File manager - Edit - /home/newsbmcs.com/public_html/static/img/logo/setuptools.tar
Back
depends.py 0000644 00000013515 15030122015 0006532 0 ustar 00 from __future__ import annotations import contextlib import dis import marshal import sys from types import CodeType from typing import Any, Literal, TypeVar from packaging.version import Version from . import _imp from ._imp import PY_COMPILED, PY_FROZEN, PY_SOURCE, find_module _T = TypeVar("_T") __all__ = ['Require', 'find_module'] class Require: """A prerequisite to building or installing a distribution""" def __init__( self, name, requested_version, module, homepage: str = '', attribute=None, format=None, ) -> None: if format is None and requested_version is not None: format = Version if format is not None: requested_version = format(requested_version) if attribute is None: attribute = '__version__' self.__dict__.update(locals()) del self.self def full_name(self): """Return full package/distribution name, w/version""" if self.requested_version is not None: return f'{self.name}-{self.requested_version}' return self.name def version_ok(self, version): """Is 'version' sufficiently up-to-date?""" return ( self.attribute is None or self.format is None or str(version) != "unknown" and self.format(version) >= self.requested_version ) def get_version( self, paths=None, default: _T | Literal["unknown"] = "unknown" ) -> _T | Literal["unknown"] | None | Any: """Get version number of installed module, 'None', or 'default' Search 'paths' for module. If not found, return 'None'. If found, return the extracted version attribute, or 'default' if no version attribute was specified, or the value cannot be determined without importing the module. The version is formatted according to the requirement's version format (if any), unless it is 'None' or the supplied 'default'. """ if self.attribute is None: try: f, _p, _i = find_module(self.module, paths) except ImportError: return None if f: f.close() return default v = get_module_constant(self.module, self.attribute, default, paths) if v is not None and v is not default and self.format is not None: return self.format(v) return v def is_present(self, paths=None): """Return true if dependency is present on 'paths'""" return self.get_version(paths) is not None def is_current(self, paths=None): """Return true if dependency is present and up-to-date on 'paths'""" version = self.get_version(paths) if version is None: return False return self.version_ok(str(version)) def maybe_close(f): @contextlib.contextmanager def empty(): yield return if not f: return empty() return contextlib.closing(f) # Some objects are not available on some platforms. # XXX it'd be better to test assertions about bytecode instead. if not sys.platform.startswith('java') and sys.platform != 'cli': def get_module_constant( module, symbol, default: _T | int = -1, paths=None ) -> _T | int | None | Any: """Find 'module' by searching 'paths', and extract 'symbol' Return 'None' if 'module' does not exist on 'paths', or it does not define 'symbol'. If the module defines 'symbol' as a constant, return the constant. Otherwise, return 'default'.""" try: f, path, (_suffix, _mode, kind) = info = find_module(module, paths) except ImportError: # Module doesn't exist return None with maybe_close(f): if kind == PY_COMPILED: f.read(8) # skip magic & date code = marshal.load(f) elif kind == PY_FROZEN: code = _imp.get_frozen_object(module, paths) elif kind == PY_SOURCE: code = compile(f.read(), path, 'exec') else: # Not something we can parse; we'll have to import it. :( imported = _imp.get_module(module, paths, info) return getattr(imported, symbol, None) return extract_constant(code, symbol, default) def extract_constant( code: CodeType, symbol: str, default: _T | int = -1 ) -> _T | int | None | Any: """Extract the constant value of 'symbol' from 'code' If the name 'symbol' is bound to a constant value by the Python code object 'code', return that value. If 'symbol' is bound to an expression, return 'default'. Otherwise, return 'None'. Return value is based on the first assignment to 'symbol'. 'symbol' must be a global, or at least a non-"fast" local in the code block. That is, only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol' must be present in 'code.co_names'. """ if symbol not in code.co_names: # name's not there, can't possibly be an assignment return None name_idx = list(code.co_names).index(symbol) STORE_NAME = dis.opmap['STORE_NAME'] STORE_GLOBAL = dis.opmap['STORE_GLOBAL'] LOAD_CONST = dis.opmap['LOAD_CONST'] const = default for byte_code in dis.Bytecode(code): op = byte_code.opcode arg = byte_code.arg if op == LOAD_CONST: assert arg is not None const = code.co_consts[arg] elif arg == name_idx and (op == STORE_NAME or op == STORE_GLOBAL): return const else: const = default return None __all__ += ['get_module_constant', 'extract_constant'] tests/test_bdist_egg.py 0000644 00000003645 15030122015 0011243 0 ustar 00 """develop tests""" import os import re import zipfile import pytest from setuptools.dist import Distribution from . import contexts SETUP_PY = """\ from setuptools import setup setup(py_modules=['hi']) """ @pytest.fixture def setup_context(tmpdir): with (tmpdir / 'setup.py').open('w') as f: f.write(SETUP_PY) with (tmpdir / 'hi.py').open('w') as f: f.write('1\n') with tmpdir.as_cwd(): yield tmpdir class Test: @pytest.mark.usefixtures("user_override") @pytest.mark.usefixtures("setup_context") def test_bdist_egg(self): dist = Distribution( dict( script_name='setup.py', script_args=['bdist_egg'], name='foo', py_modules=['hi'], ) ) os.makedirs(os.path.join('build', 'src')) with contexts.quiet(): dist.parse_command_line() dist.run_commands() # let's see if we got our egg link at the right place [content] = os.listdir('dist') assert re.match(r'foo-0.0.0-py[23].\d+.egg$', content) @pytest.mark.xfail( os.environ.get('PYTHONDONTWRITEBYTECODE', False), reason="Byte code disabled", ) @pytest.mark.usefixtures("user_override") @pytest.mark.usefixtures("setup_context") def test_exclude_source_files(self): dist = Distribution( dict( script_name='setup.py', script_args=['bdist_egg', '--exclude-source-files'], py_modules=['hi'], ) ) with contexts.quiet(): dist.parse_command_line() dist.run_commands() [dist_name] = os.listdir('dist') dist_filename = os.path.join('dist', dist_name) zip = zipfile.ZipFile(dist_filename) names = list(zi.filename for zi in zip.filelist) assert 'hi.pyc' in names assert 'hi.py' not in names tests/text.py 0000644 00000000173 15030122015 0007232 0 ustar 00 class Filenames: unicode = 'smörbröd.py' latin_1 = unicode.encode('latin-1') utf_8 = unicode.encode('utf-8') tests/test_find_packages.py 0000644 00000017213 15030122015 0012066 0 ustar 00 """Tests for automatic package discovery""" import os import shutil import tempfile import pytest from setuptools import find_namespace_packages, find_packages from setuptools.discovery import FlatLayoutPackageFinder from .compat.py39 import os_helper class TestFindPackages: def setup_method(self, method): self.dist_dir = tempfile.mkdtemp() self._make_pkg_structure() def teardown_method(self, method): shutil.rmtree(self.dist_dir) def _make_pkg_structure(self): """Make basic package structure. dist/ docs/ conf.py pkg/ __pycache__/ nspkg/ mod.py subpkg/ assets/ asset __init__.py setup.py """ self.docs_dir = self._mkdir('docs', self.dist_dir) self._touch('conf.py', self.docs_dir) self.pkg_dir = self._mkdir('pkg', self.dist_dir) self._mkdir('__pycache__', self.pkg_dir) self.ns_pkg_dir = self._mkdir('nspkg', self.pkg_dir) self._touch('mod.py', self.ns_pkg_dir) self.sub_pkg_dir = self._mkdir('subpkg', self.pkg_dir) self.asset_dir = self._mkdir('assets', self.sub_pkg_dir) self._touch('asset', self.asset_dir) self._touch('__init__.py', self.sub_pkg_dir) self._touch('setup.py', self.dist_dir) def _mkdir(self, path, parent_dir=None): if parent_dir: path = os.path.join(parent_dir, path) os.mkdir(path) return path def _touch(self, path, dir_=None): if dir_: path = os.path.join(dir_, path) open(path, 'wb').close() return path def test_regular_package(self): self._touch('__init__.py', self.pkg_dir) packages = find_packages(self.dist_dir) assert packages == ['pkg', 'pkg.subpkg'] def test_exclude(self): self._touch('__init__.py', self.pkg_dir) packages = find_packages(self.dist_dir, exclude=('pkg.*',)) assert packages == ['pkg'] def test_exclude_recursive(self): """ Excluding a parent package should not exclude child packages as well. """ self._touch('__init__.py', self.pkg_dir) self._touch('__init__.py', self.sub_pkg_dir) packages = find_packages(self.dist_dir, exclude=('pkg',)) assert packages == ['pkg.subpkg'] def test_include_excludes_other(self): """ If include is specified, other packages should be excluded. """ self._touch('__init__.py', self.pkg_dir) alt_dir = self._mkdir('other_pkg', self.dist_dir) self._touch('__init__.py', alt_dir) packages = find_packages(self.dist_dir, include=['other_pkg']) assert packages == ['other_pkg'] def test_dir_with_dot_is_skipped(self): shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) data_dir = self._mkdir('some.data', self.pkg_dir) self._touch('__init__.py', data_dir) self._touch('file.dat', data_dir) packages = find_packages(self.dist_dir) assert 'pkg.some.data' not in packages def test_dir_with_packages_in_subdir_is_excluded(self): """ Ensure that a package in a non-package such as build/pkg/__init__.py is excluded. """ build_dir = self._mkdir('build', self.dist_dir) build_pkg_dir = self._mkdir('pkg', build_dir) self._touch('__init__.py', build_pkg_dir) packages = find_packages(self.dist_dir) assert 'build.pkg' not in packages @pytest.mark.skipif(not os_helper.can_symlink(), reason='Symlink support required') def test_symlinked_packages_are_included(self): """ A symbolically-linked directory should be treated like any other directory when matched as a package. Create a link from lpkg -> pkg. """ self._touch('__init__.py', self.pkg_dir) linked_pkg = os.path.join(self.dist_dir, 'lpkg') os.symlink('pkg', linked_pkg) assert os.path.isdir(linked_pkg) packages = find_packages(self.dist_dir) assert 'lpkg' in packages def _assert_packages(self, actual, expected): assert set(actual) == set(expected) def test_pep420_ns_package(self): packages = find_namespace_packages( self.dist_dir, include=['pkg*'], exclude=['pkg.subpkg.assets'] ) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_includes(self): packages = find_namespace_packages(self.dist_dir, exclude=['pkg.subpkg.assets']) self._assert_packages(packages, ['docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_includes_or_excludes(self): packages = find_namespace_packages(self.dist_dir) expected = ['docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg', 'pkg.subpkg.assets'] self._assert_packages(packages, expected) def test_regular_package_with_nested_pep420_ns_packages(self): self._touch('__init__.py', self.pkg_dir) packages = find_namespace_packages( self.dist_dir, exclude=['docs', 'pkg.subpkg.assets'] ) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) def test_pep420_ns_package_no_non_package_dirs(self): shutil.rmtree(self.docs_dir) shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) packages = find_namespace_packages(self.dist_dir) self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) class TestFlatLayoutPackageFinder: EXAMPLES = { "hidden-folders": ( [".pkg/__init__.py", "pkg/__init__.py", "pkg/nested/file.txt"], ["pkg", "pkg.nested"], ), "private-packages": ( ["_pkg/__init__.py", "pkg/_private/__init__.py"], ["pkg", "pkg._private"], ), "invalid-name": ( ["invalid-pkg/__init__.py", "other.pkg/__init__.py", "yet,another/file.py"], [], ), "docs": (["pkg/__init__.py", "docs/conf.py", "docs/readme.rst"], ["pkg"]), "tests": ( ["pkg/__init__.py", "tests/test_pkg.py", "tests/__init__.py"], ["pkg"], ), "examples": ( [ "pkg/__init__.py", "examples/__init__.py", "examples/file.py", "example/other_file.py", # Sub-packages should always be fine "pkg/example/__init__.py", "pkg/examples/__init__.py", ], ["pkg", "pkg.examples", "pkg.example"], ), "tool-specific": ( [ "htmlcov/index.html", "pkg/__init__.py", "tasks/__init__.py", "tasks/subpackage/__init__.py", "fabfile/__init__.py", "fabfile/subpackage/__init__.py", # Sub-packages should always be fine "pkg/tasks/__init__.py", "pkg/fabfile/__init__.py", ], ["pkg", "pkg.tasks", "pkg.fabfile"], ), } @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_unwanted_directories_not_included(self, tmp_path, example): files, expected_packages = self.EXAMPLES[example] ensure_files(tmp_path, files) found_packages = FlatLayoutPackageFinder.find(str(tmp_path)) assert set(found_packages) == set(expected_packages) def ensure_files(root_path, files): for file in files: path = root_path / file path.parent.mkdir(parents=True, exist_ok=True) path.touch() tests/test_build_py.py 0000644 00000033552 15030122015 0011123 0 ustar 00 import os import shutil import stat import warnings from pathlib import Path from unittest.mock import Mock import jaraco.path import pytest from setuptools import SetuptoolsDeprecationWarning from setuptools.dist import Distribution from .textwrap import DALS def test_directories_in_package_data_glob(tmpdir_cwd): """ Directories matching the glob in package_data should not be included in the package data. Regression test for #261. """ dist = Distribution( dict( script_name='setup.py', script_args=['build_py'], packages=[''], package_data={'': ['path/*']}, ) ) os.makedirs('path/subpath') dist.parse_command_line() dist.run_commands() def test_recursive_in_package_data_glob(tmpdir_cwd): """ Files matching recursive globs (**) in package_data should be included in the package data. #1806 """ dist = Distribution( dict( script_name='setup.py', script_args=['build_py'], packages=[''], package_data={'': ['path/**/data']}, ) ) os.makedirs('path/subpath/subsubpath') open('path/subpath/subsubpath/data', 'wb').close() dist.parse_command_line() dist.run_commands() assert stat.S_ISREG(os.stat('build/lib/path/subpath/subsubpath/data').st_mode), ( "File is not included" ) def test_read_only(tmpdir_cwd): """ Ensure read-only flag is not preserved in copy for package modules and package data, as that causes problems with deleting read-only files on Windows. #1451 """ dist = Distribution( dict( script_name='setup.py', script_args=['build_py'], packages=['pkg'], package_data={'pkg': ['data.dat']}, ) ) os.makedirs('pkg') open('pkg/__init__.py', 'wb').close() open('pkg/data.dat', 'wb').close() os.chmod('pkg/__init__.py', stat.S_IREAD) os.chmod('pkg/data.dat', stat.S_IREAD) dist.parse_command_line() dist.run_commands() shutil.rmtree('build') @pytest.mark.xfail( 'platform.system() == "Windows"', reason="On Windows, files do not have executable bits", raises=AssertionError, strict=True, ) def test_executable_data(tmpdir_cwd): """ Ensure executable bit is preserved in copy for package data, as users rely on it for scripts. #2041 """ dist = Distribution( dict( script_name='setup.py', script_args=['build_py'], packages=['pkg'], package_data={'pkg': ['run-me']}, ) ) os.makedirs('pkg') open('pkg/__init__.py', 'wb').close() open('pkg/run-me', 'wb').close() os.chmod('pkg/run-me', 0o700) dist.parse_command_line() dist.run_commands() assert os.stat('build/lib/pkg/run-me').st_mode & stat.S_IEXEC, ( "Script is not executable" ) EXAMPLE_WITH_MANIFEST = { "setup.cfg": DALS( """ [metadata] name = mypkg version = 42 [options] include_package_data = True packages = find: [options.packages.find] exclude = *.tests* """ ), "mypkg": { "__init__.py": "", "resource_file.txt": "", "tests": { "__init__.py": "", "test_mypkg.py": "", "test_file.txt": "", }, }, "MANIFEST.in": DALS( """ global-include *.py *.txt global-exclude *.py[cod] prune dist prune build prune *.egg-info """ ), } def test_excluded_subpackages(tmpdir_cwd): jaraco.path.build(EXAMPLE_WITH_MANIFEST) dist = Distribution({"script_name": "%PEP 517%"}) dist.parse_config_files() build_py = dist.get_command_obj("build_py") msg = r"Python recognizes 'mypkg\.tests' as an importable package" with pytest.warns(SetuptoolsDeprecationWarning, match=msg): # TODO: To fix #3260 we need some transition period to deprecate the # existing behavior of `include_package_data`. After the transition, we # should remove the warning and fix the behavior. if os.getenv("SETUPTOOLS_USE_DISTUTILS") == "stdlib": # pytest.warns reset the warning filter temporarily # https://github.com/pytest-dev/pytest/issues/4011#issuecomment-423494810 warnings.filterwarnings( "ignore", "'encoding' argument not specified", module="distutils.text_file", # This warning is already fixed in pypa/distutils but not in stdlib ) build_py.finalize_options() build_py.run() build_dir = Path(dist.get_command_obj("build_py").build_lib) assert (build_dir / "mypkg/__init__.py").exists() assert (build_dir / "mypkg/resource_file.txt").exists() # Setuptools is configured to ignore `mypkg.tests`, therefore the following # files/dirs should not be included in the distribution. for f in [ "mypkg/tests/__init__.py", "mypkg/tests/test_mypkg.py", "mypkg/tests/test_file.txt", "mypkg/tests", ]: with pytest.raises(AssertionError): # TODO: Enforce the following assertion once #3260 is fixed # (remove context manager and the following xfail). assert not (build_dir / f).exists() pytest.xfail("#3260") @pytest.mark.filterwarnings("ignore::setuptools.SetuptoolsDeprecationWarning") def test_existing_egg_info(tmpdir_cwd, monkeypatch): """When provided with the ``existing_egg_info_dir`` attribute, build_py should not attempt to run egg_info again. """ # == Pre-condition == # Generate an egg-info dir jaraco.path.build(EXAMPLE_WITH_MANIFEST) dist = Distribution({"script_name": "%PEP 517%"}) dist.parse_config_files() assert dist.include_package_data egg_info = dist.get_command_obj("egg_info") dist.run_command("egg_info") egg_info_dir = next(Path(egg_info.egg_base).glob("*.egg-info")) assert egg_info_dir.is_dir() # == Setup == build_py = dist.get_command_obj("build_py") build_py.finalize_options() egg_info = dist.get_command_obj("egg_info") egg_info_run = Mock(side_effect=egg_info.run) monkeypatch.setattr(egg_info, "run", egg_info_run) # == Remove caches == # egg_info is called when build_py looks for data_files, which gets cached. # We need to ensure it is not cached yet, otherwise it may impact on the tests build_py.__dict__.pop('data_files', None) dist.reinitialize_command(egg_info) # == Sanity check == # Ensure that if existing_egg_info is not given, build_py attempts to run egg_info build_py.existing_egg_info_dir = None build_py.run() egg_info_run.assert_called() # == Remove caches == egg_info_run.reset_mock() build_py.__dict__.pop('data_files', None) dist.reinitialize_command(egg_info) # == Actual test == # Ensure that if existing_egg_info_dir is given, egg_info doesn't run build_py.existing_egg_info_dir = egg_info_dir build_py.run() egg_info_run.assert_not_called() assert build_py.data_files # Make sure the list of outputs is actually OK outputs = map(lambda x: x.replace(os.sep, "/"), build_py.get_outputs()) assert outputs example = str(Path(build_py.build_lib, "mypkg/__init__.py")).replace(os.sep, "/") assert example in outputs EXAMPLE_ARBITRARY_MAPPING = { "pyproject.toml": DALS( """ [project] name = "mypkg" version = "42" [tool.setuptools] packages = ["mypkg", "mypkg.sub1", "mypkg.sub2", "mypkg.sub2.nested"] [tool.setuptools.package-dir] "" = "src" "mypkg.sub2" = "src/mypkg/_sub2" "mypkg.sub2.nested" = "other" """ ), "src": { "mypkg": { "__init__.py": "", "resource_file.txt": "", "sub1": { "__init__.py": "", "mod1.py": "", }, "_sub2": { "mod2.py": "", }, }, }, "other": { "__init__.py": "", "mod3.py": "", }, "MANIFEST.in": DALS( """ global-include *.py *.txt global-exclude *.py[cod] """ ), } def test_get_outputs(tmpdir_cwd): jaraco.path.build(EXAMPLE_ARBITRARY_MAPPING) dist = Distribution({"script_name": "%test%"}) dist.parse_config_files() build_py = dist.get_command_obj("build_py") build_py.editable_mode = True build_py.ensure_finalized() build_lib = build_py.build_lib.replace(os.sep, "/") outputs = {x.replace(os.sep, "/") for x in build_py.get_outputs()} assert outputs == { f"{build_lib}/mypkg/__init__.py", f"{build_lib}/mypkg/resource_file.txt", f"{build_lib}/mypkg/sub1/__init__.py", f"{build_lib}/mypkg/sub1/mod1.py", f"{build_lib}/mypkg/sub2/mod2.py", f"{build_lib}/mypkg/sub2/nested/__init__.py", f"{build_lib}/mypkg/sub2/nested/mod3.py", } mapping = { k.replace(os.sep, "/"): v.replace(os.sep, "/") for k, v in build_py.get_output_mapping().items() } assert mapping == { f"{build_lib}/mypkg/__init__.py": "src/mypkg/__init__.py", f"{build_lib}/mypkg/resource_file.txt": "src/mypkg/resource_file.txt", f"{build_lib}/mypkg/sub1/__init__.py": "src/mypkg/sub1/__init__.py", f"{build_lib}/mypkg/sub1/mod1.py": "src/mypkg/sub1/mod1.py", f"{build_lib}/mypkg/sub2/mod2.py": "src/mypkg/_sub2/mod2.py", f"{build_lib}/mypkg/sub2/nested/__init__.py": "other/__init__.py", f"{build_lib}/mypkg/sub2/nested/mod3.py": "other/mod3.py", } class TestTypeInfoFiles: PYPROJECTS = { "default_pyproject": DALS( """ [project] name = "foo" version = "1" """ ), "dont_include_package_data": DALS( """ [project] name = "foo" version = "1" [tool.setuptools] include-package-data = false """ ), "exclude_type_info": DALS( """ [project] name = "foo" version = "1" [tool.setuptools] include-package-data = false [tool.setuptools.exclude-package-data] "*" = ["py.typed", "*.pyi"] """ ), } EXAMPLES = { "simple_namespace": { "directory_structure": { "foo": { "bar.pyi": "", "py.typed": "", "__init__.py": "", } }, "expected_type_files": {"foo/bar.pyi", "foo/py.typed"}, }, "nested_inside_namespace": { "directory_structure": { "foo": { "bar": { "py.typed": "", "mod.pyi": "", } } }, "expected_type_files": {"foo/bar/mod.pyi", "foo/bar/py.typed"}, }, "namespace_nested_inside_regular": { "directory_structure": { "foo": { "namespace": { "foo.pyi": "", }, "__init__.pyi": "", "py.typed": "", } }, "expected_type_files": { "foo/namespace/foo.pyi", "foo/__init__.pyi", "foo/py.typed", }, }, } @pytest.mark.parametrize( "pyproject", [ "default_pyproject", pytest.param( "dont_include_package_data", marks=pytest.mark.xfail(reason="pypa/setuptools#4350"), ), ], ) @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_type_files_included_by_default(self, tmpdir_cwd, pyproject, example): structure = { **self.EXAMPLES[example]["directory_structure"], "pyproject.toml": self.PYPROJECTS[pyproject], } expected_type_files = self.EXAMPLES[example]["expected_type_files"] jaraco.path.build(structure) build_py = get_finalized_build_py() outputs = get_outputs(build_py) assert expected_type_files <= outputs @pytest.mark.parametrize("pyproject", ["exclude_type_info"]) @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_type_files_can_be_excluded(self, tmpdir_cwd, pyproject, example): structure = { **self.EXAMPLES[example]["directory_structure"], "pyproject.toml": self.PYPROJECTS[pyproject], } expected_type_files = self.EXAMPLES[example]["expected_type_files"] jaraco.path.build(structure) build_py = get_finalized_build_py() outputs = get_outputs(build_py) assert expected_type_files.isdisjoint(outputs) def test_stub_only_package(self, tmpdir_cwd): structure = { "pyproject.toml": DALS( """ [project] name = "foo-stubs" version = "1" """ ), "foo-stubs": {"__init__.pyi": "", "bar.pyi": ""}, } expected_type_files = {"foo-stubs/__init__.pyi", "foo-stubs/bar.pyi"} jaraco.path.build(structure) build_py = get_finalized_build_py() outputs = get_outputs(build_py) assert expected_type_files <= outputs def get_finalized_build_py(script_name="%build_py-test%"): dist = Distribution({"script_name": script_name}) dist.parse_config_files() build_py = dist.get_command_obj("build_py") build_py.finalize_options() return build_py def get_outputs(build_py): build_dir = Path(build_py.build_lib) return { os.path.relpath(x, build_dir).replace(os.sep, "/") for x in build_py.get_outputs() } tests/config/setupcfg_examples.txt 0000644 00000003570 15030122015 0013424 0 ustar 00 # ==================================================================== # Some popular packages that use setup.cfg (and others not so popular) # Reference: https://hugovk.github.io/top-pypi-packages/ # ==================================================================== https://github.com/pypa/setuptools/raw/52c990172fec37766b3566679724aa8bf70ae06d/setup.cfg https://github.com/pypa/wheel/raw/0acd203cd896afec7f715aa2ff5980a403459a3b/setup.cfg https://github.com/python/importlib_metadata/raw/2f05392ca980952a6960d82b2f2d2ea10aa53239/setup.cfg https://github.com/jaraco/skeleton/raw/d9008b5c510cd6969127a6a2ab6f832edddef296/setup.cfg https://github.com/jaraco/zipp/raw/700d3a96390e970b6b962823bfea78b4f7e1c537/setup.cfg https://github.com/pallets/jinja/raw/7d72eb7fefb7dce065193967f31f805180508448/setup.cfg https://github.com/tkem/cachetools/raw/2fd87a94b8d3861d80e9e4236cd480bfdd21c90d/setup.cfg https://github.com/aio-libs/aiohttp/raw/5e0e6b7080f2408d5f1dd544c0e1cf88378b7b10/setup.cfg https://github.com/pallets/flask/raw/9486b6cf57bd6a8a261f67091aca8ca78eeec1e3/setup.cfg https://github.com/pallets/click/raw/6411f425fae545f42795665af4162006b36c5e4a/setup.cfg https://github.com/sqlalchemy/sqlalchemy/raw/533f5718904b620be8d63f2474229945d6f8ba5d/setup.cfg https://github.com/pytest-dev/pluggy/raw/461ef63291d13589c4e21aa182cd1529257e9a0a/setup.cfg https://github.com/pytest-dev/pytest/raw/c7be96dae487edbd2f55b561b31b68afac1dabe6/setup.cfg https://github.com/platformdirs/platformdirs/raw/7b7852128dd6f07511b618d6edea35046bd0c6ff/setup.cfg https://github.com/pandas-dev/pandas/raw/bc17343f934a33dc231c8c74be95d8365537c376/setup.cfg https://github.com/django/django/raw/4e249d11a6e56ca8feb4b055b681cec457ef3a3d/setup.cfg https://github.com/pyscaffold/pyscaffold/raw/de7aa5dc059fbd04307419c667cc4961bc9df4b8/setup.cfg https://github.com/pypa/virtualenv/raw/f92eda6e3da26a4d28c2663ffb85c4960bdb990c/setup.cfg tests/config/test_pyprojecttoml_dynamic_deps.py 0000644 00000006307 15030122015 0016211 0 ustar 00 from inspect import cleandoc import pytest from jaraco import path from setuptools.config.pyprojecttoml import apply_configuration from setuptools.dist import Distribution from setuptools.warnings import SetuptoolsWarning def test_dynamic_dependencies(tmp_path): files = { "requirements.txt": "six\n # comment\n", "pyproject.toml": cleandoc( """ [project] name = "myproj" version = "1.0" dynamic = ["dependencies"] [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [tool.setuptools.dynamic.dependencies] file = ["requirements.txt"] """ ), } path.build(files, prefix=tmp_path) dist = Distribution() dist = apply_configuration(dist, tmp_path / "pyproject.toml") assert dist.install_requires == ["six"] def test_dynamic_optional_dependencies(tmp_path): files = { "requirements-docs.txt": "sphinx\n # comment\n", "pyproject.toml": cleandoc( """ [project] name = "myproj" version = "1.0" dynamic = ["optional-dependencies"] [tool.setuptools.dynamic.optional-dependencies.docs] file = ["requirements-docs.txt"] [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" """ ), } path.build(files, prefix=tmp_path) dist = Distribution() dist = apply_configuration(dist, tmp_path / "pyproject.toml") assert dist.extras_require == {"docs": ["sphinx"]} def test_mixed_dynamic_optional_dependencies(tmp_path): """ Test that if PEP 621 was loosened to allow mixing of dynamic and static configurations in the case of fields containing sub-fields (groups), things would work out. """ files = { "requirements-images.txt": "pillow~=42.0\n # comment\n", "pyproject.toml": cleandoc( """ [project] name = "myproj" version = "1.0" dynamic = ["optional-dependencies"] [project.optional-dependencies] docs = ["sphinx"] [tool.setuptools.dynamic.optional-dependencies.images] file = ["requirements-images.txt"] """ ), } path.build(files, prefix=tmp_path) pyproject = tmp_path / "pyproject.toml" with pytest.raises(ValueError, match="project.optional-dependencies"): apply_configuration(Distribution(), pyproject) def test_mixed_extras_require_optional_dependencies(tmp_path): files = { "pyproject.toml": cleandoc( """ [project] name = "myproj" version = "1.0" optional-dependencies.docs = ["sphinx"] """ ), } path.build(files, prefix=tmp_path) pyproject = tmp_path / "pyproject.toml" with pytest.warns(SetuptoolsWarning, match=".extras_require. overwritten"): dist = Distribution({"extras_require": {"hello": ["world"]}}) dist = apply_configuration(dist, pyproject) assert dist.extras_require == {"docs": ["sphinx"]} tests/config/test_setupcfg.py 0000644 00000101223 15030122015 0012370 0 ustar 00 import configparser import contextlib import inspect import re from pathlib import Path from unittest.mock import Mock, patch import pytest from packaging.requirements import InvalidRequirement from setuptools.config.setupcfg import ConfigHandler, Target, read_configuration from setuptools.dist import Distribution, _Distribution from setuptools.warnings import SetuptoolsDeprecationWarning from ..textwrap import DALS from distutils.errors import DistutilsFileError, DistutilsOptionError class ErrConfigHandler(ConfigHandler[Target]): """Erroneous handler. Fails to implement required methods.""" section_prefix = "**err**" def make_package_dir(name, base_dir, ns=False): dir_package = base_dir for dir_name in name.split('/'): dir_package = dir_package.mkdir(dir_name) init_file = None if not ns: init_file = dir_package.join('__init__.py') init_file.write('') return dir_package, init_file def fake_env( tmpdir, setup_cfg, setup_py=None, encoding='ascii', package_path='fake_package' ): if setup_py is None: setup_py = 'from setuptools import setup\nsetup()\n' tmpdir.join('setup.py').write(setup_py) config = tmpdir.join('setup.cfg') config.write(setup_cfg.encode(encoding), mode='wb') package_dir, init_file = make_package_dir(package_path, tmpdir) init_file.write( 'VERSION = (1, 2, 3)\n' '\n' 'VERSION_MAJOR = 1' '\n' 'def get_version():\n' ' return [3, 4, 5, "dev"]\n' '\n' ) return package_dir, config @contextlib.contextmanager def get_dist(tmpdir, kwargs_initial=None, parse=True): kwargs_initial = kwargs_initial or {} with tmpdir.as_cwd(): dist = Distribution(kwargs_initial) dist.script_name = 'setup.py' parse and dist.parse_config_files() yield dist def test_parsers_implemented(): with pytest.raises(NotImplementedError): handler = ErrConfigHandler(None, {}, False, Mock()) handler.parsers class TestConfigurationReader: def test_basic(self, tmpdir): _, config = fake_env( tmpdir, '[metadata]\n' 'version = 10.1.1\n' 'keywords = one, two\n' '\n' '[options]\n' 'scripts = bin/a.py, bin/b.py\n', ) config_dict = read_configuration(str(config)) assert config_dict['metadata']['version'] == '10.1.1' assert config_dict['metadata']['keywords'] == ['one', 'two'] assert config_dict['options']['scripts'] == ['bin/a.py', 'bin/b.py'] def test_no_config(self, tmpdir): with pytest.raises(DistutilsFileError): read_configuration(str(tmpdir.join('setup.cfg'))) def test_ignore_errors(self, tmpdir): _, config = fake_env( tmpdir, '[metadata]\nversion = attr: none.VERSION\nkeywords = one, two\n', ) with pytest.raises(ImportError): read_configuration(str(config)) config_dict = read_configuration(str(config), ignore_option_errors=True) assert config_dict['metadata']['keywords'] == ['one', 'two'] assert 'version' not in config_dict['metadata'] config.remove() class TestMetadata: def test_basic(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'version = 10.1.1\n' 'description = Some description\n' 'long_description_content_type = text/something\n' 'long_description = file: README\n' 'name = fake_name\n' 'keywords = one, two\n' 'provides = package, package.sub\n' 'license = otherlic\n' 'download_url = http://test.test.com/test/\n' 'maintainer_email = test@test.com\n', ) tmpdir.join('README').write('readme contents\nline2') meta_initial = { # This will be used so `otherlic` won't replace it. 'license': 'BSD 3-Clause License', } with get_dist(tmpdir, meta_initial) as dist: metadata = dist.metadata assert metadata.version == '10.1.1' assert metadata.description == 'Some description' assert metadata.long_description_content_type == 'text/something' assert metadata.long_description == 'readme contents\nline2' assert metadata.provides == ['package', 'package.sub'] assert metadata.license == 'BSD 3-Clause License' assert metadata.name == 'fake_name' assert metadata.keywords == ['one', 'two'] assert metadata.download_url == 'http://test.test.com/test/' assert metadata.maintainer_email == 'test@test.com' def test_license_cfg(self, tmpdir): fake_env( tmpdir, DALS( """ [metadata] name=foo version=0.0.1 license=Apache 2.0 """ ), ) with get_dist(tmpdir) as dist: metadata = dist.metadata assert metadata.name == "foo" assert metadata.version == "0.0.1" assert metadata.license == "Apache 2.0" def test_file_mixed(self, tmpdir): fake_env( tmpdir, '[metadata]\nlong_description = file: README.rst, CHANGES.rst\n\n', ) tmpdir.join('README.rst').write('readme contents\nline2') tmpdir.join('CHANGES.rst').write('changelog contents\nand stuff') with get_dist(tmpdir) as dist: assert dist.metadata.long_description == ( 'readme contents\nline2\nchangelog contents\nand stuff' ) def test_file_sandboxed(self, tmpdir): tmpdir.ensure("README") project = tmpdir.join('depth1', 'depth2') project.ensure(dir=True) fake_env(project, '[metadata]\nlong_description = file: ../../README\n') with get_dist(project, parse=False) as dist: with pytest.raises(DistutilsOptionError): dist.parse_config_files() # file: out of sandbox def test_aliases(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'author_email = test@test.com\n' 'home_page = http://test.test.com/test/\n' 'summary = Short summary\n' 'platform = a, b\n' 'classifier =\n' ' Framework :: Django\n' ' Programming Language :: Python :: 3.5\n', ) with get_dist(tmpdir) as dist: metadata = dist.metadata assert metadata.author_email == 'test@test.com' assert metadata.url == 'http://test.test.com/test/' assert metadata.description == 'Short summary' assert metadata.platforms == ['a', 'b'] assert metadata.classifiers == [ 'Framework :: Django', 'Programming Language :: Python :: 3.5', ] def test_multiline(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'name = fake_name\n' 'keywords =\n' ' one\n' ' two\n' 'classifiers =\n' ' Framework :: Django\n' ' Programming Language :: Python :: 3.5\n', ) with get_dist(tmpdir) as dist: metadata = dist.metadata assert metadata.keywords == ['one', 'two'] assert metadata.classifiers == [ 'Framework :: Django', 'Programming Language :: Python :: 3.5', ] def test_dict(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'project_urls =\n' ' Link One = https://example.com/one/\n' ' Link Two = https://example.com/two/\n', ) with get_dist(tmpdir) as dist: metadata = dist.metadata assert metadata.project_urls == { 'Link One': 'https://example.com/one/', 'Link Two': 'https://example.com/two/', } def test_version(self, tmpdir): package_dir, config = fake_env( tmpdir, '[metadata]\nversion = attr: fake_package.VERSION\n' ) sub_a = package_dir.mkdir('subpkg_a') sub_a.join('__init__.py').write('') sub_a.join('mod.py').write('VERSION = (2016, 11, 26)') sub_b = package_dir.mkdir('subpkg_b') sub_b.join('__init__.py').write('') sub_b.join('mod.py').write( 'import third_party_module\nVERSION = (2016, 11, 26)' ) with get_dist(tmpdir) as dist: assert dist.metadata.version == '1.2.3' config.write('[metadata]\nversion = attr: fake_package.get_version\n') with get_dist(tmpdir) as dist: assert dist.metadata.version == '3.4.5.dev' config.write('[metadata]\nversion = attr: fake_package.VERSION_MAJOR\n') with get_dist(tmpdir) as dist: assert dist.metadata.version == '1' config.write('[metadata]\nversion = attr: fake_package.subpkg_a.mod.VERSION\n') with get_dist(tmpdir) as dist: assert dist.metadata.version == '2016.11.26' config.write('[metadata]\nversion = attr: fake_package.subpkg_b.mod.VERSION\n') with get_dist(tmpdir) as dist: assert dist.metadata.version == '2016.11.26' def test_version_file(self, tmpdir): fake_env(tmpdir, '[metadata]\nversion = file: fake_package/version.txt\n') tmpdir.join('fake_package', 'version.txt').write('1.2.3\n') with get_dist(tmpdir) as dist: assert dist.metadata.version == '1.2.3' tmpdir.join('fake_package', 'version.txt').write('1.2.3\n4.5.6\n') with pytest.raises(DistutilsOptionError): with get_dist(tmpdir) as dist: dist.metadata.version def test_version_with_package_dir_simple(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'version = attr: fake_package_simple.VERSION\n' '[options]\n' 'package_dir =\n' ' = src\n', package_path='src/fake_package_simple', ) with get_dist(tmpdir) as dist: assert dist.metadata.version == '1.2.3' def test_version_with_package_dir_rename(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'version = attr: fake_package_rename.VERSION\n' '[options]\n' 'package_dir =\n' ' fake_package_rename = fake_dir\n', package_path='fake_dir', ) with get_dist(tmpdir) as dist: assert dist.metadata.version == '1.2.3' def test_version_with_package_dir_complex(self, tmpdir): fake_env( tmpdir, '[metadata]\n' 'version = attr: fake_package_complex.VERSION\n' '[options]\n' 'package_dir =\n' ' fake_package_complex = src/fake_dir\n', package_path='src/fake_dir', ) with get_dist(tmpdir) as dist: assert dist.metadata.version == '1.2.3' def test_unknown_meta_item(self, tmpdir): fake_env(tmpdir, '[metadata]\nname = fake_name\nunknown = some\n') with get_dist(tmpdir, parse=False) as dist: dist.parse_config_files() # Skip unknown. def test_usupported_section(self, tmpdir): fake_env(tmpdir, '[metadata.some]\nkey = val\n') with get_dist(tmpdir, parse=False) as dist: with pytest.raises(DistutilsOptionError): dist.parse_config_files() def test_classifiers(self, tmpdir): expected = set([ 'Framework :: Django', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3.5', ]) # From file. _, config = fake_env(tmpdir, '[metadata]\nclassifiers = file: classifiers\n') tmpdir.join('classifiers').write( 'Framework :: Django\n' 'Programming Language :: Python :: 3\n' 'Programming Language :: Python :: 3.5\n' ) with get_dist(tmpdir) as dist: assert set(dist.metadata.classifiers) == expected # From list notation config.write( '[metadata]\n' 'classifiers =\n' ' Framework :: Django\n' ' Programming Language :: Python :: 3\n' ' Programming Language :: Python :: 3.5\n' ) with get_dist(tmpdir) as dist: assert set(dist.metadata.classifiers) == expected def test_interpolation(self, tmpdir): fake_env(tmpdir, '[metadata]\ndescription = %(message)s\n') with pytest.raises(configparser.InterpolationMissingOptionError): with get_dist(tmpdir): pass def test_non_ascii_1(self, tmpdir): fake_env(tmpdir, '[metadata]\ndescription = éàïôñ\n', encoding='utf-8') with get_dist(tmpdir): pass def test_non_ascii_3(self, tmpdir): fake_env(tmpdir, '\n# -*- coding: invalid\n') with get_dist(tmpdir): pass def test_non_ascii_4(self, tmpdir): fake_env( tmpdir, '# -*- coding: utf-8\n[metadata]\ndescription = éàïôñ\n', encoding='utf-8', ) with get_dist(tmpdir) as dist: assert dist.metadata.description == 'éàïôñ' def test_not_utf8(self, tmpdir): """ Config files encoded not in UTF-8 will fail """ fake_env( tmpdir, '# vim: set fileencoding=iso-8859-15 :\n[metadata]\ndescription = éàïôñ\n', encoding='iso-8859-15', ) with pytest.raises(UnicodeDecodeError): with get_dist(tmpdir): pass @pytest.mark.parametrize( ("error_msg", "config", "invalid"), [ ( "Invalid dash-separated key 'author-email' in 'metadata' (setup.cfg)", DALS( """ [metadata] author-email = test@test.com maintainer_email = foo@foo.com """ ), {"author-email": "test@test.com"}, ), ( "Invalid uppercase key 'Name' in 'metadata' (setup.cfg)", DALS( """ [metadata] Name = foo description = Some description """ ), {"Name": "foo"}, ), ], ) def test_invalid_options_previously_deprecated( self, tmpdir, error_msg, config, invalid ): # This test and related methods can be removed when no longer needed. # Deprecation postponed due to push-back from the community in # https://github.com/pypa/setuptools/issues/4910 fake_env(tmpdir, config) with pytest.warns(SetuptoolsDeprecationWarning, match=re.escape(error_msg)): dist = get_dist(tmpdir).__enter__() tmpdir.join('setup.cfg').remove() for field, value in invalid.items(): attr = field.replace("-", "_").lower() assert getattr(dist.metadata, attr) == value class TestOptions: def test_basic(self, tmpdir): fake_env( tmpdir, '[options]\n' 'zip_safe = True\n' 'include_package_data = yes\n' 'package_dir = b=c, =src\n' 'packages = pack_a, pack_b.subpack\n' 'namespace_packages = pack1, pack2\n' 'scripts = bin/one.py, bin/two.py\n' 'eager_resources = bin/one.py, bin/two.py\n' 'install_requires = docutils>=0.3; pack ==1.1, ==1.3; hey\n' 'setup_requires = docutils>=0.3; spack ==1.1, ==1.3; there\n' 'dependency_links = http://some.com/here/1, ' 'http://some.com/there/2\n' 'python_requires = >=1.0, !=2.8\n' 'py_modules = module1, module2\n', ) deprec = pytest.warns(SetuptoolsDeprecationWarning, match="namespace_packages") with deprec, get_dist(tmpdir) as dist: assert dist.zip_safe assert dist.include_package_data assert dist.package_dir == {'': 'src', 'b': 'c'} assert dist.packages == ['pack_a', 'pack_b.subpack'] assert dist.namespace_packages == ['pack1', 'pack2'] assert dist.scripts == ['bin/one.py', 'bin/two.py'] assert dist.dependency_links == ([ 'http://some.com/here/1', 'http://some.com/there/2', ]) assert dist.install_requires == ([ 'docutils>=0.3', 'pack==1.1,==1.3', 'hey', ]) assert dist.setup_requires == ([ 'docutils>=0.3', 'spack ==1.1, ==1.3', 'there', ]) assert dist.python_requires == '>=1.0, !=2.8' assert dist.py_modules == ['module1', 'module2'] def test_multiline(self, tmpdir): fake_env( tmpdir, '[options]\n' 'package_dir = \n' ' b=c\n' ' =src\n' 'packages = \n' ' pack_a\n' ' pack_b.subpack\n' 'namespace_packages = \n' ' pack1\n' ' pack2\n' 'scripts = \n' ' bin/one.py\n' ' bin/two.py\n' 'eager_resources = \n' ' bin/one.py\n' ' bin/two.py\n' 'install_requires = \n' ' docutils>=0.3\n' ' pack ==1.1, ==1.3\n' ' hey\n' 'setup_requires = \n' ' docutils>=0.3\n' ' spack ==1.1, ==1.3\n' ' there\n' 'dependency_links = \n' ' http://some.com/here/1\n' ' http://some.com/there/2\n', ) deprec = pytest.warns(SetuptoolsDeprecationWarning, match="namespace_packages") with deprec, get_dist(tmpdir) as dist: assert dist.package_dir == {'': 'src', 'b': 'c'} assert dist.packages == ['pack_a', 'pack_b.subpack'] assert dist.namespace_packages == ['pack1', 'pack2'] assert dist.scripts == ['bin/one.py', 'bin/two.py'] assert dist.dependency_links == ([ 'http://some.com/here/1', 'http://some.com/there/2', ]) assert dist.install_requires == ([ 'docutils>=0.3', 'pack==1.1,==1.3', 'hey', ]) assert dist.setup_requires == ([ 'docutils>=0.3', 'spack ==1.1, ==1.3', 'there', ]) def test_package_dir_fail(self, tmpdir): fake_env(tmpdir, '[options]\npackage_dir = a b\n') with get_dist(tmpdir, parse=False) as dist: with pytest.raises(DistutilsOptionError): dist.parse_config_files() def test_package_data(self, tmpdir): fake_env( tmpdir, '[options.package_data]\n' '* = *.txt, *.rst\n' 'hello = *.msg\n' '\n' '[options.exclude_package_data]\n' '* = fake1.txt, fake2.txt\n' 'hello = *.dat\n', ) with get_dist(tmpdir) as dist: assert dist.package_data == { '': ['*.txt', '*.rst'], 'hello': ['*.msg'], } assert dist.exclude_package_data == { '': ['fake1.txt', 'fake2.txt'], 'hello': ['*.dat'], } def test_packages(self, tmpdir): fake_env(tmpdir, '[options]\npackages = find:\n') with get_dist(tmpdir) as dist: assert dist.packages == ['fake_package'] def test_find_directive(self, tmpdir): dir_package, config = fake_env(tmpdir, '[options]\npackages = find:\n') make_package_dir('sub_one', dir_package) make_package_dir('sub_two', dir_package) with get_dist(tmpdir) as dist: assert set(dist.packages) == set([ 'fake_package', 'fake_package.sub_two', 'fake_package.sub_one', ]) config.write( '[options]\n' 'packages = find:\n' '\n' '[options.packages.find]\n' 'where = .\n' 'include =\n' ' fake_package.sub_one\n' ' two\n' ) with get_dist(tmpdir) as dist: assert dist.packages == ['fake_package.sub_one'] config.write( '[options]\n' 'packages = find:\n' '\n' '[options.packages.find]\n' 'exclude =\n' ' fake_package.sub_one\n' ) with get_dist(tmpdir) as dist: assert set(dist.packages) == set(['fake_package', 'fake_package.sub_two']) def test_find_namespace_directive(self, tmpdir): dir_package, config = fake_env( tmpdir, '[options]\npackages = find_namespace:\n' ) make_package_dir('sub_one', dir_package) make_package_dir('sub_two', dir_package, ns=True) with get_dist(tmpdir) as dist: assert set(dist.packages) == { 'fake_package', 'fake_package.sub_two', 'fake_package.sub_one', } config.write( '[options]\n' 'packages = find_namespace:\n' '\n' '[options.packages.find]\n' 'where = .\n' 'include =\n' ' fake_package.sub_one\n' ' two\n' ) with get_dist(tmpdir) as dist: assert dist.packages == ['fake_package.sub_one'] config.write( '[options]\n' 'packages = find_namespace:\n' '\n' '[options.packages.find]\n' 'exclude =\n' ' fake_package.sub_one\n' ) with get_dist(tmpdir) as dist: assert set(dist.packages) == {'fake_package', 'fake_package.sub_two'} def test_extras_require(self, tmpdir): fake_env( tmpdir, '[options.extras_require]\n' 'pdf = ReportLab>=1.2; RXP\n' 'rest = \n' ' docutils>=0.3\n' ' pack ==1.1, ==1.3\n', ) with get_dist(tmpdir) as dist: assert dist.extras_require == { 'pdf': ['ReportLab>=1.2', 'RXP'], 'rest': ['docutils>=0.3', 'pack==1.1,==1.3'], } assert set(dist.metadata.provides_extras) == {'pdf', 'rest'} @pytest.mark.parametrize( "config", [ "[options.extras_require]\nfoo = bar;python_version<'3'", "[options.extras_require]\nfoo = bar;os_name=='linux'", "[options.extras_require]\nfoo = bar;python_version<'3'\n", "[options.extras_require]\nfoo = bar;os_name=='linux'\n", "[options]\ninstall_requires = bar;python_version<'3'", "[options]\ninstall_requires = bar;os_name=='linux'", "[options]\ninstall_requires = bar;python_version<'3'\n", "[options]\ninstall_requires = bar;os_name=='linux'\n", ], ) def test_raises_accidental_env_marker_misconfig(self, config, tmpdir): fake_env(tmpdir, config) match = ( r"One of the parsed requirements in `(install_requires|extras_require.+)` " "looks like a valid environment marker.*" ) with pytest.raises(InvalidRequirement, match=match): with get_dist(tmpdir) as _: pass @pytest.mark.parametrize( "config", [ "[options.extras_require]\nfoo = bar;python_version<3", "[options.extras_require]\nfoo = bar;python_version<3\n", "[options]\ninstall_requires = bar;python_version<3", "[options]\ninstall_requires = bar;python_version<3\n", ], ) def test_warn_accidental_env_marker_misconfig(self, config, tmpdir): fake_env(tmpdir, config) match = ( r"One of the parsed requirements in `(install_requires|extras_require.+)` " "looks like a valid environment marker.*" ) with pytest.warns(SetuptoolsDeprecationWarning, match=match): with get_dist(tmpdir) as _: pass @pytest.mark.parametrize( "config", [ "[options.extras_require]\nfoo =\n bar;python_version<'3'", "[options.extras_require]\nfoo = bar;baz\nboo = xxx;yyy", "[options.extras_require]\nfoo =\n bar;python_version<'3'\n", "[options.extras_require]\nfoo = bar;baz\nboo = xxx;yyy\n", "[options.extras_require]\nfoo =\n bar\n python_version<3\n", "[options]\ninstall_requires =\n bar;python_version<'3'", "[options]\ninstall_requires = bar;baz\nboo = xxx;yyy", "[options]\ninstall_requires =\n bar;python_version<'3'\n", "[options]\ninstall_requires = bar;baz\nboo = xxx;yyy\n", "[options]\ninstall_requires =\n bar\n python_version<3\n", ], ) @pytest.mark.filterwarnings("error::setuptools.SetuptoolsDeprecationWarning") def test_nowarn_accidental_env_marker_misconfig(self, config, tmpdir, recwarn): fake_env(tmpdir, config) num_warnings = len(recwarn) with get_dist(tmpdir) as _: pass # The examples are valid, no warnings shown assert len(recwarn) == num_warnings def test_dash_preserved_extras_require(self, tmpdir): fake_env(tmpdir, '[options.extras_require]\nfoo-a = foo\nfoo_b = test\n') with get_dist(tmpdir) as dist: assert dist.extras_require == {'foo-a': ['foo'], 'foo_b': ['test']} def test_entry_points(self, tmpdir): _, config = fake_env( tmpdir, '[options.entry_points]\n' 'group1 = point1 = pack.module:func, ' '.point2 = pack.module2:func_rest [rest]\n' 'group2 = point3 = pack.module:func2\n', ) with get_dist(tmpdir) as dist: assert dist.entry_points == { 'group1': [ 'point1 = pack.module:func', '.point2 = pack.module2:func_rest [rest]', ], 'group2': ['point3 = pack.module:func2'], } expected = ( '[blogtool.parsers]\n' '.rst = some.nested.module:SomeClass.some_classmethod[reST]\n' ) tmpdir.join('entry_points').write(expected) # From file. config.write('[options]\nentry_points = file: entry_points\n') with get_dist(tmpdir) as dist: assert dist.entry_points == expected def test_case_sensitive_entry_points(self, tmpdir): fake_env( tmpdir, '[options.entry_points]\n' 'GROUP1 = point1 = pack.module:func, ' '.point2 = pack.module2:func_rest [rest]\n' 'group2 = point3 = pack.module:func2\n', ) with get_dist(tmpdir) as dist: assert dist.entry_points == { 'GROUP1': [ 'point1 = pack.module:func', '.point2 = pack.module2:func_rest [rest]', ], 'group2': ['point3 = pack.module:func2'], } def test_data_files(self, tmpdir): fake_env( tmpdir, '[options.data_files]\n' 'cfg =\n' ' a/b.conf\n' ' c/d.conf\n' 'data = e/f.dat, g/h.dat\n', ) with get_dist(tmpdir) as dist: expected = [ ('cfg', ['a/b.conf', 'c/d.conf']), ('data', ['e/f.dat', 'g/h.dat']), ] assert sorted(dist.data_files) == sorted(expected) def test_data_files_globby(self, tmpdir): fake_env( tmpdir, '[options.data_files]\n' 'cfg =\n' ' a/b.conf\n' ' c/d.conf\n' 'data = *.dat\n' 'icons = \n' ' *.ico\n' 'audio = \n' ' *.wav\n' ' sounds.db\n', ) # Create dummy files for glob()'s sake: tmpdir.join('a.dat').write('') tmpdir.join('b.dat').write('') tmpdir.join('c.dat').write('') tmpdir.join('a.ico').write('') tmpdir.join('b.ico').write('') tmpdir.join('c.ico').write('') tmpdir.join('beep.wav').write('') tmpdir.join('boop.wav').write('') tmpdir.join('sounds.db').write('') with get_dist(tmpdir) as dist: expected = [ ('cfg', ['a/b.conf', 'c/d.conf']), ('data', ['a.dat', 'b.dat', 'c.dat']), ('icons', ['a.ico', 'b.ico', 'c.ico']), ('audio', ['beep.wav', 'boop.wav', 'sounds.db']), ] assert sorted(dist.data_files) == sorted(expected) def test_python_requires_simple(self, tmpdir): fake_env( tmpdir, DALS( """ [options] python_requires=>=2.7 """ ), ) with get_dist(tmpdir) as dist: dist.parse_config_files() def test_python_requires_compound(self, tmpdir): fake_env( tmpdir, DALS( """ [options] python_requires=>=2.7,!=3.0.* """ ), ) with get_dist(tmpdir) as dist: dist.parse_config_files() def test_python_requires_invalid(self, tmpdir): fake_env( tmpdir, DALS( """ [options] python_requires=invalid """ ), ) with pytest.raises(Exception): with get_dist(tmpdir) as dist: dist.parse_config_files() def test_cmdclass(self, tmpdir): module_path = Path(tmpdir, "src/custom_build.py") # auto discovery for src module_path.parent.mkdir(parents=True, exist_ok=True) module_path.write_text( "from distutils.core import Command\nclass CustomCmd(Command): pass\n", encoding="utf-8", ) setup_cfg = """ [options] cmdclass = customcmd = custom_build.CustomCmd """ fake_env(tmpdir, inspect.cleandoc(setup_cfg)) with get_dist(tmpdir) as dist: cmdclass = dist.cmdclass['customcmd'] assert cmdclass.__name__ == "CustomCmd" assert cmdclass.__module__ == "custom_build" assert module_path.samefile(inspect.getfile(cmdclass)) def test_requirements_file(self, tmpdir): fake_env( tmpdir, DALS( """ [options] install_requires = file:requirements.txt [options.extras_require] colors = file:requirements-extra.txt """ ), ) tmpdir.join('requirements.txt').write('\ndocutils>=0.3\n\n') tmpdir.join('requirements-extra.txt').write('colorama') with get_dist(tmpdir) as dist: assert dist.install_requires == ['docutils>=0.3'] assert dist.extras_require == {'colors': ['colorama']} saved_dist_init = _Distribution.__init__ class TestExternalSetters: # During creation of the setuptools Distribution() object, we call # the init of the parent distutils Distribution object via # _Distribution.__init__ (). # # It's possible distutils calls out to various keyword # implementations (i.e. distutils.setup_keywords entry points) # that may set a range of variables. # # This wraps distutil's Distribution.__init__ and simulates # pbr or something else setting these values. def _fake_distribution_init(self, dist, attrs): saved_dist_init(dist, attrs) # see self._DISTUTILS_UNSUPPORTED_METADATA dist.metadata.long_description_content_type = 'text/something' # Test overwrite setup() args dist.metadata.project_urls = { 'Link One': 'https://example.com/one/', 'Link Two': 'https://example.com/two/', } @patch.object(_Distribution, '__init__', autospec=True) def test_external_setters(self, mock_parent_init, tmpdir): mock_parent_init.side_effect = self._fake_distribution_init dist = Distribution(attrs={'project_urls': {'will_be': 'ignored'}}) assert dist.metadata.long_description_content_type == 'text/something' assert dist.metadata.project_urls == { 'Link One': 'https://example.com/one/', 'Link Two': 'https://example.com/two/', } tests/config/__pycache__/test_apply_pyprojecttoml.cpython-310.pyc 0000644 00000063216 15030122015 0021240 0 ustar 00 o �h�p � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl m Z ddl Z ddl mZ ddlmZ ddlZdd lmZ dd lmZ dd lmZmZmZ dd lmZm Z dd l m Z ddl m Z m!Z! ddl"m#Z#m$Z$ ddl%m&Z&m'Z' e e(�j)Z*dZ+dd� Z,dd� Z-e j.�/de'e*e+ ��e j.�0d�e j.j1dd� ���Z2dZ3d Z4d Z5d Z6d Z7d e3fd!d"�Z8d#d$� Z9e j.�/d%g d&��d'd(� �Z:d)d*� Z;d+d,� Z<e j.�/d-e j=e3d.d/d0�e j=e4d1e j.j>d2d3d4�d5d6�f�d7d8� �Z?e j.�/d9e j=e6d:dd;d<d=e j.�0d>�gd?�e j=e7dd@dAdBdCd0�f�dDdE� �Z@dFdG� ZAdHdI� ZBG dJdK� dK�ZCG dLdM� dM�ZDG dNdO� dO�ZEG dPdQ� dQ�ZFG dRdS� dS�ZGG dTdU� dU�ZHG dVdW� dW�ZIG dXdY� dY�ZJd^d\d]�ZKdS )_z�Make sure that applying the configuration from pyproject.toml is equivalent to applying a similar configuration from setup.cfg To run these tests offline, please have a look on ``./downloads/preload.py`` � )� annotationsN)�cleandoc)�Path)�Mock)�LiteTranslator)�Metadata)� is_static)�write_requirements)�expand� pyprojecttoml�setupcfg)�_MissingDynamic�_some_attrgetter�� Distribution)�InvalidConfigError�RemovedConfigError)�InformationOnly� SetuptoolsDeprecationWarning� )� retrieve_file�urls_from_filezsetupcfg_examples.txtc K s t d| i|��S )N�src_rootr )�path�attrs� r �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py�makedist# s r c O s dd� | D �S )z� Allow comparing the given patterns for 2 dist objects. We need to strip special chars to avoid errors when validating. c S s$ g | ]}t jd d|t jd�pd�qS )z [^a-z0-9]+� )�flags�empty)�re�sub�I)�.0�pr r r � <listcomp>, s $ z)_mock_expand_patterns.<locals>.<listcomp>r )�patterns�_�__r r r �_mock_expand_patterns' s r* �url�ignorec C s |� tdtdd�� |� tdttd�� t| �}t|d�}|jdd�}t� � |d �}|j |dd� t � t |�|�}t� t |�|�}t|�} t|�} | | ksOJ �td d � ||fD ��rft|j�t|j�ksfJ �td d � ||fD ��r�t|j� d d� |j�� D �} dd� |j�� D �} | | ks�J �tdd � ||fD ��r�dd� |j�� D �} dd� |j�� D �}| |ks�J �tdd � ||fD ��r�dd� |jD �}dd� |jD �}||ks�J �t|j�t|j�ks�J �tdd � ||fD ���r dd� |j�� D �}dd� |j�� D �}||k�s J �d S d S )N� read_attrz0.0.1)� return_value�_expand_patterns)� side_effect�pyproject.toml�utf-8��encodingz setup.cfgc s � � | ] }t |d d�V qdS )� license_filesN��getattr�r$ �dr r r � <genexpr>D � � z>test_apply_pyproject_equivalent_to_setupcfg.<locals>.<genexpr>c s r5 )� entry_pointsNr7 r9 r r r r; G r< c S �* h | ]\}}|gt d d� |D ���R �qS )c s � � | ] }|� d d�V qdS �� r N��replace�r$ �ir r r r; J r< �Htest_apply_pyproject_equivalent_to_setupcfg.<locals>.<setcomp>.<genexpr>��sorted�r$ �k�vr r r � <setcomp>I � ��z>test_apply_pyproject_equivalent_to_setupcfg.<locals>.<setcomp>c S r> )c s r? r@ rB rD r r r r; N r< rF rG rI r r r rL M rM c s r5 )� package_dataNr7 r9 r r r r; S r< c S � h | ] \}}|gt |��R �qS r rG rI r r r rL T � c S rO r rG rI r r r rL U rP c s r5 )� data_filesNr7 r9 r r r r; X r< c S rO r rG rI r r r rL Y rP c S rO r rG rI r r r rL Z rP c s r5 )�extras_requireNr7 r9 r r r r; ^ r< c S rO r rG rI r r r rL _ rP c S rO r rG rI r r r rL ` rP )�setattrr r r r* r r � read_textr � translate� write_textr �apply_configurationr r � core_metadata�any�setr6 �printr= �itemsrN rQ �install_requiresrR )r+ � monkeypatch�tmp_path�setupcfg_example�pyproject_example� setupcfg_text� toml_config� dist_toml�dist_cfg� pkg_info_toml� pkg_info_cfg�ep_toml�ep_cfg� pkg_data_toml� pkg_data_cfg�data_files_toml�data_files_cfg�extra_req_toml� extra_req_cfgr r r �+test_apply_pyproject_equivalent_to_setupcfg/ sP � �� �rp u� [project] name = "spam" version = "2020.0.0" description = "Lovely Spam! Wonderful Spam!" readme = "README.rst" requires-python = ">=3.8" license-files = ["LICENSE.txt"] # Updated to be PEP 639 compliant keywords = ["egg", "bacon", "sausage", "tomatoes", "Lobster Thermidor"] authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] maintainers = [ {name = "Brett Cannon", email = "brett@python.org"}, {name = "John X. Ãørçeč", email = "john@utf8.org"}, {name = "Γαμα קּ 東", email = "gama@utf8.org"}, ] classifiers = [ "Development Status :: 4 - Beta", "Programming Language :: Python" ] dependencies = [ "httpx", "gidgethub[httpx]>4.0.0", "django>2.1; os_name != 'nt'", "django>2.0; os_name == 'nt'" ] [project.optional-dependencies] test = [ "pytest < 5.0.0", "pytest-cov[all]" ] [project.urls] homepage = "http://example.com" documentation = "http://readthedocs.org" repository = "http://github.com" changelog = "http://github.com/me/spam/blob/master/CHANGELOG.md" [project.scripts] spam-cli = "spam:main_cli" [project.gui-scripts] spam-gui = "spam:main_gui" [project.entry-points."spam.magical"] tomatoes = "spam:main_tomatoes" u� [project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] maintainers = [ {name = "Степан Бандера", email = "криївка@оун-упа.укр"}, ] zE def main_cli(): pass def main_gui(): pass def main_tomatoes(): pass z�[project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] license = {text = "MIT"} a# [project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] license = "mit or apache-2.0" # should be normalized in metadata classifiers = [ "Development Status :: 5 - Production/Stable", "Programming Language :: Python", ] z README.rstc C s� | d }|}dd|� d�i}|� � D ] \}}|�||�}q|j|dd� | | jddd� | d jd dd� | d jtdd� |S ) Nr1 zreadme = "README.rst"z readme = "�"r2 r3 z hello world� LICENSE.txt�--- LICENSE stub ---zspam.py)r\ rC rV �PEP621_EXAMPLE_SCRIPT)r_ �readme�pyproject_text� pyproject�text� replacements�orig�substr r r �_pep621_example_project� s r| c C s2 t | �}t�t| �|�}t|jj�dhksJ �dS )z&Make sure the example in PEP 621 worksrr N)r| r rW r rZ �metadatar6 �r_ rw �distr r r �test_pep621_example� s r� )ru �ctype))z Readme.txtz text/plain)z readme.mdz text/markdown)ztext.rstz text/x-rstc C s. t | |�}t�t| �|�}|jj|ksJ �d S �N�r| r rW r r} � long_description_content_type)r_ ru r� rw r r r r �test_readme_content_type� s r� c C sN t | d�}tjtdd�� t�t| �|� W d � d S 1 s w Y d S )Nz README.texz%Undefined content type for README.tex��match)r| �pytest�raises� ValueErrorr rW r )r_ rw r r r �test_undefined_content_type� s "�r� c C s. t | d�}t�t| �|�}|jjd u sJ �d S )N�READMEr� r~ r r r �3test_no_explicit_content_type_for_missing_extension� s r� )rv � expected_maintainers_meta_valueug Brett Cannon <brett@python.org>, "John X. Ãørçeč" <john@utf8.org>, Γαμα קּ 東 <gama@utf8.org>znon-international-emails)�iduA Степан Бандера <криївка@оун-упа.укр>zlCPython's `email.headerregistry.Address` only supports RFC 5322, as of Nov 10, 2022 and latest Python 3.11.0T)�reason�strictzinternational-email)�marksr� c C s� t |d|d�}t�t|�|�}|jj| ksJ �|d }t|ddd��}|j�|� W d � n1 s3w Y |jdd�}d| � �|v sGJ �d S )Nr� �rv �PKG-FILE�wr2 r3 zMaintainer-email: ) r| r rW r r} �maintainer_email�open�write_pkg_filerT )r� rv r_ rw r �pkg_file�fh�contentr r r � test_utf8_maintainer_in_metadata� s � � r� )rv �license�license_expression� content_str�not_content_str�MITz License: MITzLicense-Expression: z license-textz6ignore:.project.license. as a TOML table is deprecated)r� r� zMIT OR Apache-2.0z%License-Expression: MIT OR Apache-2.0z License: zlicense-expressionc C s� t |d|d�}t�t|�|�}|jj| ksJ �|jj|ks J �|d }t|ddd��} |j�| � W d � n1 s;w Y |j dd�} d| v sLJ �|| v sRJ �|| vsXJ �d S )Nr� r� r� r� r2 r3 zMetadata-Version: 2.4) r| r rW r r} r� r� r� r� rT ) r� r� r� r� rv r_ rw r r� r� r� r r r �test_license_in_metadata# s (� � r� c C sz t �dd�d }t| d|� d��}d}tjt|d��}t�t| �|� W d � n1 s-w Y dt |j �v s;J �d S ) N� � r r� z/ "License :: OSI Approved :: MIT License" ]z?License classifiers have been superseded by license expressionsr� �&License :: OSI Approved :: MIT License) �PEP639_LICENSE_EXPRESSION�rsplitr| r� r� r r rW r �str�value)r_ rx rw �msg�excr r r �/test_license_classifier_with_license_expression\ s � �r� c C s� d}t | d|�}d}d}tjt|d��' tjt|d�� t�t| �|�}W d � n1 s.w Y W d � n1 s=w Y |j�� dgksLJ �d S )Nz� [project] name = "spam" version = "2020.0.0" license = {text = "mit or apache-2.0"} classifiers = ["License :: OSI Approved :: MIT License"] r� z5License classifiers are deprecated(?:.| )*MIT License�/.project.license. as a TOML table is deprecatedr� r� ) r| r� �warnsr r rW r r} �get_classifiers)r_ rx rw �msg1�msg2r r r r �2test_license_classifier_without_license_expressionj s � � �� r� c @ sT e Zd Z ddd�Zddd�Zdd� Zd d � Zd d � Zd d� Zdd� Z dd� Z dS )�TestLicenseFilesr �!license = {file = "LICENSE.txt"} c C sh t }d|v sJ �d|vsJ �d|vsJ �tjd||dd�}||v s#J �|� d|� d�}t|d|d �}|S ) Nz license = "mit or apache-2.0"z license-filesz[tool.setuptools]z(license = .*)\nr )�countr� r� r� )r� r! r" r| )�selfr_ �additional_text� license_tomlrx rw r r r �base_pyproject� s � z TestLicenseFiles.base_pyprojectc C s | j ||dd�S )Nz>license = "licenseref-Proprietary" license-files = ["_FILE*"] )r� r� )r� )r� r_ r� r r r � base_pyproject_license_pep639� s �z.TestLicenseFiles.base_pyproject_license_pep639c C s� d}| � ||�}|d �� |d �� |d }|jddd� d}d }tjt|d ��' tjt|d �� t�t|�|�}W d � n1 sEw Y W d � n1 sTw Y t |j j �ddhkseJ �|j j dksmJ �d S ) N�,[tool.setuptools] license-files = ["_FILE*"]� _FILE.txt� _FILE.rstrr zLicenseRef-Proprietary r2 r3 zQ'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'r� r� ) r� �touchrV r� r� r r rW r rZ r} r6 r� )r� r_ �setuptools_configrw r� r� r� r r r r �+test_both_license_and_license_files_defined� s$ � � �� z<TestLicenseFiles.test_both_license_and_license_files_definedc C s� | � |�}|d �� |d �� d}tjt|d�� t�t|�|�}W d � n1 s-w Y t|j j �ddhks>J �|j j d u sFJ �|j j dksNJ �d S )Nr� r� zNormalizing.*LicenseRefr� zLicenseRef-Proprietary) r� r� r� r� r r rW r rZ r} r6 r� r� )r� r_ rw r� r r r r �2test_both_license_and_license_files_defined_pep639� s �zCTestLicenseFiles.test_both_license_and_license_files_defined_pep639c C sX d}| � ||�}d}tjt|d�� t�t|�|� W d � d S 1 s%w Y d S )Nr� zR'project.license-files' is defined already. Remove 'tool.setuptools.license-files'r� )r� r� r� r r rW r )r� r_ r� rw r� r r r � test_license_files_defined_twice� s "�z1TestLicenseFiles.test_license_files_defined_twicec C s~ d}| j ||dd�}d�� }|D ]}|| j|� d�dd� qt�t|�|�}|d �� s/J �t|jj �h |�d�ks=J �d S ) Nz"[tool.setuptools] zip-safe = falser )r� z5LICENCE-a.html COPYING-abc.txt AUTHORS-xyz NOTICE,defr� r2 r3 rr ) r� �splitrV r rW r �existsrZ r} r6 )r� r_ r� rw r6 �fnamer r r r �test_default_patterns� s z&TestLicenseFiles.test_default_patternsc C s� | � |�}t|�d��g ksJ �d}d}tjt|d��0 tjt|d�� t�t |�|� W d � n1 s6w Y W d � d S W d � d S 1 sNw Y d S )Nz_FILE*z-Cannot find any files for the given pattern.*z@Normalizing 'licenseref-Proprietary' to 'LicenseRef-Proprietary'r� ) r� �list�globr� r� r r r rW r )r� r_ rw r� r� r r r �test_missing_patterns� s � �P�z&TestLicenseFiles.test_missing_patternsc C s� dt v sJ �t �dd�}t||d�}d}tjt|d�� t�t|�|�}W d � n1 s.w Y |j j dks;J �t |j j �dhksFJ �dS ) z?Make sure the old example with ``license = {text = ...}`` worksz license-files = ["LICENSE.txt"]z license = {file = "LICENSE.txt"}r� r� r� Nrs rr ) �PEP621_EXAMPLErC r| r� r� r r rW r r} r� rZ r6 )r� r_ rx rw r� r r r r �$test_deprecated_file_expands_to_text� s � �z5TestLicenseFiles.test_deprecated_file_expands_to_textN)r r� �r ) �__name__� __module__� __qualname__r� r� r� r� r� r� r� r� r r r r r� � s � r� c @ sH e Zd Zdd� Zej�dddg�dd� �Zej�dg d��d d � �Zd S ) � TestPyModulesc C s6 d|�d�}t d�}|jt|�dd� t�ti �|�S )Nzr [project] name = "test" version = "42.0" [tool.setuptools] py-modules = [z ] r1 r2 r3 )r rV r r rW r )r� �namerc rw r r r r � s �zTestPyModules.dist�modulezpip-runu abc-d.λ-xyz-ec C s" |� |� || �|�jv sJ �d S r� )�chdirr � py_modules�r� r_ r^ r� r r r �test_valid_module_name s z$TestPyModules.test_valid_module_name)zpip runz-pip-runz pip-run-stubsc C sJ |� |� tjtdd�� | �|�j W d � d S 1 s w Y d S )Nz py-modulesr� )r� r� r� r� r r� r� r r r �test_invalid_module_name s "�z&TestPyModules.test_invalid_module_nameN) r� r� r� r r� �mark� parametrizer� r� r r r r r� � s r� c @ � e Zd Zdd� ZdS )�TestExtModulesc C s� |� |� td�}d}|jt|�dd� t�tj�� t�t i �|�}W d � n1 s-w Y t |j �dks;J �|j d j dksEJ �t |j d j�dd hksSJ �d S ) Nr1 z� [project] name = "test" version = "42.0" [tool.setuptools] ext-modules = [ {name = "my.ext", sources = ["hello.c", "world.c"]} ] r2 r3 r r zmy.extzhello.czworld.c)r� r rV r r� r� r �_ExperimentalConfigurationrW r �len� ext_modulesr� rZ �sources)r� r_ r^ rw rc r r r r � test_pyproject_sets_attribute s � z,TestExtModules.test_pyproject_sets_attributeN)r� r� r� r� r r r r r� � r� c @ r� )�TestDeprecatedFieldsc C sb |d }d}|j t|�dd� tjtdd�� t�t|�|� W d � d S 1 s*w Y d S )Nr1 z� [project] name = "myproj" version = "42" [tool.setuptools] namespace-packages = ["myproj.pkg"] r2 r3 znamespace-packagesr� )rV r r� r� r r rW r )r� r_ rw �configr r r �test_namespace_packages- s "�z,TestDeprecatedFields.test_namespace_packagesN)r� r� r� r� r r r r r� , r� r� c @ s e Zd Zd)dd�Zej�ddejddej�d�gi�d d d gfd d d dgifd dddgifejdddgfdej�d�gi�g�dd� �Z ej�ddddg fddi fdddgfd d d gfg�dd� �Z d d � Z d d � Z d d!� Z ej�d"d#d$g�ej�d%�d&d'� ��Zd(S )*�TestPresetFieldr c C s: d|�d�}d|vr|d7 }|d }|j || dd� |S )Nz"[project] name = 'proj' dynamic = r� �versionzversion = '42' r1 r2 r3 )rV )r� r_ �dynamic� extra_contentr� �filer r r rw < s zTestPresetField.pyproject)�attr�fieldr� )r� r� r� )r� r� zNot SPDXr� z ignore:.*license. overwritten� classifierszPrivate :: Classifierr= �scripts�console_scripts�foobar=foobar:main� gui-scripts� gui_scriptszbazquux=bazquux:mainr] � dependencies�sixz&ignore:.*install_requires. overwrittenc C s� | � |g �}t|fi ||i��}t�d|� �tj�}tjt|d�� t� ||�}W d � n1 s2w Y t d|� �|�|�}|rEJ �dS )z:Setuptools cannot set a field if not listed in ``dynamic``z&defined outside of `pyproject.toml`:.*r� N� metadata.) rw r r! �compile�Sr� r� r r rW r ) r� r_ r� r� r� rw r r� � dist_valuer r r �test_not_listed_in_dynamicD s � z*TestPresetField.test_not_listed_in_dynamicrR zoptional-dependenciesc C sR | � ||g�}t|fi ||i��}t�||�}td|� �|�|�}||ks'J �d S )Nr� )rw r r rW r )r� r_ r� r� r� rw r r� r r r �test_listed_in_dynamicb s z&TestPresetField.test_listed_in_dynamicc C sX |� |� | �|g �}t|dgd�}|d jddd� t�||�}|jjdgks*J �dS )ap license-file is currently not considered in the context of dynamic. As per 2025-02-19, https://packaging.python.org/en/latest/specifications/pyproject-toml/#license-files allows setuptools to fill-in `license-files` the way it sees fit: > If the license-files key is not defined, tools can decide how to handle license files. > For example they can choose not to include any files or use their own > logic to discover the appropriate files in the distribution. Using license_files from setup.py to fill-in the value is in accordance with this rule. zLIC*)r6 �LIC1�42r2 r3 N)r� rw r rV r rW r} r6 )r� r^ r_ rw r r r r �&test_license_files_exempt_from_dynamics s z6TestPresetField.test_license_files_exempt_from_dynamicc C sr d}|d }|j |dd� t|dgd�}tjdd�� t�||�}W d � n1 s+w Y d|jvs7J �d S ) Nz:[project] name='pkg' version='0.1' dependencies=['click'] r1 r2 r3 �wheel�r] z `install_requires` overwrittenr� )rV r r� r� r rW r] )r� r_ �srcrw r r r r �%test_warning_overwritten_dependencies� s �z5TestPresetField.test_warning_overwritten_dependenciesc C s� d}| � |dg|�}dg}t||d�}t�||�}d|jv s J �|�d�}t|||d � |d jdd �}d |v s;J �d |v sAJ �d |v sGJ �d S )a# Internally setuptools converts dependencies with markers to "extras". If ``install_requires`` is given by ``setup.py``, we have to ensure that applying ``optional-dependencies`` does not overwrite the mandatory dependencies with markers (see #3204). z1 [project.optional-dependencies] foo = ['bar>1'] r� z6importlib-resources (>=3.0.0) ; python_version < "3.7"r� �foo�egg_infoz requires.txtr2 r3 zimportlib-resources�barz:python_version < "3.7"N)rw r r rW rR �get_command_objr rT )r� r_ �extrarw � install_reqr r �reqsr r r �2test_optional_dependencies_dont_remove_env_markers� s zBTestPresetField.test_optional_dependencies_dont_remove_env_markers)r� �group)r� r� )r� r� �errorc C s> | � ||g�}t||dgid�}t�||�}||jv s J �d S )Nr� )r= )rw r r rW r= )r� r_ r� r rw r r r r �.test_scripts_dont_require_dynamic_entry_points� s z>TestPresetField.test_scripts_dont_require_dynamic_entry_pointsNr� )r� r� r� rw r� r� r� �param�filterwarningsr� r� r� r r r r r r r r� ; sR � � � ���� �� � r� c @ r� )�TestMetac C sJ t �|��}tdd� |�� D ��sJ �W d � dS 1 s w Y dS )z,Meta test to ensure tests can run from sdistc s s � | ]}|� t�V qd S r� )�endswith� EXAMPLES_FILE)r$ r� r r r r; � s � z6TestMeta.test_example_file_in_sdist.<locals>.<genexpr>N)�tarfiler� rY �getnames)r� �setuptools_sdist�tarr r r �test_example_file_in_sdist� s "�z#TestMeta.test_example_file_in_sdistN)r� r� r� r r r r r r � r� r c @ r� )� TestInteropCommandLineParsingc C sf |� |� d}t|d�}|jt|�dd� ddgi}t�t|�|�}|�� |�� }d|j v s1J �d S )NzJ [project] name = "test" version = "42.0" r1 r2 r3 � script_argsz --versionz42.0) r� r rV r r rW r �parse_command_line� readouterr�out) r� r_ r^ �capsysrc rw �optsr �capturedr r r � test_version� s z*TestInteropCommandLineParsing.test_versionN)r� r� r� r r r r r r � r� r c @ r� )�TestStaticConfigc C s� |� |� d}t|d�}|jt|�dd� t�ti �|�}t|j�s$J �t|j j �s,J �t|j j �s4J �t|j j �s<J �t|j j �sDJ �t|j j�sLJ �d S )Na) [project] name = "test" version = "42.0" dependencies = ["hello"] keywords = ["world"] classifiers = ["private :: hello world"] [tool.setuptools] obsoletes = ["abcd"] provides = ["abcd"] platforms = ["abcd"] r1 r2 r3 )r� r rV r r rW r r r] r} �keywordsr� � obsoletes�provides� platforms)r� r_ r^ rc rw r r r r �test_mark_static_fields� s z(TestStaticConfig.test_mark_static_fieldsN)r� r� r� r$ r r r r r � r� r �returnr� c C s� t �� �}| j�|� |�� }W d � n1 sw Y tj|dd� d}t� }|d7 }|d7 }|d7 }|�d� g }|� � D ]}|� |�sL||v rMqA|� |d � qAd� |�S ) NT)�validater )zAuthor:z Author-email:z Maintainer:zMaintainer-email:)zProject-URL: Homepage,z Home-page:)zDescription-Content-Type:r r� ) �io�StringIOr} r� �getvaluer � from_emailrZ �add� splitlines� startswith�append�join)r �buffer� pkg_file_txt� skip_prefixes� skip_lines�result�liner r r rX � s" � rX )r% r� )L�__doc__� __future__r r' r! r �inspectr �pathlibr � unittest.mockr r� � ini2toml.apir �packaging.metadatar � setuptools�setuptools._staticr �setuptools.command.egg_infor �setuptools.configr r r �&setuptools.config._apply_pyprojecttomlr r �setuptools.distr �setuptools.errorsr r �setuptools.warningsr r � downloadsr r �__file__�parent�HEREr r r* r� r� r � uses_networkrp r� �"PEP621_INTERNATIONAL_EMAIL_EXAMPLErt �PEP639_LICENSE_TEXTr� r| r� r� r� r� r �xfailr� r� r� r� r� r� r� r� r� r r r rX r r r r �<module> s� 24 �� ����� ��� ��� |x tests/config/__pycache__/__init__.cpython-310.pyc 0000644 00000000260 15030122015 0015606 0 ustar 00 o �h � @ s d S )N� r r r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/__init__.py�<module> s tests/config/__pycache__/test_expand.cpython-310.pyc 0000644 00000017174 15030122015 0016401 0 ustar 00 o �h�" � @ s� d dl Z d dlZd dlmZ d dlZd dlmZ d dlmZ d dl m Z d dl m Z dd� Z d d � Zd d � ZG d d� d�Zej�dddidddfddidddfi dddfi d d d fg�d d � �Zej�d!d"gd#d$�dd%hfd"d&gd#d$�h d'�fd(d)ih d*�fi h d*�fg�d+d,� �Zej�d-d.d/gd"gi fd.d0gd"gi fd1d2gdgddifd1d3gdgddifd4d5gd6d7gd8d9d:�fd1d0gdd"gd;d<ifg�d=d>� �ZdS )?� N)�Path)� is_static)�expand)�find_package_path)�DistutilsOptionErrorc C s< | � � D ]\}}|| }|jjddd� |j|dd� qd S )NT)�exist_ok�parentszutf-8)�encoding)�items�parent�mkdir� write_text)�files�root_dir�file�content�path� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/test_expand.py� write_files s �r c C s` h d�}t dd� |D �| � g d�}|�| � tt�|��|ks"J �tt�|| ��|ks.J �d S )N> �a.ini�b.ini� dir1/c.ini�dir1/file3.txt�dir1/dir2/a.ini�dir1/dir2/file2.txt�dir1/dir2/dir3/file1.txtc S � i | ]}|d �qS �� r ��.0�kr r r � <dictcomp> � z&test_glob_relative.<locals>.<dictcomp>)z**/*.txtz[ab].*z **/[ac].ini)r �chdir�setr � glob_relative)�tmp_path� monkeypatchr �patternsr r r �test_glob_relative s r+ c C s� | d }| d j dd� | d �� dddd �}t||� tt|�d �}|j dd� td d i|� |�� �V}|�|� t�t |��d ksGJ �d}t j t |d�� t�dg� W d � n1 saw Y d}t j t |d�� t�dg� W d � n1 s�w Y W d � n1 s�w Y t�t |�|�d ks�J �t j t |d�� t�dg|� W d � d S 1 s�w Y d S )N�dir_�_dirT)r �a.txt�a�b�c)r. z dir1/b.txtzdir1/dir2/c.txt�secretsz secrets.txtz secret keysza b cz Cannot access '.*\.\..a\.txt')�matchz../a.txtz Cannot access '.*secrets\.txt'z../dir_secrets/secrets.txt) r �touchr r �str�contextr% r � read_files�list�pytest�raisesr )r( r) r, r r2 �m�cannot_access_msg�cannot_access_secrets_msgr r r �test_read_files( s2 � �� � "�r> c @ sj e Zd Zej�dg d��dd� �Zdd� Zej�dddg�d d � �Zej�dg d ��d d � �Z dd� Z dS )� TestReadAttr�example)s' __version__ = 'é' raise SystemExit(1) s? # -*- coding: utf-8 -*- __version__ = 'é' raise SystemExit(1) s? # -*- coding: latin1 -*- __version__ = '�' raise SystemExit(1) c C s( |d � |� tjd|d�dksJ �d S )Nzmod.pyzmod.__version__�r � é)� write_bytesr � read_attr)�selfr@ r( r r r � test_read_attr_encoding_cookieF s z+TestReadAttr.test_read_attr_encoding_cookiec C s� dddd�}t ||� |�� �}|�|� t�d�}t�dddi�}W d � n1 s,w Y |d ks7J �t|�s=J �|d d ksEJ �|d d hksNJ �t|�sTJ �tjd|d�d ks_J �t�dddi|�}|d dkspJ �d S )Nr zVERSION = '0.1.1'z@VALUES = {'a': 0, 'b': {42}, 'c': (0, 1, 1)} raise SystemExit(1))�pkg/__init__.py�pkg/sub/__init__.pyzpkg/sub/mod.py�pkg.sub.VERSIONzlib.mod.VALUES�libzpkg/sub�0.1.1r/ r r0 �* rA r1 )r � rM )r r6 r% r rD r )rE r( r) r r; �version�valuesr r r �test_read_attrT s$ � � zTestReadAttr.test_read_attrz3VERSION: str VERSION = '0.1.1' raise SystemExit(1) z+VERSION: str = '0.1.1' raise SystemExit(1) c C s> d|d�}t ||� tjd|d�}|dksJ �t|�s J �d S )Nr �rG rH rI rA rK )r r rD r )rE r( r@ r rN r r r �test_read_annotated_attrp s � z%TestReadAttr.test_read_annotated_attr)z VERSION = (lambda: '0.1.1')() z(def fn(): return '0.1.1' VERSION = fn() z#VERSION: str = (lambda: '0.1.1')() c C sD d|d�}t ||� |�|� t�d�}|dksJ �t|�r J �d S )Nr rQ rI rK )r r% r rD r )rE r( r) r@ r rN r r r �test_read_dynamic_attr� s � z#TestReadAttr.test_read_dynamic_attrc C s< dddd�}t ||� d}ddi}t�|||�dks J �d S ) a* Sometimes the import machinery will import the parent package of a nested module, which triggers side-effects and might create problems (see issue #3176) ``read_attr`` should bypass these limitations by resolving modules statically (via ast.literal_eval). z1from .main import func from .about import versionz2import super_complicated_dep def func(): return 42zversion = '42')zsrc/pkg/__init__.py�src/pkg/main.pyzsrc/pkg/about.pyzpkg.about.versionr �src�42N)r r rD )rE r( r � attr_desc� package_dirr r r �test_import_order� s � z TestReadAttr.test_import_orderN) �__name__� __module__� __qualname__r9 �mark� parametrizerF rP rR rS rY r r r r r? E s( � �� � r? )rX r �module� return_valuer rU rT zpkg.mainrL �pkgrJ z lib/main.py� zsingle_module.py� single_module�F zflat_layout/pkg.pyzflat_layout.pkgiD c C sP | � tdi � |d|� �i}t||� t�|� d�||�}|� �� |ks&J �d S )N�modulesz,class Custom: def testing(self): return z.Custom)�setattr�sysr r � resolve_class�testing)r) r( rX r r_ r` r �clsr r r �test_resolve_class� s rk )�args�pkgs�.F)�where� namespaces�other�dir1> ra �dir2rq rp T> � dir1.dir2ra rr rq c s� h d�}t dd� |D �� � i }� |d�|�}|�ddg�}ttjd i |���|ks,J �|D ]}t||� �}tj�|�s>J �q.� fdd�|� ddg�D �}ttjd d|i|���|ks]J �d S ) N> �other/__init__.py�dir1/dir2/__init__.pyrG c S r r r r r r r r# � r$ z&test_find_packages.<locals>.<dictcomp>)r �fill_package_dirro rn c s& g | ]}t � | �� ��tjd ��qS )�/)r5 �resolve�replace�os�sep)r! �p�r( r r � <listcomp>� s ��z&test_find_packages.<locals>.<listcomp>r ) r �getr& r � find_packagesr r{ r �exists�pop) r( rl rm r rX �kwargsro ra �pkg_pathr r~ r �test_find_packages� s �$r� )r ro �expected_package_dirzpkg1/__init__.pyz pkg1/other.pyzpkg2/__init__.pyzsrc/pkg1/__init__.pyzsrc/pkg1/other.pyzsrc/pkg2/__init__.pyzsrc1/pkg1/__init__.pyzsrc2/pkg2/__init__.py�src1�src2z src1/pkg1z src2/pkg2)�pkg1�pkg2r� zsrc/pkg1c C s~ t dd� |D �| � i }| |dd�}tjdd|i|��}t|�� �t|�� �ks*J �|D ]}t||| �}tj�|�s<J �q,d S )Nc S r r r r r r r r# � r$ z)test_fill_package_dir.<locals>.<dictcomp>F)r rw rp ro r ) r r r� r& r r r{ r r� ) r( r ro r� �pkg_dirr� rm ra r� r r r �test_fill_package_dir� s �r� )r{ rg �pathlibr r9 �setuptools._staticr �setuptools.configr �setuptools.discoveryr �distutils.errorsr r r+ r> r? r] r^ rk r� r� r r r r �<module> s^ d �� �� ���� tests/config/__pycache__/test_setupcfg.cpython-310.pyc 0000644 00000066774 15030122015 0016754 0 ustar 00 o �h�� � @ s d dl Z d dlZd dlZd dlZd dlmZ d dlmZmZ d dl Z d dl m Z d dl m Z mZmZ d dlmZmZ d dlmZ dd lmZ d d lmZmZ G d d � d e e �Zd!dd�Z d"dd�Z ej d#dd��Z dd� Z G dd� d�Z G dd � d �Z!G d d � d �Z"ej#Z$G d d � d �Z%dS )$� N)�Path)�Mock�patch)�InvalidRequirement)� ConfigHandler�Target�read_configuration)� Distribution� _Distribution)� SetuptoolsDeprecationWarning� )�DALS)�DistutilsFileError�DistutilsOptionErrorc @ s e Zd ZdZdZdS )�ErrConfigHandlerz7Erroneous handler. Fails to implement required methods.z**err**N)�__name__� __module__� __qualname__�__doc__�section_prefix� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/test_setupcfg.pyr s r Fc C sB |}| � d�D ]}|�|�}qd }|s |�d�}|�d� ||fS )N�/� __init__.py� )�split�mkdir�join�write)�name�base_dir�ns� dir_package�dir_name� init_filer r r �make_package_dir s r% �ascii� fake_packagec C sZ |d u rd}| � d��|� | � d�}|j|�|�dd� t|| �\}}|�d� ||fS )Nz%from setuptools import setup setup() �setup.py� setup.cfg�wb)�modezWVERSION = (1, 2, 3) VERSION_MAJOR = 1 def get_version(): return [3, 4, 5, "dev"] )r r �encoder% )�tmpdir� setup_cfg�setup_py�encoding� package_path�config� package_dirr$ r r r �fake_env% s � r4 Tc c sp � |pi }| � � �% t|�}d|_|o"|�� |V W d � d S |V W d � d S 1 s1w Y d S )Nr( )�as_cwdr � script_name�parse_config_files)r- �kwargs_initial�parse�distr r r �get_dist> s � �"�r; c C sF t �t�� td i dt� �} | j W d � d S 1 s w Y d S )NF)�pytest�raises�NotImplementedErrorr r �parsers)�handlerr r r �test_parsers_implementedJ s "�rA c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�TestConfigurationReaderc C sb t |d�\}}tt|��}|d d dksJ �|d d ddgks#J �|d d d d gks/J �d S ) NzX[metadata] version = 10.1.1 keywords = one, two [options] scripts = bin/a.py, bin/b.py �metadata�version�10.1.1�keywords�one�two�options�scriptszbin/a.pyzbin/b.py)r4 r �str��selfr- �_r2 � config_dictr r r � test_basicQ s � z"TestConfigurationReader.test_basicc C sB t �t�� tt|�d��� W d � d S 1 sw Y d S )Nr) )r< r= r r rK r �rM r- r r r �test_no_config` s "�z&TestConfigurationReader.test_no_configc C s� t |d�\}}t�t�� tt|�� W d � n1 s w Y tt|�dd�}|d d ddgks6J �d|d vs>J �|�� d S ) Nz<[metadata] version = attr: none.VERSION keywords = one, two T)�ignore_option_errorsrC rF rG rH rD )r4 r< r= � ImportErrorr rK �removerL r r r �test_ignore_errorsd s � � z*TestConfigurationReader.test_ignore_errorsN)r r r rP rR rV r r r r rB P s rB c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zej�d)d*ed+�d,d-ifd.ed/�d0d1ifg�d2d3� �Zd4S )5� TestMetadatac C s� t |d� |�d��d� ddi}t||��V}|j}|jdks!J �|jdks(J �|jdks/J �|jdks6J �|j d d gks?J �|j dksFJ �|j d ksMJ �|j d d gksVJ �|j dks]J �|jdksdJ �W d � d S 1 sow Y d S )Na- [metadata] version = 10.1.1 description = Some description long_description_content_type = text/something long_description = file: README name = fake_name keywords = one, two provides = package, package.sub license = otherlic download_url = http://test.test.com/test/ maintainer_email = test@test.com �README�readme contents line2�licensezBSD 3-Clause LicenserE zSome description�text/something�packagez package.sub� fake_namerG rH �http://test.test.com/test/� test@test.com)r4 r r r; rC rD � description� long_description_content_type�long_description�providesrZ r rF � download_url�maintainer_email)rM r- � meta_initialr: rC r r r rP u s( �� "�zTestMetadata.test_basicc C sl t |td�� t|��!}|j}|jdksJ �|jdks J �|jdks$J �W d � d S 1 s/w Y d S )Nzr [metadata] name=foo version=0.0.1 license=Apache 2.0 �fooz0.0.1z Apache 2.0)r4 r r; rC r rD rZ �rM r- r: rC r r r �test_license_cfg� s �� "�z TestMetadata.test_license_cfgc C sh t |d� |�d��d� |�d��d� t|��}|jjdks"J �W d � d S 1 s-w Y d S )Nz=[metadata] long_description = file: README.rst, CHANGES.rst z README.rstrY z CHANGES.rstz changelog contents and stuffz2readme contents line2 changelog contents and stuff)r4 r r r; rC rb �rM r- r: r r r �test_file_mixed� s � �"�z TestMetadata.test_file_mixedc C s� |� d� |�dd�}|j dd� t|d� t|dd��*}t�t�� |�� W d � n1 s1w Y W d � d S W d � d S 1 sIw Y d S ) NrX �depth1�depth2T)�dirz1[metadata] long_description = file: ../../README F�r9 )�ensurer r4 r; r< r= r r7 )rM r- �projectr: r r r �test_file_sandboxed� s ��"�z TestMetadata.test_file_sandboxedc C s� t |d� t|��3}|j}|jdksJ �|jdksJ �|jdks"J �|jddgks+J �|jddgks4J �W d � d S 1 s?w Y d S ) Nz�[metadata] author_email = test@test.com home_page = http://test.test.com/test/ summary = Short summary platform = a, b classifier = Framework :: Django Programming Language :: Python :: 3.5 r_ r^ z Short summary�a�b�Framework :: Django�%Programming Language :: Python :: 3.5)r4 r; rC � author_email�urlr` � platforms� classifiersrh r r r � test_aliases� s � �"�zTestMetadata.test_aliasesc C sb t |d� t|�� }|j}|jddgksJ �|jddgks J �W d � d S 1 s*w Y d S )Nz[metadata] name = fake_name keywords = one two classifiers = Framework :: Django Programming Language :: Python :: 3.5 rG rH ru rv )r4 r; rC rF rz rh r r r �test_multiline� s � �"�zTestMetadata.test_multilinec C sR t |d� t|��}|j}|jddd�ksJ �W d � d S 1 s"w Y d S )Nzf[metadata] project_urls = Link One = https://example.com/one/ Link Two = https://example.com/two/ �https://example.com/one/�https://example.com/two/�zLink OnezLink Two)r4 r; rC � project_urlsrh r r r � test_dict� s � �"�zTestMetadata.test_dictc C s� t |d�\}}|�d�}|�d��d� |�d��d� |�d�}|�d��d� |�d��d� t|��}|jjd ks>J �W d � n1 sHw Y |�d � t|��}|jjd ks_J �W d � n1 siw Y |�d � t|��}|jjd ks�J �W d � n1 s�w Y |�d� t|��}|jjdks�J �W d � n1 s�w Y |�d� t|��}|jjdks�J �W d � d S 1 s�w Y d S )Nz0[metadata] version = attr: fake_package.VERSION �subpkg_ar r zmod.pyzVERSION = (2016, 11, 26)�subpkg_bz2import third_party_module VERSION = (2016, 11, 26)�1.2.3z4[metadata] version = attr: fake_package.get_version z 3.4.5.devz6[metadata] version = attr: fake_package.VERSION_MAJOR �1z=[metadata] version = attr: fake_package.subpkg_a.mod.VERSION z 2016.11.26z=[metadata] version = attr: fake_package.subpkg_b.mod.VERSION )r4 r r r r; rC rD )rM r- r3 r2 �sub_a�sub_br: r r r � test_version s< � � � � � � "�zTestMetadata.test_versionc C s� t |d� |�dd��d� t|��}|jjdksJ �W d � n1 s%w Y |�dd��d� t�t��) t|�� }|jj W d � n1 sLw Y W d � d S W d � d S 1 sdw Y d S )Nz4[metadata] version = file: fake_package/version.txt r' z version.txtz1.2.3 r� z 1.2.3 4.5.6 ) r4 r r r; rC rD r< r= r rj r r r �test_version_file# s � ��"�z TestMetadata.test_version_filec C �L t |ddd� t|��}|jjdksJ �W d � d S 1 s w Y d S )NzY[metadata] version = attr: fake_package_simple.VERSION [options] package_dir = = src zsrc/fake_package_simple�r1 r� �r4 r; rC rD rj r r r �$test_version_with_package_dir_simple/ � � "�z1TestMetadata.test_version_with_package_dir_simplec C r� )Nzr[metadata] version = attr: fake_package_rename.VERSION [options] package_dir = fake_package_rename = fake_dir �fake_dirr� r� r� rj r r r �$test_version_with_package_dir_rename= r� z1TestMetadata.test_version_with_package_dir_renamec C r� )Nzx[metadata] version = attr: fake_package_complex.VERSION [options] package_dir = fake_package_complex = src/fake_dir z src/fake_dirr� r� r� rj r r r �%test_version_with_package_dir_complexK r� z2TestMetadata.test_version_with_package_dir_complexc C sD t |d� t|dd�� }|�� W d � d S 1 sw Y d S )Nz+[metadata] name = fake_name unknown = some Fro )r4 r; r7 rj r r r �test_unknown_meta_itemY s "�z#TestMetadata.test_unknown_meta_itemc C �~ t |d� t|dd��*}t�t�� |�� W d � n1 s w Y W d � d S W d � d S 1 s8w Y d S )Nz[metadata.some] key = val Fro �r4 r; r< r= r r7 rj r r r �test_usupported_section^ � ��"�z$TestMetadata.test_usupported_sectionc C s� t g d��}t|d�\}}|�d��d� t|��}t |jj�|ks$J �W d � n1 s.w Y |�d� t|��}t |jj�|ksGJ �W d � d S 1 sRw Y d S )N)ru z#Programming Language :: Python :: 3rv z+[metadata] classifiers = file: classifiers rz z^Framework :: Django Programming Language :: Python :: 3 Programming Language :: Python :: 3.5 z�[metadata] classifiers = Framework :: Django Programming Language :: Python :: 3 Programming Language :: Python :: 3.5 )�setr4 r r r; rC rz )rM r- �expectedrN r2 r: r r r �test_classifiersd s � �� "�z TestMetadata.test_classifiersc C st t |d� t�tj��% t|�� W d � n1 sw Y W d � d S W d � d S 1 s3w Y d S )Nz%[metadata] description = %(message)s )r4 r< r= � configparser� InterpolationMissingOptionErrorr; rQ r r r �test_interpolation� s ��"�z TestMetadata.test_interpolationc C s< t |ddd� t|�� W d � d S 1 sw Y d S )Nu$ [metadata] description = éàïôñ �utf-8�r0 �r4 r; rQ r r r �test_non_ascii_1� s "�z TestMetadata.test_non_ascii_1c C s8 t |d� t|�� W d � d S 1 sw Y d S )Nz # -*- coding: invalid r� rQ r r r �test_non_ascii_3� s "�z TestMetadata.test_non_ascii_3c C r� )Nu8 # -*- coding: utf-8 [metadata] description = éàïôñ r� r� u éàïôñ)r4 r; rC r` rj r r r �test_non_ascii_4� s � "�z TestMetadata.test_non_ascii_4c C sv t |ddd� t�t��% t|�� W d � n1 s w Y W d � dS W d � dS 1 s4w Y dS )z= Config files encoded not in UTF-8 will fail uJ # vim: set fileencoding=iso-8859-15 : [metadata] description = éàïôñ z iso-8859-15r� N)r4 r< r= �UnicodeDecodeErrorr; rQ r r r � test_not_utf8� s � ��"�zTestMetadata.test_not_utf8)� error_msgr2 �invalidzCInvalid dash-separated key 'author-email' in 'metadata' (setup.cfg)z� [metadata] author-email = test@test.com maintainer_email = foo@foo.com z author-emailr_ z6Invalid uppercase key 'Name' in 'metadata' (setup.cfg)z� [metadata] Name = foo description = Some description �Namerg c C s� t ||� tjtt�|�d�� t|��� }W d � n1 s w Y |�d�� � |� � D ]\}}|� dd�� � }t |j|�|ksFJ �q0d S )N��matchr) �-rN )r4 r< �warnsr �re�escaper; � __enter__r rU �items�replace�lower�getattrrC ) rM r- r� r2 r� r: �field�value�attrr r r �*test_invalid_options_previously_deprecated� s ! ��z7TestMetadata.test_invalid_options_previously_deprecatedN) r r r rP ri rk rr r{ r| r� r� r� r� r� r� r� r� r� r� r� r� r� r� r< �mark� parametrizer r� r r r r rW t sL % " �� ����rW c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z e j � dg d��dd� �Ze j � dg d��dd� �Ze j � dg d��e j �d�dd� ��Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0S )1� TestOptionsc C s. t |d� tjtdd�}|� t|��b}|jsJ �|js J �|jddd�ks(J �|jddgks1J �|j d d gks:J �|j d d gksCJ �|j d dgksLJ �|j g d�ksUJ �|j g d�ks^J �|jdkseJ �|jddgksnJ �W d � n1 sxw Y W d � d S W d � d S 1 s�w Y d S )Na� [options] zip_safe = True include_package_data = yes package_dir = b=c, =src packages = pack_a, pack_b.subpack namespace_packages = pack1, pack2 scripts = bin/one.py, bin/two.py eager_resources = bin/one.py, bin/two.py install_requires = docutils>=0.3; pack ==1.1, ==1.3; hey setup_requires = docutils>=0.3; spack ==1.1, ==1.3; there dependency_links = http://some.com/here/1, http://some.com/there/2 python_requires = >=1.0, !=2.8 py_modules = module1, module2 �namespace_packagesr� �src�c�r rt �pack_a�pack_b.subpack�pack1�pack2� bin/one.py� bin/two.py�http://some.com/here/1�http://some.com/there/2�� docutils>=0.3�pack==1.1,==1.3�hey�r� zspack ==1.1, ==1.3�therez >=1.0, !=2.8�module1�module2)r4 r< r� r r; �zip_safe�include_package_datar3 �packagesr� rJ �dependency_links�install_requires�setup_requires�python_requires� py_modules�rM r- �deprecr: r r r rP � s* � �P�zTestOptions.test_basicc C s� t |d� tjtdd�}|�e t|��H}|jddd�ks J �|jddgks'J �|jd d gks0J �|jd d gks9J �|j d dgksBJ �|j g d�ksKJ �|j g d�ksTJ �W d � n1 s^w Y W d � d S W d � d S 1 svw Y d S )Na� [options] package_dir = b=c =src packages = pack_a pack_b.subpack namespace_packages = pack1 pack2 scripts = bin/one.py bin/two.py eager_resources = bin/one.py bin/two.py install_requires = docutils>=0.3 pack ==1.1, ==1.3 hey setup_requires = docutils>=0.3 spack ==1.1, ==1.3 there dependency_links = http://some.com/here/1 http://some.com/there/2 r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� ) r4 r< r� r r; r3 r� r� rJ r� r� r� r� r r r r| s" � �P�zTestOptions.test_multilinec C r� )Nz [options] package_dir = a b Fro r� rj r r r �test_package_dir_fail4 r� z!TestOptions.test_package_dir_failc C sl t |d� t|��#}|jddgdgd�ksJ �|jddgdgd�ks$J �W d � d S 1 s/w Y d S ) Nz}[options.package_data] * = *.txt, *.rst hello = *.msg [options.exclude_package_data] * = fake1.txt, fake2.txt hello = *.dat z*.txtz*.rstz*.msg)r �helloz fake1.txtz fake2.txtz*.dat)r4 r; � package_data�exclude_package_datarj r r r �test_package_data: s � ��"�z TestOptions.test_package_datac C sH t |d� t|��}|jdgksJ �W d � d S 1 s w Y d S )N�[options] packages = find: r' )r4 r; r� rj r r r � test_packagesP s "�zTestOptions.test_packagesc C s� t |d�\}}td|� td|� t|��}t|j�tg d��ks#J �W d � n1 s-w Y |�d� t|��}|jdgksDJ �W d � n1 sNw Y |�d� t|��}t|j�tdd g�ksjJ �W d � d S 1 suw Y d S ) Nr� �sub_one�sub_two)r' �fake_package.sub_two�fake_package.sub_onezi[options] packages = find: [options.packages.find] where = . include = fake_package.sub_one two r� zW[options] packages = find: [options.packages.find] exclude = fake_package.sub_one r' r� �r4 r% r; r� r� r �rM r- r" r2 r: r r r �test_find_directiveV s$ �� �� "�z TestOptions.test_find_directivec C s� t |d�\}}td|� td|dd� t|��}t|j�h d�ks#J �W d � n1 s-w Y |�d� t|��}|jdgksDJ �W d � n1 sNw Y |�d � t|��}t|j�d d hkshJ �W d � d S 1 ssw Y d S ) Nz%[options] packages = find_namespace: r� r� T)r! > r' r� r� zs[options] packages = find_namespace: [options.packages.find] where = . include = fake_package.sub_one two r� za[options] packages = find_namespace: [options.packages.find] exclude = fake_package.sub_one r' r� r� r� r r r � test_find_namespace_directive{ s( � �� �� "�z)TestOptions.test_find_namespace_directivec C sl t |d� t|��#}|jddgddgd�ksJ �t|jj�ddhks$J �W d � d S 1 s/w Y d S ) Nz_[options.extras_require] pdf = ReportLab>=1.2; RXP rest = docutils>=0.3 pack ==1.1, ==1.3 zReportLab>=1.2�RXPr� r� )�pdf�restr� r� )r4 r; �extras_requirer� rC �provides_extrasrj r r r �test_extras_require� s � �"�z TestOptions.test_extras_requirer2 )z5[options.extras_require] foo = bar;python_version<'3'z3[options.extras_require] foo = bar;os_name=='linux'z6[options.extras_require] foo = bar;python_version<'3' z4[options.extras_require] foo = bar;os_name=='linux' z3[options] install_requires = bar;python_version<'3'z1[options] install_requires = bar;os_name=='linux'z4[options] install_requires = bar;python_version<'3' z2[options] install_requires = bar;os_name=='linux' c C �z t ||� d}tjt|d��% t|��}W d � n1 s w Y W d � d S W d � d S 1 s6w Y d S �NzoOne of the parsed requirements in `(install_requires|extras_require.+)` looks like a valid environment marker.*r� )r4 r< r= r r; �rM r2 r- r� rN r r r �+test_raises_accidental_env_marker_misconfig� s � ��"�z7TestOptions.test_raises_accidental_env_marker_misconfig)z3[options.extras_require] foo = bar;python_version<3z4[options.extras_require] foo = bar;python_version<3 z1[options] install_requires = bar;python_version<3z2[options] install_requires = bar;python_version<3 c C r� r� )r4 r< r� r r; r� r r r �)test_warn_accidental_env_marker_misconfig� s � ��"�z5TestOptions.test_warn_accidental_env_marker_misconfig) z9[options.extras_require] foo = bar;python_version<'3'z4[options.extras_require] foo = bar;baz boo = xxx;yyyz:[options.extras_require] foo = bar;python_version<'3' z5[options.extras_require] foo = bar;baz boo = xxx;yyy z<[options.extras_require] foo = bar python_version<3 z7[options] install_requires = bar;python_version<'3'z2[options] install_requires = bar;baz boo = xxx;yyyz8[options] install_requires = bar;python_version<'3' z3[options] install_requires = bar;baz boo = xxx;yyy z:[options] install_requires = bar python_version<3 z.error::setuptools.SetuptoolsDeprecationWarningc C sN t ||� t|�}t|��}W d � n1 sw Y t|�|ks%J �d S )N)r4 �lenr; )rM r2 r- �recwarn� num_warningsrN r r r �+test_nowarn_accidental_env_marker_misconfig� s �z7TestOptions.test_nowarn_accidental_env_marker_misconfigc C sP t |d� t|��}|jdgdgd�ksJ �W d � d S 1 s!w Y d S )Nz2[options.extras_require] foo-a = foo foo_b = test rg �test)zfoo-a�foo_b)r4 r; r� rj r r r �"test_dash_preserved_extras_require� s "�z.TestOptions.test_dash_preserved_extras_requirec C s� t |d�\}}t|��}|jddgdgd�ksJ �W d � n1 s#w Y d}|�d��|� |�d� t|��}|j|ksCJ �W d � d S 1 sNw Y d S ) Nz�[options.entry_points] group1 = point1 = pack.module:func, .point2 = pack.module2:func_rest [rest] group2 = point3 = pack.module:func2 �point1 = pack.module:func�'.point2 = pack.module2:func_rest [rest]�point3 = pack.module:func2)�group1�group2zN[blogtool.parsers] .rst = some.nested.module:SomeClass.some_classmethod[reST] � entry_pointsz,[options] entry_points = file: entry_points )r4 r; r� r r )rM r- rN r2 r: r� r r r �test_entry_points� s& � �� � � "�z TestOptions.test_entry_pointsc C sR t |d� t|��}|jddgdgd�ksJ �W d � d S 1 s"w Y d S )Nz�[options.entry_points] GROUP1 = point1 = pack.module:func, .point2 = pack.module2:func_rest [rest] group2 = point3 = pack.module:func2 r� r� r� )�GROUP1r� )r4 r; r� rj r r r � test_case_sensitive_entry_points s � ��"�z,TestOptions.test_case_sensitive_entry_pointsc C sf t |d� t|�� }dddgfdddgfg}t|j�t|�ks!J �W d � d S 1 s,w Y d S )NzQ[options.data_files] cfg = a/b.conf c/d.conf data = e/f.dat, g/h.dat �cfg�a/b.conf�c/d.conf�dataze/f.datzg/h.dat)r4 r; �sorted� data_files�rM r- r: r� r r r �test_data_files, s � �"�zTestOptions.test_data_filesc C s t |d� |�d��d� |�d��d� |�d��d� |�d��d� |�d��d� |�d��d� |�d ��d� |�d ��d� |�d ��d� t|��*}d d dgfdg d�fdg d�fdg d�fg}t|j�t|�kssJ �W d � d S 1 s~w Y d S )Nz�[options.data_files] cfg = a/b.conf c/d.conf data = *.dat icons = *.ico audio = *.wav sounds.db �a.datr �b.dat�c.dat�a.ico�b.ico�c.ico�beep.wav�boop.wav� sounds.dbr r r r )r r r �icons)r r r �audio)r r r )r4 r r r; r r r r r r �test_data_files_globby= s* � �"�z"TestOptions.test_data_files_globbyc C �D t |td�� t|�� }|�� W d � d S 1 sw Y d S )NzE [options] python_requires=>=2.7 �r4 r r; r7 rj r r r �test_python_requires_simple` � �� "�z'TestOptions.test_python_requires_simplec C r )NzM [options] python_requires=>=2.7,!=3.0.* r rj r r r � test_python_requires_compoundm r z)TestOptions.test_python_requires_compoundc C s~ t |td�� t�t��) t|�� }|�� W d � n1 s w Y W d � d S W d � d S 1 s8w Y d S )NzG [options] python_requires=invalid )r4 r r< r= � Exceptionr; r7 rj r r r � test_python_requires_invalidz s �� ��"�z(TestOptions.test_python_requires_invalidc C s� t |d�}|jjddd� |jddd� d}t|t�|�� t|��&}|jd }|j d ks/J �|j d ks6J �|� t� |��s@J �W d � d S 1 sKw Y d S ) Nzsrc/custom_build.pyT)�parents�exist_okzBfrom distutils.core import Command class CustomCmd(Command): pass r� r� zi [options] cmdclass = customcmd = custom_build.CustomCmd � customcmd� CustomCmd� custom_build) r �parentr � write_textr4 �inspect�cleandocr; �cmdclassr r �samefile�getfile)rM r- � module_pathr. r: r& r r r � test_cmdclass� s � "�zTestOptions.test_cmdclassc C s� t |td�� |�d��d� |�d��d� t|��}|jdgks$J �|jddgiks.J �W d � d S 1 s9w Y d S )Nz� [options] install_requires = file:requirements.txt [options.extras_require] colors = file:requirements-extra.txt zrequirements.txtz docutils>=0.3 zrequirements-extra.txt�coloramar� �colors)r4 r r r r; r� r� rj r r r �test_requirements_file� s �� "�z"TestOptions.test_requirements_fileN) r r r rP r| r� r� r� r� r� r� r< r� r� r� r� �filterwarningsr� r� r� r r r r r r r* r- r r r r r� � sF +4%'� � � # r� c @ s, e Zd Zdd� Zejeddd�dd� �ZdS ) �TestExternalSettersc C s$ t ||� d|j_ddd�|j_d S )Nr[ r} r~ r )�saved_dist_initrC ra r� )rM r: �attrsr r r �_fake_distribution_init� s �z+TestExternalSetters._fake_distribution_init�__init__T)�autospecc C sD | j |_tdddiid�}|jjdksJ �|jjddd�ks J �d S ) Nr� �will_be�ignored)r1 r[ r} r~ r )r2 � side_effectr rC ra r� )rM �mock_parent_initr- r: r r r �test_external_setters� s �z)TestExternalSetters.test_external_settersN)r r r r2 r �objectr r9 r r r r r/ � s r/ )F)Nr& r' )NT)&r� � contextlibr$ r� �pathlibr � unittest.mockr r r< �packaging.requirementsr �setuptools.config.setupcfgr r r �setuptools.distr r �setuptools.warningsr �textwrapr �distutils.errorsr r r r% r4 �contextmanagerr; rA rB rW r� r3 r0 r/ r r r r �<module> s< � $ b a tests/config/__pycache__/test_pyprojecttoml.cpython-310.pyc 0000644 00000025524 15030122015 0020033 0 ustar 00 o �hv0 � @ s| d dl Z d dlmZ d dlmZ d dlZd dlZd dlZd dl m Z d dl Z d dl m Z mZmZmZmZ d dlmZ d dlmZ d dlZdZd d � Zd d � Zd d� Zej � ddi fdi fdddddgiiifg�dd� �Z ddiddid d id �Z G d d � d �Z G d!d"� d"�Z!ej � d#d$�d%d&� �Z"ej � d'd(g�d)d*� �Z#ej � d+d,�d-d.� �Z$ej � d+d/�d0d1� �Z%d2d3� Z&d4d5� Z'dS )6� N)� ConfigParser)�cleandoc)�Path)�_ToolsTypoInMetadata�apply_configuration�expand_configuration�read_configuration�validate)� Distribution)� OptionErrora� [project] name = "myproj" keywords = ["some", "key", "words"] dynamic = ["version", "readme"] requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" dependencies = [ 'importlib-metadata>=0.12;python_version<"3.8"', 'importlib-resources>=1.0;python_version<"3.7"', 'pathlib2>=2.3.3,<3;python_version < "3.4" and sys.platform != "win32"', ] [project.optional-dependencies] docs = [ "sphinx>=3", "sphinx-argparse>=0.2.5", "sphinx-rtd-theme>=0.4.3", ] testing = [ "pytest>=1", "coverage>=3,<5", ] [project.scripts] exec = "pkg.__main__:exec" [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [tool.setuptools] package-dir = {"" = "src"} zip-safe = true platforms = ["any"] [tool.setuptools.packages.find] where = ["src"] [tool.setuptools.cmdclass] sdist = "pkg.mod.CustomSdist" [tool.setuptools.dynamic.version] attr = "pkg.__version__.VERSION" [tool.setuptools.dynamic.readme] file = ["README.md"] content-type = "text/markdown" [tool.setuptools.package-data] "*" = ["*.txt"] [tool.setuptools.data-files] "data" = ["_files/*.txt"] [tool.distutils.sdist] formats = "gztar" [tool.distutils.bdist_wheel] universal = true c C sp t dddid�}dddddd �i}|sJ �|d kr i |�|�}ni |�d d d diii�||< tjj|| d� d S )N� hello worldzfile.txt� )�pyproject.tomlz README.md�_files�pkgzclass CustomSdist: passzVERSION = (3, 10)zdef exec(): print('hello'))� __init__.pyzmod.pyz__version__.pyz __main__.py�.�other�nestedr ��prefix)�EXAMPLE�jaraco�path�build)r �pkg_root�files�packages� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/test_pyprojecttoml.py�create_exampleU s" ���� r c C s. |d }|j t�| �dd� t| |�}|d }t|dd�|ks!J �|d dks)J �|d d d ks3J �d |d d v s=J �|dkrQt|d d d �dhksPJ �nt|d d d �h d�ksaJ �|d d d du smJ �d|d d d v syJ �d|d d d vs�J �|d d d ddgfgks�J �d S )Nr �utf-8��encoding�projectT��expand�versionz3.10�readme�textr r �tool� setuptoolsr r > � other.nestedr r �include-package-datar z package-data�*z data-files�dataz_files/file.txt)� write_text�tomli_w�dumpsr r �set)�configr r � pyproject�expanded�expanded_projectr r r �verify_exampler s" �r8 c C sZ t | d� | d }t|dd�}|d �d�d u sJ �|d �d�d u s%J �t|| d� d S )N�srcr Fr% r$ r' r( )r r �getr8 )�tmp_pathr5 r4 r r r �test_read_configuration� s r< )r �optsr r9 �libr �find�wherec C s� t | |� | d }t|dd�}|d �d�d u sJ �|d �d�d u s%J �|d d �d d � |d d �d d � |d d �|� t|| |� d S ) Nr Fr% r$ r' r( r* r+ r z package-dir)r r r: �pop�updater8 )r; r r= r5 r4 r r r �9test_discovered_package_dir_with_attr_directive_in_config� s rC �a� mod.a:func�b� mod.b:func�c�mod.c:func [extra])�console_scripts� gui_scriptsr c @ s< e Zd Zdd� Zd dd�Zdd� Zej�dd �d d � �Z dS ) �TestEntryPointsc C sR t � }|�t� t|d ddd��}|�|� W d � d S 1 s"w Y d S )N�entry-points.txt�wr! r" )r � read_dict� ENTRY_POINTS�open�write)�selfr; � entry_points�fr r r �write_entry_points� s "�z"TestEntryPoints.write_entry_pointsNc C s. d|pg d�i}ddddiii}|d|id�S )N�dynamic)�scripts� gui-scripts� entry-pointsrZ �filerM r+ )r$ r* r )rS rW r$ r* r r r r5 � s zTestEntryPoints.pyprojectc C s� | � |� t| �� |�}|d }t|d �dksJ �|d d dks$J �t|d �dks.J �|d d dks8J �t|d �dksBJ �|d d d d ksNJ �d S ) Nr$ rX � rD rE rY rF rG rZ r rH rI )rV r r5 �len)rS r; r6 r7 r r r �test_all_listed_in_dynamic� s z*TestEntryPoints.test_all_listed_in_dynamic�missing_dynamic)rX rY c C sp | � |� h d�|h }d|� �}tjtt�|tj�d�� t| �|�|� W d � d S 1 s1w Y d S )N> rX rY rZ z&defined outside of `pyproject.toml`:.*��match) rV �pytest�raisesr �re�compile�Sr r5 )rS r; r_ rW �msgr r r �"test_scripts_not_listed_in_dynamic� s "�z2TestEntryPoints.test_scripts_not_listed_in_dynamic)N) �__name__� __module__� __qualname__rV r5 r^ rb �mark� parametrizerh r r r r rL � s rL c @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) �TestClassifiersc C s� t |d� td�}|d j|dd� |d }t|dd�}|d d }th |�d ��|d d < |d d d }ddi|d < t||� t||�}t|d d �ddhksTJ �d S )Nr9 zX Framework :: Flask Programming Language :: Haskell zclassifiers.txtr! r" r Fr% r$ rW � classifiersr* r+ r[ zFramework :: Flaskz Programming Language :: Haskell)r r r0 r �listr r r3 )rS r; ro r5 r4 rW �dynamic_configr6 r r r � test_dynamic� s" � �z TestClassifiers.test_dynamicc C sZ d}|d }|j t|�dd� tjtdd�� t|� W d � d S 1 s&w Y d S )Nzl [project] name = "myproj" version = '42' dynamic = ["classifiers"] r r! r" z!No configuration .* .classifiers.r` )r0 r rb rc r r )rS r; r4 r5 r r r �test_dynamic_without_config� s "�z+TestClassifiers.test_dynamic_without_configc C sJ d}|d }|j t|�dd� tddid�}t||�}|jjdks#J �d S )Nzg [project] name = "myproj" version = '42' dynamic = ["readme"] r r! r" �long_description�42)�attrs)r0 r r r �metadatart )rS r; r4 r5 �distr r r �*test_dynamic_readme_from_setup_script_args s z:TestClassifiers.test_dynamic_readme_from_setup_script_argsc C sh d}|d }|j t|�dd� tjtdd�� t|�}W d � n1 s%w Y d|d vs2J �d S ) Nz� [project] name = "myproj" version = '42' dynamic = ["classifiers"] [tool.setuptools.dynamic] classifiers = {file = ["classifiers.txt"]} r r! r" z'File .*classifiers.txt. cannot be foundr` ro r$ )r0 r rb �warns� UserWarningr )rS r; r4 r5 r6 r r r �test_dynamic_without_file s �z)TestClassifiers.test_dynamic_without_fileN)ri rj rk rr rs ry r| r r r r rn � s rn �example)z� [project] name = "myproj" version = "1.2" [my-tool.that-disrespect.pep518] value = 42 c C s. | d }|j t|�dd� t|�d usJ �d S �Nr r! r" )r0 r r )r; r} r5 r r r � test_ignore_unrelated_config! s r )r} � error_msg)z� [project] name = "myproj" version = "1.2" requires = ['pywin32; platform_system=="Windows"' ] zGconfiguration error: .project. must not contain ..requires.. propertiesc C sr | d }|j t|�dd� t�d|� d�tjtjB �}tjt|d�� t |� W d � d S 1 s2w Y d S )Nr r! r" zinvalid pyproject.toml.*z.*r` ) r0 r rd re �Mrf rb rc � ValueErrorr )r; r} r� r5 �patternr r r �test_invalid_example6 s "�r� r4 )r z[tool.something] value = 42c C s* | d }|j |dd� t|�i ksJ �d S r~ �r0 r �r; r4 r5 r r r � test_emptyM s r� )�'[project] name = 'myproj' version='42' c C s: | d }|j |dd� t|�}|d d d du sJ �dS ) zaBuilds with ``pyproject.toml`` should consider ``include-package-data=True`` as default. r r! r" r* r+ r- TNr� r� r r r �$test_include_package_data_by_defaultV s r� c C s� ddd�}t jj|| d� t| �� tjjdi dd�}W d � n1 s%w Y |�� d ks2J �|�� d ks:J �|j d u sAJ �dS ) z�Builds with ``pyproject.toml`` should consider ``include_package_data`` set in ``setup.py``. See https://github.com/pypa/setuptools/issues/3197#issuecomment-1079023889 r� z:__import__('setuptools').setup(include_package_data=False))r �setup.pyr r� r4 )� stop_afterN�myprojru F) r r r r � distutils�core� run_setup�get_name� get_version�include_package_data)r; r rx r r r �$test_include_package_data_in_setuppyb s � �r� c C sV d}| d }|j t|�dd� t�t�� t|� W d � dS 1 s$w Y dS )z�Test that the common ``tools.setuptools`` typo in ``pyproject.toml`` issues a warning See https://github.com/pypa/setuptools/issues/4150 z� [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "myproj" version = '42' [tools.setuptools] packages = ["package"] r r! r" N)r0 r rb rz r r r� r r r �test_warn_tools_typov s "�r� )(rd � configparserr �inspectr � jaraco.pathr rb r1 r r r+ � setuptools.config.pyprojecttomlr r r r r �setuptools.distr �setuptools.errorsr �distutils.corer� r r r8 r< rl rm rC rP rL rn r r� r� r� r� r� r r r r �<module> s^ > �� �!K� �� tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-310.pyc 0000644 00000006476 15030122015 0022557 0 ustar 00 o �h� � @ sh d dl mZ d dlZd dlmZ d dlmZ d dlmZ d dl m Z dd� Z d d � Z d d � Z d d� ZdS )� )�cleandocN)�path)�apply_configuration)� Distribution)�SetuptoolsWarningc C sD dt d�d�}tj|| d� t� }t|| d �}|jdgks J �d S )Nzsix # comment a] [project] name = "myproj" version = "1.0" dynamic = ["dependencies"] [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [tool.setuptools.dynamic.dependencies] file = ["requirements.txt"] )zrequirements.txt�pyproject.toml��prefixr �six)r r �buildr r �install_requires��tmp_path�files�dist� r �j/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py�test_dynamic_dependencies s ��r c C sH dt d�d�}tj|| d� t� }t|| d �}|jddgiks"J �d S )Nzsphinx # comment ay [project] name = "myproj" version = "1.0" dynamic = ["optional-dependencies"] [tool.setuptools.dynamic.optional-dependencies.docs] file = ["requirements-docs.txt"] [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" )zrequirements-docs.txtr r r �docs�sphinx)r r r r r �extras_requirer r r r �"test_dynamic_optional_dependencies$ s ��r c C sd dt d�d�}tj|| d� | d }tjtdd�� tt� |� W d � dS 1 s+w Y dS ) z� Test that if PEP 621 was loosened to allow mixing of dynamic and static configurations in the case of fields containing sub-fields (groups), things would work out. zpillow~=42.0 # comment aI [project] name = "myproj" version = "1.0" dynamic = ["optional-dependencies"] [project.optional-dependencies] docs = ["sphinx"] [tool.setuptools.dynamic.optional-dependencies.images] file = ["requirements-images.txt"] )zrequirements-images.txtr r r z project.optional-dependencies��matchN)r r r �pytest�raises� ValueErrorr r )r r � pyprojectr r r �(test_mixed_dynamic_optional_dependencies= s ��"�r c C s� dt d�i}tj|| d� | d }tjtdd��! tdddgii�}t||�}|jd d giks1J �W d � d S 1 s<w Y d S ) Nr z� [project] name = "myproj" version = "1.0" optional-dependencies.docs = ["sphinx"] r z .extras_require. overwrittenr r �hello�worldr r ) r r r r �warnsr r r r )r r r r r r r �/test_mixed_extras_require_optional_dependencies[ s �� "�r" )�inspectr r �jaracor � setuptools.config.pyprojecttomlr �setuptools.distr �setuptools.warningsr r r r r" r r r r �<module> s tests/config/test_pyprojecttoml.py 0000644 00000030166 15030122015 0013472 0 ustar 00 import re from configparser import ConfigParser from inspect import cleandoc import jaraco.path import pytest import tomli_w from path import Path import setuptools # noqa: F401 # force distutils.core to be patched from setuptools.config.pyprojecttoml import ( _ToolsTypoInMetadata, apply_configuration, expand_configuration, read_configuration, validate, ) from setuptools.dist import Distribution from setuptools.errors import OptionError import distutils.core EXAMPLE = """ [project] name = "myproj" keywords = ["some", "key", "words"] dynamic = ["version", "readme"] requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" dependencies = [ 'importlib-metadata>=0.12;python_version<"3.8"', 'importlib-resources>=1.0;python_version<"3.7"', 'pathlib2>=2.3.3,<3;python_version < "3.4" and sys.platform != "win32"', ] [project.optional-dependencies] docs = [ "sphinx>=3", "sphinx-argparse>=0.2.5", "sphinx-rtd-theme>=0.4.3", ] testing = [ "pytest>=1", "coverage>=3,<5", ] [project.scripts] exec = "pkg.__main__:exec" [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [tool.setuptools] package-dir = {"" = "src"} zip-safe = true platforms = ["any"] [tool.setuptools.packages.find] where = ["src"] [tool.setuptools.cmdclass] sdist = "pkg.mod.CustomSdist" [tool.setuptools.dynamic.version] attr = "pkg.__version__.VERSION" [tool.setuptools.dynamic.readme] file = ["README.md"] content-type = "text/markdown" [tool.setuptools.package-data] "*" = ["*.txt"] [tool.setuptools.data-files] "data" = ["_files/*.txt"] [tool.distutils.sdist] formats = "gztar" [tool.distutils.bdist_wheel] universal = true """ def create_example(path, pkg_root): files = { "pyproject.toml": EXAMPLE, "README.md": "hello world", "_files": { "file.txt": "", }, } packages = { "pkg": { "__init__.py": "", "mod.py": "class CustomSdist: pass", "__version__.py": "VERSION = (3, 10)", "__main__.py": "def exec(): print('hello')", }, } assert pkg_root # Meta-test: cannot be empty string. if pkg_root == ".": files = {**files, **packages} # skip other files: flat-layout will raise error for multi-package dist else: # Use this opportunity to ensure namespaces are discovered files[pkg_root] = {**packages, "other": {"nested": {"__init__.py": ""}}} jaraco.path.build(files, prefix=path) def verify_example(config, path, pkg_root): pyproject = path / "pyproject.toml" pyproject.write_text(tomli_w.dumps(config), encoding="utf-8") expanded = expand_configuration(config, path) expanded_project = expanded["project"] assert read_configuration(pyproject, expand=True) == expanded assert expanded_project["version"] == "3.10" assert expanded_project["readme"]["text"] == "hello world" assert "packages" in expanded["tool"]["setuptools"] if pkg_root == ".": # Auto-discovery will raise error for multi-package dist assert set(expanded["tool"]["setuptools"]["packages"]) == {"pkg"} else: assert set(expanded["tool"]["setuptools"]["packages"]) == { "pkg", "other", "other.nested", } assert expanded["tool"]["setuptools"]["include-package-data"] is True assert "" in expanded["tool"]["setuptools"]["package-data"] assert "*" not in expanded["tool"]["setuptools"]["package-data"] assert expanded["tool"]["setuptools"]["data-files"] == [ ("data", ["_files/file.txt"]) ] def test_read_configuration(tmp_path): create_example(tmp_path, "src") pyproject = tmp_path / "pyproject.toml" config = read_configuration(pyproject, expand=False) assert config["project"].get("version") is None assert config["project"].get("readme") is None verify_example(config, tmp_path, "src") @pytest.mark.parametrize( ("pkg_root", "opts"), [ (".", {}), ("src", {}), ("lib", {"packages": {"find": {"where": ["lib"]}}}), ], ) def test_discovered_package_dir_with_attr_directive_in_config(tmp_path, pkg_root, opts): create_example(tmp_path, pkg_root) pyproject = tmp_path / "pyproject.toml" config = read_configuration(pyproject, expand=False) assert config["project"].get("version") is None assert config["project"].get("readme") is None config["tool"]["setuptools"].pop("packages", None) config["tool"]["setuptools"].pop("package-dir", None) config["tool"]["setuptools"].update(opts) verify_example(config, tmp_path, pkg_root) ENTRY_POINTS = { "console_scripts": {"a": "mod.a:func"}, "gui_scripts": {"b": "mod.b:func"}, "other": {"c": "mod.c:func [extra]"}, } class TestEntryPoints: def write_entry_points(self, tmp_path): entry_points = ConfigParser() entry_points.read_dict(ENTRY_POINTS) with open(tmp_path / "entry-points.txt", "w", encoding="utf-8") as f: entry_points.write(f) def pyproject(self, dynamic=None): project = {"dynamic": dynamic or ["scripts", "gui-scripts", "entry-points"]} tool = {"dynamic": {"entry-points": {"file": "entry-points.txt"}}} return {"project": project, "tool": {"setuptools": tool}} def test_all_listed_in_dynamic(self, tmp_path): self.write_entry_points(tmp_path) expanded = expand_configuration(self.pyproject(), tmp_path) expanded_project = expanded["project"] assert len(expanded_project["scripts"]) == 1 assert expanded_project["scripts"]["a"] == "mod.a:func" assert len(expanded_project["gui-scripts"]) == 1 assert expanded_project["gui-scripts"]["b"] == "mod.b:func" assert len(expanded_project["entry-points"]) == 1 assert expanded_project["entry-points"]["other"]["c"] == "mod.c:func [extra]" @pytest.mark.parametrize("missing_dynamic", ("scripts", "gui-scripts")) def test_scripts_not_listed_in_dynamic(self, tmp_path, missing_dynamic): self.write_entry_points(tmp_path) dynamic = {"scripts", "gui-scripts", "entry-points"} - {missing_dynamic} msg = f"defined outside of `pyproject.toml`:.*{missing_dynamic}" with pytest.raises(OptionError, match=re.compile(msg, re.S)): expand_configuration(self.pyproject(dynamic), tmp_path) class TestClassifiers: def test_dynamic(self, tmp_path): # Let's create a project example that has dynamic classifiers # coming from a txt file. create_example(tmp_path, "src") classifiers = cleandoc( """ Framework :: Flask Programming Language :: Haskell """ ) (tmp_path / "classifiers.txt").write_text(classifiers, encoding="utf-8") pyproject = tmp_path / "pyproject.toml" config = read_configuration(pyproject, expand=False) dynamic = config["project"]["dynamic"] config["project"]["dynamic"] = list({*dynamic, "classifiers"}) dynamic_config = config["tool"]["setuptools"]["dynamic"] dynamic_config["classifiers"] = {"file": "classifiers.txt"} # When the configuration is expanded, # each line of the file should be an different classifier. validate(config, pyproject) expanded = expand_configuration(config, tmp_path) assert set(expanded["project"]["classifiers"]) == { "Framework :: Flask", "Programming Language :: Haskell", } def test_dynamic_without_config(self, tmp_path): config = """ [project] name = "myproj" version = '42' dynamic = ["classifiers"] """ pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(config), encoding="utf-8") with pytest.raises(OptionError, match="No configuration .* .classifiers."): read_configuration(pyproject) def test_dynamic_readme_from_setup_script_args(self, tmp_path): config = """ [project] name = "myproj" version = '42' dynamic = ["readme"] """ pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(config), encoding="utf-8") dist = Distribution(attrs={"long_description": "42"}) # No error should occur because of missing `readme` dist = apply_configuration(dist, pyproject) assert dist.metadata.long_description == "42" def test_dynamic_without_file(self, tmp_path): config = """ [project] name = "myproj" version = '42' dynamic = ["classifiers"] [tool.setuptools.dynamic] classifiers = {file = ["classifiers.txt"]} """ pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(config), encoding="utf-8") with pytest.warns(UserWarning, match="File .*classifiers.txt. cannot be found"): expanded = read_configuration(pyproject) assert "classifiers" not in expanded["project"] @pytest.mark.parametrize( "example", ( """ [project] name = "myproj" version = "1.2" [my-tool.that-disrespect.pep518] value = 42 """, ), ) def test_ignore_unrelated_config(tmp_path, example): pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(example), encoding="utf-8") # Make sure no error is raised due to 3rd party configs in pyproject.toml assert read_configuration(pyproject) is not None @pytest.mark.parametrize( ("example", "error_msg"), [ ( """ [project] name = "myproj" version = "1.2" requires = ['pywin32; platform_system=="Windows"' ] """, "configuration error: .project. must not contain ..requires.. properties", ), ], ) def test_invalid_example(tmp_path, example, error_msg): pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(example), encoding="utf-8") pattern = re.compile(f"invalid pyproject.toml.*{error_msg}.*", re.M | re.S) with pytest.raises(ValueError, match=pattern): read_configuration(pyproject) @pytest.mark.parametrize("config", ("", "[tool.something]\nvalue = 42")) def test_empty(tmp_path, config): pyproject = tmp_path / "pyproject.toml" pyproject.write_text(config, encoding="utf-8") # Make sure no error is raised assert read_configuration(pyproject) == {} @pytest.mark.parametrize("config", ("[project]\nname = 'myproj'\nversion='42'\n",)) def test_include_package_data_by_default(tmp_path, config): """Builds with ``pyproject.toml`` should consider ``include-package-data=True`` as default. """ pyproject = tmp_path / "pyproject.toml" pyproject.write_text(config, encoding="utf-8") config = read_configuration(pyproject) assert config["tool"]["setuptools"]["include-package-data"] is True def test_include_package_data_in_setuppy(tmp_path): """Builds with ``pyproject.toml`` should consider ``include_package_data`` set in ``setup.py``. See https://github.com/pypa/setuptools/issues/3197#issuecomment-1079023889 """ files = { "pyproject.toml": "[project]\nname = 'myproj'\nversion='42'\n", "setup.py": "__import__('setuptools').setup(include_package_data=False)", } jaraco.path.build(files, prefix=tmp_path) with Path(tmp_path): dist = distutils.core.run_setup("setup.py", {}, stop_after="config") assert dist.get_name() == "myproj" assert dist.get_version() == "42" assert dist.include_package_data is False def test_warn_tools_typo(tmp_path): """Test that the common ``tools.setuptools`` typo in ``pyproject.toml`` issues a warning See https://github.com/pypa/setuptools/issues/4150 """ config = """ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "myproj" version = '42' [tools.setuptools] packages = ["package"] """ pyproject = tmp_path / "pyproject.toml" pyproject.write_text(cleandoc(config), encoding="utf-8") with pytest.warns(_ToolsTypoInMetadata): read_configuration(pyproject) tests/config/test_apply_pyprojecttoml.py 0000644 00000070207 15030122015 0014677 0 ustar 00 """Make sure that applying the configuration from pyproject.toml is equivalent to applying a similar configuration from setup.cfg To run these tests offline, please have a look on ``./downloads/preload.py`` """ from __future__ import annotations import io import re import tarfile from inspect import cleandoc from pathlib import Path from unittest.mock import Mock import pytest from ini2toml.api import LiteTranslator from packaging.metadata import Metadata import setuptools # noqa: F401 # ensure monkey patch to metadata from setuptools._static import is_static from setuptools.command.egg_info import write_requirements from setuptools.config import expand, pyprojecttoml, setupcfg from setuptools.config._apply_pyprojecttoml import _MissingDynamic, _some_attrgetter from setuptools.dist import Distribution from setuptools.errors import InvalidConfigError, RemovedConfigError from setuptools.warnings import InformationOnly, SetuptoolsDeprecationWarning from .downloads import retrieve_file, urls_from_file HERE = Path(__file__).parent EXAMPLES_FILE = "setupcfg_examples.txt" def makedist(path, **attrs): return Distribution({"src_root": path, **attrs}) def _mock_expand_patterns(patterns, *_, **__): """ Allow comparing the given patterns for 2 dist objects. We need to strip special chars to avoid errors when validating. """ return [re.sub("[^a-z0-9]+", "", p, flags=re.I) or "empty" for p in patterns] @pytest.mark.parametrize("url", urls_from_file(HERE / EXAMPLES_FILE)) @pytest.mark.filterwarnings("ignore") @pytest.mark.uses_network def test_apply_pyproject_equivalent_to_setupcfg(url, monkeypatch, tmp_path): monkeypatch.setattr(expand, "read_attr", Mock(return_value="0.0.1")) monkeypatch.setattr( Distribution, "_expand_patterns", Mock(side_effect=_mock_expand_patterns) ) setupcfg_example = retrieve_file(url) pyproject_example = Path(tmp_path, "pyproject.toml") setupcfg_text = setupcfg_example.read_text(encoding="utf-8") toml_config = LiteTranslator().translate(setupcfg_text, "setup.cfg") pyproject_example.write_text(toml_config, encoding="utf-8") dist_toml = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject_example) dist_cfg = setupcfg.apply_configuration(makedist(tmp_path), setupcfg_example) pkg_info_toml = core_metadata(dist_toml) pkg_info_cfg = core_metadata(dist_cfg) assert pkg_info_toml == pkg_info_cfg if any(getattr(d, "license_files", None) for d in (dist_toml, dist_cfg)): assert set(dist_toml.license_files) == set(dist_cfg.license_files) if any(getattr(d, "entry_points", None) for d in (dist_toml, dist_cfg)): print(dist_cfg.entry_points) ep_toml = { (k, *sorted(i.replace(" ", "") for i in v)) for k, v in dist_toml.entry_points.items() } ep_cfg = { (k, *sorted(i.replace(" ", "") for i in v)) for k, v in dist_cfg.entry_points.items() } assert ep_toml == ep_cfg if any(getattr(d, "package_data", None) for d in (dist_toml, dist_cfg)): pkg_data_toml = {(k, *sorted(v)) for k, v in dist_toml.package_data.items()} pkg_data_cfg = {(k, *sorted(v)) for k, v in dist_cfg.package_data.items()} assert pkg_data_toml == pkg_data_cfg if any(getattr(d, "data_files", None) for d in (dist_toml, dist_cfg)): data_files_toml = {(k, *sorted(v)) for k, v in dist_toml.data_files} data_files_cfg = {(k, *sorted(v)) for k, v in dist_cfg.data_files} assert data_files_toml == data_files_cfg assert set(dist_toml.install_requires) == set(dist_cfg.install_requires) if any(getattr(d, "extras_require", None) for d in (dist_toml, dist_cfg)): extra_req_toml = {(k, *sorted(v)) for k, v in dist_toml.extras_require.items()} extra_req_cfg = {(k, *sorted(v)) for k, v in dist_cfg.extras_require.items()} assert extra_req_toml == extra_req_cfg PEP621_EXAMPLE = """\ [project] name = "spam" version = "2020.0.0" description = "Lovely Spam! Wonderful Spam!" readme = "README.rst" requires-python = ">=3.8" license-files = ["LICENSE.txt"] # Updated to be PEP 639 compliant keywords = ["egg", "bacon", "sausage", "tomatoes", "Lobster Thermidor"] authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] maintainers = [ {name = "Brett Cannon", email = "brett@python.org"}, {name = "John X. Ãørçeč", email = "john@utf8.org"}, {name = "Γαμα קּ 東", email = "gama@utf8.org"}, ] classifiers = [ "Development Status :: 4 - Beta", "Programming Language :: Python" ] dependencies = [ "httpx", "gidgethub[httpx]>4.0.0", "django>2.1; os_name != 'nt'", "django>2.0; os_name == 'nt'" ] [project.optional-dependencies] test = [ "pytest < 5.0.0", "pytest-cov[all]" ] [project.urls] homepage = "http://example.com" documentation = "http://readthedocs.org" repository = "http://github.com" changelog = "http://github.com/me/spam/blob/master/CHANGELOG.md" [project.scripts] spam-cli = "spam:main_cli" [project.gui-scripts] spam-gui = "spam:main_gui" [project.entry-points."spam.magical"] tomatoes = "spam:main_tomatoes" """ PEP621_INTERNATIONAL_EMAIL_EXAMPLE = """\ [project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] maintainers = [ {name = "Степан Бандера", email = "криївка@оун-упа.укр"}, ] """ PEP621_EXAMPLE_SCRIPT = """ def main_cli(): pass def main_gui(): pass def main_tomatoes(): pass """ PEP639_LICENSE_TEXT = """\ [project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] license = {text = "MIT"} """ PEP639_LICENSE_EXPRESSION = """\ [project] name = "spam" version = "2020.0.0" authors = [ {email = "hi@pradyunsg.me"}, {name = "Tzu-Ping Chung"} ] license = "mit or apache-2.0" # should be normalized in metadata classifiers = [ "Development Status :: 5 - Production/Stable", "Programming Language :: Python", ] """ def _pep621_example_project( tmp_path, readme="README.rst", pyproject_text=PEP621_EXAMPLE, ): pyproject = tmp_path / "pyproject.toml" text = pyproject_text replacements = {'readme = "README.rst"': f'readme = "{readme}"'} for orig, subst in replacements.items(): text = text.replace(orig, subst) pyproject.write_text(text, encoding="utf-8") (tmp_path / readme).write_text("hello world", encoding="utf-8") (tmp_path / "LICENSE.txt").write_text("--- LICENSE stub ---", encoding="utf-8") (tmp_path / "spam.py").write_text(PEP621_EXAMPLE_SCRIPT, encoding="utf-8") return pyproject def test_pep621_example(tmp_path): """Make sure the example in PEP 621 works""" pyproject = _pep621_example_project(tmp_path) dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert set(dist.metadata.license_files) == {"LICENSE.txt"} @pytest.mark.parametrize( ("readme", "ctype"), [ ("Readme.txt", "text/plain"), ("readme.md", "text/markdown"), ("text.rst", "text/x-rst"), ], ) def test_readme_content_type(tmp_path, readme, ctype): pyproject = _pep621_example_project(tmp_path, readme) dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert dist.metadata.long_description_content_type == ctype def test_undefined_content_type(tmp_path): pyproject = _pep621_example_project(tmp_path, "README.tex") with pytest.raises(ValueError, match="Undefined content type for README.tex"): pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) def test_no_explicit_content_type_for_missing_extension(tmp_path): pyproject = _pep621_example_project(tmp_path, "README") dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert dist.metadata.long_description_content_type is None @pytest.mark.parametrize( ("pyproject_text", "expected_maintainers_meta_value"), ( pytest.param( PEP621_EXAMPLE, ( 'Brett Cannon <brett@python.org>, "John X. Ãørçeč" <john@utf8.org>, ' 'Γαμα קּ 東 <gama@utf8.org>' ), id='non-international-emails', ), pytest.param( PEP621_INTERNATIONAL_EMAIL_EXAMPLE, 'Степан Бандера <криївка@оун-упа.укр>', marks=pytest.mark.xfail( reason="CPython's `email.headerregistry.Address` only supports " 'RFC 5322, as of Nov 10, 2022 and latest Python 3.11.0', strict=True, ), id='international-email', ), ), ) def test_utf8_maintainer_in_metadata( # issue-3663 expected_maintainers_meta_value, pyproject_text, tmp_path, ): pyproject = _pep621_example_project( tmp_path, "README", pyproject_text=pyproject_text, ) dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert dist.metadata.maintainer_email == expected_maintainers_meta_value pkg_file = tmp_path / "PKG-FILE" with open(pkg_file, "w", encoding="utf-8") as fh: dist.metadata.write_pkg_file(fh) content = pkg_file.read_text(encoding="utf-8") assert f"Maintainer-email: {expected_maintainers_meta_value}" in content @pytest.mark.parametrize( ( 'pyproject_text', 'license', 'license_expression', 'content_str', 'not_content_str', ), ( pytest.param( PEP639_LICENSE_TEXT, 'MIT', None, 'License: MIT', 'License-Expression: ', id='license-text', marks=[ pytest.mark.filterwarnings( "ignore:.project.license. as a TOML table is deprecated", ) ], ), pytest.param( PEP639_LICENSE_EXPRESSION, None, 'MIT OR Apache-2.0', 'License-Expression: MIT OR Apache-2.0', 'License: ', id='license-expression', ), ), ) def test_license_in_metadata( license, license_expression, content_str, not_content_str, pyproject_text, tmp_path, ): pyproject = _pep621_example_project( tmp_path, "README", pyproject_text=pyproject_text, ) dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert dist.metadata.license == license assert dist.metadata.license_expression == license_expression pkg_file = tmp_path / "PKG-FILE" with open(pkg_file, "w", encoding="utf-8") as fh: dist.metadata.write_pkg_file(fh) content = pkg_file.read_text(encoding="utf-8") assert "Metadata-Version: 2.4" in content assert content_str in content assert not_content_str not in content def test_license_classifier_with_license_expression(tmp_path): text = PEP639_LICENSE_EXPRESSION.rsplit("\n", 2)[0] pyproject = _pep621_example_project( tmp_path, "README", f"{text}\n \"License :: OSI Approved :: MIT License\"\n]", ) msg = "License classifiers have been superseded by license expressions" with pytest.raises(InvalidConfigError, match=msg) as exc: pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert "License :: OSI Approved :: MIT License" in str(exc.value) def test_license_classifier_without_license_expression(tmp_path): text = """\ [project] name = "spam" version = "2020.0.0" license = {text = "mit or apache-2.0"} classifiers = ["License :: OSI Approved :: MIT License"] """ pyproject = _pep621_example_project(tmp_path, "README", text) msg1 = "License classifiers are deprecated(?:.|\n)*MIT License" msg2 = ".project.license. as a TOML table is deprecated" with ( pytest.warns(SetuptoolsDeprecationWarning, match=msg1), pytest.warns(SetuptoolsDeprecationWarning, match=msg2), ): dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) # Check license classifier is still included assert dist.metadata.get_classifiers() == ["License :: OSI Approved :: MIT License"] class TestLicenseFiles: def base_pyproject( self, tmp_path, additional_text="", license_toml='license = {file = "LICENSE.txt"}\n', ): text = PEP639_LICENSE_EXPRESSION # Sanity-check assert 'license = "mit or apache-2.0"' in text assert 'license-files' not in text assert "[tool.setuptools]" not in text text = re.sub( r"(license = .*)\n", license_toml, text, count=1, ) assert license_toml in text # sanity check text = f"{text}\n{additional_text}\n" pyproject = _pep621_example_project(tmp_path, "README", pyproject_text=text) return pyproject def base_pyproject_license_pep639(self, tmp_path, additional_text=""): return self.base_pyproject( tmp_path, additional_text=additional_text, license_toml='license = "licenseref-Proprietary"' '\nlicense-files = ["_FILE*"]\n', ) def test_both_license_and_license_files_defined(self, tmp_path): setuptools_config = '[tool.setuptools]\nlicense-files = ["_FILE*"]' pyproject = self.base_pyproject(tmp_path, setuptools_config) (tmp_path / "_FILE.txt").touch() (tmp_path / "_FILE.rst").touch() # Would normally match the `license_files` patterns, but we want to exclude it # by being explicit. On the other hand, contents should be added to `license` license = tmp_path / "LICENSE.txt" license.write_text("LicenseRef-Proprietary\n", encoding="utf-8") msg1 = "'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'" msg2 = ".project.license. as a TOML table is deprecated" with ( pytest.warns(SetuptoolsDeprecationWarning, match=msg1), pytest.warns(SetuptoolsDeprecationWarning, match=msg2), ): dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert set(dist.metadata.license_files) == {"_FILE.rst", "_FILE.txt"} assert dist.metadata.license == "LicenseRef-Proprietary\n" def test_both_license_and_license_files_defined_pep639(self, tmp_path): # Set license and license-files pyproject = self.base_pyproject_license_pep639(tmp_path) (tmp_path / "_FILE.txt").touch() (tmp_path / "_FILE.rst").touch() msg = "Normalizing.*LicenseRef" with pytest.warns(InformationOnly, match=msg): dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert set(dist.metadata.license_files) == {"_FILE.rst", "_FILE.txt"} assert dist.metadata.license is None assert dist.metadata.license_expression == "LicenseRef-Proprietary" def test_license_files_defined_twice(self, tmp_path): # Set project.license-files and tools.setuptools.license-files setuptools_config = '[tool.setuptools]\nlicense-files = ["_FILE*"]' pyproject = self.base_pyproject_license_pep639(tmp_path, setuptools_config) msg = "'project.license-files' is defined already. Remove 'tool.setuptools.license-files'" with pytest.raises(InvalidConfigError, match=msg): pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) def test_default_patterns(self, tmp_path): setuptools_config = '[tool.setuptools]\nzip-safe = false' # ^ used just to trigger section validation pyproject = self.base_pyproject(tmp_path, setuptools_config, license_toml="") license_files = "LICENCE-a.html COPYING-abc.txt AUTHORS-xyz NOTICE,def".split() for fname in license_files: (tmp_path / fname).write_text(f"{fname}\n", encoding="utf-8") dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert (tmp_path / "LICENSE.txt").exists() # from base example assert set(dist.metadata.license_files) == {*license_files, "LICENSE.txt"} def test_missing_patterns(self, tmp_path): pyproject = self.base_pyproject_license_pep639(tmp_path) assert list(tmp_path.glob("_FILE*")) == [] # sanity check msg1 = "Cannot find any files for the given pattern.*" msg2 = "Normalizing 'licenseref-Proprietary' to 'LicenseRef-Proprietary'" with ( pytest.warns(SetuptoolsDeprecationWarning, match=msg1), pytest.warns(InformationOnly, match=msg2), ): pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) def test_deprecated_file_expands_to_text(self, tmp_path): """Make sure the old example with ``license = {text = ...}`` works""" assert 'license-files = ["LICENSE.txt"]' in PEP621_EXAMPLE # sanity check text = PEP621_EXAMPLE.replace( 'license-files = ["LICENSE.txt"]', 'license = {file = "LICENSE.txt"}', ) pyproject = _pep621_example_project(tmp_path, pyproject_text=text) msg = ".project.license. as a TOML table is deprecated" with pytest.warns(SetuptoolsDeprecationWarning, match=msg): dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) assert dist.metadata.license == "--- LICENSE stub ---" assert set(dist.metadata.license_files) == {"LICENSE.txt"} # auto-filled class TestPyModules: # https://github.com/pypa/setuptools/issues/4316 def dist(self, name): toml_config = f""" [project] name = "test" version = "42.0" [tool.setuptools] py-modules = [{name!r}] """ pyproject = Path("pyproject.toml") pyproject.write_text(cleandoc(toml_config), encoding="utf-8") return pyprojecttoml.apply_configuration(Distribution({}), pyproject) @pytest.mark.parametrize("module", ["pip-run", "abc-d.λ-xyz-e"]) def test_valid_module_name(self, tmp_path, monkeypatch, module): monkeypatch.chdir(tmp_path) assert module in self.dist(module).py_modules @pytest.mark.parametrize("module", ["pip run", "-pip-run", "pip-run-stubs"]) def test_invalid_module_name(self, tmp_path, monkeypatch, module): monkeypatch.chdir(tmp_path) with pytest.raises(ValueError, match="py-modules"): self.dist(module).py_modules class TestExtModules: def test_pyproject_sets_attribute(self, tmp_path, monkeypatch): monkeypatch.chdir(tmp_path) pyproject = Path("pyproject.toml") toml_config = """ [project] name = "test" version = "42.0" [tool.setuptools] ext-modules = [ {name = "my.ext", sources = ["hello.c", "world.c"]} ] """ pyproject.write_text(cleandoc(toml_config), encoding="utf-8") with pytest.warns(pyprojecttoml._ExperimentalConfiguration): dist = pyprojecttoml.apply_configuration(Distribution({}), pyproject) assert len(dist.ext_modules) == 1 assert dist.ext_modules[0].name == "my.ext" assert set(dist.ext_modules[0].sources) == {"hello.c", "world.c"} class TestDeprecatedFields: def test_namespace_packages(self, tmp_path): pyproject = tmp_path / "pyproject.toml" config = """ [project] name = "myproj" version = "42" [tool.setuptools] namespace-packages = ["myproj.pkg"] """ pyproject.write_text(cleandoc(config), encoding="utf-8") with pytest.raises(RemovedConfigError, match="namespace-packages"): pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) class TestPresetField: def pyproject(self, tmp_path, dynamic, extra_content=""): content = f"[project]\nname = 'proj'\ndynamic = {dynamic!r}\n" if "version" not in dynamic: content += "version = '42'\n" file = tmp_path / "pyproject.toml" file.write_text(content + extra_content, encoding="utf-8") return file @pytest.mark.parametrize( ("attr", "field", "value"), [ ("license_expression", "license", "MIT"), pytest.param( *("license", "license", "Not SPDX"), marks=[pytest.mark.filterwarnings("ignore:.*license. overwritten")], ), ("classifiers", "classifiers", ["Private :: Classifier"]), ("entry_points", "scripts", {"console_scripts": ["foobar=foobar:main"]}), ("entry_points", "gui-scripts", {"gui_scripts": ["bazquux=bazquux:main"]}), pytest.param( *("install_requires", "dependencies", ["six"]), marks=[ pytest.mark.filterwarnings("ignore:.*install_requires. overwritten") ], ), ], ) def test_not_listed_in_dynamic(self, tmp_path, attr, field, value): """Setuptools cannot set a field if not listed in ``dynamic``""" pyproject = self.pyproject(tmp_path, []) dist = makedist(tmp_path, **{attr: value}) msg = re.compile(f"defined outside of `pyproject.toml`:.*{field}", re.S) with pytest.warns(_MissingDynamic, match=msg): dist = pyprojecttoml.apply_configuration(dist, pyproject) dist_value = _some_attrgetter(f"metadata.{attr}", attr)(dist) assert not dist_value @pytest.mark.parametrize( ("attr", "field", "value"), [ ("license_expression", "license", "MIT"), ("install_requires", "dependencies", []), ("extras_require", "optional-dependencies", {}), ("install_requires", "dependencies", ["six"]), ("classifiers", "classifiers", ["Private :: Classifier"]), ], ) def test_listed_in_dynamic(self, tmp_path, attr, field, value): pyproject = self.pyproject(tmp_path, [field]) dist = makedist(tmp_path, **{attr: value}) dist = pyprojecttoml.apply_configuration(dist, pyproject) dist_value = _some_attrgetter(f"metadata.{attr}", attr)(dist) assert dist_value == value def test_license_files_exempt_from_dynamic(self, monkeypatch, tmp_path): """ license-file is currently not considered in the context of dynamic. As per 2025-02-19, https://packaging.python.org/en/latest/specifications/pyproject-toml/#license-files allows setuptools to fill-in `license-files` the way it sees fit: > If the license-files key is not defined, tools can decide how to handle license files. > For example they can choose not to include any files or use their own > logic to discover the appropriate files in the distribution. Using license_files from setup.py to fill-in the value is in accordance with this rule. """ monkeypatch.chdir(tmp_path) pyproject = self.pyproject(tmp_path, []) dist = makedist(tmp_path, license_files=["LIC*"]) (tmp_path / "LIC1").write_text("42", encoding="utf-8") dist = pyprojecttoml.apply_configuration(dist, pyproject) assert dist.metadata.license_files == ["LIC1"] def test_warning_overwritten_dependencies(self, tmp_path): src = "[project]\nname='pkg'\nversion='0.1'\ndependencies=['click']\n" pyproject = tmp_path / "pyproject.toml" pyproject.write_text(src, encoding="utf-8") dist = makedist(tmp_path, install_requires=["wheel"]) with pytest.warns(match="`install_requires` overwritten"): dist = pyprojecttoml.apply_configuration(dist, pyproject) assert "wheel" not in dist.install_requires def test_optional_dependencies_dont_remove_env_markers(self, tmp_path): """ Internally setuptools converts dependencies with markers to "extras". If ``install_requires`` is given by ``setup.py``, we have to ensure that applying ``optional-dependencies`` does not overwrite the mandatory dependencies with markers (see #3204). """ # If setuptools replace its internal mechanism that uses `requires.txt` # this test has to be rewritten to adapt accordingly extra = "\n[project.optional-dependencies]\nfoo = ['bar>1']\n" pyproject = self.pyproject(tmp_path, ["dependencies"], extra) install_req = ['importlib-resources (>=3.0.0) ; python_version < "3.7"'] dist = makedist(tmp_path, install_requires=install_req) dist = pyprojecttoml.apply_configuration(dist, pyproject) assert "foo" in dist.extras_require egg_info = dist.get_command_obj("egg_info") write_requirements(egg_info, tmp_path, tmp_path / "requires.txt") reqs = (tmp_path / "requires.txt").read_text(encoding="utf-8") assert "importlib-resources" in reqs assert "bar" in reqs assert ':python_version < "3.7"' in reqs @pytest.mark.parametrize( ("field", "group"), [("scripts", "console_scripts"), ("gui-scripts", "gui_scripts")], ) @pytest.mark.filterwarnings("error") def test_scripts_dont_require_dynamic_entry_points(self, tmp_path, field, group): # Issue 3862 pyproject = self.pyproject(tmp_path, [field]) dist = makedist(tmp_path, entry_points={group: ["foobar=foobar:main"]}) dist = pyprojecttoml.apply_configuration(dist, pyproject) assert group in dist.entry_points class TestMeta: def test_example_file_in_sdist(self, setuptools_sdist): """Meta test to ensure tests can run from sdist""" with tarfile.open(setuptools_sdist) as tar: assert any(name.endswith(EXAMPLES_FILE) for name in tar.getnames()) class TestInteropCommandLineParsing: def test_version(self, tmp_path, monkeypatch, capsys): # See pypa/setuptools#4047 # This test can be removed once the CLI interface of setup.py is removed monkeypatch.chdir(tmp_path) toml_config = """ [project] name = "test" version = "42.0" """ pyproject = Path(tmp_path, "pyproject.toml") pyproject.write_text(cleandoc(toml_config), encoding="utf-8") opts = {"script_args": ["--version"]} dist = pyprojecttoml.apply_configuration(Distribution(opts), pyproject) dist.parse_command_line() # <-- there should be no exception here. captured = capsys.readouterr() assert "42.0" in captured.out class TestStaticConfig: def test_mark_static_fields(self, tmp_path, monkeypatch): monkeypatch.chdir(tmp_path) toml_config = """ [project] name = "test" version = "42.0" dependencies = ["hello"] keywords = ["world"] classifiers = ["private :: hello world"] [tool.setuptools] obsoletes = ["abcd"] provides = ["abcd"] platforms = ["abcd"] """ pyproject = Path(tmp_path, "pyproject.toml") pyproject.write_text(cleandoc(toml_config), encoding="utf-8") dist = pyprojecttoml.apply_configuration(Distribution({}), pyproject) assert is_static(dist.install_requires) assert is_static(dist.metadata.keywords) assert is_static(dist.metadata.classifiers) assert is_static(dist.metadata.obsoletes) assert is_static(dist.metadata.provides) assert is_static(dist.metadata.platforms) # --- Auxiliary Functions --- def core_metadata(dist) -> str: with io.StringIO() as buffer: dist.metadata.write_pkg_file(buffer) pkg_file_txt = buffer.getvalue() # Make sure core metadata is valid Metadata.from_email(pkg_file_txt, validate=True) # can raise exceptions skip_prefixes: tuple[str, ...] = () skip_lines = set() # ---- DIFF NORMALISATION ---- # PEP 621 is very particular about author/maintainer metadata conversion, so skip skip_prefixes += ("Author:", "Author-email:", "Maintainer:", "Maintainer-email:") # May be redundant with Home-page skip_prefixes += ("Project-URL: Homepage,", "Home-page:") # May be missing in original (relying on default) but backfilled in the TOML skip_prefixes += ("Description-Content-Type:",) # Remove empty lines skip_lines.add("") result = [] for line in pkg_file_txt.splitlines(): if line.startswith(skip_prefixes) or line in skip_lines: continue result.append(line + "\n") return "".join(result) tests/config/test_expand.py 0000644 00000021345 15030122015 0012035 0 ustar 00 import os import sys from pathlib import Path import pytest from setuptools._static import is_static from setuptools.config import expand from setuptools.discovery import find_package_path from distutils.errors import DistutilsOptionError def write_files(files, root_dir): for file, content in files.items(): path = root_dir / file path.parent.mkdir(exist_ok=True, parents=True) path.write_text(content, encoding="utf-8") def test_glob_relative(tmp_path, monkeypatch): files = { "dir1/dir2/dir3/file1.txt", "dir1/dir2/file2.txt", "dir1/file3.txt", "a.ini", "b.ini", "dir1/c.ini", "dir1/dir2/a.ini", } write_files({k: "" for k in files}, tmp_path) patterns = ["**/*.txt", "[ab].*", "**/[ac].ini"] monkeypatch.chdir(tmp_path) assert set(expand.glob_relative(patterns)) == files # Make sure the same APIs work outside cwd assert set(expand.glob_relative(patterns, tmp_path)) == files def test_read_files(tmp_path, monkeypatch): dir_ = tmp_path / "dir_" (tmp_path / "_dir").mkdir(exist_ok=True) (tmp_path / "a.txt").touch() files = {"a.txt": "a", "dir1/b.txt": "b", "dir1/dir2/c.txt": "c"} write_files(files, dir_) secrets = Path(str(dir_) + "secrets") secrets.mkdir(exist_ok=True) write_files({"secrets.txt": "secret keys"}, secrets) with monkeypatch.context() as m: m.chdir(dir_) assert expand.read_files(list(files)) == "a\nb\nc" cannot_access_msg = r"Cannot access '.*\.\..a\.txt'" with pytest.raises(DistutilsOptionError, match=cannot_access_msg): expand.read_files(["../a.txt"]) cannot_access_secrets_msg = r"Cannot access '.*secrets\.txt'" with pytest.raises(DistutilsOptionError, match=cannot_access_secrets_msg): expand.read_files(["../dir_secrets/secrets.txt"]) # Make sure the same APIs work outside cwd assert expand.read_files(list(files), dir_) == "a\nb\nc" with pytest.raises(DistutilsOptionError, match=cannot_access_msg): expand.read_files(["../a.txt"], dir_) class TestReadAttr: @pytest.mark.parametrize( "example", [ # No cookie means UTF-8: b"__version__ = '\xc3\xa9'\nraise SystemExit(1)\n", # If a cookie is present, honor it: b"# -*- coding: utf-8 -*-\n__version__ = '\xc3\xa9'\nraise SystemExit(1)\n", b"# -*- coding: latin1 -*-\n__version__ = '\xe9'\nraise SystemExit(1)\n", ], ) def test_read_attr_encoding_cookie(self, example, tmp_path): (tmp_path / "mod.py").write_bytes(example) assert expand.read_attr('mod.__version__', root_dir=tmp_path) == 'é' def test_read_attr(self, tmp_path, monkeypatch): files = { "pkg/__init__.py": "", "pkg/sub/__init__.py": "VERSION = '0.1.1'", "pkg/sub/mod.py": ( "VALUES = {'a': 0, 'b': {42}, 'c': (0, 1, 1)}\nraise SystemExit(1)" ), } write_files(files, tmp_path) with monkeypatch.context() as m: m.chdir(tmp_path) # Make sure it can read the attr statically without evaluating the module version = expand.read_attr('pkg.sub.VERSION') values = expand.read_attr('lib.mod.VALUES', {'lib': 'pkg/sub'}) assert version == '0.1.1' assert is_static(values) assert values['a'] == 0 assert values['b'] == {42} assert is_static(values) # Make sure the same APIs work outside cwd assert expand.read_attr('pkg.sub.VERSION', root_dir=tmp_path) == '0.1.1' values = expand.read_attr('lib.mod.VALUES', {'lib': 'pkg/sub'}, tmp_path) assert values['c'] == (0, 1, 1) @pytest.mark.parametrize( "example", [ "VERSION: str\nVERSION = '0.1.1'\nraise SystemExit(1)\n", "VERSION: str = '0.1.1'\nraise SystemExit(1)\n", ], ) def test_read_annotated_attr(self, tmp_path, example): files = { "pkg/__init__.py": "", "pkg/sub/__init__.py": example, } write_files(files, tmp_path) # Make sure this attribute can be read statically version = expand.read_attr('pkg.sub.VERSION', root_dir=tmp_path) assert version == '0.1.1' assert is_static(version) @pytest.mark.parametrize( "example", [ "VERSION = (lambda: '0.1.1')()\n", "def fn(): return '0.1.1'\nVERSION = fn()\n", "VERSION: str = (lambda: '0.1.1')()\n", ], ) def test_read_dynamic_attr(self, tmp_path, monkeypatch, example): files = { "pkg/__init__.py": "", "pkg/sub/__init__.py": example, } write_files(files, tmp_path) monkeypatch.chdir(tmp_path) version = expand.read_attr('pkg.sub.VERSION') assert version == '0.1.1' assert not is_static(version) def test_import_order(self, tmp_path): """ Sometimes the import machinery will import the parent package of a nested module, which triggers side-effects and might create problems (see issue #3176) ``read_attr`` should bypass these limitations by resolving modules statically (via ast.literal_eval). """ files = { "src/pkg/__init__.py": "from .main import func\nfrom .about import version", "src/pkg/main.py": "import super_complicated_dep\ndef func(): return 42", "src/pkg/about.py": "version = '42'", } write_files(files, tmp_path) attr_desc = "pkg.about.version" package_dir = {"": "src"} # `import super_complicated_dep` should not run, otherwise the build fails assert expand.read_attr(attr_desc, package_dir, tmp_path) == "42" @pytest.mark.parametrize( ("package_dir", "file", "module", "return_value"), [ ({"": "src"}, "src/pkg/main.py", "pkg.main", 42), ({"pkg": "lib"}, "lib/main.py", "pkg.main", 13), ({}, "single_module.py", "single_module", 70), ({}, "flat_layout/pkg.py", "flat_layout.pkg", 836), ], ) def test_resolve_class(monkeypatch, tmp_path, package_dir, file, module, return_value): monkeypatch.setattr(sys, "modules", {}) # reproducibility files = {file: f"class Custom:\n def testing(self): return {return_value}"} write_files(files, tmp_path) cls = expand.resolve_class(f"{module}.Custom", package_dir, tmp_path) assert cls().testing() == return_value @pytest.mark.parametrize( ("args", "pkgs"), [ ({"where": ["."], "namespaces": False}, {"pkg", "other"}), ({"where": [".", "dir1"], "namespaces": False}, {"pkg", "other", "dir2"}), ({"namespaces": True}, {"pkg", "other", "dir1", "dir1.dir2"}), ({}, {"pkg", "other", "dir1", "dir1.dir2"}), # default value for `namespaces` ], ) def test_find_packages(tmp_path, args, pkgs): files = { "pkg/__init__.py", "other/__init__.py", "dir1/dir2/__init__.py", } write_files({k: "" for k in files}, tmp_path) package_dir = {} kwargs = {"root_dir": tmp_path, "fill_package_dir": package_dir, **args} where = kwargs.get("where", ["."]) assert set(expand.find_packages(**kwargs)) == pkgs for pkg in pkgs: pkg_path = find_package_path(pkg, package_dir, tmp_path) assert os.path.exists(pkg_path) # Make sure the same APIs work outside cwd where = [ str((tmp_path / p).resolve()).replace(os.sep, "/") # ensure posix-style paths for p in args.pop("where", ["."]) ] assert set(expand.find_packages(where=where, **args)) == pkgs @pytest.mark.parametrize( ("files", "where", "expected_package_dir"), [ (["pkg1/__init__.py", "pkg1/other.py"], ["."], {}), (["pkg1/__init__.py", "pkg2/__init__.py"], ["."], {}), (["src/pkg1/__init__.py", "src/pkg1/other.py"], ["src"], {"": "src"}), (["src/pkg1/__init__.py", "src/pkg2/__init__.py"], ["src"], {"": "src"}), ( ["src1/pkg1/__init__.py", "src2/pkg2/__init__.py"], ["src1", "src2"], {"pkg1": "src1/pkg1", "pkg2": "src2/pkg2"}, ), ( ["src/pkg1/__init__.py", "pkg2/__init__.py"], ["src", "."], {"pkg1": "src/pkg1"}, ), ], ) def test_fill_package_dir(tmp_path, files, where, expected_package_dir): write_files({k: "" for k in files}, tmp_path) pkg_dir = {} kwargs = {"root_dir": tmp_path, "fill_package_dir": pkg_dir, "namespaces": False} pkgs = expand.find_packages(where=where, **kwargs) assert set(pkg_dir.items()) == set(expected_package_dir.items()) for pkg in pkgs: pkg_path = find_package_path(pkg, pkg_dir, tmp_path) assert os.path.exists(pkg_path) tests/config/downloads/__pycache__/__init__.cpython-310.pyc 0000644 00000004166 15030122015 0017611 0 ustar 00 o �h# � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ d dlm Z g d�Z dZ ee �j Zefdd d�Zedfd dd�Zd dd�Zd dd�ZdS ) � )� annotationsN)�Path)� HTTPError)�urlopen)� DOWNLOAD_DIR� retrieve_file� output_file�urls_from_file)zhttp://zhttps://z github.com/z/raw/�url�str� download_dirr �returnc C s@ | � � }tD ]}|�|d�� � � d�� � }qt|t�dd|��S )N� z/:z [^\-_\.\w\d]+�_)�strip� NAME_REMOVE�replacer �re�sub)r r � file_name�part� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/downloads/__init__.pyr s r � �wait�floatc C s� t | |�}|�� rtd| � d|� d�� |S |jddd� td| � d|� �� zt| |� W |S tyC t�|� t| |� Y |S w )Nz Skipping z (already exists: �)T)�exist_ok�parentsz Downloading z to )r �exists�print�mkdir�downloadr �time�sleep)r r r �pathr r r r s � � �r � list_file� list[str]c C s, t d| � �� | jdd�}dd� |�� D �S )z^``list_file`` should be a text file where each line corresponds to a URL to download. zfile: zutf-8)�encodingc S s g | ] }|� d �s|�qS )�#)� startswith)�.0r r r r � <listcomp>1 s z"urls_from_file.<locals>.<listcomp>)r � read_text� splitlines)r& �contentr r r r + s r �destc C sx t | �� }|�� }W d � n1 sw Y t|d�� }|�|� W d � n1 s-w Y t|��� s:J �d S )N�wb)r �read�open�writer r )r r0 �f�datar r r r" 4 s � �r" )r r r r r r )r r r r r r r r )r& r r r' )r r r0 r )� __future__r r r# �pathlibr � urllib.errorr �urllib.requestr �__all__r �__file__�parentr r r r r" r r r r �<module> s tests/config/downloads/__pycache__/preload.cpython-310.pyc 0000644 00000001235 15030122015 0017472 0 ustar 00 o �h� � @ sX d Z ddlZddlmZ ddlmZmZ edkr*eeejd ��Z e e ee �� dS dS )z�This file can be used to preload files needed for testing. For example you can use:: cd setuptools/tests/config python -m downloads.preload setupcfg_examples.txt to make sure the `setup.cfg` examples are downloaded before starting the tests. � N)�Path� )� retrieve_file�urls_from_file�__main__) �__doc__�sys�pathlibr � r r �__name__�argv�urls�list�map� r r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/config/downloads/preload.py�<module> s � tests/config/downloads/preload.py 0000644 00000000702 15030122015 0013131 0 ustar 00 """This file can be used to preload files needed for testing. For example you can use:: cd setuptools/tests/config python -m downloads.preload setupcfg_examples.txt to make sure the `setup.cfg` examples are downloaded before starting the tests. """ import sys from pathlib import Path from . import retrieve_file, urls_from_file if __name__ == "__main__": urls = urls_from_file(Path(sys.argv[1])) list(map(retrieve_file, urls)) tests/config/downloads/__init__.py 0000644 00000003443 15030122015 0013247 0 ustar 00 from __future__ import annotations import re import time from pathlib import Path from urllib.error import HTTPError from urllib.request import urlopen __all__ = ["DOWNLOAD_DIR", "retrieve_file", "output_file", "urls_from_file"] NAME_REMOVE = ("http://", "https://", "github.com/", "/raw/") DOWNLOAD_DIR = Path(__file__).parent # ---------------------------------------------------------------------- # Please update ./preload.py accordingly when modifying this file # ---------------------------------------------------------------------- def output_file(url: str, download_dir: Path = DOWNLOAD_DIR) -> Path: file_name = url.strip() for part in NAME_REMOVE: file_name = file_name.replace(part, '').strip().strip('/:').strip() return Path(download_dir, re.sub(r"[^\-_\.\w\d]+", "_", file_name)) def retrieve_file(url: str, download_dir: Path = DOWNLOAD_DIR, wait: float = 5) -> Path: path = output_file(url, download_dir) if path.exists(): print(f"Skipping {url} (already exists: {path})") else: download_dir.mkdir(exist_ok=True, parents=True) print(f"Downloading {url} to {path}") try: download(url, path) except HTTPError: time.sleep(wait) # wait a few seconds and try again. download(url, path) return path def urls_from_file(list_file: Path) -> list[str]: """``list_file`` should be a text file where each line corresponds to a URL to download. """ print(f"file: {list_file}") content = list_file.read_text(encoding="utf-8") return [url for url in content.splitlines() if not url.startswith("#")] def download(url: str, dest: Path): with urlopen(url) as f: data = f.read() with open(dest, "wb") as f: f.write(data) assert Path(dest).exists() tests/config/__init__.py 0000644 00000000000 15030122015 0011237 0 ustar 00 tests/mod_with_constant.py 0000644 00000000026 15030122015 0011766 0 ustar 00 value = 'three, sir!' tests/test_bdist_deprecations.py 0000644 00000001407 15030122015 0013153 0 ustar 00 """develop tests""" import sys from unittest import mock import pytest from setuptools import SetuptoolsDeprecationWarning from setuptools.dist import Distribution @pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') @pytest.mark.xfail(reason="bdist_rpm is long deprecated, should we remove it? #1988") @mock.patch('distutils.command.bdist_rpm.bdist_rpm') def test_bdist_rpm_warning(distutils_cmd, tmpdir_cwd): dist = Distribution( dict( script_name='setup.py', script_args=['bdist_rpm'], name='foo', py_modules=['hi'], ) ) dist.parse_command_line() with pytest.warns(SetuptoolsDeprecationWarning): dist.run_commands() distutils_cmd.run.assert_called_once() tests/test_warnings.py 0000644 00000006423 15030122015 0011141 0 ustar 00 from inspect import cleandoc import pytest from setuptools.warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning _EXAMPLES = { "default": dict( args=("Hello {x}", "\n\t{target} {v:.1f}"), kwargs={"x": 5, "v": 3, "target": "World"}, expected=""" Hello 5 !! ******************************************************************************** World 3.0 ******************************************************************************** !! """, ), "futue_due_date": dict( args=("Summary", "Lorem ipsum"), kwargs={"due_date": (9999, 11, 22)}, expected=""" Summary !! ******************************************************************************** Lorem ipsum By 9999-Nov-22, you need to update your project and remove deprecated calls or your builds will no longer be supported. ******************************************************************************** !! """, ), "past_due_date_with_docs": dict( args=("Summary", "Lorem ipsum"), kwargs={"due_date": (2000, 11, 22), "see_docs": "some_page.html"}, expected=""" Summary !! ******************************************************************************** Lorem ipsum This deprecation is overdue, please update your project and remove deprecated calls to avoid build errors in the future. See https://setuptools.pypa.io/en/latest/some_page.html for details. ******************************************************************************** !! """, ), } @pytest.mark.parametrize("example_name", _EXAMPLES.keys()) def test_formatting(monkeypatch, example_name): """ It should automatically handle indentation, interpolation and things like due date. """ args = _EXAMPLES[example_name]["args"] kwargs = _EXAMPLES[example_name]["kwargs"] expected = _EXAMPLES[example_name]["expected"] monkeypatch.setenv("SETUPTOOLS_ENFORCE_DEPRECATION", "false") with pytest.warns(SetuptoolsWarning) as warn_info: SetuptoolsWarning.emit(*args, **kwargs) assert _get_message(warn_info) == cleandoc(expected) def test_due_date_enforcement(monkeypatch): class _MyDeprecation(SetuptoolsDeprecationWarning): _SUMMARY = "Summary" _DETAILS = "Lorem ipsum" _DUE_DATE = (2000, 11, 22) _SEE_DOCS = "some_page.html" monkeypatch.setenv("SETUPTOOLS_ENFORCE_DEPRECATION", "true") with pytest.raises(SetuptoolsDeprecationWarning) as exc_info: _MyDeprecation.emit() expected = """ Summary !! ******************************************************************************** Lorem ipsum This deprecation is overdue, please update your project and remove deprecated calls to avoid build errors in the future. See https://setuptools.pypa.io/en/latest/some_page.html for details. ******************************************************************************** !! """ assert str(exc_info.value) == cleandoc(expected) def _get_message(warn_info): return next(warn.message.args[0] for warn in warn_info) tests/fixtures.py 0000644 00000012115 15030122015 0010116 0 ustar 00 import contextlib import os import subprocess import sys from pathlib import Path import path import pytest from . import contexts, environment @pytest.fixture def user_override(monkeypatch): """ Override site.USER_BASE and site.USER_SITE with temporary directories in a context. """ with contexts.tempdir() as user_base: monkeypatch.setattr('site.USER_BASE', user_base) with contexts.tempdir() as user_site: monkeypatch.setattr('site.USER_SITE', user_site) with contexts.save_user_site_setting(): yield @pytest.fixture def tmpdir_cwd(tmpdir): with tmpdir.as_cwd() as orig: yield orig @pytest.fixture(autouse=True, scope="session") def workaround_xdist_376(request): """ Workaround pytest-dev/pytest-xdist#376 ``pytest-xdist`` tends to inject '' into ``sys.path``, which may break certain isolation expectations. Remove the entry so the import machinery behaves the same irrespective of xdist. """ if not request.config.pluginmanager.has_plugin('xdist'): return with contextlib.suppress(ValueError): sys.path.remove('') @pytest.fixture def sample_project(tmp_path): """ Clone the 'sampleproject' and return a path to it. """ cmd = ['git', 'clone', 'https://github.com/pypa/sampleproject'] try: subprocess.check_call(cmd, cwd=str(tmp_path)) except Exception: pytest.skip("Unable to clone sampleproject") return tmp_path / 'sampleproject' # sdist and wheel artifacts should be stable across a round of tests # so we can build them once per session and use the files as "readonly" # In the case of setuptools, building the wheel without sdist may cause # it to contain the `build` directory, and therefore create situations with # `setuptools/build/lib/build/lib/...`. To avoid that, build both artifacts at once. def _build_distributions(tmp_path_factory, request): with contexts.session_locked_tmp_dir( request, tmp_path_factory, "dist_build" ) as tmp: # pragma: no cover sdist = next(tmp.glob("*.tar.gz"), None) wheel = next(tmp.glob("*.whl"), None) if sdist and wheel: return (sdist, wheel) # Sanity check: should not create recursive setuptools/build/lib/build/lib/... assert not Path(request.config.rootdir, "build/lib/build").exists() subprocess.check_output([ sys.executable, "-m", "build", "--outdir", str(tmp), str(request.config.rootdir), ]) # Sanity check: should not create recursive setuptools/build/lib/build/lib/... assert not Path(request.config.rootdir, "build/lib/build").exists() return next(tmp.glob("*.tar.gz")), next(tmp.glob("*.whl")) @pytest.fixture(scope="session") def setuptools_sdist(tmp_path_factory, request): prebuilt = os.getenv("PRE_BUILT_SETUPTOOLS_SDIST") if prebuilt and os.path.exists(prebuilt): # pragma: no cover return Path(prebuilt).resolve() sdist, _ = _build_distributions(tmp_path_factory, request) return sdist @pytest.fixture(scope="session") def setuptools_wheel(tmp_path_factory, request): prebuilt = os.getenv("PRE_BUILT_SETUPTOOLS_WHEEL") if prebuilt and os.path.exists(prebuilt): # pragma: no cover return Path(prebuilt).resolve() _, wheel = _build_distributions(tmp_path_factory, request) return wheel @pytest.fixture def venv(tmp_path, setuptools_wheel): """Virtual env with the version of setuptools under test installed""" env = environment.VirtualEnv() env.root = path.Path(tmp_path / 'venv') env.create_opts = ['--no-setuptools', '--wheel=bundle'] # TODO: Use `--no-wheel` when setuptools implements its own bdist_wheel env.req = str(setuptools_wheel) # In some environments (eg. downstream distro packaging), # where tox isn't used to run tests and PYTHONPATH is set to point to # a specific setuptools codebase, PYTHONPATH will leak into the spawned # processes. # env.create() should install the just created setuptools # wheel, but it doesn't if it finds another existing matching setuptools # installation present on PYTHONPATH: # `setuptools is already installed with the same version as the provided # wheel. Use --force-reinstall to force an installation of the wheel.` # This prevents leaking PYTHONPATH to the created environment. with contexts.environment(PYTHONPATH=None): return env.create() @pytest.fixture def venv_without_setuptools(tmp_path): """Virtual env without any version of setuptools installed""" env = environment.VirtualEnv() env.root = path.Path(tmp_path / 'venv_without_setuptools') env.create_opts = ['--no-setuptools', '--no-wheel'] env.ensure_env() return env @pytest.fixture def bare_venv(tmp_path): """Virtual env without any common packages installed""" env = environment.VirtualEnv() env.root = path.Path(tmp_path / 'bare_venv') env.create_opts = ['--no-setuptools', '--no-pip', '--no-wheel', '--no-seed'] env.ensure_env() return env tests/test_bdist_wheel.py 0000644 00000055053 15030122015 0011605 0 ustar 00 from __future__ import annotations import builtins import importlib import os.path import platform import shutil import stat import struct import sys import sysconfig from contextlib import suppress from inspect import cleandoc from zipfile import ZipFile import jaraco.path import pytest from packaging import tags import setuptools from setuptools.command.bdist_wheel import bdist_wheel, get_abi_tag from setuptools.dist import Distribution from setuptools.warnings import SetuptoolsDeprecationWarning from distutils.core import run_setup DEFAULT_FILES = { "dummy_dist-1.0.dist-info/top_level.txt", "dummy_dist-1.0.dist-info/METADATA", "dummy_dist-1.0.dist-info/WHEEL", "dummy_dist-1.0.dist-info/RECORD", } DEFAULT_LICENSE_FILES = { "LICENSE", "LICENSE.txt", "LICENCE", "LICENCE.txt", "COPYING", "COPYING.md", "NOTICE", "NOTICE.rst", "AUTHORS", "AUTHORS.txt", } OTHER_IGNORED_FILES = { "LICENSE~", "AUTHORS~", } SETUPPY_EXAMPLE = """\ from setuptools import setup setup( name='dummy_dist', version='1.0', ) """ EXAMPLES = { "dummy-dist": { "setup.py": SETUPPY_EXAMPLE, "licenses_dir": {"DUMMYFILE": ""}, **dict.fromkeys(DEFAULT_LICENSE_FILES | OTHER_IGNORED_FILES, ""), }, "simple-dist": { "setup.py": cleandoc( """ from setuptools import setup setup( name="simple.dist", version="0.1", description="A testing distribution \N{SNOWMAN}", extras_require={"voting": ["beaglevote"]}, ) """ ), "simpledist": "", }, "complex-dist": { "setup.py": cleandoc( """ from setuptools import setup setup( name="complex-dist", version="0.1", description="Another testing distribution \N{SNOWMAN}", long_description="Another testing distribution \N{SNOWMAN}", author="Illustrious Author", author_email="illustrious@example.org", url="http://example.org/exemplary", packages=["complexdist"], setup_requires=["setuptools"], install_requires=["quux", "splort"], extras_require={"simple": ["simple.dist"]}, entry_points={ "console_scripts": [ "complex-dist=complexdist:main", "complex-dist2=complexdist:main", ], }, ) """ ), "complexdist": {"__init__.py": "def main(): return"}, }, "headers-dist": { "setup.py": cleandoc( """ from setuptools import setup setup( name="headers.dist", version="0.1", description="A distribution with headers", headers=["header.h"], ) """ ), "headersdist.py": "", "header.h": "", }, "commasinfilenames-dist": { "setup.py": cleandoc( """ from setuptools import setup setup( name="testrepo", version="0.1", packages=["mypackage"], description="A test package with commas in file names", include_package_data=True, package_data={"mypackage.data": ["*"]}, ) """ ), "mypackage": { "__init__.py": "", "data": {"__init__.py": "", "1,2,3.txt": ""}, }, "testrepo-0.1.0": { "mypackage": {"__init__.py": ""}, }, }, "unicode-dist": { "setup.py": cleandoc( """ from setuptools import setup setup( name="unicode.dist", version="0.1", description="A testing distribution \N{SNOWMAN}", packages=["unicodedist"], zip_safe=True, ) """ ), "unicodedist": {"__init__.py": "", "åäö_日本語.py": ""}, }, "utf8-metadata-dist": { "setup.cfg": cleandoc( """ [metadata] name = utf8-metadata-dist version = 42 author_email = "John X. Ãørçeč" <john@utf8.org>, Γαμα קּ 東 <gama@utf8.org> long_description = file: README.rst """ ), "README.rst": "UTF-8 描述 説明", }, "licenses-dist": { "setup.cfg": cleandoc( """ [metadata] name = licenses-dist version = 1.0 license_files = **/LICENSE """ ), "LICENSE": "", "src": { "vendor": {"LICENSE": ""}, }, }, } if sys.platform != "win32": # ABI3 extensions don't really work on Windows EXAMPLES["abi3extension-dist"] = { "setup.py": cleandoc( """ from setuptools import Extension, setup setup( name="extension.dist", version="0.1", description="A testing distribution \N{SNOWMAN}", ext_modules=[ Extension( name="extension", sources=["extension.c"], py_limited_api=True ) ], ) """ ), "setup.cfg": "[bdist_wheel]\npy_limited_api=cp32", "extension.c": "#define Py_LIMITED_API 0x03020000\n#include <Python.h>", } def bdist_wheel_cmd(**kwargs): """Run command in the same process so that it is easier to collect coverage""" dist_obj = ( run_setup("setup.py", stop_after="init") if os.path.exists("setup.py") else Distribution({"script_name": "%%build_meta%%"}) ) dist_obj.parse_config_files() cmd = bdist_wheel(dist_obj) for attr, value in kwargs.items(): setattr(cmd, attr, value) cmd.finalize_options() return cmd def mkexample(tmp_path_factory, name): basedir = tmp_path_factory.mktemp(name) jaraco.path.build(EXAMPLES[name], prefix=str(basedir)) return basedir @pytest.fixture(scope="session") def wheel_paths(tmp_path_factory): build_base = tmp_path_factory.mktemp("build") dist_dir = tmp_path_factory.mktemp("dist") for name in EXAMPLES: example_dir = mkexample(tmp_path_factory, name) build_dir = build_base / name with jaraco.path.DirectoryStack().context(example_dir): bdist_wheel_cmd(bdist_dir=str(build_dir), dist_dir=str(dist_dir)).run() return sorted(str(fname) for fname in dist_dir.glob("*.whl")) @pytest.fixture def dummy_dist(tmp_path_factory): return mkexample(tmp_path_factory, "dummy-dist") @pytest.fixture def licenses_dist(tmp_path_factory): return mkexample(tmp_path_factory, "licenses-dist") def test_no_scripts(wheel_paths): """Make sure entry point scripts are not generated.""" path = next(path for path in wheel_paths if "complex_dist" in path) for entry in ZipFile(path).infolist(): assert ".data/scripts/" not in entry.filename def test_unicode_record(wheel_paths): path = next(path for path in wheel_paths if "unicode_dist" in path) with ZipFile(path) as zf: record = zf.read("unicode_dist-0.1.dist-info/RECORD") assert "åäö_日本語.py".encode() in record UTF8_PKG_INFO = """\ Metadata-Version: 2.1 Name: helloworld Version: 42 Author-email: "John X. Ãørçeč" <john@utf8.org>, Γαμα קּ 東 <gama@utf8.org> UTF-8 描述 説明 """ def test_preserve_unicode_metadata(monkeypatch, tmp_path): monkeypatch.chdir(tmp_path) egginfo = tmp_path / "dummy_dist.egg-info" distinfo = tmp_path / "dummy_dist.dist-info" egginfo.mkdir() (egginfo / "PKG-INFO").write_text(UTF8_PKG_INFO, encoding="utf-8") (egginfo / "dependency_links.txt").touch() class simpler_bdist_wheel(bdist_wheel): """Avoid messing with setuptools/distutils internals""" def __init__(self): pass @property def license_paths(self): return [] cmd_obj = simpler_bdist_wheel() cmd_obj.egg2dist(egginfo, distinfo) metadata = (distinfo / "METADATA").read_text(encoding="utf-8") assert 'Author-email: "John X. Ãørçeč"' in metadata assert "Γαμα קּ 東 " in metadata assert "UTF-8 描述 説明" in metadata def test_licenses_default(dummy_dist, monkeypatch, tmp_path): monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: license_files = { "dummy_dist-1.0.dist-info/licenses/" + fname for fname in DEFAULT_LICENSE_FILES } assert set(wf.namelist()) == DEFAULT_FILES | license_files def test_licenses_deprecated(dummy_dist, monkeypatch, tmp_path): dummy_dist.joinpath("setup.cfg").write_text( "[metadata]\nlicense_file=licenses_dir/DUMMYFILE", encoding="utf-8" ) monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: license_files = {"dummy_dist-1.0.dist-info/licenses/licenses_dir/DUMMYFILE"} assert set(wf.namelist()) == DEFAULT_FILES | license_files @pytest.mark.parametrize( ("config_file", "config"), [ ("setup.cfg", "[metadata]\nlicense_files=licenses_dir/*\n LICENSE"), ("setup.cfg", "[metadata]\nlicense_files=licenses_dir/*, LICENSE"), ( "setup.py", SETUPPY_EXAMPLE.replace( ")", " license_files=['licenses_dir/DUMMYFILE', 'LICENSE'])" ), ), ], ) def test_licenses_override(dummy_dist, monkeypatch, tmp_path, config_file, config): dummy_dist.joinpath(config_file).write_text(config, encoding="utf-8") monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: license_files = { "dummy_dist-1.0.dist-info/licenses/" + fname for fname in {"licenses_dir/DUMMYFILE", "LICENSE"} } assert set(wf.namelist()) == DEFAULT_FILES | license_files metadata = wf.read("dummy_dist-1.0.dist-info/METADATA").decode("utf8") assert "License-File: licenses_dir/DUMMYFILE" in metadata assert "License-File: LICENSE" in metadata def test_licenses_preserve_folder_structure(licenses_dist, monkeypatch, tmp_path): monkeypatch.chdir(licenses_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() print(os.listdir("dist")) with ZipFile("dist/licenses_dist-1.0-py3-none-any.whl") as wf: default_files = {name.replace("dummy_", "licenses_") for name in DEFAULT_FILES} license_files = { "licenses_dist-1.0.dist-info/licenses/LICENSE", "licenses_dist-1.0.dist-info/licenses/src/vendor/LICENSE", } assert set(wf.namelist()) == default_files | license_files metadata = wf.read("licenses_dist-1.0.dist-info/METADATA").decode("utf8") assert "License-File: src/vendor/LICENSE" in metadata assert "License-File: LICENSE" in metadata def test_licenses_disabled(dummy_dist, monkeypatch, tmp_path): dummy_dist.joinpath("setup.cfg").write_text( "[metadata]\nlicense_files=\n", encoding="utf-8" ) monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: assert set(wf.namelist()) == DEFAULT_FILES def test_build_number(dummy_dist, monkeypatch, tmp_path): monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path), build_number="2").run() with ZipFile("dist/dummy_dist-1.0-2-py3-none-any.whl") as wf: filenames = set(wf.namelist()) assert "dummy_dist-1.0.dist-info/RECORD" in filenames assert "dummy_dist-1.0.dist-info/METADATA" in filenames def test_universal_deprecated(dummy_dist, monkeypatch, tmp_path): monkeypatch.chdir(dummy_dist) with pytest.warns(SetuptoolsDeprecationWarning, match=".*universal is deprecated"): bdist_wheel_cmd(bdist_dir=str(tmp_path), universal=True).run() # For now we still respect the option assert os.path.exists("dist/dummy_dist-1.0-py2.py3-none-any.whl") EXTENSION_EXAMPLE = """\ #include <Python.h> static PyMethodDef methods[] = { { NULL, NULL, 0, NULL } }; static struct PyModuleDef module_def = { PyModuleDef_HEAD_INIT, "extension", "Dummy extension module", -1, methods }; PyMODINIT_FUNC PyInit_extension(void) { return PyModule_Create(&module_def); } """ EXTENSION_SETUPPY = """\ from __future__ import annotations from setuptools import Extension, setup setup( name="extension.dist", version="0.1", description="A testing distribution \N{SNOWMAN}", ext_modules=[Extension(name="extension", sources=["extension.c"])], ) """ @pytest.mark.filterwarnings( "once:Config variable '.*' is unset.*, Python ABI tag may be incorrect" ) def test_limited_abi(monkeypatch, tmp_path, tmp_path_factory): """Test that building a binary wheel with the limited ABI works.""" source_dir = tmp_path_factory.mktemp("extension_dist") (source_dir / "setup.py").write_text(EXTENSION_SETUPPY, encoding="utf-8") (source_dir / "extension.c").write_text(EXTENSION_EXAMPLE, encoding="utf-8") build_dir = tmp_path.joinpath("build") dist_dir = tmp_path.joinpath("dist") monkeypatch.chdir(source_dir) bdist_wheel_cmd(bdist_dir=str(build_dir), dist_dir=str(dist_dir)).run() def test_build_from_readonly_tree(dummy_dist, monkeypatch, tmp_path): basedir = str(tmp_path.joinpath("dummy")) shutil.copytree(str(dummy_dist), basedir) monkeypatch.chdir(basedir) # Make the tree read-only for root, _dirs, files in os.walk(basedir): for fname in files: os.chmod(os.path.join(root, fname), stat.S_IREAD) bdist_wheel_cmd().run() @pytest.mark.parametrize( ("option", "compress_type"), list(bdist_wheel.supported_compressions.items()), ids=list(bdist_wheel.supported_compressions), ) def test_compression(dummy_dist, monkeypatch, tmp_path, option, compress_type): monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path), compression=option).run() with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: filenames = set(wf.namelist()) assert "dummy_dist-1.0.dist-info/RECORD" in filenames assert "dummy_dist-1.0.dist-info/METADATA" in filenames for zinfo in wf.filelist: assert zinfo.compress_type == compress_type def test_wheelfile_line_endings(wheel_paths): for path in wheel_paths: with ZipFile(path) as wf: wheelfile = next(fn for fn in wf.filelist if fn.filename.endswith("WHEEL")) wheelfile_contents = wf.read(wheelfile) assert b"\r" not in wheelfile_contents def test_unix_epoch_timestamps(dummy_dist, monkeypatch, tmp_path): monkeypatch.setenv("SOURCE_DATE_EPOCH", "0") monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(bdist_dir=str(tmp_path), build_number="2a").run() with ZipFile("dist/dummy_dist-1.0-2a-py3-none-any.whl") as wf: for zinfo in wf.filelist: assert zinfo.date_time >= (1980, 1, 1, 0, 0, 0) # min epoch is used def test_get_abi_tag_windows(monkeypatch): monkeypatch.setattr(tags, "interpreter_name", lambda: "cp") monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "cp313-win_amd64") assert get_abi_tag() == "cp313" monkeypatch.setattr(sys, "gettotalrefcount", lambda: 1, False) assert get_abi_tag() == "cp313d" monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "cp313t-win_amd64") assert get_abi_tag() == "cp313td" monkeypatch.delattr(sys, "gettotalrefcount") assert get_abi_tag() == "cp313t" def test_get_abi_tag_pypy_old(monkeypatch): monkeypatch.setattr(tags, "interpreter_name", lambda: "pp") monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "pypy36-pp73") assert get_abi_tag() == "pypy36_pp73" def test_get_abi_tag_pypy_new(monkeypatch): monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "pypy37-pp73-darwin") monkeypatch.setattr(tags, "interpreter_name", lambda: "pp") assert get_abi_tag() == "pypy37_pp73" def test_get_abi_tag_graalpy(monkeypatch): monkeypatch.setattr( sysconfig, "get_config_var", lambda x: "graalpy231-310-native-x86_64-linux" ) monkeypatch.setattr(tags, "interpreter_name", lambda: "graalpy") assert get_abi_tag() == "graalpy231_310_native" def test_get_abi_tag_fallback(monkeypatch): monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "unknown-python-310") monkeypatch.setattr(tags, "interpreter_name", lambda: "unknown-python") assert get_abi_tag() == "unknown_python_310" def test_platform_with_space(dummy_dist, monkeypatch): """Ensure building on platforms with a space in the name succeed.""" monkeypatch.chdir(dummy_dist) bdist_wheel_cmd(plat_name="isilon onefs").run() def test_data_dir_with_tag_build(monkeypatch, tmp_path): """ Setuptools allow authors to set PEP 440's local version segments using ``egg_info.tag_build``. This should be reflected not only in the ``.whl`` file name, but also in the ``.dist-info`` and ``.data`` dirs. See pypa/setuptools#3997. """ monkeypatch.chdir(tmp_path) files = { "setup.py": """ from setuptools import setup setup(headers=["hello.h"]) """, "setup.cfg": """ [metadata] name = test version = 1.0 [options.data_files] hello/world = file.txt [egg_info] tag_build = +what tag_date = 0 """, "file.txt": "", "hello.h": "", } for file, content in files.items(): with open(file, "w", encoding="utf-8") as fh: fh.write(cleandoc(content)) bdist_wheel_cmd().run() # Ensure .whl, .dist-info and .data contain the local segment wheel_path = "dist/test-1.0+what-py3-none-any.whl" assert os.path.exists(wheel_path) entries = set(ZipFile(wheel_path).namelist()) for expected in ( "test-1.0+what.data/headers/hello.h", "test-1.0+what.data/data/hello/world/file.txt", "test-1.0+what.dist-info/METADATA", "test-1.0+what.dist-info/WHEEL", ): assert expected in entries for not_expected in ( "test.data/headers/hello.h", "test-1.0.data/data/hello/world/file.txt", "test.dist-info/METADATA", "test-1.0.dist-info/WHEEL", ): assert not_expected not in entries @pytest.mark.parametrize( ("reported", "expected"), [("linux-x86_64", "linux_i686"), ("linux-aarch64", "linux_armv7l")], ) @pytest.mark.skipif( platform.system() != "Linux", reason="Only makes sense to test on Linux" ) def test_platform_linux32(reported, expected, monkeypatch): monkeypatch.setattr(struct, "calcsize", lambda x: 4) dist = setuptools.Distribution() cmd = bdist_wheel(dist) cmd.plat_name = reported cmd.root_is_pure = False _, _, actual = cmd.get_tag() assert actual == expected def test_no_ctypes(monkeypatch) -> None: def _fake_import(name: str, *args, **kwargs): if name == "ctypes": raise ModuleNotFoundError(f"No module named {name}") return importlib.__import__(name, *args, **kwargs) with suppress(KeyError): monkeypatch.delitem(sys.modules, "wheel.macosx_libfile") # Install an importer shim that refuses to load ctypes monkeypatch.setattr(builtins, "__import__", _fake_import) with pytest.raises(ModuleNotFoundError, match="No module named ctypes"): import wheel.macosx_libfile # noqa: F401 # Unload and reimport the bdist_wheel command module to make sure it won't try to # import ctypes monkeypatch.delitem(sys.modules, "setuptools.command.bdist_wheel") import setuptools.command.bdist_wheel # noqa: F401 def test_dist_info_provided(dummy_dist, monkeypatch, tmp_path): monkeypatch.chdir(dummy_dist) distinfo = tmp_path / "dummy_dist.dist-info" distinfo.mkdir() (distinfo / "METADATA").write_text("name: helloworld", encoding="utf-8") # We don't control the metadata. According to PEP-517, "The hook MAY also # create other files inside this directory, and a build frontend MUST # preserve". (distinfo / "FOO").write_text("bar", encoding="utf-8") bdist_wheel_cmd(bdist_dir=str(tmp_path), dist_info_dir=str(distinfo)).run() expected = { "dummy_dist-1.0.dist-info/FOO", "dummy_dist-1.0.dist-info/RECORD", } with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: files_found = set(wf.namelist()) # Check that all expected files are there. assert expected - files_found == set() # Make sure there is no accidental egg-info bleeding into the wheel. assert not [path for path in files_found if 'egg-info' in str(path)] def test_allow_grace_period_parent_directory_license(monkeypatch, tmp_path): # Motivation: https://github.com/pypa/setuptools/issues/4892 # TODO: Remove this test after deprecation period is over files = { "LICENSE.txt": "parent license", # <---- the license files are outside "NOTICE.txt": "parent notice", "python": { "pyproject.toml": cleandoc( """ [project] name = "test-proj" dynamic = ["version"] # <---- testing dynamic will not break [tool.setuptools.dynamic] version.file = "VERSION" """ ), "setup.cfg": cleandoc( """ [metadata] license_files = ../LICENSE.txt ../NOTICE.txt """ ), "VERSION": "42", }, } jaraco.path.build(files, prefix=str(tmp_path)) monkeypatch.chdir(tmp_path / "python") msg = "Pattern '../.*.txt' cannot contain '..'" with pytest.warns(SetuptoolsDeprecationWarning, match=msg): bdist_wheel_cmd().run() with ZipFile("dist/test_proj-42-py3-none-any.whl") as wf: files_found = set(wf.namelist()) expected_files = { "test_proj-42.dist-info/licenses/LICENSE.txt", "test_proj-42.dist-info/licenses/NOTICE.txt", } assert expected_files <= files_found metadata = wf.read("test_proj-42.dist-info/METADATA").decode("utf8") assert "License-File: LICENSE.txt" in metadata assert "License-File: NOTICE.txt" in metadata tests/test_develop.py 0000644 00000012026 15030122015 0010743 0 ustar 00 """develop tests""" import os import pathlib import platform import subprocess import sys import pytest from setuptools._path import paths_on_pythonpath from setuptools.command.develop import develop from setuptools.dist import Distribution from . import contexts, namespaces SETUP_PY = """\ from setuptools import setup setup(name='foo', packages=['foo'], ) """ INIT_PY = """print "foo" """ @pytest.fixture def temp_user(monkeypatch): with contexts.tempdir() as user_base: with contexts.tempdir() as user_site: monkeypatch.setattr('site.USER_BASE', user_base) monkeypatch.setattr('site.USER_SITE', user_site) yield @pytest.fixture def test_env(tmpdir, temp_user): target = tmpdir foo = target.mkdir('foo') setup = target / 'setup.py' if setup.isfile(): raise ValueError(dir(target)) with setup.open('w') as f: f.write(SETUP_PY) init = foo / '__init__.py' with init.open('w') as f: f.write(INIT_PY) with target.as_cwd(): yield target class TestDevelop: in_virtualenv = hasattr(sys, 'real_prefix') in_venv = hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix def test_console_scripts(self, tmpdir): """ Test that console scripts are installed and that they reference only the project by name and not the current version. """ pytest.skip( "TODO: needs a fixture to cause 'develop' " "to be invoked without mutating environment." ) settings = dict( name='foo', packages=['foo'], version='0.0', entry_points={ 'console_scripts': [ 'foocmd = foo:foo', ], }, ) dist = Distribution(settings) dist.script_name = 'setup.py' cmd = develop(dist) cmd.ensure_finalized() cmd.install_dir = tmpdir cmd.run() # assert '0.0' not in foocmd_text @pytest.mark.xfail(reason="legacy behavior retained for compatibility #4167") def test_egg_link_filename(self): settings = dict( name='Foo $$$ Bar_baz-bing', ) dist = Distribution(settings) cmd = develop(dist) cmd.ensure_finalized() link = pathlib.Path(cmd.egg_link) assert link.suffix == '.egg-link' assert link.stem == 'Foo_Bar_baz_bing' class TestResolver: """ TODO: These tests were written with a minimal understanding of what _resolve_setup_path is intending to do. Come up with more meaningful cases that look like real-world scenarios. """ def test_resolve_setup_path_cwd(self): assert develop._resolve_setup_path('.', '.', '.') == '.' def test_resolve_setup_path_one_dir(self): assert develop._resolve_setup_path('pkgs', '.', 'pkgs') == '../' def test_resolve_setup_path_one_dir_trailing_slash(self): assert develop._resolve_setup_path('pkgs/', '.', 'pkgs') == '../' class TestNamespaces: @staticmethod def install_develop(src_dir, target): develop_cmd = [ sys.executable, 'setup.py', 'develop', '--install-dir', str(target), ] with src_dir.as_cwd(): with paths_on_pythonpath([str(target)]): subprocess.check_call(develop_cmd) @pytest.mark.skipif( bool(os.environ.get("APPVEYOR")), reason="https://github.com/pypa/setuptools/issues/851", ) @pytest.mark.skipif( platform.python_implementation() == 'PyPy', reason="https://github.com/pypa/setuptools/issues/1202", ) def test_namespace_package_importable(self, tmpdir): """ Installing two packages sharing the same namespace, one installed naturally using pip or `--single-version-externally-managed` and the other installed using `develop` should leave the namespace in tact and both packages reachable by import. """ pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') target = tmpdir / 'packages' # use pip to install to the target directory install_cmd = [ sys.executable, '-m', 'pip', 'install', str(pkg_A), '-t', str(target), ] subprocess.check_call(install_cmd) self.install_develop(pkg_B, target) namespaces.make_site_dir(target) try_import = [ sys.executable, '-c', 'import myns.pkgA; import myns.pkgB', ] with paths_on_pythonpath([str(target)]): subprocess.check_call(try_import) # additionally ensure that pkg_resources import works pkg_resources_imp = [ sys.executable, '-c', 'import pkg_resources', ] with paths_on_pythonpath([str(target)]): subprocess.check_call(pkg_resources_imp) tests/test_build_ext.py 0000644 00000023563 15030122015 0011274 0 ustar 00 from __future__ import annotations import os import sys from importlib.util import cache_from_source as _compiled_file_name import pytest from jaraco import path from setuptools.command.build_ext import build_ext, get_abi3_suffix from setuptools.dist import Distribution from setuptools.errors import CompileError from setuptools.extension import Extension from . import environment from .textwrap import DALS import distutils.command.build_ext as orig from distutils.sysconfig import get_config_var IS_PYPY = '__pypy__' in sys.builtin_module_names class TestBuildExt: def test_get_ext_filename(self): """ Setuptools needs to give back the same result as distutils, even if the fullname is not in ext_map. """ dist = Distribution() cmd = build_ext(dist) cmd.ext_map['foo/bar'] = '' res = cmd.get_ext_filename('foo') wanted = orig.build_ext.get_ext_filename(cmd, 'foo') assert res == wanted def test_abi3_filename(self): """ Filename needs to be loadable by several versions of Python 3 if 'is_abi3' is truthy on Extension() """ print(get_abi3_suffix()) extension = Extension('spam.eggs', ['eggs.c'], py_limited_api=True) dist = Distribution(dict(ext_modules=[extension])) cmd = build_ext(dist) cmd.finalize_options() assert 'spam.eggs' in cmd.ext_map res = cmd.get_ext_filename('spam.eggs') if not get_abi3_suffix(): assert res.endswith(get_config_var('EXT_SUFFIX')) elif sys.platform == 'win32': assert res.endswith('eggs.pyd') else: assert 'abi3' in res def test_ext_suffix_override(self): """ SETUPTOOLS_EXT_SUFFIX variable always overrides default extension options. """ dist = Distribution() cmd = build_ext(dist) cmd.ext_map['for_abi3'] = ext = Extension( 'for_abi3', ['s.c'], # Override shouldn't affect abi3 modules py_limited_api=True, ) # Mock value needed to pass tests ext._links_to_dynamic = False if not IS_PYPY: expect = cmd.get_ext_filename('for_abi3') else: # PyPy builds do not use ABI3 tag, so they will # also get the overridden suffix. expect = 'for_abi3.test-suffix' try: os.environ['SETUPTOOLS_EXT_SUFFIX'] = '.test-suffix' res = cmd.get_ext_filename('normal') assert 'normal.test-suffix' == res res = cmd.get_ext_filename('for_abi3') assert expect == res finally: del os.environ['SETUPTOOLS_EXT_SUFFIX'] def dist_with_example(self): files = { "src": {"mypkg": {"subpkg": {"ext2.c": ""}}}, "c-extensions": {"ext1": {"main.c": ""}}, } ext1 = Extension("mypkg.ext1", ["c-extensions/ext1/main.c"]) ext2 = Extension("mypkg.subpkg.ext2", ["src/mypkg/subpkg/ext2.c"]) ext3 = Extension("ext3", ["c-extension/ext3.c"]) path.build(files) return Distribution({ "script_name": "%test%", "ext_modules": [ext1, ext2, ext3], "package_dir": {"": "src"}, }) def test_get_outputs(self, tmpdir_cwd, monkeypatch): monkeypatch.setenv('SETUPTOOLS_EXT_SUFFIX', '.mp3') # make test OS-independent monkeypatch.setattr('setuptools.command.build_ext.use_stubs', False) dist = self.dist_with_example() # Regular build: get_outputs not empty, but get_output_mappings is empty build_ext = dist.get_command_obj("build_ext") build_ext.editable_mode = False build_ext.ensure_finalized() build_lib = build_ext.build_lib.replace(os.sep, "/") outputs = [x.replace(os.sep, "/") for x in build_ext.get_outputs()] assert outputs == [ f"{build_lib}/ext3.mp3", f"{build_lib}/mypkg/ext1.mp3", f"{build_lib}/mypkg/subpkg/ext2.mp3", ] assert build_ext.get_output_mapping() == {} # Editable build: get_output_mappings should contain everything in get_outputs dist.reinitialize_command("build_ext") build_ext.editable_mode = True build_ext.ensure_finalized() mapping = { k.replace(os.sep, "/"): v.replace(os.sep, "/") for k, v in build_ext.get_output_mapping().items() } assert mapping == { f"{build_lib}/ext3.mp3": "src/ext3.mp3", f"{build_lib}/mypkg/ext1.mp3": "src/mypkg/ext1.mp3", f"{build_lib}/mypkg/subpkg/ext2.mp3": "src/mypkg/subpkg/ext2.mp3", } def test_get_output_mapping_with_stub(self, tmpdir_cwd, monkeypatch): monkeypatch.setenv('SETUPTOOLS_EXT_SUFFIX', '.mp3') # make test OS-independent monkeypatch.setattr('setuptools.command.build_ext.use_stubs', True) dist = self.dist_with_example() # Editable build should create compiled stubs (.pyc files only, no .py) build_ext = dist.get_command_obj("build_ext") build_ext.editable_mode = True build_ext.ensure_finalized() for ext in build_ext.extensions: monkeypatch.setattr(ext, "_needs_stub", True) build_lib = build_ext.build_lib.replace(os.sep, "/") mapping = { k.replace(os.sep, "/"): v.replace(os.sep, "/") for k, v in build_ext.get_output_mapping().items() } def C(file): """Make it possible to do comparisons and tests in a OS-independent way""" return _compiled_file_name(file).replace(os.sep, "/") assert mapping == { C(f"{build_lib}/ext3.py"): C("src/ext3.py"), f"{build_lib}/ext3.mp3": "src/ext3.mp3", C(f"{build_lib}/mypkg/ext1.py"): C("src/mypkg/ext1.py"), f"{build_lib}/mypkg/ext1.mp3": "src/mypkg/ext1.mp3", C(f"{build_lib}/mypkg/subpkg/ext2.py"): C("src/mypkg/subpkg/ext2.py"), f"{build_lib}/mypkg/subpkg/ext2.mp3": "src/mypkg/subpkg/ext2.mp3", } # Ensure only the compiled stubs are present not the raw .py stub assert f"{build_lib}/mypkg/ext1.py" not in mapping assert f"{build_lib}/mypkg/subpkg/ext2.py" not in mapping # Visualize what the cached stub files look like example_stub = C(f"{build_lib}/mypkg/ext1.py") assert example_stub in mapping assert example_stub.startswith(f"{build_lib}/mypkg/__pycache__/ext1") assert example_stub.endswith(".pyc") class TestBuildExtInplace: def get_build_ext_cmd(self, optional: bool, **opts) -> build_ext: files: dict[str, str | dict[str, dict[str, str]]] = { "eggs.c": "#include missingheader.h\n", ".build": {"lib": {}, "tmp": {}}, } path.build(files) extension = Extension('spam.eggs', ['eggs.c'], optional=optional) dist = Distribution(dict(ext_modules=[extension])) dist.script_name = 'setup.py' cmd = build_ext(dist) vars(cmd).update(build_lib=".build/lib", build_temp=".build/tmp", **opts) cmd.ensure_finalized() return cmd def get_log_messages(self, caplog, capsys): """ Historically, distutils "logged" by printing to sys.std*. Later versions adopted the logging framework. Grab messages regardless of how they were captured. """ std = capsys.readouterr() return std.out.splitlines() + std.err.splitlines() + caplog.messages def test_optional(self, tmpdir_cwd, caplog, capsys): """ If optional extensions fail to build, setuptools should show the error in the logs but not fail to build """ cmd = self.get_build_ext_cmd(optional=True, inplace=True) cmd.run() assert any( 'build_ext: building extension "spam.eggs" failed' for msg in self.get_log_messages(caplog, capsys) ) # No compile error exception should be raised def test_non_optional(self, tmpdir_cwd): # Non-optional extensions should raise an exception cmd = self.get_build_ext_cmd(optional=False, inplace=True) with pytest.raises(CompileError): cmd.run() def test_build_ext_config_handling(tmpdir_cwd): files = { 'setup.py': DALS( """ from setuptools import Extension, setup setup( name='foo', version='0.0.0', ext_modules=[Extension('foo', ['foo.c'])], ) """ ), 'foo.c': DALS( """ #include "Python.h" #if PY_MAJOR_VERSION >= 3 static struct PyModuleDef moduledef = { PyModuleDef_HEAD_INIT, "foo", NULL, 0, NULL, NULL, NULL, NULL, NULL }; #define INITERROR return NULL PyMODINIT_FUNC PyInit_foo(void) #else #define INITERROR return void initfoo(void) #endif { #if PY_MAJOR_VERSION >= 3 PyObject *module = PyModule_Create(&moduledef); #else PyObject *module = Py_InitModule("extension", NULL); #endif if (module == NULL) INITERROR; #if PY_MAJOR_VERSION >= 3 return module; #endif } """ ), 'setup.cfg': DALS( """ [build] build_base = foo_build """ ), } path.build(files) code, (stdout, stderr) = environment.run_setup_py( cmd=['build'], data_stream=(0, 2), ) assert code == 0, f'\nSTDOUT:\n{stdout}\nSTDERR:\n{stderr}' tests/script-with-bom.py 0000644 00000000022 15030122015 0011267 0 ustar 00 result = 'passed' tests/__pycache__/test_develop.cpython-310.pyc 0000644 00000013115 15030122015 0015302 0 ustar 00 o �h � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m Z ddl m Z ddl mZmZ dZd Zejd d � �Zejd d � �ZG dd� d�ZG dd� d�ZG dd� d�ZdS )z develop tests� N)�paths_on_pythonpath)�develop)� Distribution� )�contexts� namespaceszHfrom setuptools import setup setup(name='foo', packages=['foo'], ) z print "foo" c c s� � t �� �4}t �� �}| �d|� | �d|� d V W d � n1 s$w Y W d � d S W d � d S 1 s<w Y d S )Nzsite.USER_BASEzsite.USER_SITE)r �tempdir�setattr)� monkeypatch� user_base� user_site� r �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_develop.py� temp_user s � ��"�r c c s� � | }|� d�}|d }|�� rtt|���|�d�� }|�t� W d � n1 s+w Y |d }|�d�� }|�t� W d � n1 sIw Y |�� � |V W d � d S 1 saw Y d S )N�foo�setup.py�wz __init__.py) �mkdir�isfile� ValueError�dir�open�write�SETUP_PY�INIT_PY�as_cwd)�tmpdirr �targetr �setup�f�initr r r �test_env& s � � � "�r! c @ sJ e Zd Zeed�Zeed�oejejkZdd� Z e j j dd�dd� �Z d S ) � TestDevelop� real_prefix� base_prefixc C sR t �d� tddgdddgid�}t|�}d|_t|�}|�� ||_|�� dS ) z� Test that console scripts are installed and that they reference only the project by name and not the current version. zTTODO: needs a fixture to cause 'develop' to be invoked without mutating environment.r z0.0�console_scriptszfoocmd = foo:foo)�name�packages�version� entry_pointsr N) �pytest�skip�dictr � script_namer �ensure_finalized� install_dir�run)�selfr �settings�dist�cmdr r r �test_console_scripts: s$ ���� z TestDevelop.test_console_scriptsz0legacy behavior retained for compatibility #4167��reasonc C sN t dd�}t|�}t|�}|�� t�|j�}|jdks J �|jdks%J �d S )NzFoo $$$ Bar_baz-bing)r& z .egg-link�Foo_Bar_baz_bing) r, r r r. �pathlib�Path�egg_link�suffix�stem)r1 r2 r3 r4 �linkr r r �test_egg_link_filenameU s � z"TestDevelop.test_egg_link_filenameN)�__name__� __module__� __qualname__�hasattr�sys� in_virtualenvr$ �prefix�in_venvr5 r* �mark�xfailr? r r r r r" 6 s r" c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � TestResolverz� TODO: These tests were written with a minimal understanding of what _resolve_setup_path is intending to do. Come up with more meaningful cases that look like real-world scenarios. c C s t �ddd�dks J �d S )N�.�r �_resolve_setup_path�r1 r r r �test_resolve_setup_path_cwdi � z(TestResolver.test_resolve_setup_path_cwdc C s t �ddd�dks J �d S )N�pkgsrK �../rL rN r r r � test_resolve_setup_path_one_dirl rP z,TestResolver.test_resolve_setup_path_one_dirc C s t �ddd�dks J �d S )Nzpkgs/rK rQ rR rL rN r r r �.test_resolve_setup_path_one_dir_trailing_slasho rP z;TestResolver.test_resolve_setup_path_one_dir_trailing_slashN)r@ rA rB �__doc__rO rS rT r r r r rJ b s rJ c @ sT e Zd Zedd� �Zejjee j � d��dd�ejje � � dkdd�dd � ��Zd S ) �TestNamespacesc C s� t jdddt|�g}| �� �- tt|�g�� t�|� W d � n1 s&w Y W d � d S W d � d S 1 s>w Y d S )Nr r z --install-dir)rD � executable�strr r � subprocess� check_call)�src_dirr � develop_cmdr r r �install_developt s � ��"�z TestNamespaces.install_develop�APPVEYORz-https://github.com/pypa/setuptools/issues/851r6 �PyPyz.https://github.com/pypa/setuptools/issues/1202c C s� t �|d�}t �|d�}|d }tjdddt|�dt|�g}t�|� | �||� t �|� tjdd g}t t|�g�� t�|� W d � n1 sKw Y tjdd g}t t|�g�� t�|� W d � d S 1 snw Y d S ) a Installing two packages sharing the same namespace, one installed naturally using pip or `--single-version-externally-managed` and the other installed using `develop` should leave the namespace in tact and both packages reachable by import. z myns.pkgAz myns.pkgBr' z-m�pip�installz-tz-cz"import myns.pkgA; import myns.pkgBNzimport pkg_resources) r �build_namespace_packagerD rW rX rY rZ r] � make_site_dirr )r1 r �pkg_A�pkg_Br � install_cmd� try_import�pkg_resources_impr r r �!test_namespace_package_importable� s8 � � �� "�z0TestNamespaces.test_namespace_package_importableN)r@ rA rB � staticmethodr] r* rH �skipif�bool�os�environ�get�platform�python_implementationri r r r r rV s s � �rV )rU rm r9 rp rY rD r* �setuptools._pathr �setuptools.command.developr �setuptools.distr � r r r r �fixturer r! r" rJ rV r r r r �<module> s( , tests/__pycache__/test_shutil_wrapper.cpython-310.pyc 0000644 00000001521 15030122015 0016712 0 ustar 00 o �h� � @ s4 d dl Z d dlZd dlmZ d dlmZ dd� ZdS )� N)�Mock)�_shutilc C s� |d }|� � |�d�}|�� |�tj� tj�d�r dnd}t t j d�}| � t d|� t � |� |j|ks:J �|�� r@J �dS ) z Verify onerr works as expected� with_readonlyzfile.txt�win� r )�wraps�attempt_chmod_verboseN)�mkdir�joinpath�touch�chmod�stat�S_IREAD�sys�platform� startswithr r r �setattr�rmtree� call_count�is_dir)� monkeypatch�tmp_path�tmp_dir� some_file�expected_count�chmod_fn� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_shutil_wrapper.py�test_rmtree_readonly s r )r r � unittest.mockr � setuptoolsr r r r r r �<module> s tests/__pycache__/contexts.cpython-310.pyc 0000644 00000007554 15030122015 0014466 0 ustar 00 o �h� � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZ e j dd� fdd��Z e j dd� �Z e j d d � �Z e j d d � �Z e j d d� �Ze j dd� �Zdd� Ze j dd� �Ze j dd� �Ze j dd� �ZdS )� N)�FileLockc C s d S �N� )�dirr r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/contexts.py�<lambda> s r c k sV � t jdi |��}t�� }z| |� |V W | |� t�|� d S | |� t�|� w )Nr )�tempfile�mkdtemp�os�getcwd�shutil�rmtree)�cd�kwargs�temp_dir�orig_dirr r r �tempdir s �� r c k s� � t dd� | D ��}dd� | �� D �}t|�D ]}tj�|d� | �|� qtj�| � z|V W | D ] }tj�|d� q3tj�|� dS | D ] }tj�|d� qGtj�|� w )zj In a context, patch the environment with replacements. Pass None values to clear the values. c s s( � | ]}|t jv r|t j| fV qd S r )r �environ)�.0�keyr r r � <genexpr> s �& z environment.<locals>.<genexpr>c s s � | ] \}}|d u r|V qd S r r )r r �valuer r r r ! s � N)�dict�items�listr r �pop�update)� replacements�saved�remover r r r � environment s � �r c c s~ � t j} t j}t�� }t _t�� }t _z||fV W |�d� |�d� | t _|t _dS |�d� |�d� | t _|t _w )zk Redirect stdout/stderr to StringIO objects to prevent console output from distutils commands. r N)�sys�stdout�stderr�io�StringIO�seek)� old_stdout� old_stderr� new_stdout� new_stderrr r r �quiet0 s � � r+ c c s$ � t j} z | V W | t _d S | t _w r )�site�ENABLE_USER_SITE)r r r r �save_user_site_settingD s �r. c c sd � dd l } | �� }tjd d � }z||fV W |tjd d �< | �|� d S |tjd d �< | �|� w )Nr )� pkg_resources� __getstate__r! �path� __setstate__)r/ �pr_state�sys_pathr r r �save_pkg_resources_stateM s � � r5 c g s$ � zd V W d S | y Y d S w r r )�excsr r r �suppress_exceptions[ s � �r7 c C s* z | � d�}W |dkS ty Y dS w )zO Return True if running under xdist and multiple workers are used. � worker_idF�master)�getfixturevalue� Exception)�requestr8 r r r � multiprocc s ��r= c c sl � |� � }t| �r |jn|}|| }t|�d��� |jddd� |V W d � dS 1 s/w Y dS )zCUses a file lock to guarantee only one worker can access a temp dirz.lockT)�exist_ok�parentsN)� getbasetempr= �parentr � with_suffix�mkdir)r< �tmp_path_factory�name�base� shared_dir� locked_dirr r r �session_locked_tmp_diro s �"�rI c c sZ � t jdd� t jdd� t jdd� f} zdV W | \t _t _t _dS | \t _t _t _w )zNMake sure ``sys.path``, ``sys.meta_path`` and ``sys.path_hooks`` are preservedN)r! r1 � meta_path� path_hooks)�prevr r r � save_paths} s �(&rM c c s0 � t j} zt j�� t _dV W | t _dS | t _w )z.Make sure initial ``sys.modules`` is preservedN)r! �modules�copy)� prev_modulesr r r �save_sys_modules� s � rQ )� contextlibr$ r r r, r! r �filelockr �contextmanagerr r r+ r. r5 r7 r= rI rM rQ r r r r �<module> s6 tests/__pycache__/test_core_metadata.cpython-310.pyc 0000644 00000036767 15030122015 0016456 0 ustar 00 o �h�Q � @ s( d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ d dl m Z m Z d dl m Z d dlmZ d dlmZ d d lmZ d d lmZ d dlZd dlZd d lmZ d d lm Z d d l m Z m Z d dl m!Z!m"Z" d dl#m$Z$m%Z% d dl&m'Z'm(Z( d dl)m*Z* ddl+m,Z,m-Z- e.ddddddddgd �Z/ej0�1d ej2d dd d �ej2d!dd"d �ej2d#dd$d �ej2d%d&d'd �ej2d(d)d*d �f�d+d,� �Z3d-d.� Z4ej0�1d/e4� �d0d1� �Z5d2d3� Z6ej0�1d/e6� �d4d5� �Z7G d6d7� d7�Z8G d8d9� d9�Z9d:d;� Z:dWd@dA�Z;dXdDdE�Z<dYdJdK�Z=dZdNdO�Z>d[d\dQdR�Z?d]dUdV�Z@dS )^� )� annotationsN)�message_from_string)� Generator)� EmailMessage�Message)�Parser)� EmailPolicy)�cleandoc)�Path)�Mock)�Metadata)� Requirement)�_reqs�sic)� rfc822_escape�rfc822_unescape)�egg_info�write_requirements)�expand�setupcfg)� Distribution� )� retrieve_file�urls_from_file�packagez0.0.1zFoo Barz foo@bar.netzLong descriptionzShort description�one�two)�name�version�author� author_email�long_description� description�keywords��content�resultzJust a single line� single_line)�idz%Multiline Text without extra indents � multilinez,Multiline With additional indentation�multiline_with_indentationz Leading whitespacezLeading whitespace�remove_leading_whitespacez- Leading whitespace In Multiline commentz+Leading whitespace In Multiline comment�#remove_leading_whitespace_multilinec C s |p| t t| ��ks J �d S �N)r r r$ � r. �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_core_metadata.py�test_rfc822_unescape' s r0 c C s� t } t�t| �}d|� fd|dd�fd|g d�d�fd|d d �fd |d d �ftjd|tdd�d�tjjdd�d�d|dd�fd|dd�fd|d d�ftjd |d d gd �tjjd!d�d�d"td d#d$d%�fd&td d#d'd(�fd)td d#d*�fd+td td,�d*�fgS )-NzMetadata version 1.0z,Metadata Version 1.0: Short long descriptionzShort long description)r! z!Metadata version 1.1: Classifiers)z#Programming Language :: Python :: 3z%Programming Language :: Python :: 3.7z&License :: OSI Approved :: MIT License)� classifiersz"Metadata version 1.1: Download URLzhttps://example.com)� download_urlz%Metadata Version 1.2: Requires-Pythonz>=3.7)�python_requiresz!Metadata Version 1.2: Project-Urlzhttps://example.bar)�Foo)� project_urlsz"Issue #1578: project_urls not read)�reason)�marksz3Metadata Version 2.1: Long Description Content Typeztext/x-rst; charset=UTF-8)� long_description_content_type�License�MIT)�licensezLicense multilinez+This is a long license over multiple linesz$Metadata Version 2.1: Provides Extra�foo�bar)�provides_extraszprovides_extras not readzMissing authorz1.0.0zsnorri@sturluson.name)r r r zMissing author e-mailzSnorri Sturluson)r r r zMissing author and e-mail)r r zBypass normalized versionz1.0.0a) �EXAMPLE_BASE_INFO� functools�partial�dict�pytest�param�mark�xfailr )�base�paramsr. r. r/ �__read_test_casesI s� ���� ������������ ��� �� �����rI )r �attrsc C s t |�}|j}|j}t�� }|�|� |�d� |�� }t|�s"J �|�d� |� }|� |� d|j fd|j fd|j fd|j fd|jfd|jfd|jfd |jfd |jfd |jfd |jfd |jfd|jfd|jfddd� fddd� fg}|D ]\} } | |�| |�ks�J �qud S )Nr r r r r �metadata_version�providesr" r! r2 r# � platforms� obsoletes�requiresr1 r5 c S � t | di �S )Nr5 ��getattr��sr. r. r/ �<lambda>� � z$test_read_metadata.<locals>.<lambda>r> c S rP )Nr> rQ rS r. r. r/ rU � rV )r �metadata� __class__�io�StringIO�write_pkg_file�seek�read�_valid_metadata� read_pkg_file�get_name� get_version� get_contact�get_contact_email�get_metadata_version� get_provides�get_description�get_long_description�get_download_url� get_keywords� get_platforms� get_obsoletes� get_requires�get_classifiers) r rJ �dist� metadata_out� dist_class�PKG_INFO�pkg_info� metadata_in� tested_attrs�attr�getterr. r. r/ �test_read_metadata� s> � �rw c C s� dddd�} dd� }d| � � fd|| d d i�fd || d d d ��fd|| ddi�fd|| ddd��fd|| d dd��fd|| d d ddd��fd|| d dd��fd|| d di�fd || dd i�fg S ) Nr z1.0�xxx)r r r" c S s | � � } | �|� | S r- )�copy�update)�d1�d2r. r. r/ � merge_dicts� s z,__maintainer_test_cases.<locals>.merge_dictszNo author, no maintainerz!Author (no e-mail), no maintainerr z Author Namez Author (e-mail), no maintainerzauthor@name.com)r r z!No author, maintainer (no e-mail)� maintainerzMaintainer Namez No author, maintainer (e-mail)zmaintainer@name.com)r~ �maintainer_emailz)Author (no e-mail), Maintainer (no-email))r r~ z$Author (e-mail), Maintainer (e-mail)�r r r~ r z*No author (e-mail), no maintainer (e-mail))r r zAuthor unicodeu 鉄沢寛zMaintainer unicodeu Jan Łukasiewicz)ry )rJ r} r. r. r/ �__maintainer_test_cases� s` � �� ���� ����� ��� �r� c C s ddddd�}t |�}|�d�}t|�}|j�|� tt|�d��dd d �� }|�� }W d � n1 s5w Y t|�s@J �|� � } t t d | d d � ��} t | �} t | �t | �ks]J �|�� D ]*\} } |�| d �}|d u r~| D ] }|�| d �r|J �qqqa| � d |� �}|| v s�J �qad S )N�Authorz Author-email� MaintainerzMaintainer-emailr� rr �PKG-INFO�r�utf-8��encoding����:z: )r �mkdir�strrW �write_pkg_info�open�joinr] r^ � splitlines�list�filter�set�len�items�get� startswith)r rJ �tmpdir� tested_keysrn �fn�fn_s�frr � raw_pkg_lines� pkg_lines� pkg_lines_set�fkey�dkey�val�liner. r. r/ �test_maintainer_author s4 � � ��r� c @ s\ e Zd Zdd� Zdd� Zee�jZed Z e j dge e ��d�dd � �Z e jjd d � �ZdS ) �#TestParityWithMetadataFromPyPaWheelc C s( t di t�dddg d�d���}t|�S )Nz>=3.8a, packaging==23.2 more-itertools==8.8.0; extra == "other" jaraco.text==3.7.0 importlib-resources==5.10.2; python_version<"3.8" importlib-metadata==6.0.0 ; python_version<"3.8" colorama>=0.4.4; sys_platform == "win32" a pytest >= 6 pytest-checkdocs >= 2.4 tomli ; \ # Using stdlib when possible python_version < "3.11" ini2toml[lite]>=0.9 )�testing�other)r3 �install_requires�extras_requirer. )rB r? r )�selfrJ r. r. r/ � base_exampleA s � � �z0TestParityWithMetadataFromPyPaWheel.base_examplec C s> | � � }t|�}t|�sJ �g d�}|D ]}||v s J �qd S )N)zMetadata-Version:zRequires-Python: >=3.8zProvides-Extra: otherzProvides-Extra: testingzDRequires-Dist: tomli; python_version < "3.11" and extra == "testing"z6Requires-Dist: more-itertools==8.8.0; extra == "other"z6Requires-Dist: ini2toml[lite]>=0.9; extra == "testing")r� � _get_pkginfor^ )r� �tmp_pathrn rr �expectedr� r. r. r/ �test_requires_dist] s �z6TestParityWithMetadataFromPyPaWheel.test_requires_distz config/setupcfg_examples.txtN)rH c c s� � |� |� |�tdtdd�� |�tdtdd�� |�tdtdd�� |jdu r0| �� V dS t|j�}t� ti �|�V dS )z4Example of distribution with arbitrary configuration� read_attrz0.42)� return_value� read_files� hello world�_finalize_license_filesN) �chdir�setattrr r r rD r� r r �apply_configuration)r� �request� monkeypatchr� �configr. r. r/ rn r s � � z(TestParityWithMetadataFromPyPaWheel.distc C s� t �d�}t|dd�}|du rt�d� t|�}|d }|jdd� |d j|d d � tt |�||d � |||d �}t |�}t |�} t | �} || ksNJ �t |� dS ) zHEnsure output from setuptools is equivalent to the one from `pypa/wheel`zwheel.metadata�pkginfo_to_metadataNzjwheel.metadata.pkginfo_to_metadata is undefined, (this is likely to be caused by API changes in pypa/wheelz pkg.egg-infoT)�parentsr� r� r� z requires.txt) � importlib� import_modulerR rC rF r� r� � write_textr r �_normalize_metadatar �_assert_roundtrip_message) r� r� rn �wheel_metadatar� rr � egg_info_dir� metadata_msg� metadata_str� pkg_info_msg� pkg_info_strr. r. r/ �test_equivalent_output� s" � z:TestParityWithMetadataFromPyPaWheel.test_equivalent_output)�__name__� __module__� __qualname__r� r� r �__file__�parent�HERE� EXAMPLES_FILErC �fixturer rn rE � uses_networkr� r. r. r. r/ r� @ s r� c @ s� e Zd Zed�ed�d�Zej�de�� �dd� �Z ej�de�� �ej�ddd id d id d d dgfidddgfiddddgfd�g�dd� ��Z ej�dddg�d d � �Z d S ) � TestPEP643a� [metadata] name = package version = 0.0.1 author = Foo Bar author_email = foo@bar.net long_description = Long description description = Short description keywords = one, two platforms = abcd [options] install_requires = requests a [project] name = "package" version = "0.0.1" authors = [ {name = "Foo Bar", email = "foo@bar.net"} ] description = "Short description" readme = {text = "Long\ndescription", content-type = "text/plain"} keywords = ["one", "two"] dependencies = ["requests"] license = "AGPL-3.0-or-later" [tool.setuptools] provides = ["abcd"] obsoletes = ["abcd"] )z setup.cfg�pyproject.toml�filec C sF t |�j| j| dd� t� }|�d�d u sJ �|�d�d u s!J �d S )Nr� r� �Dynamic�dynamic)r r� � STATIC_CONFIG� _get_metadata�get_all)r� r� � tmpdir_cwdrW r. r. r/ �!test_static_config_has_no_dynamic� s z,TestPEP643.test_static_config_has_no_dynamic�fieldszrequires-python)r3 z>=3.12z author-email)r zsnoopy@peanuts.comr# �hello�world�platformrM �abcd)r" r� )r! zbla bla bla blar� z hello-world)�summaryr" z requires-distc C sp t |�j| j| dd� t� }|�� D ]\}}t|||� t|j||� qt|�}t|� d��t|�ks6J �d S )Nr� r� r� ) r r� r� � _makedist�valuesr� rW r� r� r� )r� r� r� r� rn ru �valuerW r. r. r/ �&test_modified_fields_marked_as_dynamic� s z1TestPEP643.test_modified_fields_marked_as_dynamic� extra_tomlz'# Let setuptools autofill license-filesz2license-files = ['LICENSE*', 'AUTHORS*', 'NOTICE']c C s� | j d �dd|� ��dddd�}||d v sJ �d|vs J �tj�|� tdd �}t|�}t|�d ��d d hks;J �|� d �dksDJ �t|�d��h d�ksQJ �d S )Nr� z license = "AGPL-3.0-or-later"zdynamic = ['license'] z--- mock license ---z--- mock notice ---z --- me ---)r� � LICENSE.md�NOTICE� AUTHORS.txtzAGPL-3.0-or-later)�license_expressionr� z license-filezlicense-expressionzLicense-Expressionz License-File> r� r� r� ) r� �replace�jaraco�path�buildr� r� r� r� r� )r� r� r� �filesrn rW r. r. r/ �test_license_files_dynamic� s& �� � z%TestPEP643.test_license_files_dynamicN) r� r� r� r r� rC rE � parametrize�keysr� r� r� r. r. r. r/ r� � s> ���% ��� ��r� c K s t | �}|�� |S r- )r �parse_config_files)rJ rn r. r. r/ r� s r� rW r� �return�Nonec C s� t �| ��}tt��|�}W d � n1 sw Y tdddd�}t �� � }t j|dd�}t||d�� |� |� � |� � }W d � n1 sJw Y t | d�}d � |�� �}d � |�� �}||kshJ �dS ) z�Emulate the way wheel.bdist_wheel parses and regenerates the message, then ensures the metadata generated by setuptools is compatible. NTFr )�utf8� mangle_from_�max_line_lengthr� r� )�policy� )rY rZ r r �parser �BytesIO� TextIOWrapperr �flatten�flush�getvalue�bytesr� r� )rW �buffer�msg�serialization_policy�out� regenerated� raw_metadatar. r. r/ r� ! s$ �� � r� r r c s| dd� | � dg �D �� � fdd�t�| � dg ��D �}| d= | d= t|�D ]}|| d< q%t� �D ]}|| d< q0| d= | �� S )z1Allow equivalent metadata to be compared directlyc S s i | ] }|� d d�|�qS )�_�-)r� )�.0�xr. r. r/ � <dictcomp>F s z'_normalize_metadata.<locals>.<dictcomp>zProvides-Extrac s g | ]}t |� ��qS r. )�_normalize_req)r �req��extrasr. r/ � <listcomp>G s ��z'_normalize_metadata.<locals>.<listcomp>z Requires-DistzMetadata-Version)r� r r� �sorted� as_string)r �reqsr �extrar. r r/ r� : s � r� r r r �dict[str, str]c C s> t | ��| j| j�dd��}|�� D ] \}}|�||�}q|S )z<Allow equivalent requirement objects to be compared directlyr r )r� r� r r� )r r �as_str�norm�origr. r. r/ r Z s r rn r c C s@ t �� �}| j�|� |�� W d � S 1 sw Y d S r- )rY rZ rW r[ r )rn �fpr. r. r/ r� b s $�r� �Distribution | Nonec C s t t| pt� ��S r- )r r� r� )rn r. r. r/ r� h s r� �text�boolc C s t j| dd�}|d uS )NT)�validate)r � from_email)r rW r. r. r/ r^ l s r^ )rW r� r� r� )r r r� r� )r r r r r� r� )rn r r- )rn r )r r� r� r )A� __future__r r@ r� rY �emailr �email.generatorr � email.messager r � email.parserr � email.policyr �inspectr �pathlibr � unittest.mockr � jaraco.pathr� rC �packaging.metadatar �packaging.requirementsr � setuptoolsr r �setuptools._core_metadatar r �setuptools.command.egg_infor r �setuptools.configr r �setuptools.distr �config.downloadsr r rB r? rE r� rD r0 rI rw r� r� r� r� r� r� r� r r� r� r^ r. r. r. r/ �<module> s� � ������� b (D 'cx tests/__pycache__/test_install_scripts.cpython-310.pyc 0000644 00000007135 15030122015 0017066 0 ustar 00 o �hi � @ sJ d Z ddlZddlZddlmZ ddlmZ ddlmZ G dd� d�Z dS ) zinstall_scripts tests� N)�install_scripts)� Distribution� )�contextsc @ s� e Zd Zedddgidd�ZdZdZdZdd d �Ze j j e j d kd d�dd� �Ze j j e j d kdd�dd� �Ze j j e j d kd d�dd� �Ze j j e j d kdd�dd� �Zd S )�TestInstallScripts�foo�console_scriptsz foo=foo:fooz0.0)�name� entry_points�versionz%/usr/dummy-test-path/local/bin/pythonz /usr/bin/env dummy-test-pythonz6C:\Dummy Test Path\Program Files\Python 3.6\python.exeNc C st t | j�}d|_t|�}||_|d ur|�d�}||_|�� t� � � |� � W d � d S 1 s3w Y d S )Nzsetup.py� build_scripts) r �settings� script_namer � install_dir�get_finalized_command� executable�ensure_finalizedr �quiet�run)�selfr r �dist�cmd�bs� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_install_scripts.py�_run_install_scripts s "�z'TestInstallScripts._run_install_scripts�win32znon-Windows only)�reasonc C � d| j � d�}|�d| j � |�� �/ | �t|�� tt|�d��ddd�� }|�� }W d � n1 s5w Y W d � n1 sDw Y ||ksOJ �dS ) zt Ensure that shebang is not quoted on Unix when getting the Python exe from sys.executable. �#!� �sys.executabler �r�utf-8��encodingN)�unix_exe�setattr�as_cwdr �str�open�join�readline�r �tmpdir� monkeypatch�expected�f�actualr r r �!test_sys_executable_escaping_unix# � �� �z4TestInstallScripts.test_sys_executable_escaping_unixz Windows onlyc C r ) z� Ensure that shebang is quoted on Windows when getting the Python exe from sys.executable and it contains a space. �#!"�" r! � foo-script.pyr" r# r$ N)� win32_exer' r( r r) r* r+ r, r- r r r �"test_sys_executable_escaping_win321 r4 z5TestInstallScripts.test_sys_executable_escaping_win32c C s� d| j � d�}|�� �1 | �t|�| j � tt|�d��ddd�� }|�� }W d � n1 s0w Y W d � n1 s?w Y ||ksJJ �dS )z� Ensure that shebang on Unix is not quoted, even when a value with spaces is specified using --executable. r r r r" r# r$ N)�unix_spaces_exer( r r) r* r+ r, �r r. r0 r1 r2 r r r �)test_executable_with_spaces_escaping_unix? s �� �z<TestInstallScripts.test_executable_with_spaces_escaping_unixc C s� d| j � d�}|�� �5 | �t|�d| j d � tt|�d��ddd�� }|�� }W d � n1 s4w Y W d � n1 sCw Y ||ksNJ �dS ) z� Ensure that shebang on Windows is quoted when getting a path with spaces from --executable, that is itself properly quoted. r5 r6 �"r7 r" r# r$ N)r8 r( r r) r* r+ r, r; r r r �"test_executable_arg_escaping_win32M s �� �z5TestInstallScripts.test_executable_arg_escaping_win32)N)�__name__� __module__� __qualname__�dictr r& r: r8 r �pytest�mark�skipif�sys�platformr3 r9 r< r> r r r r r s$ � r ) �__doc__rF rC �"setuptools.command.install_scriptsr �setuptools.distr � r r r r r r �<module> s tests/__pycache__/fixtures.cpython-310.pyc 0000644 00000010043 15030122015 0014453 0 ustar 00 o �hM � @ s� d dl Z d dlZd dlZd dlZd dlmZ d dlZd dlZddlm Z m Z ej dd� �Z ej dd� �Z ej d d d �d d � �Zej dd� �Zdd� Zej d d�dd� �Zej d d�dd� �Zej dd� �Zej dd� �Zej dd � �ZdS ) � N)�Path� )�contexts� environmentc c s� � t �� �H}| �d|� t �� �%}| �d|� t �� � dV W d � n1 s)w Y W d � n1 s8w Y W d � dS W d � dS 1 sPw Y dS )za Override site.USER_BASE and site.USER_SITE with temporary directories in a context. zsite.USER_BASEzsite.USER_SITEN)r �tempdir�setattr�save_user_site_setting)� monkeypatch� user_base� user_site� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/fixtures.py� user_override s � �� ��"�r c c s6 � | � � � }|V W d � d S 1 sw Y d S )N)�as_cwd)�tmpdir�origr r r � tmpdir_cwd s � "�r T�session)�autouse�scopec C sN | j j�d�s dS t�t�� tj�d� W d � dS 1 s w Y dS )z� Workaround pytest-dev/pytest-xdist#376 ``pytest-xdist`` tends to inject '' into ``sys.path``, which may break certain isolation expectations. Remove the entry so the import machinery behaves the same irrespective of xdist. �xdistN� ) �config� pluginmanager� has_plugin� contextlib�suppress� ValueError�sys�path�remove)�requestr r r �workaround_xdist_376! s "�r" c C sH g d�}zt j|t| �d� W | d S ty# t�d� Y | d S w )z< Clone the 'sampleproject' and return a path to it. )�git�clonez%https://github.com/pypa/sampleproject)�cwdz Unable to clone sampleproject� sampleproject)� subprocess� check_call�str� Exception�pytest�skip)�tmp_path�cmdr r r �sample_project2 s � �r/ c C s� t �|| d��]}t|�d�d �}t|�d�d �}|r'|r'||fW d � S t|jjd��� r2J �t� t j dddt |�t |jj�g� t|jjd��� rOJ �t|�d��t|�d��fW d � S 1 sgw Y d S )N� dist_buildz*.tar.gzz*.whlzbuild/lib/buildz-m�buildz--outdir) r �session_locked_tmp_dir�next�globr r �rootdir�existsr' � check_outputr � executabler) )�tmp_path_factoryr! �tmp�sdist�wheelr r r �_build_distributionsG s* �� � $�r= )r c C s8 t �d�}|rt j�|�rt|��� S t| |�\}}|S )N�PRE_BUILT_SETUPTOOLS_SDIST��os�getenvr r6 r �resolver= )r9 r! �prebuiltr; �_r r r �setuptools_sdistb � rE c C s8 t �d�}|rt j�|�rt|��� S t| |�\}}|S )N�PRE_BUILT_SETUPTOOLS_WHEELr? )r9 r! rC rD r< r r r �setuptools_wheell rF rH c C sd t �� }t�| d �|_ddg|_t|�|_tj dd�� |� � W d � S 1 s+w Y dS )z?Virtual env with the version of setuptools under test installed�venv�--no-setuptoolsz--wheel=bundleN)� PYTHONPATH) r � VirtualEnvr r �root� create_optsr) �reqr �create)r- rH �envr r r rI v s $�rI c C s. t �� }t�| d �|_ddg|_|�� |S )z7Virtual env without any version of setuptools installed�venv_without_setuptoolsrJ � --no-wheel�r rL r r rM rN � ensure_env�r- rQ r r r rR � � rR c C s. t �� }t�| d �|_g d�|_|�� |S )z1Virtual env without any common packages installed� bare_venv)rJ z--no-piprS z --no-seedrT rV r r r rX � rW rX )r r@ r' r �pathlibr r r+ r r r �fixturer r r" r/ r= rE rH rI rR rX r r r r �<module> s6 tests/__pycache__/test_egg_info.cpython-310.pyc 0000644 00000074572 15030122015 0015437 0 ustar 00 o �hB� � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z d dl m Z d dl Z d dlmZ d dlmZ d dlmZmZmZ d dlmZ d d lmZmZ d d lm Z G d d � d e �Z e j dd� �Z G dd� d�Z!G dd� d�Z"dS )� )� annotationsN)�Path)�mock)�path)�errors)�egg_info�manifest_maker� write_entries)� Distribution� )�contexts� environment)�DALSc @ s e Zd ZdS )� EnvironmentN)�__name__� __module__� __qualname__� r r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_egg_info.pyr s r c # s� � t jdd��E� t� �} t�� tj� d}t� fdd�|D ��| _t t tj | j� � �� t �| jd dtdjd i | j���ii� | V W d � d S 1 sOw Y d S ) Nzsetuptools-test.)�prefix)�home�lib�scripts�datazegg-basec 3 s" � | ] }|t j�� |�fV qd S )N)�osr �join)�.0�dirname��env_dirr r � <genexpr>" s � zenv.<locals>.<genexpr>r z.pydistutils.cfgzR [egg_info] egg-base = {egg-base} r )r �tempdirr r �chmod�stat�S_IRWXU�dict�paths�list�map�mkdir�valuesr �buildr �format)�env�subsr r r r- s( ������ "�r- c @ sX e Zd Zed�Zdd� Zed�dd ��Zd d � Zed d � �Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zd�dd �Zd ejd � d �Zd ejd � d!�Zd"ZG d#d$� d$�Zejd%d&d'd(d)d*d+d,d-d.d/eeed0�d1d2� �Zd3d4� Zd5d6� Zd7d8� Zd9d:� Z d;d<� Z e j �d=ed>�d?d@�dAfedB�d?d@�dfedC�d?d@�dAfed>�dDd?dE�dAfe j edF�d?d@�dAdGdH�g�dIdJ� �Z!e j �dKedL�dMdNdO�dPdQgg fedR�dMdNdO�dPdQgg fedS�dMdNdO�dPgdQgfedT�dMdNdO�g dPdQgfedU�dMdNdO�dQgdPgfedV�d?dW�dPgdXgfedC�d?d@�dYgg fedZ�dDd?dE�dYgg fedL�d[dMdNd\�dPdQgg fe j d]dMd^d_d`dNdadbdc�g dd�degdfdH�e j edg�dMdhdi�dPgdjgdkdH�e j edl�dMdW�dPgg dmdH�e j edn�dMdodYdpidq�dYdrgdsgdtdH�g �dudv� �Z"e j �dKedw�dMdNdO�g dPdQgfedx�dMdNdO�g dPdQgfedy�dMdzdNd{�g d|�g fed}�dMdzdNd{�g d|�g fed~�dMdzdNd{�dPdQgdgfedy�d?d��dgdPdQgfed��d�dMdzdNd��g d|�g fe j ed��dMdhdi�dPgdjgdkdH�e j ed��dMd_d`d��dPd�gd�gd�dH�g �d�d�� �Z#d�d�� Z$d�d�� Z%d�d�� Z&d�d�� Z'd�d�� Z(d�d�� Z)d�d�� Z*d�d�� Z+d�d�� Z,d�d�� Z-d�d�d��Z.d�d�� Z/d�S )�� TestEggInfoz� from setuptools import setup setup( name='foo', py_modules=['hello'], entry_points={'console_scripts': ['hi = hello.run']}, zip_safe=False, ) c C s t �| jtd�d�� d S )NzO def run(): print('hello') )�setup.pyzhello.py)r r+ � setup_scriptr )�selfr r r �_create_project? s � �zTestEggInfo._create_project�pkg_info_lines� list[str]�return�tuple[int, int]c C s6 | d � d�d }tt|� d�d d� �\}}||fS )Nr � r �.� )�splitr( �int)r4 � version_str�major�minorr r r �_extract_mv_versionJ s z TestEggInfo._extract_mv_versionc C s� t j�|jd d�}t� }t|�}|�� |�|� t|ddd�� }|� � }W d � n1 s0w Y d|v s;J �d|v sAJ �d |v sGJ �d }| � ||� dS ) z� When the egg_info section is empty or not present, running save_version_info should add the settings to the setup.cfg in a deterministic order. r � setup.cfg�r�utf-8��encodingN� [egg_info]� tag_build =� tag_date = 0�� tag_build�tag_date) r r r r& r r �initialize_options�save_version_info�open�read�_validate_content_order� r2 � tmpdir_cwdr- � setup_cfg�dist�ei�f�content�expected_orderr r r �+test_egg_info_save_version_info_setup_emptyP s � z7TestEggInfo.test_egg_info_save_version_info_setup_emptyc C s, d� |�}tjtjB }t�|| |�sJ �dS )zY Assert that the strings in expected appear in content in order. z.*N)r �re� MULTILINE�DOTALL�search)rW �expected�pattern�flagsr r r rP j s z#TestEggInfo._validate_content_orderc C s� t j�|jd d�}t�|td�i� t� }t|�}|�� |� |� t |ddd�� }|� � }W d � n1 s9w Y d|v sDJ �d |v sJJ �d |v sPJ �d }| � ||� dS ) z� When running save_version_info on an existing setup.cfg with the 'default' values present from a previous run, the file should remain unchanged. r rA zU [egg_info] tag_build = tag_date = 0 rB rC rD NrF rG rH rI ) r r r r& r+ r r r rL rM rN rO rP rQ r r r �.test_egg_info_save_version_info_setup_defaultst s$ �� � z:TestEggInfo.test_egg_info_save_version_info_setup_defaultsc C s: | � � | �||� t�d�}g d�}t|�|ksJ �d S )N� foo.egg-info)�PKG-INFO� SOURCES.txtzdependency_links.txt�entry_points.txtz not-zip-safez top_level.txt)r3 �_run_egg_info_commandr �listdir�sorted)r2 rR r- �actualr^ r r r � test_expected_files_produced� s z(TestEggInfo.test_expected_files_producedc C s� t � }t|�}tjdtd�d�}tjdd d�}|�F |�+ dd l}d}tj|jj |d�� |� � W d � n1 s;w Y W d � n1 sJw Y W d � d S W d � d S 1 sbw Y d S ) Nzos.utime�TEST)� side_effectz+setuptools.command.egg_info.egg_info.mkpath)� return_valr z,Cannot update time stamp of directory 'None'��match) r r r �patch�OSError�distutils.errors�pytest�raisesr �DistutilsFileError�run) r2 rR r- rT rU � utime_patch� mkpath_patch� distutils�msgr r r �test_handling_utime_error� s � ��P�z%TestEggInfo.test_handling_utime_errorc C sn t d�}t d�}t�||d�� t�t��}| �||� W d � n1 s&w Y d|jjd v s5J �d S )Nzp [metadata] name=foo version=0.0.1 license=file:MIT zK from setuptools import setup setup() �r0 rA � ValueErrorr ) r r r+ rs rt �AssertionErrorrf �value�args)r2 rR r- � setup_configr1 �excr r r �test_license_is_a_string� s � �� �z$TestEggInfo.test_license_is_a_stringc C sR | � � | �||� tj�d�}t�d� | �||� tj�d�}||ks'J �dS )z9Ensure timestamps are updated when the command is re-run.rb g����MbP?N)r3 rf r r �getmtime�time�sleep)r2 rR r- � timestamp_a� timestamp_br r r � test_rebuilt� s zTestEggInfo.test_rebuiltc C s� | � � t�td�ddid�� | �||� tj�dd�}tj�|d�}t|dd ��}d |�� � d �v s6J �W d � d S 1 sAw Y d S ) Nz: recursive-include docs *.rst z usage.rstzRun 'hi')� MANIFEST.in�docsr9 rb rd rC rD zdocs/usage.rst� � r3 r r+ r rf r r rN rO r; )r2 rR r- � egg_info_dir� sources_txtrV r r r � test_manifest_template_is_read� s ��� "�z*TestEggInfo.test_manifest_template_is_readFc C s4 t d�|rdn| }|r|nd}t�||d�� d S )Nzi from setuptools import setup setup(name='foo', zip_safe=False, %s) � r| )r r r+ )r2 �requires� use_setup_cfgr1 r� r r r �_setup_script_with_requires� s � � �z'TestEggInfo._setup_script_with_requireszpython_version<'r �'zpython_version < "�"z<=>++c @ s e Zd Zedd� �ZdS )z TestEggInfo.RequiresTestHelperc s� g }g }| D ]m}|� � �dd�}|�d��d�}t|�dkr*|d �� }t�|�}ni }|d �� } � fdd�|D �\} } } | | df| d | d ffD ](\} }}|�| � d }|�d �re|d d � }t j j }|�t j ||| ||d�� qJqt j j d||d�S )Nz � r r� r c s g | ] }t |�jd i � ���qS )r )r r, )r �a�� format_dictr r � <listcomp> s �z>TestEggInfo.RequiresTestHelper.parametrize.<locals>.<listcomp>F� _in_setup_cfgTr z@xfail � )�marks)r� r� �expected_requires�install_cmd_kwargs)�ids)�lstripr; �pop�len�strip�ast� literal_eval�append� startswithrs �mark�xfail�param� parametrize)� test_listr� �idlist� argvalues�test� test_params� name_kwargs�valr� �name�setup_py_requires�setup_cfg_requiresr� �id_r� �use_cfgr� r r� r r� sH � � ����z*TestEggInfo.RequiresTestHelper.parametrizeN)r r r � staticmethodr� r r r r �RequiresTestHelper s r� z� install_requires_deterministic install_requires=["wheel>=0.5", "pytest"] [options] install_requires = wheel>=0.5 pytest wheel>=0.5 pytest z� install_requires_ordered install_requires=["pytest>=3.0.2,!=10.9999"] [options] install_requires = pytest>=3.0.2,!=10.9999 pytest!=10.9999,>=3.0.2 z� install_requires_with_marker install_requires=["barbazquux;{mismatch_marker}"], [options] install_requires = barbazquux; {mismatch_marker} [:{mismatch_marker_alternate}] barbazquux z� install_requires_with_extra {'cmd': ['egg_info']} install_requires=["barbazquux [test]"], [options] install_requires = barbazquux [test] barbazquux[test] a install_requires_with_extra_and_marker install_requires=["barbazquux [test]; {mismatch_marker}"], [options] install_requires = barbazquux [test]; {mismatch_marker} [:{mismatch_marker_alternate}] barbazquux[test] z� setup_requires_with_markers setup_requires=["barbazquux;{mismatch_marker}"], [options] setup_requires = barbazquux; {mismatch_marker} z� extras_require_with_extra {'cmd': ['egg_info']} extras_require={{"extra": ["barbazquux [test]"]}}, [options.extras_require] extra = barbazquux [test] [extra] barbazquux[test] aF extras_require_with_extra_and_marker_in_req extras_require={{"extra": ["barbazquux [test]; {mismatch_marker}"]}}, [options.extras_require] extra = barbazquux [test]; {mismatch_marker} [extra] [extra:{mismatch_marker_alternate}] barbazquux[test] z� extras_require_with_marker extras_require={{":{mismatch_marker}": ["barbazquux"]}}, @xfail [options.extras_require] :{mismatch_marker} = barbazquux [:{mismatch_marker}] barbazquux a( extras_require_with_marker_in_req extras_require={{"extra": ["barbazquux; {mismatch_marker}"]}}, [options.extras_require] extra = barbazquux; {mismatch_marker} [extra] [extra:{mismatch_marker_alternate}] barbazquux z� extras_require_with_empty_section extras_require={{"empty": []}}, [options.extras_require] empty = [empty] )�invalid_marker�mismatch_marker�mismatch_marker_alternatec C s� | � ||� | j||fi |�� tj�dd�}tj�|d�}tj�|�r?t|dd�� } | �� } W d � n1 s9w Y nd} | �� |ksIJ �t � tj�|j d d��g ksZJ �d S ) Nr9 rb z requires.txtrC rD r� r � barbazquux*) r� rf r r r �existsrN rO r� �globr& ) r2 rR r- r� r� r� r� r� � requires_txt�fp�install_requiresr r r � test_requires9 s ��&zTestEggInfo.test_requiresc C sJ d}| � |� t�t�� | �||� W d � dS 1 s w Y dS )z� Packages that pass unordered install_requires sequences should be rejected as they produce non-deterministic builds. See #458. z0install_requires={"fake-factory==0.5.2", "pytz"}N)r� rs rt r~ rf )r2 rR r- �reqr r r �*test_install_requires_unordered_disallowed� s "�z6TestEggInfo.test_install_requires_unordered_disallowedc C �x d}|j | jd�}| �|� t�t�� | �||� W d � n1 s$w Y t�tj � |j d d��g ks:J �d S )Nz/extras_require={{":{marker}": ["barbazquux"]}},��markerr r� � r, r� r� rs rt r~ rf r� r r r r& �r2 rR r- �tmplr� r r r �'test_extras_require_with_invalid_marker� � �&z3TestEggInfo.test_extras_require_with_invalid_markerc C r� )Nz5extras_require={{"extra": ["barbazquux; {marker}"]}},r� r r� r� r� r r r �.test_extras_require_with_invalid_marker_in_req� r� z:TestEggInfo.test_extras_require_with_invalid_marker_in_reqc C s� | � d� tj�� j|jd d�}tjdgtj� |jd t |�g�d|d� tj � dd �}t tj � |d �d d ��}|� � �d �}W d � n1 sJw Y d|v sUJ �d|v s[J �d S )Nz*extras_require={"foobar": ["barbazquux"]},r ��HOMEr r r ��cmd�pypath� data_streamr- r9 rb rc rC rD r� zProvides-Extra: foobar�Metadata-Version: 2.4�r� r �environ�copy�updater& r � run_setup_py�pathsepr �strr rN rO r; �r2 rR r- r� r� r� r4 r r r �test_provides_extra� s �� � z TestEggInfo.test_provides_extrac C s� | � d� tj�� j|jd d�}tjdgtj� |jd t |�g�d|d� tj � dd �}t tj � |d �d d �� }|� � }W d � n1 sGw Y d |vsRJ �d S )Nz0install_requires=["spam ; python_version<'3.6'"]r r� r r r r� r9 rb rc rC rD zProvides-Extra:)r� r r� r� r� r& r r� r� r r� r rN rO )r2 rR r- r� r� r� � pkg_info_textr r r �test_doesnt_provides_extra s" � �� �z&TestEggInfo.test_doesnt_provides_extra)�files�license_in_sourcesz} [metadata] license_file = LICENSE z Test license)rA �LICENSETz� [metadata] license_file = INVALID_LICENSE z zexclude LICENSE)rA r� r� z� [metadata] license_file = LICEN[CS]E* � glob_pattern)�idc C s� | � � t�|� tjdgtj�|jd t |�g�d� tj�dd�}t |d�j dd�}|r6d |v s4J �d S d |vs<J �d |vsBJ �d S ) Nr r �r� r� r9 rb rd rC rD r� �INVALID_LICENSE) r3 r r+ r r� r r� r r& r� r � read_text)r2 rR r- r� r� r� � sources_textr r r �test_setup_cfg_license_file! s B � z'TestEggInfo.test_setup_cfg_license_file)r� � incl_licenses� excl_licensesz� [metadata] license_files = LICENSE-ABC LICENSE-XYZ � ABC license� XYZ license)rA � LICENSE-ABC� LICENSE-XYZr� r� z� [metadata] license_files = LICENSE-ABC, LICENSE-XYZ z� [metadata] license_files = LICENSE-ABC zv [metadata] license_files = z� [metadata] license_files = LICENSE-XYZ z� [metadata] license_files = LICENSE-ABC INVALID_LICENSE )rA r� r� r� z~ [metadata] license_files = LICENSE zexclude LICENSE-XYZ)rA r� r� r� r� z ABC copyingz ABC noticez ABC authors�LicensezInvalid license)rA r� � COPYING-ABC� NOTICE-ABC� AUTHORS-ABC� LICENCE-XYZr� �INVALID-LICENSE)r� r� r� r� r� r� r� �default_glob_patternsz� [metadata] license_files = LICENSE* z XYZ notice)rA r� � NOTICE-XYZr� �no_default_glob_patternsz� [metadata] license_files = LICENSE-ABC LICENSE* �files_only_added_oncez� [metadata] license_files = **/LICENSE z Don't include�Vendor license)rA r� � LICENSE-OTHER�vendorzvendor/LICENSEr� �recursive_globc C � | � � t�|� tjdgtj�|jd t |�g�d� tj�dd�}t |d�j dd�}d d � |� � D �}|D ] } |� | �d ksBJ �q7|D ] } |� | �d ksPJ �qEd S ) Nr r r� r9 rb rd rC rD c S � g | ]}|� � �qS r �r� �r �liner r r r� Q � z<TestEggInfo.test_setup_cfg_license_files.<locals>.<listcomp>r r �r3 r r+ r r� r r� r r& r� r r� � splitlines�count� r2 rR r- r� r� r� r� r� � sources_lines�lfr r r � test_setup_cfg_license_filesu s S ��z(TestEggInfo.test_setup_cfg_license_filesz� [metadata] license_file = license_files = z� [metadata] license_file = LICENSE-ABC LICENSE-XYZ a [metadata] license_file = LICENSE-ABC license_files = LICENSE-XYZ LICENSE-PQR z PQR license)rA r� � LICENSE-PQRr� )r� r r� a9 [metadata] license_file = LICENSE-ABC license_files = LICENSE-ABC LICENSE-XYZ LICENSE-PQR z� [metadata] license_file = LICENSE-ABC license_files = LICENSE-XYZ r )rA r a [metadata] license_file = LICENSE-ABC license_files = LICENSE-PQR LICENSE-XYZ z'exclude LICENSE-ABC exclude LICENSE-PQR)rA r� r� r r� z~ [metadata] license_file = LICENSE* z� [metadata] license_file = LICENSE* license_files = NOTICE* )rA r� r� r� r� r� �combined_glob_patterrnsc C r ) Nr r r� r9 rb rd rC rD c S r r r r r r r r� r zITestEggInfo.test_setup_cfg_license_file_license_files.<locals>.<listcomp>r r r r r r r �)test_setup_cfg_license_file_license_filesY s ' ��z5TestEggInfo.test_setup_cfg_license_file_license_filesc C s | � � t�td�ddddddid�� tjd gtj�|j d t |�g�d � tj�d d �}t tj�|d�dd��}|� � � d�}W d � n1 sKw Y dd� |D �}t|�dks_J �d|d ksgJ �d|dd� v sqJ �d|dd� v s{J �d|d v s�J �dS ) zCAll matched license files should have a corresponding License-File.z� [metadata] license_files = NOTICE* LICENSE* **/LICENSE r� r� �includedz not includer� r� )rA r� r� �NOTICE�IGNOREr� r r r� r9 rb rc rC rD r� Nc S s g | ] }|� d �r|�qS )z License-File:)r� r r r r r� , s ��z?TestEggInfo.test_license_file_attr_pkg_info.<locals>.<listcomp>� zLicense-File: NOTICEr zLicense-File: LICENSE-ABCr zLicense-File: LICENSE-XYZz License-File: vendor/LICENSEr� )r3 r r+ r r r� r r� r r& r� rN rO r; r� )r2 rR r- r� r� r4 �license_file_linesr r r � test_license_file_attr_pkg_info s6 � �� ��z+TestEggInfo.test_license_file_attr_pkg_infoc C s� | � d� tjdgtj�|jd t|�g�dd� tj�dd�}t tj�|d�d d ��}|� � � d �}W d � n1 s=w Y | � |�d ksKJ �d S )z5Make sure latest metadata version is used by default.r� r r r �r� r� r� r9 rb rc rC rD r� N)r: r ) r� r r� r r� r r& r� r rN rO r; r@ �r2 rR r- r� r� r4 r r r �test_metadata_version8 s � �z!TestEggInfo.test_metadata_versionc C s� | � d� tj�� j|jd d�}tjdgtj� |jd t |�g�d|d� tj � dd �}t tj � |d �d d ��}|� � �d �}W d � n1 sJw Y d}||v sWJ �d|v s]J �d S )Nz.long_description_content_type='text/markdown',r r� r r r r� r9 rb rc rC rD r� z'Description-Content-Type: text/markdownr� r� �r2 rR r- r� r� r� r4 � expected_liner r r �"test_long_description_content_typeF s& � �� � z.TestEggInfo.test_long_description_content_typec C s� | � d� tjdgtj�|jd t|�g�dd� tj�dd�}t tj�|d�d d ��}|� � � d �}W d � n1 s=w Y d |v sHJ �d |d ksPJ �||� d �d � }d|v s_J �d|v seJ �d S )Nzqlong_description='This is a long description\nover multiple lines',long_description_content_type='text/markdown',r r r r r9 rb rc rC rD r� r� r� ���zThis is a long descriptionzover multiple lines) r� r r� r r� r r& r� r rN rO r; �index)r2 rR r- r� r� r4 �long_desc_linesr r r �test_long_descriptiona s" �� � z!TestEggInfo.test_long_descriptionc C s� | � d� tj�� j|jd d�}tjdgtj� |jd t |�g�d|d� tj � dd �}t tj � |d �d d ��}|� � �d �}W d � n1 sJw Y d}||v sWJ �d}||v s_J �| �|�dkshJ �d S )Nz�project_urls={ 'Link One': 'https://example.com/one/', 'Link Two': 'https://example.com/two/', },r r� r r r r� r9 rb rc rC rD r� z/Project-URL: Link One, https://example.com/one/z/Project-URL: Link Two, https://example.com/two/�r r: �r� r r� r� r� r& r r� r� r r� r rN rO r; r@ r r r r �test_project_urlsx s* � �� � z TestEggInfo.test_project_urlsc C s� | � d� tjdgtj�|jd t|�g�dd� tj�dd�}t tj�|d�d d ��}|� � � d �}W d � n1 s=w Y d |v sHJ �d S )zTest single line license.zlicense='MIT',r r r r r9 rb rc rC rD r� Nz License: MIT� r� r r� r r� r r& r� r rN rO r; r r r r � test_license� s � �zTestEggInfo.test_licensec C s� | � d� tjdgtj�|jd t|�g�dd� tj�dd�}t tj�|d�d d ��}|� � � d �}W d � n1 s=w Y d |v sHJ �d|v sNJ �dd �|�v sWJ �d S )z:Test license is escaped correctly if longer than one line.z<license='This is a long license text \nover multiple lines',r r r r r9 rb rc rC rD r� Nz%License: This is a long license text z over multiple linesztext over multipler$ r r r r �test_license_escape� s �� � z TestEggInfo.test_license_escapec C s� | � d� tj�� j|jd d�}tjdgtj� |jd t |�g�d|d� tj � dd �}t tj � |d �d d ��}|� � �d �}W d � n1 sJw Y d|v sUJ �| �|�dks^J �d S )Nzpython_requires='>=2.7.12',r r� r r r r� r9 rb rc rC rD r� zRequires-Python: >=2.7.12r! r" r� r r r � test_python_requires_egg_info� s �� � z)TestEggInfo.test_python_requires_egg_infoc C s$ ddg}|D ] }t �|�sJ �qd S )Nz:standard file not found: should have one of foo.py, bar.pyz"standard file 'setup.py' not found)r �_should_suppress_warning)r2 �fixturesrz r r r �'test_manifest_maker_warning_suppression� s ��z3TestEggInfo.test_manifest_maker_warning_suppressionc C s� | � � tddd��}d|_t|�}|�� |�� d|jjv s"J �t|jd dd��}|� � � d �}d|v s9J �W d � d S 1 sDw Y d S ) N�foo�0.0.1�r� �versionz non_setup.pyr0 z /SOURCES.txtrC rD r� ) r3 r � script_namer �finalize_optionsrv �filelistr� rN rO r; )r2 rR rT �egg_info_instancerV �sourcesr r r � test_egg_info_includes_setup_py� s "�z+TestEggInfo.test_egg_info_includes_setup_pyNc C sv t j�� j|jd d�}|d u rdg}tj|t j�|jd t |�g�d|d�\}}|r/J |��|r7||v s9J �d S d S )Nr r� r r r r� ) r r� r� r� r& r r� r� r r� )r2 rR r- r� �outputr� �coder r r r rf � s" �� � �z!TestEggInfo._run_egg_info_commandc C s� | � � t�dtd�i� | �||� tj�dd�}ttj�|d�dd��}|�� � d�}W d � n1 s7w Y d |v sBJ �d S ) NrA z� [egg_info] tag_build = dev tag_date = 0 tag_svn_revision = 0 r9 rb rc rC rD r� zVersion: 0.0.0.dev0r� r r r r �test_egg_info_tag_only_once� s �� �z'TestEggInfo.test_egg_info_tag_only_once)r4 r5 r6 r7 )F)NN)0r r r r r1 r3 r� r@ rY rP ra rj r{ r� r� r� r� �sys� version_infor� r� r� r� r� r� r� r� r� r� r� rs r� r� r� r r r r r r r# r% r& r' r* r4 rf r7 r r r r r/ 1 s� � #! . �� �� ��� ���� �� � �� ��� A�� ��� ��� ��� ��� ��� ���� �� ����� ��� ��� ��� � ��� P�� ��� �� ��� ������ � �� ���� ��� � ��� $' r/ c @ s e Zd Zdd� Zdd� ZdS )�TestWriteEntriesc C s| t ddd��}ddi|_|�d�}d}tjtj|d��}t|dd � d |jj d v s,J �W d � d S 1 s7w Y d S ) Nr+ r, r- z foo = invalid-identifier:foor z(Problems to parse .*invalid-identifier.*rn � entry_pointsre z#ensure entry-point follows the specr ) r r; �get_command_objrs rt r � OptionErrorr r r� )r2 rR r- rT r� � expected_msg�exr r r �test_invalid_entry_point s "�z)TestWriteEntries.test_invalid_entry_pointc C s^ t ddd��}ddgd�|_|�d�}t|dd � td �jd d �}d |v s'J �d |v s-J �d S )Nr+ r, r- z foo = bar:bazz faa = bor:boz)�abc�defr r; re rC rD z[abc] foo = bar:baz z[def] faa = bor:boz )r r; r< r r r� )r2 rR r- rT r� rW r r r �test_valid_entry_point s � z'TestWriteEntries.test_valid_entry_pointN)r r r r@ rC r r r r r: s r: )#� __future__r r� r� r rZ r# r8 r� �pathlibr �unittestr rs �jaracor � setuptoolsr �setuptools.command.egg_infor r r �setuptools.distr r� r r �textwrapr r� r �fixturer- r/ r: r r r r �<module> s> ] tests/__pycache__/test_bdist_deprecations.cpython-310.pyc 0000644 00000002024 15030122015 0017506 0 ustar 00 o �h � @ sr d Z ddlZddlmZ ddlZddlmZ ddlmZ ej j ej dkdd�ej j d d�e� d �d d � ���ZdS ) z develop tests� N)�mock)� SetuptoolsDeprecationWarning)� Distribution�win32znon-Windows only)�reasonz8bdist_rpm is long deprecated, should we remove it? #1988z%distutils.command.bdist_rpm.bdist_rpmc C s` t tddgddgd��}|�� t�t�� |�� W d � n1 s$w Y | j�� d S )Nzsetup.py� bdist_rpm�foo�hi)� script_name� script_args�name� py_modules) r �dict�parse_command_line�pytest�warnsr � run_commands�run�assert_called_once)� distutils_cmd� tmpdir_cwd�dist� r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_bdist_deprecations.py�test_bdist_rpm_warning s �� �r )�__doc__�sys�unittestr r � setuptoolsr �setuptools.distr �mark�skipif�platform�xfail�patchr r r r r �<module> s tests/__pycache__/test_manifest.cpython-310.pyc 0000644 00000037110 15030122015 0015453 0 ustar 00 o �h�H � @ sH U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z mZmZ ddlmZ ddlmZ ddlmZ ddlmZ d e jv Zd d � Zd d d gd�Zde�d�Z ej dd� �Z dd� Z e e!eg d���Z"ddgddgfddgg d�fdd d gd gfd g d �d!gfd"d#gg fd$d%gd&gfd'g d(�d)gfd*d+d,gd-gfd.g d/�g fd0g d1�d2d3gfd4d5d6gg d7�fd8g d9�d:gfd;d<gg d=�fg Z#d>e$d?< ej%�&d@dA� e#D ��Z'e j(e'dB�dCdD� �Z)ej%�&dEdA� e#D ��Z*e j(e*dB�dFdG� �Z+dHdI� Z,dJdK� Z-G dLdM� dM�Z.G dNdO� dOe.�Z/G dPdQ� dQe.�Z0dS )Rz sdist tests� )� annotationsN)�FileList�egg_info�translate_pattern)� Distribution)�DALS)�log)�DistutilsTemplateError�__pypy__c C s | � dtj�S )z"Converts '/' in a string to os.sep�/)�replace�os�sep)�s� r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_manifest.py�make_local_path s r �appz0.0)�name�version�packagesz&from setuptools import setup setup(**z) c c sR � t jt j} }t�� t�� t _t _z d V W | |t _t _d S | |t _t _w �N)�sys�stdout�stderr�io�StringIO)� old_stdout� old_stderrr r r �quiet, s �"r c C s t | d��� d S )N�wb)�open�close)�filenamer r r �touch6 s r$ )� README.rst� MANIFEST.in�setup.pyzapp.egg-info/PKG-INFOzapp.egg-info/SOURCES.txtz!app.egg-info/dependency_links.txtzapp.egg-info/top_level.txtzapp/__init__.py�foo�bar�foobar�foo/bar)z foo/bar/bazz ./foo/barr( z*.txtzfoo.txtzbar.txtz foo/foo.txtz dir/*.txt)z dir/foo.txtz dir/bar.txtzdir/.txtznotdir/foo.txtz*/*.pyz bin/start.pyzdocs/page-?.txtzdocs/page-9.txtzdocs/page-10.txtz foo/**/bar)z foo/bing/barzfoo/bing/bang/barr+ zfoo/abarzfoo/**zfoo/bar/bing.pyzfoo/xz/foo/xz**)�xzabc/xyzz@nythingz pre[one]post)�preopost�prenpost�preepost�prepost� preonepostzhello[!one]world� helloxworld� helloyworld)� hellooworld� helloworld� hellooneworldz []one].txt)zo.txtz].txtze.txtzone].txtz foo[!]one]bar�fooybar)zfoo]bar�fooobar�fooebarz&list[tuple[str, list[str], list[str]]]�translate_specsc c s& � | ]\}}}t t�|�|�V qd S r ��zip� itertools�repeat��.0�pattern�matches� mismatchesr r r � <genexpr>� � � � �rD )�paramsc C � t t| j�S r ��mapr �param��requestr r r � pattern_match� � rM c c s& � | ]\}}}t t�|�|�V qd S r r; r? r r r rD � rE c C rG r rH rK r r r �pattern_mismatch� rN rO c C s | \}}t |��|�s J �d S r �r �match)rM rA �targetr r r � test_translated_pattern_match� � rS c C s | \}}t |��|�r J �d S r rP )rO rA rR r r r � test_translated_pattern_mismatch� rT rU c @ s e Zd Zdd� Zdd� ZdS )�TempDirTestCasec C s$ t �� | _t�� | _t�| j� d S r )�tempfile�mkdtemp�temp_dirr �getcwd�old_cwd�chdir��self�methodr r r � setup_method� s z TempDirTestCase.setup_methodc C s t �| j� t�| j� d S r )r r\ r[ �shutil�rmtreerY r] r r r �teardown_method� s z TempDirTestCase.teardown_methodN)�__name__� __module__� __qualname__r` rc r r r r rV � s rV c s| e Zd Z� fdd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Z� ZS )�TestManifestTestc s� t � �|� ttj�| jd�ddd�}|�t� |� � dD ] }t tj�| j|�� q tj�| jd�}t� |� dD ] }t tj�||�� q;tj�|d�}t� |� d D ] }t tj�||�� qUd S ) Nr' �w�utf-8��encoding)r% � .hidden.rst� testing.rst�LICENSEr )z __init__.py�a.txt�b.txtzc.rst�static)zapp.jsz app.js.mapzapp.cssz app.css.map) �superr` r! r �path�joinrY �write�SETUP_PYr" r$ �mkdir)r^ r_ �f�fname�test_pkgrq �� __class__r r r` � s �z TestManifestTest.setup_methodc C sR t j�| jd�}t|ddd��}|�t|�� W d � dS 1 s"w Y dS )zWrite a MANIFEST.in.r& rh ri rj N)r rs rt rY r! ru r )r^ �contents�manifestrx r r r � make_manifest� s "�z TestManifestTest.make_manifestc C s2 t t�}d|_t|�}|�� |�� t|jj�S )z7Run egg_info and get all the files to include, as a setr' ) r � SETUP_ATTRS� script_namer �ensure_finalized�run�set�filelist�files)r^ �dist�cmdr r r � get_files� s zTestManifestTest.get_filesc C s t tdg� | �� ks J �dS )z=Check a missing MANIFEST.in includes only the standard files.r& N)� default_filesr� r� �r^ r r r �test_no_manifest� s z!TestManifestTest.test_no_manifestc C s | � d� t| �� ks J �dS )z<Check an empty MANIFEST.in includes only the standard files.� N)r r� r� r� r r r �test_empty_files� s z!TestManifestTest.test_empty_filesc C s. | � d� ttddg�B }|| �� ksJ �dS )z,Include extra rst files in the project root.z include *.rstrm rl N)r r� r� r� )r^ r� r r r � test_include� s z TestManifestTest.test_includec C s4 t }| �d� tt|d�g�B }|| �� ksJ �dS )z0Include everything in app/ except the text fileszE include app/* exclude app/*.txt � app/c.rstN�r r r� r� r� �r^ �mlr� r r r � test_exclude� s �z TestManifestTest.test_excludec C sR t }| �d� tt|d�|d�|d�|d�|d�|d�g�B }|| �� ks'J �dS ) z Include with multiple patterns.z include app/*.txt app/static/*� app/a.txt� app/b.txt�app/static/app.js�app/static/app.js.map�app/static/app.css�app/static/app.css.mapNr� r� r r r �test_include_multiple� s �z&TestManifestTest.test_include_multiplec C �F t }| �d� tt|d�|d�|d�|d�g�B }|| �� ks!J �dS )�(Include the whole app/static/ directory.zgraft app/staticr� r� r� r� Nr� r� r r r � test_graft � �zTestManifestTest.test_graftc C r� )r� zgraft */staticr� r� r� r� Nr� r� r r r �test_graft_glob_syntax r� z'TestManifestTest.test_graft_glob_syntaxc C s: t }| �d� tt|d�|d�g�B }|| �� ksJ �dS )z'Exclude all *.map files in the project.zK graft app/static global-exclude *.map r� r� Nr� r� r r r �test_graft_global_exclude% s �z*TestManifestTest.test_graft_global_excludec C sD t }| �d� ttdd|d�|d�|d�g�B }|| �� ks J �dS )z;Include all *.rst, *.js, and *.css files in the whole tree.z9 global-include *.rst *.js *.css rl rm r� r� r� Nr� r� r r r �test_global_include1 s ��z$TestManifestTest.test_global_includec C s@ t }| �d� tt|d�|d�|d�g�B }|| �� ks J �dS )z@Include all files in app/, except for the whole app/static/ dir.z@ graft app prune app/static r� r� r� Nr� r� r r r �test_graft_pruneB s � z!TestManifestTest.test_graft_prune)rd re rf r` r r� r� r� r� r� r� r� r� r� r� r� � __classcell__r r r{ r rg � s ' rg c @ s� e Zd ZdZeje�d�dkd�dd� �Zdd� Z d d � Z d d � Z d d� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'S )(�TestFileListTestz� A copy of the relevant bits of distutils/tests/test_filelist.py, to ensure setuptools' version of FileList keeps parity with distutils. �SETUPTOOLS_USE_DISTUTILS�stdlib)�autousec s � fdd�}|� tjd|� dS )z Account for stdlib compatibilityc s. t �� }t�d|dd|||�}� j�|� d S )N� distutilsr� r )r �exc_info�logging� LogRecord�records�append)�_logger�level�msg�args�exc�rec��caplogr r �_logY s z2TestFileListTest._compat_record_logs.<locals>._logr� N)�setattrr �Log)r^ � monkeypatchr� r� r r� r �_compat_record_logsU s z$TestFileListTest._compat_record_logsc s � fdd�|j D �S )Nc s g | ] }|j � v r|�qS r )�levelno)r@ �r��levelsr r � <listcomp>a s z0TestFileListTest.get_records.<locals>.<listcomp>)r� )r^ r� r� r r� r � get_records` s z TestFileListTest.get_recordsc C s" | � |tj�g ks J �|�� d S r )r� r �WARN�clear�r^ r� r r r �assertNoWarningsc s z!TestFileListTest.assertNoWarningsc C s> t r |js t�d� d S t| �|tj��dksJ �|�� d S )Nz'caplog checks may not work well in PyPyr ) �IS_PYPYr� �pytest�xfail�lenr� r r� r� r� r r r �assertWarningsg s z TestFileListTest.assertWarningsc C sD |D ] }t j�| j|�}t j�|�\}}t j|dd� t|� qd S )NT)�exist_ok)r rs rt rY �split�makedirsr$ )r^ r� �file�dirname� _basenamer r r � make_filesn s �zTestFileListTest.make_filesc C s� t � }t}| �ddddd|d�|d�|d�|d �|d �|d �|d �|d �|d�|d�g� td�}|�d�D ] }|s;q6|�|� q6ddd|d�|d �|d �|d �|d�|d�g }|�� |j|kscJ �d S )Nzfoo.tmp�ok�xozfour.txtz buildout.cfgz.hg/last-message.txtzglobal/one.txtzglobal/two.txtzglobal/files.xzglobal/here.tmpzf/o/f.ooz dir/graft-onezdir/dir2/graft2zdir3/okzdir3/sub/ok.txta6 include ok include xo exclude xo include foo.tmp include buildout.cfg global-include *.x global-include *.txt global-exclude *.tmp recursive-include f *.oo recursive-exclude global *.x graft dir prune dir3 � )r r r� r r� �process_template_line�sortr� )r^ � file_listr� � MANIFEST_IN�line�wantedr r r �test_process_template_lineu sL �� � z+TestFileListTest.test_process_template_linec C sh t � }|�d�r J �t � }ddg|_|�d�sJ �t � }ddg|_|�d� |�� |jdgks2J �d S )N�*.py�a.pyzb.pyro )r �exclude_patternr� r� �r^ r� r r r �test_exclude_pattern� s z%TestFileListTest.test_exclude_patternc C s| t � }| �g � |�d�rJ �t � }| �ddg� |�d�s J �t � }| �ddg� |�d� |�� |jddgks<J �d S )Nr� r� rp �*)r r� �include_patternr� r� r� r r r �test_include_pattern� s z%TestFileListTest.test_include_patternc C sH t � }dD ] }t�t�� |�|� W d � n1 s w Y qd S )N) �include�excludezglobal-includezglobal-excludezrecursive-includezrecursive-exclude�graft�prune�blarg)r r� �raisesr r� )r^ r� �actionr r r �"test_process_template_line_invalid� s ���z3TestFileListTest.test_process_template_line_invalidc C s� |� tj� t}t� }| �dd|d�g� |�d� |�� |jdgks&J �| � |� |�d� |�� |jdgks<J �| � |� d S )Nr� rp �d/c.pyz include *.pyz include *.rb� � set_levelr� �DEBUGr r r� r� r� r� r� r� �r^ r� r� r� r r r r� � s z TestFileListTest.test_includec C s� |� tj� t}t� }dd|d�g|_|�d� |�� |jd|d�gks'J �| �|� |�d� |�� |jd|d�gks@J �| � |� d S )Nr� rp r� z exclude *.pyz exclude *.rb� r� r� r� r r r� r� r� r� r� r� r r r r� � s z TestFileListTest.test_excludec C s� |� tj� t}t� }| �dd|d�g� |�d� |�� |jd|d�gks)J �| � |� |�d� |�� |jd|d�gksBJ �| � |� d S )Nr� rp r� zglobal-include *.pyzglobal-include *.rbr� r� r r r r� s z$TestFileListTest.test_global_includec C s� |� tj� t}t� }dd|d�g|_|�d� |�� |jdgks$J �| �|� |�d� |�� |jdgks:J �| � |� d S )Nr� rp r� zglobal-exclude *.pyzglobal-exclude *.rbr� r� r r r �test_global_exclude s z$TestFileListTest.test_global_excludec C s� |� tj� t}t� }| �d|d�|d�|d�g� |�d� |�� |j|d�|d�gks0J �| � |� |�d� |�� |j|d�|d�gksKJ �| � |� d S )Nr� �d/b.py�d/c.txt�d/d/e.pyzrecursive-include d *.pyzrecursive-include e *.pyr� r� r r r �test_recursive_include, � z'TestFileListTest.test_recursive_includec C s� |� tj� t}t� }d|d�|d�|d�g|_|�d� |�� |jd|d�gks,J �| �|� |�d� |�� |jd|d�gksEJ �| � |� d S )Nr� r� r� r� zrecursive-exclude d *.pyzrecursive-exclude e *.pyr� r� r r r �test_recursive_exclude= � z'TestFileListTest.test_recursive_excludec C s� |� tj� t}t� }| �d|d�|d�|d�g� |�d� |�� |j|d�|d�gks0J �| � |� |�d� |�� |j|d�|d�gksKJ �| � |� d S )Nr� r� r� �f/f.pyzgraft dzgraft er� r� r r r r� N r� zTestFileListTest.test_graftc C s� |� tj� t}t� }d|d�|d�|d�g|_|�d� |�� |jd|d�gks,J �| �|� |�d� |�� |jd|d�gksEJ �| � |� d S )Nr� r� r� r� zprune dzprune er� r� r r r � test_prune_ r� zTestFileListTest.test_pruneN)rd re rf �__doc__r� �fixturer �getenvr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r� O s( ? r� )1r� � __future__r � contextlibr r= r� r ra r rW r� �setuptools.command.egg_infor r r �setuptools.distr �setuptools.tests.textwrapr r� r �distutils.errorsr �builtin_module_namesr� r r� rv �contextmanagerr r$ � frozensetrI r� r: �__annotations__�chain� from_iterable� match_paramsr� rM �mismatch_paramsrO rS rU rV rg r� r r r r �<module> s� �� �� ������� �. � � % tests/__pycache__/textwrap.cpython-310.pyc 0000644 00000000522 15030122015 0014461 0 ustar 00 o �hb � @ s d dl Z dd� ZdS )� Nc C s t �| ��� S )zdedent and left-strip)�textwrap�dedent�lstrip)�s� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/textwrap.py�DALS s r )r r r r r r �<module> s tests/__pycache__/text.cpython-310.pyc 0000644 00000000635 15030122015 0013574 0 ustar 00 o �h{ � @ s G d d� d�Z dS )c @ s$ e Zd ZdZe�d�Ze�d�ZdS )� Filenamesu smörbröd.pyzlatin-1zutf-8N)�__name__� __module__� __qualname__�unicode�encode�latin_1�utf_8� r r �H/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/text.pyr s r N)r r r r r �<module> s tests/__pycache__/test_find_py_modules.cpython-310.pyc 0000644 00000005205 15030122015 0017025 0 ustar 00 o �hd � @ s\ d Z ddlZddlZddlmZmZ ddlmZ ddlm Z G dd� d�Z G d d � d �Z dS ) z(Tests for automatic discovery of modules� N)�FlatLayoutModuleFinder� ModuleFinder� )� os_helper)� ensure_filesc @ s� e Zd Zdd� Zddgi ddgfddgddgidgfg d �dgd gd �dgfd d gi g fd�Zej�de�� �dd� �Z ejj e � � dd�dd� �Z dS )�TestModuleFinderc O s t tjt|�g|�R i |���S �N)�setr �find�str��self�path�args�kwargs� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_find_py_modules.pyr s zTestModuleFinder.find�file.py�other.py�file�other�excludezf*)r zfole.pyr zfo*)�includer z my-file.pyz other.file.py)� simple_folderr r z invalid-name�examplec C s< | j | \}}}t||� | j|fi |��t|�ks J �d S r ��EXAMPLESr r r )r �tmp_pathr �filesr �expected_modulesr r r � test_finder% s "z TestModuleFinder.test_finderzSymlink support required)�reasonc C s< d}t ||g� t�|| |d � | �|�dhks J �d S )Nz_myfiles/file.pyzlink.py�link)r �os�symlinkr )r r �srcr r r �$test_symlinked_packages_are_included+ s z5TestModuleFinder.test_symlinked_packages_are_includedN)�__name__� __module__� __qualname__r r �pytest�mark� parametrize�keysr �skipifr � can_symlinkr& r r r r r s( �� � � r c @ s\ e Zd Zdd� Zdgg fdgg fg d�dgfg d�dgfd�Zej�d e�� �d d � �Z d S ) �TestFlatLayoutModuleFinderc O s t t�t|���S r )r r r r r r r r r 4 s z TestFlatLayoutModuleFinder.findz .module.pyz _module.py)zsetup.pyz conftest.pyztest.pyztests.pyz example.py�mod.py�mod)ztasks.pyz fabfile.pyz noxfile.pyzdodo.pyz manage.pyr1 )z hidden-fileszprivate-modulesz common-namesz tool-specificr c C s2 | j | \}}t||� | �|�t|�ksJ �d S r r )r r r r r r r r � test_unwanted_files_not_includedE s z;TestFlatLayoutModuleFinder.test_unwanted_files_not_includedN) r' r( r) r r r* r+ r, r- r3 r r r r r0 3 s ���r0 ) �__doc__r# r* �setuptools.discoveryr r � compat.py39r �test_find_packagesr r r0 r r r r �<module> s & tests/__pycache__/test_bdist_wheel.cpython-310.pyc 0000644 00000055060 15030122015 0016142 0 ustar 00 o �h+Z � @ sF d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl m Z d dlmZ d dlmZ d dlZd dlZd dlmZ d dlZd dlmZmZ d dlm Z d d l m Z d d l m Z h d �Z!h d �Z"d dhZ#dZ$e$ddid�e%�&e"e#B d��ed�dd�ed�ddid�ed�ddd�ed�dddd �d �d ddiid �ed �ddd!�d"�ed#�d$d%�ed&�dd'd(diid)�d*�Z'e jd+kr�ed,�d-d.d/�e'd0< d1d2� Z(d3d4� Z)ej*d5d6�d7d8� �Z+ej*d9d:� �Z,ej*d;d<� �Z-d=d>� Z.d?d@� Z/dAZ0dBdC� Z1dDdE� Z2dFdG� Z3ej4�5dHdIdJdKe$�6dLdM�fg�dNdO� �Z7dPdQ� Z8dRdS� Z9dTdU� Z:dVdW� Z;dXZ<dYZ=ej4�>dZ�d[d\� �Z?d]d^� Z@ej4j5d_eAejB�C� �eAejB�d`�dadb� �ZDdcdd� ZEdedf� ZFdgdh� ZGdidj� ZHdkdl� ZIdmdn� ZJdodp� ZKdqdr� ZLdsdt� ZMej4�5dudvdwg�ej4jNe�O� dxkdydz�d{d|� ��ZPd�dd��ZQd�d�� ZRd�d�� ZSdS )�� )� annotationsN)�suppress)�cleandoc)�ZipFile)�tags)� bdist_wheel� get_abi_tag)� Distribution)� SetuptoolsDeprecationWarning)� run_setup> � dummy_dist-1.0.dist-info/WHEEL�&dummy_dist-1.0.dist-info/top_level.txt� dummy_dist-1.0.dist-info/RECORD�!dummy_dist-1.0.dist-info/METADATA> � COPYING.md� NOTICE.rst� AUTHORS.txt� LICENCE.txt�NOTICE�AUTHORS�COPYING�LICENCE�LICENSE� LICENSE.txtzLICENSE~zAUTHORS~zQfrom setuptools import setup setup( name='dummy_dist', version='1.0', ) � DUMMYFILE� )�setup.py� licenses_diru from setuptools import setup setup( name="simple.dist", version="0.1", description="A testing distribution ☃", extras_require={"voting": ["beaglevote"]}, ) )r � simpledistui from setuptools import setup setup( name="complex-dist", version="0.1", description="Another testing distribution ☃", long_description="Another testing distribution ☃", author="Illustrious Author", author_email="illustrious@example.org", url="http://example.org/exemplary", packages=["complexdist"], setup_requires=["setuptools"], install_requires=["quux", "splort"], extras_require={"simple": ["simple.dist"]}, entry_points={ "console_scripts": [ "complex-dist=complexdist:main", "complex-dist2=complexdist:main", ], }, ) � __init__.pyzdef main(): return)r � complexdistz� from setuptools import setup setup( name="headers.dist", version="0.1", description="A distribution with headers", headers=["header.h"], ) )r zheadersdist.pyzheader.hak from setuptools import setup setup( name="testrepo", version="0.1", packages=["mypackage"], description="A test package with commas in file names", include_package_data=True, package_data={"mypackage.data": ["*"]}, ) )r z 1,2,3.txt)r �data� mypackage)r r" ztestrepo-0.1.0u from setuptools import setup setup( name="unicode.dist", version="0.1", description="A testing distribution ☃", packages=["unicodedist"], zip_safe=True, ) )r � åäö_日本語.py)r � unicodedistu� [metadata] name = utf8-metadata-dist version = 42 author_email = "John X. Ãørçeč" <john@utf8.org>, Γαμα קּ 東 <gama@utf8.org> long_description = file: README.rst � UTF-8 描述 説明)� setup.cfgz README.rstz� [metadata] name = licenses-dist version = 1.0 license_files = **/LICENSE �vendorr )r& r �src)� dummy-distz simple-distz complex-distz headers-distzcommasinfilenames-distz unicode-distzutf8-metadata-dist� licenses-dist�win32u� from setuptools import Extension, setup setup( name="extension.dist", version="0.1", description="A testing distribution ☃", ext_modules=[ Extension( name="extension", sources=["extension.c"], py_limited_api=True ) ], ) z![bdist_wheel] py_limited_api=cp32z5#define Py_LIMITED_API 0x03020000 #include <Python.h>)r r& � extension.czabi3extension-distc K s^ t j�d�r tddd�ntddi�}|�� t|�}| �� D ] \}}t|||� q |� � |S )zHRun command in the same process so that it is easier to collect coverager �init)� stop_after� script_namez%%build_meta%%) �os�path�existsr r �parse_config_filesr �items�setattr�finalize_options)�kwargs�dist_obj�cmd�attr�value� r< �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_bdist_wheel.py�bdist_wheel_cmd� s � �r> c C s& | � |�}tjjt| t|�d� |S )N��prefix)�mktemp�jaracor1 �build�EXAMPLES�str)�tmp_path_factory�name�basedirr< r< r= � mkexample� s rI �session)�scopec C s� | � d�}| � d�}tD ]/}t| |�}|| }tj�� �|�� tt|�t|�d�� � W d � n1 s6w Y q t dd� |� d�D ��S )NrC �dist�� bdist_dir�dist_dirc s s � | ]}t |�V qd S �N�rE ��.0�fnamer< r< r= � <genexpr>� s � z wheel_paths.<locals>.<genexpr>z*.whl) rA rD rI rB r1 �DirectoryStack�contextr> rE �run�sorted�glob)rF � build_baserO rG � example_dir� build_dirr< r< r= � wheel_paths� s ��r^ c C � t | d�S )Nr) �rI �rF r< r< r= � dummy_dist� � rb c C r_ )Nr* r` ra r< r< r= � licenses_dist� rc rd c C s6 t dd� | D ��}t|��� D ] }d|jvsJ �qdS )z0Make sure entry point scripts are not generated.c s � � | ] }d |v r|V qdS )� complex_distNr< �rS r1 r< r< r= rU � � z"test_no_scripts.<locals>.<genexpr>z.data/scripts/N)�nextr �infolist�filename)r^ r1 �entryr< r< r= �test_no_scripts s �rm c C sX t dd� | D ��}t|�� }|�d�}W d � n1 s w Y d�� |v s*J �d S )Nc s re )� unicode_distNr< rg r< r< r= rU rh z&test_unicode_record.<locals>.<genexpr>z!unicode_dist-0.1.dist-info/RECORDr# )ri r �read�encode)r^ r1 �zf�recordr< r< r= �test_unicode_record s �rs u� Metadata-Version: 2.1 Name: helloworld Version: 42 Author-email: "John X. Ãørçeč" <john@utf8.org>, Γαμα קּ 東 <gama@utf8.org> UTF-8 描述 説明 c C s� | � |� |d }|d }|�� |d jtdd� |d �� G dd� dt�}|� }|�||� |d jdd�}d |v s?J �d |v sEJ �d |v sKJ �d S ) Nzdummy_dist.egg-info�dummy_dist.dist-infozPKG-INFO�utf-8��encodingzdependency_links.txtc @ s$ e Zd ZdZdd� Zedd� �ZdS )z;test_preserve_unicode_metadata.<locals>.simpler_bdist_wheelz1Avoid messing with setuptools/distutils internalsc S s d S rP r< ��selfr< r< r= �__init__* s zDtest_preserve_unicode_metadata.<locals>.simpler_bdist_wheel.__init__c S s g S rP r< rx r< r< r= � license_paths- s zItest_preserve_unicode_metadata.<locals>.simpler_bdist_wheel.license_pathsN)�__name__� __module__� __qualname__�__doc__rz �propertyr{ r< r< r< r= �simpler_bdist_wheel' s r� �METADATAu" Author-email: "John X. Ãørçeč"u Γαμα קּ 東 r% )�chdir�mkdir� write_text� UTF8_PKG_INFO�touchr �egg2dist� read_text)� monkeypatch�tmp_path�egginfo�distinfor� �cmd_obj�metadatar< r< r= � test_preserve_unicode_metadata s r� c C sp |� | � tt|�d��� td�� }dd� tD �}t|�� �t|B ks&J �W d � d S 1 s1w Y d S )N�rN �$dist/dummy_dist-1.0-py3-none-any.whlc S � h | ]}d | �qS �z"dummy_dist-1.0.dist-info/licenses/r< rR r< r< r= � <setcomp>> � ��z(test_licenses_default.<locals>.<setcomp>) r� r> rE rX r �DEFAULT_LICENSE_FILES�set�namelist� DEFAULT_FILES�rb r� r� �wf� license_filesr< r< r= �test_licenses_default: s �"�r� c C s| | � d�jddd� |�| � tt|�d��� td��}dh}t|�� �t |B ks,J �W d � d S 1 s7w Y d S )Nr& z.[metadata] license_file=licenses_dir/DUMMYFILEru rv r� r� z8dummy_dist-1.0.dist-info/licenses/licenses_dir/DUMMYFILE� �joinpathr� r� r> rE rX r r� r� r� r� r< r< r= �test_licenses_deprecatedE s � "�r� )� config_file�config)r& z1[metadata] license_files=licenses_dir/* LICENSE)r& z0[metadata] license_files=licenses_dir/*, LICENSEr �)z6 license_files=['licenses_dir/DUMMYFILE', 'LICENSE'])c C s� | � |�j|dd� |�| � tt|�d��� td��0}dd� dD �}t|�� �t |B ks0J �|� d�� d �}d |v s>J �d |v sDJ �W d � d S 1 sOw Y d S ) Nru rv r� r� c S r� r� r< rR r< r< r= r� d r� z)test_licenses_override.<locals>.<setcomp>> �licenses_dir/DUMMYFILEr r �utf8z$License-File: licenses_dir/DUMMYFILE�License-File: LICENSE) r� r� r� r> rE rX r r� r� r� ro �decode)rb r� r� r� r� r� r� r� r< r< r= �test_licenses_overrideR s � "�r� c C s� |� | � tt|�d��� tt�d�� td��4}dd� tD �}ddh}t |� � �||B ks1J �|� d�� d �}d |v s?J �d |v sEJ �W d � d S 1 sPw Y d S ) Nr� rL z'dist/licenses_dist-1.0-py3-none-any.whlc S s h | ]}|� d d��qS )�dummy_� licenses_)�replace)rS rG r< r< r= r� s s z:test_licenses_preserve_folder_structure.<locals>.<setcomp>z,licenses_dist-1.0.dist-info/licenses/LICENSEz7licenses_dist-1.0.dist-info/licenses/src/vendor/LICENSEz$licenses_dist-1.0.dist-info/METADATAr� z License-File: src/vendor/LICENSEr� ) r� r> rE rX �printr0 �listdirr r� r� r� ro r� )rd r� r� r� � default_filesr� r� r< r< r= �'test_licenses_preserve_folder_structuren s � "�r� c C sr | � d�jddd� |�| � tt|�d��� td��}t|�� �t ks'J �W d � d S 1 s2w Y d S )Nr& z[metadata] license_files= ru rv r� r� r� )rb r� r� r� r< r< r= �test_licenses_disabled~ s � "�r� c C sp |� | � tt|�dd��� td��}t|�� �}d|v s J �d|v s&J �W d � d S 1 s1w Y d S )N�2�rN � build_numberz&dist/dummy_dist-1.0-2-py3-none-any.whlr r )r� r> rE rX r r� r� )rb r� r� r� � filenamesr< r< r= �test_build_number� s "�r� c C s` |� | � tjtdd�� tt|�dd��� W d � n1 s!w Y tj� d�s.J �d S )Nz.*universal is deprecated��matchT)rN � universalz(dist/dummy_dist-1.0-py2.py3-none-any.whl) r� �pytest�warnsr r> rE rX r0 r1 r2 )rb r� r� r< r< r= �test_universal_deprecated� s �r� a& #include <Python.h> static PyMethodDef methods[] = { { NULL, NULL, 0, NULL } }; static struct PyModuleDef module_def = { PyModuleDef_HEAD_INIT, "extension", "Dummy extension module", -1, methods }; PyMODINIT_FUNC PyInit_extension(void) { return PyModule_Create(&module_def); } u� from __future__ import annotations from setuptools import Extension, setup setup( name="extension.dist", version="0.1", description="A testing distribution ☃", ext_modules=[Extension(name="extension", sources=["extension.c"])], ) zEonce:Config variable '.*' is unset.*, Python ABI tag may be incorrectc C sh |� d�}|d jtdd� |d jtdd� |�d�}|�d�}| �|� tt|�t|�d��� d S ) z=Test that building a binary wheel with the limited ABI works.�extension_distr ru rv r, rC rL rM N) rA r� �EXTENSION_SETUPPY�EXTENSION_EXAMPLEr� r� r> rE rX )r� r� rF � source_dirr] rO r< r< r= �test_limited_abi� s r� c C sn t |�d��}t�t | �|� |�|� t�|�D ]\}}}|D ]}t�tj� ||�t j � q qt � � � d S )N�dummy)rE r� �shutil�copytreer� r0 �walk�chmodr1 �join�stat�S_IREADr> rX )rb r� r� rH �root�_dirs�filesrT r< r< r= � test_build_from_readonly_tree� s �r� )�option� compress_type)�idsc C s� |� | � tt|�|d��� td��(}t|�� �}d|v s J �d|v s&J �|jD ] }|j|ks2J �q)W d � d S 1 s>w Y d S )N)rN � compressionr� r r ) r� r> rE rX r r� r� �filelistr� )rb r� r� r� r� r� r� �zinfor< r< r= �test_compression� s �"�r� c C s` | D ]+}t |�� }tdd� |jD ��}|�|�}d|vs J �W d � n1 s(w Y qd S )Nc s s � | ] }|j �d �r|V qdS )�WHEELN)rk �endswith)rS �fnr< r< r= rU � s � z.test_wheelfile_line_endings.<locals>.<genexpr>� )r ri r� ro )r^ r1 r� � wheelfile�wheelfile_contentsr< r< r= �test_wheelfile_line_endings� s ���r� c C sr |� dd� |�| � tt|�dd��� td��}|jD ] }|jdks&J �q W d � d S 1 s2w Y d S )N�SOURCE_DATE_EPOCH�0�2ar� z'dist/dummy_dist-1.0-2a-py3-none-any.whl)i� � r� r r r )�setenvr� r> rE rX r r� � date_time)rb r� r� r� r� r< r< r= �test_unix_epoch_timestamps� s �"�r� c C s� | � tddd� � | � tddd� � t� dksJ �| � tddd� d � t� d ks*J �| � tdd d� � t� d ks:J �| �td� t� d ksGJ �d S )N�interpreter_namec S � dS )N�cpr< r< r< r< r= �<lambda>� � z*test_get_abi_tag_windows.<locals>.<lambda>�get_config_varc S r� )Nzcp313-win_amd64r< ��xr< r< r= r� � r� �cp313�gettotalrefcountc S r� )Nr� r< r< r< r< r= r� � r� F�cp313dc S r� )Nzcp313t-win_amd64r< r� r< r< r= r� � r� �cp313td�cp313t)r5 r � sysconfigr �sys�delattr�r� r< r< r= �test_get_abi_tag_windows� s r� c C �6 | � tddd� � | � tddd� � t� dksJ �d S )Nr� c S r� �N�ppr< r< r< r< r= r� r� z+test_get_abi_tag_pypy_old.<locals>.<lambda>r� c S r� )Nz pypy36-pp73r< r� r< r< r= r� r� � pypy36_pp73)r5 r r� r r� r< r< r= �test_get_abi_tag_pypy_old � r� c C r� )Nr� c S r� )Nzpypy37-pp73-darwinr< r� r< r< r= r� r� z+test_get_abi_tag_pypy_new.<locals>.<lambda>r� c S r� r� r< r< r< r< r= r� r� � pypy37_pp73�r5 r� r r r� r< r< r= �test_get_abi_tag_pypy_new r� r� c C r� )Nr� c S r� )Nz"graalpy231-310-native-x86_64-linuxr< r� r< r< r= r� r� z*test_get_abi_tag_graalpy.<locals>.<lambda>r� c S r� )N�graalpyr< r< r< r< r= r� r� �graalpy231_310_nativer� r� r< r< r= �test_get_abi_tag_graalpy s �r c C r� )Nr� c S r� )Nzunknown-python-310r< r� r< r< r= r� r� z+test_get_abi_tag_fallback.<locals>.<lambda>r� c S r� )Nzunknown-pythonr< r< r< r< r= r� r� �unknown_python_310r� r� r< r< r= �test_get_abi_tag_fallback r� r c C s |� | � tdd��� dS )z>Ensure building on platforms with a space in the name succeed.z isilon onefs)� plat_nameN)r� r> rX )rb r� r< r< r= �test_platform_with_space s r c C s� | � |� ddddd�}|�� D ]"\}}t|ddd��}|�t|�� W d � n1 s-w Y qt� �� d }tj� |�sBJ �t t |�� � �}d D ]}||v sTJ �qLd D ]} | |vs_J �qWdS ) z� Setuptools allow authors to set PEP 440's local version segments using ``egg_info.tag_build``. This should be reflected not only in the ``.whl`` file name, but also in the ``.dist-info`` and ``.data`` dirs. See pypa/setuptools#3997. z] from setuptools import setup setup(headers=["hello.h"]) z� [metadata] name = test version = 1.0 [options.data_files] hello/world = file.txt [egg_info] tag_build = +what tag_date = 0 r )r r& zfile.txtzhello.h�wru rv Nz#dist/test-1.0+what-py3-none-any.whl)z"test-1.0+what.data/headers/hello.hz,test-1.0+what.data/data/hello/world/file.txtz test-1.0+what.dist-info/METADATAz test-1.0+what.dist-info/WHEEL)ztest.data/headers/hello.hz'test-1.0.data/data/hello/world/file.txtztest.dist-info/METADATAztest-1.0.dist-info/WHEEL) r� r4 �open�writer r> rX r0 r1 r2 r� r r� ) r� r� r� �file�content�fh� wheel_path�entries�expected� not_expectedr< r< r= � test_data_dir_with_tag_build# s( � �� �r )�reportedr )z linux-x86_64� linux_i686)z linux-aarch64� linux_armv7l�Linuxz!Only makes sense to test on Linux)�reasonc C sL |� tddd� � t�� }t|�}| |_d|_|�� \}}}||ks$J �d S )N�calcsizec S r� )N� r< r� r< r< r= r� b r� z'test_platform_linux32.<locals>.<lambda>F)r5 �struct� setuptoolsr r r � root_is_pure�get_tag)r r r� rL r9 �_�actualr< r< r= �test_platform_linux32Z s r �return�Nonec C s� d dd�}t t�� | �tjd� W d � n1 sw Y | �td|� tjt dd�� d d l }W d � n1 s=w Y | �tjd � d d l }d S ) NrG rE c _ s. | dkr t d| � ���tj| g|�R i |��S )N�ctypeszNo module named )�ModuleNotFoundError� importlib� __import__)rG �argsr7 r< r< r= � _fake_importl s z$test_no_ctypes.<locals>._fake_importzwheel.macosx_libfiler# zNo module named ctypesr� r z setuptools.command.bdist_wheel)rG rE ) r �KeyError�delitemr� �modulesr5 �builtinsr� �raisesr! �wheel.macosx_libfile� setuptools.command.bdist_wheel)r� r% �wheelr r< r< r= �test_no_ctypesk s � � r. c C s� |� | � |d }|�� |d jddd� |d jddd� tt|�t|�d��� d d h}td ��}t|�� �}W d � n1 sDw Y || t� ksRJ �d d � |D �r[J �d S )Nrt r� zname: helloworldru rv �FOO�bar)rN � dist_info_dirz dummy_dist-1.0.dist-info/FOOr r� c S s g | ] }d t |�v r|�qS )zegg-inforQ rg r< r< r= � <listcomp>� s z+test_dist_info_provided.<locals>.<listcomp>) r� r� r� r> rE rX r r� r� )rb r� r� r� r r� � files_foundr< r< r= �test_dist_info_provided� s � �r4 c C s� ddt d�t d�dd�d�}tjj|t|�d� | �|d � d }tjt|d �� t � � � W d � n1 s8w Y t d ��-}t |� � �}d dh}||ksRJ �|�d��d�}d|v s`J �d|v sfJ �W d � d S 1 sqw Y d S )Nzparent licensez parent noticez� [project] name = "test-proj" dynamic = ["version"] # <---- testing dynamic will not break [tool.setuptools.dynamic] version.file = "VERSION" z� [metadata] license_files = ../LICENSE.txt ../NOTICE.txt �42)zpyproject.tomlr& �VERSION)r z NOTICE.txt�pythonr? r7 z'Pattern '../.*.txt' cannot contain '..'r� z"dist/test_proj-42-py3-none-any.whlz+test_proj-42.dist-info/licenses/LICENSE.txtz*test_proj-42.dist-info/licenses/NOTICE.txtz test_proj-42.dist-info/METADATAr� zLicense-File: LICENSE.txtzLicense-File: NOTICE.txt)r rB r1 rC rE r� r� r� r r> rX r r� r� ro r� )r� r� r� �msgr� r3 �expected_filesr� r< r< r= �0test_allow_grace_period_parent_directory_license� s6 � ��� � � "�r: )r r )T� __future__r r) r" �os.pathr0 �platformr� r� r r� r� � contextlibr �inspectr �zipfiler � jaraco.pathrB r� � packagingr r r, r r �setuptools.distr �setuptools.warningsr �distutils.corer r� r� �OTHER_IGNORED_FILES�SETUPPY_EXAMPLE�dict�fromkeysrD r> rI �fixturer^ rb rd rm rs r� r� r� r� �mark� parametrizer� r� r� r� r� r� r� r� �filterwarningsr� r� �list�supported_compressionsr4 r� r� r� r� r� r� r r r r �skipif�systemr r. r4 r: r< r< r< r= �<module> s$ � ��� ��� � ������ �� � ���� � � ���� � � 7� � tests/__pycache__/server.cpython-310.pyc 0000644 00000006507 15030122015 0014122 0 ustar 00 o �h] � @ s� d Z ddlZddlZddlZddlZddlZddlZG dd� dej j �Z G dd� dej j �Z G dd� dej j ej�Zd d d �ZdS ) z>Basic http server for tests to simulate PyPI or custom indexes� Nc @ s: e Zd ZdZdejjfdd�Zdd� Zdd� Z d d � Z d S ) � IndexServeraY Basic single-threaded http server simulating a package index You can use this server in unittest like this:: s = IndexServer() s.start() index_url = s.base_url() + 'mytestindex' # do some test requests to the index # The index files should be located in setuptools/tests/indexes s.stop() �� r c C s t jj�| ||� d| _d S �NT)�http�server� HTTPServer�__init__�_run��self�server_address�RequestHandlerClass� r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/server.pyr s zIndexServer.__init__c C s t j| jd�| _| j�� d S )N)�target)� threading�Thread� serve_forever�thread�start�r r r r r s zIndexServer.startc C s* t �d� | �� | j�� | j�� dS )zStop the serverg�������?N)�time�sleep�shutdownr �join�socket�closer r r r �stop# s zIndexServer.stopc C s | j }d|� d�S )Nzhttp://127.0.0.1:z/setuptools/tests/indexes/�� server_port)r �portr r r �base_url- s zIndexServer.base_urlN) �__name__� __module__� __qualname__�__doc__r r �SimpleHTTPRequestHandlerr r r r" r r r r r s � r c @ s e Zd Zdd� ZdS )�RequestRecorderc C s, t | j��dg �}|�| � | �dd� d S )N�requests�� �OK)�varsr � setdefault�append� send_response)r r) r r r �do_GET3 s zRequestRecorder.do_GETN)r# r$ r% r0 r r r r r( 2 s r( c @ s> e Zd ZdZdefdd�Zdd� Zedd� �Zed d � �Z d S ) � MockServerzD A simple HTTP Server that records the requests made to it. r c C s. t jj�| ||� tj�| � d| _g | _d S r )r r r r r r �daemonr) r r r r r > s zMockServer.__init__c C s | � � d S �N)r r r r r �runD s zMockServer.runc C s d| j � �S )Nz localhost:r r r r r �netlocG s zMockServer.netlocc C s d| j � d�S )Nzhttp://�/)r5 r r r r �urlK s zMockServer.urlN) r# r$ r% r& r( r r4 �propertyr5 r7 r r r r r1 9 s r1 c C sB t j�t j�| ��} d}|dur|d| 7 }tj�|tj�| ��S )z Convert a path to a file: URL.zfile:Nz//) �os�path�normpath�abspath�urllib�parse�urljoin�request� pathname2url)r: � authority�baser r r � path_to_urlP s rD r3 )r& � http.serverr r9 r r � urllib.parser= �urllib.requestr r r �BaseHTTPRequestHandlerr( r r1 rD r r r r �<module> s ' tests/__pycache__/test_distutils_adoption.cpython-310.pyc 0000644 00000013003 15030122015 0017561 0 ustar 00 o �hc � @ sn d dl Z d dlZd dlZd dlZd dlZdejv Zddd�Zdd� Zd3d d �Z d4d d �Z ej j ej d kdd�Zedd� �Zdd� Zej jddd�dd� �Zdd� Zdd� Zd Zej �d �ej �d ejd d ed!�ejd d"ed!�ejd d#ed!�d$d%d&g�d'd(� ��Zd)Zej �d �ej �d*d+ejd ed!�g�d,d-� ��Zd.Z ej �d �ej �d d/ejd d0ed!�g�d1d2� ��Z dS )5� N�__pypy__Tzutf-8)�text�encodingc C s" | rt �� dkrtjd | d< | S )z� On Windows, SYSTEMROOT must be present to avoid > Fatal Python error: _Py_HashRandomization_Init: failed to > get random numbers to initialize Python �Windows� SYSTEMROOT)�platform�system�os�environ��env� r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_distutils_adoption.py�win_sr s r � distutilsc K s: dj di t� ��}dd|g}| j|fdt|�it�|��S )Nz+import {imports}; print(distutils.__file__)�python�-cr r )�format�locals�runr � _TEXT_KWARGS)�venv�importsr �kwargs�py_cmd�cmdr r r �find_distutils s r c C s2 t �d�}dd|g}t| j|fdt|�it���S )Nz� import sys is_distutils = lambda finder: finder.__class__.__name__ == "DistutilsMetaFinder" print(len(list(filter(is_distutils, sys.meta_path)))) r r r )�textwrap�dedent�intr r r )r r r r r r r �count_meta_path s � r )� � z-stdlib distutils is removed from Python 3.12+)�reasonc C s@ t dd�}| jt| |d��tj�vsJ �t| |d�dks J �dS )z; Ensure stdlib distutils is used when appropriate. �stdlib��SETUPTOOLS_USE_DISTUTILSr r N��dict�namer �splitr �sepr �r r r r r �test_distutils_stdlib1 s r- c C sF t dd�}t| d|d�}| j|�tj�v sJ �t| |d�dks!J �dS )z: Ensure local distutils is used when appropriate. �localr% zsetuptools, distutils)r r r � N)r( r r) r* r r+ r )r r �locr r r �$test_distutils_local_with_setuptools; s r1 �IS_PYPYz!pypy imports distutils on startupc C s@ t dd�}| jt| |d��tj�v sJ �t| |d�dks J �dS )zZ Even without importing, the setuptools-local copy of distutils is preferred. r. r% r r/ Nr' r, r r r �test_distutils_localE s r3 c C s g d�}| j |fi t�� dS )zD Ensure pip can be imported. Regression test for #3002. )r r z import pipN)r r )r r r r r �test_pip_importP s r4 c C s t d�jjsJ �dS )z= Distutils module spec should have an origin. #2990. r N)� __import__�__spec__�originr r r r �test_distutils_has_originY s r8 a8 # Depending on the importlib machinery and _distutils_hack, some imports are # duplicated resulting in different module objects being loaded, which prevents # patches as shown in #3042. # This script provides a way of verifying if this duplication is happening. from distutils import cmd import distutils.command.sdist as sdist # import last to prevent caching from distutils import {imported_module} for mod in (cmd, sdist): assert mod.{imported_module} == {imported_module}, ( f"\n{{mod.dir_util}}\n!=\n{{{imported_module}}}" ) print("success") � tmpdir_cwd)�distutils_version�imported_moduler$ �dir_util)�marks� file_util� archive_util)r. r< )r. r> )r. r? c C sN t | d�}tj|d�}dd|g}|j|fdt|�it���� }|dks%J �d S )Nr% �r; r r r �success)r( �!ENSURE_IMPORTS_ARE_NOT_DUPLICATEDr r r r �strip)r: r; r r �scriptr �outputr r r �)test_modules_are_not_duplicated_on_importu s rF z� import types import distutils.dist as dist from distutils import log if isinstance(dist.log, types.ModuleType): assert dist.log == log, f"\n{dist.log}\n!=\n{log}" print("success") r: r. c C sB t | d�}ddtg}|j|fdt|�it���� }|dks J �d S )Nr% r r r rA )r( �#ENSURE_LOG_IMPORT_IS_NOT_DUPLICATEDr r r rC )r: r r r rE r r r �+test_log_module_is_not_duplicated_on_import� s rH z� from setuptools.modified import newer from {imported_module}.errors import DistutilsError # Can't use pytest.raises in this context try: newer("", "") except DistutilsError: print("success") else: raise AssertionError("Expected to raise") )r. r zsetuptools._distutilsc C sJ t | d�}ddtj|d�g}|j|fdt|�it���� }|dks#J �d S )Nr% r r r@ r rA )r( �(ENSURE_CONSISTENT_ERROR_FROM_MODIFIED_PYr r r r rC )r: r; r r r rE r r r �&test_consistent_error_from_modified_py� s �� rJ )r N)N) r r �sysr �pytest�builtin_module_namesr2 r r r r �mark�skipif� version_info� skip_without_stdlib_distutilsr- r1 �xfailr3 r4 r8 rB � usefixtures� parametrize�paramrF rG rH rI rJ r r r r �<module> sl � �� �� ��� tests/__pycache__/test_build.cpython-310.pyc 0000644 00000002571 15030122015 0014747 0 ustar 00 o �h � @ s@ d dl mZ d dlmZ d dlmZ dd� ZG dd� de�ZdS ) � )�Command)�build)� Distributionc C s4 t tddgg ddgid��}t|�d�t�sJ �dS )z_ Check that the setuptools Distribution uses the setuptools specific build object. zsetup.pyr � zpath/*)� script_name� script_args�packages� package_dataN)r �dict� isinstance�get_command_objr )� tmpdir_cwd�dist� r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_build.py�,test_distribution_gives_setuptools_build_obj s ��r c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � Subcommandz!Dummy command to be used in testsc C � d S �Nr ��selfr r r �initialize_options � z Subcommand.initialize_optionsc C r r r r r r r �finalize_options r zSubcommand.finalize_optionsc C s t d��)Nz!just to check if the command runs)�NotImplementedErrorr r r r �run s zSubcommand.runN)�__name__� __module__� __qualname__�__doc__r r r r r r r r s r N)� setuptoolsr �setuptools.command.buildr �setuptools.distr r r r r r r �<module> s tests/__pycache__/__init__.cpython-310.pyc 0000644 00000000734 15030122015 0014347 0 ustar 00 o �hO � @ sX d dl Z d dlZd dlZdgZejdkre �� Zne �d�ZedkZej j edd�Z dS )� N� fail_on_ascii)� � FzANSI_X3.4-1968zTest fails in this locale)�reason) �locale�sys�pytest�__all__� version_info� getencoding�locale_encoding�getpreferredencoding�is_ascii�mark�xfailr � r r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/__init__.py�<module> s tests/__pycache__/test_namespaces.cpython-310.pyc 0000644 00000006651 15030122015 0015772 0 ustar 00 o �h� � @ s: d dl Z d dlZd dlmZ ddlmZ G dd� d�ZdS )� N)�paths_on_pythonpath� )� namespacesc @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) �TestNamespacesc C s� t �|d�}t �|d�}|d }|d }||f}tjdddt|�dt|�g}t�|� t �|� tjdddt|�dt|�g}t�|� tjd d g}tt t|��� t�|� W d � d S 1 saw Y d S ) z� Installing two packages sharing the same namespace, one installed to a site dir and the other installed just to a path on PYTHONPATH should leave the namespace in tact and both packages reachable by import. � myns.pkgA� myns.pkgBz site-packagesz path-packages�-m� pip.__main__�install�-t�-cz"import myns.pkgA; import myns.pkgBN) r �build_namespace_package�sys� executable�str� subprocess� check_call� make_site_dirr �map) �self�tmpdir�pkg_A�pkg_B� site_packages� path_packages�targets� install_cmd� try_import� r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_namespaces.py� test_mixed_site_and_non_site s> � � � "�z+TestNamespaces.test_mixed_site_and_non_sitec C s� t �|d�}|d }|�� tjddddt|�t|�g}tt|�g�� t�|� W d � n1 s3w Y t � |� tjdd g}tt|�g�� t�|� W d � dS 1 s[w Y dS ) zc Ensure that a namespace package doesn't break on import of pkg_resources. r �packagesr �pipr r Nr zimport pkg_resources) r r �mkdirr r r r r r r )r r �pkg�targetr r r r r �test_pkg_resources_import4 s, � � � "�z(TestNamespaces.test_pkg_resources_importc C s� t �|d�}|d }tjdddt|�dt|�g}t�|� t �|� tjddg}tt|�g�� tj|t|�d � W d � d S 1 sDw Y d S ) z� Installing a namespace packages but also having it in the current working directory, only one version should take precedence. r r! r r r r r z&import pkg_resources; import myns.pkgA��cwdN� r r r r r r r r r )r r r r% r �pkg_resources_impr r r �(test_namespace_package_installed_and_cwdP s& � �"�z7TestNamespaces.test_namespace_package_installed_and_cwdc C s� t �|d�}t �|d�}|d }tjdddt|�dt|�g}t�|� t �|� tjdd g}tt|�g�� tj|t|�d � W d � d S 1 sJw Y d S ) z� Installing one namespace package and also have another in the same namespace in the current working directory, both of them must be importable. r r r! r r r r r z8import pkg_resources; import myns.pkgA; import myns.pkgBr' Nr) )r r r r r% r r* r r r �5test_packages_in_the_same_namespace_installed_and_cwdm s( � �"�zDTestNamespaces.test_packages_in_the_same_namespace_installed_and_cwdN)�__name__� __module__� __qualname__r r& r+ r, r r r r r s * r )r r �setuptools._pathr � r r r r r r �<module> s tests/__pycache__/test_warnings.cpython-310.pyc 0000644 00000006224 15030122015 0015477 0 ustar 00 o �h � @ s� d dl mZ d dlZd dlmZmZ eddddd�d d �ed d d idd �ed ddd�dd �d�Zej� de� � �dd� �Z dd� Z dd� Z dS )� )�cleandocN)� SetuptoolsDeprecationWarning�SetuptoolsWarning)z Hello {x}z {target} {v:.1f}� � �World)�x�v�targetz� Hello 5 !! ******************************************************************************** World 3.0 ******************************************************************************** !! )�args�kwargs�expected)�Summary� Lorem ipsum�due_date)i' � � a� Summary !! ******************************************************************************** Lorem ipsum By 9999-Nov-22, you need to update your project and remove deprecated calls or your builds will no longer be supported. ******************************************************************************** !! �i� r r �some_page.html)r �see_docs�� Summary !! ******************************************************************************** Lorem ipsum This deprecation is overdue, please update your project and remove deprecated calls to avoid build errors in the future. See https://setuptools.pypa.io/en/latest/some_page.html for details. ******************************************************************************** !! )�default�futue_due_date�past_due_date_with_docs� example_namec C s� t | d }t | d }t | d }| �dd� t�t��}tj|i |�� W d � n1 s0w Y t|�t|�ks?J �dS )z] It should automatically handle indentation, interpolation and things like due date. r r r � SETUPTOOLS_ENFORCE_DEPRECATION�falseN)� _EXAMPLES�setenv�pytest�warnsr �emit� _get_messager )� monkeypatchr r r r � warn_info� r% �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_warnings.py�test_formatting= s �r' c C sl G dd� dt �}| �dd� t�t �� }|�� W d � n1 s"w Y d}t|j�t|�ks4J �d S )Nc @ s e Zd ZdZdZdZdZdS )z1test_due_date_enforcement.<locals>._MyDeprecationr r r r N)�__name__� __module__� __qualname__�_SUMMARY�_DETAILS� _DUE_DATE� _SEE_DOCSr% r% r% r& �_MyDeprecationM s r/ r �truer )r r r �raisesr! �str�valuer )r# r/ �exc_infor r% r% r& �test_due_date_enforcementL s �r5 c C s t dd� | D ��S )Nc s s � | ] }|j jd V qdS )r N)�messager )�.0�warnr% r% r& � <genexpr>j s � z _get_message.<locals>.<genexpr>)�next)r$ r% r% r& r" i s r" )�inspectr r �setuptools.warningsr r �dictr �mark� parametrize�keysr' r5 r" r% r% r% r& �<module> s. ����6 tests/__pycache__/test_build_ext.cpython-310.pyc 0000644 00000022252 15030122015 0015625 0 ustar 00 o �hs' � @ s� d dl mZ d dlZd dlZd dlmZ d dlZd dlm Z d dl m Z m Z d dl mZ d dlmZ d dlmZ d d lmZ d d lmZ d dlm m Z d d lmZ d ej v Z G dd� d�Z G dd� d�Z dd� Z dS )� )� annotationsN)�cache_from_source)�path)� build_ext�get_abi3_suffix)� Distribution)� CompileError)� Extension� )� environment)�DALS)�get_config_var�__pypy__c @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )� TestBuildExtc C s@ t � }t|�}d|jd< |�d�}tj�|d�}||ks J �dS )z� Setuptools needs to give back the same result as distutils, even if the fullname is not in ext_map. � zfoo/bar�fooN)r r �ext_map�get_ext_filename�orig)�self�dist�cmd�res�wanted� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_build_ext.py�test_get_ext_filename s z"TestBuildExt.test_get_ext_filenamec C s� t t� � tddgdd�}tt|gd��}t|�}|�� d|jv s$J �|�d�}t� s7|� t d��s5J �d S t j dkrE|� d�sCJ �d S d |v sKJ �d S ) z} Filename needs to be loadable by several versions of Python 3 if 'is_abi3' is truthy on Extension() � spam.eggs�eggs.cT��py_limited_api�� ext_modules� EXT_SUFFIX�win32zeggs.pyd�abi3N) �printr r r �dictr �finalize_optionsr r �endswithr �sys�platform)r � extensionr r r r r r �test_abi3_filename& s z TestBuildExt.test_abi3_filenamec C s� t � }t|�}tddgdd� |jd< }d|_ts |�d�}nd}z"dtjd< |�d �}d |ks2J �|�d�}||ks=J �W tjd= d S tjd= w ) zd SETUPTOOLS_EXT_SUFFIX variable always overrides default extension options. �for_abi3zs.cTr Fzfor_abi3.test-suffixz .test-suffix�SETUPTOOLS_EXT_SUFFIX�normalznormal.test-suffixN) r r r r �_links_to_dynamic�IS_PYPYr �os�environ)r r r �ext�expectr r r r �test_ext_suffix_override; s$ � z%TestBuildExt.test_ext_suffix_overridec C sf ddddiiidddiid�}t dd g�}t d d g�}t d d g�}t�|� td|||gddid��S )N�mypkg�subpkgzext2.cr �ext1zmain.c)�srcz c-extensionsz mypkg.ext1zc-extensions/ext1/main.czmypkg.subpkg.ext2zsrc/mypkg/subpkg/ext2.c�ext3zc-extension/ext3.cz%test%r; )� script_namer" � package_dir)r r �buildr )r �filesr: �ext2r< r r r �dist_with_example[ s � �z TestBuildExt.dist_with_examplec C s� |� dd� |�dd� | �� }|�d�}d|_|�� |j�tj d�}dd� |� � D �}||� d �|� d �|� d �gks?J �|� � i ksGJ �|� d� d |_|�� d d� |� � � � D �}||� d �d|� d �d|� d �dikssJ �d S )Nr/ �.mp3�&setuptools.command.build_ext.use_stubsFr �/c S s g | ] }|� tjd ��qS �rE ��replacer3 �sep)�.0�xr r r � <listcomp>v s z1TestBuildExt.test_get_outputs.<locals>.<listcomp>� /ext3.mp3�/mypkg/ext1.mp3�/mypkg/subpkg/ext2.mp3Tc S �* i | ]\}}|� tjd �|� tjd ��qS rF rG �rJ �k�vr r r � <dictcomp>� � ��z1TestBuildExt.test_get_outputs.<locals>.<dictcomp>� src/ext3.mp3�src/mypkg/ext1.mp3�src/mypkg/subpkg/ext2.mp3)�setenv�setattrrB �get_command_obj� editable_mode�ensure_finalized� build_librH r3 rI � get_outputs�get_output_mapping�reinitialize_command�items)r � tmpdir_cwd� monkeypatchr r r^ �outputs�mappingr r r �test_get_outputsl s2 � � �z TestBuildExt.test_get_outputsc C sD |� dd� |�dd� | �� }|�d�}d|_|�� |jD ] }|�|dd� q |j�t j d�}dd � |� � � � D �}d d � }|||� d ��|d �|� d�d||� d��|d�|� d�d||� d��|d�|� d�dikspJ �|� d�|vsyJ �|� d�|vs�J �||� d��} | |v s�J �| � |� d��s�J �| �d�s�J �d S )Nr/ rC rD Tr � _needs_stubrE c S rP rF rG rQ r r r rT � rU zBTestBuildExt.test_get_output_mapping_with_stub.<locals>.<dictcomp>c S s t | ��tjd�S )zDMake it possible to do comparisons and tests in a OS-independent wayrE )�_compiled_file_namerH r3 rI )�filer r r �C� s z9TestBuildExt.test_get_output_mapping_with_stub.<locals>.Cz/ext3.pyz src/ext3.pyrM rV z/mypkg/ext1.pyzsrc/mypkg/ext1.pyrN rW z/mypkg/subpkg/ext2.pyzsrc/mypkg/subpkg/ext2.pyrO rX z/mypkg/__pycache__/ext1z.pyc)rY rZ rB r[ r\ r] � extensionsr^ rH r3 rI r` rb � startswithr) ) r rc rd r r r5 r^ rf rk � example_stubr r r �!test_get_output_mapping_with_stub� s6 � � z.TestBuildExt.test_get_output_mapping_with_stubN) �__name__� __module__� __qualname__r r- r7 rB rg ro r r r r r s r c @ s. e Zd Zddd�Zdd� Zd d � Zd d � Zd S )�TestBuildExtInplace�optional�bool�returnr c K sn di i d�d�}t �|� tddg|d�}tt|gd��}d|_t|�}t|�jd d d d �|�� |� � |S ) Nz#include missingheader.h )�lib�tmp)r z.buildr r )rt r! �setup.pyz .build/libz .build/tmp)r^ � build_tempr ) r r? r r r' r= r �vars�updater] )r rt �optsr@ r, r r r r r �get_build_ext_cmd� s � z%TestBuildExtInplace.get_build_ext_cmdc C s" |� � }|j�� |j�� |j S )z� Historically, distutils "logged" by printing to sys.std*. Later versions adopted the logging framework. Grab messages regardless of how they were captured. )� readouterr�out� splitlines�err�messages)r �caplog�capsys�stdr r r �get_log_messages� s z$TestBuildExtInplace.get_log_messagesc C s8 | j ddd�}|�� tdd� | �||�D ��sJ �dS )z� If optional extensions fail to build, setuptools should show the error in the logs but not fail to build T�rt �inplacec s s � | ]}d V qdS )z0build_ext: building extension "spam.eggs" failedNr )rJ �msgr r r � <genexpr>� s � � �z4TestBuildExtInplace.test_optional.<locals>.<genexpr>N)r~ �run�anyr� )r rc r� r� r r r r � test_optional� s �z!TestBuildExtInplace.test_optionalc C sF | j ddd�}t�t�� |�� W d � d S 1 s w Y d S )NFTr� )r~ �pytest�raisesr r� )r rc r r r r �test_non_optional� s "�z%TestBuildExtInplace.test_non_optionalN)rt ru rv r )rp rq rr r~ r� r� r� r r r r rs � s rs c C sZ t d�t d�t d�d�}t�|� tjdgdd�\}\}}|dks+J d |� d |� ���d S ) Nz� from setuptools import Extension, setup setup( name='foo', version='0.0.0', ext_modules=[Extension('foo', ['foo.c'])], ) a� #include "Python.h" #if PY_MAJOR_VERSION >= 3 static struct PyModuleDef moduledef = { PyModuleDef_HEAD_INIT, "foo", NULL, 0, NULL, NULL, NULL, NULL, NULL }; #define INITERROR return NULL PyMODINIT_FUNC PyInit_foo(void) #else #define INITERROR return void initfoo(void) #endif { #if PY_MAJOR_VERSION >= 3 PyObject *module = PyModule_Create(&moduledef); #else PyObject *module = Py_InitModule("extension", NULL); #endif if (module == NULL) INITERROR; #if PY_MAJOR_VERSION >= 3 return module; #endif } zD [build] build_base = foo_build )ry zfoo.cz setup.cfgr? )r � )r � data_streamr z STDOUT: z STDERR: )r r r? r � run_setup_py)rc r@ �code�stdout�stderrr r r � test_build_ext_config_handling� s � �+�� =� r� )!� __future__r r3 r* �importlib.utilr ri r� �jaracor � setuptools.command.build_extr r �setuptools.distr �setuptools.errorsr �setuptools.extensionr r r �textwrapr �distutils.command.build_ext�commandr �distutils.sysconfigr �builtin_module_namesr2 r rs r� r r r r �<module> s& , tests/__pycache__/test_bdist_egg.cpython-310.pyc 0000644 00000004512 15030122015 0015574 0 ustar 00 o �h� � @ s` d Z ddlZddlZddlZddlZddlmZ ddlmZ dZ ej dd� �Z G d d � d �Z dS ) z develop tests� N)� Distribution� )�contextsz7from setuptools import setup setup(py_modules=['hi']) c c s� � | d � d�� }|�t� W d � n1 sw Y | d � d�� }|�d� W d � n1 s4w Y | �� � | V W d � d S 1 sLw Y d S )N�setup.py�w�hi.pyz1 )�open�write�SETUP_PY�as_cwd)�tmpdir�f� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_bdist_egg.py� setup_context s � � � "�r c @ sf e Zd Zej�d�ej�d�dd� ��Zejjej � dd�dd�ej�d�ej�d�d d � ���Z d S ) �Test� user_overrider c C s� t tddgddgd��}t�tj�dd�� t�� � |�� |� � W d � n1 s-w Y t� d�\}t � d |�s@J �d S ) Nr � bdist_egg�foo�hi)� script_name� script_args�name� py_modules�build�src�distzfoo-0.0.0-py[23].\d+.egg$) r �dict�os�makedirs�path�joinr �quiet�parse_command_line� run_commands�listdir�re�match)�selfr �contentr r r �test_bdist_egg s �� � zTest.test_bdist_egg�PYTHONDONTWRITEBYTECODEFzByte code disabled)�reasonc C s� t tdddgdgd��}t�� � |�� |�� W d � n1 s#w Y t�d�\}tj� d|�}t � |�}t dd� |j D ��}d |v sJJ �d |vsPJ �d S ) Nr r z--exclude-source-filesr )r r r r c s s � | ]}|j V qd S )N)�filename)�.0�zir r r � <genexpr>G s � z1Test.test_exclude_source_files.<locals>.<genexpr>zhi.pycr )r r r r" r# r$ r r% r r! �zipfile�ZipFile�list�filelist)r( r � dist_name� dist_filename�zip�namesr r r �test_exclude_source_files3 s" �� � z Test.test_exclude_source_filesN) �__name__� __module__� __qualname__�pytest�mark� usefixturesr* �xfailr �environ�getr9 r r r r r s � r ) �__doc__r r& r1 r= �setuptools.distr � r r �fixturer r r r r r �<module> s tests/__pycache__/test_sandbox.cpython-310.pyc 0000644 00000014174 15030122015 0015310 0 ustar 00 o �h� � @ sL d Z ddlZddlZddlZddlZddlZG dd� d�ZG dd� d�ZdS )z develop tests� Nc @ s0 e Zd Zdd� Zedd� �Zdd� Zdd� Zd S ) � TestSandboxc C sB t j�t|��� | �tj� W d � d S 1 sw Y d S �N)� setuptools�sandbox�DirectorySandbox�str� _file_writer�os�devnull)�self�tmpdir� r �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_sandbox.py� test_devnull s "�zTestSandbox.test_devnullc s � fdd�}|S )Nc s> t � ddd��} | �d� W d � d S 1 sw Y d S )N�w�utf-8��encoding�xxx)�open�write)�f��pathr r �do_write s "�z*TestSandbox._file_writer.<locals>.do_writer )r r r r r r s zTestSandbox._file_writerc C s: t �td�}t�d�}tj�|t|�� |j dksJ �dS )zT It should be possible to execute a setup.py with a Byte Order Mark zscript-with-bom.py� namespace�passedN) � pkg_resources�resource_filename�__name__�types� ModuleTyper r � _execfile�vars�result)r �targetr r r r �test_setup_py_with_BOM s z"TestSandbox.test_setup_py_with_BOMc C sT |d }|� d�� }|�d� W d � n1 sw Y tj�t|�t� � d S )Nzsetup.py�wbs "degenerate script" )r r r r r" r �globals)r r �setup_py�streamr r r �test_setup_py_with_CRLF" s �z#TestSandbox.test_setup_py_with_CRLFN)r � __module__� __qualname__r � staticmethodr r& r+ r r r r r s r c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )�TestExceptionSaverc C s( t j�� � td��1 s w Y d S �N�details)r r �ExceptionSaver� ValueError�r r r r �test_exception_trapped* s �z)TestExceptionSaver.test_exception_trappedc C s| t j�� �}td��1 s w Y t�t�� }|�� W d � n1 s&w Y t|jt�s3J �t |j�dks<J �d S r0 ) r r r2 r3 �pytest�raises�resume� isinstance�valuer )r � saved_exc�caughtr r r �test_exception_resumed. s � �z)TestExceptionSaver.test_exception_resumedc C s| t d�}tj�� �}|�1 sw Y t�t �� }|�� W d � n1 s(w Y t|jt �s5J �|j|us<J �d S r0 ) r3 r r r2 r6 r7 r8 r9 r: )r �orig_excr; r< r r r � test_exception_reconstructed8 s � �z/TestExceptionSaver.test_exception_reconstructedc C s6 t j�� �}W d � n1 sw Y |�� d S r )r r r2 r8 )r r; r r r � test_no_exception_passes_quietlyD s � z3TestExceptionSaver.test_no_exception_passes_quietlyc C s� G dd� dt �}tj�� �}|d��1 sw Y t�tjj�� }|�� W d � n1 s0w Y t|j �dks>J �d S )Nc @ s e Zd ZdZdefdd�ZdS )zFTestExceptionSaver.test_unpickleable_exception.<locals>.CantPickleThisz:This Exception is unpickleable because it's not in globals�returnc S s d| j ��S )N�CantPickleThis)�argsr4 r r r �__repr__N s zOTestExceptionSaver.test_unpickleable_exception.<locals>.CantPickleThis.__repr__N)r r, r- �__doc__r rD r r r r rB K s rB �detailzCantPickleThis('detail',)) � Exceptionr r r2 r6 r7 �UnpickleableExceptionr8 r r: )r rB r; r< r r r �test_unpickleable_exceptionJ s � �z.TestExceptionSaver.test_unpickleable_exceptionc C s� G dd� dt �}t�tjj�� }tj�� � tj�� |�1 s w Y W d � n1 s/w Y |jj \}|dks?J �dS )z� As revealed in #440, an infinite recursion can occur if an unpickleable exception while setuptools is hidden. Ensure this doesn't happen. c @ s e Zd ZdZdS )zaTestExceptionSaver.test_unpickleable_exception_when_hiding_setuptools.<locals>.ExceptionUnderTestzE An unpickleable exception (not in globals). N)r r, r- rE r r r r �ExceptionUnderTest_ s rJ NzExceptionUnderTest()) rG r6 r7 r r rH � save_modules�hide_setuptoolsr: rC )r rJ r< �msgr r r �2test_unpickleable_exception_when_hiding_setuptoolsY s � � zETestExceptionSaver.test_unpickleable_exception_when_hiding_setuptoolsc C s dd� }t �tjj��=}tj�� �( tj�� tj�t|��� |� W d � n1 s-w Y W d � n1 s<w Y W d � n1 sKw Y |j j \}}}|dks]J �|dkscJ �|ddikskJ �t|j �}d|v svJ �d|v s|J �d |v s�J �dS ) z� When in a sandbox with setuptools hidden, a SandboxViolation should reflect a proper exception and not be wrapped in an UnpickleableException. c S s4 t dddd�� W d � dS 1 sw Y dS )z9Trigger a SandboxViolation by writing outside the sandbox�/etc/foor r r N)r r r r r � write_files s "�zVTestExceptionSaver.test_sandbox_violation_raised_hiding_setuptools.<locals>.write_fileNr )rO r r r z('/etc/foo', 'w')z{'encoding': 'utf-8'}) r6 r7 r r �SandboxViolationrK rL r r r: rC )r r rP r< �cmdrC �kwargsrM r r r �/test_sandbox_violation_raised_hiding_setuptoolsl s& �� �� � zBTestExceptionSaver.test_sandbox_violation_raised_hiding_setuptoolsN) r r, r- r5 r= r? r@ rI rN rT r r r r r/ ) s r/ ) rE r r r6 r �setuptools.sandboxr r r/ r r r r �<module> s tests/__pycache__/test_build_meta.cpython-310.pyc 0000644 00000067517 15030122015 0015770 0 ustar 00 o �h � � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z d dl m Z d dl mZmZ d dlmZ d dlZd dlmZ d dlmZ d dlmZ d d lmZ d Ze e� d d ��Z dej v Z ej!j"ej#dkore dd�Z$G dd� d�Z%G dd� de%�Z&G dd� de%�Z'ed�ed�d�ed�ed�d�ed �ed�d�d ed �ied �ed �d!�ed �d ed �d"�gZ(G d#d$� d$�Z)G d%d&� d&e)�Z*ej!�+d'�d(d)� �Z,d*d+� Z-dS ),� N)�futures)�Path)�Any�Callable)�ZipFile)�path)� Requirement)� SetuptoolsDeprecationWarning� )�DALSz __import__('setuptools').setup()�TIMEOUT_BACKEND_TEST�180�__pypy__�win32z_The combination of PyPy + Windows + pytest-xdist + ProcessPoolExecutor is flaky and problematic)�reasonc @ s e Zd Zddd�ZdS )�BuildBackendBase�.N�setuptools.build_metac C s || _ |pi | _|| _d S )N)�cwd�env� backend_name)�selfr r r � r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_build_meta.py�__init__& s zBuildBackendBase.__init__)r Nr )�__name__� __module__� __qualname__r r r r r r % s r c sB e Zd ZdZ� fdd�Zdededef fdd�Zd d � Z � Z S ) � BuildBackendzPEP 517 Build Backendc s$ t � j|i |�� tjdd�| _d S )Nr )� max_workers)�superr r �ProcessPoolExecutor�pool)r �args�kwargs�� __class__r r r / s zBuildBackend.__init__�name�return.c s � �fdd�}|S )�<Handles arbitrary function invocations on the build backend.c s� t j��j�}t|�j�j�}d }z �j�t j �� t �}�jj|� g| �R i |��� t �W S t j yM �jjdd� ��|� t�dt � d�� Y d S t jjttfy` tr_t�d� � w )NF)�waitz(Backend did not respond before timeout (z s)z3PyPy frequently fails tests with ProcessPoolExector)�osr �abspathr �BuildBackendCallerr r r" �submit�getpid�result�TIMEOUTr � TimeoutError�shutdown�_kill�pytest�xfail�process�BrokenProcessPool� MemoryError�OSError�IS_PYPY)r# �kw�root�caller�pid�r' r r r �method6 s $ �z(BuildBackend.__getattr__.<locals>.methodr )r r' rA r r@ r � __getattr__3 s zBuildBackend.__getattr__c C s\ |d u rd S t �tt�� t�|tjdkrtjntj � W d � d S 1 s'w Y d S )N�nt) � contextlib�suppress�ProcessLookupErrorr: r+ �killr' �signal�SIGTERM�SIGKILL)r r? r r r r4 H s "�zBuildBackend._kill) r r r �__doc__r �strr r rB r4 � __classcell__r r r% r r , s r c s$ e Zd Z� fdd�Zdd� Z� ZS )r- c s, t � j|i |�� | j�d�\| _}| _d S )N�:)r r r � partition� backend_obj)r r# r$ �_r% r r r P s zBuildBackendCaller.__init__c O sR t �| j� t j�| j� t�| j�}| j r t || j �}n|}t ||�|i |��S )r) ) r+ �chdirr �environ�updater � importlib� import_moduler rP �getattr)r r' r# r< �mod�backendr r r �__call__U s zBuildBackendCaller.__call__)r r r r rZ rM r r r% r r- O s r- z� __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) �C def run(): print('hello') ��setup.py�hello.pyz� assert __name__ == '__main__' __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) aF variable = True def function(): return variable assert variable __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) r] a� # Some packages construct files on the fly, include them in the package, # and immediately remove them after `setup()` (e.g. pybind11==2.9.1). # Therefore, we cannot use `distutils.core.run_setup(..., stop_after=...)` # to obtain a distribution object first, and then run the distutils # commands later, because these files will be removed in the meantime. with open('world.py', 'w', encoding="utf-8") as f: f.write('x = 42') try: __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['world'], setup_requires=['six'], ) finally: # Some packages will clean temporary files __import__('os').unlink('world.py') z� [metadata] name = foo version = 0.0.0 [options] py_modules=hello setup_requires=six z7 def run(): print('hello') )� setup.cfgr^ )r_ r] r^ c @ s e Zd ZdZdd� Zejed�dd� �Zdd� Z d d � Z d d � Z ej � d d�dd� �Zej � ddeg�dd� �Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zed)�d*ed+�d,�Z d-d.� Z ed/�d0d1d2iid3�Z d4d5� Z d6d7� Z d8d9� Z!ej � d:d;d<ig�d=d>� �Z"ej � d?d@dAgfdBdAgfdCdAgfdDdAgfdEdAdFgfdGdAgfdHdAgfdIdJgfdKdAdFgfdLdAdFgfdMdAdFgfg �ej � dNdOdPg�dQdR� ��Z#dSdT� Z$dUdV� Z%dWedX�iZ&dYdZ� Z'dWed[�iZ(d\d]� Z)ej � d^d_�d`da� �Z*dS )b�TestBuildMetaBackendr c C s t | jd�S )N�r )r r )r r r r �get_build_backend� s z&TestBuildMetaBackend.get_build_backend)�paramsc c sN � t j|jt|�d� |�� � | �� V W d � d S 1 s w Y d S )N)�prefix)r �build�paramrL �as_cwdrb )r �tmpdir�requestr r r � build_backend� s � "�z"TestBuildMetaBackend.build_backendc C �& |� � }dg}t|�t|�ksJ �d S �N�six)� get_requires_for_build_wheel�sorted�r rj �actual�expectedr r r �!test_get_requires_for_build_wheel� � z6TestBuildMetaBackend.test_get_requires_for_build_wheelc C rk rl )� get_requires_for_build_sdistro rp r r r �!test_get_requires_for_build_sdist� rt z6TestBuildMetaBackend.test_get_requires_for_build_sdistc C s� t j�d�}t �|� |�|�}t j�||�}t j�|�s J �t j�d�r'J �t|��}t|� � �}W d � n1 s<w Y dd� |D �}dd� |D �}t |�dksWJ �d S )Nz pip-wheel�world.pyc s s � | ] }|� d �r|V qdS )z.pyN��endswith��.0�fr r r � <genexpr> s � z8TestBuildMetaBackend.test_build_wheel.<locals>.<genexpr>c S s g | ] }|� d �s|�qS )r] rx rz r r r � <listcomp> s z9TestBuildMetaBackend.test_build_wheel.<locals>.<listcomp>r ) r+ r r, �makedirs� build_wheel�join�isfiler �set�namelist�len) r rj �dist_dir� wheel_name� wheel_file�zipfile�wheel_contents�python_scripts�modulesr r r �test_build_wheel� s �z%TestBuildMetaBackend.test_build_wheel� build_type)�wheel�sdistc C s ddt d�t d�d�}t�|� tj�d| �}| �� }t|d| �}||�}tdd d d �� }|�d � W d � n1 s>w Y ||�} tj� tj� ||��sTJ �|| ksZJ �ttj� || �d �� � ||�} | | kspJ �tj� tj� || ��dksJ �d S )Nz$from setuptools import setup setup()z0.0.1zo [metadata] name = foo version = file: VERSION �� [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" )r] �VERSIONr_ �pyproject.tomlz preexisting-�build_r� �wt�utf-8��encodingz0.0.2�wbr ) r r re r+ r, rb rW �open�writer� r� �close�getsize) r r� � tmpdir_cwd�filesr� rj � build_method� first_result� version_file� second_result� third_resultr r r �%test_build_with_existing_file_present s0 ��� � "z:TestBuildMetaBackend.test_build_with_existing_file_present� setup_scriptNc C s t d�t d�dddddddd d �id �}|r||d < | �� }|�� �; t�|� d dg}t�� � |D ] }t�d|t� q3|� d�}|� d�}W d � n1 sQw Y W d � n1 s`w Y t � t j�|d|���} t| �� �} W d � n1 s�w Y tt j�|d|���&} t| �� �} t| �d�d�} t| �d�d�}t| �d�d�}W d � n1 s�w Y | dh h d�ks�J �| h d�ks�J �|dks�J �ddddd d ttd �� d ttd �� fD ] }|| v s�J || f��q�| �� �d��sJ �|�� d k�s J �d S )!Naj [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "foo" license = {text = "MIT"} description = "This is a Python package" dynamic = ["version", "readme"] classifiers = [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers" ] urls = {Homepage = "http://github.com"} dependencies = [ "appdirs", ] [project.optional-dependencies] all = [ "tomli>=1", "pyscaffold>=4,<5", 'importlib; python_version == "2.6"', ] [project.scripts] foo = "foo.cli:main" [tool.setuptools] zip-safe = false package-dir = {"" = "src"} packages = {find = {where = ["src"]}} license-files = ["LICENSE*"] [tool.setuptools.dynamic] version = {attr = "foo.__version__"} readme = {file = "README.rst"} [tool.distutils.sdist] formats = "gztar" zd global-include *.py *.txt global-exclude *.py[cod] zThis is a ``README``z!---- placeholder MIT license ----�fooz__version__ = '0.1'z__version__: strz def main(): print('hello world')� )� __init__.pyz __init__.pyizcli.pyzdata.txtzpy.typed)r� � MANIFEST.inz README.rstz LICENSE.txt�srcr] zQ'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'z/`project.license` as a TOML table is deprecated�ignore�temp�foo-0.1.dist-info/METADATAr� �&foo-0.1.dist-info/licenses/LICENSE.txt�"foo-0.1.dist-info/entry_points.txtzfoo-0.1/setup.py> �foo-0.1� foo-0.1/src�foo-0.1/src/foo�foo-0.1/PKG-INFO�foo-0.1/setup.cfg�foo-0.1/README.rst�foo-0.1/LICENSE.txt�foo-0.1/MANIFEST.in�foo-0.1/pyproject.toml�foo-0.1/src/foo/cli.py�foo-0.1/src/foo.egg-info�foo-0.1/src/foo/data.txt�foo-0.1/src/foo/py.typed�foo-0.1/src/foo/__init__.py� foo-0.1/src/foo/__init__.pyi�!foo-0.1/src/foo.egg-info/PKG-INFO�$foo-0.1/src/foo.egg-info/SOURCES.txt�%foo-0.1/src/foo.egg-info/not-zip-safe�%foo-0.1/src/foo.egg-info/requires.txt�&foo-0.1/src/foo.egg-info/top_level.txt�)foo-0.1/src/foo.egg-info/entry_points.txt�-foo-0.1/src/foo.egg-info/dependency_links.txt> � foo/cli.py� foo/data.txt� foo/py.typed�foo/__init__.py�foo/__init__.pyi�foo-0.1.dist-info/WHEEL�foo-0.1.dist-info/RECORD� foo-0.1.dist-info/top_level.txtr� r� r� z!Summary: This is a Python packagez License: MITzLicense-File: LICENSE.txtz+Classifier: Intended Audience :: DeveloperszRequires-Dist: appdirszRequires-Dist: ztomli>=1 ; extra == "all"z2importlib; python_version=="2.6" and extra =="all"z$[console_scripts] foo = foo.cli:main)r rb rg r re �warnings�catch_warnings�filterwarningsr � build_sdistr� �tarfiler� r+ r� r� �getnamesr r� rL �readr �stripry )r rh r� r� rj �msgs�msg� sdist_pathr� �tar�sdist_contentsr� r� �metadata�license�epoints�liner r r � test_build_with_pyproject_config? sx �,����? � �� � � � � �� z5TestBuildMetaBackend.test_build_with_pyproject_configc C s� t d�t d�t d�d�}| �� }|�� � t�|� |�d�}|�d�}W d � n1 s.w Y |d �� s;J �|d �� sCJ �|d �� rKJ �|d �� rSJ �|d �� r[J �|d �� rcJ �|d �� rkJ �|d �� rsJ �t� t j� |d|��� }t |� d��� d�}|�� }d|vs�J �W d � n1 s�w Y tt j� |d|���} t | �d�d�} | �� }d|vs�J �W d � n1 s�w Y || fD ]} dD ]} | | v s�J �q�dD ]} | | vs�J �q�q�d S )NaR [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "foo" description = "This is a Python package" version = "42" dependencies = ["six"] zO def run(): print('hello') z� __import__('setuptools').setup( name='bar', version='13', ) )r� r^ r] r� ztemp/foo-42.tar.gzz temp/foo-42-py3-none-any.whlztemp/bar-13.tar.gzztemp/bar-42.tar.gzztemp/foo-13.tar.gzz temp/bar-13-py3-none-any.whlz temp/bar-42-py3-none-any.whlz temp/foo-13-py3-none-any.whlzfoo-42/PKG-INFOr� zbar-13/PKG-INFOzfoo-42.dist-info/METADATAzbar-13.dist-info/METADATA)z Name: fooz Version: 42)z Name: barz Version: 13)r rb rg r re r� r� �existsr� r� r+ r� rL � extractfiler� r� r r� ) r rh r� rj r� r� r� �pkg_info�membersr� r� �filer� r r r �(test_static_metadata_in_pyproject_config� sR � ��� � � � ��z=TestBuildMetaBackend.test_static_metadata_in_pyproject_configc C s> t j�d�}t �|� |�|�}t j�t j�||��s J �d S )Nz pip-sdist)r+ r r, r r� r� r� �r rj r� � sdist_namer r r �test_build_sdist s z%TestBuildMetaBackend.test_build_sdistc C s@ t j�d�}t �|� |�|�}t j�t j�||d��s J �d S )N� pip-dist-info�METADATA)r+ r r, r � prepare_metadata_for_build_wheelr� r� )r rj r� � dist_infor r r �%test_prepare_metadata_for_build_wheel s z:TestBuildMetaBackend.test_prepare_metadata_for_build_wheelc C s@ dD ] }t j|dd� q|�d�}t j�t j�|d��s J �dS )zy Some users might pass metadata_directory pre-populated with `.tox` or `.venv`. See issue #3523. )z?.tox/python/lib/python3.10/site-packages/attrs-22.1.0.dist-infozD.tox/python/lib/python3.10/site-packages/autocommand-2.2.1.dist-infoz>.nox/python/lib/python3.10/site-packages/build-0.8.0.dist-infoz4.venv/python3.10/site-packages/click-8.1.3.dist-infoz5venv/python3.10/site-packages/distlib-0.3.5.dist-infoz4env/python3.10/site-packages/docutils-0.19.dist-infoT)�exist_okr r� N)r+ r r� r r� r� )r rj � pre_existingr� r r r � test_prepare_metadata_inplace s z2TestBuildMetaBackend.test_prepare_metadata_inplacec C s4 t j�d�}|�|�}t j�t j�||��sJ �d S )N�dist)r+ r r, r� r� r� r� r r r � test_build_sdist_explicit_dist0 s z3TestBuildMetaBackend.test_build_sdist_explicit_distc C s t j�d�}t �|� |�|�}t j�t j�||��s J �t j�d�}t j�|�s/t j�d�}t|ddd�� }|� � }W d � n1 sEw Y t|ddd��}|� |� dd �� W d � n1 sew Y t � |� t �|� |�d�}t j�t j�t j�d�|��s�J �d S ) N� out_sdistr] r_ �rtr� r� r� zversion='0.0.0'zversion='0.0.1')r+ r r, r r� r� r� r� r� r� r� �replace�shutil�rmtree)r rj �sdist_into_directoryr� � setup_loc� file_handler�contentr r r � test_build_sdist_version_change7 s" � � &z4TestBuildMetaBackend.test_build_sdist_version_changec C s� t d�dt d�d�}t�|� | �� }|�d�}t�tj�d|���}t dd� |� � D ��s0J �W d � d S 1 s;w Y d S )N�� __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'] )r� r� )r] r^ r� r� c s � � | ]}d |v V qdS )r� Nr �r{ r' r r r r} g � � zNTestBuildMetaBackend.test_build_sdist_pyproject_toml_exists.<locals>.<genexpr>� r r re rb r� r� r� r+ r� �anyr� �r r� r� rj � targz_pathr� r r r �&test_build_sdist_pyproject_toml_existsP s ��� "�z;TestBuildMetaBackend.test_build_sdist_pyproject_toml_existsc C st t �td � | �� }|�d�}t�tj �d|���}t dd� |� � D ��s(J �W d � d S 1 s3w Y d S )Nr r� c s r� �r] Nr r r r r r} q r zHTestBuildMetaBackend.test_build_sdist_setup_py_exists.<locals>.<genexpr>) r re �defnsrb r� r� r� r+ r� r r� )r r� rj r r� r r r � test_build_sdist_setup_py_existsi s "�z5TestBuildMetaBackend.test_build_sdist_setup_py_existsc C s� t d�dt d�d�}t�|� | �� }|�d�}t�tj�d|���}t dd� |� � D ��r0J �W d � d S 1 s;w Y d S )Nz� __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'] )r� z" exclude setup.py )r] r^ r� r� c s r� r r r r r r r} � r zSTestBuildMetaBackend.test_build_sdist_setup_py_manifest_excluded.<locals>.<genexpr>r r r r r �+test_build_sdist_setup_py_manifest_excludeds s ��� "�z@TestBuildMetaBackend.test_build_sdist_setup_py_manifest_excludedc C s4 t d�dt d�d�}t�|� | �� }|�d� d S )Nr� r� zE [sdist] formats=zip �r] r^ r_ r� )r r re rb r� )r r� r� rj r r r �3test_build_sdist_builds_targz_even_if_zip_indicated� s ��� zHTestBuildMetaBackend.test_build_sdist_builds_targz_even_if_zip_indicatedz� __import__('setuptools').setup( name='foo', version=__import__('hello').__version__, py_modules=['hello'] )z__version__ = "0.0.0"z9 [sdist] formats=zip r c C sR t �| j� | �� }tjtdd�� |�d� W d � d S 1 s"w Y d S )Nz^No module named 'hello'$��matchr� )r re �_relative_path_import_filesrb r5 �raises� ImportErrorr� �r r� rj r r r �%test_build_sdist_relative_path_import� s "�z:TestBuildMetaBackend.test_build_sdist_relative_path_importzX [project] name = "proj" version = "42" �projr� r� )r� r� c C sD t t|��d��}|s J �|D ]}|�� s t�|�jdks J �qdS )z?All files in the directory should be either links or hard linksz**/*r N)�listr �glob� is_symlinkr+ �stat�st_nlink)r � parent_dirr� r� r r r �_assert_link_tree� s ��z&TestBuildMetaBackend._assert_link_treec C sB t �| j� | �� }td��� rJ �|�d� td��� r J �dS )z� Sanity check to ensure tests with --mode=strict are different from the ones without --mode. --mode=strict should create a local directory with a package tree. The directory should not get created otherwise. re r� N)r re �_simple_pyproject_examplerb r r� �build_editabler r r r �%test_editable_without_config_settings� s z:TestBuildMetaBackend.test_editable_without_config_settingsc C sh dddgi}t �| j� | �� }td��� rJ �td��� |�d|� |�d|� td��� s2J �d S )Nz--build-option� build_extz --inplacere z build/proj-42-py3-none-any.whl) r re r rb r r� �mkdirr� r� �r r� �config_settingsrj r r r �test_build_wheel_inplace� s z-TestBuildMetaBackend.test_build_wheel_inplacer" z editable-mode�strictc C sf t �i | j�di i�� td��� rJ �| �� }|�d|� |�d|d� | �t td�� d��� d S )N�_metare r� z__editable__.*) r re r r r� rb �#prepare_metadata_for_build_editabler r �nextr r! r r r �"test_editable_with_config_settings� s z7TestBuildMetaBackend.test_editable_with_config_settings)� setup_literal� requirementsz'foo'r� z['foo']z'foo\n'z 'foo\n\n'z['foo', 'bar']�barz'# Has a comment line\nfoo'z 'foo # Has an inline comment'z'foo \\\n >=3.0'zfoo>=3.0z 'foo\nbar'z 'foo\nbar\n'z['foo\n', 'bar\n']� use_wheelTFc C s` t d�j|d�t d�d�}t�|� | �� }|r |j}n|j}t|�}|� } |t| �ks.J �d S )Na from setuptools import setup setup( name="qux", version="0.0.0", py_modules=["hello"], setup_requires={setup_literal}, ) )r) r[ r\ )r �formatr re rb rn ru ro ) r r) r* r, r� r� rj � get_requiresrr rq r r r �test_setup_requires� s" � � �� z(TestBuildMetaBackend.test_setup_requiresc C sB t d�t d�ddd�}t�|� | �� }|�� }|dgks J �d S )Nzd [project] name = "proj" version = "42" z� __import__('setuptools').setup( setup_requires=["foo"], py_modules = ["hello", "world"] ) z'hello'z'world')r� r] r^ rw r� )r r re rb rn )r r� r� rj �setup_requiresr r r �'test_setup_requires_with_auto_discovery& s ��� z<TestBuildMetaBackend.test_setup_requires_with_auto_discoveryc C sH t d�t d�d�}t�|� | �� }tj�d�}t�|� |�|� d S )NaN from setuptools import setup setup( name="qux", version="0.0.0", py_modules=["hello"], setup_requires=["does-not-exist >99"], ) z[ def run(): print('hello') r\ r� )r r re rb r+ r, r r� )r r� r� rj r� r r r � test_dont_install_setup_requiresB s � �� z5TestBuildMetaBackend.test_dont_install_setup_requiresr] aD import os import sys __import__('setuptools').setup( name='foo', version='0.0.0', ) sys_argv = os.path.abspath(sys.argv[0]) file_path = os.path.abspath('setup.py') assert sys_argv == file_path c C sN t �| j� | �� }t�t�� |�d� W d � d S 1 s w Y d S �Nr� )r re �_sys_argv_0_passthroughrb r5 r �AssertionErrorr� r r r r �test_sys_argv_passthroughu s "�z.TestBuildMetaBackend.test_sys_argv_passthrougha import os assert os.path.isabs(__file__) __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) c C �" t �| j� | �� }|�d� d S r3 )r re �_setup_py_file_abspathrb r� r r r r �test_setup_py_file_abspath� s z/TestBuildMetaBackend.test_setup_py_file_abspath� build_hook)r� r� c C s^ ddi}t �|� t�d�}tjt|d�� t||�d� W d � d S 1 s(w Y d S )Nr] r� zNo distribution was found.r r� )r re �re�escaper5 r � ValueErrorrW )r rj r: r� r� r r r � test_build_with_empty_setuppy� s "�z2TestBuildMetaBackend.test_build_with_empty_setuppy)+r r r r rb r5 �fixturer rj rs rv r� �mark� parametrizer� �SETUP_SCRIPT_STUBr� r� r� r� r� r� r� r r r r r r r r r r r# r( r/ r1 r2 r4 r6 r8 r9 r> r r r r r` � s� 2 ? ���� � �� % "���� r` c @ s e Zd ZdZdd� Zdd� ZdS )�TestBuildMetaLegacyBackendz setuptools.build_meta:__legacy__c C r7 r3 )r re r rb r� r r r r r � s z@TestBuildMetaLegacyBackend.test_build_sdist_relative_path_importc C r7 r3 )r re r4 rb r� r r r r r6 � s z4TestBuildMetaLegacyBackend.test_sys_argv_passthroughN)r r r r r r6 r r r r rC � s rC z/ignore::setuptools.SetuptoolsDeprecationWarningc C sB | � |� d}|d jt|�dd� tdd�}|�� g ks J �dS )zHSetuptools should be resilient to setup.py with ``sys.exit(0)`` (#3973).zr import sys, setuptools setuptools.setup(name='foo', version='0.0.0') sys.exit(0) r] r� r� r ra N)rR � write_textr r rn �� monkeypatch�tmp_path�setuppyrY r r r �test_sys_exit_0_in_setuppy� s rI c C sf | � |� d}|d j|dd� tjtdd�� tdd�}|�� W d � d S 1 s,w Y d S ) Nz"import sys; sys.exit('some error')r] r� r� z some errorr r ra )rR rD r5 r � SystemExitr rn rE r r r �test_system_exit_in_setuppy� s "�rK ).rD rU r+ r; r� rH �sysr� r� � concurrentr �pathlibr �typingr r r� r r5 �jaracor �packaging.requirementsr �setuptools.warningsr �textwrapr rB �int�getenvr1 �builtin_module_namesr; r@ �skipif�platform� pytestmarkr r r- r r` rC r� rI rK r r r r �<module> s� �#� ��� �������� ��� ��� < tests/__pycache__/test_easy_install.cpython-310.pyc 0000644 00000127041 15030122015 0016337 0 ustar 00 o �h � � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlmZ ddlmZ ddlmZ ddlZddlmZ ddlZddlm mZ ddlm Z m Z m Z ddl!m"Z" dd l#m$Z$ dd lm%Z% dd l&m Z dd l'm(Z( dd l)m*Z* ddl+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1 ddl2Z3ej4dd�dd� �Z5G dd� d�Z6e1d�Z7G dd� d�Z8ej9�:d�G d d � d ��Z;ej4d d � �Z<ej9�=d �ej9�=d �G d!d"� d"���Z>ej4d#d$� �Z?ej9�=d$�G d%d&� d&��Z@ej4d'd(� �ZAG d)d*� d*�ZBG d+d,� d,�ZCd-d.� ZDd/d0� ZEd1d2� ZFd3d4� ZGd5d6eDddd7fd8d9�ZHej9jIe jJ�Kd:��oCe �Le jM�d;d<�G d=d>� d>��ZNG d?d@� d@�ZOG dAdB� dB�ZPG dCdD� dDe�ZQdEdF� ZRej9jSe jJdGkdHd<�dIdJ� �ZTdS )KzEasy install Tests� N)�Path)� NamedTuple)�mock��path)� Distribution�normalize_path� working_set)�sandbox)� safer_name)�PthDistributions)r �� run_setup)� fail_on_ascii)� MockServer� path_to_url� )�contexts)�DALST)�autousec C s | � dd� dS )z� Important: Disable the default index for pip to avoid querying packages in the index and potentially resolving and installing packages there. � PIP_NO_INDEX�trueN)�setenv)� monkeypatch� r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_easy_install.py�pip_disable_index* s r c @ � e Zd Zdd� Zdd� ZdS )�FakeDistc C s |dkri S ddiS )N�console_scripts�name�epr )�self�groupr r r � get_entry_map5 s zFakeDist.get_entry_mapc C � dS )N�specr �r" r r r �as_requirement: s zFakeDist.as_requirementN)�__name__� __module__� __qualname__r$ r( r r r r r 4 s r z3 from setuptools import setup setup() c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zej d d � �Z e d d� �Z ej dd� �Z e dd� �Zej dd� �Zejjej�d� dd�dd� �ZdS )�TestEasyInstallTestc C s� t j�� �� �� }t� }tt j�|��}t � |d�\}}|� |�s#J �d|v s)J �d|v s/J �d|v s5J �t j d|t jd�s@J �d S )N� z'spec'z'console_scripts'z'name'z ^# EASY-INSTALL-ENTRY-SCRIPT)�flags)�ei� CommandSpec�best�from_environment� as_headerr �next� ScriptWriter�get_args� itertools�islice� startswith�re�search� MULTILINE)r" �header�dist�args�_name�scriptr r r �test_get_script_argsH s z(TestEasyInstallTest.test_get_script_argsc C s� t � }t�|�}dd� |_d|_ddg|_tj�t � � d�|_ dg|_ |� � |jji ks/J �t�|�}dd� |_ddg|_tj�t � � d�|_ dg|_ |� � t|jj�� �}|ddgks`J �d S )Nc S r% �NTr r r r r �<lambda>X � z8TestEasyInstallTest.test_no_find_links.<locals>.<lambda>T�link1�link2�okc S r% rC r r r r r rD b rE )r r/ � easy_install�check_pth_processing� no_find_links� find_links�osr �join�tempfile�mkdtemp� install_dirr? �ensure_finalized� package_index� scanned_urls�sorted�keys)r" r> �cmdrV r r r �test_no_find_linksS s" z&TestEasyInstallTest.test_no_find_linksc C sV t � }t�|�}t�� |_t�tj j �� |� � W d � dS 1 s$w Y dS )zS Test that `cant_write_to_target` is rendered as a DistutilsError. N) r r/ rI rM �getcwdrQ �pytest�raises� distutils�errors�DistutilsError�cant_write_to_target)r" r> rW r r r �test_write_exceptionj s "�z(TestEasyInstallTest.test_write_exceptionc s: t d�� � fdd�}|jtd|dd� � t�� v sJ �dS )zh get_site_dirs should always return site dirs reported by site.getsitepackages. z /setuptools/test/site-packagesc s � gS �Nr r r r r �mock_gsp{ s z8TestEasyInstallTest.test_all_site_dirs.<locals>.mock_gsp�getsitepackagesF��raisingN)r �setattr�siter/ � get_site_dirs)r" r rb r r r �test_all_site_dirst s z&TestEasyInstallTest.test_all_site_dirsc C s |j tddd� t�� sJ �d S )Nrc Frd )�delattrrg r/ rh )r" r r r r �0test_all_site_dirs_works_without_getsitepackages� s zDTestEasyInstallTest.test_all_site_dirs_works_without_getsitepackagesc C sX dt d�fddg}d}|| }t�t|�d�}|D ] \}}|�||� q|�� t|�S )N�setup.pya5 import setuptools setuptools.setup( name="setuptools-test-unicode", version="1.0", packages=["mypkg"], include_package_data=True, ) �zmypkg/__init__.py� )u mypkg/☃.txtrn z setuptools-test-unicode-1.0.zip�w)r �zipfile�ZipFile�str�writestr�close�r" �tmpdir�files� sdist_name�sdist� sdist_zip�filename�contentr r r � sdist_unicode� s ��� z!TestEasyInstallTest.sdist_unicodec C �Z t ddgi�}|d �� }tj|t|�dgd�}|�tjdt|�� |�� |�|� dS )zq The install command should execute correctly even if the package has unicode filenames. � script_argsrI �target�x�rQ r? � PYTHONPATHN� r � ensure_dirr/ rI rr �setitemrM �environrR )r" r} rv r r> r� rW r r r � test_unicode_filename_in_sdist� s �z2TestEasyInstallTest.test_unicode_filename_in_sdistc C sf dt d�fddt d�fg}d}|| }t�t|�d�}|D ] \}}|�||�d�� q |�� t|�S ) Nrl ar import setuptools setuptools.setup( name="setuptools-test-unicode", version="1.0", packages=["mypkg"], include_package_data=True, scripts=['mypkg/unicode_in_script'], ) rm zmypkg/unicode_in_scriptu� #!/bin/sh # á non_python_fn() { } z&setuptools-test-unicode-script-1.0.zipro �utf-8)r rp rq rr rs �encodert ru r r r �sdist_unicode_in_script� s& ����� z+TestEasyInstallTest.sdist_unicode_in_scriptc C r~ )zr The install command should execute correctly even if the package has unicode in scripts. r rI r� r� r� r� Nr� )r" r� rv r r> r� rW r r r � test_unicode_content_in_sdist� s z1TestEasyInstallTest.test_unicode_content_in_sdistc C s6 dt d�fdt d�fg}d}t|| �}t||� |S )Nrl a import setuptools setuptools.setup( name="setuptools-test-script", version="1.0", scripts=["mypkg_script"], ) � mypkg_scriptzg #/usr/bin/python print('mypkg_script') z setuptools-test-script-1.0.zip)r rr � make_sdist)r" rv rw rx ry r r r � sdist_script� s ����� z TestEasyInstallTest.sdist_script�linuxz Test can only be run on Linux��reasonc C sj t ddgi�}|d �� }tj|t|�dgd�}|�tjdt|�� |�� |�|� |d � � s3J �dS ) z. Check scripts are installed. r rI r� r� r� r� r� N) r r� r/ rI rr r� rM r� rR �exists)r" r� rv r r> r� rW r r r �test_script_install s � z'TestEasyInstallTest.test_script_installN)r) r* r+ rB rX r` ri rk rZ �fixturer} r r� r� r� r� �mark�skipif�sys�platformr9 r� r r r r r, G s( # ) �r, zignore:Unbuilt eggc @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�TestPTHFileWriterc C s: t dt�� g�}|jr J �|�tt�� �� |jsJ �dS )zba pth file manager should set dirty if a distribution is in site but also the cwd �does-not_existN)r rM rY �dirty�add�PRDistribution)r" �pthr r r �!test_add_from_cwd_site_sets_dirty( s z3TestPTHFileWriter.test_add_from_cwd_site_sets_dirtyc C s@ d}t �|�}td|g�}|jrJ �|�t|�� |jr J �d S )Nz%/test/location/does-not-have-to-existr� )� pkg_resourcesr r r� r� r� )r" �locationr� r r r � test_add_from_site_is_ignored1 s �� z/TestPTHFileWriter.test_add_from_site_is_ignoredc C s� |� d�}|�� t|� d��}t|�}t|�}|j|j kr'g ks,J d�� J d��|� d�}|�� t|�}|j�|� |�� |jsJJ d��||jvsSJ d��|�� ||jv s`J d��|jd |kskJ d ��t|�j|jkswJ d ��d S ) z� If the pth file is modified under the hood, then PthDistribution will refresh its content before saving, merging contents when necessary. � pth_subdirz file1.pthz6unless there would be some default added at some point� src_subdirzEthe new_src_path added must still be present/valid in pth1 after savez:right before we save the entry should still not be presentzJthe new_src_path entry should have been added by pth2 with its save() call���zVand it should match exactly on the last entry actually given we append to it in save()zXand we should have the exact same list at the end with a fresh PthDistributions instanceN)rN �mkdirrr r �paths�append�save)r" rv r� �pth_path�pth1�pth2� new_src_path�new_src_path_strr r r �*test_many_pth_distributions_merge_together? s> �� � � ���z<TestPTHFileWriter.test_many_pth_distributions_merge_togetherN)r) r* r+ r� r� r� r r r r r� & s r� c c sr � | d j ddd�� }|�t� W d � n1 sw Y | �� � | V W d � d S 1 s2w Y d S )Nrl ro r� ��encoding)�open�write�SETUP_PY�as_cwd)rv �fr r r � setup_contextk s � � "�r� � user_overridec @ s� e Zd Ze�de�� �Ze�dej�e�dd�edd� ���Z e�dd�edd � ��Z e d d � �Z d d � Z ejdd� �Zejdd� �Zdd� Zejdd� �Zdd� ZdS )�TestUserInstallTestz;setuptools.command.easy_install.easy_install.check_site_dirz(setuptools.command.easy_install.__file__�site.ENABLE_USER_SITETc C � | � � d S ra ��assert_not_user_siter' r r r �/test_user_install_not_implied_user_site_enabled s zCTestUserInstallTest.test_user_install_not_implied_user_site_enabledFc C r� ra r� r' r r r �0test_user_install_not_implied_user_site_disabled� s zDTestUserInstallTest.test_user_install_not_implied_user_site_disabledc C s8 t � } d| _t�| �}dg|_|�� |jrJ d��d S )Nrl �pyzuser should not be implied)r � script_namer/ rI r? rR �user)r> rW r r r r� � s z(TestUserInstallTest.assert_not_user_sitec C s4 t �d� t�d�}tjtjtjd� |�d� d S )N�multiprocessing�test_easy_install)�level�streamzthis should not break) rZ � importorskip�logging� getLogger� basicConfig�INFOr� �stderr�info)r" �logr r r �test_multiproc_atexit� s z)TestUserInstallTest.test_multiproc_atexitc C sJ |d }|� d��}|�d� W d � t|�S 1 s w Y t|�S )Nzfoo-1.0.egg-inforo z Name: foo )r� r� rr )r" rv �egg_filer� r r r � foo_package� s ��z TestUserInstallTest.foo_packagec c s� � t |�}t�dtj|g ��5 tjj�tj�}tjjtj |d�� |V W d � n1 s/w Y W d � d S W d � d S 1 sGw Y d S )Nzsys.path�r� ) rr r �patchr� r rM �pathseprN �dictr� )r" rv r� � python_pathr r r �install_target� s � ��"�z"TestUserInstallTest.install_targetc C s~ t � }d|_t�|�}||_dg|_|�� |j�|g� |�d�}t j � t j � |j ��}t j � t j � |��}||ks=J �dS )zd The local index must be used when easy_install locates installed packages. rl �fooN)r r� r/ rI rQ r? rR � local_index�scanrM r �normcase�realpathr� )r" r� r� r> rW �res�actual�expectedr r r �test_local_index� s z$TestUserInstallTest.test_local_indexc o sX � | j |i |��� ddlm m} tj|_dV W d � dS 1 s%w Y dS )zw Wrap sandbox.setup_context to patch easy_install in that context to appear as user-installed. r N)� orig_context� setuptools.command.easy_install�commandrI rg � USER_SITE�__file__)r" r? �kwargsr/ r r r �user_install_setup_context� s �"�z.TestUserInstallTest.user_install_setup_contextc C s t j| _t�d| j�S )Nz setuptools.sandbox.setup_context)r r� r� r r� r� r' r r r �patched_setup_context� s �z)TestUserInstallTest.patched_setup_contextN)r) r* r+ r r� �Mock� prev_sp_writerg r� r� r� � staticmethodr� r� rZ r� r� r� r� � contextlib�contextmanagerr� r� r r r r r� s s. � r� c c s� � t �dd�} tjtjd��( tdddd�� }|�| � W d � n1 s&w Y d V W d � d S 1 s9w Y d S )Nz from setuptools import setupz from distutils.core import setup)�cdrl ro r� r� )r� �replacer �tempdirrM �chdirr� r� )�distutils_setup_pyr� r r r �distutils_package� s �� �"�r� c @ � e Zd Zdd� ZdS )�TestDistutilsPackagec C s t ddg� d S )Nrl � bdist_eggr r' r r r �)test_bdist_egg_available_on_distutils_pkg� s z>TestDistutilsPackage.test_bdist_egg_available_on_distutils_pkgN)r) r* r+ r� r r r r r� � s r� c C s& t � } | jdkr t�d� | �� | S )Nr zcould not find a valid port)r � server_portrZ �skip�start)�p_indexr r r � mock_index� s r� c @ r )�TestInstallRequiresc C s( |d }|j dd� |d }|j dd� | �|� tjddddt|�dt|�d t|�d t|�d t|�d t|�d t|�g}i tj�d|ji�}tj |t|�|tj tj ddd�}|j dks]J �z ddd� |j D �v sjJ �tdd� |j�� D ��sxJ �W dS ty� d|jv r�t�tj� d|j� �� � w )z~ When ``python setup.py install`` is called directly, it will use easy_install to fetch dependencies. �projectT)�exist_ok�install�-c� __import__("setuptools").setup()z--install-basez --install-libz--install-headersz--install-scriptsz--install-dataz--install-purelibz--install-platlib�__EASYINSTALL_INDEXr� )�cwd�env�stdoutr� �textr� r �/does-not-exist/c S � h | ]}|j �qS r r ��.0�rr r r � <setcomp> � zOTestInstallRequires.test_setup_install_includes_dependencies.<locals>.<setcomp>c s s$ � | ] }d |v rd|v r|V qdS )z"not find suitable distribution forzdoes-not-existNr )r �liner r r � <genexpr> s � ��zOTestInstallRequires.test_setup_install_includes_dependencies.<locals>.<genexpr>z failed to get random numbersz failure - N)r� �create_projectr� � executablerr rM r� �url� subprocess�run�PIPE�STDOUT� returncode�requestsr4 r � splitlines� ExceptionrZ �xfailr� )r" �tmp_pathr� � project_root� install_rootrW r �cpr r r �(test_setup_install_includes_dependencies� sZ �� � �z<TestInstallRequires.test_setup_install_includes_dependenciesc C s* d}|d j t|�dd� |d �� d S )Nz� [metadata] name = project version = 42 [options] install_requires = does-not-exist py_modules = mod � setup.cfgr� r� zmod.py)� write_textr �touch)r" �root�configr r r r ' s z"TestInstallRequires.create_projectN)r) r* r+ r" r r r r r r� � s 8r� c @ s� e Zd Zdd� Zeejdd� ��ZdZe j � de�dd� �Z e j � de�d d � �Z e j � de�d d � �Zd d� Zdd� Zdd� Zdd� Ze j � dd�dd� �Zdd� Zdd � Zd S ) �TestSetupRequiresc C s |� dd� |� dd� |� dd� t�� �[ t�� �G}t�� �3}tj|d�� tjddd d |j d d ||g }t � |�� � W d � n1 sGw Y W d � n1 sVw Y W d � n1 sew Y W d � n1 stw Y dd� |j D �dgks�J �d S )z� When easy_install installs a source distribution which specifies setup_requires, it should honor the fetch parameters (such as index-url, and find-links). � PIP_RETRIES�0� PIP_TIMEOUTr �falser� r r rI z --index-urlz--exclude-scriptsz --install-dirNc S s g | ]}|j �qS r r r r r r � <listcomp>R r zMTestSetupRequires.test_setup_requires_honors_fetch_params.<locals>.<listcomp>r )r r �quietr( � create_sdistr� � environmentr� r r r �Popen�waitr )r" r� r � dist_file�temp_install_dirrW r r r �'test_setup_requires_honors_fetch_params6 s6 � �� �� �� � z9TestSetupRequires.test_setup_requires_honors_fetch_paramsc c sZ � t �� � } tj�| d�}t|dtd�fdg� |V W d � dS 1 s&w Y dS )zl Return an sdist with a setup_requires dependency (of something that doesn't exist) z"setuptools-test-fetcher-1.0.tar.gzrl a import setuptools setuptools.setup( name="setuptools-test-fetcher", version="1.0", setup_requires = ['does-not-exist'], ) �r# rn N)r r� rM r rN r� r )�dir� dist_pathr r r r/ T s � �� ��"�z TestSetupRequires.create_sdist)r ��dependency_links��setup_requires)r: r< � use_setup_cfgc C s� t dddd�}t�|� t�� �d t�� �G}t||d�}tj� |d�}t� � �\}}t |dg� W d � n1 s:w Y |� � }t |�d ksKJ �|d �� d ksUJ �W d � n1 s_w Y W d � dS W d � dS 1 sww Y dS ) a< Regression test for distribution issue 323: https://bitbucket.org/tarek/distribute/issues/323 Ensures that a distribution's setup_requires requirements can still be installed and used locally even if a conflicting version of that requirement is already on the path. zdoes-not-matter�foobar�0.0�� project_name�version�r= rl �--nameNr r� �test_pkg)r� r r� r �save_pkg_resources_stater� � create_setup_requires_packagerM r rN r. r � readlines�len�strip) r" r= � fake_dist�temp_dirrE � test_setup_pyr �_stderr�linesr r r �.test_setup_requires_overrides_version_conflicty s( � � � ��"�z@TestSetupRequires.test_setup_requires_overrides_version_conflictc C s� t �� �� t �� ��}tj�|d�}t|dd� tj�|d�}t�|� t� |��}dd� |_ |� |� W d � n1 s=w Y t j� d|� t|ddd �}t�|� td �}t|dd t||d �}tj�|d �} t �� �"\} } zt| dg� W n tjy� t�d� Y nw W d � n1 s�w Y d| �� vs�J �| �� } t| �dks�J �| d � � dks�J �W d � n1 s�w Y W d � dS W d � dS 1 s�w Y dS )z� Like ``test_setup_requires_overrides_version_conflict`` but where the ``setup_requires`` package is part of a namespace package that has *already* been imported. zfoo_bar-0.1.tar.gzzfoo.bar�0.1z foo_bar-0.1c S s | S ra r )�memberr r r r rD � rE zFTestSetupRequires.test_setup_requires_override_nspkg.<locals>.<lambda>Nr r@ a� import foo # Even with foo imported first the # setup_requires package should override import setuptools setuptools.setup(**%r) if not (hasattr(foo, '__path__') and len(foo.__path__) == 2): print('FAIL') if 'foo_bar-0.2' not in foo.__path__[0]: print('FAIL') z0.2rC rl rD z9Installing setup.py requirements caused a VersionConflict�FAILr r� rE ) r rF r� rM r rN �make_nspkg_sdistr� �tarfiler� �extraction_filter� extractallr� �insertr� r r� r rG r. r r� �VersionConflictrZ �fail�getvaluerH rI rJ ) r" r= rL �foobar_1_archive� foobar_1_dir�tfr> �templaterE rM r rN rO r r r �"test_setup_requires_override_nspkg� sZ �� �� ��� � ��"�z4TestSetupRequires.test_setup_requires_override_nspkgc C s� dd� }t �� �k t �� �N}t|tdd�||d d�}tj�|d�}t �� �\}}t |dg� W d � n1 s9w Y |� � }t |�dksJJ �|d � � d ksTJ �W d � n1 s^w Y W d � d S W d � d S 1 svw Y d S ) Nc S s> dt d|�d|�d|�d��f|d t d�fg}t| |� d S )Nrl zj import setuptools setuptools.setup( name=z", version=z&, py_modules=[z-], ) z.pyz6 version = 42 )r r� )r8 �distnamerB rw r r r �make_dependency_sdist� s$ ��������zVTestSetupRequires.test_setup_requires_with_attr_version.<locals>.make_dependency_sdistzattr: foobar.version)rB )� setup_attrs� make_packager= rl � --versionr r� �42) r rF r� rG r� rM r rN r. r rH rI rJ ) r" r= rb rL rE rM r rN rO r r r �%test_setup_requires_with_attr_version� s( � � ��"�z7TestSetupRequires.test_setup_requires_with_attr_versionc C sT |� dd� |� dd� |� dd� |� d|j� t�� �p t�� �\}t|ddtg d �d �}tj� |d �}t |d d d��}|� t d�� W d � n1 sNw Y tj� |d�}t �tjj�� t|dg� W d � n1 srw Y W d � n1 s�w Y W d � n1 s�w Y t|j�dks�J �|jd jdks�J �d S )Nr) r* r+ r r, � PIP_INDEX_URL� python-xlib�0.19r9 �rc r# ro r� r� z} [easy_install] index_url = https://pypi.org/legacy/ rl re r r z /python-xlib/)r r r rF r� rG r� rM r rN r� r� r rZ r[ r\ r] r^ r rI r )r" r� r rL rE �test_setup_cfg�fprM r r r �"test_setup_requires_honors_pip_env s< ��� � �� �� �z4TestSetupRequires.test_setup_requires_honors_pip_envc C s� |� dd� |� dd� |� d|j� t�� �J t�� �6}tj�|d�}t|dd� t |dd �}t |d d t d |� �d �d�}tj�|d�}t |dg� W d � n1 sUw Y W d � n1 sdw Y t |j�dksrJ �d S )Nr) r* r+ rh z dep.tar.gz� dependencyrf � localhost)� authorityri rj z dependency @ r; rk rl re r )r r r rF r� rM r rN �make_trivial_sdistr rG r� r rI r )r" r� r rL � dep_sdist�dep_urlrE rM r r r �#test_setup_requires_with_pep508_url$ s( � �� �z5TestSetupRequires.test_setup_requires_with_pep508_urlc C s� dt d�t d�d�i}t�� �I t�� �5}tj||d� tt�|dd��}t � t j j �� t|dg� W d � n1 s=w Y W d � n1 sLw Y W d � n1 s[w Y t|j�d ksiJ �dS ) z2The `allow-hosts` option in not supported anymore.rE z~ from setuptools import setup setup(setup_requires='python-xlib') z\ [easy_install] allow_hosts = * �rl r# ��prefixrl re Nr )r r rF r� r �buildrr �pathlibr rZ r[ r\ r] r^ r rI r )r" r� rw rL �setup_pyr r r �$test_setup_requires_with_allow_hosts8 s* ���� �� �� �z6TestSetupRequires.test_setup_requires_with_allow_hostsc C sh |� dd� |� dd� |� dd� |� dd� d}tt|| ��}d}tt|| �d d |� d }tt|| ��}d tjj� d tjj� d�}tt|| �d d|� |d } | �t d�j ||||||d�d� tt| ��} t � � �$ t t|�ddtd | gd�d�} tj�| d�} t| dg� W d � n1 s�w Y tttt�tj�| d����} | d gks�J �dS ) z#Check `python_requires` is honored.r) r* r+ r �1� PIP_VERBOSEzdep-1.0.tar.gzz>=2.7�dep�1.0zdep-2.0.tar.gzz!=�.z.*z2.0z index.htmla� <!DOCTYPE html> <html><head><title>Links for dep</title></head> <body> <h1>Links for dep</h1> <a href="{dep_1_0_url}"data-requires-python="{dep_1_0_python_requires}">{dep_1_0_sdist}</a><br/> <a href="{dep_2_0_url}"data-requires-python="{dep_2_0_python_requires}">{dep_2_0_sdist}</a><br/> </body> </html> )� dep_1_0_url� dep_1_0_sdist�dep_1_0_python_requires� dep_2_0_url� dep_2_0_sdist�dep_2_0_python_requiresr� ri rj )r< r: rk rl re Nz.eggszdep 1.0)r r rr �make_python_requires_sdistr� � version_info�major�minorr$ r �formatr rF rG r� rM r rN r �list�mapr� �find_distributions)r" r rv r� r� r� r� r� r� �index� index_urlrE rM �eggsr r r �(test_setup_requires_with_python_requiresR s^ ���� �� � � �z:TestSetupRequires.test_setup_requires_with_python_requires�!with_dependency_links_in_setup_py)FTc C s� |� dd� |� dd� t�� �� t�� ��}ttj�|d�dd� tj�|d�}tj�|d�}tj�|d �}t�|� t |d d d �� }|rNtj�|d �g}ng }|� t d�j |d�� W d � n1 sew Y t |d d d ��}|� t d�j tj�|d�|d�� W d � n1 s�w Y t |dg� W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S )Nr) r* r+ zpython-xlib-42.tar.gzri rf rE rl r# ro r� r� �linksz� from setuptools import installer, setup setup(setup_requires='python-xlib==42', dependency_links={dependency_links!r}) r9 z� [easy_install] index_url = {index_url} find_links = {find_links} r� )r� rL re )r r rF r� rr rM r rN r� r� r� r r� r ) r" r r� rL rE rM rl rm r: r r r �0test_setup_requires_with_find_links_in_setup_cfg� sN � ��� �� �� � ��"�zBTestSetupRequires.test_setup_requires_with_find_links_in_setup_cfgc C sn t �� �� t �� ��}ttj�|d�dd� tj�|d�}t�|� tjt d�dd�|d� t tj�|d �d g� t � |� tj�|d �}tj�|d �}t�|� t |d d d��}|�t d�� W d � n1 siw Y |�dt|�� |�dd� |�dd� |�dd� t |dg� W d � n1 s�w Y W d � dS W d � dS 1 s�w Y dS )z� Use case: installing a package with a build dependency on an already installed `dep[extra]`, which in turn depends on `extra_dep` (whose is not already installed). �extra_dep-1.0.tar.gz� extra_depr� r a import setuptools setuptools.setup( name='dep', version='2.0', extras_require={'extra': ['extra_dep']}, ) rn rv rw rl � dist_inforE ro r� r� �� from setuptools import installer, setup setup(setup_requires='dep[extra]') N�PIP_FIND_LINKSr r} r) r* r+ re )r rF r� rr rM r rN r� ry r r r � add_entryr� r� r rr �r" r rL �dep_pkgrE rM rm r r r �4test_setup_requires_with_transitive_extra_dependency� sH � � � � �� � ��"�zFTestSetupRequires.test_setup_requires_with_transitive_extra_dependencyc C s� t �� �� t �� ��}ttj�|d�dtd�fddg� tj�|d�}t�|� tj td�dtd �d �|d � t tj�|d�d g� t � |� tj�|d �}tj�|d�}t�|� t |ddd��}|�td�� W d � n1 srw Y |�dt|�� |�dd� |�dd� |�dd� t |dg� W d � n1 s�w Y W d � dS W d � dS 1 s�w Y dS )zk Use case: ensure build requirements' extras are properly installed and activated. r� rl a$ import setuptools setuptools.setup( name='extra_dep', version='1.0', py_modules=['extra_dep'], ) r6 )z extra_dep.pyrn �epdepa( import setuptools setuptools.setup( name='dep', version='2.0', py_modules=['epcmd'], extras_require={'extra': ['extra_dep']}, entry_points=''' [distutils.commands] epcmd = epcmd:epcmd [extra] ''', ) rn a from distutils.command.build_py import build_py import extra_dep class epcmd(build_py): pass )rl r# zepcmd.pyrw r� rE ro r� r� r� Nr� r r} r) r* r+ �epcmd)r rF r� r� rM r rN r r� ry r r r� r� r� r rr r� r r r �.test_setup_requires_with_distutils_command_dep� s^ �� �� ���� �� � ��"�z@TestSetupRequires.test_setup_requires_with_distutils_command_depN)r) r* r+ r5 r� r� r� r/ r= rZ r� � parametrizerP r` rg rn ru r| r� r� r� r� r r r r r( 5 s( C * < + 5r( c C s( t | dtd|�d|�d��fdg� dS )z\ Create a simple sdist tarball at dist_path, containing just a simple setup.py. rl zT import setuptools setuptools.setup( name=z, version=z ) r6 N)r� r )r8 ra rB r r r rr D s ���� ��rr c s� d|v sJ �|� d�� � d }� fdd�tdt� �d �D �}td|�d|�d|�d |�d � �}d }d |ftj�|d �|fg}|dd� D ]}tjj|� d�d g � } |�| df� qEt| |� dS )z� Make an sdist tarball with distname and version which also contains one package with the same name as distname. The top-level package is designated a namespace package). r� r c s g | ] }d � � d|� ��qS )r� N)rN )r �idx��partsr r r- j s z$make_nspkg_sdist.<locals>.<listcomp>r zE import setuptools setuptools.setup( name=z, version=z, packages=z", namespace_packages=[z] ) z7__import__('pkg_resources').declare_namespace(__name__)rl z __init__.pyNrn ) �split�rangerI r rM r rN r� r� ) r8 ra rB � nspackage�packagesr{ �initrw �packager{ r r� r rT ^ s* ����� rT c C s& t | dtd�j|||d�fdg� d S )Nrl z� import setuptools setuptools.setup( name={name!r}, version={version!r}, python_requires={python_requires!r}, ) )r rB �python_requiresr6 )r� r r� )r8 ra rB r� r r r r� � s � ����r� c C s� t |�dksJ �t�| d��3}|D ]'\}}t�|�d��}tj|d�}t |�� �|_t t � � �|_ |j ||d� qW d � dS 1 sDw Y dS )z� Create a simple sdist tarball at dist_path, containing the files listed in ``files`` as ``(filename, content)`` tuples. r zw:gzr� �r )�fileobjN) rI rU r� �io�BytesIOr� �TarInfor[ �size�int�time�mtime�addfile)r8 rw r> r{ r| � file_bytes� file_infor r r r� � s �"�r� r> rQ r c C s� t |�}dd|� d|� �gtj�| �gd�}|r |�|� tj�| d�} t�| � |rjg } g } |D ](} |�| �} | d�� v rA| }n| }t | t t f�rOd�| �} |� | � d| � �� q1t d�jd �| �d �| �d �}nd }ttj�| d �d dd�� }|�|� W d � n1 s�w Y |du r�t d�}ttj�| d�d dd��}|�|| � W d � n1 s�w Y tj�| |� d|� d��}||||� | S )a� Creates a source tree under path for a trivial test package that has a single requirement in setup_requires--a tarball for that requirement is also created and added to the dependency_links argument. ``distname`` and ``version`` refer to the name/version of the package that the test package requires via ``setup_requires``. The name of the test package itself is just 'test_pkg'. rE r? z==)r rB r< r: z name version�;z: zg [metadata] {metadata} [options] {options} � )�options�metadatarn r# ro r� r� NzI import setuptools setuptools.setup(**%r) rl �-z.tar.gz)r rM r �abspath�updaterN r� �popr� � isinstance�tupler� r� r r� r� r� )r ra rB rd �setup_py_templaterc r= �normalized_distname�test_setup_attrsrE r� r� r �value�section�test_setup_cfg_contentsr� � foobar_pathr r r rG � sT � �� �� � rG �javaz0Test cannot run under java when executable is shr� c @ s4 e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd S ) �TestScriptHeaderu /Users/José/bin/pythonz$C:\Program Files\Python36\python.exec C �8 dt �tj�tj��� d�}t j�d�}||ksJ �d S )N�#!r� z#!/usr/local/bin/python� r/ � nt_quote_argrM r �normpathr� r r5 � get_header�r" r� r� r r r �test_get_script_header � z'TestScriptHeader.test_get_script_headerc C r� )Nr� � -x z#!/usr/bin/python -xr� r� r r r �test_get_script_header_args r� z,TestScriptHeader.test_get_script_header_argsc C s0 t jjd| jd�}d| j� d�}||ksJ �d S )N�#!/usr/bin/python�r r� r� )r/ r5 r� � non_ascii_exe�r" r� r� r r r �$test_get_script_header_non_ascii_exe s �z5TestScriptHeader.test_get_script_header_non_ascii_exec C s8 t jjdd| j d d�}d| j� d�}||ksJ �d S )Nr� �"r� �#!"z" )r/ r5 r� �exe_with_spacesr� r r r �&test_get_script_header_exe_with_spaces s �z7TestScriptHeader.test_get_script_header_exe_with_spacesN) r) r* r+ r� r� r� r� r� r� r r r r r� � s r� c @ sR e Zd Zdd� Zdd� Ze�dej�ej� e j �dd� ��Z dd � Z dd d �Zd S )�TestCommandSpecc C s" t �ddg�}|�� dksJ �dS )zx Show how a custom CommandSpec could be used to specify a #! executable which takes parameters. z /usr/bin/env�python3z#!/usr/bin/env python3 N)r/ r0 r3 �r" rW r r r �test_custom_launch_command s z*TestCommandSpec.test_custom_launch_commandc C s( t �dg�}t j�|�}||u sJ �dS )zG from_param should return an instance of a CommandSpec �pythonN)r/ r0 � from_param)r" rW �cmd_newr r r �.test_from_param_for_CommandSpec_is_passthrough" s z>TestCommandSpec.test_from_param_for_CommandSpec_is_passthroughzsys.executablec C s> t j�dd � tj�� }t|�dksJ �|�� �d�s J �d S )N�__PYVENV_LAUNCHER__r r� ) rM r� r� r/ r0 r2 rI r3 r9 r� r r r �/test_from_environment_with_spaces_in_executable* s z?TestCommandSpec.test_from_environment_with_spaces_in_executablec C s0 t j�d�}t|�dksJ �d|�� vsJ �dS )z� In order to support `executable = /usr/bin/env my-python`, make sure from_param invokes shlex on that input. z/usr/bin/env my-pythonr- r� N)r/ r0 r� rI r3 r� r r r �"test_from_simple_string_uses_shlex2 s z2TestCommandSpec.test_from_simple_string_uses_shlex�returnNc C sT t �t��}tj�t� � W d � n1 sw Y t|j�dks(J |j��dS )zc from_param should raise its own TypeError when the argument's type is unsupported Nz1Argument has an unsupported type <class 'object'>) rZ r[ � TypeErrorr/ r0 r� �objectrr r� )r" �exc_infor r r �%test_from_param_raises_expected_error; s ��z5TestCommandSpec.test_from_param_raises_expected_error)r� N)r) r* r+ r� r� r r� r� r� r� rM r� r� r� r� r r r r r� s r� c @ r� )�TestWindowsScriptWriterc C sN t j�d�}|�d�s J �|�d�sJ �|�d�}|�d�}|�d�r%J �d S )Nrn r� r� z\")r/ �WindowsScriptWriterr� r9 �endswith�lstrip�rstrip)r" �hdrr r r � test_headerG s z#TestWindowsScriptWriter.test_headerN)r) r* r+ r� r r r r r� F s r� c @ s6 e Zd ZU eed< eed< eed< eed< eed< dS )� VersionStubr� r� �micro� releaselevel�serialN)r) r* r+ r� �__annotations__rr r r r r r� Q s r� c C st t � }|�d�}dg|_d|_d|_t| �|_d |_|�d�}t| �|_d |_|�� �J}t � � �6 t � d� d}t dd d d d�}|� d d� |� d |� |� d|� |� |dt�� � |�� W d � n1 siw Y W d � n1 sxw Y ttd�r�dnd} |j�� } t�| d | �r�t�| d | �s�J �|jd dks�J �|jd dks�J �|jd dks�J �d S )NrI rH r Tr �ignorez:3.10.1 (main, Dec 21 2021, 09:17:12) [GCC 10.2.1 20210110]� � r �finalr� z sys.versionzsys.version_info�create_home_path�pypy_version_info�pypyr� z3\.?1z3\.?1\d� py_versionz3.10.1�py_version_shortz3.10�py_version_nodot�310)r �get_command_objr? �optimizer� rr �install_userbase�install_usersite�context�warnings�catch_warnings� simplefilterr� rf r r� �finalize_options�hasattrr� rQ �lowerr: r; � config_vars) rv � tmpdir_cwdr r> rW � install_cmdr� rB r� r rQ r r r �&test_use_correct_python_version_stringY s: �� r �darwinzDhttps://github.com/pypa/setuptools/pull/4716#issuecomment-2447624418c C s6 |� dd� |�dt|d �� |�dt|d �� |�dt|d �� |� dd� |� d d� tt�� �}|jd d d � |d }|jd d d � |� d t|�� d}|d j|dd� t|� d��g ksfJ �t|� d��g ksqJ �t dddg� t|� d��g ks�J �dd� |� d�D �}|dh }|dhks�J �dS )zC`setup.py develop` should honor `--user` even under build isolationr� F�HOMEz.home� USERPROFILE�APPDATAzsite.USER_BASENzsite.USER_SITET)�parentsr z .sys_prefixz sys.prefixzF__import__('setuptools').setup(name='aproj', version=42, packages=[]) rl r� r� �*�developz--userc S r r r� )r r� r r r r � r z9test_editable_user_and_build_isolation.<locals>.<setcomp>zeasy-install.pthzaproj.egg-link) rf r rr r rg �getusersitepackagesr� r$ r� �globr )r� r r � user_site� sys_prefix� setup_script� installedr r r �&test_editable_user_and_build_isolation� s* � r$ )U�__doc__r� r� r7 r� rM rz r: rg r r� rU rO r� r rp r �typingr �unittestr rZ �jaracor r� r� r� rI r/ r r� r r � setuptoolsr �setuptools._normalizationr r �setuptools.dist�setuptools.sandboxr �setuptools.testsr �setuptools.tests.serverr r rn r �textwrapr �distutils.errorsr\ r� r r r� r, r� �filterwarningsr� r� � usefixturesr� r� r� r� r� r( rr rT r� r� rG r� r� r9 �is_shr r� r� r� r� r r r$ r r r r �<module> s� � `D [ G $ �M� - .� tests/__pycache__/test_archive_util.cpython-310.pyc 0000644 00000002217 15030122015 0016323 0 ustar 00 o �hM � @ sL d dl Z d dlZd dlZd dlmZ ejdd� �Zejjdd�dd� �Z dS ) � N)� archive_utilc C s� t �� }tj|dd�� }d}d}t�|�}t|�|_|�|t �|�� W d � n1 s-w Y | d }tt|�dd��}|� |� � � W d � t|�S 1 sSw Y t|�S ) ul Create a tarfile containing only a file whose name is a zero byte file called testimäge.png. zw:gz)�fileobj�mode� u testimäge.pngNzunicode-pkg-1.0.tar.gz�wb)r ) �io�BytesIO�tarfile�open�TarInfo�len�size�addfile�str�write�getvalue)�tmpdir�tarobj�tgz�data�filename�t�target�tf� r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_archive_util.py�tarfile_with_unicode s � ��r z #710 and #712)�reasonc C s |d }t �| t|�� d S )N�out)r �unpack_archiver )r r r r r r �test_unicode_files! s r ) r r �pytest� setuptoolsr �fixturer �mark�xfailr r r r r �<module> s tests/__pycache__/test_setopt.cpython-310.pyc 0000644 00000003575 15030122015 0015173 0 ustar 00 o �hU � @ s& d dl Z d dlmZ G dd� d�ZdS )� N)�setoptc @ s4 e Zd Zedd� �Zedd� �Zdd� Zdd� Zd S ) �TestEditc C sD t �� }t| dd��}|�|� W d � |S 1 sw Y |S )N�utf-8��encoding)� configparser� ConfigParser�open� read_file)�filename�parser�reader� r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_setopt.py� parse_config s ��zTestEdit.parse_configc C s@ t | d��}|�|�d�� W d � d S 1 sw Y d S )N�wbr )r �write�encode)�file�content�strmr r r � write_text s "�zTestEdit.write_textc C sp |� d�}| �t|�d� t�t|�ttdd�d�� | �t|��}|�dd�dks,J �|�dd �dks6J �d S ) zh When editing a file, non-ASCII characters encoded in UTF-8 should be retained. � setup.cfgu [names] jaraco=джарако�yes)�other��namesr �jaracou джаракоr N)�joinr �strr � edit_config�dictr �get)�self�tmpdir�configr r r r �test_utf8_encoding_retained s z$TestEdit.test_utf8_encoding_retainedc C s^ |� d�}| �t|�d� t�t|�ttdd�d�� |jdd�}d|v s'J �d |v s-J �d S ) zG When editing a file, case of keys should be retained. r z[names] FoO=bArr )�oTherr �asciir �FoOr' N)r r r r r r! � read_text)r# r$ r% �actualr r r �test_case_retained s zTestEdit.test_case_retainedN)�__name__� __module__� __qualname__� staticmethodr r r& r, r r r r r s r )r �setuptools.commandr r r r r r �<module> s tests/__pycache__/test_virtualenv.cpython-310.pyc 0000644 00000005353 15030122015 0016050 0 ustar 00 o �h� � @ s d dl Z d dlZd dlZd dlmZ d dlmZ d dlZejdd�dd� �Z dd � Z d d � Z ej j d d d�ej j e � dd�ej �ddejdej jddd�d�ejdej jddd�d�ejdej jddd�d�ejdej jddd�d�ejdej jdd�d�g�dd� ���Zd d � ZdS ) � N)�URLError)�urlopenT)�autousec C s. | � g d���� }|tjkrt�d� dS dS )zY pytest_virtualenv may not work. if it doesn't, skip these tests. See #1284. )�python�-cz import sys; print(sys.prefix)z/virtualenv is broken (see pypa/setuptools#1284)N)�run�strip�sys�prefix�pytest�skip)�venv� venv_prefix� r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_virtualenv.py�pytest_virtualenv_works s �r c C s ddddt |�g}| �|� dS )zC Check setuptools can be installed in a clean environment. r �-m�pip�installN)�strr )�venv_without_setuptools�setuptools_wheel�cmdr r r �test_clean_env_install s r c C s: t j�dd�sz tddd� W dS ty Y dS w dS )N�NETWORK_REQUIREDFzhttps://pypi.org� )�timeoutT)�os�environ�getr r r r r r � access_pypi s ��r z*platform.python_implementation() == "PyPy"zChttps://github.com/pypa/setuptools/pull/2865#issuecomment-965834995)�reasonz no network� pip_versionzpip<20.1zsys.version_info >= (3, 12)z-pip 23.1.2 required for Python 3.12 and later)�markszpip<21zpip<22zpip<23z,https://github.com/pypa/pip/archive/main.zipz#2975c C s� |}|� g d�� | dur|� ddddd| dg� t�tj�� |� g d �� W d � n1 s1w Y |� ddt|�g� |� ddd d t|�g� dS ) z7 Check pip can upgrade setuptools from source. )r r �-U�wheelNr r r r r$ z --retries=1)r r zimport setuptoolsz--no-cache-dirz --upgrade)r r �raises� subprocess�CalledProcessErrorr )r" r r �setuptools_sdistr r r r � test_pip_upgrade_from_source) s 5 � r* c C s |j j}| jg d�|d� dS )zP Quick and dirty test to ensure all external dependencies are vendored. )r zsetup.pyz--help)�cwdN)�config�rootdirr )� bare_venv�request�setuptools_dirr r r � test_no_missing_dependenciesl s r1 )r r' r � urllib.errorr �urllib.requestr r �fixturer r r �mark�skipif� parametrize�param�xfailr* r1 r r r r �<module> sl ��������� ���& tests/__pycache__/test_windows_wrappers.cpython-310.pyc 0000644 00000016411 15030122015 0017263 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ej j ejdkdd�Z G dd� d�Z d d � ZG d d � d e �ZG d d� de �ZdS )a1 Python Script Wrapper for Windows ================================= setuptools includes wrappers for Python scripts that allows them to be executed like regular windows programs. There are 2 wrappers, one for command-line programs, cli.exe, and one for graphical programs, gui.exe. These programs are almost identical, function pretty much the same way, and are generated from the same source file. The wrapper programs are used by copying them to the directory containing the script they are to wrap and with the same name as the script they are to wrap. � N)� nt_quote_arg�win32z Windows only)�reasonc @ s$ e Zd Zedd� �Zedd� �ZdS )� WrapperTesterc C s t tj�}|t� S )N)r �sys� executable�locals)�cls�template� python_exe� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_windows_wrappers.py� prep_script s zWrapperTester.prep_scriptc C s� | � | j�}|| j �d�� }|�|� W d � n1 s w Y || j �d��}t�d| j�}|�|� W d � dS 1 sCw Y dS )z� Create a simple script, foo-script.py Note that the script starts with a Unix-style '#!' line saying which Python executable to run. The wrapper will use this line to find the correct Python executable. �wN�wb� setuptools) r � script_tmpl� script_name�open�write� wrapper_name� pkg_resources�resource_string�wrapper_source)r �tmpdir�script�fr r r r � create_script# s � "�zWrapperTester.create_scriptN)�__name__� __module__� __qualname__� classmethodr r r r r r r s r c C s, | dv sJ �t �� dkr| � d�S | � d�S )z=A simple routine to select launcher script based on platform.)�cli�gui�ARM64z -arm64.exez-32.exe)�platform�machine)�prefixr r r �win_launcher_exe8 s r( c @ sB e Zd ZdZdZed�Ze�d�� � Z dd� Z dd� Z d d � Z d S ) �TestCLI� foo-script.py�foo.exer" z� #!%(python_exe)s import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') c C sr | � |� t|d �dddddg}tj|tjtjddd �}|�d �\}}|�d d �}t�d �� � }||ks7J �dS )aD When the copy of cli.exe, foo.exe in this example, runs, it examines the path name it was run with and computes a Python script path name by removing the '.exe' suffix and adding the '-script.py' suffix. (For GUI programs, the suffix '-script.pyw' is added.) This is why we named out script the way we did. Now we can run out script by running the wrapper: This example was a little pathological in that it exercised windows (MS C runtime) quoting rules: - Strings containing spaces are surrounded by double quotes. - Double quotes in strings need to be escaped by preceding them with back slashes. - One or more backslashes preceding double quotes need to be escaped by preceding each of them with back slashes. r+ �arg1�arg 2�arg "2\"�arg 4\� arg5 a\\bT�utf-8��stdout�stdin�text�encoding� hello world � � �� \foo-script.py ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] 'hello\nworld\n' non-optimized N) r �str� subprocess�Popen�PIPE� communicate�replace�textwrap�dedent�lstrip)�selfr �cmd�procr3 �_stderr�actual�expectedr r r � test_basicS s. �� ��zTestCLI.test_basicc C s� |d }|� � | �|� t�|d �}|�|d � t|d �dddddg}tj|tjtjdd d �}|� d �\}}|� d d �}t � d�� � } || ksMJ �dS )zK Ensure that symlink for the foo.exe is working correctly. � script_dirr+ r, r- r. r/ r0 Tr1 r2 r7 r8 r9 r: N)�mkdirr �pathlib�Path� symlink_tor; r< r= r> r? r@ rA rB rC ) rD r rK �symlinkrE rF r3 rG rH rI r r r � test_symlink� s6 �� ��zTestCLI.test_symlinkc C s� | � |� t�d��� }|d �d��}|�| �|�� W d � n1 s&w Y t|d �g}tj |tj tj tj ddd�}|� � \}}|� d d �}t�d ��� } || ksYJ �dS ) a� Specifying Python Command-line Options -------------------------------------- You can specify a single argument on the '#!' line. This can be used to specify Python options like -O, to run in optimized mode or -i to start the interactive interpreter. You can combine multiple options as usual. For example, to run in optimized mode and enter the interpreter after running the script, you could use -Oi: a, #!%(python_exe)s -Oi import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') sys.ps1 = '---' r* r Nr+ Tr1 �r3 r4 �stderrr5 r6 r8 r9 zV \foo-script.py [] '' --- )r rA rB rC r r r r; r< r= r> �STDOUTr? r@ ) rD r �tmplr rE rF r3 rG rH rI r r r �test_with_options� s4 � � �� ��zTestCLI.test_with_optionsN)r r r r r r( r rA rB rC r rJ rQ rV r r r r r) A s � � 0 %r) c @ s6 e Zd ZdZdZed�ZdZe� d�� � Z dd� Z dS ) �TestGUIz= Testing the GUI Version ----------------------- zbar-script.pywr# �bar.exez� #!%(python_exe)s import sys f = open(sys.argv[1], 'wb') bytes_written = f.write(repr(sys.argv[2]).encode('utf-8')) f.close() c C s� | � |� t|d �t|d �dg}tj|tjtjtjddd�}|�� \}}|r*J �|r.J �|d �d��}|�� � d�}W d � n1 sGw Y |t d�ksTJ �d S ) z:Test the GUI version with the simple script, bar-script.pyrX ztest_output.txtz Test ArgumentTr1 rR �rb�asciiN) r r; r< r= r> rT r? r �read�decode�repr)rD r rE rF r3 rS �f_outrH r r r rJ � s( �� �zTestGUI.test_basicN) r r r �__doc__r r( r r rA rB �stripr rJ r r r r rW � s �� rW )r_ rM r% r< r rA �pytestr � setuptools.command.easy_installr �mark�skipif� pytestmarkr r( r) rW r r r r �<module> s tests/__pycache__/test_build_clib.cpython-310.pyc 0000644 00000004342 15030122015 0015736 0 ustar 00 o �h3 � @ sR d dl Z d dlmZ d dlZd dlmZ d dlmZ d dlm Z G dd� d�Z dS )� N)�mock)� build_clib)� Distribution)�DistutilsSetupErrorc @ s0 e Zd Ze�d�dd� �Ze�d�dd� �ZdS )� TestBuildCLibz2setuptools.command.build_clib.newer_pairwise_groupc C s� t � }t|�}dddifg}t�t�� |�|� W d � n1 s#w Y d}ddg|d�fg}t�t�� |�|� W d � n1 sHw Y ddi}ddg|d�fg}t�t�� |�|� W d � n1 sow Y ddi}ddg|d�fg}t�t�� |�|� W d � n1 s�w Y tj|jd�|_g g f|_ d d d �}dd g|d�fg}|�|� g d �g|j d v s�J �|jj j r�J �|jj jdks�J �|j�� d|_ |�|� |jj jdks�J �|jj jdks�J �d S )N�example�sourceszbroken.c� some_stringzsource.c�r �obj_deps� ��spec��global.h�� example.h�r � example.cr )r r r r � )r r �pytest�raisesr �build_librariesr � MagicMock�compiler� return_value� call_args�compile�called�create_static_lib� call_count� reset_mock)�self� mock_newer�dist�cmd�libsr � r' �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_build_clib.py�test_build_libraries sD � � � � z"TestBuildCLib.test_build_librariesc C s� t � }t|�}tj|jd�|_g g f|_ddg}|}ddd�}d||d�fg}|�|� |jd }||krAt� |t |��}||ks5d||d�fg}|�|� ||jd ksWJ �d S ) Nr z a-example.cr r r r r r r ) r r r r r r r r �random�sample�len) r" r# r$ r% �original_sourcesr r r& �computed_call_argsr' r' r( �!test_build_libraries_reproducible< s � z/TestBuildCLib.test_build_libraries_reproducibleN)�__name__� __module__� __qualname__r �patchr) r/ r' r' r' r( r s .r ) r* �unittestr r � setuptools.command.build_clibr �setuptools.distr �distutils.errorsr r r' r' r' r( �<module> s tests/__pycache__/test_sdist.cpython-310.pyc 0000644 00000067725 15030122015 0015012 0 ustar 00 o �hh� � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddlm Z ddl mZ ddlZddlZddlmZmZ ddlmZ ddlmZ dd lmZ dd lm Z dd l m Z dd l m Z d dl!m"Z" ddl#Z#ddl$m%Z% dddgddgidej&�'dd�gfgd�Z(de(�d�Z)e dej&�'dd�gej&�'dd�gd �Z*e*j+e*j, Z-ej.d d � �Z/d d � Z0d!d"� Z1d#d$� Z2d%d&� Z3ej4j5e3� d'd(�Z6ej4j7d)d*d(�Z8ej4j7e#j9�:d+� d,d(�Z;d-d.� Z<d/d0� Z=G d1d2� d2�Z>d3d4� Z?G d5d6� d6�Z@d7d8� ZAd9d:� ZBdS );z sdist tests� N��cleandoc)�Path)�mock)�Command� SetuptoolsDeprecationWarning)�metadata)�manifest_maker)�sdist)� Distribution)� Extension)� fail_on_ascii� )� Filenames)� run_setup� sdist_testz0.0z*.txt�data�d�e.dat)�name�version�packages� package_data� data_filesz&from setuptools import setup setup(**z) � sdist_test.fzf.c�f.h�r �sources�dependsc c sR � t jt j} }t�� t�� t _t _z d V W | |t _t _d S | |t _t _w �N)�sys�stdout�stderr�io�StringIO)� old_stdout� old_stderr� r' �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_sdist.py�quiet6 s �"r) c C s, t | t�s| �tj�d�d�S | �tjd�S )N�ascii� /�/)� isinstance�str�replace�os�sep�encode��pathr' r' r( �posixA s r5 c C sR t | t�r t�d| �S z| �d�} t�d| �} | �d�} W | S ty( Y | S w )N�NFD�utf-8)r- r. � unicodedata� normalize�decoder2 � UnicodeErrorr3 r' r' r( � decomposeI s ��r< c C s6 t | d�� }|�� W d � S 1 sw Y d S )N�rb)�open�read)�filename�fpr' r' r( �read_all_bytesU s $�rB c C sB zt jtjd�\} }t�| � t�|� W d S ty Y dS w )N)�suffixT)�tempfile�mkstempr �latin_1r0 �close�remove� Exception)�descr@ r' r' r( � latin1_failZ s �rK z)System does not support latin-1 filenames)�reasonz%os.environ.get('PYTEST_XDIST_WORKER')zpytest-dev/pytest-xdist#843� setuptoolsz/the test is not supported with stdlib distutilsc C s t | d��� | S )N�wb)r> rG r3 r' r' r( �touchs s rO c C s6 z t �| |� W |S ttfy t�d� Y d S w )Nzsymlink not supported in OS)r0 �symlink�OSError�NotImplementedError�pytest�skip)�src�dstr' r' r( �symlink_or_skip_testx s � �rW c @ s� e Zd Zejdd�dd� �Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� dd� dd� dd� d�Z eej�de �� �dd� ��Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zed(d)� �Zed*d+� �Ze d,d-� �Z ed.d/� �Z e d0d1� �Z ee d2d3� ��Z!e"d4d5� �Z#e e d6d7� ��Z$d8d9d:d;d<�Z%ej�d=e%�� �ej�&d>�d?d@� ��Z'dAdB� Z(dCdD� Z)dEdF� Z*ej�+dG�dHdI� �Z,dJS )K� TestSdistTestT)�autousec c s� � |d }|� � |d jtdd� |d }|� � |d }|� � dD ]}t|| � q$t|d � tD ]}t|| � q5|�� � |V W d � d S 1 sQw Y d S ) N� project_root�setup.pyr7 ��encodingr r )z __init__.py�a.txt�b.txt�c.rstr )�mkdir� write_text�SETUP_PYrO �EXTENSION_SOURCES�as_cwd)�self�tmpdir�test_pkg� data_folder�fnamer' r' r( � source_dir� s � "�zTestSdistTest.source_dirc C sd |j j}tj�dd�|v sJ �tj�dd�|v sJ �tj�dd�|vs%J �tj�dd�|v s0J �d S )Nr r^ r_ r` r r )�filelist�filesr0 r4 �join)rf �cmd�manifestr' r' r( � assert_package_data_in_manifest� s z-TestSdistTest.assert_package_data_in_manifestc C sd i t �dtgi�}t|�}d|_t|�}|�� t� � |�� W d � |S 1 s+w Y |S )N� ext_modulesr[ )� SETUP_ATTRS� EXTENSIONr � script_namer �ensure_finalizedr) �run�rf � setup_attrs�distro r' r' r( �setup_with_extension� s ��z"TestSdistTest.setup_with_extensionc C sZ t t�}d|_t|�}|�� t� � |�� W d � n1 s!w Y | �|� dS )z�Regression test for pull request #4: ensures that files listed in package_data are included in the manifest even if they're not added to version control. r[ N)r rs ru r rv r) rw rq )rf rz ro r' r' r( �test_package_data_in_sdist� s �z(TestSdistTest.test_package_data_in_sdistc C sv i t �ddi�}|d sJ �t|�}d|_t|�}|�� t� � |�� W d � n1 s/w Y | �|� dS )zU Ensure package_data and include_package_data work together. �include_package_dataTr r[ N)rs r ru r rv r) rw rq rx r' r' r( �3test_package_data_and_include_package_data_in_sdist� s �zATestSdistTest.test_package_data_and_include_package_data_in_sdistc C s4 | � � }| �|� |jj}tD ]}||v sJ �qdS )z� Ensure that the files listed in Extension.sources and Extension.depends are automatically included in the manifest. N)r{ rq rl rm rd )rf ro rp r4 r' r' r( � test_extension_sources_in_sdist� s �z-TestSdistTest.test_extension_sources_in_sdistc C sH t D ]}t�|� q| �� }| �|� |jj}t D ]}||vs!J �qdS )z� Similar to test_extension_sources_in_sdist but the referenced files don't exist. Missing files should not be included in distribution (with no error raised). N)rd r0 rH r{ rq rl rm )rf r4 ro rp r' r' r( � test_missing_extension_sources� s �z,TestSdistTest.test_missing_extension_sourcesc C s� g }t D ]$}tj�|�\}}|d | }t�||� ttj�|�|� |�|� q| �� }| � |� |j j }t D ]}||v s@J �q8|D ]}||vsKJ �qCdS )z� Similar to test_extension_sources_in_sdist but the referenced files are instead symbolic links to project-local files. Referenced file paths should be included. Symlink targets themselves should NOT be included. z_target.N) rd r0 r4 �splitext�renamerW �basename�appendr{ rq rl rm )rf � symlinkedr4 �base�ext�targetro rp r' r' r( � test_symlinked_extension_sources� s �z.TestSdistTest.test_symlinked_extension_sourcesc C s t j�t j�dd��S )Nr r )r0 r4 �abspathrn r' r' r' r( �<lambda> s zTestSdistTest.<lambda>c C s t j�dddd�S )Nr �..r �r0 r4 rn r' r' r' r( r� s c C s t j�dd�S )Nr zthis_file_does_not_exist.hr� r' r' r' r( r� s c C s t ttj�dd��d�S )Nr� zoutside_of_project_root.hz symlink.h)rW rO r0 r4 rn r' r' r' r( r� s �)zmust be relativezcan't have `..` segmentsz doesn't existz must be inside the project rootrL c s� | j | � � tdg � gd�}i t�d|gi�}t|�}d|_t|�}|�� t� �" |�t j �� |� � W d � n1 s?w Y W d � n1 sNw Y | � |� |j j}� |vsbJ �� fdd�|jD �}t|�dkstJ �|\}||v s}J �dS ) a� Due to backwards compatibility reasons, `Extension.depends` should accept invalid/weird paths, but then ignore them when building a sdist. This test verifies that the source distribution is still built successfully with such paths, but that instead of adding these paths to the manifest, we emit an informational message, notifying the user that the invalid path won't be automatically included. r r rr r[ Nc s0 g | ]\}}}|d kr|t jkr� |v r|�qS )�root)�logging�INFO)�.0�logger�level�message�� invalid_pathr' r( � <listcomp>3 s �z@TestSdistTest.test_invalid_extension_depends.<locals>.<listcomp>r )�_INVALID_PATHSr rs r ru r rv r) �at_levelr� r� rw rq rl rm � record_tuples�len) rf rL �caplog� extensionry rz ro rp �expected_messager' r� r( � test_invalid_extension_depends s2 � �� � z,TestSdistTest.test_invalid_extension_dependsc s ddl m} t�� � G � fdd�d|�}i t�ddi�}|d s"J �t|�}d|_t|�}|�� d |i|_ d |i|j _ |j � d �|ksFJ �d }t � �# t jt|d �� |�� W d � n1 sbw Y W d � n1 sqw Y � �� | �|� d S ) zq Ensure projects defining custom build_py don't break when creating sdists (issue #2849) r )�build_pyc s" e Zd ZdZ� �fdd�Z� ZS )z9TestSdistTest.test_custom_build_py.<locals>.CustomBuildPyzX Some projects have custom commands inheriting from `distutils` c s �� t � �� S r )�super�get_data_files�rf )� __class__�using_custom_command_guardr' r( r� N s zHTestSdistTest.test_custom_build_py.<locals>.CustomBuildPy.get_data_files)�__name__� __module__� __qualname__�__doc__r� � __classcell__r' �r� )r� r( � CustomBuildPyI s r� r} Tr r[ r� z setuptools instead of distutils)�matchN)�distutils.command.build_pyr� r �Mockrs r ru r rv �cmdclass� distribution�get_command_classr) rS �warnsr rw � assert_calledrq )rf � OrigBuildPyr� ry rz ro �msgr' r� r( �test_custom_build_py@ s( �� z"TestSdistTest.test_custom_build_pyc C sd t t�}d|_t|�}|�� t� � |�� W d � n1 s!w Y |jj}d|v s0J �d S �N�foo.pyr[ ) r rs ru r rv r) rw rl rm �rf rz ro rp r' r' r( �test_setup_py_existsf s �z"TestSdistTest.test_setup_py_existsc C sz t t�}d|_t|�}|�� tj�d�rt�d� t � � |� � W d � n1 s,w Y |j j }d|vs;J �d S r� ) r rs ru r rv r0 r4 �existsrH r) rw rl rm r� r' r' r( �test_setup_py_missingr s �z#TestSdistTest.test_setup_py_missingc C s� t dddd�� }|�d� W d � n1 sw Y tt�}d|_t|�}|�� t� � |�� W d � n1 s=w Y |j j }d|vsLJ �d S )N� MANIFEST.in�wr7 r\ zexclude setup.pyr� r[ ) r> �writer rs ru r rv r) rw rl rm )rf � manifest_filerz ro rp r' r' r( �test_setup_py_excluded� s � �z$TestSdistTest.test_setup_py_excludedc C s� t |d � t |d � tt�}d|_t|�}|�� t� � |�� W d � n1 s-w Y tdd� |j j �}d|vsCJ |��d|vsKJ |��d|vsSJ |��dS ) z� Make sure default files (README.*, etc.) are added in a case-sensitive way to avoid problems with packages built on Windows. z readme.rstz SETUP.cfgzsetup.PYNc S s | � � S r )�lower)�xr' r' r( r� � s z>TestSdistTest.test_defaults_case_sensitivity.<locals>.<lambda>r[ z setup.cfg) rO r rs ru r rv r) rw �maprl rm �rf rk rz ro rp r' r' r( � test_defaults_case_sensitivity� s �z,TestSdistTest.test_defaults_case_sensitivityc C s� dddddddd�}dddd�}i |�|�� � D ]\}}t||�jjddd� t||�j|dd� q| �� }| �|� d d � |jjD �}|D ]}t j � |�sPJ �||vsZJ ||f��qF|D ]}t j � |�sgJ �||v sqJ ||f��q]d S ) NzJglobal-include LICEN[CS]E* COPYING* NOTICE* AUTHORS* global-include *.txt � )r� zBtest/.venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rstzDsrc/.nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txtzEdoc/.tox/default/lib/python3.11/site-packages/foo-4.dist-info/LICENSEz.venv-requirements.txtz.tox-coveragerc.txtz.noxy/coveragerc.txt)zA.tox/release/lib/python3.11/site-packages/foo-4.dist-info/LICENSEz@.nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txtz=.venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rstT)�parents�exist_okr7 r\ c S s h | ] }|� tjd ��qS )r, )r/ r0 r1 )r� �fr' r' r( � <setcomp>� s zDTestSdistTest.test_exclude_dev_only_cache_folders.<locals>.<setcomp>) �itemsr �parentra rb r{ rq rl rm r0 r4 r� ) rf rk �included�excluded�file�contentro rp r4 r' r' r( �#test_exclude_dev_only_cache_folders� s2 �� �z1TestSdistTest.test_exclude_dev_only_cache_foldersc C s� t t�}d|_t|�}tj�dd�|_t�d� tj�dd�}t |� t � � |� � |j � |� |�� W d � n1 s?w Y t|j�}|�d�}t|�|v sVJ �d S )Nr[ �sdist_test.egg-info� SOURCES.txtr u smörbröd.py�UTF-8)r rs ru r r0 r4 rn rp ra rO r) rw rl r� �write_manifestrB r: r5 )rf rz �mmr@ �contents� u_contentsr' r' r( �+test_manifest_is_written_with_utf8_encoding� s � z9TestSdistTest.test_manifest_is_written_with_utf8_encodingc C s� t t�}d|_t|�}tj�dd�|_t�d� tj�dt j �}t |� t � � |� � |�d�}|jj�|� |�� W d � n1 sFw Y t|j�}|�d� t|�|v s]J �||jjv seJ �d S )Nr[ r� r� � sdist_testr7 r� )r rs ru r r0 r4 rn rp ra r �utf_8rO r) rw r: rl rm r� r� rB r5 �rf rz r� r@ � u_filenamer� r' r' r( �)test_write_manifest_allows_utf8_filenames� s" � z7TestSdistTest.test_write_manifest_allows_utf8_filenamesc C s� t t�}d|_t|�}tj�dd�|_t�d� tj�dt j �}t � � |� � |� dd�}|j�|� |�� W d � n1 sBw Y t|j�}|� d� t|�|vsYJ �||jjvsaJ �dS ) a Files that cannot be encoded to UTF-8 (specifically, those that weren't originally successfully decoded and have surrogate escapes) should be omitted from the manifest. See https://bitbucket.org/tarek/distribute/issue/303 for history. r[ r� r� r� r7 �surrogateescapeNr� )r rs ru r r0 r4 rn rp ra r rF r) rw r: rl r� r� rB r5 rm r� r' r' r( �,test_write_manifest_skips_non_utf8_filenames s � z:TestSdistTest.test_write_manifest_skips_non_utf8_filenamesc C s� t t�}d|_t|�}|�� t� � |�� W d � n1 s!w Y tj� dt j �}tj� dd�|_ t |j d�}|�d| � |�� t|� g |j_t� � |�� W d � n1 saw Y |�d�}||jjv ssJ �d S )Nr[ r� r� r� �ab� r7 )r rs ru r rv r) rw r0 r4 rn r r� rp r> r� rG rO rl rm � read_manifestr: �rf rz ro r@ rp r' r' r( �(test_manifest_is_read_with_utf8_encoding5 �& � � z6TestSdistTest.test_manifest_is_read_with_utf8_encodingc C s� t t�}d|_t|�}|�� t� � |�� W d � n1 s!w Y tj� dt j �}tj� dd�|_ t |j d�}|�d| � |�� t|� g |j_t� � |�� W d � n1 saw Y |�d�}||jjvssJ �d S )Nr[ r� r� r� r� r� �latin-1)r rs ru r rv r) rw r0 r4 rn r rF rp r> r� rG rO rl rm r� r: r� r' r' r( �+test_read_manifest_skips_non_utf8_filenamesT r� z9TestSdistTest.test_read_manifest_skips_non_utf8_filenamesc C s� t | �t��}d|_t|�}|�� tj�dt j �}t |� t � � |� � W d � n1 s0w Y tjdkr>t|�}t�� }tjdkri|dkrZ|�d�}||jjv sXJ �d S |�d�}||jjv sgJ �d S |�d�}||jjv svJ �d S )Nr[ r� �darwin�win32�cp1252�mbcsr7 )r � make_stringsrs ru r rv r0 r4 rn r r� rO r) rw r �platformr< �getfilesystemencodingr: rl rm �rf rz ro r@ �fs_encr' r' r( �%test_sdist_with_utf8_encoded_filenames s( � z3TestSdistTest.test_sdist_with_utf8_encoded_filenamec sB t |t�r� fdd�|�� D �S t |t�r tt� j|��S t|�S )Nc s i | ] \}}|� � |��qS r' )r� )r� �key�value��clsr' r( � <dictcomp>� s z.TestSdistTest.make_strings.<locals>.<dictcomp>)r- �dictr� �listr� r� r. )r� �itemr' r� r( r� � s zTestSdistTest.make_stringsc C s� t | �t��}d|_t|�}|�� tj�dt j �}t |� tj� |�s&J �t � � |�� W d � n1 s8w Y tjdkr[t�� }|dkrLd}|�|�}||jjv sYJ �d S |�d�}||jjvshJ �d S )Nr[ r� r� r� r� )r r� rs ru r rv r0 r4 rn r rF rO �isfiler) rw r r� r� r: rl rm r� r' r' r( �'test_sdist_with_latin1_encoded_filename� s$ � z5TestSdistTest.test_sdist_with_latin1_encoded_filenamez� [metadata] name = testing version = file: src/VERSION.txt license_files = DOWHATYOUWANT long_description = file: README.rst, USAGE.rst a [project] name = "testing" readme = "USAGE.rst" license-files = ["DOWHATYOUWANT"] dynamic = ["version"] [tool.setuptools.dynamic] version = {file = ["src/VERSION.txt"]} a [project] name = "testing" readme = "USAGE.rst" license-files = ["DOWHATYOUWANT"] dynamic = ["version"] [tool.setuptools.dynamic] version = {file = "src/VERSION.txt"} a [project] name = "testing" readme = "USAGE.rst" license = {file = "DOWHATYOUWANT"} dynamic = ["version"] [tool.setuptools.dynamic] version = {file = "src/VERSION.txt"} )z(setup.cfg - long_description and versionz@pyproject.toml - static readme/license files and dynamic versionz3pyproject.toml - directive with str instead of listz9pyproject.toml - deprecated license table with file entry�configz6ignore:.project.license. as a TOML table is deprecatedc C s8 |� d�\}}}| j| }|d �� |d jddd� |d jddd� |d jddd� |d jddd� || j|dd� td g i�}d |_|�� t|�}|�� t � � |� � W d � n1 sgw Y d|j j v szd |j j v szJ �d |j j v s�J �d |j j v s�J �d|j j vs�J �d|j j vs�J �d S )Nz - rU zsrc/VERSION.txtz0.42r7 r\ z README.rstz hello world!z USAGE.rst� DOWHATYOUWANTr r[ zsrc\VERSION.txtr, �\) � partition�_EXAMPLE_DIRECTIVESra rb r ru �parse_config_filesr rv r) rw rl rm )rf rk r� � config_file�_� config_textrz ro r' r' r( �.test_add_files_referenced_by_config_directives� s, � z<TestSdistTest.test_add_files_referenced_by_config_directivesc C sp t |d � tt�}d|_t|�}|�� t� � |�� W d � n1 s'w Y |jj }d|v s6J �dS )zW Check if pyproject.toml is included in source distribution if present �pyproject.tomlr[ N) rO r rs ru r rv r) rw rl rm r� r' r' r( � test_pyproject_toml_in_sdist s �z*TestSdistTest.test_pyproject_toml_in_sdistc C s� t |d � tdddd��}td|d� W d � n1 s w Y tt�}d |_t|�}|�� t� � |� � W d � n1 sDw Y |j j }d|vsSJ �dS ) zH Check that pyproject.toml can excluded even if present r r� r� r7 r\ zexclude pyproject.toml)r� Nr[ ) rO r> �printr rs ru r rv r) rw rl rm )rf rk �mtsrz ro rp r' r' r( � test_pyproject_toml_excluded s � �z*TestSdistTest.test_pyproject_toml_excludedc C s t |d � ti t�ddi��}t|�}|�� t� � |�� W d � n1 s*w Y |jj}d|vs9J �ti t�ddi��}|� d�}g |j �d�|_ G dd� dt �}|j j |d� t|�}d |_|�� t� � |�� W d � n1 s|w Y |jj}d|v s�J �d S ) N�.myfile~ru r[ �build)� build_customNc @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) zFTestSdistTest.test_build_subcommand_source_files.<locals>.build_customc S � d S r r' r� r' r' r( �initialize_options0 � zYTestSdistTest.test_build_subcommand_source_files.<locals>.build_custom.initialize_optionsc S r r r' r� r' r' r( �finalize_options2 r zWTestSdistTest.test_build_subcommand_source_files.<locals>.build_custom.finalize_optionsc S r r r' r� r' r' r( rw 4 r zJTestSdistTest.test_build_subcommand_source_files.<locals>.build_custom.runc S s dgS )Nr r' r� r' r' r( �get_source_files6 s zWTestSdistTest.test_build_subcommand_source_files.<locals>.build_custom.get_source_filesN)r� r� r� r r rw r r' r' r' r( r / s r )r T)rO r rs r rv r) rw rl rm �get_command_obj� sub_commandsr r� �update� use_defaults)rf rk rz ro rp r r r' r' r( �"test_build_subcommand_source_files s, � �z0TestSdistTest.test_build_subcommand_source_filesz6os.environ.get('SETUPTOOLS_USE_DISTUTILS') == 'stdlib'c C sh t i t�dddt�d�iid���}t|�}|�� t� � |�� W d � dS 1 s-w Y dS )zS Ensure if build_base is a pathlib.Path, the build still succeeds. r[ r � build_base)ru �optionsN)r rs �pathlibr r rv r) rw )rf rk rz ro r' r' r( �test_build_base_pathlibC s � � "�z%TestSdistTest.test_build_base_pathlibN)-r� r� r� rS �fixturerk rq r{ r| r~ r r� r� r� �skip_under_stdlib_distutils�mark� parametrize�keysr� r� r� r� r� r� r� r r� r� �skip_under_xdistr� r� � fail_on_latin1_encoded_filenamesr� r� � classmethodr� r� r �filterwarningsr r r r �skipifr r' r' r' r( rX � sr � +& ( # �%� %rX c C s( t j�d�\} | �� }t|d�sJ �dS )a� When _default_revctrl was removed from the `setuptools.command.sdist` module in 10.0, it broke some systems which keep an old install of setuptools (Distribute) around. Those old versions require that the setuptools package continue to implement that interface, so this function provides that interface, stubbed. See #320 for details. This interface must be maintained until Ubuntu 12.04 is no longer supported (by Setuptools). zg [setuptools.file_finders] svn_cvs = setuptools.command.sdist:_default_revctrl �__iter__N)r � EntryPoints� _from_text�load�hasattr)�ep�resr' r' r( �test_default_revctrlS s �r0 c @ sT e Zd ZdZedd� �Zej�dd�dd� �Z edd � �Z ej�dd �d d � �Z d S )�TestRegressionszp Can be removed/changed if the project decides to change how it handles symlinks or external files. c C s& dddiit d|�d��ddd�d�S ) N�dir�file.hr� �[ from setuptools import Extension, setup setup( name="myproj", version="42", ext_modules=[ Extension( "hello", sources=["hello.pyx"], depends=[�e] ) ], ) �global-include *.h�r[ z hello.pyxr� ��external�projectr )�tmp_path�dep_pathr' r' r( �&files_for_symlink_in_extension_dependsn s �����z6TestRegressions.files_for_symlink_in_extension_dependsr< )zmyheaders/dir/file.hzmyheaders/dir/../dir/file.hc C sZ | � ||�}tjj|t|�d� t|d |d � t||d �}dD ]}||v s*J �q"d S )N��prefixr9 zproject/myheadersr: )zmyproj-42/hello.pyxz myproj-42/myheaders/dir/file.h)r= �jaracor4 r r. rW � run_sdist)rf � monkeypatchr; r< rm �members�expectedr' r' r( �!test_symlink_in_extension_depends� s �z1TestRegressions.test_symlink_in_extension_dependsc C sJ |� d�\}}}|r| | n|}dddiitdt|��d��ddd�d �S ) Nz $tmp_path$/r2 r3 r� r4 r5 r6 r7 r8 )r r r. )r; r< �headr �tailr' r' r( �,files_for_external_path_in_extension_depends� s �����z<TestRegressions.files_for_external_path_in_extension_depends)z $tmp_path$/external/dir/file.hz../external/dir/file.hc C sH | � ||�}tjj|t|�d� t||d �}|D ]}d|vs!J �qd S )Nr> r: r3 )rH r@ r4 r r. rA )rf rB r; r< rm rC r r' r' r( �'test_external_path_in_extension_depends� s �z7TestRegressions.test_external_path_in_extension_dependsN) r� r� r� r� � staticmethodr= rS r! r" rE rH rI r' r' r' r( r1 h s � �r1 c C s� | � |� t� � tddg� W d � n1 sw Y t|d �d��}t�t|���}t|� � �W d � S 1 s?w Y dS )z@Given a project directory, run the sdist and return its contentsr[ r Nrz z*.tar.gz) �chdirr) r �next�glob�tarfiler> r. �set�getnames)rB r: �archive�tarr' r' r( rA � s � $�rA c C s^ t �| �� }|�� }W d � n1 sw Y dd� |D �}t|�dks-J d|� ���d S )Nc S s g | ]}d |v r|�qS )z.toxr' )r� r r' r' r( r� � s z:test_sanity_check_setuptools_own_sdist.<locals>.<listcomp>r z not empty )rN r> rP r� )�setuptools_sdistrR rm � tox_filesr' r' r( �&test_sanity_check_setuptools_own_sdist� s � rU )Cr� � contextlibr# r� r0 r r rN rD r8 �inspectr r �unittestr � jaraco.pathr@ rS rM r r �setuptools._importlibr �setuptools.command.egg_infor �setuptools.command.sdistr �setuptools.distr �setuptools.extensionr �setuptools.testsr �textr � distutils�distutils.corer r4 rn rs rc rt r r rd �contextmanagerr) r5 r< rB rK r! �xfailr% r( r$ � __package__� startswithr rO rW rX r0 r1 rA rU r' r' r' r( �<module> s� ��� �� � W_ tests/__pycache__/test_dist.cpython-310.pyc 0000644 00000015445 15030122015 0014617 0 ustar 00 o �h�" � @ s4 d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlm Z m Z ddl m Z ddl mZ ddlmZ d dlmZ d d � Zed d d dddddgd�Zdd� Zddgdgd�dfdddgfddgffd fd ddgid fddid fdd d!� d"D �id#ffZej�d$e�d%d&� �Zd'd(� Zd)d*� Z ej�d+g d,��d-d.� �Z ej�d/d0dd1d2gd3gfd4dd1d2gd3gfd3dd1d2gd3gfd0dd5gd6d0gfd3dd7d8gd3d9gfd3d:d;d<�g d=�g d>�fg�d?d@� �Z ej�dAdBddCgfd0dd5dDgfd3ddEgfd3dd1dFgfd3dd7dGgfd3d:d;dH�g d=�fdIddJdKgfdIddLdMgfg�dNdO� �Z dS )P� N)� Distribution)�check_package_data�check_specifier� )�make_trivial_sdist)� ensure_files)�DALS)�DistutilsSetupErrorc s� | � d��tj�dtj�t����}�fdd�}|dd� |dd� | �d ��d ��}|� t d �j |d �� W d � n1 s@w Y d� � }| � � � t� � � �� � fdd�|D �}W d � n1 shw Y dd� |D �|ksxJ �d S )zR Check multiple calls to `Distribution.fetch_build_egg` work as expected. �indexzfile://c s| � � | �}| � d|� d�}tt|�|��| |� |�d��d��}|�td�j|d�� W d � d S 1 s7w Y d S )N�-z.tar.gzz index.html�wz� <!DOCTYPE html><html><body> <a href="{dist_sdist}" rel="internal">{dist_sdist}</a><br/> </body></html> )� dist_sdist)�mkdirr �str�join�open�writer �format)�distname�version�dist_dirr �fp)r � �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_dist.py�sdist_with_index s ���"�z3test_dist_fetch_build_egg.<locals>.sdist_with_index� barbazquuxz3.2.0zbarbazquux-runnerz2.11.1z setup.cfgr zL [easy_install] index_url = {index_url} )� index_urlNz* barbazquux-runner barbazquux c s g | ]}� � |��qS r )�fetch_build_egg)�.0�r)�distr r � <listcomp>: � z-test_dist_fetch_build_egg.<locals>.<listcomp>c S s g | ]}|r|j �qS r )�key)r r r r r r! ; r" )r �urllib�parse�urljoin�request� pathname2urlr r r r r r �split�as_cwdr �parse_config_files)�tmpdirr r r �reqs�resolved_distsr )r r r �test_dist_fetch_build_egg s. ��� � � �r/ �packagez0.0.1zFoo Barz foo@bar.netzLong descriptionzShort description�one�two)�namer �author� author_email�long_description� description�keywordsc C sr t t dgdgd�d�} t| �}t|jj�ddgksJ �t t| d �� ��| d< t| �}t|jj�ddgks7J �d S )N�foo�bar)�a�b)�extras_requirer; r< r= )�dictr �list�metadata�provides_extras�reversed�items��attrsr r r r �(test_provides_extras_deterministic_orderI s rF z*.txtz*.rstz*.msg)� �hellorG rH z^'package_data' must be a dictionary mapping package names to lists of string wildcard patternsi� z5keys of 'package_data' dict must be strings (got 400)z["values of 'package_data' dict" must be of type <tuple[str, ...] | list[str]> (got '*.msg')c c s � | ]}|V qd S )Nr )r �xr r r � <genexpr>z s � rJ � generatorzd"values of 'package_data' dict" must be of type <tuple[str, ...] | list[str]> (got <generator object�� package_data�expected_messagec C sf |d u rt d d| �d u sJ �d S tjtt�|�d�� t d d| � W d � d S 1 s,w Y d S )NrM ��match)r �pytest�raisesr �re�escaperL r r r �test_check_package_data� s "�rU c C s� ddd�} t | �}t|| | d � dddgd�} t | �}t|| | d � ddd�} t�t�� t | �}W d � d S 1 s>w Y d S )Nr9 z >=3.0, !=3.1)r3 �python_requiresrV z>=3.0z!=3.1z>=invalid-version)r r rQ rR r rD r r r �test_check_specifier� s "�rW c C s> t jtdd�� t� �� W d � d S 1 sw Y d S )Nz missing.*namerO )rQ rR r r �_validate_metadatar r r r �test_metadata_name� s "�rY )� dist_name� py_module))�my.pkg�my_pkg)�my-pkgr] )r] r] )�pkgr_ c C s� | |� d� � � | d � � | d � � i t�|t| �d��}t|�}|�� |j|gks0J �ti |�ddgi��}|�� |jdgksGJ �ti |�ddgi��}|�� |jr[J �d S ) Nz.py�setup.py� noxfile.py)r3 �src_root� py_modules�explicity_py_module�packages�explicity_package)�touch�EXAMPLE_BASE_INFOr r � set_defaultsrc )�tmp_pathrZ r[ rE r r r r � test_dist_default_py_modules� s rk )rZ � package_dir� package_filesre r\ zmy_pkg/__init__.pyz my_pkg/mod.pyr] r^ zmy/pkg/__init__.py�myzsrc/my_pkg/__init__.pyzsrc/my_pkg2/__init__.py�my_pkg2�lib�lib2)r_ �pkg2)zlib/__init__.pyzlib/nested/__init__.pytzlib2/__init__.py)r_ z pkg.nestedrr c C s� t | |� | d �� | d �� i t�|t| �|d��}t|�}|�� |jr*J �|jr/J �t|j�t|�ks:J �ti |�ddgi��}|�� |jrNJ �t|j�dhksXJ �ti |�ddgi��}|�� |jrlJ �t|j�dhksvJ �d S )Nr` ra )r3 rb rl rc �explicit_py_modulere �explicit_package) r rg rh r r ri rc �setre )rj rZ rl rm re rE r r r r �test_dist_default_packages� s. �� rv )rZ rl rm z my.pkg.nestedzmy/pkg/nested/__init__.pyzmy/pkg/file.pyz my_pkg.pyzmy_pkg/nested/__init__.pyz src/my_pkg/nested/__init__.py)r] z my_pkg.lib2�UNKNOWNz src/mod1.pyz src/mod2.pyzsrc/pkg1/__ini__.pyzsrc/pkg2/__init__.pyc C sd t | |� i t�d�tj�| ��|d��}|d= t|�}|�� |js(|j s(J �|� � |ks0J �dS )z:Make sure dist.name is discovered from packages/py_modules�/)rb rl r3 N) r rh r �os�pathr) r ri rc re �get_name)rj rZ rl rm rE r r r r �test_dist_default_name� s ��r| ) ry rS � urllib.parser$ �urllib.requestrQ � setuptoolsr �setuptools.distr r �test_easy_installr �test_find_packagesr �textwrapr �distutils.errorsr r/ r> rh rF �CHECK_PACKAGE_DATA_TESTS�mark� parametrizerU rW rY rk rv r| r r r r �<module> s� ,� �� �� �� �� ��� 2 � ���� ! � �� tests/__pycache__/test_unicode_utils.cpython-310.pyc 0000644 00000001301 15030122015 0016504 0 ustar 00 o �h< � @ s d dl mZ dd� ZdS )� )� unicode_utilsc C s | � ddd� � t�d� dS )zc Test filesys_decode does not raise TypeError when getfilesystemencoding returns None. zsys.getfilesystemencodingc S s d S )N� r r r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_unicode_utils.py�<lambda> s z9test_filesys_decode_fs_encoding_is_None.<locals>.<lambda>s testN)�setattrr �filesys_decode)� monkeypatchr r r �'test_filesys_decode_fs_encoding_is_None s r N)� setuptoolsr r r r r r �<module> s tests/__pycache__/test_extern.cpython-310.pyc 0000644 00000001160 15030122015 0015146 0 ustar 00 o �h( � @ s8 d dl Z d dlZd dlZd dlmZ dd� Zdd� ZdS )� N)� Distributionc C s t �tj�} t| u s J �d S �N)� importlib� import_module� packaging�__name__)� packaging2� r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_extern.py�test_reimport_extern s r c C s t �t �t� �� d S r )�pickle�loads�dumpsr r r r r �test_distribution_picklable s r )r r r � setuptoolsr r r r r r r �<module> s tests/__pycache__/test_logging.cpython-310.pyc 0000644 00000004007 15030122015 0015272 0 ustar 00 o �h3 � @ sh d dl Z d dlZd dlZd dlZd dlZdejv ZdZej� dddg�dd� �Z d d � Z e d d � �Z dS ) � N�__pypy__zRfrom setuptools import setup setup( name="test_logging", version="0.0" ) )�flag�expected_level)z --dry-run�INFO)z --verbose�DEBUGc C s� ddl }ddl}t�t�}|�td|� |�� }t�|�dks!J �| d }|jt dd� |j j |dd �} |d g| _ | � � |�� } t�| �} | |ksLJ �dS ) z:Make sure the correct verbosity level is set (issue #3038)r N�root�NOTSETzsetup.pyzutf-8)�encoding�init)� stop_after�sdist)� setuptools� distutils�logging�Logger�__name__�setattr�getEffectiveLevel� getLevelName� write_text�setup_py�core� run_setup� script_args�parse_command_line) �tmp_path� monkeypatchr r r r �logger�unset_log_level� setup_script�dist� log_level�log_level_name� r# �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_logging.py�test_verbosity_level s r% c s t �� �� fdd��}|S )Nc s6 z� � W d S t y trd} t�| � d�� � w )Nz!Flaky monkeypatch on PyPy (#4124)z&. Original discussion in #3707, #3709.)�AssertionError�IS_PYPY�pytest�xfail)�msg��funcr# r$ �_func. s �z flaky_on_pypy.<locals>._func)� functools�wraps)r, r- r# r+ r$ � flaky_on_pypy- s r0 c C sp dd l } dd l}ddlm} |j�� | �� r.|jd u s#d|jv s#J �t|j tj �s,J �d S t � |j �s6J �d S )Nr )r r ) �_distutils_hack�setuptools.loggingr r r � configure�enabled�__file__� isinstance�logr �inspect�ismodule)r1 r r r# r# r$ �%test_patching_does_not_cause_problems; s r: ) r. r8 r �sysr( �builtin_module_namesr' r �mark� parametrizer% r0 r: r# r# r# r$ �<module> s � tests/__pycache__/test_depends.cpython-310.pyc 0000644 00000001412 15030122015 0015263 0 ustar 00 o �h� � @ s& d dl Z d dlmZ G dd� d�ZdS )� N)�dependsc @ s e Zd Zdd� ZdS )�TestGetModuleConstantc C s. d}t �|d�}|dksJ �dtjvsJ �dS )zU Invoke get_module_constant on a module in the test package. z"setuptools.tests.mod_with_constant�valuez three, sir!N)r �get_module_constant�sys�modules)�self�mod_name�val� r �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_depends.py� test_basic s z TestGetModuleConstant.test_basicN)�__name__� __module__� __qualname__r r r r r r s r )r � setuptoolsr r r r r r �<module> s tests/__pycache__/test_find_packages.cpython-310.pyc 0000644 00000017734 15030122015 0016435 0 ustar 00 o �h� � @ st d Z ddlZddlZddlZddlZddlmZmZ ddlm Z ddl m Z G dd� d�Z G d d � d �Z d d � ZdS ) z%Tests for automatic package discovery� N)�find_namespace_packages� find_packages)�FlatLayoutPackageFinder� )� os_helperc @ s� e Zd Zdd� Zdd� Zdd� Zd(dd �Zd(d d �Zd d � Zdd� Z dd� Z dd� Z dd� Z dd� Z ejje�� dd�dd� �Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� ZdS ))�TestFindPackagesc C s t �� | _| �� d S �N)�tempfile�mkdtemp�dist_dir�_make_pkg_structure��self�method� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_find_packages.py� setup_method s z TestFindPackages.setup_methodc C s t �| j� d S r )�shutil�rmtreer r r r r �teardown_method s z TestFindPackages.teardown_methodc C s� | � d| j�| _| �d| j� | � d| j�| _| � d| j� | � d| j�| _| �d| j� | � d| j�| _| � d| j�| _| �d | j� | �d | j� | �d | j� d S ) aG Make basic package structure. dist/ docs/ conf.py pkg/ __pycache__/ nspkg/ mod.py subpkg/ assets/ asset __init__.py setup.py �docszconf.py�pkg� __pycache__�nspkgzmod.py�subpkg�assets�asset� __init__.pyzsetup.pyN)�_mkdirr �docs_dir�_touch�pkg_dir� ns_pkg_dir� sub_pkg_dir� asset_dir)r r r r r s z$TestFindPackages._make_pkg_structureNc C s |r t j�||�}t �|� |S r )�os�path�join�mkdir)r r& � parent_dirr r r r 4 s zTestFindPackages._mkdirc C s$ |r t j�||�}t|d��� |S )N�wb)r% r& r' �open�close)r r& �dir_r r r r : s zTestFindPackages._touchc C s, | � d| j� t| j�}|ddgksJ �d S )Nr r � pkg.subpkg�r r! r r �r �packagesr r r �test_regular_package@ s z%TestFindPackages.test_regular_packagec C s. | � d| j� t| jdd�}|dgksJ �d S )Nr )zpkg.*��excluder r/ r0 r r r � test_excludeE s z TestFindPackages.test_excludec C s< | � d| j� | � d| j� t| jdd�}|dgks J �dS )zW Excluding a parent package should not exclude child packages as well. r )r r3 r. N)r r! r# r r r0 r r r �test_exclude_recursiveJ s z'TestFindPackages.test_exclude_recursivec C sJ | � d| j� | �d| j�}| � d|� t| jdgd�}|dgks#J �dS )zM If include is specified, other packages should be excluded. r � other_pkg)�includeN)r r! r r r )r �alt_dirr1 r r r �test_include_excludes_otherS s z,TestFindPackages.test_include_excludes_otherc C sV t �tj�| jd�� | �d| j�}| �d|� | �d|� t | j�}d|vs)J �d S )N�pkg/subpkg/assetsz some.datar zfile.datz pkg.some.data) r r r% r& r' r r r! r r )r �data_dirr1 r r r � test_dir_with_dot_is_skipped] s z-TestFindPackages.test_dir_with_dot_is_skippedc C s@ | � d| j�}| � d|�}| �d|� t| j�}d|vs J �dS )zk Ensure that a package in a non-package such as build/pkg/__init__.py is excluded. �buildr r z build.pkgN)r r r r )r � build_dir� build_pkg_dirr1 r r r �,test_dir_with_packages_in_subdir_is_excludede s z=TestFindPackages.test_dir_with_packages_in_subdir_is_excludedzSymlink support required)�reasonc C sT | � d| j� tj�| jd�}t�d|� tj�|�s J �t| j�}d|v s(J �dS )z� A symbolically-linked directory should be treated like any other directory when matched as a package. Create a link from lpkg -> pkg. r �lpkgr N) r r! r% r& r' r �symlink�isdirr )r � linked_pkgr1 r r r �$test_symlinked_packages_are_includedp s z5TestFindPackages.test_symlinked_packages_are_includedc C s t |�t |�ks J �d S r )�set)r �actual�expectedr r r �_assert_packages s z!TestFindPackages._assert_packagesc C s( t | jdgdgd�}| �|g d�� d S )Nzpkg*�pkg.subpkg.assets)r8 r4 �r � pkg.nspkgr. �r r rK r0 r r r �test_pep420_ns_package� s �z'TestFindPackages.test_pep420_ns_packagec C s$ t | jdgd�}| �|g d�� d S )NrL r3 )r r rN r. rO r0 r r r �"test_pep420_ns_package_no_includes� s z3TestFindPackages.test_pep420_ns_package_no_includesc C s" t | j�}g d�}| �||� d S )N)r r rN r. rL rO )r r1 rJ r r r �.test_pep420_ns_package_no_includes_or_excludes� s z?TestFindPackages.test_pep420_ns_package_no_includes_or_excludesc C s4 | � d| j� t| jddgd�}| �|g d�� d S )Nr r rL r3 rM )r r! r r rK r0 r r r �3test_regular_package_with_nested_pep420_ns_packages� s �zDTestFindPackages.test_regular_package_with_nested_pep420_ns_packagesc C s@ t �| j� t �tj�| jd�� t| j�}| �|g d�� d S )Nr; rM ) r r r r% r& r' r r rK r0 r r r �*test_pep420_ns_package_no_non_package_dirs� s z;TestFindPackages.test_pep420_ns_package_no_non_package_dirsr )�__name__� __module__� __qualname__r r r r r r2 r5 r6 r: r= rA �pytest�mark�skipifr � can_symlinkrG rK rP rQ rR rS rT r r r r r s( r c @ s� e Zd Zg d�ddgfddgddgfg d�g fg d�dgfg d �dgfg d �g d �fg d �g d �fd�Zej�de�� �dd� �ZdS )�TestFlatLayoutPackageFinder)z.pkg/__init__.py�pkg/__init__.pyzpkg/nested/file.txtr z pkg.nestedz_pkg/__init__.pyzpkg/_private/__init__.pyz pkg._private)zinvalid-pkg/__init__.pyzother.pkg/__init__.pyzyet,another/file.py)r] z docs/conf.pyzdocs/readme.rst)r] ztests/test_pkg.pyztests/__init__.py)r] zexamples/__init__.pyzexamples/file.pyzexample/other_file.pyzpkg/example/__init__.pyzpkg/examples/__init__.py)r z pkg.examplesz pkg.example)zhtmlcov/index.htmlr] ztasks/__init__.pyz tasks/subpackage/__init__.pyzfabfile/__init__.pyz fabfile/subpackage/__init__.pyzpkg/tasks/__init__.pyzpkg/fabfile/__init__.py)r z pkg.tasksz pkg.fabfile)zhidden-folderszprivate-packagesz invalid-namer �tests�examplesz tool-specific�examplec C s> | j | \}}t||� t�t|��}t|�t|�ks J �d S r )�EXAMPLES� ensure_filesr �find�strrH )r �tmp_pathr` �files�expected_packages�found_packagesr r r �&test_unwanted_directories_not_included� s zBTestFlatLayoutPackageFinder.test_unwanted_directories_not_includedN) rU rV rW ra rX rY � parametrize�keysri r r r r r\ � s. ��� � � ��.r\ c C s. |D ]}| | }|j jddd� |�� qd S )NT)�parents�exist_ok)�parentr( �touch)� root_pathrf �filer& r r r rb � s �rb )�__doc__r% r r rX � setuptoolsr r �setuptools.discoveryr � compat.py39r r r\ rb r r r r �<module> s 7 tests/__pycache__/script-with-bom.cpython-310.pyc 0000644 00000000301 15030122015 0015626 0 ustar 00 o �h � @ s d Z dS )�passedN)�result� r r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/script-with-bom.py�<module> s tests/__pycache__/mod_with_constant.cpython-310.pyc 0000644 00000000307 15030122015 0016327 0 ustar 00 o �h � @ s d Z dS )z three, sir!N)�value� r r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/mod_with_constant.py�<module> s tests/__pycache__/test_wheel.cpython-310.pyc 0000644 00000031655 15030122015 0014761 0 ustar 00 o �h�K � @ s� U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZ ddlZddlmZ ddlmZ ddlmZ ddlmZmZmZ dd lmZ d d l m Z d d l m Z dd l m!Z! ddl"m#Z# de$fdddddddd�fdddddddd�fdd ddd ddd�fd d d d!d"d#d$d�ffZ%ej&j'd%e%d&d'� e%D �d(�d)d*� �Z(ej)d�d+d,��Z*d-d.� Z+d/d0� Z,d1d2� Z-d3d4� Z.G d5d6� d6�Z/e0d7d8d9d:iie0d8gd;�e,d<g d=�d9gd>�i�d?�e0d@e0dAdB�dC�e0dDdEe dF�ie0dGdEgfgdH�e,d<g d=�dEgdI�i�d?�e0dJdKe dL�ie0e/dMdJdKgdN�gdO�e,dPdQdRg d=�igi�d?�e0dSdTe dU�ie0dTgdV�e,d<dTdRg d=�igi�d?�e0dWe dX�e dY�dZ�e0d[d\gd]�e,d<dRd^d_d`dadbd[d\gigii�d?�e0dcdde,d<dRg de�ii�e df�dg�e0dhdie j1�dj�e dk�dl�e0dmdne j1�do�dp�e0dqdrdsdtie du�dv�e0dwdsdxe j1�dy�ie dz�d{�e0d|d}dsd~ie d�dv�e0d�d8d�d9d:iiie0d8gd�gd��e,d<d�dRg d��id8d9d�d9gigigi�d?�e0d�d�d9d�iie0d�gd�gd��e,d<d�dRg d��id�d9gigi�d?�e0d�d8d:dEe d��id��ie0d8gd�d�gfgd��e,d<g d=�d9dGdEgigd>�i�d?�fZ2d�e3d�< ej&j'd�e2d�d'� e2D �d(�d�d�� �Z4d�d�� Z5d�d�� Z6d�d�� Z7d�d�� Z8dS )�z wheel tests� )� annotationsN)�Any)�path�� parse_tag)�canonicalize_name)�PY_MAJOR� Distribution� PathMetadata)�Wheel� )�tempdir)�DALS)�get_config_var)� get_platformz invalid.whlz&simplewheel-2.0-1-py2.py3-none-any.whl� simplewheelz2.0�1zpy2.py3�none�any)� project_name�version�build� py_version�abi�platformz$simple.dist-0.1-py2.py3-none-any.whlz simple.distz0.1z example_pkg_a-1-py3-none-any.whl� example_pkg_a�py3z9PyQt5-5.9-5.9.1-cp35.cp36.cp37-abi3-manylinux1_x86_64.whl�PyQt5z5.9z5.9.1zcp35.cp36.cp37�abi3�manylinux1_x86_64��filename�infoc C � g | ]}|d �qS )r � ��.0�tr$ r$ �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_wheel.py� <listcomp>Q � r) )�idsc sl t �|�r!t�|�� t| � W d � d S 1 sw Y d S t| �� � fdd�|�� D �|ks4J �d S )Nc s i | ]}|t � |��qS r$ )�getattr)r& �k��wr$ r( � <dictcomp>Y s z#test_wheel_info.<locals>.<dictcomp>)�inspect�isclass�pytest�raisesr �keysr r$ r. r( �test_wheel_infoP s ��"r6 c k s� � dt d�| �d�i}| r|�| � t� �)}t�||� tjtj dddf|d� t � t j� |dd��d V W d � d S 1 sBw Y d S ) N�setup.pyz� # -*- coding: utf-8 -*- from setuptools import setup import setuptools setup(**%r) �utf-8�-q� bdist_wheel��cwd�dist�*.whlr ) r �encode�updater r r � subprocess� check_call�sys� executable�glob�os�join)�extra_file_defs�kwargs� file_defs� source_dirr$ r$ r( � build_wheel\ s$ ��� � � "�rL c C sH t � }t�| �D ]\}}}|D ]}|�tj�tj�|| �|�� qq|S �N)�setrF �walk�addr rG �relpath)�root�contents�dirpath�dirnames� filenamesr! r$ r$ r( �tree_setu s �rW c sr t � }| �� D ]/\� }t|t�rt|�}|D ] }t|t�r+|� fdd�t|�D �O }q|�tj�� |�� qq|S )z8Flatten nested dicts and lists into a full list of pathsc s h | ] }t j�� |��qS r$ )rF r rG )r& �val��noder$ r( � <setcomp>� s z flatten_tree.<locals>.<setcomp>) rN �items� isinstance�dict� flatten_treerP rF r rG )�tree�outputrS �elemr$ rY r( r_ } s �r_ c C s dd� | D �S )Nc S s* h | ]}|j tt� td �ptd�d��qS )� EXT_SUFFIX�SO)r r � shlib_ext)�formatr r r )r& �xr$ r$ r( r[ � s ���z&format_install_tree.<locals>.<setcomp>r$ )r` r$ r$ r( �format_install_tree� s �rh c C s� t | �}tj�||�� �}|�|� |d ur)t|�}t|�} |�| �s)J || ��t |tj�|d��} t j || d�} | j |ksAJ �| j |ksHJ �|d u rU| �d�rSJ �d S || �d��� ks`J �d S )N�EGG-INFO)�metadata� requires.txt)r rF r rG �egg_name�install_as_eggrh rW �issubsetr r � from_filenamer r � has_metadata� get_metadata�lstrip) r! � install_dir�install_tree_includesr r � requires_txtr/ �egg_path� install_tree�exprj r= r$ r$ r( �_check_wheel_install� s ry c @ s e Zd Zdd� Zddd�ZdS ) �Recordc K s || _ || _d S rM ��_id�_fields)�self�idrI r$ r$ r( �__init__� s zRecord.__init__�return�strc C s | j � d| j�d�S )Nz(**�)r{ )r~ r$ r$ r( �__repr__� s zRecord.__repr__N)r� r� )�__name__� __module__� __qualname__r� r� r$ r$ r$ r( rz � s rz �basic�foo� __init__.py� )�packages�foo-1.0-py{py_version}.egg)�PKG-INFO�RECORD�WHEEL� top_level.txt)ri r� �r rJ � setup_kwargsrw r8 u Description accentuée)� description)r r� �datazdata.txtz. Some data... �data_dir)� data_files)ri r� � extensionz extension.can #include "Python.h" #if PY_MAJOR_VERSION >= 3 static struct PyModuleDef moduledef = { PyModuleDef_HEAD_INIT, "extension", NULL, 0, NULL, NULL, NULL, NULL, NULL }; #define INITERROR return NULL PyMODINIT_FUNC PyInit_extension(void) #else #define INITERROR return void initextension(void) #endif { #if PY_MAJOR_VERSION >= 3 PyObject *module = PyModule_Create(&moduledef); #else PyObject *module = Py_InitModule("extension", NULL); #endif if (module == NULL) INITERROR; #if PY_MAJOR_VERSION >= 3 return module; #endif } zsetuptools.Extension)�name�sources)� ext_modulesz%foo-1.0-py{py_version}-{platform}.eggzextension{shlib_ext}ri �headerzheader.hz )�headers�script�X #/usr/bin/python print('hello world!') �N #/bin/sh echo 'hello world!' �� script.py� script.shr� r� ��scriptsr� r� r� r� r� � requires1z foobar==2.0)r� r� r� rk r� z% foobar==2.0 )r �install_requiresrw ru � requires2z bar foo<=2.0; z in sys_platform z2 bar foo<=2.0 )r r� ru � requires3z bar; z != sys_platform )r r� � requires4z foo �extrazfoobar>3zG foo [extra] foobar>3 )r r� �extras_requireru � requires5zfoobar; z != sys_platformz! [extra] )r r� ru �requires_ensure_orderz9 foo bar baz qux za foobar>3 barbaz>4 bazqux>5 quxzap>6 z� foo bar baz qux [extra] foobar>3 barbaz>4 bazqux>5 quxzap>6 �namespace_package�barzfoo.bar)�namespace_packagesr� z foo-1.0-py{py_version}-nspkg.pth)r� r� r� znamespace_packages.txtr� �empty_namespace_package�foobarz7__import__('pkg_resources').declare_namespace(__name__)�data_in_packagez> Some data... )r� r� z foo/data_dirzfoo/data_dir/data.txt)r� r� ztuple[dict[str, Any], ...]�WHEEL_INSTALL_TESTS�paramsc C r# )r r$ )r& r� r$ r$ r( r) * r* c C s� | � dd�}| � dd�}| � dg �}| � di �}| � dd �}| � d�}| � d i �}| � d i �}td |||||d �|���-} t� �} t| | ||||� W d � n1 sTw Y W d � d S W d � d S 1 slw Y d S ) Nr� r� r �1.0r� r� ru rw rJ r� �r� r r� r� rH r$ )�getrL r ry ) r� r r r� r� ru rw rJ r� r! rs r$ r$ r( �test_wheel_install' s4 ���� �P�r� c C s� d} d}t | |d��=}t� �!}|�| t| ��}t�||� t||d t| �|d � W d � n1 s2w Y W d � d S W d � d S 1 sJw Y d S )N�Foo_Barr� )r� r )rL r �replacer �shutil�movery )r r r! rs � new_filenamer$ r$ r( �test_wheel_install_pep_503E s, ��� �P�r� c C s� d} d}| � d|� d�}t � �Q}tj�||�}t�|d��� t � �&}t�t �� t ||d | |d � W d � n1 s<w Y W d � n1 sKw Y W d � d S W d � d S 1 scw Y d S )N� nodistinfor� �-z-py2.py3-none-any.whlr/ ) r rF r rG �zipfile�ZipFile�closer3 r4 � ValueErrorry )r r � wheel_namerK � wheel_pathrs r$ r$ r( �test_wheel_no_dist_dir[ s" � �� ��"�r� c C s( dd� }| � d|� td��� sJ �d S )Nc S s dd� t d�D �S )Nc S s h | ] }|j |j|jf�qS r$ )� interpreterr r r% r$ r$ r( r[ l s ��z=test_wheel_is_compatible.<locals>.sys_tags.<locals>.<setcomp>z cp36-cp36m-manylinux1_x86_64r r$ r$ r$ r( �sys_tagsk s �z*test_wheel_is_compatible.<locals>.sys_tagsz$setuptools.wheel._get_supported_tagsz2onnxruntime-0.1.2-cp36-cp36m-manylinux1_x86_64.whl)�setattrr � is_compatible)� monkeypatchr� r$ r$ r( �test_wheel_is_compatiblej s r� c C st t jd dd��} tdtd�td�d�tddgd �td d d d dddddgigii�d�}|�dd�}|�dd�}|�d�}|�di �}|�di �}| d ||g i |d�|���[}t� �?}t|||||d � t|�} t � |�| � � } | d d d } | � � s~J �t jdkr�tt�| �� j��dks�J �W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S ) Nc { s� � dt d�| �d�i}| r|�| � t� �6}t�||� t�|�d }t� |d� t j t j dddf|d� t�tj�|d d ��d V W d � d S 1 sOw Y d S ) Nr7 z� # -*- coding: utf-8 -*- from setuptools import setup import setuptools setup(**%r) r8 r� i� r9 r: r; r= r> r )r r? r@ r r r �pathlib�PathrF �chmodrA rB rC rD rE rG )rH rI rJ rK �runshr$ r$ r( rL v s( ��� � � "�z$test_wheel_mode.<locals>.build_wheelr� r� r� r� r� r� r� r� ri r� r� r� r� r� r� r� r� r r� rw rJ r� r� �win32�0o777rM r$ )� contextlib�contextmanagerr^ r r_ r� r ry r r� r� rl �existsrC r �oct�stat�S_IMODE�st_mode) rL r� r r rw rJ r� r! rs r/ �base� script_shr$ r$ r( �test_wheel_modeu sp ���� ���� ���� � �P�r� rM )9�__doc__� __future__r r� rE r1 rF r� r� r� rA rC r� �typingr r3 �jaracor �packaging.tagsr �packaging.utilsr � pkg_resourcesr r r �setuptools.wheelr �contextsr �textwrapr �distutils.sysconfigr �distutils.utilr r� �WHEEL_INFO_TESTS�mark� parametrizer6 r� rL rW r_ rh ry rz r^ r r� �__annotations__r� r� r� r� r� r$ r$ r$ r( �<module> sh �� �� �� ���1� ���� ���� ������-�������D����������� ���� �� ����� �������� ��� ���� ����� ���� �����!���� ������� � � � p � tests/__pycache__/test_setuptools.cpython-310.pyc 0000644 00000023330 15030122015 0016065 0 ustar 00 o �h0# � @ sF d Z ddlZddlZddlZddlmZ ddlZddlmZ ddl Z ddl m Z ddl Z ddl mZ ddlZddlZddlmZ ddlmZ ejdd �d d � �Zd d � Zejjee d� dd�ZG dd� d�Z G dd� d�Z ejdd� �Z dd� Z dd� Z ejdd � �Z!ej�"d �d d � �Z#ejj$d d�d d!� �Z%d"d#� Z&d$d%� Z'dS )&z"Tests for the 'setuptools' package� N)�ZipFile)�Version)�Require)� Extension)�DistutilsSetupErrorT)�autousec C s d S �N� )� tmpdir_cwdr r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_setuptools.py� isolated_dir s r c K s< dt j_| �ddg� z tjdi | ��W dt j_S dt j_w )zDReturn distribution from 'setup(**args)', without executing commands� commandline� script_args�installNr )� distutils�core�_setup_stop_after� setdefault� setuptools�setup)�argsr r r � makeSetup s r �get_module_constantz bytecode support not available)�reasonc @ s@ e Zd Zdd� Zdd� Zedd� �Zedd� �Zed d � �Zd S ) � TestDependsc C sx t td�sd S dd� }|j}t�|dd�d u sJ �t�|dd�dks$J �t�|dd�dks/J �t�|d d�d u s:J �d S ) N�extract_constantc S s da tad S )N�test)�x�z�yr r r r �f15 s z(TestDepends.testExtractConst.<locals>.f1�q���r r r r )�hasattr�dep�__code__r )�selfr �fcr r r �testExtractConst0 s z TestDepends.testExtractConstc C s� t �t�� t�d� W d � n1 sw Y t �t�� t�d� W d � n1 s/w Y t�d�\}}}|�� d S )Nzno-such.-thingzsetuptools.non-existentzsetuptools.tests)�pytest�raises� ImportErrorr$ � find_module�close)r& �f�_p�_ir r r �testFindModuleH s � � zTestDepends.testFindModulec C sN ddl m} t�dd�|ksJ �t�dd�tjksJ �t�dd�tks%J �d S ) Nr �� __version__�jsonr3 �sys�versionz setuptools.tests.test_setuptools�__doc__)r4 r3 r$ r r5 r6 r7 )r& r3 r r r �testModuleExtractP s �z TestDepends.testModuleExtractc C s� t ddd�}|jdks J �|jdksJ �|jtd�ks J �|jdks$J �|�� dks,J �ddlm} t |� � �|ks<J �|� d�sCJ �|� d �rJJ �|� d �rQJ �|� � sWJ �|� � s]J �t d d d �}|� � riJ �|� � roJ �d S )N�Jsonz1.0.3r4 r3 z Json-1.0.3r r2 z1.0.9z0.9.1�unknownzDo-what-I-meanz1.0zd-w-i-m)r �name�module�requested_versionr � attribute� full_namer4 r3 �str� get_version� version_ok� is_present� is_current)r& �reqr3 r r r � testRequire[ s zTestDepends.testRequirec C s� t dd ddd�}|jd u sJ �|jd u sJ �|jd u s J �|�� dks%J �|jdks,J �ddlm} dd� |D �}|�|�s@J �|� |�sGJ �d S ) N�Tests�testszhttp://example.com)�homepager )�__path__c S s g | ]}t j�|��qS r )�os�path�dirname)�.0�pr r r � <listcomp>� s z4TestDepends.test_require_present.<locals>.<listcomp>) r �formatr> r= r? rI �setuptools.testsrJ rC rD )r& rE rJ �pathsr r r �test_require_presents s z TestDepends.test_require_presentN) �__name__� __module__� __qualname__r( r1 �needs_bytecoder8 rF rT r r r r r / s r c @ sL e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dS )� TestDistroc C sB t ddg�| _t ddg�| _tg d�ddg| j| jfi d�| _d S ) Nzbar.extzbar.czc.yzy.c)�aza.bza.b.c�b�czb.dr )�packages� py_modules� ext_modules� package_dir)r �e1�e2r �dist)r& �methodr r r � setup_method� s �zTestDistro.setup_methodc C s t | jtjj�s J �d S r )� isinstancerc r � Distribution�r& r r r �testDistroType� s zTestDistro.testDistroTypec C s� | j �d� | j jddgksJ �| j �d� | j jdgks J �| j jdgks(J �| j j| j| jgks4J �| j �d� | j jg ksBJ �| j jdgksKJ �| j j| jgksUJ �t� �d� d S )NrZ r[ r\ r )rc �exclude_packager] r^ r_ ra rb r rh r r r �testExcludePackage� s z TestDistro.testExcludePackagec C s~ | j j| jgd� | j j| jgksJ �| j j| jgd� | j j| j| jgks(J �| j j| jgd� | j j| j| jgks=J �d S )N�r_ )rc �excludera r_ rb �includerh r r r �testIncludeExclude� s z TestDistro.testIncludeExcludec C sL | j jg d�d� | j jg ksJ �| j jdgksJ �| j j| jgks$J �d S )N)r\ r[ rZ �r] r )rc rm r] r^ r_ ra rh r r r �testExcludePackages� s z TestDistro.testExcludePackagesc C s@ t � }|jdgdg| jgd� t � }|jdgdg| jgd� d S )NrZ r[ )r] r^ r_ )r rn rb rm )r& rc r r r � testEmpty� s zTestDistro.testEmptyc C s� | j �d�sJ �| j �d� | j �d�rJ �| j �d�s J �| j �d� | j �d�r,J �| j �d�s4J �| j �d� | j �d�rBJ �d S )NrZ r[ r\ )rc �has_contents_forrj rh r r r � testContents� s zTestDistro.testContentsc C s� t �t�� | jjdd� W d � n1 sw Y t �t�� | jjdd� W d � n1 s3w Y t �t�� | jjddid� W d � n1 sQw Y t �t�� | jjddid� W d � n1 sow Y t �t�� | jjddid� W d � n1 s�w Y t �t�� | jjddid� W d � n1 s�w Y t �t�� | jjdgd� W d � n1 s�w Y t �t�� | jjdgd� W d � d S 1 s�w Y d S )Nr )�nonexistent_optionr rp rl r! )r` )r) r* r rc rn rm rh r r r �testInvalidIncludeExclude� s0 � � � � � � � "�z$TestDistro.testInvalidIncludeExcludeN) rU rV rW re ri rk ro rq rr rt rv r r r r rY � s rY c C s* | � d� | d �d� | d �d� | S )N�foo� foo/bar.py� � readme.txt)�mkdir�write)�tmpdirr r r �example_source� s r~ c s< t t�t� ���}ddg}� fdd�|D �}||ks J �d S )Nrz rx c s g | ]}� � |��qS r )�join)rN �fn�r~ r r rP � s z test_findall.<locals>.<listcomp>)�listr �findallr@ �r~ �found�expectedr r� r � test_findall� s r� c C sV | � � � tt�� �}W d � n1 sw Y dtj�dd�g}||ks)J �d S )Nrz rw zbar.py)�as_cwdr� r r� rK rL r r� r r r �test_findall_curdir� s �r� c C sJ d}d}zt �||� W n tttfy t�d� Y nw t �|� dS )z/ Skip if cannot create a symbolic link �link�targetz Cannot create symbolic linksN)rK �symlink�OSError�NotImplementedError�AttributeErrorr) �skip�remove)r} �link_fn� target_fnr r r � can_symlink� s �r� c C sR | � � � t�dd� tt�� �}|g ksJ �W d � d S 1 s"w Y d S )Nrw �bar)r� rK r� r� r r� )r} r� r r r � test_findall_missing_symlink s "�r� z$unable to exclude tests; #4475 #3260c C sT t | ��}dd� |�� D �}W d � n1 sw Y |D ]}d|vs'J �q d S )Nc S � g | ] }|� tjd ��qS ��/��replacerK �sep�rN r. r r r rP � z=test_its_own_wheel_does_not_contain_tests.<locals>.<listcomp>z/tests/)r �namelist)�setuptools_wheel�zipfile�contents�memberr r r �)test_its_own_wheel_does_not_contain_tests s ��r� c C �T t | ��}dd� |�� D �}W d � n1 sw Y tdd� |D ��s(J �d S )Nc S r� r� r� r� r r r rP r� z3test_wheel_includes_cli_scripts.<locals>.<listcomp>c s s � | ]}d |v V qdS )z cli-64.exeNr �rN r� r r r � <genexpr> s � z2test_wheel_includes_cli_scripts.<locals>.<genexpr>�r r� �any�r� r� r� r r r � test_wheel_includes_cli_scripts s �r� c C r� )Nc S r� r� r� r� r r r rP r� z9test_wheel_includes_vendored_metadata.<locals>.<listcomp>c s s � | ] }t �d |�V qdS )z _vendor/.*\.dist-info/METADATAN)�re�searchr� r r r r� s � �z8test_wheel_includes_vendored_metadata.<locals>.<genexpr>r� r� r r r �%test_wheel_includes_vendored_metadata s ��r� )(r7 rK r� r5 r� r r) �packaging.versionr r �setuptools.depends�dependsr$ �setuptools.distr � distutils.cmdr �distutils.corer �distutils.errorsr �fixturer r �mark�skipifr# rX r rY r~ r� r� r� � usefixturesr� �xfailr� r� r� r r r r �<module> sH �WZ tests/__pycache__/environment.cpython-310.pyc 0000644 00000004101 15030122015 0015144 0 ustar 00 o �h � @ sb d dl Z d dlZd dlZd dlZd dlmZmZ d dlZ G dd� de j j �Z dd� Z d dd�Z dS ) � N)�PIPE�Popenc @ s e Zd ZdZdgZdd� ZdS )� VirtualEnvz.envz--no-setuptoolsc O sl | � |d �g|dd � }| jdd�|�}d|vr*ttj�}d|v r&|d= ||d< tj|g|�R i |��S )Nr � �utf-8)�cwd�encoding�env� PYTHONPATH)�exe�root�dict�os�environ� subprocess� check_output)�self�cmd�args�kwargsr � r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/environment.py�run s zVirtualEnv.runN)�__name__� __module__� __qualname__�name� create_optsr r r r r r s r c C sL t � }tj�dd��tj�D ]}tj�|| �}t�|tj �r#|� |� q|S )N�PATH� ) �setr r �get�split�pathsep�path�join�access�X_OK�add)r �resultr$ �filenamer r r � _which_dirs% s �r+ c C s |du rt � }tjD ] }tj| ||< q |dur ||d< |dur$||d< |�dd�s?td��td��|d< tj�|d �|d< tj dgt | � } tj dk}zt | t t ||d d �}t|t�rat|� }|�� | }W n tyr Y d S w t|d �r�|�� }t�d |�}|j|fS )z~ Execution command for tests, separate from those used by the code directly to prevent accidental behavior issues Nr r r �tar�gzipzsetup.py�win32r )�stdout�stderr�shellr r )r r �decode�NFC)r r r r! r+ �unionr# r% �sys� executable�list�platform�_Popen�_PIPE� isinstance�tuple�slice� communicate�OSError�hasattrr2 � unicodedata� normalize� returncode) r �pypathr$ � data_streamr �envnamer1 �proc�datar r r � run_setup_py. s@ � � rI )NNr N)r r r5 rA r r: r r9 � jaraco.envs�jaraco�envsr r+ rI r r r r �<module> s tests/__pycache__/test_build_py.cpython-310.pyc 0000644 00000025154 15030122015 0015461 0 ustar 00 o �hj7 � @ s@ d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlZ d dl Z d dl m Z d dl mZ ddlmZ dd � Zd d � Zd d � Ze jjddedd�dd� �Zed�dddddd�d�ed�d�Zdd� Ze j�d �d d � �Zed �d ddddd!�d"did#�iddd$�ed%�d&�Z d'd(� Z G d)d*� d*�Z d0d,d-�Z d.d/� Z dS )1� N)�Path)�Mock)� SetuptoolsDeprecationWarning)� Distribution� )�DALSc C s< t tddgdgddgid��}t�d� |�� |�� dS )z� Directories matching the glob in package_data should not be included in the package data. Regression test for #261. �setup.py�build_py� zpath/*�� script_name� script_args�packages� package_dataz path/subpathN)r �dict�os�makedirs�parse_command_line� run_commands�� tmpdir_cwd�dist� r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_build_py.py�%test_directories_in_package_data_glob s �� r c C sd t tddgdgddgid��}t�d� tdd��� |�� |�� t� t�d �j �s0J d ��d S ) zt Files matching recursive globs (**) in package_data should be included in the package data. #1806 r r r z path/**/datar zpath/subpath/subsubpathz path/subpath/subsubpath/data�wbz&build/lib/path/subpath/subsubpath/datazFile is not includedN) r r r r �open�closer r �stat�S_ISREG�st_moder r r r �#test_recursive_in_package_data_glob% s �� �r! c C s~ t tddgdgddgid��}t�d� tdd��� tdd��� t�dtj� t�dtj� |� � |� � t � d � d S ) z� Ensure read-only flag is not preserved in copy for package modules and package data, as that causes problems with deleting read-only files on Windows. #1451 r r �pkgzdata.datr �pkg/__init__.pyr z pkg/data.dat�buildN) r r r r r r �chmodr �S_IREADr r �shutil�rmtreer r r r �test_read_only? s �� r) z platform.system() == "Windows"z-On Windows, files do not have executable bitsT)�reason�raises�strictc C s~ t tddgdgddgid��}t�d� tdd��� tdd��� t�dd � |�� |�� t� d �j t j @ s=J d ��d S ) zv Ensure executable bit is preserved in copy for package data, as users rely on it for scripts. #2041 r r r" zrun-mer r# r z pkg/run-mei� zbuild/lib/pkg/run-mezScript is not executableN) r r r r r r r% r r r r �S_IEXECr r r r �test_executable_dataZ s" �� �r. z� [metadata] name = mypkg version = 42 [options] include_package_data = True packages = find: [options.packages.find] exclude = *.tests* r )� __init__.pyz test_mypkg.pyz test_file.txt)r/ �resource_file.txt�testsz� global-include *.py *.txt global-exclude *.py[cod] prune dist prune build prune *.egg-info )z setup.cfg�mypkg� MANIFEST.inc C s t j�t� tddi�}|�� |�d�}d}tjt |d�� t � d�dkr.t j dd d d � |�� |�� W d � n1 s@w Y t|�d�j�}|d �� sUJ �|d �� s]J �dD ] }t�t�� || �� roJ �W d � n1 syw Y q_t�d� d S )Nr � %PEP 517%r z9Python recognizes 'mypkg\.tests' as an importable package)�match�SETUPTOOLS_USE_DISTUTILS�stdlib�ignorez!'encoding' argument not specifiedzdistutils.text_file)�module�mypkg/__init__.pyzmypkg/resource_file.txt)zmypkg/tests/__init__.pyzmypkg/tests/test_mypkg.pyzmypkg/tests/test_file.txtz mypkg/testsz#3260)�jaraco�pathr$ �EXAMPLE_WITH_MANIFESTr �parse_config_files�get_command_obj�pytest�warnsr r �getenv�warnings�filterwarnings�finalize_options�runr � build_lib�existsr+ �AssertionError�xfail)r r r �msg� build_dir�fr r r �test_excluded_subpackages� s0 � � ��rN z/ignore::setuptools.SetuptoolsDeprecationWarningc C sF t j�t� tddi�}|�� |jsJ �|�d�}|�d� t t |j �� d��}|� � s/J �|�d�}|�� |�d�}t|jd�}|�|d|� |j�dd � |�|� d |_|�� |�� |�� |j�dd � |�|� ||_|�� |�� |js�J �td d � |�� �}|s�J �t t |j d ��� t j d �}||v s�J �d S )zwWhen provided with the ``existing_egg_info_dir`` attribute, build_py should not attempt to run egg_info again. r r4 �egg_infoz *.egg-infor )� side_effectrF � data_filesNc S s | � tjd�S )N�/��replacer �sep)�xr r r �<lambda>� s z(test_existing_egg_info.<locals>.<lambda>r: rR )!r; r< r$ r= r r> �include_package_datar? � run_command�nextr �egg_base�glob�is_dirrE r rF �setattr�__dict__�pop�reinitialize_command�existing_egg_info_dir� assert_called� reset_mock�assert_not_calledrQ �map� get_outputs�strrG rT r rU ) r � monkeypatchr rO � egg_info_dirr � egg_info_run�outputs�exampler r r �test_existing_egg_info� s: rn a; [project] name = "mypkg" version = "42" [tool.setuptools] packages = ["mypkg", "mypkg.sub1", "mypkg.sub2", "mypkg.sub2.nested"] [tool.setuptools.package-dir] "" = "src" "mypkg.sub2" = "src/mypkg/_sub2" "mypkg.sub2.nested" = "other" r2 )r/ zmod1.pyzmod2.py)r/ r0 �sub1�_sub2)r/ zmod3.pyzL global-include *.py *.txt global-exclude *.py[cod] )�pyproject.toml�src�otherr3 c C s t j�t� tddi�}|�� |�d�}d|_|�� |j � t j d�}dd� |� � D �}||� d�|� d �|� d �|� d �|� d �|� d �|� d�hksOJ �dd� |�� �� D �}||� d�d|� d �d|� d �d|� d �d|� d �d|� d �d|� d�diks�J �d S )Nr z%test%r TrR c S s h | ] }|� tjd ��qS �rR rS ��.0rV r r r � <setcomp>8 s z#test_get_outputs.<locals>.<setcomp>z/mypkg/__init__.pyz/mypkg/resource_file.txtz/mypkg/sub1/__init__.pyz/mypkg/sub1/mod1.pyz/mypkg/sub2/mod2.pyz /mypkg/sub2/nested/__init__.pyz/mypkg/sub2/nested/mod3.pyc S s* i | ]\}}|� tjd �|� tjd ��qS rt rS )rv �k�vr r r � <dictcomp>B s ��z$test_get_outputs.<locals>.<dictcomp>zsrc/mypkg/__init__.pyzsrc/mypkg/resource_file.txtzsrc/mypkg/sub1/__init__.pyzsrc/mypkg/sub1/mod1.pyzsrc/mypkg/_sub2/mod2.pyzother/__init__.pyz other/mod3.py)r; r< r$ �EXAMPLE_ARBITRARY_MAPPINGr r> r? � editable_mode�ensure_finalizedrG rT r rU rg �get_output_mapping�items)r r r rG rl �mappingr r r �test_get_outputs/ s: � � �r� c @ s� e Zd Zed�ed�ed�d�Zddddd�idd hd �dd ddd �iid dhd �dddiddd�ih d�d �d�Zej�ddej dejj dd�d�g�ej�de� � �dd� ��Z ej�dd g�ej�de� � �d d � ��Z d d � Zd!S )"�TestTypeInfoFileszV [project] name = "foo" version = "1" z� [project] name = "foo" version = "1" [tool.setuptools] include-package-data = false z� [project] name = "foo" version = "1" [tool.setuptools] include-package-data = false [tool.setuptools.exclude-package-data] "*" = ["py.typed", "*.pyi"] )�default_pyproject�dont_include_package_data�exclude_type_info�foor )�bar.pyi�py.typedr/ z foo/bar.pyi� foo/py.typed)�directory_structure�expected_type_files�bar)r� zmod.pyizfoo/bar/mod.pyizfoo/bar/py.typedzfoo.pyi)� namespace� __init__.pyir� > �foo/__init__.pyi�foo/namespace/foo.pyir� )�simple_namespace�nested_inside_namespace� namespace_nested_inside_regular� pyprojectr� r� zpypa/setuptools#4350)r* )�marksrm c C sX i | j | d �d| j| i�}| j | d }tj�|� t� }t|�}||ks*J �d S �Nr� rq r� )�EXAMPLES� PYPROJECTSr; r< r$ �get_finalized_build_pyrg ��selfr r� rm � structurer� r rl r r r �#test_type_files_included_by_default� s � � z5TestTypeInfoFiles.test_type_files_included_by_defaultr� c C sZ i | j | d �d| j| i�}| j | d }tj�|� t� }t|�}|�|�s+J �d S r� )r� r� r; r< r$ r� rg � isdisjointr� r r r � test_type_files_can_be_excluded� s � � z1TestTypeInfoFiles.test_type_files_can_be_excludedc C sF t d�ddd�d�}ddh}tj�|� t� }t|�}||ks!J �d S )Nzl [project] name = "foo-stubs" version = "1" r )r� r� )rq z foo-stubszfoo-stubs/__init__.pyizfoo-stubs/bar.pyi)r r; r< r$ r� rg )r� r r� r� r rl r r r �test_stub_only_package� s �� z(TestTypeInfoFiles.test_stub_only_packageN)�__name__� __module__� __qualname__r r� r� r@ �mark� parametrize�paramrJ �keysr� r� r� r r r r r� Q sj �� ��$��� ���� ��� ��( ��� r� �%build_py-test%c C s* t d| i�}|�� |�d�}|�� |S )Nr r )r r> r? rE )r r r r r r r� � s r� c s t | j�� � fdd�| �� D �S )Nc s$ h | ]}t j�|� ��t jd ��qS rt )r r< �relpathrT rU ru �rL r r rw � s ��z get_outputs.<locals>.<setcomp>)r rG rg )r r r� r rg � s �rg )r� )!r r' r rC �pathlibr � unittest.mockr � jaraco.pathr; r@ � setuptoolsr �setuptools.distr �textwrapr r r! r) r� rJ rI r. r= rN rD rn r{ r� r� r� rg r r r r �<module> s~ � ��� ��$ . 7��������*" tests/__pycache__/test_config_discovery.cpython-310.pyc 0000644 00000050100 15030122015 0017173 0 ustar 00 o �h4X � @ sX d dl Z d dlZd dlmZ d dlmZ d dlmZ d dlZ d dl Z d dl m Z d dl Z d dlmZ d dlmZmZ d dlmZ d d lmZ d d lmZ d d lmZmZm Z d d l m Z d dl Z G dd� d�Z!G dd� d�Z"G dd� d�Z#G dd� d�Z$G dd� d�Z%G dd� d�Z&dd� Z'd d � Z(d d � Z)d d!� Z*d"d#� Z+d$d%� Z,d&d'� Z-d(d)� Z.dS )*� N)� ConfigParser)�product)�cast)�Path)�sdist)�find_package_path�find_parent_package)� Distribution)�PackageDiscoveryError� )�quiet)�get_sdist_members�get_wheel_members�run)�DALSc @ s e Zd Zdd� Zdd� ZdS )�TestFindParentPackagec C sN |d j ddd� |d �� |d �� g d�}t|ddi|�d ks%J �d S ) Nzsrc/namespace/pkg/nestedT��exist_ok�parentsz$src/namespace/pkg/nested/__init__.pyz src/namespace/pkg/__init__.py)� namespace� namespace.pkgznamespace.pkg.nested� �srcr ��mkdir�touchr )�self�tmp_path�packages� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_config_discovery.py�test_single_package s z)TestFindParentPackage.test_single_packagec C sZ g d�}|D ]}|d|� � j ddd� |d|� d� �� qt|ddi|�d u s+J �d S )N)�pkg�pkg1�pkg2�src/Tr z /__init__.pyr r r )r r �multiple�namer r r �test_multiple_toplevel! s z,TestFindParentPackage.test_multiple_toplevelN)�__name__� __module__� __qualname__r! r( r r r r r s r c @ s� e Zd ZdZddidgd�dddiiddgid dgidd d gii i i i d � Zd dgddgddgdgdgd�Zdd� Zej� de� � �dd� �Z ej� de� � �dd � �Z e d �e d �e d �e d �d!�Zej� d"eg d#�dd ge� � ��d$d%� �Zej� d&d'gdhfd(gdd)hfd*gdd+hfd,gh d-�fd.gdd/hfd0gdhfd1gdhfg�d2d3� �Zej� d4d5gd6gg�d7d8� �Zd9d:� Zd;d<� Zd=d>� Zd?S )@� TestDiscoverPackagesAndPyModulesz�Make sure discovered values for ``packages`` and ``py_modules`` work similarly to explicit configuration for the simple scenarios. r r r" )� package_dirr r- �libr � py_modules�nszns.pkg) z explicit-srcz variation-libz explicit-flatzexplicit-single_modulezexplicit-namespacez automatic-srczautomatic-flatzautomatic-single_modulezautomatic-namespace�src/pkg/__init__.pyzsrc/pkg/main.pyzlib/pkg/__init__.pyzlib/pkg/main.pyzpkg/__init__.pyz pkg/main.py�pkg.pyzns/pkg/__init__.py)r r. �flat� single_moduler c C s, |� d�\}}}| j| }| j| }||fS )N�-)� partition�FILES�OPTIONS)r � circumstance�_�layout�files�optionsr r r � _get_infoF s z*TestDiscoverPackagesAndPyModules._get_infor9 c sb | � |�\}}t|||� t||�\}}dd� |jjD �}|D ]� t� fdd�|D ��s.J �q d S )Nc S s g | ] }|� tjd ��qS )�/)�replace�os�sep��.0�fr r r � <listcomp>S s zHTestDiscoverPackagesAndPyModules.test_sdist_filelist.<locals>.<listcomp>c 3 s � | ]}|� � �V qd S �N)�endswithrC ��filer r � <genexpr>U s � zGTestDiscoverPackagesAndPyModules.test_sdist_filelist.<locals>.<genexpr>)r> �_populate_project_dir�_run_sdist_programatically�filelistr< �any)r r r9 r< r= r: �cmd�manifestr rI r �test_sdist_filelistL s �z4TestDiscoverPackagesAndPyModules.test_sdist_filelistc C s" | � |�\}}t|||� |d �� |d �� |d �� |d �� |d �� |d �� |d �� |d �� t|� tt|�d ���}td � td � |�� |t |�ks]J �t t|�d ���}td � td � |�� dd� |D �}||ks~J �|D ]}d|vs�J �d|vs�J �q�d S )N�buildz build/libzbuild/bdist.linux-x86_64z build/bdist.linux-x86_64/file.pyzbuild/lib/__init__.pyzbuild/lib/file.py�distz dist/file.py� dist/*.tar.gz�~~~~~ sdist_members ~~~~~� � dist/*.whl�~~~~~ wheel_members ~~~~~c S � h | ] }|� d d�� dd��qS �r% r zlib/�r@ rC r r r � <setcomp>p � z@TestDiscoverPackagesAndPyModules.test_project.<locals>.<setcomp>) r> rL r r � _run_buildr �next�glob�print�join�setr ) r r r9 r< r= � sdist_files� wheel_files� orig_filesrJ r r r � test_projectW s0 �z-TestDiscoverPackagesAndPyModules.test_projectz� [metadata] name = myproj version = 0.0.0 [options] {param} = z� __import__('setuptools').setup( name="myproj", version="0.0.0", {param}=[] ) z� [build-system] requires = [] build-backend = 'setuptools.build_meta' [project] name = "myproj" version = "0.0.0" [tool.setuptools] {param} = [] zv [build-system] requires = [] build-backend = 'setuptools.build_meta' )� setup.cfg�setup.py�pyproject.toml�template-pyproject.toml)� config_file�paramr9 )ri rj rk c C s� | j | g d� }t||i � |dkr|�dd�}n| jd }|d j|dd� |}| j| j|d�}|| j|dd� t|i �} t| |�g ksJJ �d d d �| } t| | �d u sZJ �d S ) N)zmod.pyzother.pyr1 rk r: r5 rl �utf-8��encoding)rn r r/ )r/ r )r7 rL r@ �PURPOSEFULLY_EMPY� write_text�format� _get_dist�getattr) r r rm rn r9 r< �template_param� pyproject�configrT �otherr r r �test_purposefully_empty� s z8TestDiscoverPackagesAndPyModules.test_purposefully_empty)� extra_files�pkgszvenv/bin/simulate_venvzpkg-stubs/__init__.pyiz pkg-stubszother-stubs/__init__.pyiz other-stubsz namespace-stubs/pkg/__init__.pyi> �namespace-stubs.pkgr" �namespace-stubsz&namespace-stubs/pkg-stubs/__init__.pyir z_hidden/file.pyznews/finalize.pyc C s: | j d | }t||i � t|i �}t|j�|ksJ �d S )Nr3 )r7 rL ru rd r )r r r| r} r< rT r r r �!test_flat_layout_with_extra_files� s zBTestDiscoverPackagesAndPyModules.test_flat_layout_with_extra_filesr| zother/__init__.pyzother/finalize.pyc C sX | j d | }t||i � tjtdd�� t|i � W d � d S 1 s%w Y d S )Nr3 �multiple (packages|modules)��match�r7 rL �pytest�raisesr ru )r r r| r< r r r �+test_flat_layout_with_dangerous_extra_files� s "�zLTestDiscoverPackagesAndPyModules.test_flat_layout_with_dangerous_extra_filesc C s> | j d dg }t||i � t|i �}t|j�dhks J �d S )Nr4 zinvalid-module-name.pyr" )r7 rL ru rd r/ )r r r< rT r r r �#test_flat_layout_with_single_module� s zDTestDiscoverPackagesAndPyModules.test_flat_layout_with_single_modulec C sZ | j d dg }t||i � tjtdd�� t|i � W d � d S 1 s&w Y d S )Nr4 zvalid_module_name.pyr� r� r� )r r r< r r r �&test_flat_layout_with_multiple_modules� s "�zGTestDiscoverPackagesAndPyModules.test_flat_layout_with_multiple_modulesc C s� ddl m} d}|d jt|�dd� |d �� tj�� �|�� |� d� W d � n1 s1w Y t t |� d ���}d|v sEJ �d S ) zRegression for issue 3692r )� build_metaz%[project] name = "test" version = "1"rk ro rp zfoo.py�.Nz*.whl) � setuptoolsr� rs r r �jaraco�path�DirectoryStack�context� build_wheelr r` ra )r r r� rx rf r r r �%test_py_modules_when_wheel_dir_is_cwd� s �zFTestDiscoverPackagesAndPyModules.test_py_modules_when_wheel_dir_is_cwdN)r) r* r+ �__doc__r8 r7 r> r� �mark� parametrize�keysrR rh r rr r r{ r� r� r� r� r� r r r r r, + s� � �� !� � ���+�� �� �� �� r, c @ sT e Zd ZdZdgdgddgddgdgd gd �Zej�d e�� �d d � �Z dd� Z dS )� TestNoConfigz0.0.0z src/pkg1.pyzsrc/pkg2/__init__.pyzsrc/pkg3/__init__.pyzsrc/pkg3-stubs/__init__.pyzpkg4/__init__.pyzpkg4-stubs/__init__.pyz src/ns/nested/pkg1/__init__.pyzns/nested/pkg2/__init__.py)r# r$ �pkg3�pkg4zns.nested.pkg1zns.nested.pkg2�examplec C s0 t || j| i � t|i �}|�� |ksJ �d S rG )rL �EXAMPLESru �get_name)r r r� rT r r r �test_discover_name s z TestNoConfig.test_discover_namec C s> dg}t ||i � t|d� |d| j� d� }|�� s J �d S )Nz src/ns/nested/pkg/__init__.py�--sdistzdist/ns_nested_pkg-z.tar.gz)rL r_ �DEFAULT_VERSION�is_file)r r r< � dist_filer r r � test_build_with_discovered_name s z,TestNoConfig.test_build_with_discovered_nameN) r) r* r+ r� r� r� r� r� r� r� r� r r r r r� s � r� c @ s@ e Zd Zej�ddi fddddid�fg�dd� �Zd d � Zd S ) �TestWithAttrDirective)�folder�optsr r. zfind:�where)r � packages.findc C s� |� d�dg}t |||� |d jdd�}|dddiidd| i}tjj||d � t|i �}|�� dks6J �|�� d ks>J �|jsCJ �t d|j|�}t j� |�sRJ �|t |�� � v s\J �t|d � |d } | �� skJ �d S ) Nz/pkg/__init__.pyri ro rp r" � __init__.py� version = 42z'[metadata] version = attr: pkg.version ��prefix�42r� zdist/pkg-42.tar.gz)rL � read_textr� r� rS ru r� � get_versionr- r rA �existsr �partsr_ r� ) r r r� r� r< ry � overwriterT � package_pathr� r r r �test_setupcfg_metadata s" � z,TestWithAttrDirective.test_setupcfg_metadatac C s` t |dgi � dddiidd�}tjj||d� t|i �}|�� dks%J �|jd d iks.J �d S ) Nr1 r" r� r� zh[project] name = 'pkg' dynamic = ['version'] [tool.setuptools.dynamic] version = {attr = 'pkg.version'} �r rk r� r� r r )rL r� r� rS ru r� r- )r r r� rT r r r �test_pyproject_metadata< s � z-TestWithAttrDirective.test_pyproject_metadataN)r) r* r+ r� r� r� r� r� r r r r r� s �� r� c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�TestWithCExtensionc C s2 g d�}t ||i � d}|d jt|�dd� d S )N) zbenchmarks/file.pyz docs/Makefilezdocs/requirements.txtzdocs/source/conf.pyz proj/header.hz proj/file.pyz py/proj.cppz py/other.cppz py/file.pyz py/py.typedzpy/tests/test_proj.pyz README.rsta^ from setuptools import Extension, setup ext_modules = [ Extension( "proj", ["py/proj.cpp", "py/other.cpp"], include_dirs=["."], language="c++", ), ] setup(ext_modules=ext_modules) rj ro rp �rL rs r )r r r< � setup_scriptr r r � _simulate_package_with_extensionN s z3TestWithCExtension._simulate_package_with_extensionc C s� | � |� d}|d jt|�dd� d}|d jt|�dd� t|i �}|�� dks,J �|�� dks4J �|jd u s;J �|jd u sBJ �t|j �d ksKJ �|j d j dksUJ �d S ) z�Ensure that auto-discovery is not triggered when the project is based on C-extensions only, for backward compatibility. zr [build-system] requires = [] build-backend = 'setuptools.build_meta' rk ro rp zQ [metadata] name = proj version = 42 ri �projr� Nr r ) r� rs r ru r� r� r/ r �len� ext_modulesr' )r r rx �setupcfgrT r r r �*test_skip_discovery_with_setupcfg_metadatao s z=TestWithCExtension.test_skip_discovery_with_setupcfg_metadatac C sb | � |� d}|d jt|�dd� tjtdd�� t|i � W d � dS 1 s*w Y dS )a� When opting-in to pyproject.toml metadata, auto-discovery will be active if the package lists C-extensions, but does not configure py-modules or packages. This way we ensure users with complex package layouts that would lead to the discovery of multiple top-level modules/packages see errors and are forced to explicitly set ``packages`` or ``py-modules``. zT [project] name = 'proj' version = '42' rk ro rp r� r� N)r� rs r r� r� r ru )r r rx r r r �0test_dont_skip_discovery_with_pyproject_metadata� s "�zCTestWithCExtension.test_dont_skip_discovery_with_pyproject_metadataN)r) r* r+ r� r� r� r r r r r� M s ! r� c @ s� e Zd Zdd� ZdZdZdZej� ddde e�ifdd e e�ifd de e�ifd d e e�ifd de e�e d � ifd d e e�e d � ifg�d d� �Z dS )�TestWithPackageDatac C sF |� d�|� d�|� d�g}t ||i � d}|d jt|�dd� d S )Nz/proj/__init__.py�/proj/file1.txt�/proj/nested/file2.txtz/ global-include *.py *.txt z MANIFEST.inro rp r� )r r �src_rootr< rQ r r r �!_simulate_package_with_data_files� s � z5TestWithPackageData._simulate_package_with_data_fileszd [metadata] name = proj version = 42 [options] include_package_data = True z8 [project] name = "proj" version = "42" z: [tool.setuptools] package-dir = {"" = "src"} )r� r< r� ri rk r z� packages = find: package_dir = =src [options.packages.find] where = src zv [tool.setuptools] package-dir = {"" = "src"} c C s� t jj|t|�d� | �||� tj�|� d���tjd�tj�|� d���tjd�h}t |� t t |� d���}t d� t d�|�� ||ksJJ �tt |� d���}t d � t d�|�� d d � |D �}||kskJ �d S ) zq Make sure auto-discovery does not affect package include_package_data. See issue #3196. r� r� r? r� rU rV rW rX rY c S rZ r[ r\ rC r r r r] � r^ z@TestWithPackageData.test_include_package_data.<locals>.<setcomp>N)r� r� rS �strr� rA �normpathr@ rB r_ r r` ra rb rc r )r r r� r< �expectedre rf rg r r r �test_include_package_data� s * � z-TestWithPackageData.test_include_package_dataN) r) r* r+ r� �EXAMPLE_SETUPCFG�EXAMPLE_PYPROJECT�PYPROJECT_PACKAGE_DIRr� r� r� r r� r r r r r� � s< ����������%r� c C sL g d�}t | |i � ti �}t� |_|�� |jd u s J �|jd u s$J �d S )N)zdir1/__init__.pyzdir2/__init__.pyzfile.py)rL r �object� configuration� set_defaultsr/ r )r r< rT r r r �(test_compatible_with_numpy_configuration s r� c C sD t j�ddi� ti �}dg|_|�� |�� |�� dks J �d S )Nr2 r z--namer" )r� r� rS r � script_argsr� �parse_command_liner� )� tmpdir_cwdrT r r r �$test_name_discovery_doesnt_break_cli s r� c s� dddiit d�d�}tj�|� ti �� � jj�� �fdd�}|�� jd|� � �� � � � d ks4J �t � j �dhks>J �d S ) a According to #3545 it seems that ``name`` discovery is running, even when the project already explicitly sets it. This seems to be related to parsing of dynamic versions (via ``attr`` directive), which requires the auto-discovery of ``package_dir``. r" r� z__version__ = 42 z� [project] name = "myproj" # purposefully different from package name dynamic = ["version"] [tool.setuptools.dynamic] version = {"attr" = "pkg.__version__"} r� c s �� � � � dks J �d S )N�myproj)r� r �rT �orig_analyse_namer r �spy_analyse_name/ s zJtest_preserve_explicit_name_with_dynamic_version.<locals>.spy_analyse_name� analyse_namer� N) r r� r� rS r r� r� �setattr�parse_config_filesr� rd r )r� � monkeypatchr< r� r r� r �0test_preserve_explicit_name_with_dynamic_version s ��� r� c s^ dddd�}t jj|� d� t� |� � fdd�|D �}|D ]}|jjddd � |�� q d S ) Nz$import setuptools setuptools.setup()z# Example PackagezCopyright (c) 2018)rj z README.md�LICENSEr� c 3 s � | ]}� | V qd S rG r rC ��rootr r rK F s � z(_populate_project_dir.<locals>.<genexpr>Tr )r� r� rS �_write_setupcfg�parentr r )r� r< r= �basic�pathsr� r r� r rL ; s � �rL c C s |st d� d S t� }|�d� |�� D ]L\}}|dkr/|�d|� �� |d|� � �|� qt|t�r>d�|�|d |< qt|t�rXd�dd� |�� D ��}d| |d |< qt |�|d |< qt | d d d d �� }|� |� W d � n1 szw Y t d � t | d j d d �� d S )Nz ~~~~~ **NO** setup.cfg ~~~~~r= r� zoptions.z, rW c s s$ � | ] \}}d |� d|� �V qdS )� z = Nr )rD �k�vr r r rK Y s �" z"_write_setupcfg.<locals>.<genexpr>ri �wro rp z~~~~~ setup.cfg ~~~~~) rb r � add_section�items�update� isinstance�listrc �dictr� �open�writer� )r� r= r� �key�value� str_valuerE r r r r� L s( �r� c G s* t jdddg|�t| ��}t|ddid�S )Nz-mrS z--no-isolation�DISTUTILS_DEBUGr )�env)�sys� executabler� r )r� �flagsrP r r r r_ c s r_ c C s� d� tj�| ��}| d }|�� r2t| �� tttj j di dd��}W d � n1 s,w Y nt|�}||_ d|_ t| �� |� � W d � n1 sOw Y |�� |S )Nr? rj �init)� stop_after)rc rA r� �splitr� r r r � distutils�core� run_setupr� � script_namer� r� )� dist_path�attrsr� �scriptrT r r r ru h s$ � �� �ru c C s� t | |�}t|�}|�� |jjs|jjsJ �t� �- t| �� |�� W d � n1 s.w Y W d � ||fS W d � ||fS 1 sJw Y ||fS rG ) ru r �ensure_finalized� distributionr r/ r r r )r� r rT rP r r r rM ~ s (� ��rM )/rA r� � configparserr � itertoolsr �typingr � jaraco.pathr� r� r� r r� �setuptools.command.sdistr �setuptools.discoveryr r �setuptools.distr �setuptools.errorsr �contextsr �integration.helpersr r r �textwrapr �distutils.corer� r r, r� r� r� r� r� r� r� rL r� r_ ru rM r r r r �<module> s@ X0Ra $ tests/__pycache__/test_packageindex.cpython-310.pyc 0000644 00000033200 15030122015 0016264 0 ustar 00 o �hG" � @ s� d dl Zd dlZd dlZd dlZd dlmZ d dlZd dl Z d dl Z G dd� d�Z G dd� d�ZG dd� d�Zej�d �d d � �ZdS ) � N)�cleandocc @ st e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� ZdS ) �TestPackageIndexc C s8 d}|d7 }d� � jdi t� ��}tjj�|�sJ �d S )Nz&http://other_url?:action=show_md5&z'digest=0123456789abcdef0123456789abcdefz� <a href="http://some_url">Name</a> (<a title="MD5 hash" href="{hash_url}">md5</a>) � )�lstrip�format�locals� setuptools� package_index�PYPI_MD5�match)�self�hash_url�docr r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_packageindex.py� test_regex s ��zTestPackageIndex.test_regexc C sd t j�� }d}tjtt�|�d�� |�|�}t |t j j �s J �W d � d S 1 s+w Y d S )Nz.http://127.0.0.1:0/nonesuch/test_package_index�r � r r � PackageIndex�pytest�raises� Exception�re�escape�open_url� isinstance�urllib�error� HTTPError�r �index�url�vr r r �test_bad_url_bad_port s "�z&TestPackageIndex.test_bad_url_bad_portc C sh t jjdd�}d}tjtt�|�d�� |�|�}t |t j j �s"J �W d � d S 1 s-w Y d S )N�zwww.example.com��hostszMurl:%20https://svn.plone.org/svn/collective/inquant.contentmirror.plone/trunkr r r r r r �test_bad_url_typo s "�z"TestPackageIndex.test_bad_url_typoc C s^ t jjdd�}dd� }||_d}tjtdd�� |�|� W d � d S 1 s(w Y d S )Nr# r$ c W s t j�d��)N�line)�http�client� BadStatusLine)�argsr r r �_urlopen/ s z?TestPackageIndex.test_bad_url_bad_status_line.<locals>._urlopenzhttp://example.comr' r )r r r �openerr r r r )r r r, r r r r � test_bad_url_bad_status_line, s "�z-TestPackageIndex.test_bad_url_bad_status_linec C sv t jjdd�}d}z |�|� W td�� tjjy: } zt|�}d|v s/d|v s/d|v s/J �W Y d}~dS d}~ww ) zO A bad URL with a double scheme should raise a DistutilsError. r# r$ z2http://http://svn.pythonpaste.org/Paste/wphp/trunkznonnumeric portzgetaddrinfo failedzName or service not knownNz Did not raise) r r r r � distutils�errors�DistutilsError�str� RuntimeError)r r r r �msgr r r �test_bad_url_double_scheme7 s � ��z+TestPackageIndex.test_bad_url_double_schemec C s& t jjdd�}d}|�|d�sJ �d S )Nr# r$ z file:///tmp/test_package_indexT)r r r �url_ok)r r r r r r � test_url_okK s z TestPackageIndex.test_url_okc C sl t jj}|d�}d}||ksJ �|d�}d}||ks J �|d�}d}||ks(J �|d�}d}||ks4J �d S ) Nz reportlab-2.5.win32-py2.4.exe)� reportlab-2.5z2.4�win32zreportlab-2.5.win32.exe)r8 Nr9 z!reportlab-2.5.win-amd64-py2.7.exe)r8 z2.7� win-amd64zreportlab-2.5.win-amd64.exe)r8 Nr: )r r �parse_bdist_wininst)r �parse�actual�expectedr r r �test_parse_bdist_wininstP s z)TestPackageIndex.test_parse_bdist_wininstc C s2 t jjj}|d�\}}|dksJ �|dksJ �dS )zA Test the basic usage of _vcs_split_rev_from_url z https://example.com/bar@2995zhttps://example.com/bar�2995N)r r r �_vcs_split_rev_from_url)r �vsrfur �revr r r � test__vcs_split_rev_from_urlc s z-TestPackageIndex.test__vcs_split_rev_from_urlc C st |d }|� d�� }|�d� W d � n1 sw Y dtj�t|�� d }tj�|�}d|� � v s8J �dS )zR local_open should be able to read an index from the file system. z index.html�wz<div>content</div>Nzfile:�/�content) �open�writer �request� pathname2urlr2 r r � local_open�read)r �tmpdir� index_file�fr �resr r r �test_local_indexl s � z!TestPackageIndex.test_local_indexc s� ddg}g d��g d��dg�dg� g d��� ����fdd �|D �}|D ] \}}t tj�d | ��}|d jdks<J �|d j|ksEJ �q%d S )z6 EGG fragments must comply to PEP 440 � z1!)�0z0.0z0.0.0)�a0�b0�rc0z.post0z.dev0))rS rS )� +ubuntu.0rX )z +ubuntu-0rX )z +ubuntu_0rX c sN g | ]#� �D ] �t ���gd g�D ]��D ] }� ��fdd�|D ��qqqqS )rS c s g | ] }d � � ��|g��qS )rS )�join)�.0�loc��e�p�rr r � <listcomp>� s zATestPackageIndex.test_egg_fragment.<locals>.<listcomp>.<listcomp>)�sum)rZ �locs��dev�local�post�pre�releasesr\ r r` � s ���� �z6TestPackageIndex.test_egg_fragment.<locals>.<listcomp>z3http://example.com/example-foo.zip#egg=example-foo-r � N)�listr r �distros_for_url�version)r �epoch�versionsr! �vc�distsr rc r �test_egg_fragmentw s* ��� ���z"TestPackageIndex.test_egg_fragmentc C sr d}t j�� }|d }|�dddd|g� |�dd|ddd g� |�||�}|t|�ks.J �t|j�d ks7J �d S ) Nz7git+https://github.example/group/project@master#egg=foozproject@master�git�clone�--quiet�$https://github.example/group/projectz-C�checkout�master� )r r r �register�downloadr2 �len�calls)r �tmp_path�fpr r � expected_dir�resultr r r �test_download_git_with_rev� s � z+TestPackageIndex.test_download_git_with_revc C s: d}t j�� }|d }|�dddd|g� |�||� d S )Nz0git+https://github.example/group/project#egg=foo�projectrr rs rt ru )r r r ry rz )r r} r~ r r r r r r �test_download_git_no_rev� s �z)TestPackageIndex.test_download_git_no_revc C sV d}t j�� }d}tjtjj|d�� |�||� W d � d S 1 s$w Y d S )Nz'svn+https://svn.example/project#egg=fooz!.*SVN download is not supported.*r ) r r r r r r/ r0 r1 rz )r r} r r r4 r r r �test_download_svn� s "�z"TestPackageIndex.test_download_svnN)�__name__� __module__� __qualname__r r" r& r. r5 r7 r? rD rR rq r� r� r� r r r r r s , r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) �TestContentCheckersc C s@ t jj�d�}|�d�d�� |j�� dksJ �|�� s J �d S )N�3http://foo/bar#md5=f12895fdffbd45007040d2e44df98478z$You should probably not be using MD5�ascii� f12895fdffbd45007040d2e44df98478) r r � HashChecker�from_url�feed�encode�hash� hexdigest�is_valid�r �checkerr r r �test_md5� s �z TestContentCheckers.test_md5c C �. t jj�d�}|�d�d�� |�� sJ �dS )z<Content checks should succeed silently if no hash is presentz1http://foo/bar#something%20completely%20different�anythingr� N�r r r� r� r� r� r� r� r r r �test_other_fragment� s �z'TestContentCheckers.test_other_fragmentc C r� )z0Content checks should succeed if a hash is emptyzhttp://foo/bar#md5=r� r� Nr� r� r r r �test_blank_md5� s z"TestContentCheckers.test_blank_md5c C s t jj�d�}|jdksJ �d S )Nr� �md5)r r r� r� � hash_namer� r r r �test_get_hash_name_md5� s �z*TestContentCheckers.test_get_hash_name_md5c C s. t jj�d�}|�dd� d�}|dksJ �d S )Nr� c S s | S )Nr )�xr r r �<lambda>� s z1TestContentCheckers.test_report.<locals>.<lambda>zMy message about %szMy message about md5)r r r� r� �report)r r� �repr r r � test_report� s �z TestContentCheckers.test_reportN)r� r� r� r� r� r� r� r� r r r r r� � s r� c @ s e Zd Zdd� ZdS )�TestPyPIConfigc C sN |d }|j td�dd� tj�� }|jd }|jdks J �|jdks%J �d S )Nz.pypircz� [pypi] repository=https://pypi.org username=jaraco password=pity% zutf-8)�encodingzhttps://pypi.org�jaracozpity%)� write_textr r r � PyPIConfig�creds_by_repository�username�password)r � tmp_home_dir�pypirc�cfg�credr r r �test_percent_in_password� s �� z'TestPyPIConfig.test_percent_in_passwordN)r� r� r� r� r r r r r� � s r� ri c C s t jj�d� dS )z; REL should not hang on a contrived attack string. a < rel= N)r r �REL�searchr r r r � test_REL_DoS s r� )� http.clientr( r � urllib.errorr �urllib.request�inspectr r �setuptools.package_indexr �distutils.errorsr/ r r� r� �mark�timeoutr� r r r r �<module> s @% tests/__pycache__/test_dist_info.cpython-310.pyc 0000644 00000015576 15030122015 0015637 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlZddl Z ddl m Z ddl m Z eejjdd�ZG d d � d �ZG d d � d �Zd d� Zdd� ZdS )z$Test .dist-info style distributions.� N)�partial)�unpack_archive� )�DALS�utf-8��encodingc @ sd e Zd Zed�Zedd� �Zejdd� �Z dd� Z dd � Z d d � Z d d � Z ej�dd�dd� �ZdS )� TestDistInfoz� Metadata-Version: 1.2 Requires-Dist: splort (==4) Provides-Extra: baz Requires-Dist: quux (>=1.1); extra == 'baz' c K s" dd� |� � D �}| jd�|� S )Nc s s& � | ]\}}d j di t� ��V qdS )z{key}: {value} N� )�format�locals)�.0�key�valuer r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_dist_info.py� <genexpr> s �$ z.TestDistInfo.build_metadata.<locals>.<genexpr>� )�items� metadata_base�join)�cls�kwargs�linesr r r �build_metadata s zTestDistInfo.build_metadatac C sv d}|| }|� � |d }| jdd�}|j|dd� d}|| }|� � |d }| jdd d �}|j|dd� t|�S ) Nz%VersionedDistribution-2.718.dist-info�METADATA�VersionedDistribution)�Namer r z!UnversionedDistribution.dist-info�UnversionedDistribution�0.3)r �Version)�mkdirr � write_text�str)�self�tmpdir�dist_info_name� versioned�filename�content� unversionedr r r �metadata# s$ ��zTestDistInfo.metadatac C s\ t dd� t�|�D ��}t|�dksJ |��|d }|d }|jdks%J �|jdks,J �d S )Nc s s � | ]}|j |fV qd S �N)� project_name)r �dr r r r ; s � �z-TestDistInfo.test_distinfo.<locals>.<genexpr>� r r z2.718r )�dict� pkg_resources�find_distributions�len�version)r# r* �distsr) r& r r r � test_distinfo: s �zTestDistInfo.test_distinfoc C sv d}t ttjj|��}t�|�D ](}|�� |d d� ks J �|jdd�|d tj�d�gks0J �|jdgks8J �qd S )N)z splort==4z quux>=1.1r )�baz)�extrasr zquux>=1.1;extra=="baz"r6 )�list�mapr0 � Requirement�parser1 �requiresr7 )r# r* �specsr< r- r r r � test_conditional_dependenciesG s ��z*TestDistInfo.test_conditional_dependenciesc C sh d}|d j |dd� t�dtjtjB �}td|dd�}|js!J �|�|j�s)J �t |� d ��r2J �d S ) zA Supplying an invalid version crashes dist_info. z@[metadata] name=proj version=42 [egg_info] tag_build=invalid!!! � setup.cfgr r zinvalid version� dist_infoF)�cwd�check� *.dist-infoN) r! �re�compile�M�I�run_command_inner� returncode�search�stdoutr8 �glob)r# �tmp_path�config�msg�procr r r �test_invalid_versionS s z!TestDistInfo.test_invalid_versionc C s� d}|d j |dd� ttdd|d�� t|�d��}|j�d �s#J �t�|� ttdd d |d�� t|�d��}|j�d �sAJ �d S ) Nz [metadata] name=proj version=42 [egg_info] tag_date=1 tag_build=.post r? r r r@ z --no-date�rA rC zproj-42z --tag-buildz.azproj-42a) r! �print� run_command�nextrL �name� startswith�shutil�rmtree)r# rM rN r@ r r r �test_tag_arguments_ s z TestDistInfo.test_tag_arguments� keep_egg_info)FTc C s� d}|d j |dd� |d }|�� |rdgng }tdd|g|�R d |i� tt|�d ���d ks4J �tt|�d ���d ksAJ �t|�}tt|�d ���|ksRJ �tt|�d ���d ks_J �tt|�d���d kslJ �tt|�d���d ksyJ �d S )Nz [metadata] name=proj version=42 r? r r �__outz--keep-egg-infor@ z --output-dirrA rC r r z *.egg-infoz *.__bkp__)r! r rT r2 r8 rL �int)r# rM r[ rN �out�opts�expected_egg_infor r r �test_output_dirs s z TestDistInfo.test_output_dirN)�__name__� __module__� __qualname__r r � classmethodr �pytest�fixturer* r5 r> rQ rZ �mark� parametrizera r r r r r s � r c @ sX e Zd ZdZed�Zg d�Zej� dd� � �ej� ddg�ej� de�d d � ���Z d S ) �TestWheelCompatibilityz�Make sure the .dist-info directory produced with the ``dist_info`` command is the same as the one produced by ``bdist_wheel``. ae [metadata] name = {name} version = {version} [options] install_requires = foo>=12; sys_platform != "linux" [options.extras_require] test = pytest [options.entry_points] console_scripts = executable-name = my_package.module:function discover = myproj = my_package.other_module:function ))r r )�.postz [egg_info] tag_build = post )rk z [egg_info] tag_build = .post )rk z)[egg_info] tag_build = post tag_date = 1 )�.devz [egg_info] tag_build = .dev )rl z)[egg_info] tag_build = .dev tag_date = 1 )�a1z[egg_info] tag_build = .a1 )z+localz [egg_info] tag_build = +local rV z my-proj my_proj my.proj My.Projr3 z0.42.13)�suffix�cfgc C s� | j j||d�| }dD ]}|| �� || d j|dd� q td|d d� t|�d ��}t||d � t|�d ��} td |d d� t|�d��} | j| jksTJ �| j� d|� |� ��saJ �dD ]} t | | �t | | �kssJ �qcd S )N)rV r3 )� dir_wheel�dir_distr? r r � bdist_wheelrp rR zdir_wheel/dist/*.whl�unpackzunpack/*.dist-infor@ rq zdir_dist/*.dist-infozmy_proj-)r zentry_points.txt) �SETUPCFGr r r! rT rU rL r rV rW �read) r# rV r3 rM rn ro rN �i�wheel�wheel_dist_infor@ �filer r r �&test_dist_info_is_the_same_as_in_wheel� s �z=TestWheelCompatibility.test_dist_info_is_the_same_as_in_wheelN) rb rc rd �__doc__r rt � EGG_INFO_OPTSrf rh ri �splitrz r r r r rj � s � rj c O s@ t jt jdddd�|�}tjddgtt| ��} t j| fi |��S )NTr )�stderrrK �textr rB z-cz __import__('setuptools').setup())� subprocess�STDOUT�PIPE�sys� executabler9 r" �run)�cmdr r_ r r r rH � s ��rH c O s t | i |��jS r+ )rH rK )�argsr r r r rT � s rT )r{ �pathlibrD rX r� r� � functoolsr rf r0 �setuptools.archive_utilr �textwrapr �Path� read_textru r rj rH rT r r r r �<module> s p@ tests/__pycache__/namespaces.cpython-310.pyc 0000644 00000005275 15030122015 0014734 0 ustar 00 o �h� � @ sJ d dl Z d dlZd dlZd dlmZ dd� Zd dd�Zd d � Zd d � ZdS )� N)�Pathc c s: � | � d�}tt|��D ]}d�|d |d � �V q d S )N�.� )�split�range�len�join)� namespace�parts�i� r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/namespaces.py�iter_namespace_pkgs s � �r �1.0� pkg_resourcesc C s* | | }|� � |d }|�d�\}}}tt|��} ||| d�} |dkr+d} | | d< n|dkr2d} ntd |�d ���tj| d d �} t�| �sHJ �t � d �j | d�} |j | dd� t ||�dd��}|j dd� | D ]}||�dd� d }|j | dd� qi||d }dj di t� ��}|j |dd� |S )Nzsetup.pyr )�name�version�packagesr z7__import__("pkg_resources").declare_namespace(__name__)�namespace_packages�pkgutilz@__path__ = __import__("pkgutil").extend_path(__path__, __name__)zCannot recognise impl=z when creating namespaces� )�indentzY import setuptools args = {args} setuptools.setup(**args) )�args�utf-8��encoding�/T��parentsz __init__.py�.pyzname = {rest!r}r )�mkdir� rpartition�listr � ValueError�json�dumps�ast� literal_eval�textwrap�dedent�format� write_textr �replace�locals)�tmpdirr r �impl�src_dir�setup_pyr �_�rest� namespaces� setup_args�tmplr �script� ns_pkg_dir�ns�pkg_init�pkg_mod�some_functionalityr r r �build_namespace_package s@ � �� r= c C s� | | }|� � |d }|�d�\}}}d|� d�}|jt�|�dd� t||�dd��}|j dd � ||d } d |��} | j| dd� |S ) Nzpyproject.tomlr z� [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "z&" version = "3.14159" r r r Tr r zname = )r r! r+ r( r) r r, ) r. r r0 � pyprojectr r2 r3 r7 r8 r; r< r r r � build_pep420_namespace_package: s � r? c C s4 | d }t | �}d}|j|jdi t� ��dd� dS )z� Add a sitecustomize.py module in target to cause target to be added to site dirs such that .pth files are processed there. zsitecustomize.pyz-__import__("site").addsitedir({target_str!r})r r Nr )�strr+ r* r- )�target�sc� target_strr6 r r r � make_site_dirQ s rD )r r ) r& r$ r( �pathlibr r r= r? rD r r r r �<module> s - tests/__pycache__/test_glob.cpython-310.pyc 0000644 00000001727 15030122015 0014575 0 ustar 00 o �hw � @ sN d dl Z d dlmZ d dlmZ e j�dddg fddg fddf�d d � �ZdS ) � N)�path)�glob)�tree�pattern�matches� � )�� appveyor.yml CHANGES.rst LICENSE MANIFEST.in pyproject.toml README.rst setup.cfg setup.py z*.rst)z CHANGES.rstz README.rst)r s *.rst)s CHANGES.rsts README.rstc C sF | � |� t�dd� |�� D �� ttt|���tt|��ks!J �d S )Nc S s i | ]}|d �qS )r � )�.0�namer r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_glob.py� <dictcomp>, s z test_glob.<locals>.<dictcomp>)�chdirr �build�split�list�sortedr )� monkeypatch�tmpdirr r r r r r � test_glob s $$r )�pytest�jaracor �setuptools.globr �mark� parametrizer r r r r �<module> s ��# tests/__pycache__/test_editable_install.cpython-310.pyc 0000644 00000110121 15030122015 0017136 0 ustar 00 o �hw� � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlmZ d dl m Z d dl m Z d dl mZ d dlmZ d dlmZ d d lmZ d d lmZ d dlZd dlZd dlZd dlmZ d d l m Z d d l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) d d l*m+Z+ d dl,m-Z- d dl.m/Z/ ddl0m1Z1m2Z2 d dl3m4Z4 ej5ddgd�dd� �Z6ed�ed��7� ddd ed �ed �d d d!�id"�Z8d#Z9ej:j;ejd$kd%d&�ej:�<d'i e8�d(e9i�e8g�d)d*� ��Z=d+d,� Z>d-d.� Z?G d/d0� d0�Z@G d1d2� d2�ZAd3d4� ZBG d5d6� d6�ZCd7d8� ZDG d9d:� d:�ZEG d;d<� d<�ZFej:�Gd=�d>d?� �ZHd@dA� ZIG dBdC� dC�ZJG dDdE� dE�ZKG dFdG� dG�ZLdHdI� ZMej:�GdJ�dKdL� �ZNdMdN� ZOdOdP� ZPdQdR� ZQd^dXdY�ZRd_d\d]�ZSdS )`� )� annotationsN)�deepcopy)� import_module)�EXTENSION_SUFFIXES)�Path)�dedent)�Any)�Mock)�uuid4)� resources) �_DebuggingTips� _encode_pth�_find_namespaces�_find_package_roots�_find_virtual_namespaces�_finder_template� _LinkTree�_TopLevelFinder�editable_wheel)� Distribution)� Extension)� SetuptoolsDeprecationWarning� )�contexts� namespaces)� run_setup�strict�lenient)�paramsc C s | j dkr ddgS g S )Nr �--config-settings�editable-mode=strict)�param)�request� r# �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/test_editable_install.py� editable_opts+ s r% a� [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" license = {text = "MIT"} description = "This is a Python package" dynamic = ["readme"] classifiers = [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers" ] urls = {Homepage = "https://github.com"} [tool.setuptools] package-dir = {"" = "src"} packages = {find = {where = ["src"]}} license-files = ["LICENSE*"] [tool.setuptools.dynamic] readme = {file = "README.rst"} [tool.distutils.egg_info] tag-build = ".post0" zr global-include *.py *.txt global-exclude *.py[cod] prune dist prune build zThis is a ``README``z!---- placeholder MIT license ----�mypkga import sys from importlib.metadata import PackageNotFoundError, version try: __version__ = version(__name__) except PackageNotFoundError: __version__ = "unknown" a from importlib.resources import read_text from . import __version__, __name__ as parent from .mod import x data = read_text(parent, "data.txt") print(__version__, data, x) zx = ''z Hello World)� __init__.pyz __main__.py�mod.pyzdata.txt)�pyproject.toml� MANIFEST.inz README.rstz LICENSE.txt�srcz __import__('setuptools').setup()�darwin�pypa/setuptools#4328��reason�files�setup.pyc C s� | d }|� � tjj||d� ddddddt|�g|�}t|�|�� g d �}|�|��� d ks3J �|d jd d d� |d jdd d� |�|��� dksPJ �d S )Nr& ��prefix�python�-m�pip�install�--no-build-isolation�-e)r4 r5 r& z3.14159.post0 Hello Worldzsrc/mypkg/data.txt�foobar�utf-8��encodingzsrc/mypkg/mod.py�x = 42z3.14159.post0 foobar 42) �mkdir�jaraco�path�build�str�print�run�strip� write_text)�tmp_path�venvr0 r% �project�cmdr# r# r$ � test_editable_with_pyproject| s& �� rL c C sz dt d�ddidd�i}tjj|| d� | d }dd d d d d t|�g|�}t|�|�� g d�}|�|��� dks;J �d S )Nr& ac [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" [tool.setuptools] packages = ["pkg"] py-modules = ["mod"] r' za = 4�b = 2)r) �pkgr( r2 r4 r5 r6 r7 r8 r9 )r4 �-cz$import pkg, mod; print(pkg.a, mod.b)z4 2�r r@ rA rB rC rD rE rF �rH rI r% r0 rJ rK r# r# r$ � test_editable_with_flat_layout� s. ����� rR c C st dt d�dd�i}tjj|| d� | d }dddd d d t|�g|�}t|�|�� g d �}|�|��� d ks8J �d S )Nr& a> [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "mod" version = "3.14159" [tool.setuptools] py-modules = ["mod"] rM )r) r( r2 r4 r5 r6 r7 r8 r9 )r4 rO zimport mod; print(mod.b)�2rP rQ r# r# r$ � test_editable_with_single_module� s, ����� rT c @ s8 e Zd Zdd� Zej�dd�ej�dd�dd� ��Zd S ) �TestLegacyNamespacesc C s� t jtdd�}|d }|�� d}|D ]O}tj||dd�}|�; |�� �'}|�|� tddd �} t | �} | � � | � d �j } | � || � W d � n1 sNw Y W d � n1 s]w Y qt|�d ��} t| �t|�kstJ �d S ) Nz .*namespace_packages parameter.*��matchz.installation_dir)z myns.pkgAz myns.pkgB� myns.n.pkgA� myns.n.pkgB�42)�versionr1 �config)� stop_after� dist_infoz *-nspkg.pth)�pytest�warnsr r? r �build_namespace_package�context�chdirr r �finalize_options�get_finalized_command�name�_install_namespaces�list�glob�len) �selfrH � monkeypatch� deprecation�installation_dir�examplesrf rN �ctx�distrK � editable_namer0 r# r# r$ �test_nspkg_file_is_unique� s* � �� �z.TestLegacyNamespaces.test_nspkg_file_is_unique�impl)� pkg_resources�ns)zmyns.nc C s� d}t j||� d�|d�}t j||� d�|d�}|d j|dd� |d j|dd� |dd� } | �d � |�d d d d t|�g| �� |�d d d d dt|�g| �� |�d dd|� d|� d�g� |�g d�� dS )a> Installing two packages sharing the same namespace, one installed naturally using pip or `--single-version-externally-managed` and the other installed in editable mode should leave the namespace intact and both packages reachable by import. (Ported from test_develop). zq [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" z.pkgA)rt z.pkgBr) r; r< Nr8 r4 r5 r6 r7 r9 rO zimport z.pkgA; import )r4 rO zimport pkg_resources)r ra rG �appendrE rC ) rk rI rH rv rt r% � build_system�pkg_A�pkg_B�optsr# r# r$ �!test_namespace_package_importable s z6TestLegacyNamespaces.test_namespace_package_importableN)�__name__� __module__� __qualname__rs r_ �mark� parametrizer| r# r# r# r$ rU � s � rU c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�TestPep420Namespacesc C sz t �|d�}t �|d�}|dd� }|�d� |�ddddt|�g|�� |�ddddd t|�g|�� |�g d �� dS ) z� Installing two packages sharing the same namespace, one installed normally using pip and the other installed in editable mode should allow importing both packages. rX rY Nr8 r4 r5 r6 r7 r9 )r4 rO z&import myns.n.pkgA; import myns.n.pkgB)r � build_pep420_namespace_packagerw rE rC )rk rI rH r% ry rz r{ r# r# r$ r| . s z6TestPep420Namespaces.test_namespace_package_importablec C s� dt d�ddid�i}tjj||d� |d }t�|d�}t�|d�}|d d � }|�d � |�d d d dt|�g|�� |�d d d ddt|�g|�� |�d d d ddt|�g|�� |�g d�� d S )z@Currently users can create a namespace by tweaking `package_dir`�pkgAat [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "pkgA" version = "3.14159" [tool.setuptools] package-dir = {"myns.n.pkgA" = "src"} r' �a = 1)r) r+ r2 rY z myns.n.pkgCNr8 r4 r5 r6 r7 r9 )r4 rO z#from myns.n import pkgA, pkgB, pkgC) r r@ rA rB r r� rw rE rC ) rk rI rH r% r0 ry rz �pkg_Cr{ r# r# r$ �&test_namespace_created_via_package_dir= s" ��� z;TestPep420Namespaces.test_namespace_created_via_package_dirc C s� dt d�ddddd�d�td d �i}tjj||d � |d }d g}|�d d ddddt|�g|�� |�g d��}|�� dksAJ �d}|�d dt |�g�}d|v sSJ �dS )a/ Sometimes users might specify an ``include`` pattern that ignores parent packages. In a normal installation this would ignore all modules inside the parent packages, and make them namespaces (reported in issue #3504), so the editable mode should preserve this behaviour. r� ar [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "pkgA" version = "3.14159" [tool.setuptools] packages.find.include = ["mypkg.*"] � zb = 1r� )r' zpkgA.py)r' zother.py�nr* )r) r& r* r2 r8 r4 r5 r6 �-vr7 r9 )r4 rO z'from mypkg.n import pkgA; print(pkgA.a)�1z} try: import mypkg.other except ImportError: print("mypkg.other not defined") rO zmypkg.other not definedN)r �EXAMPLEr@ rA rB rE rC rF )rk rI rH r0 ry r{ �outrK r# r# r$ �0test_namespace_accidental_config_in_lenient_mode_ s, ����� zETestPep420Namespaces.test_namespace_accidental_config_in_lenient_modeN)r} r~ r r| r� r� r# r# r# r$ r� - s "r� c s� | d � � fdd�t jD �}|D ]}|jdd� qt|� ttjtj�t t |��d�}t j ddd d t |�d t � �d g |�}t j ||d � t�� dkrLdnd}� | d }t j |g|d � dS )z> Editable install to a prefix should be discoverable. r3 c s4 g | ]}d |v r|� tj�r� t|��tj� �qS )z site-packages)� startswith�sysr3 r � relative_to)�.0rA r2 r# r$ � <listcomp>� s �z-test_editable_with_prefix.<locals>.<listcomp>T)�parents)� PYTHONPATHr5 r6 r7 z --editablez--prefixr8 )�env�Windows�Scripts�bin�sampleN)r� rA r? � _addsitedirs�dict�os�environ�pathsep�join�maprC � executable� subprocess� check_call�platform�system) rH �sample_projectr% �site_packages_all�spr� rK r� �exer# r2 r$ �test_editable_with_prefix� s0 � � � r� c @ sh e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� ZdS )�TestFinderTemplate��This test focus in getting a particular implementation detail right. If at some point in time the implementation is changed for something different, this test can be modified or even excluded. c C s i }t |||� |d � d S )Nr7 )�exec)rk �finder�locr# r# r$ �install_finder� s z!TestFinderTemplate.install_finderc C s. ddddid�iddid�}t jj||d � t|d �t|d �d �}ttt� �|i �}t�� �] t�� �@ d D ] }t j � |d � q8| � |� t d�}t d�}t d�}|jdksZJ �|jdksaJ �t|d �� �} t|| � W d � n1 sxw Y W d � d S W d � d S 1 s�w Y d S )N�pkg1r� �mod1.pyza = 42)r' �subpkg�mod2.pyza = 43��src1�src2r2 z src1/pkg1z src2/mod2)r� �mod2)r� � pkg1.subpkg�pkg1.subpkg.mod1r� r� r� r� �* �+ zsrc1/pkg1/subpkg)r@ rA rB rC r r r � save_paths�save_sys_modulesr� �modules�popr� r �a�resolve� assert_path) rk rH r0 �mapping�template�mod�mod1r� r� �expectedr# r# r$ � test_packages� s0 ��� � P�z TestFinderTemplate.test_packagesc C s" dddd�i}t jj||d� dt|d �i}dg i}ttt� �||�}t�� �_ t�� �B dD ] }t j � |d � q0| � |� t d�}t�|�d }t|d �� �} t|| � |jd ks^J �|jd d �dkshJ �W d � n1 srw Y W d � d S W d � d S 1 s�w Y d S ) NrN �a = 13�abc)r' �text.txtr2 � ns.othernamerv �rv r� r� � r; r< )r@ rA rB rC r r r r� r� r� r� r� r� r �importlib_resourcesr0 r� r� r� � read_text) rk rH r0 r� r r� r� rN �textr� r# r# r$ �test_namespace� s P�z!TestFinderTemplate.test_namespacec C sD ddddiiidddiid�}t jj||d� t|d �t|d �d �}dt|d �t|d �gi}ttt� �||�}t�� �Y t�� �< dD ] }t j � |d � qG| � |� t d�}t d�}t|d �� �} t|| � |jdksrJ �|jdksyJ �W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S )Nrv r� r' r� r� �b = 37r� r2 z src1/ns/pkg1zsrc2/ns)�ns.pkgArv r� r� )rv r� �ns.mod2r� r� r� �% )r@ rA rB rC r r r r� r� r� r� r� r� r r� r� r� �b) rk rH r0 r� � namespaces_r� r� r� r� r� r# r# r$ �test_combine_namespaces� s( � � P�z*TestFinderTemplate.test_combine_namespacesc C s� dddiidddiid�}t j�� }|�|��0 t j�|� dd d d �d d gd�}t|�}t|tt� ��}t dd� |� � D ��}W d � n1 sJw Y t � � �x t � � �[ |d D ] }tj�|d� q]| �|� td�} td�} t|d �� �} tt| j��� �| ks�J �t|d �� �} tt| j��� �| ks�J �| jdks�J �| jdks�J �W d � n1 s�w Y W d � dS W d � dS 1 s�w Y dS )z� Users may attempt to combine namespace packages in a nested way via ``package_dir`` as shown in pypa/setuptools#4248. � my_packagez my_module.pyr� � my_package2z my_module2.pyr� )r+ r� � %PEP 517%zsrc/my_packagezsrc2/my_package2)�different_name�different_name.subpkgr� r� )� script_name� package_dir�packagesc s s" � | ] \}}|� d �r|V qdS )z.pyN��endswith)r� �k�vr# r# r$ � <genexpr>/ � � zDTestFinderTemplate.test_combine_namespaces_nested.<locals>.<genexpr>Nr� zdifferent_name.my_modulez different_name.subpkg.my_module2zsrc/my_package/my_module.pyz src2/my_package2/my_module2.pyr� r� )r@ rA �DirectoryStackrb rB r r rC r �next�get_implementationr r� r� r� r� r� r� r r� r �__file__r� r� ) rk rH r0 �stack�attrsrq r� �coder� r� r� r� r# r# r$ � test_combine_namespaces_nested s: � �� � P�z1TestFinderTemplate.test_combine_namespaces_nestedc C s� ddddiiiddddiiiddddiiid �}t jj||d � i }dt|d �gi}ttt� �||�}d d � dD �}t�� �� t�� �� dddg|�R D ] }t j � |d � qM| � |� t d�}|jdksgJ �t�t�� t d� W d � n1 s{w Y t j�t|d �� t d�} | jdks�J �t�t�� t d� W d � n1 s�w Y t j�t|d �� t d�} | jdks�J �W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S )N�parent�childzone.py�x = 1ztwo.py�x = 2zthree.pyzx = 3)�project1�project2�project3r2 zproject1/parentc s s � | ]}d |� �V qdS )z parent.child.Nr# )r� rf r# r# r$ r� N � � zCTestFinderTemplate.test_dynamic_path_computation.<locals>.<genexpr>)�one�two�threez parent.childzparent.child.oner zparent.child.twor� � zparent.child.threer� � )r@ rA rB rC r r r r� r� r� r� r� r� r �xr_ �raises� ImportErrorrw ) rk rH r0 r� r� r� �modsr� r� r� r� r# r# r$ � test_dynamic_path_computationB s8 � � �P�z0TestFinderTemplate.test_dynamic_path_computationc C s� dddii}t jj||d� dt|d �i}ttt� �|i �}t�� �L t�� �/ t j � dd � | � |� t jtdd�� td� W d � n1 sKw Y W d � n1 sZw Y W d � d S W d � d S 1 srw Y d S )NrN r' zfrom . import pkgr2 rV �r@ rA rB rC r r r r� r� r� r� r� r� r_ r r r �rk rH r0 r� r� r# r# r$ �test_no_recursionf s �� � ��P�z$TestFinderTemplate.test_no_recursionc C s ddddid�i}t jj||d� dt|d �i}ttt� �|i �}t�� �S t�� �6 t j � dd � t j � dd � | � |� t jtdd�� td� W d � n1 sUw Y W d � n1 sdw Y W d � d S W d � d S 1 s|w Y d S ) N�foor� r' )r' �barr2 zfoo.barr: rV r r r# r# r$ �test_similar_name{ s& ��� � ��P�z$TestFinderTemplate.test_similar_namec C s dddddd�d�i}t jj||d� dt|d �i}ttt� �|i �}t�� �� t�� �� t j � dd � | � |� t jtdd �� td � W d � n1 sPw Y t jtd d �� td � W d � n1 skw Y t jtd d �� td� W d � n1 s�w Y t jtdd �� td� W d � n1 s�w Y t jtdd �� td� W d � n1 s�w Y td�}|jdks�J �td�}|jdks�J �W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S )Nr r� r� r� )r' � lowercase.py)r' r r r2 z'FOO'rV �FOOz'foo\.LOWERCASE'z foo.LOWERCASEz'foo\.bar\.Lowercase'zfoo.bar.Lowercasez 'foo\.BAR'zfoo.BAR.lowercasezFOO.bar.lowercasez foo.lowercaser zfoo.bar.lowercaser� )r@ rA rB rC r r r r� r� r� r� r� r� r_ r r r r� )rk rH r0 r� r� r� r# r# r$ �test_case_sensitivity� sF ��� � � � � � �P�z(TestFinderTemplate.test_case_sensitivityc C s� ddddd�d�i}t jj||d� dt|d �i}d g i}ttt� �||�}t�� �� t�� �� d D ] }t j � |d � q3| � |� t d�}t|d �� �}t||� |jd ksZJ �t d �} | jd kseJ �t d�} | jdkspJ �tjtdd�� t d� W d � n1 s�w Y tjtdd�� t d� W d � n1 s�w Y tjtdd�� t d� W d � n1 s�w Y W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S )NrN r� r� zc = 42)r' zbar.py)r' r r2 r� rv r� r� zns.othername.foor� zns.othername.foo.barr� z'NS'rV zNS.othername.fooz'ns\.othername\.FOO\'zns.othername.FOOz'ns\.othername\.foo\.BAR\'zns.othername.foo.BAR)r@ rA rB rC r r r r� r� r� r� r� r� r r� r� r� r� �cr_ r r ) rk rH r0 r� r r� r� rN r� r r r# r# r$ � test_namespace_case_sensitivity� sD ��� � � ��P�z2TestFinderTemplate.test_namespace_case_sensitivityc C s2 dddddddid�ii}t jj||d � dt|d �i}ttt� �|i �}t�� �e t�� �H d D ] }t j � |d � q2| � |� t d �}|jdksLJ �t d�}|jdksWJ �t�t�� t d� W d � n1 skw Y W d � n1 szw Y W d � d S W d � d S 1 s�w Y d S )z� The finder should not import ``fullname`` if the intermediate segments don't exist (see pypa/setuptools#4019). r+ r& r� r� zb = 13� config.pyza = 37)r' r z helloworld.py� componentsr2 z src/mypkg)r& z mypkg.config�mypkg.helloworldzmypkg.components�mypkg.components.config�mypkg.components.helloworldNr r� r r� r )r@ rA rB rC r r r r� r� r� r� r� r� r r� r� r_ r r )rk rH r0 r� r� r� r\ � helloworldr# r# r$ �test_intermediate_packages� s4 ���� ��P�z-TestFinderTemplate.test_intermediate_packagesN)r} r~ r �__doc__r� r� r� r� r� r r r r r r r# r# r# r$ r� � s +$) )r� c C s� ddidd�dddid�dd dd iiidd idd idd id�}t jj|| d� dddd�}g d�}t||| �}|t| d �t| d �t| d �t| d �t| d �t| d �d�ks\J �ttt||���}|ddhksmJ �tt|��}|h d�ks{J �dS ) r� r' zab = 1r� )r� r' zd = 1zde = 1)r' �e�g�hzfgh = 1zabc = 1z abcxyz = 1z mnopq = 1)r� �d�f�other�another� yet_anotherr2 r r r )�a.b.c� a.b.c.x.y.z� m.n.o.p.q) r� �a.br � a.b.c.x.yr r zd.er �f.gzf.g.hr! r� r r )r� r r r r r! r$ > �m.n�m.n.o�a.b.c.x�m.n.o.p�mr" r# N) r@ rA rB r rC �setr� r r )rH r0 r� r� �rootsrv r# r# r$ �test_pkg_roots s4 �� � r, c @ s� e Zd ZU dZee�ed ddddddd�d�d �Zd ed < eee�ed dd ed id �ee�ed� ed dded d d�ed d d�ee�ed dd ed d ed d d�id �d�Ze j j e j dkdd�e j �de�� �dd� ��ZdS ) �TestOverallBehaviourz� [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" r* r� zvar = 42zvar = 13� resource 39)r' r� zresource_file.txt)r' r� � subpackage)r) r* � otherfile.pyr& zdict[str, Any]� FLAT_LAYOUTr& )r) r* r0 r+ z� [tool.setuptools] packages = ["mypkg", "mypkg.subpackage"] [tool.setuptools.package-dir] "mypkg.subpackage" = "other" r� )r' r� r/ )r) r* r0 r& r )r� r/ )� flat-layout� src-layout� custom-layout� namespacer, r- r. �layoutc C s< t d||| j| g|�R � \}}d}|�ddt|�g�}d|v s"J �d} |�ddt| �g�}d|v s4J �d} |�ddt| �g�}d |v sFJ �t|�d ��} t|�d ��} t|�d ��} | jd dd� | jddd� | jddd� |�ddt| �g�}d|vs�J �d|v s�J �|�ddt| �g�}d |vs�J �d|v s�J �d S )Nr& zj try: import otherfile except ImportError as ex: print(ex) r4 rO zNo module named 'otherfile'zy import mypkg, mypkg.mod1, mypkg.subpackage.mod2 print(mypkg.mod1.var, mypkg.subpackage.mod2.var) z42 13z� import mypkg.subpackage from setuptools._importlib import resources as importlib_resources text = importlib_resources.files(mypkg.subpackage) / "resource_file.txt" print(text.read_text(encoding="utf-8")) r. � **/mod1.py� **/mod2.py�**/resource_file.txtzvar = 17r; r< z var = 781z resource 374z17 781)�install_project�EXAMPLESrE r r� ri rG )rk rH rI r6 r% rJ �_�cmd_import_errorr� � cmd_get_vars�cmd_get_resourcer� r� � resource_filer# r# r$ �test_editable_install� s4 � � z*TestOverallBehaviour.test_editable_installN)r} r~ r � PYPROJECTr r� r1 �__annotations__r; r_ r� �xfailr� r� r� �keysrA r# r# r# r$ r- C sX ��� ��� � � ����(r- c @ sN e Zd Zeejd �Zed ed�7 < ded d d< dd � Zd d � Z d S ) � TestLinkTreer3 r) a[ [tool.setuptools] # Temporary workaround: both `include-package-data` and `package-data` configs # can be removed after #3260 is fixed. include-package-data = false package-data = {"*" = ["*.txt"]} [tool.setuptools.packages.find] where = ["src"] exclude = ["*.subpackage*"] r� r+ r& �resource.not_in_manifestc C sJ t jj| j|d� t|��� d}tddi�}|�� t� }|d }|d }|�� |�� |� d�}d|_ t |�|_ |� � |�� }|�� } t||||�} | ||| � t|�d ��} |d } t| | � t|�d �d �d u soJ �t|�d �d �d u s{J �t|�d �d �d u s�J �t|�d�d �d u s�J �W d � d S 1 s�w Y d S )Nr2 z mypkg-3.14159r� r� z.auxz.build�build_pyTr7 zsrc/mypkg/mod1.pyz **/subpackager8 r9 z**/resource.not_in_manifest)r@ rA rB �FILES�_Pathr �parse_config_filesr r? �get_command_obj� editable_moderC � build_lib�ensure_finalized� get_outputs�get_output_mappingr r� ri �assert_link_to) rk rH rf rq �wheel�auxrB rH �outputs�output_mapping� make_treer� r� r# r# r$ �test_generated_tree� s4 "�z TestLinkTree.test_generated_treec C s� ddg}t d||| jg|�R � |�g d��}d|v s J �d}|�ddt|�g�}d |v s/J �d }|�ddt|�g�}d |v sAJ �d |v sGJ �d S ) Nr r r& �r4 rO z(import mypkg.mod1; print(mypkg.mod1.var)rZ zv try: from mypkg import subpackage except ImportError as ex: print(ex) r4 rO � cannot import name 'subpackage'a8 import mypkg from setuptools._importlib import resources as importlib_resources try: text = importlib_resources.files(mypkg) / "resource.not_in_manifest" print(text.read_text(encoding="utf-8")) except FileNotFoundError as ex: print(ex) zNo such file or directoryrG )r: rI rE r )rk rH rI r{ r� r= r? r# r# r$ �test_strict_install� s z TestLinkTree.test_strict_installN) r} r~ r r r- r; rI r rX r[ r# r# r# r$ rF � s � "rF z9ignore:.*compat.*:setuptools.SetuptoolsDeprecationWarningc C s� ddg}t jd }td|| |g|�R � |�g d��}d|v s!J �tt| ��}dD ]}t|�dd |g��}||v s;J �q)d }|�dd t|�g�}d |v sNJ �d S ) Nr zeditable-mode=compatr4 r& rY rZ )z"import otherfile; print(otherfile)zimport other; print(other)zimport mypkg; print(mypkg)r4 rO zc try: from mypkg import subpackage; except ImportError as ex: print(ex) rZ )r- r; r: rE �comparable_pathrC r )rH rI r{ r0 r� � expected_pathrK r# r# r$ �test_compat_install s r^ c C s� t d�t d�t d�ddd�ddid �}|�g d �� tjd d �� td || |g|�R � W d � n1 s6w Y |�g d��}d|v sHJ �dS )z3Ensure editable installs work with pbr, issue #3500z� [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" z� __import__('setuptools').setup( pbr=True, setup_requires=["pbr"], ) z~ [metadata] name = mypkg [files] packages = mypkg r� zprint('Hello world!'))r' zhello.pyztest.txtzAnother file in here.)r) r1 z setup.cfgr& r )r4 r5 r6 r7 �pbrz0.42)� PBR_VERSIONr& N)r4 rO zimport mypkg.helloz Hello world!)r rE r � environmentr: )rH rI r% r0 r� r# r# r$ �test_pbr_integration/ s( ��� �� �rb c @ s2 e Zd ZdZi ejd �ded�i�Zdd� ZdS )�TestCustomBuildPya$ Issue #3501 indicates that some plugins/customizations might rely on: 1. ``build_py`` not running 2. ``build_py`` always copying files to ``build_lib`` During the transition period setuptools should prevent potential errors from happening due to those assumptions. r2 r1 af import pathlib from setuptools import setup from setuptools.command.build_py import build_py as orig class my_build_py(orig): def run(self): super().run() raise ValueError("TEST_RAISE") setup(cmdclass={"build_py": my_build_py}) c C sJ t d||| j�\}}d|v sJ �d|v sJ �|�g d��}d|v s#J �dS )z>Ensure that errors in custom build_py are reported as warningsr& r zValueError: TEST_RAISErY rZ N)r: rI rE )rk rH rI r< r� r# r# r$ � test_safeguarded_from_errorsy s z.TestCustomBuildPy.test_safeguarded_from_errorsN) r} r~ r r r- r; r rI rd r# r# r# r$ rc Z s ��� rc c @ s e Zd Zdd� Zdd� ZdS )�TestCustomBuildWheelc C s( |� d�}G dd� d|�}||jd< d S )N� bdist_wheelc s e Zd Z� fdd�Z� ZS )zETestCustomBuildWheel.install_custom_build_wheel.<locals>.MyBdistWheelc s | j �d�rd}t� �� S )Nzmacosx-zmacOS platform)� plat_namer� �super�get_tag)rk r< �� __class__r# r$ ri � s zMTestCustomBuildWheel.install_custom_build_wheel.<locals>.MyBdistWheel.get_tag)r} r~ r ri � __classcell__r# r# rj r$ � MyBdistWheel� s rm )�get_command_class�cmdclass)rk rq �bdist_wheel_clsrm r# r# r$ �install_custom_build_wheel� s z/TestCustomBuildWheel.install_custom_build_wheelc C sj t j�ddi� t� }d|_|�� | �|� t|�}|�� |� � t t t � � d���}d|v s3J �d S )N� module.pyr> r1 � dist/*.whl�editable)r@ rA rB r r� � set_defaultsrq r rO rE rC r� r ri )rk � tmpdir_cwdrq rK � wheel_filer# r# r$ �test_access_plat_name� s z*TestCustomBuildWheel.test_access_plat_nameN)r} r~ r rq rx r# r# r# r$ re � s re c @ s2 e Zd Zdd� Zejjejdkdd�dd� �Z dS ) �TestCustomBuildExtc C s* ddl m} G dd� d|�}||jd< d S )Nr )� build_extc @ s e Zd ZdS )zITestCustomBuildExt.install_custom_build_ext_distutils.<locals>.MyBuildExtN)r} r~ r r# r# r# r$ � MyBuildExt� s r{ rz )�distutils.command.build_extrz ro )rk rq � build_ext_clsr{ r# r# r$ �"install_custom_build_ext_distutils� s z5TestCustomBuildExt.install_custom_build_ext_distutils�linuxz(compilers may fail without correct setupr. c s� t j�ddi� dtddg�gi}t|�}d|_|�� | �|� t|�}|� � |� � t t t � �d���}d|v s=J �dd � t � �d �D �}t|�d ksPJ �|d j� t� fd d�tD ��sbJ �d S )Nzmodule.cr� � ext_modules�moduler1 rs rt c S s g | ] }|j d kr|�qS )z.c)�suffix)r� �pr# r# r$ r� � s zITestCustomBuildExt.test_distutils_leave_inplace_files.<locals>.<listcomp>zmodule.*r r c 3 s � | ]}� � |�V qd S �Nr� )r� �ext�rf r# r$ r� � r� zHTestCustomBuildExt.test_distutils_leave_inplace_files.<locals>.<genexpr>)r@ rA rB r r r� ru r~ r rO rE rC r� r ri rj rf �anyr )rk rv r� rq rK rw r0 r# r� r$ �"test_distutils_leave_inplace_files� s � z5TestCustomBuildExt.test_distutils_leave_inplace_filesN) r} r~ r r~ r_ r� �skipifr� r� r� r# r# r# r$ ry � s �ry c C s� t j�ddi� t� }d|_|�� t|�}|�� tdt fi �}t |� d�}|� |d|� d}t � |��, t jt|d�� |�� W d � n1 sLw Y W d � d S W d � d S 1 sdw Y d S ) z7Make sure to display useful debugging tips to the user.rr r> r1 � SimulatedErr)� side_effectre z-following steps are recommended to help debugrV N)r@ rA rB r r� ru r rO �type� Exceptionr �setattrr_ r r` r rE )rv rl rq rK r� �simulated_failure� expected_msgr# r# r$ �test_debugging_tips� s P�r� �errorc C s t d�} t| t�s J �dS )z>Ensure _encode_pth function does not produce encoding warningsu tkmilan_ç_utf8N)r � isinstance�bytes)�contentr# r# r$ �test_encode_pth� s r� c G sZ || }|� � tjj||d� g |�d�}|jddddddt|�g|�tjd �}||fS ) Nr2 r8 r4 r5 r6 r� r7 r9 )�stderr)r? r@ rA rB rE rC r� �STDOUT)rf rI rH r0 r{ rJ r� r# r# r$ r: � s �r: c C s6 d� dtdd� | D �� �}| d d j|dd� d S ) a5 To use this function, it is necessary to insert new_dir in front of sys.path. The Python process will try to import a ``sitecustomize`` module on startup. If we manipulate sys.path/PYTHONPATH, we can force it to run our code, which invokes ``addsitedir`` and ensure ``.pth`` files are loaded. � )z import sitec s s" � | ] }d t �|��d�V qdS )zsite.addsitedir(�)N)r� �fspath)r� �new_dirr# r# r$ r� � r� z _addsitedirs.<locals>.<genexpr>r zsitecustomize.pyr; r< N)r� �tuplerG )�new_dirsr� r# r# r$ r� � s ��r� c C s> | j rtt| j �d �}|rtt|��� �|ks J �d S d S d S r� )�__path__r� �iterrC r r� )rN r� rA r# r# r$ r� � s �r� �filer r �return�Nonec C sl | � � rt| �� �t|�� �ksJ �d S | �� }|�� }|tj |tj ks(J �|tj |tj ks4J �d S r� )� is_symlinkrC r� �stat�ST_INO�ST_DEV)r� r � file_stat� other_statr# r# r$ rR � s rR � str_with_pathrC c C s | � � �tjd��dd�S )N�/z//)�lower�replacer� �sep)r� r# r# r$ r\ s r\ )r� r r r r� r� )r� rC r� rC )T� __future__r r� r� r� r� r� �copyr � importlibr �importlib.machineryr �pathlibr �textwrapr �typingr � unittest.mockr �uuidr � jaraco.envsr@ � jaraco.pathr_ rA rJ �setuptools._importlibr r� �!setuptools.command.editable_wheelr r r r r r r r r �setuptools.distr �setuptools.extensionr �setuptools.warningsr r� r r �distutils.corer �fixturer% rF r� �SETUP_SCRIPT_STUBr� rD r� rL rR rT rU r� r� r� r, r- rF �filterwarningsr^ rb rc re ry r� r� r: r� r� rR r\ r# r# r# r$ �<module> s� , � �� � ���G�� (&Be( Z1x S +* tests/test_packageindex.py 0000644 00000021107 15030122015 0011730 0 ustar 00 import http.client import re import urllib.error import urllib.request from inspect import cleandoc import pytest import setuptools.package_index import distutils.errors class TestPackageIndex: def test_regex(self): hash_url = 'http://other_url?:action=show_md5&' hash_url += 'digest=0123456789abcdef0123456789abcdef' doc = """ <a href="http://some_url">Name</a> (<a title="MD5 hash" href="{hash_url}">md5</a>) """.lstrip().format(**locals()) assert setuptools.package_index.PYPI_MD5.match(doc) def test_bad_url_bad_port(self): index = setuptools.package_index.PackageIndex() url = 'http://127.0.0.1:0/nonesuch/test_package_index' with pytest.raises(Exception, match=re.escape(url)): v = index.open_url(url) assert isinstance(v, urllib.error.HTTPError) def test_bad_url_typo(self): # issue 16 # easy_install inquant.contentmirror.plone breaks because of a typo # in its home URL index = setuptools.package_index.PackageIndex(hosts=('www.example.com',)) url = 'url:%20https://svn.plone.org/svn/collective/inquant.contentmirror.plone/trunk' with pytest.raises(Exception, match=re.escape(url)): v = index.open_url(url) assert isinstance(v, urllib.error.HTTPError) def test_bad_url_bad_status_line(self): index = setuptools.package_index.PackageIndex(hosts=('www.example.com',)) def _urlopen(*args): raise http.client.BadStatusLine('line') index.opener = _urlopen url = 'http://example.com' with pytest.raises(Exception, match=r'line'): index.open_url(url) def test_bad_url_double_scheme(self): """ A bad URL with a double scheme should raise a DistutilsError. """ index = setuptools.package_index.PackageIndex(hosts=('www.example.com',)) # issue 20 url = 'http://http://svn.pythonpaste.org/Paste/wphp/trunk' try: index.open_url(url) except distutils.errors.DistutilsError as error: msg = str(error) assert ( 'nonnumeric port' in msg or 'getaddrinfo failed' in msg or 'Name or service not known' in msg ) return raise RuntimeError("Did not raise") def test_url_ok(self): index = setuptools.package_index.PackageIndex(hosts=('www.example.com',)) url = 'file:///tmp/test_package_index' assert index.url_ok(url, True) def test_parse_bdist_wininst(self): parse = setuptools.package_index.parse_bdist_wininst actual = parse('reportlab-2.5.win32-py2.4.exe') expected = 'reportlab-2.5', '2.4', 'win32' assert actual == expected actual = parse('reportlab-2.5.win32.exe') expected = 'reportlab-2.5', None, 'win32' assert actual == expected actual = parse('reportlab-2.5.win-amd64-py2.7.exe') expected = 'reportlab-2.5', '2.7', 'win-amd64' assert actual == expected actual = parse('reportlab-2.5.win-amd64.exe') expected = 'reportlab-2.5', None, 'win-amd64' assert actual == expected def test__vcs_split_rev_from_url(self): """ Test the basic usage of _vcs_split_rev_from_url """ vsrfu = setuptools.package_index.PackageIndex._vcs_split_rev_from_url url, rev = vsrfu('https://example.com/bar@2995') assert url == 'https://example.com/bar' assert rev == '2995' def test_local_index(self, tmpdir): """ local_open should be able to read an index from the file system. """ index_file = tmpdir / 'index.html' with index_file.open('w') as f: f.write('<div>content</div>') url = 'file:' + urllib.request.pathname2url(str(tmpdir)) + '/' res = setuptools.package_index.local_open(url) assert 'content' in res.read() def test_egg_fragment(self): """ EGG fragments must comply to PEP 440 """ epoch = [ '', '1!', ] releases = [ '0', '0.0', '0.0.0', ] pre = [ 'a0', 'b0', 'rc0', ] post = ['.post0'] dev = [ '.dev0', ] local = [ ('', ''), ('+ubuntu.0', '+ubuntu.0'), ('+ubuntu-0', '+ubuntu.0'), ('+ubuntu_0', '+ubuntu.0'), ] versions = [ [''.join([e, r, p, loc]) for loc in locs] for e in epoch for r in releases for p in sum([pre, post, dev], ['']) for locs in local ] for v, vc in versions: dists = list( setuptools.package_index.distros_for_url( 'http://example.com/example-foo.zip#egg=example-foo-' + v ) ) assert dists[0].version == '' assert dists[1].version == vc def test_download_git_with_rev(self, tmp_path, fp): url = 'git+https://github.example/group/project@master#egg=foo' index = setuptools.package_index.PackageIndex() expected_dir = tmp_path / 'project@master' fp.register([ 'git', 'clone', '--quiet', 'https://github.example/group/project', expected_dir, ]) fp.register(['git', '-C', expected_dir, 'checkout', '--quiet', 'master']) result = index.download(url, tmp_path) assert result == str(expected_dir) assert len(fp.calls) == 2 def test_download_git_no_rev(self, tmp_path, fp): url = 'git+https://github.example/group/project#egg=foo' index = setuptools.package_index.PackageIndex() expected_dir = tmp_path / 'project' fp.register([ 'git', 'clone', '--quiet', 'https://github.example/group/project', expected_dir, ]) index.download(url, tmp_path) def test_download_svn(self, tmp_path): url = 'svn+https://svn.example/project#egg=foo' index = setuptools.package_index.PackageIndex() msg = r".*SVN download is not supported.*" with pytest.raises(distutils.errors.DistutilsError, match=msg): index.download(url, tmp_path) class TestContentCheckers: def test_md5(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478' ) checker.feed('You should probably not be using MD5'.encode('ascii')) assert checker.hash.hexdigest() == 'f12895fdffbd45007040d2e44df98478' assert checker.is_valid() def test_other_fragment(self): "Content checks should succeed silently if no hash is present" checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#something%20completely%20different' ) checker.feed('anything'.encode('ascii')) assert checker.is_valid() def test_blank_md5(self): "Content checks should succeed if a hash is empty" checker = setuptools.package_index.HashChecker.from_url('http://foo/bar#md5=') checker.feed('anything'.encode('ascii')) assert checker.is_valid() def test_get_hash_name_md5(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478' ) assert checker.hash_name == 'md5' def test_report(self): checker = setuptools.package_index.HashChecker.from_url( 'http://foo/bar#md5=f12895fdffbd45007040d2e44df98478' ) rep = checker.report(lambda x: x, 'My message about %s') assert rep == 'My message about md5' class TestPyPIConfig: def test_percent_in_password(self, tmp_home_dir): pypirc = tmp_home_dir / '.pypirc' pypirc.write_text( cleandoc( """ [pypi] repository=https://pypi.org username=jaraco password=pity% """ ), encoding="utf-8", ) cfg = setuptools.package_index.PyPIConfig() cred = cfg.creds_by_repository['https://pypi.org'] assert cred.username == 'jaraco' assert cred.password == 'pity%' @pytest.mark.timeout(1) def test_REL_DoS(): """ REL should not hang on a contrived attack string. """ setuptools.package_index.REL.search('< rel=' + ' ' * 2**12) tests/test_windows_wrappers.py 0000644 00000017311 15030122015 0012724 0 ustar 00 """ Python Script Wrapper for Windows ================================= setuptools includes wrappers for Python scripts that allows them to be executed like regular windows programs. There are 2 wrappers, one for command-line programs, cli.exe, and one for graphical programs, gui.exe. These programs are almost identical, function pretty much the same way, and are generated from the same source file. The wrapper programs are used by copying them to the directory containing the script they are to wrap and with the same name as the script they are to wrap. """ import pathlib import platform import subprocess import sys import textwrap import pytest import pkg_resources from setuptools.command.easy_install import nt_quote_arg pytestmark = pytest.mark.skipif(sys.platform != 'win32', reason="Windows only") class WrapperTester: @classmethod def prep_script(cls, template): python_exe = nt_quote_arg(sys.executable) return template % locals() @classmethod def create_script(cls, tmpdir): """ Create a simple script, foo-script.py Note that the script starts with a Unix-style '#!' line saying which Python executable to run. The wrapper will use this line to find the correct Python executable. """ script = cls.prep_script(cls.script_tmpl) with (tmpdir / cls.script_name).open('w') as f: f.write(script) # also copy cli.exe to the sample directory with (tmpdir / cls.wrapper_name).open('wb') as f: w = pkg_resources.resource_string('setuptools', cls.wrapper_source) f.write(w) def win_launcher_exe(prefix): """A simple routine to select launcher script based on platform.""" assert prefix in ('cli', 'gui') if platform.machine() == "ARM64": return f"{prefix}-arm64.exe" else: return f"{prefix}-32.exe" class TestCLI(WrapperTester): script_name = 'foo-script.py' wrapper_name = 'foo.exe' wrapper_source = win_launcher_exe('cli') script_tmpl = textwrap.dedent( """ #!%(python_exe)s import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') """ ).lstrip() def test_basic(self, tmpdir): """ When the copy of cli.exe, foo.exe in this example, runs, it examines the path name it was run with and computes a Python script path name by removing the '.exe' suffix and adding the '-script.py' suffix. (For GUI programs, the suffix '-script.pyw' is added.) This is why we named out script the way we did. Now we can run out script by running the wrapper: This example was a little pathological in that it exercised windows (MS C runtime) quoting rules: - Strings containing spaces are surrounded by double quotes. - Double quotes in strings need to be escaped by preceding them with back slashes. - One or more backslashes preceding double quotes need to be escaped by preceding each of them with back slashes. """ self.create_script(tmpdir) cmd = [ str(tmpdir / 'foo.exe'), 'arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b', ] proc = subprocess.Popen( cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, text=True, encoding="utf-8", ) stdout, _stderr = proc.communicate('hello\nworld\n') actual = stdout.replace('\r\n', '\n') expected = textwrap.dedent( r""" \foo-script.py ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] 'hello\nworld\n' non-optimized """ ).lstrip() assert actual == expected def test_symlink(self, tmpdir): """ Ensure that symlink for the foo.exe is working correctly. """ script_dir = tmpdir / "script_dir" script_dir.mkdir() self.create_script(script_dir) symlink = pathlib.Path(tmpdir / "foo.exe") symlink.symlink_to(script_dir / "foo.exe") cmd = [ str(tmpdir / 'foo.exe'), 'arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b', ] proc = subprocess.Popen( cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, text=True, encoding="utf-8", ) stdout, _stderr = proc.communicate('hello\nworld\n') actual = stdout.replace('\r\n', '\n') expected = textwrap.dedent( r""" \foo-script.py ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] 'hello\nworld\n' non-optimized """ ).lstrip() assert actual == expected def test_with_options(self, tmpdir): """ Specifying Python Command-line Options -------------------------------------- You can specify a single argument on the '#!' line. This can be used to specify Python options like -O, to run in optimized mode or -i to start the interactive interpreter. You can combine multiple options as usual. For example, to run in optimized mode and enter the interpreter after running the script, you could use -Oi: """ self.create_script(tmpdir) tmpl = textwrap.dedent( """ #!%(python_exe)s -Oi import sys input = repr(sys.stdin.read()) print(sys.argv[0][-14:]) print(sys.argv[1:]) print(input) if __debug__: print('non-optimized') sys.ps1 = '---' """ ).lstrip() with (tmpdir / 'foo-script.py').open('w') as f: f.write(self.prep_script(tmpl)) cmd = [str(tmpdir / 'foo.exe')] proc = subprocess.Popen( cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, encoding="utf-8", ) stdout, _stderr = proc.communicate() actual = stdout.replace('\r\n', '\n') expected = textwrap.dedent( r""" \foo-script.py [] '' --- """ ).lstrip() assert actual == expected class TestGUI(WrapperTester): """ Testing the GUI Version ----------------------- """ script_name = 'bar-script.pyw' wrapper_source = win_launcher_exe('gui') wrapper_name = 'bar.exe' script_tmpl = textwrap.dedent( """ #!%(python_exe)s import sys f = open(sys.argv[1], 'wb') bytes_written = f.write(repr(sys.argv[2]).encode('utf-8')) f.close() """ ).strip() def test_basic(self, tmpdir): """Test the GUI version with the simple script, bar-script.py""" self.create_script(tmpdir) cmd = [ str(tmpdir / 'bar.exe'), str(tmpdir / 'test_output.txt'), 'Test Argument', ] proc = subprocess.Popen( cmd, stdout=subprocess.PIPE, stdin=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, encoding="utf-8", ) stdout, stderr = proc.communicate() assert not stdout assert not stderr with (tmpdir / 'test_output.txt').open('rb') as f_out: actual = f_out.read().decode('ascii') assert actual == repr('Test Argument') tests/test_virtualenv.py 0000644 00000007222 15030122015 0011506 0 ustar 00 import os import subprocess import sys from urllib.error import URLError from urllib.request import urlopen import pytest @pytest.fixture(autouse=True) def pytest_virtualenv_works(venv): """ pytest_virtualenv may not work. if it doesn't, skip these tests. See #1284. """ venv_prefix = venv.run(["python", "-c", "import sys; print(sys.prefix)"]).strip() if venv_prefix == sys.prefix: pytest.skip("virtualenv is broken (see pypa/setuptools#1284)") def test_clean_env_install(venv_without_setuptools, setuptools_wheel): """ Check setuptools can be installed in a clean environment. """ cmd = ["python", "-m", "pip", "install", str(setuptools_wheel)] venv_without_setuptools.run(cmd) def access_pypi(): # Detect if tests are being run without connectivity if not os.environ.get('NETWORK_REQUIRED', False): # pragma: nocover try: urlopen('https://pypi.org', timeout=1) except URLError: # No network, disable most of these tests return False return True @pytest.mark.skipif( 'platform.python_implementation() == "PyPy"', reason="https://github.com/pypa/setuptools/pull/2865#issuecomment-965834995", ) @pytest.mark.skipif(not access_pypi(), reason="no network") # ^-- Even when it is not necessary to install a different version of `pip` # the build process will still try to download `wheel`, see #3147 and #2986. @pytest.mark.parametrize( 'pip_version', [ None, pytest.param( 'pip<20.1', marks=pytest.mark.xfail( 'sys.version_info >= (3, 12)', reason="pip 23.1.2 required for Python 3.12 and later", ), ), pytest.param( 'pip<21', marks=pytest.mark.xfail( 'sys.version_info >= (3, 12)', reason="pip 23.1.2 required for Python 3.12 and later", ), ), pytest.param( 'pip<22', marks=pytest.mark.xfail( 'sys.version_info >= (3, 12)', reason="pip 23.1.2 required for Python 3.12 and later", ), ), pytest.param( 'pip<23', marks=pytest.mark.xfail( 'sys.version_info >= (3, 12)', reason="pip 23.1.2 required for Python 3.12 and later", ), ), pytest.param( 'https://github.com/pypa/pip/archive/main.zip', marks=pytest.mark.xfail(reason='#2975'), ), ], ) def test_pip_upgrade_from_source( pip_version, venv_without_setuptools, setuptools_wheel, setuptools_sdist ): """ Check pip can upgrade setuptools from source. """ # Install pip/wheel, in a venv without setuptools (as it # should not be needed for bootstrapping from source) venv = venv_without_setuptools venv.run(["pip", "install", "-U", "wheel"]) if pip_version is not None: venv.run(["python", "-m", "pip", "install", "-U", pip_version, "--retries=1"]) with pytest.raises(subprocess.CalledProcessError): # Meta-test to make sure setuptools is not installed venv.run(["python", "-c", "import setuptools"]) # Then install from wheel. venv.run(["pip", "install", str(setuptools_wheel)]) # And finally try to upgrade from source. venv.run(["pip", "install", "--no-cache-dir", "--upgrade", str(setuptools_sdist)]) def test_no_missing_dependencies(bare_venv, request): """ Quick and dirty test to ensure all external dependencies are vendored. """ setuptools_dir = request.config.rootdir bare_venv.run(['python', 'setup.py', '--help'], cwd=setuptools_dir) tests/test_unicode_utils.py 0000644 00000000474 15030122015 0012157 0 ustar 00 from setuptools import unicode_utils def test_filesys_decode_fs_encoding_is_None(monkeypatch): """ Test filesys_decode does not raise TypeError when getfilesystemencoding returns None. """ monkeypatch.setattr('sys.getfilesystemencoding', lambda: None) unicode_utils.filesys_decode(b'test') tests/integration/test_pip_install_sdist.py 0000644 00000020100 15030122015 0015344 0 ustar 00 # https://github.com/python/mypy/issues/16936 # mypy: disable-error-code="has-type" """Integration tests for setuptools that focus on building packages via pip. The idea behind these tests is not to exhaustively check all the possible combinations of packages, operating systems, supporting libraries, etc, but rather check a limited number of popular packages and how they interact with the exposed public API. This way if any change in API is introduced, we hope to identify backward compatibility problems before publishing a release. The number of tested packages is purposefully kept small, to minimise duration and the associated maintenance cost (changes in the way these packages define their build process may require changes in the tests). """ import json import os import shutil import sys from enum import Enum from glob import glob from hashlib import md5 from urllib.request import urlopen import pytest from packaging.requirements import Requirement from .helpers import Archive, run pytestmark = pytest.mark.integration (LATEST,) = Enum("v", "LATEST") # type: ignore[misc] # https://github.com/python/mypy/issues/16936 """Default version to be checked""" # There are positive and negative aspects of checking the latest version of the # packages. # The main positive aspect is that the latest version might have already # removed the use of APIs deprecated in previous releases of setuptools. # Packages to be tested: # (Please notice the test environment cannot support EVERY library required for # compiling binary extensions. In Ubuntu/Debian nomenclature, we only assume # that `build-essential`, `gfortran` and `libopenblas-dev` are installed, # due to their relevance to the numerical/scientific programming ecosystem) EXAMPLES = [ ("pip", LATEST), # just in case... ("pytest", LATEST), # uses setuptools_scm ("mypy", LATEST), # custom build_py + ext_modules # --- Popular packages: https://hugovk.github.io/top-pypi-packages/ --- ("botocore", LATEST), ("kiwisolver", LATEST), # build_ext ("brotli", LATEST), # not in the list but used by urllib3 ("pyyaml", LATEST), # cython + custom build_ext + custom distclass ("charset-normalizer", LATEST), # uses mypyc, used by aiohttp ("protobuf", LATEST), # ("requests", LATEST), # XXX: https://github.com/psf/requests/pull/6920 ("celery", LATEST), # When adding packages to this list, make sure they expose a `__version__` # attribute, or modify the tests below ] # Some packages have "optional" dependencies that modify their build behaviour # and are not listed in pyproject.toml, others still use `setup_requires` EXTRA_BUILD_DEPS = { "pyyaml": ("Cython<3.0",), # constraint to avoid errors "charset-normalizer": ("mypy>=1.4.1",), # no pyproject.toml available } EXTRA_ENV_VARS = { "pyyaml": {"PYYAML_FORCE_CYTHON": "1"}, "charset-normalizer": {"CHARSET_NORMALIZER_USE_MYPYC": "1"}, } IMPORT_NAME = { "pyyaml": "yaml", "protobuf": "google.protobuf", } VIRTUALENV = (sys.executable, "-m", "virtualenv") # By default, pip will try to build packages in isolation (PEP 517), which # means it will download the previous stable version of setuptools. # `pip` flags can avoid that (the version of setuptools under test # should be the one to be used) INSTALL_OPTIONS = ( "--ignore-installed", "--no-build-isolation", # Omit "--no-binary :all:" the sdist is supplied directly. # Allows dependencies as wheels. ) # The downside of `--no-build-isolation` is that pip will not download build # dependencies. The test script will have to also handle that. @pytest.fixture def venv_python(tmp_path): run([*VIRTUALENV, str(tmp_path / ".venv")]) possible_path = (str(p.parent) for p in tmp_path.glob(".venv/*/python*")) return shutil.which("python", path=os.pathsep.join(possible_path)) @pytest.fixture(autouse=True) def _prepare(tmp_path, venv_python, monkeypatch): download_path = os.getenv("DOWNLOAD_PATH", str(tmp_path)) os.makedirs(download_path, exist_ok=True) # Environment vars used for building some of the packages monkeypatch.setenv("USE_MYPYC", "1") yield # Let's provide the maximum amount of information possible in the case # it is necessary to debug the tests directly from the CI logs. print("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~") print("Temporary directory:") map(print, tmp_path.glob("*")) print("Virtual environment:") run([venv_python, "-m", "pip", "freeze"]) @pytest.mark.parametrize(("package", "version"), EXAMPLES) @pytest.mark.uses_network def test_install_sdist(package, version, tmp_path, venv_python, setuptools_wheel): venv_pip = (venv_python, "-m", "pip") sdist = retrieve_sdist(package, version, tmp_path) deps = build_deps(package, sdist) if deps: print("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~") print("Dependencies:", deps) run([*venv_pip, "install", *deps]) # Use a virtualenv to simulate PEP 517 isolation # but install fresh setuptools wheel to ensure the version under development env = EXTRA_ENV_VARS.get(package, {}) run([*venv_pip, "install", "--force-reinstall", setuptools_wheel]) run([*venv_pip, "install", *INSTALL_OPTIONS, sdist], env) # Execute a simple script to make sure the package was installed correctly pkg = IMPORT_NAME.get(package, package).replace("-", "_") script = f"import {pkg}; print(getattr({pkg}, '__version__', 0))" run([venv_python, "-c", script]) # ---- Helper Functions ---- def retrieve_sdist(package, version, tmp_path): """Either use cached sdist file or download it from PyPI""" # `pip download` cannot be used due to # https://github.com/pypa/pip/issues/1884 # https://discuss.python.org/t/pep-625-file-name-of-a-source-distribution/4686 # We have to find the correct distribution file and download it download_path = os.getenv("DOWNLOAD_PATH", str(tmp_path)) dist = retrieve_pypi_sdist_metadata(package, version) # Remove old files to prevent cache to grow indefinitely for file in glob(os.path.join(download_path, f"{package}*")): if dist["filename"] != file: os.unlink(file) dist_file = os.path.join(download_path, dist["filename"]) if not os.path.exists(dist_file): download(dist["url"], dist_file, dist["md5_digest"]) return dist_file def retrieve_pypi_sdist_metadata(package, version): # https://warehouse.pypa.io/api-reference/json.html id_ = package if version is LATEST else f"{package}/{version}" with urlopen(f"https://pypi.org/pypi/{id_}/json") as f: metadata = json.load(f) if metadata["info"]["yanked"]: raise ValueError(f"Release for {package} {version} was yanked") version = metadata["info"]["version"] release = metadata["releases"][version] if version is LATEST else metadata["urls"] (sdist,) = filter(lambda d: d["packagetype"] == "sdist", release) return sdist def download(url, dest, md5_digest): with urlopen(url) as f: data = f.read() assert md5(data).hexdigest() == md5_digest with open(dest, "wb") as f: f.write(data) assert os.path.exists(dest) def build_deps(package, sdist_file): """Find out what are the build dependencies for a package. "Manually" install them, since pip will not install build deps with `--no-build-isolation`. """ # delay importing, since pytest discovery phase may hit this file from a # testenv without tomli from setuptools.compat.py310 import tomllib archive = Archive(sdist_file) info = tomllib.loads(_read_pyproject(archive)) deps = info.get("build-system", {}).get("requires", []) deps += EXTRA_BUILD_DEPS.get(package, []) # Remove setuptools from requirements (and deduplicate) requirements = {Requirement(d).name: d for d in deps} return [v for k, v in requirements.items() if k != "setuptools"] def _read_pyproject(archive): contents = ( archive.get_content(member) for member in archive if os.path.basename(archive.get_name(member)) == "pyproject.toml" ) return next(contents, "") tests/integration/__pycache__/helpers.cpython-310.pyc 0000644 00000006177 15030122015 0016604 0 ustar 00 o �h� � @ s` d Z ddlZddlZddlZddlmZ ddlmZ d dd�ZG dd� d�Z d d � Z d d � Z dS )z�Reusable functions and classes for different types of integration tests. For example ``Archive`` can be used to check the contents of distribution built with setuptools, and ``run`` will always try to be as verbose as possible to facilitate debugging. � N��Path)�ZipFilec C sz t j| dddi tj�|p i �d�}|jd |j }td� td| � d|j� d|� �� |jd kr2|S t �|j| |j|j��) NT�utf-8)�capture_output�text�encoding�env� z<~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~z Command: z return code: z r ) � subprocess�run�os�environ�stdout�stderr�print� returncode�CalledProcessError)�cmdr �r�out� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/integration/helpers.pyr s � r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �Archivez5Compatibility layer for ZipFile/Info and TarFile/Infoc C sH || _ |�d�rt�|d�| _d S |�d�r t|�| _d S t|� d���)Nztar.gz�r:gz�zipz# doesn't seem to be a zip or tar.gz)� _filename�endswith�tarfile�open�_objr � ValueError)�self�filenamer r r �__init__& s zArchive.__init__c C s$ t | jd�r t| j�� �S t| j�S )N�infolist)�hasattrr �iterr% )r" r r r �__iter__/ s zArchive.__iter__c C s t |d�r|jS |jS )Nr# )r& r# �name)r" �zip_or_tar_infor r r �get_name4 s zArchive.get_namec C s\ t | jd�r%| j�|�}|d u r d|j� d| j� �}t|��t|�� d�S t| j�|�d�S )N� extractfilezInvalid z in r )r& r r, r) r r! �str�read)r" r* �content�msgr r r � get_content9 s zArchive.get_contentN)�__name__� __module__� __qualname__�__doc__r$ r( r+ r1 r r r r r # s r c C sZ t �| d��}dd� |�� D �}W d � n1 sw Y dd� |D �}dd� |D �S )Nr c S s g | ]}t |��qS r r ��.0�fr r r � <listcomp>E � z%get_sdist_members.<locals>.<listcomp>c s s$ � | ] }d � |jdd� �V qdS )�/� N)�join�partsr6 r r r � <genexpr>G s �" z$get_sdist_members.<locals>.<genexpr>c S s h | ]}|r|�qS r r r6 r r r � <setcomp>H r: z$get_sdist_members.<locals>.<setcomp>)r r �getnames)� sdist_path�tar�files�relative_filesr r r �get_sdist_membersC s �rF c C s8 t | ��}t|�� �W d � S 1 sw Y d S �N)r �set�namelist)� wheel_path�zipfiler r r �get_wheel_membersK s $�rL rG ) r5 r r r �pathlibr rK r r r rF rL r r r r �<module> s tests/integration/__pycache__/__init__.cpython-310.pyc 0000644 00000000265 15030122015 0016671 0 ustar 00 o �h � @ s d S )N� r r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/integration/__init__.py�<module> s tests/integration/__pycache__/test_pip_install_sdist.cpython-310.pyc 0000644 00000013725 15030122015 0021722 0 ustar 00 o �h@ � @ sp d Z ddlZddlZddlZddlZddlmZ ddlmZ ddlm Z ddl m Z ddl Z ddl mZ dd lmZmZ e jjZed d �\Z d efd efdefdefdefdefdefdefdefdefg Zddd�Zddiddid�Zd d d �Zejd d fZd!Z e j d"d#� �Z e j d$d%�d&d'� �Z e j� d(e�e jj!d)d*� ��Z"d+d,� Z#d-d.� Z$d/d0� Z%d1d2� Z&d3d4� Z'dS )5a� Integration tests for setuptools that focus on building packages via pip. The idea behind these tests is not to exhaustively check all the possible combinations of packages, operating systems, supporting libraries, etc, but rather check a limited number of popular packages and how they interact with the exposed public API. This way if any change in API is introduced, we hope to identify backward compatibility problems before publishing a release. The number of tested packages is purposefully kept small, to minimise duration and the associated maintenance cost (changes in the way these packages define their build process may require changes in the tests). � N)�Enum)�glob)�md5)�urlopen)� Requirement� )�Archive�run�v�LATEST�pip�pytest�mypy�botocore� kiwisolver�brotli�pyyaml�charset-normalizer�protobuf�celery)z Cython<3.0)z mypy>=1.4.1)r r �PYYAML_FORCE_CYTHON�1� CHARSET_NORMALIZER_USE_MYPYC�yamlzgoogle.protobuf)r r �-m� virtualenv)z--ignore-installedz--no-build-isolationc C sB t g t�t| d ��� dd� | �d�D �}tjdtj�|�d�S )Nz.venvc s s � | ]}t |j�V qd S )N)�str�parent)�.0�p� r �f/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/integration/test_pip_install_sdist.py� <genexpr>f s � z venv_python.<locals>.<genexpr>z.venv/*/python*�python)�path) r � VIRTUALENVr r �shutil�which�os�pathsep�join)�tmp_path� possible_pathr r r! � venv_pythonc s r- T)�autousec c sn � t �dt| ��}t j|dd� |�dd� d V td� td� tt| �d�� td � t|d d d g� d S ) N� DOWNLOAD_PATHT)�exist_ok� USE_MYPYCr �<~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~zTemporary directory:�*zVirtual environment:r r �freeze) r( �getenvr �makedirs�setenv�print�mapr r )r+ r- � monkeypatch� download_pathr r r! �_preparej s � r< )�package�versionc C s� |ddf}t | ||�}t| |�}|r%td� td|� tg |�d�|�� t�| i �}tg |�d�d�|�� tg |�d�t�|�|� t�| | ��dd�} d | � d | � d �} t|d | g� d S ) Nr r r2 z Dependencies:�installz--force-reinstall�-�_zimport z; print(getattr(z, '__version__', 0))z-c) �retrieve_sdist� build_depsr8 r �EXTRA_ENV_VARS�get�INSTALL_OPTIONS� IMPORT_NAME�replace) r= r> r+ r- �setuptools_wheel�venv_pip�sdist�deps�env�pkg�scriptr r r! �test_install_sdist} s rP c C s� t �dt|��}t| |�}tt j�|| � d���D ] }|d |kr&t �|� qt j�||d �}t j�|�s@t |d ||d � |S )z5Either use cached sdist file or download it from PyPIr/ r3 �filename�url� md5_digest) r( r5 r � retrieve_pypi_sdist_metadatar r$ r* �unlink�exists�download)r= r> r+ r; �dist�file� dist_filer r r! rB � s � rB c C s� |t u r| n| � d|� �}td|� d��� }t�|�}W d � n1 s%w Y |d d r;td| � d|� d���|d d }|t u rK|d | n|d }td d � |�\}|S )N�/zhttps://pypi.org/pypi/z/json�info�yankedz Release for � z was yankedr> �releases�urlsc S s | d dkS )N� packagetyperK r )�dr r r! �<lambda>� s z.retrieve_pypi_sdist_metadata.<locals>.<lambda>)r r �json�load� ValueError�filter)r= r> �id_�f�metadata�releaserK r r r! rT � s � rT c C s� t | �� }|�� }W d � n1 sw Y t|��� |ks"J �t|d�� }|�|� W d � n1 s7w Y tj�|�sDJ �d S )N�wb) r �readr � hexdigest�open�writer( r$ rV )rR �destrS ri �datar r r! rW � s � �rW c C sf ddl m} t|�}|�t|��}|�di ��dg �}|t�| g �7 }dd� |D �}dd� |�� D �S ) z�Find out what are the build dependencies for a package. "Manually" install them, since pip will not install build deps with `--no-build-isolation`. r )�tomllibz build-system�requiresc S s i | ]}t |�j|�qS r )r �name)r rb r r r! � <dictcomp>� s z build_deps.<locals>.<dictcomp>c S s g | ] \}}|d kr|�qS )� setuptoolsr )r �kr r r r! � <listcomp>� s z build_deps.<locals>.<listcomp>)�setuptools.compat.py310rs r �loads�_read_pyprojectrE �EXTRA_BUILD_DEPS�items)r= � sdist_filers �archiver\ rL � requirementsr r r! rC � s rC c s � fdd�� D �}t |d�S )Nc 3 s0 � | ]}t j�� �|��d kr� �|�V qdS )zpyproject.tomlN)r( r$ �basename�get_name� get_content)r �member�r� r r! r" � s � ��z"_read_pyproject.<locals>.<genexpr>� )�next)r� �contentsr r� r! r| � s � r| )(�__doc__rd r( r& �sys�enumr r �hashlibr �urllib.requestr r �packaging.requirementsr �helpersr r �mark� integration� pytestmarkr �EXAMPLESr} rD rG � executabler% rF �fixturer- r< � parametrize� uses_networkrP rB rT rW rC r| r r r r! �<module> sb ���� tests/integration/helpers.py 0000644 00000004732 15030122015 0012240 0 ustar 00 """Reusable functions and classes for different types of integration tests. For example ``Archive`` can be used to check the contents of distribution built with setuptools, and ``run`` will always try to be as verbose as possible to facilitate debugging. """ import os import subprocess import tarfile from pathlib import Path from zipfile import ZipFile def run(cmd, env=None): r = subprocess.run( cmd, capture_output=True, text=True, encoding="utf-8", env={**os.environ, **(env or {})}, # ^-- allow overwriting instead of discarding the current env ) out = r.stdout + "\n" + r.stderr # pytest omits stdout/err by default, if the test fails they help debugging print("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~") print(f"Command: {cmd}\nreturn code: {r.returncode}\n\n{out}") if r.returncode == 0: return out raise subprocess.CalledProcessError(r.returncode, cmd, r.stdout, r.stderr) class Archive: """Compatibility layer for ZipFile/Info and TarFile/Info""" def __init__(self, filename): self._filename = filename if filename.endswith("tar.gz"): self._obj = tarfile.open(filename, "r:gz") elif filename.endswith("zip"): self._obj = ZipFile(filename) else: raise ValueError(f"{filename} doesn't seem to be a zip or tar.gz") def __iter__(self): if hasattr(self._obj, "infolist"): return iter(self._obj.infolist()) return iter(self._obj) def get_name(self, zip_or_tar_info): if hasattr(zip_or_tar_info, "filename"): return zip_or_tar_info.filename return zip_or_tar_info.name def get_content(self, zip_or_tar_info): if hasattr(self._obj, "extractfile"): content = self._obj.extractfile(zip_or_tar_info) if content is None: msg = f"Invalid {zip_or_tar_info.name} in {self._filename}" raise ValueError(msg) return str(content.read(), "utf-8") return str(self._obj.read(zip_or_tar_info), "utf-8") def get_sdist_members(sdist_path): with tarfile.open(sdist_path, "r:gz") as tar: files = [Path(f) for f in tar.getnames()] # remove root folder relative_files = ("/".join(f.parts[1:]) for f in files) return {f for f in relative_files if f} def get_wheel_members(wheel_path): with ZipFile(wheel_path) as zipfile: return set(zipfile.namelist()) tests/integration/__init__.py 0000644 00000000000 15030122015 0012315 0 ustar 00 tests/test_extern.py 0000644 00000000450 15030122015 0010610 0 ustar 00 import importlib import pickle import packaging from setuptools import Distribution def test_reimport_extern(): packaging2 = importlib.import_module(packaging.__name__) assert packaging is packaging2 def test_distribution_picklable(): pickle.loads(pickle.dumps(Distribution())) tests/test_depends.py 0000644 00000000650 15030122015 0010727 0 ustar 00 import sys from setuptools import depends class TestGetModuleConstant: def test_basic(self): """ Invoke get_module_constant on a module in the test package. """ mod_name = 'setuptools.tests.mod_with_constant' val = depends.get_module_constant(mod_name, 'value') assert val == 'three, sir!' assert 'setuptools.tests.mod_with_constant' not in sys.modules tests/contexts.py 0000644 00000006630 15030122015 0010121 0 ustar 00 import contextlib import io import os import shutil import site import sys import tempfile from filelock import FileLock @contextlib.contextmanager def tempdir(cd=lambda dir: None, **kwargs): temp_dir = tempfile.mkdtemp(**kwargs) orig_dir = os.getcwd() try: cd(temp_dir) yield temp_dir finally: cd(orig_dir) shutil.rmtree(temp_dir) @contextlib.contextmanager def environment(**replacements): """ In a context, patch the environment with replacements. Pass None values to clear the values. """ saved = dict((key, os.environ[key]) for key in replacements if key in os.environ) # remove values that are null remove = (key for (key, value) in replacements.items() if value is None) for key in list(remove): os.environ.pop(key, None) replacements.pop(key) os.environ.update(replacements) try: yield saved finally: for key in replacements: os.environ.pop(key, None) os.environ.update(saved) @contextlib.contextmanager def quiet(): """ Redirect stdout/stderr to StringIO objects to prevent console output from distutils commands. """ old_stdout = sys.stdout old_stderr = sys.stderr new_stdout = sys.stdout = io.StringIO() new_stderr = sys.stderr = io.StringIO() try: yield new_stdout, new_stderr finally: new_stdout.seek(0) new_stderr.seek(0) sys.stdout = old_stdout sys.stderr = old_stderr @contextlib.contextmanager def save_user_site_setting(): saved = site.ENABLE_USER_SITE try: yield saved finally: site.ENABLE_USER_SITE = saved @contextlib.contextmanager def save_pkg_resources_state(): import pkg_resources pr_state = pkg_resources.__getstate__() # also save sys.path sys_path = sys.path[:] try: yield pr_state, sys_path finally: sys.path[:] = sys_path pkg_resources.__setstate__(pr_state) @contextlib.contextmanager def suppress_exceptions(*excs): try: yield except excs: pass def multiproc(request): """ Return True if running under xdist and multiple workers are used. """ try: worker_id = request.getfixturevalue('worker_id') except Exception: return False return worker_id != 'master' @contextlib.contextmanager def session_locked_tmp_dir(request, tmp_path_factory, name): """Uses a file lock to guarantee only one worker can access a temp dir""" # get the temp directory shared by all workers base = tmp_path_factory.getbasetemp() shared_dir = base.parent if multiproc(request) else base locked_dir = shared_dir / name with FileLock(locked_dir.with_suffix(".lock")): # ^-- prevent multiple workers to access the directory at once locked_dir.mkdir(exist_ok=True, parents=True) yield locked_dir @contextlib.contextmanager def save_paths(): """Make sure ``sys.path``, ``sys.meta_path`` and ``sys.path_hooks`` are preserved""" prev = sys.path[:], sys.meta_path[:], sys.path_hooks[:] try: yield finally: sys.path, sys.meta_path, sys.path_hooks = prev @contextlib.contextmanager def save_sys_modules(): """Make sure initial ``sys.modules`` is preserved""" prev_modules = sys.modules try: sys.modules = sys.modules.copy() yield finally: sys.modules = prev_modules tests/test_sandbox.py 0000644 00000010352 15030122015 0010743 0 ustar 00 """develop tests""" import os import types import pytest import pkg_resources import setuptools.sandbox class TestSandbox: def test_devnull(self, tmpdir): with setuptools.sandbox.DirectorySandbox(str(tmpdir)): self._file_writer(os.devnull) @staticmethod def _file_writer(path): def do_write(): with open(path, 'w', encoding="utf-8") as f: f.write('xxx') return do_write def test_setup_py_with_BOM(self): """ It should be possible to execute a setup.py with a Byte Order Mark """ target = pkg_resources.resource_filename(__name__, 'script-with-bom.py') namespace = types.ModuleType('namespace') setuptools.sandbox._execfile(target, vars(namespace)) assert namespace.result == 'passed' def test_setup_py_with_CRLF(self, tmpdir): setup_py = tmpdir / 'setup.py' with setup_py.open('wb') as stream: stream.write(b'"degenerate script"\r\n') setuptools.sandbox._execfile(str(setup_py), globals()) class TestExceptionSaver: def test_exception_trapped(self): with setuptools.sandbox.ExceptionSaver(): raise ValueError("details") def test_exception_resumed(self): with setuptools.sandbox.ExceptionSaver() as saved_exc: raise ValueError("details") with pytest.raises(ValueError) as caught: saved_exc.resume() assert isinstance(caught.value, ValueError) assert str(caught.value) == 'details' def test_exception_reconstructed(self): orig_exc = ValueError("details") with setuptools.sandbox.ExceptionSaver() as saved_exc: raise orig_exc with pytest.raises(ValueError) as caught: saved_exc.resume() assert isinstance(caught.value, ValueError) assert caught.value is not orig_exc def test_no_exception_passes_quietly(self): with setuptools.sandbox.ExceptionSaver() as saved_exc: pass saved_exc.resume() def test_unpickleable_exception(self): class CantPickleThis(Exception): "This Exception is unpickleable because it's not in globals" def __repr__(self) -> str: return f'CantPickleThis{self.args!r}' with setuptools.sandbox.ExceptionSaver() as saved_exc: raise CantPickleThis('detail') with pytest.raises(setuptools.sandbox.UnpickleableException) as caught: saved_exc.resume() assert str(caught.value) == "CantPickleThis('detail',)" def test_unpickleable_exception_when_hiding_setuptools(self): """ As revealed in #440, an infinite recursion can occur if an unpickleable exception while setuptools is hidden. Ensure this doesn't happen. """ class ExceptionUnderTest(Exception): """ An unpickleable exception (not in globals). """ with pytest.raises(setuptools.sandbox.UnpickleableException) as caught: with setuptools.sandbox.save_modules(): setuptools.sandbox.hide_setuptools() raise ExceptionUnderTest (msg,) = caught.value.args assert msg == 'ExceptionUnderTest()' def test_sandbox_violation_raised_hiding_setuptools(self, tmpdir): """ When in a sandbox with setuptools hidden, a SandboxViolation should reflect a proper exception and not be wrapped in an UnpickleableException. """ def write_file(): "Trigger a SandboxViolation by writing outside the sandbox" with open('/etc/foo', 'w', encoding="utf-8"): pass with pytest.raises(setuptools.sandbox.SandboxViolation) as caught: with setuptools.sandbox.save_modules(): setuptools.sandbox.hide_setuptools() with setuptools.sandbox.DirectorySandbox(str(tmpdir)): write_file() cmd, args, kwargs = caught.value.args assert cmd == 'open' assert args == ('/etc/foo', 'w') assert kwargs == {"encoding": "utf-8"} msg = str(caught.value) assert 'open' in msg assert "('/etc/foo', 'w')" in msg assert "{'encoding': 'utf-8'}" in msg tests/test_setopt.py 0000644 00000002525 15030122015 0010626 0 ustar 00 import configparser from setuptools.command import setopt class TestEdit: @staticmethod def parse_config(filename): parser = configparser.ConfigParser() with open(filename, encoding='utf-8') as reader: parser.read_file(reader) return parser @staticmethod def write_text(file, content): with open(file, 'wb') as strm: strm.write(content.encode('utf-8')) def test_utf8_encoding_retained(self, tmpdir): """ When editing a file, non-ASCII characters encoded in UTF-8 should be retained. """ config = tmpdir.join('setup.cfg') self.write_text(str(config), '[names]\njaraco=джарако') setopt.edit_config(str(config), dict(names=dict(other='yes'))) parser = self.parse_config(str(config)) assert parser.get('names', 'jaraco') == 'джарако' assert parser.get('names', 'other') == 'yes' def test_case_retained(self, tmpdir): """ When editing a file, case of keys should be retained. """ config = tmpdir.join('setup.cfg') self.write_text(str(config), '[names]\nFoO=bAr') setopt.edit_config(str(config), dict(names=dict(oTher='yes'))) actual = config.read_text(encoding='ascii') assert 'FoO' in actual assert 'oTher' in actual tests/test_namespaces.py 0000644 00000010643 15030122015 0011427 0 ustar 00 import subprocess import sys from setuptools._path import paths_on_pythonpath from . import namespaces class TestNamespaces: def test_mixed_site_and_non_site(self, tmpdir): """ Installing two packages sharing the same namespace, one installed to a site dir and the other installed just to a path on PYTHONPATH should leave the namespace in tact and both packages reachable by import. """ pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') site_packages = tmpdir / 'site-packages' path_packages = tmpdir / 'path-packages' targets = site_packages, path_packages # use pip to install to the target directory install_cmd = [ sys.executable, '-m', 'pip.__main__', 'install', str(pkg_A), '-t', str(site_packages), ] subprocess.check_call(install_cmd) namespaces.make_site_dir(site_packages) install_cmd = [ sys.executable, '-m', 'pip.__main__', 'install', str(pkg_B), '-t', str(path_packages), ] subprocess.check_call(install_cmd) try_import = [ sys.executable, '-c', 'import myns.pkgA; import myns.pkgB', ] with paths_on_pythonpath(map(str, targets)): subprocess.check_call(try_import) def test_pkg_resources_import(self, tmpdir): """ Ensure that a namespace package doesn't break on import of pkg_resources. """ pkg = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') target = tmpdir / 'packages' target.mkdir() install_cmd = [ sys.executable, '-m', 'pip', 'install', '-t', str(target), str(pkg), ] with paths_on_pythonpath([str(target)]): subprocess.check_call(install_cmd) namespaces.make_site_dir(target) try_import = [ sys.executable, '-c', 'import pkg_resources', ] with paths_on_pythonpath([str(target)]): subprocess.check_call(try_import) def test_namespace_package_installed_and_cwd(self, tmpdir): """ Installing a namespace packages but also having it in the current working directory, only one version should take precedence. """ pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') target = tmpdir / 'packages' # use pip to install to the target directory install_cmd = [ sys.executable, '-m', 'pip.__main__', 'install', str(pkg_A), '-t', str(target), ] subprocess.check_call(install_cmd) namespaces.make_site_dir(target) # ensure that package imports and pkg_resources imports pkg_resources_imp = [ sys.executable, '-c', 'import pkg_resources; import myns.pkgA', ] with paths_on_pythonpath([str(target)]): subprocess.check_call(pkg_resources_imp, cwd=str(pkg_A)) def test_packages_in_the_same_namespace_installed_and_cwd(self, tmpdir): """ Installing one namespace package and also have another in the same namespace in the current working directory, both of them must be importable. """ pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') target = tmpdir / 'packages' # use pip to install to the target directory install_cmd = [ sys.executable, '-m', 'pip.__main__', 'install', str(pkg_A), '-t', str(target), ] subprocess.check_call(install_cmd) namespaces.make_site_dir(target) # ensure that all packages import and pkg_resources imports pkg_resources_imp = [ sys.executable, '-c', 'import pkg_resources; import myns.pkgA; import myns.pkgB', ] with paths_on_pythonpath([str(target)]): subprocess.check_call(pkg_resources_imp, cwd=str(pkg_B)) tests/test_build_meta.py 0000644 00000101011 15030122015 0011403 0 ustar 00 import contextlib import importlib import os import re import shutil import signal import sys import tarfile import warnings from concurrent import futures from pathlib import Path from typing import Any, Callable from zipfile import ZipFile import pytest from jaraco import path from packaging.requirements import Requirement from setuptools.warnings import SetuptoolsDeprecationWarning from .textwrap import DALS SETUP_SCRIPT_STUB = "__import__('setuptools').setup()" TIMEOUT = int(os.getenv("TIMEOUT_BACKEND_TEST", "180")) # in seconds IS_PYPY = '__pypy__' in sys.builtin_module_names pytestmark = pytest.mark.skipif( sys.platform == "win32" and IS_PYPY, reason="The combination of PyPy + Windows + pytest-xdist + ProcessPoolExecutor " "is flaky and problematic", ) class BuildBackendBase: def __init__(self, cwd='.', env=None, backend_name='setuptools.build_meta'): self.cwd = cwd self.env = env or {} self.backend_name = backend_name class BuildBackend(BuildBackendBase): """PEP 517 Build Backend""" def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.pool = futures.ProcessPoolExecutor(max_workers=1) def __getattr__(self, name: str) -> Callable[..., Any]: """Handles arbitrary function invocations on the build backend.""" def method(*args, **kw): root = os.path.abspath(self.cwd) caller = BuildBackendCaller(root, self.env, self.backend_name) pid = None try: pid = self.pool.submit(os.getpid).result(TIMEOUT) return self.pool.submit(caller, name, *args, **kw).result(TIMEOUT) except futures.TimeoutError: self.pool.shutdown(wait=False) # doesn't stop already running processes self._kill(pid) pytest.xfail(f"Backend did not respond before timeout ({TIMEOUT} s)") except (futures.process.BrokenProcessPool, MemoryError, OSError): if IS_PYPY: pytest.xfail("PyPy frequently fails tests with ProcessPoolExector") raise return method def _kill(self, pid): if pid is None: return with contextlib.suppress(ProcessLookupError, OSError): os.kill(pid, signal.SIGTERM if os.name == "nt" else signal.SIGKILL) class BuildBackendCaller(BuildBackendBase): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) (self.backend_name, _, self.backend_obj) = self.backend_name.partition(':') def __call__(self, name, *args, **kw): """Handles arbitrary function invocations on the build backend.""" os.chdir(self.cwd) os.environ.update(self.env) mod = importlib.import_module(self.backend_name) if self.backend_obj: backend = getattr(mod, self.backend_obj) else: backend = mod return getattr(backend, name)(*args, **kw) defns = [ { # simple setup.py script 'setup.py': DALS( """ __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), }, { # setup.py that relies on __name__ 'setup.py': DALS( """ assert __name__ == '__main__' __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), }, { # setup.py script that runs arbitrary code 'setup.py': DALS( """ variable = True def function(): return variable assert variable __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), }, { # setup.py script that constructs temp files to be included in the distribution 'setup.py': DALS( """ # Some packages construct files on the fly, include them in the package, # and immediately remove them after `setup()` (e.g. pybind11==2.9.1). # Therefore, we cannot use `distutils.core.run_setup(..., stop_after=...)` # to obtain a distribution object first, and then run the distutils # commands later, because these files will be removed in the meantime. with open('world.py', 'w', encoding="utf-8") as f: f.write('x = 42') try: __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['world'], setup_requires=['six'], ) finally: # Some packages will clean temporary files __import__('os').unlink('world.py') """ ), }, { # setup.cfg only 'setup.cfg': DALS( """ [metadata] name = foo version = 0.0.0 [options] py_modules=hello setup_requires=six """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), }, { # setup.cfg and setup.py 'setup.cfg': DALS( """ [metadata] name = foo version = 0.0.0 [options] py_modules=hello setup_requires=six """ ), 'setup.py': "__import__('setuptools').setup()", 'hello.py': DALS( """ def run(): print('hello') """ ), }, ] class TestBuildMetaBackend: backend_name = 'setuptools.build_meta' def get_build_backend(self): return BuildBackend(backend_name=self.backend_name) @pytest.fixture(params=defns) def build_backend(self, tmpdir, request): path.build(request.param, prefix=str(tmpdir)) with tmpdir.as_cwd(): yield self.get_build_backend() def test_get_requires_for_build_wheel(self, build_backend): actual = build_backend.get_requires_for_build_wheel() expected = ['six'] assert sorted(actual) == sorted(expected) def test_get_requires_for_build_sdist(self, build_backend): actual = build_backend.get_requires_for_build_sdist() expected = ['six'] assert sorted(actual) == sorted(expected) def test_build_wheel(self, build_backend): dist_dir = os.path.abspath('pip-wheel') os.makedirs(dist_dir) wheel_name = build_backend.build_wheel(dist_dir) wheel_file = os.path.join(dist_dir, wheel_name) assert os.path.isfile(wheel_file) # Temporary files should be removed assert not os.path.isfile('world.py') with ZipFile(wheel_file) as zipfile: wheel_contents = set(zipfile.namelist()) # Each one of the examples have a single module # that should be included in the distribution python_scripts = (f for f in wheel_contents if f.endswith('.py')) modules = [f for f in python_scripts if not f.endswith('setup.py')] assert len(modules) == 1 @pytest.mark.parametrize('build_type', ('wheel', 'sdist')) def test_build_with_existing_file_present(self, build_type, tmpdir_cwd): # Building a sdist/wheel should still succeed if there's # already a sdist/wheel in the destination directory. files = { 'setup.py': "from setuptools import setup\nsetup()", 'VERSION': "0.0.1", 'setup.cfg': DALS( """ [metadata] name = foo version = file: VERSION """ ), 'pyproject.toml': DALS( """ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" """ ), } path.build(files) dist_dir = os.path.abspath('preexisting-' + build_type) build_backend = self.get_build_backend() build_method = getattr(build_backend, 'build_' + build_type) # Build a first sdist/wheel. # Note: this also check the destination directory is # successfully created if it does not exist already. first_result = build_method(dist_dir) # Change version. with open("VERSION", "wt", encoding="utf-8") as version_file: version_file.write("0.0.2") # Build a *second* sdist/wheel. second_result = build_method(dist_dir) assert os.path.isfile(os.path.join(dist_dir, first_result)) assert first_result != second_result # And if rebuilding the exact same sdist/wheel? open(os.path.join(dist_dir, second_result), 'wb').close() third_result = build_method(dist_dir) assert third_result == second_result assert os.path.getsize(os.path.join(dist_dir, third_result)) > 0 @pytest.mark.parametrize("setup_script", [None, SETUP_SCRIPT_STUB]) def test_build_with_pyproject_config(self, tmpdir, setup_script): files = { 'pyproject.toml': DALS( """ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "foo" license = {text = "MIT"} description = "This is a Python package" dynamic = ["version", "readme"] classifiers = [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers" ] urls = {Homepage = "http://github.com"} dependencies = [ "appdirs", ] [project.optional-dependencies] all = [ "tomli>=1", "pyscaffold>=4,<5", 'importlib; python_version == "2.6"', ] [project.scripts] foo = "foo.cli:main" [tool.setuptools] zip-safe = false package-dir = {"" = "src"} packages = {find = {where = ["src"]}} license-files = ["LICENSE*"] [tool.setuptools.dynamic] version = {attr = "foo.__version__"} readme = {file = "README.rst"} [tool.distutils.sdist] formats = "gztar" """ ), "MANIFEST.in": DALS( """ global-include *.py *.txt global-exclude *.py[cod] """ ), "README.rst": "This is a ``README``", "LICENSE.txt": "---- placeholder MIT license ----", "src": { "foo": { "__init__.py": "__version__ = '0.1'", "__init__.pyi": "__version__: str", "cli.py": "def main(): print('hello world')", "data.txt": "def main(): print('hello world')", "py.typed": "", } }, } if setup_script: files["setup.py"] = setup_script build_backend = self.get_build_backend() with tmpdir.as_cwd(): path.build(files) msgs = [ "'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'", "`project.license` as a TOML table is deprecated", ] with warnings.catch_warnings(): for msg in msgs: warnings.filterwarnings("ignore", msg, SetuptoolsDeprecationWarning) sdist_path = build_backend.build_sdist("temp") wheel_file = build_backend.build_wheel("temp") with tarfile.open(os.path.join(tmpdir, "temp", sdist_path)) as tar: sdist_contents = set(tar.getnames()) with ZipFile(os.path.join(tmpdir, "temp", wheel_file)) as zipfile: wheel_contents = set(zipfile.namelist()) metadata = str(zipfile.read("foo-0.1.dist-info/METADATA"), "utf-8") license = str( zipfile.read("foo-0.1.dist-info/licenses/LICENSE.txt"), "utf-8" ) epoints = str(zipfile.read("foo-0.1.dist-info/entry_points.txt"), "utf-8") assert sdist_contents - {"foo-0.1/setup.py"} == { 'foo-0.1', 'foo-0.1/LICENSE.txt', 'foo-0.1/MANIFEST.in', 'foo-0.1/PKG-INFO', 'foo-0.1/README.rst', 'foo-0.1/pyproject.toml', 'foo-0.1/setup.cfg', 'foo-0.1/src', 'foo-0.1/src/foo', 'foo-0.1/src/foo/__init__.py', 'foo-0.1/src/foo/__init__.pyi', 'foo-0.1/src/foo/cli.py', 'foo-0.1/src/foo/data.txt', 'foo-0.1/src/foo/py.typed', 'foo-0.1/src/foo.egg-info', 'foo-0.1/src/foo.egg-info/PKG-INFO', 'foo-0.1/src/foo.egg-info/SOURCES.txt', 'foo-0.1/src/foo.egg-info/dependency_links.txt', 'foo-0.1/src/foo.egg-info/entry_points.txt', 'foo-0.1/src/foo.egg-info/requires.txt', 'foo-0.1/src/foo.egg-info/top_level.txt', 'foo-0.1/src/foo.egg-info/not-zip-safe', } assert wheel_contents == { "foo/__init__.py", "foo/__init__.pyi", # include type information by default "foo/cli.py", "foo/data.txt", # include_package_data defaults to True "foo/py.typed", # include type information by default "foo-0.1.dist-info/licenses/LICENSE.txt", "foo-0.1.dist-info/METADATA", "foo-0.1.dist-info/WHEEL", "foo-0.1.dist-info/entry_points.txt", "foo-0.1.dist-info/top_level.txt", "foo-0.1.dist-info/RECORD", } assert license == "---- placeholder MIT license ----" for line in ( "Summary: This is a Python package", "License: MIT", "License-File: LICENSE.txt", "Classifier: Intended Audience :: Developers", "Requires-Dist: appdirs", "Requires-Dist: " + str(Requirement('tomli>=1 ; extra == "all"')), "Requires-Dist: " + str(Requirement('importlib; python_version=="2.6" and extra =="all"')), ): assert line in metadata, (line, metadata) assert metadata.strip().endswith("This is a ``README``") assert epoints.strip() == "[console_scripts]\nfoo = foo.cli:main" def test_static_metadata_in_pyproject_config(self, tmpdir): # Make sure static metadata in pyproject.toml is not overwritten by setup.py # as required by PEP 621 files = { 'pyproject.toml': DALS( """ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "foo" description = "This is a Python package" version = "42" dependencies = ["six"] """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), 'setup.py': DALS( """ __import__('setuptools').setup( name='bar', version='13', ) """ ), } build_backend = self.get_build_backend() with tmpdir.as_cwd(): path.build(files) sdist_path = build_backend.build_sdist("temp") wheel_file = build_backend.build_wheel("temp") assert (tmpdir / "temp/foo-42.tar.gz").exists() assert (tmpdir / "temp/foo-42-py3-none-any.whl").exists() assert not (tmpdir / "temp/bar-13.tar.gz").exists() assert not (tmpdir / "temp/bar-42.tar.gz").exists() assert not (tmpdir / "temp/foo-13.tar.gz").exists() assert not (tmpdir / "temp/bar-13-py3-none-any.whl").exists() assert not (tmpdir / "temp/bar-42-py3-none-any.whl").exists() assert not (tmpdir / "temp/foo-13-py3-none-any.whl").exists() with tarfile.open(os.path.join(tmpdir, "temp", sdist_path)) as tar: pkg_info = str(tar.extractfile('foo-42/PKG-INFO').read(), "utf-8") members = tar.getnames() assert "bar-13/PKG-INFO" not in members with ZipFile(os.path.join(tmpdir, "temp", wheel_file)) as zipfile: metadata = str(zipfile.read("foo-42.dist-info/METADATA"), "utf-8") members = zipfile.namelist() assert "bar-13.dist-info/METADATA" not in members for file in pkg_info, metadata: for line in ("Name: foo", "Version: 42"): assert line in file for line in ("Name: bar", "Version: 13"): assert line not in file def test_build_sdist(self, build_backend): dist_dir = os.path.abspath('pip-sdist') os.makedirs(dist_dir) sdist_name = build_backend.build_sdist(dist_dir) assert os.path.isfile(os.path.join(dist_dir, sdist_name)) def test_prepare_metadata_for_build_wheel(self, build_backend): dist_dir = os.path.abspath('pip-dist-info') os.makedirs(dist_dir) dist_info = build_backend.prepare_metadata_for_build_wheel(dist_dir) assert os.path.isfile(os.path.join(dist_dir, dist_info, 'METADATA')) def test_prepare_metadata_inplace(self, build_backend): """ Some users might pass metadata_directory pre-populated with `.tox` or `.venv`. See issue #3523. """ for pre_existing in [ ".tox/python/lib/python3.10/site-packages/attrs-22.1.0.dist-info", ".tox/python/lib/python3.10/site-packages/autocommand-2.2.1.dist-info", ".nox/python/lib/python3.10/site-packages/build-0.8.0.dist-info", ".venv/python3.10/site-packages/click-8.1.3.dist-info", "venv/python3.10/site-packages/distlib-0.3.5.dist-info", "env/python3.10/site-packages/docutils-0.19.dist-info", ]: os.makedirs(pre_existing, exist_ok=True) dist_info = build_backend.prepare_metadata_for_build_wheel(".") assert os.path.isfile(os.path.join(dist_info, 'METADATA')) def test_build_sdist_explicit_dist(self, build_backend): # explicitly specifying the dist folder should work # the folder sdist_directory and the ``--dist-dir`` can be the same dist_dir = os.path.abspath('dist') sdist_name = build_backend.build_sdist(dist_dir) assert os.path.isfile(os.path.join(dist_dir, sdist_name)) def test_build_sdist_version_change(self, build_backend): sdist_into_directory = os.path.abspath("out_sdist") os.makedirs(sdist_into_directory) sdist_name = build_backend.build_sdist(sdist_into_directory) assert os.path.isfile(os.path.join(sdist_into_directory, sdist_name)) # if the setup.py changes subsequent call of the build meta # should still succeed, given the # sdist_directory the frontend specifies is empty setup_loc = os.path.abspath("setup.py") if not os.path.exists(setup_loc): setup_loc = os.path.abspath("setup.cfg") with open(setup_loc, 'rt', encoding="utf-8") as file_handler: content = file_handler.read() with open(setup_loc, 'wt', encoding="utf-8") as file_handler: file_handler.write(content.replace("version='0.0.0'", "version='0.0.1'")) shutil.rmtree(sdist_into_directory) os.makedirs(sdist_into_directory) sdist_name = build_backend.build_sdist("out_sdist") assert os.path.isfile(os.path.join(os.path.abspath("out_sdist"), sdist_name)) def test_build_sdist_pyproject_toml_exists(self, tmpdir_cwd): files = { 'setup.py': DALS( """ __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'] )""" ), 'hello.py': '', 'pyproject.toml': DALS( """ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" """ ), } path.build(files) build_backend = self.get_build_backend() targz_path = build_backend.build_sdist("temp") with tarfile.open(os.path.join("temp", targz_path)) as tar: assert any('pyproject.toml' in name for name in tar.getnames()) def test_build_sdist_setup_py_exists(self, tmpdir_cwd): # If build_sdist is called from a script other than setup.py, # ensure setup.py is included path.build(defns[0]) build_backend = self.get_build_backend() targz_path = build_backend.build_sdist("temp") with tarfile.open(os.path.join("temp", targz_path)) as tar: assert any('setup.py' in name for name in tar.getnames()) def test_build_sdist_setup_py_manifest_excluded(self, tmpdir_cwd): # Ensure that MANIFEST.in can exclude setup.py files = { 'setup.py': DALS( """ __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'] )""" ), 'hello.py': '', 'MANIFEST.in': DALS( """ exclude setup.py """ ), } path.build(files) build_backend = self.get_build_backend() targz_path = build_backend.build_sdist("temp") with tarfile.open(os.path.join("temp", targz_path)) as tar: assert not any('setup.py' in name for name in tar.getnames()) def test_build_sdist_builds_targz_even_if_zip_indicated(self, tmpdir_cwd): files = { 'setup.py': DALS( """ __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'] )""" ), 'hello.py': '', 'setup.cfg': DALS( """ [sdist] formats=zip """ ), } path.build(files) build_backend = self.get_build_backend() build_backend.build_sdist("temp") _relative_path_import_files = { 'setup.py': DALS( """ __import__('setuptools').setup( name='foo', version=__import__('hello').__version__, py_modules=['hello'] )""" ), 'hello.py': '__version__ = "0.0.0"', 'setup.cfg': DALS( """ [sdist] formats=zip """ ), } def test_build_sdist_relative_path_import(self, tmpdir_cwd): path.build(self._relative_path_import_files) build_backend = self.get_build_backend() with pytest.raises(ImportError, match="^No module named 'hello'$"): build_backend.build_sdist("temp") _simple_pyproject_example = { "pyproject.toml": DALS( """ [project] name = "proj" version = "42" """ ), "src": {"proj": {"__init__.py": ""}}, } def _assert_link_tree(self, parent_dir): """All files in the directory should be either links or hard links""" files = list(Path(parent_dir).glob("**/*")) assert files # Should not be empty for file in files: assert file.is_symlink() or os.stat(file).st_nlink > 0 def test_editable_without_config_settings(self, tmpdir_cwd): """ Sanity check to ensure tests with --mode=strict are different from the ones without --mode. --mode=strict should create a local directory with a package tree. The directory should not get created otherwise. """ path.build(self._simple_pyproject_example) build_backend = self.get_build_backend() assert not Path("build").exists() build_backend.build_editable("temp") assert not Path("build").exists() def test_build_wheel_inplace(self, tmpdir_cwd): config_settings = {"--build-option": ["build_ext", "--inplace"]} path.build(self._simple_pyproject_example) build_backend = self.get_build_backend() assert not Path("build").exists() Path("build").mkdir() build_backend.prepare_metadata_for_build_wheel("build", config_settings) build_backend.build_wheel("build", config_settings) assert Path("build/proj-42-py3-none-any.whl").exists() @pytest.mark.parametrize("config_settings", [{"editable-mode": "strict"}]) def test_editable_with_config_settings(self, tmpdir_cwd, config_settings): path.build({**self._simple_pyproject_example, '_meta': {}}) assert not Path("build").exists() build_backend = self.get_build_backend() build_backend.prepare_metadata_for_build_editable("_meta", config_settings) build_backend.build_editable("temp", config_settings, "_meta") self._assert_link_tree(next(Path("build").glob("__editable__.*"))) @pytest.mark.parametrize( ("setup_literal", "requirements"), [ ("'foo'", ['foo']), ("['foo']", ['foo']), (r"'foo\n'", ['foo']), (r"'foo\n\n'", ['foo']), ("['foo', 'bar']", ['foo', 'bar']), (r"'# Has a comment line\nfoo'", ['foo']), (r"'foo # Has an inline comment'", ['foo']), (r"'foo \\\n >=3.0'", ['foo>=3.0']), (r"'foo\nbar'", ['foo', 'bar']), (r"'foo\nbar\n'", ['foo', 'bar']), (r"['foo\n', 'bar\n']", ['foo', 'bar']), ], ) @pytest.mark.parametrize('use_wheel', [True, False]) def test_setup_requires(self, setup_literal, requirements, use_wheel, tmpdir_cwd): files = { 'setup.py': DALS( """ from setuptools import setup setup( name="qux", version="0.0.0", py_modules=["hello"], setup_requires={setup_literal}, ) """ ).format(setup_literal=setup_literal), 'hello.py': DALS( """ def run(): print('hello') """ ), } path.build(files) build_backend = self.get_build_backend() if use_wheel: get_requires = build_backend.get_requires_for_build_wheel else: get_requires = build_backend.get_requires_for_build_sdist # Ensure that the build requirements are properly parsed expected = sorted(requirements) actual = get_requires() assert expected == sorted(actual) def test_setup_requires_with_auto_discovery(self, tmpdir_cwd): # Make sure patches introduced to retrieve setup_requires don't accidentally # activate auto-discovery and cause problems due to the incomplete set of # attributes passed to MinimalDistribution files = { 'pyproject.toml': DALS( """ [project] name = "proj" version = "42" """ ), "setup.py": DALS( """ __import__('setuptools').setup( setup_requires=["foo"], py_modules = ["hello", "world"] ) """ ), 'hello.py': "'hello'", 'world.py': "'world'", } path.build(files) build_backend = self.get_build_backend() setup_requires = build_backend.get_requires_for_build_wheel() assert setup_requires == ["foo"] def test_dont_install_setup_requires(self, tmpdir_cwd): files = { 'setup.py': DALS( """ from setuptools import setup setup( name="qux", version="0.0.0", py_modules=["hello"], setup_requires=["does-not-exist >99"], ) """ ), 'hello.py': DALS( """ def run(): print('hello') """ ), } path.build(files) build_backend = self.get_build_backend() dist_dir = os.path.abspath('pip-dist-info') os.makedirs(dist_dir) # does-not-exist can't be satisfied, so if it attempts to install # setup_requires, it will fail. build_backend.prepare_metadata_for_build_wheel(dist_dir) _sys_argv_0_passthrough = { 'setup.py': DALS( """ import os import sys __import__('setuptools').setup( name='foo', version='0.0.0', ) sys_argv = os.path.abspath(sys.argv[0]) file_path = os.path.abspath('setup.py') assert sys_argv == file_path """ ) } def test_sys_argv_passthrough(self, tmpdir_cwd): path.build(self._sys_argv_0_passthrough) build_backend = self.get_build_backend() with pytest.raises(AssertionError): build_backend.build_sdist("temp") _setup_py_file_abspath = { 'setup.py': DALS( """ import os assert os.path.isabs(__file__) __import__('setuptools').setup( name='foo', version='0.0.0', py_modules=['hello'], setup_requires=['six'], ) """ ) } def test_setup_py_file_abspath(self, tmpdir_cwd): path.build(self._setup_py_file_abspath) build_backend = self.get_build_backend() build_backend.build_sdist("temp") @pytest.mark.parametrize('build_hook', ('build_sdist', 'build_wheel')) def test_build_with_empty_setuppy(self, build_backend, build_hook): files = {'setup.py': ''} path.build(files) msg = re.escape('No distribution was found.') with pytest.raises(ValueError, match=msg): getattr(build_backend, build_hook)("temp") class TestBuildMetaLegacyBackend(TestBuildMetaBackend): backend_name = 'setuptools.build_meta:__legacy__' # build_meta_legacy-specific tests def test_build_sdist_relative_path_import(self, tmpdir_cwd): # This must fail in build_meta, but must pass in build_meta_legacy path.build(self._relative_path_import_files) build_backend = self.get_build_backend() build_backend.build_sdist("temp") def test_sys_argv_passthrough(self, tmpdir_cwd): path.build(self._sys_argv_0_passthrough) build_backend = self.get_build_backend() build_backend.build_sdist("temp") @pytest.mark.filterwarnings("ignore::setuptools.SetuptoolsDeprecationWarning") def test_sys_exit_0_in_setuppy(monkeypatch, tmp_path): """Setuptools should be resilient to setup.py with ``sys.exit(0)`` (#3973).""" monkeypatch.chdir(tmp_path) setuppy = """ import sys, setuptools setuptools.setup(name='foo', version='0.0.0') sys.exit(0) """ (tmp_path / "setup.py").write_text(DALS(setuppy), encoding="utf-8") backend = BuildBackend(backend_name="setuptools.build_meta") assert backend.get_requires_for_build_wheel() == [] def test_system_exit_in_setuppy(monkeypatch, tmp_path): monkeypatch.chdir(tmp_path) setuppy = "import sys; sys.exit('some error')" (tmp_path / "setup.py").write_text(setuppy, encoding="utf-8") with pytest.raises(SystemExit, match="some error"): backend = BuildBackend(backend_name="setuptools.build_meta") backend.get_requires_for_build_wheel() tests/test_build.py 0000644 00000001436 15030122015 0010407 0 ustar 00 from setuptools import Command from setuptools.command.build import build from setuptools.dist import Distribution def test_distribution_gives_setuptools_build_obj(tmpdir_cwd): """ Check that the setuptools Distribution uses the setuptools specific build object. """ dist = Distribution( dict( script_name='setup.py', script_args=['build'], packages=[], package_data={'': ['path/*']}, ) ) assert isinstance(dist.get_command_obj("build"), build) class Subcommand(Command): """Dummy command to be used in tests""" def initialize_options(self): pass def finalize_options(self): pass def run(self): raise NotImplementedError("just to check if the command runs") tests/test_logging.py 0000644 00000004063 15030122015 0010735 0 ustar 00 import functools import inspect import logging import sys import pytest IS_PYPY = '__pypy__' in sys.builtin_module_names setup_py = """\ from setuptools import setup setup( name="test_logging", version="0.0" ) """ @pytest.mark.parametrize( ('flag', 'expected_level'), [("--dry-run", "INFO"), ("--verbose", "DEBUG")] ) def test_verbosity_level(tmp_path, monkeypatch, flag, expected_level): """Make sure the correct verbosity level is set (issue #3038)""" import setuptools # noqa: F401 # import setuptools to monkeypatch distutils import distutils # <- load distutils after all the patches take place logger = logging.Logger(__name__) monkeypatch.setattr(logging, "root", logger) unset_log_level = logger.getEffectiveLevel() assert logging.getLevelName(unset_log_level) == "NOTSET" setup_script = tmp_path / "setup.py" setup_script.write_text(setup_py, encoding="utf-8") dist = distutils.core.run_setup(setup_script, stop_after="init") dist.script_args = [flag, "sdist"] dist.parse_command_line() # <- where the log level is set log_level = logger.getEffectiveLevel() log_level_name = logging.getLevelName(log_level) assert log_level_name == expected_level def flaky_on_pypy(func): @functools.wraps(func) def _func(): try: func() except AssertionError: # pragma: no cover if IS_PYPY: msg = "Flaky monkeypatch on PyPy (#4124)" pytest.xfail(f"{msg}. Original discussion in #3707, #3709.") raise return _func @flaky_on_pypy def test_patching_does_not_cause_problems(): # Ensure `dist.log` is only patched if necessary import _distutils_hack import setuptools.logging from distutils import dist setuptools.logging.configure() if _distutils_hack.enabled(): # Modern logging infra, no problematic patching. assert dist.__file__ is None or "setuptools" in dist.__file__ assert isinstance(dist.log, logging.Logger) else: assert inspect.ismodule(dist.log) tests/test_egg_info.py 0000644 00000127502 15030122015 0011070 0 ustar 00 from __future__ import annotations import ast import glob import os import re import stat import sys import time from pathlib import Path from unittest import mock import pytest from jaraco import path from setuptools import errors from setuptools.command.egg_info import egg_info, manifest_maker, write_entries from setuptools.dist import Distribution from . import contexts, environment from .textwrap import DALS class Environment(str): pass @pytest.fixture def env(): with contexts.tempdir(prefix='setuptools-test.') as env_dir: env = Environment(env_dir) os.chmod(env_dir, stat.S_IRWXU) subs = 'home', 'lib', 'scripts', 'data', 'egg-base' env.paths = dict((dirname, os.path.join(env_dir, dirname)) for dirname in subs) list(map(os.mkdir, env.paths.values())) path.build({ env.paths['home']: { '.pydistutils.cfg': DALS( """ [egg_info] egg-base = {egg-base} """.format(**env.paths) ) } }) yield env class TestEggInfo: setup_script = DALS( """ from setuptools import setup setup( name='foo', py_modules=['hello'], entry_points={'console_scripts': ['hi = hello.run']}, zip_safe=False, ) """ ) def _create_project(self): path.build({ 'setup.py': self.setup_script, 'hello.py': DALS( """ def run(): print('hello') """ ), }) @staticmethod def _extract_mv_version(pkg_info_lines: list[str]) -> tuple[int, int]: version_str = pkg_info_lines[0].split(' ')[1] major, minor = map(int, version_str.split('.')[:2]) return major, minor def test_egg_info_save_version_info_setup_empty(self, tmpdir_cwd, env): """ When the egg_info section is empty or not present, running save_version_info should add the settings to the setup.cfg in a deterministic order. """ setup_cfg = os.path.join(env.paths['home'], 'setup.cfg') dist = Distribution() ei = egg_info(dist) ei.initialize_options() ei.save_version_info(setup_cfg) with open(setup_cfg, 'r', encoding="utf-8") as f: content = f.read() assert '[egg_info]' in content assert 'tag_build =' in content assert 'tag_date = 0' in content expected_order = ( 'tag_build', 'tag_date', ) self._validate_content_order(content, expected_order) @staticmethod def _validate_content_order(content, expected): """ Assert that the strings in expected appear in content in order. """ pattern = '.*'.join(expected) flags = re.MULTILINE | re.DOTALL assert re.search(pattern, content, flags) def test_egg_info_save_version_info_setup_defaults(self, tmpdir_cwd, env): """ When running save_version_info on an existing setup.cfg with the 'default' values present from a previous run, the file should remain unchanged. """ setup_cfg = os.path.join(env.paths['home'], 'setup.cfg') path.build({ setup_cfg: DALS( """ [egg_info] tag_build = tag_date = 0 """ ), }) dist = Distribution() ei = egg_info(dist) ei.initialize_options() ei.save_version_info(setup_cfg) with open(setup_cfg, 'r', encoding="utf-8") as f: content = f.read() assert '[egg_info]' in content assert 'tag_build =' in content assert 'tag_date = 0' in content expected_order = ( 'tag_build', 'tag_date', ) self._validate_content_order(content, expected_order) def test_expected_files_produced(self, tmpdir_cwd, env): self._create_project() self._run_egg_info_command(tmpdir_cwd, env) actual = os.listdir('foo.egg-info') expected = [ 'PKG-INFO', 'SOURCES.txt', 'dependency_links.txt', 'entry_points.txt', 'not-zip-safe', 'top_level.txt', ] assert sorted(actual) == expected def test_handling_utime_error(self, tmpdir_cwd, env): dist = Distribution() ei = egg_info(dist) utime_patch = mock.patch('os.utime', side_effect=OSError("TEST")) mkpath_patch = mock.patch( 'setuptools.command.egg_info.egg_info.mkpath', return_val=None ) with utime_patch, mkpath_patch: import distutils.errors msg = r"Cannot update time stamp of directory 'None'" with pytest.raises(distutils.errors.DistutilsFileError, match=msg): ei.run() def test_license_is_a_string(self, tmpdir_cwd, env): setup_config = DALS( """ [metadata] name=foo version=0.0.1 license=file:MIT """ ) setup_script = DALS( """ from setuptools import setup setup() """ ) path.build({ 'setup.py': setup_script, 'setup.cfg': setup_config, }) # This command should fail with a ValueError, but because it's # currently configured to use a subprocess, the actual traceback # object is lost and we need to parse it from stderr with pytest.raises(AssertionError) as exc: self._run_egg_info_command(tmpdir_cwd, env) # The only argument to the assertion error should be a traceback # containing a ValueError assert 'ValueError' in exc.value.args[0] def test_rebuilt(self, tmpdir_cwd, env): """Ensure timestamps are updated when the command is re-run.""" self._create_project() self._run_egg_info_command(tmpdir_cwd, env) timestamp_a = os.path.getmtime('foo.egg-info') # arbitrary sleep just to handle *really* fast systems time.sleep(0.001) self._run_egg_info_command(tmpdir_cwd, env) timestamp_b = os.path.getmtime('foo.egg-info') assert timestamp_a != timestamp_b def test_manifest_template_is_read(self, tmpdir_cwd, env): self._create_project() path.build({ 'MANIFEST.in': DALS( """ recursive-include docs *.rst """ ), 'docs': { 'usage.rst': "Run 'hi'", }, }) self._run_egg_info_command(tmpdir_cwd, env) egg_info_dir = os.path.join('.', 'foo.egg-info') sources_txt = os.path.join(egg_info_dir, 'SOURCES.txt') with open(sources_txt, encoding="utf-8") as f: assert 'docs/usage.rst' in f.read().split('\n') def _setup_script_with_requires(self, requires, use_setup_cfg=False): setup_script = DALS( """ from setuptools import setup setup(name='foo', zip_safe=False, %s) """ ) % ('' if use_setup_cfg else requires) setup_config = requires if use_setup_cfg else '' path.build({ 'setup.py': setup_script, 'setup.cfg': setup_config, }) mismatch_marker = f"python_version<'{sys.version_info[0]}'" # Alternate equivalent syntax. mismatch_marker_alternate = f'python_version < "{sys.version_info[0]}"' invalid_marker = "<=>++" class RequiresTestHelper: @staticmethod def parametrize(*test_list, **format_dict): idlist = [] argvalues = [] for test in test_list: test_params = test.lstrip().split('\n\n', 3) name_kwargs = test_params.pop(0).split('\n') if len(name_kwargs) > 1: val = name_kwargs[1].strip() install_cmd_kwargs = ast.literal_eval(val) else: install_cmd_kwargs = {} name = name_kwargs[0].strip() setup_py_requires, setup_cfg_requires, expected_requires = [ DALS(a).format(**format_dict) for a in test_params ] for id_, requires, use_cfg in ( (name, setup_py_requires, False), (name + '_in_setup_cfg', setup_cfg_requires, True), ): idlist.append(id_) marks = () if requires.startswith('@xfail\n'): requires = requires[7:] marks = pytest.mark.xfail argvalues.append( pytest.param( requires, use_cfg, expected_requires, install_cmd_kwargs, marks=marks, ) ) return pytest.mark.parametrize( ( "requires", "use_setup_cfg", "expected_requires", "install_cmd_kwargs", ), argvalues, ids=idlist, ) @RequiresTestHelper.parametrize( # Format of a test: # # id # install_cmd_kwargs [optional] # # requires block (when used in setup.py) # # requires block (when used in setup.cfg) # # expected contents of requires.txt """ install_requires_deterministic install_requires=["wheel>=0.5", "pytest"] [options] install_requires = wheel>=0.5 pytest wheel>=0.5 pytest """, """ install_requires_ordered install_requires=["pytest>=3.0.2,!=10.9999"] [options] install_requires = pytest>=3.0.2,!=10.9999 pytest!=10.9999,>=3.0.2 """, """ install_requires_with_marker install_requires=["barbazquux;{mismatch_marker}"], [options] install_requires = barbazquux; {mismatch_marker} [:{mismatch_marker_alternate}] barbazquux """, """ install_requires_with_extra {'cmd': ['egg_info']} install_requires=["barbazquux [test]"], [options] install_requires = barbazquux [test] barbazquux[test] """, """ install_requires_with_extra_and_marker install_requires=["barbazquux [test]; {mismatch_marker}"], [options] install_requires = barbazquux [test]; {mismatch_marker} [:{mismatch_marker_alternate}] barbazquux[test] """, """ setup_requires_with_markers setup_requires=["barbazquux;{mismatch_marker}"], [options] setup_requires = barbazquux; {mismatch_marker} """, """ extras_require_with_extra {'cmd': ['egg_info']} extras_require={{"extra": ["barbazquux [test]"]}}, [options.extras_require] extra = barbazquux [test] [extra] barbazquux[test] """, """ extras_require_with_extra_and_marker_in_req extras_require={{"extra": ["barbazquux [test]; {mismatch_marker}"]}}, [options.extras_require] extra = barbazquux [test]; {mismatch_marker} [extra] [extra:{mismatch_marker_alternate}] barbazquux[test] """, # FIXME: ConfigParser does not allow : in key names! """ extras_require_with_marker extras_require={{":{mismatch_marker}": ["barbazquux"]}}, @xfail [options.extras_require] :{mismatch_marker} = barbazquux [:{mismatch_marker}] barbazquux """, """ extras_require_with_marker_in_req extras_require={{"extra": ["barbazquux; {mismatch_marker}"]}}, [options.extras_require] extra = barbazquux; {mismatch_marker} [extra] [extra:{mismatch_marker_alternate}] barbazquux """, """ extras_require_with_empty_section extras_require={{"empty": []}}, [options.extras_require] empty = [empty] """, # Format arguments. invalid_marker=invalid_marker, mismatch_marker=mismatch_marker, mismatch_marker_alternate=mismatch_marker_alternate, ) def test_requires( self, tmpdir_cwd, env, requires, use_setup_cfg, expected_requires, install_cmd_kwargs, ): self._setup_script_with_requires(requires, use_setup_cfg) self._run_egg_info_command(tmpdir_cwd, env, **install_cmd_kwargs) egg_info_dir = os.path.join('.', 'foo.egg-info') requires_txt = os.path.join(egg_info_dir, 'requires.txt') if os.path.exists(requires_txt): with open(requires_txt, encoding="utf-8") as fp: install_requires = fp.read() else: install_requires = '' assert install_requires.lstrip() == expected_requires assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_install_requires_unordered_disallowed(self, tmpdir_cwd, env): """ Packages that pass unordered install_requires sequences should be rejected as they produce non-deterministic builds. See #458. """ req = 'install_requires={"fake-factory==0.5.2", "pytz"}' self._setup_script_with_requires(req) with pytest.raises(AssertionError): self._run_egg_info_command(tmpdir_cwd, env) def test_extras_require_with_invalid_marker(self, tmpdir_cwd, env): tmpl = 'extras_require={{":{marker}": ["barbazquux"]}},' req = tmpl.format(marker=self.invalid_marker) self._setup_script_with_requires(req) with pytest.raises(AssertionError): self._run_egg_info_command(tmpdir_cwd, env) assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_extras_require_with_invalid_marker_in_req(self, tmpdir_cwd, env): tmpl = 'extras_require={{"extra": ["barbazquux; {marker}"]}},' req = tmpl.format(marker=self.invalid_marker) self._setup_script_with_requires(req) with pytest.raises(AssertionError): self._run_egg_info_command(tmpdir_cwd, env) assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] def test_provides_extra(self, tmpdir_cwd, env): self._setup_script_with_requires('extras_require={"foobar": ["barbazquux"]},') environ = os.environ.copy().update( HOME=env.paths['home'], ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'Provides-Extra: foobar' in pkg_info_lines assert 'Metadata-Version: 2.4' in pkg_info_lines def test_doesnt_provides_extra(self, tmpdir_cwd, env): self._setup_script_with_requires( """install_requires=["spam ; python_version<'3.6'"]""" ) environ = os.environ.copy().update( HOME=env.paths['home'], ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_text = fp.read() assert 'Provides-Extra:' not in pkg_info_text @pytest.mark.parametrize( ('files', 'license_in_sources'), [ ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE """ ), 'LICENSE': "Test license", }, True, ), # with license ( { 'setup.cfg': DALS( """ [metadata] license_file = INVALID_LICENSE """ ), 'LICENSE': "Test license", }, False, ), # with an invalid license ( { 'setup.cfg': DALS( """ """ ), 'LICENSE': "Test license", }, True, ), # no license_file attribute, LICENSE auto-included ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE """ ), 'MANIFEST.in': "exclude LICENSE", 'LICENSE': "Test license", }, True, ), # manifest is overwritten by license_file pytest.param( { 'setup.cfg': DALS( """ [metadata] license_file = LICEN[CS]E* """ ), 'LICENSE': "Test license", }, True, id="glob_pattern", ), ], ) def test_setup_cfg_license_file(self, tmpdir_cwd, env, files, license_in_sources): self._create_project() path.build(files) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), ) egg_info_dir = os.path.join('.', 'foo.egg-info') sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") if license_in_sources: assert 'LICENSE' in sources_text else: assert 'LICENSE' not in sources_text # for invalid license test assert 'INVALID_LICENSE' not in sources_text @pytest.mark.parametrize( ('files', 'incl_licenses', 'excl_licenses'), [ ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC LICENSE-XYZ """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, ['LICENSE-ABC', 'LICENSE-XYZ'], [], ), # with licenses ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC, LICENSE-XYZ """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, ['LICENSE-ABC', 'LICENSE-XYZ'], [], ), # with commas ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, ['LICENSE-ABC'], ['LICENSE-XYZ'], ), # with one license ( { 'setup.cfg': DALS( """ [metadata] license_files = """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, [], ['LICENSE-ABC', 'LICENSE-XYZ'], ), # empty ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-XYZ """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, ['LICENSE-XYZ'], ['LICENSE-ABC'], ), # on same line ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC INVALID_LICENSE """ ), 'LICENSE-ABC': "Test license", }, ['LICENSE-ABC'], ['INVALID_LICENSE'], ), # with an invalid license ( { 'setup.cfg': DALS( """ """ ), 'LICENSE': "Test license", }, ['LICENSE'], [], ), # no license_files attribute, LICENSE auto-included ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE """ ), 'MANIFEST.in': "exclude LICENSE", 'LICENSE': "Test license", }, ['LICENSE'], [], ), # manifest is overwritten by license_files ( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC LICENSE-XYZ """ ), 'MANIFEST.in': "exclude LICENSE-XYZ", 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", # manifest is overwritten by license_files }, ['LICENSE-ABC', 'LICENSE-XYZ'], [], ), pytest.param( { 'setup.cfg': "", 'LICENSE-ABC': "ABC license", 'COPYING-ABC': "ABC copying", 'NOTICE-ABC': "ABC notice", 'AUTHORS-ABC': "ABC authors", 'LICENCE-XYZ': "XYZ license", 'LICENSE': "License", 'INVALID-LICENSE': "Invalid license", }, [ 'LICENSE-ABC', 'COPYING-ABC', 'NOTICE-ABC', 'AUTHORS-ABC', 'LICENCE-XYZ', 'LICENSE', ], ['INVALID-LICENSE'], # ('LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*') id="default_glob_patterns", ), pytest.param( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE* """ ), 'LICENSE-ABC': "ABC license", 'NOTICE-XYZ': "XYZ notice", }, ['LICENSE-ABC'], ['NOTICE-XYZ'], id="no_default_glob_patterns", ), pytest.param( { 'setup.cfg': DALS( """ [metadata] license_files = LICENSE-ABC LICENSE* """ ), 'LICENSE-ABC': "ABC license", }, ['LICENSE-ABC'], [], id="files_only_added_once", ), pytest.param( { 'setup.cfg': DALS( """ [metadata] license_files = **/LICENSE """ ), 'LICENSE': "ABC license", 'LICENSE-OTHER': "Don't include", 'vendor': {'LICENSE': "Vendor license"}, }, ['LICENSE', 'vendor/LICENSE'], ['LICENSE-OTHER'], id="recursive_glob", ), ], ) def test_setup_cfg_license_files( self, tmpdir_cwd, env, files, incl_licenses, excl_licenses ): self._create_project() path.build(files) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), ) egg_info_dir = os.path.join('.', 'foo.egg-info') sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") sources_lines = [line.strip() for line in sources_text.splitlines()] for lf in incl_licenses: assert sources_lines.count(lf) == 1 for lf in excl_licenses: assert sources_lines.count(lf) == 0 @pytest.mark.parametrize( ('files', 'incl_licenses', 'excl_licenses'), [ ( { 'setup.cfg': DALS( """ [metadata] license_file = license_files = """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", }, [], ['LICENSE-ABC', 'LICENSE-XYZ'], ), # both empty ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC LICENSE-XYZ """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-XYZ': "XYZ license", # license_file is still singular }, [], ['LICENSE-ABC', 'LICENSE-XYZ'], ), ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC license_files = LICENSE-XYZ LICENSE-PQR """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-PQR': "PQR license", 'LICENSE-XYZ': "XYZ license", }, ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], [], ), # combined ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC license_files = LICENSE-ABC LICENSE-XYZ LICENSE-PQR """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-PQR': "PQR license", 'LICENSE-XYZ': "XYZ license", # duplicate license }, ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], [], ), ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC license_files = LICENSE-XYZ """ ), 'LICENSE-ABC': "ABC license", 'LICENSE-PQR': "PQR license", 'LICENSE-XYZ': "XYZ license", # combined subset }, ['LICENSE-ABC', 'LICENSE-XYZ'], ['LICENSE-PQR'], ), ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC license_files = LICENSE-XYZ LICENSE-PQR """ ), 'LICENSE-PQR': "Test license", # with invalid licenses }, ['LICENSE-PQR'], ['LICENSE-ABC', 'LICENSE-XYZ'], ), ( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE-ABC license_files = LICENSE-PQR LICENSE-XYZ """ ), 'MANIFEST.in': "exclude LICENSE-ABC\nexclude LICENSE-PQR", 'LICENSE-ABC': "ABC license", 'LICENSE-PQR': "PQR license", 'LICENSE-XYZ': "XYZ license", # manifest is overwritten }, ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], [], ), pytest.param( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE* """ ), 'LICENSE-ABC': "ABC license", 'NOTICE-XYZ': "XYZ notice", }, ['LICENSE-ABC'], ['NOTICE-XYZ'], id="no_default_glob_patterns", ), pytest.param( { 'setup.cfg': DALS( """ [metadata] license_file = LICENSE* license_files = NOTICE* """ ), 'LICENSE-ABC': "ABC license", 'NOTICE-ABC': "ABC notice", 'AUTHORS-ABC': "ABC authors", }, ['LICENSE-ABC', 'NOTICE-ABC'], ['AUTHORS-ABC'], id="combined_glob_patterrns", ), ], ) def test_setup_cfg_license_file_license_files( self, tmpdir_cwd, env, files, incl_licenses, excl_licenses ): self._create_project() path.build(files) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), ) egg_info_dir = os.path.join('.', 'foo.egg-info') sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") sources_lines = [line.strip() for line in sources_text.splitlines()] for lf in incl_licenses: assert sources_lines.count(lf) == 1 for lf in excl_licenses: assert sources_lines.count(lf) == 0 def test_license_file_attr_pkg_info(self, tmpdir_cwd, env): """All matched license files should have a corresponding License-File.""" self._create_project() path.build({ "setup.cfg": DALS( """ [metadata] license_files = NOTICE* LICENSE* **/LICENSE """ ), "LICENSE-ABC": "ABC license", "LICENSE-XYZ": "XYZ license", "NOTICE": "included", "IGNORE": "not include", "vendor": {'LICENSE': "Vendor license"}, }) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') license_file_lines = [ line for line in pkg_info_lines if line.startswith('License-File:') ] # Only 'NOTICE', LICENSE-ABC', and 'LICENSE-XYZ' should have been matched # Also assert that order from license_files is keeped assert len(license_file_lines) == 4 assert "License-File: NOTICE" == license_file_lines[0] assert "License-File: LICENSE-ABC" in license_file_lines[1:] assert "License-File: LICENSE-XYZ" in license_file_lines[1:] assert "License-File: vendor/LICENSE" in license_file_lines[3] def test_metadata_version(self, tmpdir_cwd, env): """Make sure latest metadata version is used by default.""" self._setup_script_with_requires("") environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') # Update metadata version if changed assert self._extract_mv_version(pkg_info_lines) == (2, 4) def test_long_description_content_type(self, tmpdir_cwd, env): # Test that specifying a `long_description_content_type` keyword arg to # the `setup` function results in writing a `Description-Content-Type` # line to the `PKG-INFO` file in the `<distribution>.egg-info` # directory. # `Description-Content-Type` is described at # https://github.com/pypa/python-packaging-user-guide/pull/258 self._setup_script_with_requires( """long_description_content_type='text/markdown',""" ) environ = os.environ.copy().update( HOME=env.paths['home'], ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') expected_line = 'Description-Content-Type: text/markdown' assert expected_line in pkg_info_lines assert 'Metadata-Version: 2.4' in pkg_info_lines def test_long_description(self, tmpdir_cwd, env): # Test that specifying `long_description` and `long_description_content_type` # keyword args to the `setup` function results in writing # the description in the message payload of the `PKG-INFO` file # in the `<distribution>.egg-info` directory. self._setup_script_with_requires( "long_description='This is a long description\\nover multiple lines'," "long_description_content_type='text/markdown'," ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'Metadata-Version: 2.4' in pkg_info_lines assert '' == pkg_info_lines[-1] # last line should be empty long_desc_lines = pkg_info_lines[pkg_info_lines.index('') :] assert 'This is a long description' in long_desc_lines assert 'over multiple lines' in long_desc_lines def test_project_urls(self, tmpdir_cwd, env): # Test that specifying a `project_urls` dict to the `setup` # function results in writing multiple `Project-URL` lines to # the `PKG-INFO` file in the `<distribution>.egg-info` # directory. # `Project-URL` is described at https://packaging.python.org # /specifications/core-metadata/#project-url-multiple-use self._setup_script_with_requires( """project_urls={ 'Link One': 'https://example.com/one/', 'Link Two': 'https://example.com/two/', },""" ) environ = os.environ.copy().update( HOME=env.paths['home'], ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') expected_line = 'Project-URL: Link One, https://example.com/one/' assert expected_line in pkg_info_lines expected_line = 'Project-URL: Link Two, https://example.com/two/' assert expected_line in pkg_info_lines assert self._extract_mv_version(pkg_info_lines) >= (1, 2) def test_license(self, tmpdir_cwd, env): """Test single line license.""" self._setup_script_with_requires("license='MIT',") environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'License: MIT' in pkg_info_lines def test_license_escape(self, tmpdir_cwd, env): """Test license is escaped correctly if longer than one line.""" self._setup_script_with_requires( "license='This is a long license text \\nover multiple lines'," ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'License: This is a long license text ' in pkg_info_lines assert ' over multiple lines' in pkg_info_lines assert 'text \n over multiple' in '\n'.join(pkg_info_lines) def test_python_requires_egg_info(self, tmpdir_cwd, env): self._setup_script_with_requires("""python_requires='>=2.7.12',""") environ = os.environ.copy().update( HOME=env.paths['home'], ) environment.run_setup_py( cmd=['egg_info'], pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'Requires-Python: >=2.7.12' in pkg_info_lines assert self._extract_mv_version(pkg_info_lines) >= (1, 2) def test_manifest_maker_warning_suppression(self): fixtures = [ "standard file not found: should have one of foo.py, bar.py", "standard file 'setup.py' not found", ] for msg in fixtures: assert manifest_maker._should_suppress_warning(msg) def test_egg_info_includes_setup_py(self, tmpdir_cwd): self._create_project() dist = Distribution({"name": "foo", "version": "0.0.1"}) dist.script_name = "non_setup.py" egg_info_instance = egg_info(dist) egg_info_instance.finalize_options() egg_info_instance.run() assert 'setup.py' in egg_info_instance.filelist.files with open(egg_info_instance.egg_info + "/SOURCES.txt", encoding="utf-8") as f: sources = f.read().split('\n') assert 'setup.py' in sources def _run_egg_info_command(self, tmpdir_cwd, env, cmd=None, output=None): environ = os.environ.copy().update( HOME=env.paths['home'], ) if cmd is None: cmd = [ 'egg_info', ] code, data = environment.run_setup_py( cmd=cmd, pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), data_stream=1, env=environ, ) assert not code, data if output: assert output in data def test_egg_info_tag_only_once(self, tmpdir_cwd, env): self._create_project() path.build({ 'setup.cfg': DALS( """ [egg_info] tag_build = dev tag_date = 0 tag_svn_revision = 0 """ ), }) self._run_egg_info_command(tmpdir_cwd, env) egg_info_dir = os.path.join('.', 'foo.egg-info') with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: pkg_info_lines = fp.read().split('\n') assert 'Version: 0.0.0.dev0' in pkg_info_lines class TestWriteEntries: def test_invalid_entry_point(self, tmpdir_cwd, env): dist = Distribution({"name": "foo", "version": "0.0.1"}) dist.entry_points = {"foo": "foo = invalid-identifier:foo"} cmd = dist.get_command_obj("egg_info") expected_msg = r"Problems to parse .*invalid-identifier.*" with pytest.raises(errors.OptionError, match=expected_msg) as ex: write_entries(cmd, "entry_points", "entry_points.txt") assert "ensure entry-point follows the spec" in ex.value.args[0] def test_valid_entry_point(self, tmpdir_cwd, env): dist = Distribution({"name": "foo", "version": "0.0.1"}) dist.entry_points = { "abc": "foo = bar:baz", "def": ["faa = bor:boz"], } cmd = dist.get_command_obj("egg_info") write_entries(cmd, "entry_points", "entry_points.txt") content = Path("entry_points.txt").read_text(encoding="utf-8") assert "[abc]\nfoo = bar:baz\n" in content assert "[def]\nfaa = bor:boz\n" in content tests/environment.py 0000644 00000006036 15030122015 0010616 0 ustar 00 import os import subprocess import sys import unicodedata from subprocess import PIPE as _PIPE, Popen as _Popen import jaraco.envs class VirtualEnv(jaraco.envs.VirtualEnv): name = '.env' # Some version of PyPy will import distutils on startup, implicitly # importing setuptools, and thus leading to BackendInvalid errors # when upgrading Setuptools. Bypass this behavior by avoiding the # early availability and need to upgrade. create_opts = ['--no-setuptools'] def run(self, cmd, *args, **kwargs): cmd = [self.exe(cmd[0])] + cmd[1:] kwargs = {"cwd": self.root, "encoding": "utf-8", **kwargs} # Allow overriding # In some environments (eg. downstream distro packaging), where: # - tox isn't used to run tests and # - PYTHONPATH is set to point to a specific setuptools codebase and # - no custom env is explicitly set by a test # PYTHONPATH will leak into the spawned processes. # In that case tests look for module in the wrong place (on PYTHONPATH). # Unless the test sets its own special env, pass a copy of the existing # environment with removed PYTHONPATH to the subprocesses. if "env" not in kwargs: env = dict(os.environ) if "PYTHONPATH" in env: del env["PYTHONPATH"] kwargs["env"] = env return subprocess.check_output(cmd, *args, **kwargs) def _which_dirs(cmd): result = set() for path in os.environ.get('PATH', '').split(os.pathsep): filename = os.path.join(path, cmd) if os.access(filename, os.X_OK): result.add(path) return result def run_setup_py(cmd, pypath=None, path=None, data_stream=0, env=None): """ Execution command for tests, separate from those used by the code directly to prevent accidental behavior issues """ if env is None: env = dict() for envname in os.environ: env[envname] = os.environ[envname] # override the python path if needed if pypath is not None: env["PYTHONPATH"] = pypath # override the execution path if needed if path is not None: env["PATH"] = path if not env.get("PATH", ""): env["PATH"] = _which_dirs("tar").union(_which_dirs("gzip")) env["PATH"] = os.pathsep.join(env["PATH"]) cmd = [sys.executable, "setup.py"] + list(cmd) # https://bugs.python.org/issue8557 shell = sys.platform == 'win32' try: proc = _Popen( cmd, stdout=_PIPE, stderr=_PIPE, shell=shell, env=env, encoding="utf-8", ) if isinstance(data_stream, tuple): data_stream = slice(*data_stream) data = proc.communicate()[data_stream] except OSError: return 1, '' # decode the console string if needed if hasattr(data, "decode"): # use the default encoding data = data.decode() data = unicodedata.normalize('NFC', data) # communicate calls wait() return proc.returncode, data tests/test_shutil_wrapper.py 0000644 00000001201 15030122015 0012346 0 ustar 00 import stat import sys from unittest.mock import Mock from setuptools import _shutil def test_rmtree_readonly(monkeypatch, tmp_path): """Verify onerr works as expected""" tmp_dir = tmp_path / "with_readonly" tmp_dir.mkdir() some_file = tmp_dir.joinpath("file.txt") some_file.touch() some_file.chmod(stat.S_IREAD) expected_count = 1 if sys.platform.startswith("win") else 0 chmod_fn = Mock(wraps=_shutil.attempt_chmod_verbose) monkeypatch.setattr(_shutil, "attempt_chmod_verbose", chmod_fn) _shutil.rmtree(tmp_dir) assert chmod_fn.call_count == expected_count assert not tmp_dir.is_dir() tests/test_editable_install.py 0000644 00000124567 15030122015 0012622 0 ustar 00 from __future__ import annotations import os import platform import stat import subprocess import sys from copy import deepcopy from importlib import import_module from importlib.machinery import EXTENSION_SUFFIXES from pathlib import Path from textwrap import dedent from typing import Any from unittest.mock import Mock from uuid import uuid4 import jaraco.envs import jaraco.path import pytest from path import Path as _Path from setuptools._importlib import resources as importlib_resources from setuptools.command.editable_wheel import ( _DebuggingTips, _encode_pth, _find_namespaces, _find_package_roots, _find_virtual_namespaces, _finder_template, _LinkTree, _TopLevelFinder, editable_wheel, ) from setuptools.dist import Distribution from setuptools.extension import Extension from setuptools.warnings import SetuptoolsDeprecationWarning from . import contexts, namespaces from distutils.core import run_setup @pytest.fixture(params=["strict", "lenient"]) def editable_opts(request): if request.param == "strict": return ["--config-settings", "editable-mode=strict"] return [] EXAMPLE = { 'pyproject.toml': dedent( """\ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" license = {text = "MIT"} description = "This is a Python package" dynamic = ["readme"] classifiers = [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers" ] urls = {Homepage = "https://github.com"} [tool.setuptools] package-dir = {"" = "src"} packages = {find = {where = ["src"]}} license-files = ["LICENSE*"] [tool.setuptools.dynamic] readme = {file = "README.rst"} [tool.distutils.egg_info] tag-build = ".post0" """ ), "MANIFEST.in": dedent( """\ global-include *.py *.txt global-exclude *.py[cod] prune dist prune build """ ).strip(), "README.rst": "This is a ``README``", "LICENSE.txt": "---- placeholder MIT license ----", "src": { "mypkg": { "__init__.py": dedent( """\ import sys from importlib.metadata import PackageNotFoundError, version try: __version__ = version(__name__) except PackageNotFoundError: __version__ = "unknown" """ ), "__main__.py": dedent( """\ from importlib.resources import read_text from . import __version__, __name__ as parent from .mod import x data = read_text(parent, "data.txt") print(__version__, data, x) """ ), "mod.py": "x = ''", "data.txt": "Hello World", } }, } SETUP_SCRIPT_STUB = "__import__('setuptools').setup()" @pytest.mark.xfail(sys.platform == "darwin", reason="pypa/setuptools#4328") @pytest.mark.parametrize( "files", [ {**EXAMPLE, "setup.py": SETUP_SCRIPT_STUB}, EXAMPLE, # No setup.py script ], ) def test_editable_with_pyproject(tmp_path, venv, files, editable_opts): project = tmp_path / "mypkg" project.mkdir() jaraco.path.build(files, prefix=project) cmd = [ "python", "-m", "pip", "install", "--no-build-isolation", # required to force current version of setuptools "-e", str(project), *editable_opts, ] print(venv.run(cmd)) cmd = ["python", "-m", "mypkg"] assert venv.run(cmd).strip() == "3.14159.post0 Hello World" (project / "src/mypkg/data.txt").write_text("foobar", encoding="utf-8") (project / "src/mypkg/mod.py").write_text("x = 42", encoding="utf-8") assert venv.run(cmd).strip() == "3.14159.post0 foobar 42" def test_editable_with_flat_layout(tmp_path, venv, editable_opts): files = { "mypkg": { "pyproject.toml": dedent( """\ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" [tool.setuptools] packages = ["pkg"] py-modules = ["mod"] """ ), "pkg": {"__init__.py": "a = 4"}, "mod.py": "b = 2", }, } jaraco.path.build(files, prefix=tmp_path) project = tmp_path / "mypkg" cmd = [ "python", "-m", "pip", "install", "--no-build-isolation", # required to force current version of setuptools "-e", str(project), *editable_opts, ] print(venv.run(cmd)) cmd = ["python", "-c", "import pkg, mod; print(pkg.a, mod.b)"] assert venv.run(cmd).strip() == "4 2" def test_editable_with_single_module(tmp_path, venv, editable_opts): files = { "mypkg": { "pyproject.toml": dedent( """\ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "mod" version = "3.14159" [tool.setuptools] py-modules = ["mod"] """ ), "mod.py": "b = 2", }, } jaraco.path.build(files, prefix=tmp_path) project = tmp_path / "mypkg" cmd = [ "python", "-m", "pip", "install", "--no-build-isolation", # required to force current version of setuptools "-e", str(project), *editable_opts, ] print(venv.run(cmd)) cmd = ["python", "-c", "import mod; print(mod.b)"] assert venv.run(cmd).strip() == "2" class TestLegacyNamespaces: # legacy => pkg_resources.declare_namespace(...) + setup(namespace_packages=...) def test_nspkg_file_is_unique(self, tmp_path, monkeypatch): deprecation = pytest.warns( SetuptoolsDeprecationWarning, match=".*namespace_packages parameter.*" ) installation_dir = tmp_path / ".installation_dir" installation_dir.mkdir() examples = ( "myns.pkgA", "myns.pkgB", "myns.n.pkgA", "myns.n.pkgB", ) for name in examples: pkg = namespaces.build_namespace_package(tmp_path, name, version="42") with deprecation, monkeypatch.context() as ctx: ctx.chdir(pkg) dist = run_setup("setup.py", stop_after="config") cmd = editable_wheel(dist) cmd.finalize_options() editable_name = cmd.get_finalized_command("dist_info").name cmd._install_namespaces(installation_dir, editable_name) files = list(installation_dir.glob("*-nspkg.pth")) assert len(files) == len(examples) @pytest.mark.parametrize( "impl", ( "pkg_resources", # "pkgutil", => does not work ), ) @pytest.mark.parametrize("ns", ("myns.n",)) def test_namespace_package_importable( self, venv, tmp_path, ns, impl, editable_opts ): """ Installing two packages sharing the same namespace, one installed naturally using pip or `--single-version-externally-managed` and the other installed in editable mode should leave the namespace intact and both packages reachable by import. (Ported from test_develop). """ build_system = """\ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" """ pkg_A = namespaces.build_namespace_package(tmp_path, f"{ns}.pkgA", impl=impl) pkg_B = namespaces.build_namespace_package(tmp_path, f"{ns}.pkgB", impl=impl) (pkg_A / "pyproject.toml").write_text(build_system, encoding="utf-8") (pkg_B / "pyproject.toml").write_text(build_system, encoding="utf-8") # use pip to install to the target directory opts = editable_opts[:] opts.append("--no-build-isolation") # force current version of setuptools venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) venv.run(["python", "-c", f"import {ns}.pkgA; import {ns}.pkgB"]) # additionally ensure that pkg_resources import works venv.run(["python", "-c", "import pkg_resources"]) class TestPep420Namespaces: def test_namespace_package_importable(self, venv, tmp_path, editable_opts): """ Installing two packages sharing the same namespace, one installed normally using pip and the other installed in editable mode should allow importing both packages. """ pkg_A = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgA') pkg_B = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgB') # use pip to install to the target directory opts = editable_opts[:] opts.append("--no-build-isolation") # force current version of setuptools venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) venv.run(["python", "-c", "import myns.n.pkgA; import myns.n.pkgB"]) def test_namespace_created_via_package_dir(self, venv, tmp_path, editable_opts): """Currently users can create a namespace by tweaking `package_dir`""" files = { "pkgA": { "pyproject.toml": dedent( """\ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "pkgA" version = "3.14159" [tool.setuptools] package-dir = {"myns.n.pkgA" = "src"} """ ), "src": {"__init__.py": "a = 1"}, }, } jaraco.path.build(files, prefix=tmp_path) pkg_A = tmp_path / "pkgA" pkg_B = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgB') pkg_C = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgC') # use pip to install to the target directory opts = editable_opts[:] opts.append("--no-build-isolation") # force current version of setuptools venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) venv.run(["python", "-m", "pip", "install", "-e", str(pkg_C), *opts]) venv.run(["python", "-c", "from myns.n import pkgA, pkgB, pkgC"]) def test_namespace_accidental_config_in_lenient_mode(self, venv, tmp_path): """Sometimes users might specify an ``include`` pattern that ignores parent packages. In a normal installation this would ignore all modules inside the parent packages, and make them namespaces (reported in issue #3504), so the editable mode should preserve this behaviour. """ files = { "pkgA": { "pyproject.toml": dedent( """\ [build-system] requires = ["setuptools", "wheel"] build-backend = "setuptools.build_meta" [project] name = "pkgA" version = "3.14159" [tool.setuptools] packages.find.include = ["mypkg.*"] """ ), "mypkg": { "__init__.py": "", "other.py": "b = 1", "n": { "__init__.py": "", "pkgA.py": "a = 1", }, }, "MANIFEST.in": EXAMPLE["MANIFEST.in"], }, } jaraco.path.build(files, prefix=tmp_path) pkg_A = tmp_path / "pkgA" # use pip to install to the target directory opts = ["--no-build-isolation"] # force current version of setuptools venv.run(["python", "-m", "pip", "-v", "install", "-e", str(pkg_A), *opts]) out = venv.run(["python", "-c", "from mypkg.n import pkgA; print(pkgA.a)"]) assert out.strip() == "1" cmd = """\ try: import mypkg.other except ImportError: print("mypkg.other not defined") """ out = venv.run(["python", "-c", dedent(cmd)]) assert "mypkg.other not defined" in out def test_editable_with_prefix(tmp_path, sample_project, editable_opts): """ Editable install to a prefix should be discoverable. """ prefix = tmp_path / 'prefix' # figure out where pip will likely install the package site_packages_all = [ prefix / Path(path).relative_to(sys.prefix) for path in sys.path if 'site-packages' in path and path.startswith(sys.prefix) ] for sp in site_packages_all: sp.mkdir(parents=True) # install workaround _addsitedirs(site_packages_all) env = dict(os.environ, PYTHONPATH=os.pathsep.join(map(str, site_packages_all))) cmd = [ sys.executable, '-m', 'pip', 'install', '--editable', str(sample_project), '--prefix', str(prefix), '--no-build-isolation', *editable_opts, ] subprocess.check_call(cmd, env=env) # now run 'sample' with the prefix on the PYTHONPATH bin = 'Scripts' if platform.system() == 'Windows' else 'bin' exe = prefix / bin / 'sample' subprocess.check_call([exe], env=env) class TestFinderTemplate: """This test focus in getting a particular implementation detail right. If at some point in time the implementation is changed for something different, this test can be modified or even excluded. """ def install_finder(self, finder): loc = {} exec(finder, loc, loc) loc["install"]() def test_packages(self, tmp_path): files = { "src1": { "pkg1": { "__init__.py": "", "subpkg": {"mod1.py": "a = 42"}, }, }, "src2": {"mod2.py": "a = 43"}, } jaraco.path.build(files, prefix=tmp_path) mapping = { "pkg1": str(tmp_path / "src1/pkg1"), "mod2": str(tmp_path / "src2/mod2"), } template = _finder_template(str(uuid4()), mapping, {}) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ("pkg1", "pkg1.subpkg", "pkg1.subpkg.mod1", "mod2"): sys.modules.pop(mod, None) self.install_finder(template) mod1 = import_module("pkg1.subpkg.mod1") mod2 = import_module("mod2") subpkg = import_module("pkg1.subpkg") assert mod1.a == 42 assert mod2.a == 43 expected = str((tmp_path / "src1/pkg1/subpkg").resolve()) assert_path(subpkg, expected) def test_namespace(self, tmp_path): files = {"pkg": {"__init__.py": "a = 13", "text.txt": "abc"}} jaraco.path.build(files, prefix=tmp_path) mapping = {"ns.othername": str(tmp_path / "pkg")} namespaces = {"ns": []} template = _finder_template(str(uuid4()), mapping, namespaces) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ("ns", "ns.othername"): sys.modules.pop(mod, None) self.install_finder(template) pkg = import_module("ns.othername") text = importlib_resources.files(pkg) / "text.txt" expected = str((tmp_path / "pkg").resolve()) assert_path(pkg, expected) assert pkg.a == 13 # Make sure resources can also be found assert text.read_text(encoding="utf-8") == "abc" def test_combine_namespaces(self, tmp_path): files = { "src1": {"ns": {"pkg1": {"__init__.py": "a = 13"}}}, "src2": {"ns": {"mod2.py": "b = 37"}}, } jaraco.path.build(files, prefix=tmp_path) mapping = { "ns.pkgA": str(tmp_path / "src1/ns/pkg1"), "ns": str(tmp_path / "src2/ns"), } namespaces_ = {"ns": [str(tmp_path / "src1"), str(tmp_path / "src2")]} template = _finder_template(str(uuid4()), mapping, namespaces_) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ("ns", "ns.pkgA", "ns.mod2"): sys.modules.pop(mod, None) self.install_finder(template) pkgA = import_module("ns.pkgA") mod2 = import_module("ns.mod2") expected = str((tmp_path / "src1/ns/pkg1").resolve()) assert_path(pkgA, expected) assert pkgA.a == 13 assert mod2.b == 37 def test_combine_namespaces_nested(self, tmp_path): """ Users may attempt to combine namespace packages in a nested way via ``package_dir`` as shown in pypa/setuptools#4248. """ files = { "src": {"my_package": {"my_module.py": "a = 13"}}, "src2": {"my_package2": {"my_module2.py": "b = 37"}}, } stack = jaraco.path.DirectoryStack() with stack.context(tmp_path): jaraco.path.build(files) attrs = { "script_name": "%PEP 517%", "package_dir": { "different_name": "src/my_package", "different_name.subpkg": "src2/my_package2", }, "packages": ["different_name", "different_name.subpkg"], } dist = Distribution(attrs) finder = _TopLevelFinder(dist, str(uuid4())) code = next(v for k, v in finder.get_implementation() if k.endswith(".py")) with contexts.save_paths(), contexts.save_sys_modules(): for mod in attrs["packages"]: sys.modules.pop(mod, None) self.install_finder(code) mod1 = import_module("different_name.my_module") mod2 = import_module("different_name.subpkg.my_module2") expected = str((tmp_path / "src/my_package/my_module.py").resolve()) assert str(Path(mod1.__file__).resolve()) == expected expected = str((tmp_path / "src2/my_package2/my_module2.py").resolve()) assert str(Path(mod2.__file__).resolve()) == expected assert mod1.a == 13 assert mod2.b == 37 def test_dynamic_path_computation(self, tmp_path): # Follows the example in PEP 420 files = { "project1": {"parent": {"child": {"one.py": "x = 1"}}}, "project2": {"parent": {"child": {"two.py": "x = 2"}}}, "project3": {"parent": {"child": {"three.py": "x = 3"}}}, } jaraco.path.build(files, prefix=tmp_path) mapping = {} namespaces_ = {"parent": [str(tmp_path / "project1/parent")]} template = _finder_template(str(uuid4()), mapping, namespaces_) mods = (f"parent.child.{name}" for name in ("one", "two", "three")) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ("parent", "parent.child", "parent.child", *mods): sys.modules.pop(mod, None) self.install_finder(template) one = import_module("parent.child.one") assert one.x == 1 with pytest.raises(ImportError): import_module("parent.child.two") sys.path.append(str(tmp_path / "project2")) two = import_module("parent.child.two") assert two.x == 2 with pytest.raises(ImportError): import_module("parent.child.three") sys.path.append(str(tmp_path / "project3")) three = import_module("parent.child.three") assert three.x == 3 def test_no_recursion(self, tmp_path): # See issue #3550 files = { "pkg": { "__init__.py": "from . import pkg", }, } jaraco.path.build(files, prefix=tmp_path) mapping = { "pkg": str(tmp_path / "pkg"), } template = _finder_template(str(uuid4()), mapping, {}) with contexts.save_paths(), contexts.save_sys_modules(): sys.modules.pop("pkg", None) self.install_finder(template) with pytest.raises(ImportError, match="pkg"): import_module("pkg") def test_similar_name(self, tmp_path): files = { "foo": { "__init__.py": "", "bar": { "__init__.py": "", }, }, } jaraco.path.build(files, prefix=tmp_path) mapping = { "foo": str(tmp_path / "foo"), } template = _finder_template(str(uuid4()), mapping, {}) with contexts.save_paths(), contexts.save_sys_modules(): sys.modules.pop("foo", None) sys.modules.pop("foo.bar", None) self.install_finder(template) with pytest.raises(ImportError, match="foobar"): import_module("foobar") def test_case_sensitivity(self, tmp_path): files = { "foo": { "__init__.py": "", "lowercase.py": "x = 1", "bar": { "__init__.py": "", "lowercase.py": "x = 2", }, }, } jaraco.path.build(files, prefix=tmp_path) mapping = { "foo": str(tmp_path / "foo"), } template = _finder_template(str(uuid4()), mapping, {}) with contexts.save_paths(), contexts.save_sys_modules(): sys.modules.pop("foo", None) self.install_finder(template) with pytest.raises(ImportError, match="'FOO'"): import_module("FOO") with pytest.raises(ImportError, match="'foo\\.LOWERCASE'"): import_module("foo.LOWERCASE") with pytest.raises(ImportError, match="'foo\\.bar\\.Lowercase'"): import_module("foo.bar.Lowercase") with pytest.raises(ImportError, match="'foo\\.BAR'"): import_module("foo.BAR.lowercase") with pytest.raises(ImportError, match="'FOO'"): import_module("FOO.bar.lowercase") mod = import_module("foo.lowercase") assert mod.x == 1 mod = import_module("foo.bar.lowercase") assert mod.x == 2 def test_namespace_case_sensitivity(self, tmp_path): files = { "pkg": { "__init__.py": "a = 13", "foo": { "__init__.py": "b = 37", "bar.py": "c = 42", }, }, } jaraco.path.build(files, prefix=tmp_path) mapping = {"ns.othername": str(tmp_path / "pkg")} namespaces = {"ns": []} template = _finder_template(str(uuid4()), mapping, namespaces) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ("ns", "ns.othername"): sys.modules.pop(mod, None) self.install_finder(template) pkg = import_module("ns.othername") expected = str((tmp_path / "pkg").resolve()) assert_path(pkg, expected) assert pkg.a == 13 foo = import_module("ns.othername.foo") assert foo.b == 37 bar = import_module("ns.othername.foo.bar") assert bar.c == 42 with pytest.raises(ImportError, match="'NS'"): import_module("NS.othername.foo") with pytest.raises(ImportError, match="'ns\\.othername\\.FOO\\'"): import_module("ns.othername.FOO") with pytest.raises(ImportError, match="'ns\\.othername\\.foo\\.BAR\\'"): import_module("ns.othername.foo.BAR") def test_intermediate_packages(self, tmp_path): """ The finder should not import ``fullname`` if the intermediate segments don't exist (see pypa/setuptools#4019). """ files = { "src": { "mypkg": { "__init__.py": "", "config.py": "a = 13", "helloworld.py": "b = 13", "components": { "config.py": "a = 37", }, }, } } jaraco.path.build(files, prefix=tmp_path) mapping = {"mypkg": str(tmp_path / "src/mypkg")} template = _finder_template(str(uuid4()), mapping, {}) with contexts.save_paths(), contexts.save_sys_modules(): for mod in ( "mypkg", "mypkg.config", "mypkg.helloworld", "mypkg.components", "mypkg.components.config", "mypkg.components.helloworld", ): sys.modules.pop(mod, None) self.install_finder(template) config = import_module("mypkg.components.config") assert config.a == 37 helloworld = import_module("mypkg.helloworld") assert helloworld.b == 13 with pytest.raises(ImportError): import_module("mypkg.components.helloworld") def test_pkg_roots(tmp_path): """This test focus in getting a particular implementation detail right. If at some point in time the implementation is changed for something different, this test can be modified or even excluded. """ files = { "a": {"b": {"__init__.py": "ab = 1"}, "__init__.py": "a = 1"}, "d": {"__init__.py": "d = 1", "e": {"__init__.py": "de = 1"}}, "f": {"g": {"h": {"__init__.py": "fgh = 1"}}}, "other": {"__init__.py": "abc = 1"}, "another": {"__init__.py": "abcxyz = 1"}, "yet_another": {"__init__.py": "mnopq = 1"}, } jaraco.path.build(files, prefix=tmp_path) package_dir = { "a.b.c": "other", "a.b.c.x.y.z": "another", "m.n.o.p.q": "yet_another", } packages = [ "a", "a.b", "a.b.c", "a.b.c.x.y", "a.b.c.x.y.z", "d", "d.e", "f", "f.g", "f.g.h", "m.n.o.p.q", ] roots = _find_package_roots(packages, package_dir, tmp_path) assert roots == { "a": str(tmp_path / "a"), "a.b.c": str(tmp_path / "other"), "a.b.c.x.y.z": str(tmp_path / "another"), "d": str(tmp_path / "d"), "f": str(tmp_path / "f"), "m.n.o.p.q": str(tmp_path / "yet_another"), } ns = set(dict(_find_namespaces(packages, roots))) assert ns == {"f", "f.g"} ns = set(_find_virtual_namespaces(roots)) assert ns == {"a.b", "a.b.c.x", "a.b.c.x.y", "m", "m.n", "m.n.o", "m.n.o.p"} class TestOverallBehaviour: PYPROJECT = """\ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "mypkg" version = "3.14159" """ # Any: Would need a TypedDict. Keep it simple for tests FLAT_LAYOUT: dict[str, Any] = { "pyproject.toml": dedent(PYPROJECT), "MANIFEST.in": EXAMPLE["MANIFEST.in"], "otherfile.py": "", "mypkg": { "__init__.py": "", "mod1.py": "var = 42", "subpackage": { "__init__.py": "", "mod2.py": "var = 13", "resource_file.txt": "resource 39", }, }, } EXAMPLES = { "flat-layout": FLAT_LAYOUT, "src-layout": { "pyproject.toml": dedent(PYPROJECT), "MANIFEST.in": EXAMPLE["MANIFEST.in"], "otherfile.py": "", "src": {"mypkg": FLAT_LAYOUT["mypkg"]}, }, "custom-layout": { "pyproject.toml": dedent(PYPROJECT) + dedent( """\ [tool.setuptools] packages = ["mypkg", "mypkg.subpackage"] [tool.setuptools.package-dir] "mypkg.subpackage" = "other" """ ), "MANIFEST.in": EXAMPLE["MANIFEST.in"], "otherfile.py": "", "mypkg": { "__init__.py": "", "mod1.py": FLAT_LAYOUT["mypkg"]["mod1.py"], }, "other": FLAT_LAYOUT["mypkg"]["subpackage"], }, "namespace": { "pyproject.toml": dedent(PYPROJECT), "MANIFEST.in": EXAMPLE["MANIFEST.in"], "otherfile.py": "", "src": { "mypkg": { "mod1.py": FLAT_LAYOUT["mypkg"]["mod1.py"], "subpackage": FLAT_LAYOUT["mypkg"]["subpackage"], }, }, }, } @pytest.mark.xfail(sys.platform == "darwin", reason="pypa/setuptools#4328") @pytest.mark.parametrize("layout", EXAMPLES.keys()) def test_editable_install(self, tmp_path, venv, layout, editable_opts): project, _ = install_project( "mypkg", venv, tmp_path, self.EXAMPLES[layout], *editable_opts ) # Ensure stray files are not importable cmd_import_error = """\ try: import otherfile except ImportError as ex: print(ex) """ out = venv.run(["python", "-c", dedent(cmd_import_error)]) assert "No module named 'otherfile'" in out # Ensure the modules are importable cmd_get_vars = """\ import mypkg, mypkg.mod1, mypkg.subpackage.mod2 print(mypkg.mod1.var, mypkg.subpackage.mod2.var) """ out = venv.run(["python", "-c", dedent(cmd_get_vars)]) assert "42 13" in out # Ensure resources are reachable cmd_get_resource = """\ import mypkg.subpackage from setuptools._importlib import resources as importlib_resources text = importlib_resources.files(mypkg.subpackage) / "resource_file.txt" print(text.read_text(encoding="utf-8")) """ out = venv.run(["python", "-c", dedent(cmd_get_resource)]) assert "resource 39" in out # Ensure files are editable mod1 = next(project.glob("**/mod1.py")) mod2 = next(project.glob("**/mod2.py")) resource_file = next(project.glob("**/resource_file.txt")) mod1.write_text("var = 17", encoding="utf-8") mod2.write_text("var = 781", encoding="utf-8") resource_file.write_text("resource 374", encoding="utf-8") out = venv.run(["python", "-c", dedent(cmd_get_vars)]) assert "42 13" not in out assert "17 781" in out out = venv.run(["python", "-c", dedent(cmd_get_resource)]) assert "resource 39" not in out assert "resource 374" in out class TestLinkTree: FILES = deepcopy(TestOverallBehaviour.EXAMPLES["src-layout"]) FILES["pyproject.toml"] += dedent( """\ [tool.setuptools] # Temporary workaround: both `include-package-data` and `package-data` configs # can be removed after #3260 is fixed. include-package-data = false package-data = {"*" = ["*.txt"]} [tool.setuptools.packages.find] where = ["src"] exclude = ["*.subpackage*"] """ ) FILES["src"]["mypkg"]["resource.not_in_manifest"] = "abc" def test_generated_tree(self, tmp_path): jaraco.path.build(self.FILES, prefix=tmp_path) with _Path(tmp_path): name = "mypkg-3.14159" dist = Distribution({"script_name": "%PEP 517%"}) dist.parse_config_files() wheel = Mock() aux = tmp_path / ".aux" build = tmp_path / ".build" aux.mkdir() build.mkdir() build_py = dist.get_command_obj("build_py") build_py.editable_mode = True build_py.build_lib = str(build) build_py.ensure_finalized() outputs = build_py.get_outputs() output_mapping = build_py.get_output_mapping() make_tree = _LinkTree(dist, name, aux, build) make_tree(wheel, outputs, output_mapping) mod1 = next(aux.glob("**/mod1.py")) expected = tmp_path / "src/mypkg/mod1.py" assert_link_to(mod1, expected) assert next(aux.glob("**/subpackage"), None) is None assert next(aux.glob("**/mod2.py"), None) is None assert next(aux.glob("**/resource_file.txt"), None) is None assert next(aux.glob("**/resource.not_in_manifest"), None) is None def test_strict_install(self, tmp_path, venv): opts = ["--config-settings", "editable-mode=strict"] install_project("mypkg", venv, tmp_path, self.FILES, *opts) out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) assert "42" in out # Ensure packages excluded from distribution are not importable cmd_import_error = """\ try: from mypkg import subpackage except ImportError as ex: print(ex) """ out = venv.run(["python", "-c", dedent(cmd_import_error)]) assert "cannot import name 'subpackage'" in out # Ensure resource files excluded from distribution are not reachable cmd_get_resource = """\ import mypkg from setuptools._importlib import resources as importlib_resources try: text = importlib_resources.files(mypkg) / "resource.not_in_manifest" print(text.read_text(encoding="utf-8")) except FileNotFoundError as ex: print(ex) """ out = venv.run(["python", "-c", dedent(cmd_get_resource)]) assert "No such file or directory" in out assert "resource.not_in_manifest" in out @pytest.mark.filterwarnings("ignore:.*compat.*:setuptools.SetuptoolsDeprecationWarning") def test_compat_install(tmp_path, venv): # TODO: Remove `compat` after Dec/2022. opts = ["--config-settings", "editable-mode=compat"] files = TestOverallBehaviour.EXAMPLES["custom-layout"] install_project("mypkg", venv, tmp_path, files, *opts) out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) assert "42" in out expected_path = comparable_path(str(tmp_path)) # Compatible behaviour will make spurious modules and excluded # files importable directly from the original path for cmd in ( "import otherfile; print(otherfile)", "import other; print(other)", "import mypkg; print(mypkg)", ): out = comparable_path(venv.run(["python", "-c", cmd])) assert expected_path in out # Compatible behaviour will not consider custom mappings cmd = """\ try: from mypkg import subpackage; except ImportError as ex: print(ex) """ out = venv.run(["python", "-c", dedent(cmd)]) assert "cannot import name 'subpackage'" in out def test_pbr_integration(tmp_path, venv, editable_opts): """Ensure editable installs work with pbr, issue #3500""" files = { "pyproject.toml": dedent( """\ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" """ ), "setup.py": dedent( """\ __import__('setuptools').setup( pbr=True, setup_requires=["pbr"], ) """ ), "setup.cfg": dedent( """\ [metadata] name = mypkg [files] packages = mypkg """ ), "mypkg": { "__init__.py": "", "hello.py": "print('Hello world!')", }, "other": {"test.txt": "Another file in here."}, } venv.run(["python", "-m", "pip", "install", "pbr"]) with contexts.environment(PBR_VERSION="0.42"): install_project("mypkg", venv, tmp_path, files, *editable_opts) out = venv.run(["python", "-c", "import mypkg.hello"]) assert "Hello world!" in out class TestCustomBuildPy: """ Issue #3501 indicates that some plugins/customizations might rely on: 1. ``build_py`` not running 2. ``build_py`` always copying files to ``build_lib`` During the transition period setuptools should prevent potential errors from happening due to those assumptions. """ # TODO: Remove tests after _run_build_steps is removed. FILES = { **TestOverallBehaviour.EXAMPLES["flat-layout"], "setup.py": dedent( """\ import pathlib from setuptools import setup from setuptools.command.build_py import build_py as orig class my_build_py(orig): def run(self): super().run() raise ValueError("TEST_RAISE") setup(cmdclass={"build_py": my_build_py}) """ ), } def test_safeguarded_from_errors(self, tmp_path, venv): """Ensure that errors in custom build_py are reported as warnings""" # Warnings should show up _, out = install_project("mypkg", venv, tmp_path, self.FILES) assert "SetuptoolsDeprecationWarning" in out assert "ValueError: TEST_RAISE" in out # but installation should be successful out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) assert "42" in out class TestCustomBuildWheel: def install_custom_build_wheel(self, dist): bdist_wheel_cls = dist.get_command_class("bdist_wheel") class MyBdistWheel(bdist_wheel_cls): def get_tag(self): # In issue #3513, we can see that some extensions may try to access # the `plat_name` property in bdist_wheel if self.plat_name.startswith("macosx-"): _ = "macOS platform" return super().get_tag() dist.cmdclass["bdist_wheel"] = MyBdistWheel def test_access_plat_name(self, tmpdir_cwd): # Even when a custom bdist_wheel tries to access plat_name the build should # be successful jaraco.path.build({"module.py": "x = 42"}) dist = Distribution() dist.script_name = "setup.py" dist.set_defaults() self.install_custom_build_wheel(dist) cmd = editable_wheel(dist) cmd.ensure_finalized() cmd.run() wheel_file = str(next(Path().glob('dist/*.whl'))) assert "editable" in wheel_file class TestCustomBuildExt: def install_custom_build_ext_distutils(self, dist): from distutils.command.build_ext import build_ext as build_ext_cls class MyBuildExt(build_ext_cls): pass dist.cmdclass["build_ext"] = MyBuildExt @pytest.mark.skipif( sys.platform != "linux", reason="compilers may fail without correct setup" ) def test_distutils_leave_inplace_files(self, tmpdir_cwd): jaraco.path.build({"module.c": ""}) attrs = { "ext_modules": [Extension("module", ["module.c"])], } dist = Distribution(attrs) dist.script_name = "setup.py" dist.set_defaults() self.install_custom_build_ext_distutils(dist) cmd = editable_wheel(dist) cmd.ensure_finalized() cmd.run() wheel_file = str(next(Path().glob('dist/*.whl'))) assert "editable" in wheel_file files = [p for p in Path().glob("module.*") if p.suffix != ".c"] assert len(files) == 1 name = files[0].name assert any(name.endswith(ext) for ext in EXTENSION_SUFFIXES) def test_debugging_tips(tmpdir_cwd, monkeypatch): """Make sure to display useful debugging tips to the user.""" jaraco.path.build({"module.py": "x = 42"}) dist = Distribution() dist.script_name = "setup.py" dist.set_defaults() cmd = editable_wheel(dist) cmd.ensure_finalized() SimulatedErr = type("SimulatedErr", (Exception,), {}) simulated_failure = Mock(side_effect=SimulatedErr()) monkeypatch.setattr(cmd, "get_finalized_command", simulated_failure) expected_msg = "following steps are recommended to help debug" with pytest.raises(SimulatedErr), pytest.warns(_DebuggingTips, match=expected_msg): cmd.run() @pytest.mark.filterwarnings("error") def test_encode_pth(): """Ensure _encode_pth function does not produce encoding warnings""" content = _encode_pth("tkmilan_ç_utf8") # no warnings (would be turned into errors) assert isinstance(content, bytes) def install_project(name, venv, tmp_path, files, *opts): project = tmp_path / name project.mkdir() jaraco.path.build(files, prefix=project) opts = [*opts, "--no-build-isolation"] # force current version of setuptools out = venv.run( ["python", "-m", "pip", "-v", "install", "-e", str(project), *opts], stderr=subprocess.STDOUT, ) return project, out def _addsitedirs(new_dirs): """To use this function, it is necessary to insert new_dir in front of sys.path. The Python process will try to import a ``sitecustomize`` module on startup. If we manipulate sys.path/PYTHONPATH, we can force it to run our code, which invokes ``addsitedir`` and ensure ``.pth`` files are loaded. """ content = '\n'.join( ("import site",) + tuple(f"site.addsitedir({os.fspath(new_dir)!r})" for new_dir in new_dirs) ) (new_dirs[0] / "sitecustomize.py").write_text(content, encoding="utf-8") # ---- Assertion Helpers ---- def assert_path(pkg, expected): # __path__ is not guaranteed to exist, so we have to account for that if pkg.__path__: path = next(iter(pkg.__path__), None) if path: assert str(Path(path).resolve()) == expected def assert_link_to(file: Path, other: Path) -> None: if file.is_symlink(): assert str(file.resolve()) == str(other.resolve()) else: file_stat = file.stat() other_stat = other.stat() assert file_stat[stat.ST_INO] == other_stat[stat.ST_INO] assert file_stat[stat.ST_DEV] == other_stat[stat.ST_DEV] def comparable_path(str_with_path: str) -> str: return str_with_path.lower().replace(os.sep, "/").replace("//", "/") tests/test_build_clib.py 0000644 00000006063 15030122015 0011401 0 ustar 00 import random from unittest import mock import pytest from setuptools.command.build_clib import build_clib from setuptools.dist import Distribution from distutils.errors import DistutilsSetupError class TestBuildCLib: @mock.patch('setuptools.command.build_clib.newer_pairwise_group') def test_build_libraries(self, mock_newer): dist = Distribution() cmd = build_clib(dist) # this will be a long section, just making sure all # exceptions are properly raised libs = [('example', {'sources': 'broken.c'})] with pytest.raises(DistutilsSetupError): cmd.build_libraries(libs) obj_deps = 'some_string' libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] with pytest.raises(DistutilsSetupError): cmd.build_libraries(libs) obj_deps = {'': ''} libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] with pytest.raises(DistutilsSetupError): cmd.build_libraries(libs) obj_deps = {'source.c': ''} libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] with pytest.raises(DistutilsSetupError): cmd.build_libraries(libs) # with that out of the way, let's see if the crude dependency # system works cmd.compiler = mock.MagicMock(spec=cmd.compiler) mock_newer.return_value = ([], []) obj_deps = {'': ('global.h',), 'example.c': ('example.h',)} libs = [('example', {'sources': ['example.c'], 'obj_deps': obj_deps})] cmd.build_libraries(libs) assert [['example.c', 'global.h', 'example.h']] in mock_newer.call_args[0] assert not cmd.compiler.compile.called assert cmd.compiler.create_static_lib.call_count == 1 # reset the call numbers so we can test again cmd.compiler.reset_mock() mock_newer.return_value = '' # anything as long as it's not ([],[]) cmd.build_libraries(libs) assert cmd.compiler.compile.call_count == 1 assert cmd.compiler.create_static_lib.call_count == 1 @mock.patch('setuptools.command.build_clib.newer_pairwise_group') def test_build_libraries_reproducible(self, mock_newer): dist = Distribution() cmd = build_clib(dist) # with that out of the way, let's see if the crude dependency # system works cmd.compiler = mock.MagicMock(spec=cmd.compiler) mock_newer.return_value = ([], []) original_sources = ['a-example.c', 'example.c'] sources = original_sources obj_deps = {'': ('global.h',), 'example.c': ('example.h',)} libs = [('example', {'sources': sources, 'obj_deps': obj_deps})] cmd.build_libraries(libs) computed_call_args = mock_newer.call_args[0] while sources == original_sources: sources = random.sample(original_sources, len(original_sources)) libs = [('example', {'sources': sources, 'obj_deps': obj_deps})] cmd.build_libraries(libs) assert computed_call_args == mock_newer.call_args[0] tests/test_core_metadata.py 0000644 00000050621 15030122015 0012100 0 ustar 00 from __future__ import annotations import functools import importlib import io from email import message_from_string from email.generator import Generator from email.message import EmailMessage, Message from email.parser import Parser from email.policy import EmailPolicy from inspect import cleandoc from pathlib import Path from unittest.mock import Mock import jaraco.path import pytest from packaging.metadata import Metadata from packaging.requirements import Requirement from setuptools import _reqs, sic from setuptools._core_metadata import rfc822_escape, rfc822_unescape from setuptools.command.egg_info import egg_info, write_requirements from setuptools.config import expand, setupcfg from setuptools.dist import Distribution from .config.downloads import retrieve_file, urls_from_file EXAMPLE_BASE_INFO = dict( name="package", version="0.0.1", author="Foo Bar", author_email="foo@bar.net", long_description="Long\ndescription", description="Short description", keywords=["one", "two"], ) @pytest.mark.parametrize( ("content", "result"), ( pytest.param( "Just a single line", None, id="single_line", ), pytest.param( "Multiline\nText\nwithout\nextra indents\n", None, id="multiline", ), pytest.param( "Multiline\n With\n\nadditional\n indentation", None, id="multiline_with_indentation", ), pytest.param( " Leading whitespace", "Leading whitespace", id="remove_leading_whitespace", ), pytest.param( " Leading whitespace\nIn\n Multiline comment", "Leading whitespace\nIn\n Multiline comment", id="remove_leading_whitespace_multiline", ), ), ) def test_rfc822_unescape(content, result): assert (result or content) == rfc822_unescape(rfc822_escape(content)) def __read_test_cases(): base = EXAMPLE_BASE_INFO params = functools.partial(dict, base) return [ ('Metadata version 1.0', params()), ( 'Metadata Version 1.0: Short long description', params( long_description='Short long description', ), ), ( 'Metadata version 1.1: Classifiers', params( classifiers=[ 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3.7', 'License :: OSI Approved :: MIT License', ], ), ), ( 'Metadata version 1.1: Download URL', params( download_url='https://example.com', ), ), ( 'Metadata Version 1.2: Requires-Python', params( python_requires='>=3.7', ), ), pytest.param( 'Metadata Version 1.2: Project-Url', params(project_urls=dict(Foo='https://example.bar')), marks=pytest.mark.xfail( reason="Issue #1578: project_urls not read", ), ), ( 'Metadata Version 2.1: Long Description Content Type', params( long_description_content_type='text/x-rst; charset=UTF-8', ), ), ( 'License', params( license='MIT', ), ), ( 'License multiline', params( license='This is a long license \nover multiple lines', ), ), pytest.param( 'Metadata Version 2.1: Provides Extra', params(provides_extras=['foo', 'bar']), marks=pytest.mark.xfail(reason="provides_extras not read"), ), ( 'Missing author', dict( name='foo', version='1.0.0', author_email='snorri@sturluson.name', ), ), ( 'Missing author e-mail', dict( name='foo', version='1.0.0', author='Snorri Sturluson', ), ), ( 'Missing author and e-mail', dict( name='foo', version='1.0.0', ), ), ( 'Bypass normalized version', dict( name='foo', version=sic('1.0.0a'), ), ), ] @pytest.mark.parametrize(("name", "attrs"), __read_test_cases()) def test_read_metadata(name, attrs): dist = Distribution(attrs) metadata_out = dist.metadata dist_class = metadata_out.__class__ # Write to PKG_INFO and then load into a new metadata object PKG_INFO = io.StringIO() metadata_out.write_pkg_file(PKG_INFO) PKG_INFO.seek(0) pkg_info = PKG_INFO.read() assert _valid_metadata(pkg_info) PKG_INFO.seek(0) metadata_in = dist_class() metadata_in.read_pkg_file(PKG_INFO) tested_attrs = [ ('name', dist_class.get_name), ('version', dist_class.get_version), ('author', dist_class.get_contact), ('author_email', dist_class.get_contact_email), ('metadata_version', dist_class.get_metadata_version), ('provides', dist_class.get_provides), ('description', dist_class.get_description), ('long_description', dist_class.get_long_description), ('download_url', dist_class.get_download_url), ('keywords', dist_class.get_keywords), ('platforms', dist_class.get_platforms), ('obsoletes', dist_class.get_obsoletes), ('requires', dist_class.get_requires), ('classifiers', dist_class.get_classifiers), ('project_urls', lambda s: getattr(s, 'project_urls', {})), ('provides_extras', lambda s: getattr(s, 'provides_extras', {})), ] for attr, getter in tested_attrs: assert getter(metadata_in) == getter(metadata_out) def __maintainer_test_cases(): attrs = {"name": "package", "version": "1.0", "description": "xxx"} def merge_dicts(d1, d2): d1 = d1.copy() d1.update(d2) return d1 return [ ('No author, no maintainer', attrs.copy()), ( 'Author (no e-mail), no maintainer', merge_dicts(attrs, {'author': 'Author Name'}), ), ( 'Author (e-mail), no maintainer', merge_dicts( attrs, {'author': 'Author Name', 'author_email': 'author@name.com'} ), ), ( 'No author, maintainer (no e-mail)', merge_dicts(attrs, {'maintainer': 'Maintainer Name'}), ), ( 'No author, maintainer (e-mail)', merge_dicts( attrs, { 'maintainer': 'Maintainer Name', 'maintainer_email': 'maintainer@name.com', }, ), ), ( 'Author (no e-mail), Maintainer (no-email)', merge_dicts( attrs, {'author': 'Author Name', 'maintainer': 'Maintainer Name'} ), ), ( 'Author (e-mail), Maintainer (e-mail)', merge_dicts( attrs, { 'author': 'Author Name', 'author_email': 'author@name.com', 'maintainer': 'Maintainer Name', 'maintainer_email': 'maintainer@name.com', }, ), ), ( 'No author (e-mail), no maintainer (e-mail)', merge_dicts( attrs, { 'author_email': 'author@name.com', 'maintainer_email': 'maintainer@name.com', }, ), ), ('Author unicode', merge_dicts(attrs, {'author': '鉄沢寛'})), ('Maintainer unicode', merge_dicts(attrs, {'maintainer': 'Jan Łukasiewicz'})), ] @pytest.mark.parametrize(("name", "attrs"), __maintainer_test_cases()) def test_maintainer_author(name, attrs, tmpdir): tested_keys = { 'author': 'Author', 'author_email': 'Author-email', 'maintainer': 'Maintainer', 'maintainer_email': 'Maintainer-email', } # Generate a PKG-INFO file dist = Distribution(attrs) fn = tmpdir.mkdir('pkg_info') fn_s = str(fn) dist.metadata.write_pkg_info(fn_s) with open(str(fn.join('PKG-INFO')), 'r', encoding='utf-8') as f: pkg_info = f.read() assert _valid_metadata(pkg_info) # Drop blank lines and strip lines from default description raw_pkg_lines = pkg_info.splitlines() pkg_lines = list(filter(None, raw_pkg_lines[:-2])) pkg_lines_set = set(pkg_lines) # Duplicate lines should not be generated assert len(pkg_lines) == len(pkg_lines_set) for fkey, dkey in tested_keys.items(): val = attrs.get(dkey, None) if val is None: for line in pkg_lines: assert not line.startswith(fkey + ':') else: line = f'{fkey}: {val}' assert line in pkg_lines_set class TestParityWithMetadataFromPyPaWheel: def base_example(self): attrs = dict( **EXAMPLE_BASE_INFO, # Example with complex requirement definition python_requires=">=3.8", install_requires=""" packaging==23.2 more-itertools==8.8.0; extra == "other" jaraco.text==3.7.0 importlib-resources==5.10.2; python_version<"3.8" importlib-metadata==6.0.0 ; python_version<"3.8" colorama>=0.4.4; sys_platform == "win32" """, extras_require={ "testing": """ pytest >= 6 pytest-checkdocs >= 2.4 tomli ; \\ # Using stdlib when possible python_version < "3.11" ini2toml[lite]>=0.9 """, "other": [], }, ) # Generate a PKG-INFO file using setuptools return Distribution(attrs) def test_requires_dist(self, tmp_path): dist = self.base_example() pkg_info = _get_pkginfo(dist) assert _valid_metadata(pkg_info) # Ensure Requires-Dist is present expected = [ 'Metadata-Version:', 'Requires-Python: >=3.8', 'Provides-Extra: other', 'Provides-Extra: testing', 'Requires-Dist: tomli; python_version < "3.11" and extra == "testing"', 'Requires-Dist: more-itertools==8.8.0; extra == "other"', 'Requires-Dist: ini2toml[lite]>=0.9; extra == "testing"', ] for line in expected: assert line in pkg_info HERE = Path(__file__).parent EXAMPLES_FILE = HERE / "config/setupcfg_examples.txt" @pytest.fixture(params=[None, *urls_from_file(EXAMPLES_FILE)]) def dist(self, request, monkeypatch, tmp_path): """Example of distribution with arbitrary configuration""" monkeypatch.chdir(tmp_path) monkeypatch.setattr(expand, "read_attr", Mock(return_value="0.42")) monkeypatch.setattr(expand, "read_files", Mock(return_value="hello world")) monkeypatch.setattr( Distribution, "_finalize_license_files", Mock(return_value=None) ) if request.param is None: yield self.base_example() else: # Real-world usage config = retrieve_file(request.param) yield setupcfg.apply_configuration(Distribution({}), config) @pytest.mark.uses_network def test_equivalent_output(self, tmp_path, dist): """Ensure output from setuptools is equivalent to the one from `pypa/wheel`""" # Generate a METADATA file using pypa/wheel for comparison wheel_metadata = importlib.import_module("wheel.metadata") pkginfo_to_metadata = getattr(wheel_metadata, "pkginfo_to_metadata", None) if pkginfo_to_metadata is None: # pragma: nocover pytest.xfail( "wheel.metadata.pkginfo_to_metadata is undefined, " "(this is likely to be caused by API changes in pypa/wheel" ) # Generate an simplified "egg-info" dir for pypa/wheel to convert pkg_info = _get_pkginfo(dist) egg_info_dir = tmp_path / "pkg.egg-info" egg_info_dir.mkdir(parents=True) (egg_info_dir / "PKG-INFO").write_text(pkg_info, encoding="utf-8") write_requirements(egg_info(dist), egg_info_dir, egg_info_dir / "requires.txt") # Get pypa/wheel generated METADATA but normalize requirements formatting metadata_msg = pkginfo_to_metadata(egg_info_dir, egg_info_dir / "PKG-INFO") metadata_str = _normalize_metadata(metadata_msg) pkg_info_msg = message_from_string(pkg_info) pkg_info_str = _normalize_metadata(pkg_info_msg) # Compare setuptools PKG-INFO x pypa/wheel METADATA assert metadata_str == pkg_info_str # Make sure it parses/serializes well in pypa/wheel _assert_roundtrip_message(pkg_info) class TestPEP643: STATIC_CONFIG = { "setup.cfg": cleandoc( """ [metadata] name = package version = 0.0.1 author = Foo Bar author_email = foo@bar.net long_description = Long description description = Short description keywords = one, two platforms = abcd [options] install_requires = requests """ ), "pyproject.toml": cleandoc( """ [project] name = "package" version = "0.0.1" authors = [ {name = "Foo Bar", email = "foo@bar.net"} ] description = "Short description" readme = {text = "Long\\ndescription", content-type = "text/plain"} keywords = ["one", "two"] dependencies = ["requests"] license = "AGPL-3.0-or-later" [tool.setuptools] provides = ["abcd"] obsoletes = ["abcd"] """ ), } @pytest.mark.parametrize("file", STATIC_CONFIG.keys()) def test_static_config_has_no_dynamic(self, file, tmpdir_cwd): Path(file).write_text(self.STATIC_CONFIG[file], encoding="utf-8") metadata = _get_metadata() assert metadata.get_all("Dynamic") is None assert metadata.get_all("dynamic") is None @pytest.mark.parametrize("file", STATIC_CONFIG.keys()) @pytest.mark.parametrize( "fields", [ # Single dynamic field {"requires-python": ("python_requires", ">=3.12")}, {"author-email": ("author_email", "snoopy@peanuts.com")}, {"keywords": ("keywords", ["hello", "world"])}, {"platform": ("platforms", ["abcd"])}, # Multiple dynamic fields { "summary": ("description", "hello world"), "description": ("long_description", "bla bla bla bla"), "requires-dist": ("install_requires", ["hello-world"]), }, ], ) def test_modified_fields_marked_as_dynamic(self, file, fields, tmpdir_cwd): # We start with a static config Path(file).write_text(self.STATIC_CONFIG[file], encoding="utf-8") dist = _makedist() # ... but then we simulate the effects of a plugin modifying the distribution for attr, value in fields.values(): # `dist` and `dist.metadata` are complicated... # Some attributes work when set on `dist`, others on `dist.metadata`... # Here we set in both just in case (this also avoids calling `_finalize_*`) setattr(dist, attr, value) setattr(dist.metadata, attr, value) # Then we should be able to list the modified fields as Dynamic metadata = _get_metadata(dist) assert set(metadata.get_all("Dynamic")) == set(fields) @pytest.mark.parametrize( "extra_toml", [ "# Let setuptools autofill license-files", "license-files = ['LICENSE*', 'AUTHORS*', 'NOTICE']", ], ) def test_license_files_dynamic(self, extra_toml, tmpdir_cwd): # For simplicity (and for the time being) setuptools is not making # any special handling to guarantee `License-File` is considered static. # Instead we rely in the fact that, although suboptimal, it is OK to have # it as dynamics, as per: # https://github.com/pypa/setuptools/issues/4629#issuecomment-2331233677 files = { "pyproject.toml": self.STATIC_CONFIG["pyproject.toml"].replace( 'license = "AGPL-3.0-or-later"', f"dynamic = ['license']\n{extra_toml}", ), "LICENSE.md": "--- mock license ---", "NOTICE": "--- mock notice ---", "AUTHORS.txt": "--- me ---", } # Sanity checks: assert extra_toml in files["pyproject.toml"] assert 'license = "AGPL-3.0-or-later"' not in extra_toml jaraco.path.build(files) dist = _makedist(license_expression="AGPL-3.0-or-later") metadata = _get_metadata(dist) assert set(metadata.get_all("Dynamic")) == { 'license-file', 'license-expression', } assert metadata.get("License-Expression") == "AGPL-3.0-or-later" assert set(metadata.get_all("License-File")) == { "NOTICE", "AUTHORS.txt", "LICENSE.md", } def _makedist(**attrs): dist = Distribution(attrs) dist.parse_config_files() return dist def _assert_roundtrip_message(metadata: str) -> None: """Emulate the way wheel.bdist_wheel parses and regenerates the message, then ensures the metadata generated by setuptools is compatible. """ with io.StringIO(metadata) as buffer: msg = Parser(EmailMessage).parse(buffer) serialization_policy = EmailPolicy( utf8=True, mangle_from_=False, max_line_length=0, ) with io.BytesIO() as buffer: out = io.TextIOWrapper(buffer, encoding="utf-8") Generator(out, policy=serialization_policy).flatten(msg) out.flush() regenerated = buffer.getvalue() raw_metadata = bytes(metadata, "utf-8") # Normalise newlines to avoid test errors on Windows: raw_metadata = b"\n".join(raw_metadata.splitlines()) regenerated = b"\n".join(regenerated.splitlines()) assert regenerated == raw_metadata def _normalize_metadata(msg: Message) -> str: """Allow equivalent metadata to be compared directly""" # The main challenge regards the requirements and extras. # Both setuptools and wheel already apply some level of normalization # but they differ regarding which character is chosen, according to the # following spec it should be "-": # https://packaging.python.org/en/latest/specifications/name-normalization/ # Related issues: # https://github.com/pypa/packaging/issues/845 # https://github.com/pypa/packaging/issues/644#issuecomment-2429813968 extras = {x.replace("_", "-"): x for x in msg.get_all("Provides-Extra", [])} reqs = [ _normalize_req(req, extras) for req in _reqs.parse(msg.get_all("Requires-Dist", [])) ] del msg["Requires-Dist"] del msg["Provides-Extra"] # Ensure consistent ord for req in sorted(reqs): msg["Requires-Dist"] = req for extra in sorted(extras): msg["Provides-Extra"] = extra # TODO: Handle lack of PEP 643 implementation in pypa/wheel? del msg["Metadata-Version"] return msg.as_string() def _normalize_req(req: Requirement, extras: dict[str, str]) -> str: """Allow equivalent requirement objects to be compared directly""" as_str = str(req).replace(req.name, req.name.replace("_", "-")) for norm, orig in extras.items(): as_str = as_str.replace(orig, norm) return as_str def _get_pkginfo(dist: Distribution): with io.StringIO() as fp: dist.metadata.write_pkg_file(fp) return fp.getvalue() def _get_metadata(dist: Distribution | None = None): return message_from_string(_get_pkginfo(dist or _makedist())) def _valid_metadata(text: str) -> bool: metadata = Metadata.from_email(text, validate=True) # can raise exceptions return metadata is not None tests/namespaces.py 0000644 00000005326 15030122015 0010372 0 ustar 00 import ast import json import textwrap from pathlib import Path def iter_namespace_pkgs(namespace): parts = namespace.split(".") for i in range(len(parts)): yield ".".join(parts[: i + 1]) def build_namespace_package(tmpdir, name, version="1.0", impl="pkg_resources"): src_dir = tmpdir / name src_dir.mkdir() setup_py = src_dir / 'setup.py' namespace, _, rest = name.rpartition('.') namespaces = list(iter_namespace_pkgs(namespace)) setup_args = { "name": name, "version": version, "packages": namespaces, } if impl == "pkg_resources": tmpl = '__import__("pkg_resources").declare_namespace(__name__)' setup_args["namespace_packages"] = namespaces elif impl == "pkgutil": tmpl = '__path__ = __import__("pkgutil").extend_path(__path__, __name__)' else: raise ValueError(f"Cannot recognise {impl=} when creating namespaces") args = json.dumps(setup_args, indent=4) assert ast.literal_eval(args) # ensure it is valid Python script = textwrap.dedent( """\ import setuptools args = {args} setuptools.setup(**args) """ ).format(args=args) setup_py.write_text(script, encoding='utf-8') ns_pkg_dir = Path(src_dir, namespace.replace(".", "/")) ns_pkg_dir.mkdir(parents=True) for ns in namespaces: pkg_init = src_dir / ns.replace(".", "/") / '__init__.py' pkg_init.write_text(tmpl, encoding='utf-8') pkg_mod = ns_pkg_dir / (rest + '.py') some_functionality = 'name = {rest!r}'.format(**locals()) pkg_mod.write_text(some_functionality, encoding='utf-8') return src_dir def build_pep420_namespace_package(tmpdir, name): src_dir = tmpdir / name src_dir.mkdir() pyproject = src_dir / "pyproject.toml" namespace, _, rest = name.rpartition(".") script = f"""\ [build-system] requires = ["setuptools"] build-backend = "setuptools.build_meta" [project] name = "{name}" version = "3.14159" """ pyproject.write_text(textwrap.dedent(script), encoding='utf-8') ns_pkg_dir = Path(src_dir, namespace.replace(".", "/")) ns_pkg_dir.mkdir(parents=True) pkg_mod = ns_pkg_dir / (rest + ".py") some_functionality = f"name = {rest!r}" pkg_mod.write_text(some_functionality, encoding='utf-8') return src_dir def make_site_dir(target): """ Add a sitecustomize.py module in target to cause target to be added to site dirs such that .pth files are processed there. """ sc = target / 'sitecustomize.py' target_str = str(target) tmpl = '__import__("site").addsitedir({target_str!r})' sc.write_text(tmpl.format(**locals()), encoding='utf-8') tests/test_config_discovery.py 0000644 00000054064 15030122015 0012651 0 ustar 00 import os import sys from configparser import ConfigParser from itertools import product from typing import cast import jaraco.path import pytest from path import Path import setuptools # noqa: F401 # force distutils.core to be patched from setuptools.command.sdist import sdist from setuptools.discovery import find_package_path, find_parent_package from setuptools.dist import Distribution from setuptools.errors import PackageDiscoveryError from .contexts import quiet from .integration.helpers import get_sdist_members, get_wheel_members, run from .textwrap import DALS import distutils.core class TestFindParentPackage: def test_single_package(self, tmp_path): # find_parent_package should find a non-namespace parent package (tmp_path / "src/namespace/pkg/nested").mkdir(exist_ok=True, parents=True) (tmp_path / "src/namespace/pkg/nested/__init__.py").touch() (tmp_path / "src/namespace/pkg/__init__.py").touch() packages = ["namespace", "namespace.pkg", "namespace.pkg.nested"] assert find_parent_package(packages, {"": "src"}, tmp_path) == "namespace.pkg" def test_multiple_toplevel(self, tmp_path): # find_parent_package should return null if the given list of packages does not # have a single parent package multiple = ["pkg", "pkg1", "pkg2"] for name in multiple: (tmp_path / f"src/{name}").mkdir(exist_ok=True, parents=True) (tmp_path / f"src/{name}/__init__.py").touch() assert find_parent_package(multiple, {"": "src"}, tmp_path) is None class TestDiscoverPackagesAndPyModules: """Make sure discovered values for ``packages`` and ``py_modules`` work similarly to explicit configuration for the simple scenarios. """ OPTIONS = { # Different options according to the circumstance being tested "explicit-src": {"package_dir": {"": "src"}, "packages": ["pkg"]}, "variation-lib": { "package_dir": {"": "lib"}, # variation of the source-layout }, "explicit-flat": {"packages": ["pkg"]}, "explicit-single_module": {"py_modules": ["pkg"]}, "explicit-namespace": {"packages": ["ns", "ns.pkg"]}, "automatic-src": {}, "automatic-flat": {}, "automatic-single_module": {}, "automatic-namespace": {}, } FILES = { "src": ["src/pkg/__init__.py", "src/pkg/main.py"], "lib": ["lib/pkg/__init__.py", "lib/pkg/main.py"], "flat": ["pkg/__init__.py", "pkg/main.py"], "single_module": ["pkg.py"], "namespace": ["ns/pkg/__init__.py"], } def _get_info(self, circumstance): _, _, layout = circumstance.partition("-") files = self.FILES[layout] options = self.OPTIONS[circumstance] return files, options @pytest.mark.parametrize("circumstance", OPTIONS.keys()) def test_sdist_filelist(self, tmp_path, circumstance): files, options = self._get_info(circumstance) _populate_project_dir(tmp_path, files, options) _, cmd = _run_sdist_programatically(tmp_path, options) manifest = [f.replace(os.sep, "/") for f in cmd.filelist.files] for file in files: assert any(f.endswith(file) for f in manifest) @pytest.mark.parametrize("circumstance", OPTIONS.keys()) def test_project(self, tmp_path, circumstance): files, options = self._get_info(circumstance) _populate_project_dir(tmp_path, files, options) # Simulate a pre-existing `build` directory (tmp_path / "build").mkdir() (tmp_path / "build/lib").mkdir() (tmp_path / "build/bdist.linux-x86_64").mkdir() (tmp_path / "build/bdist.linux-x86_64/file.py").touch() (tmp_path / "build/lib/__init__.py").touch() (tmp_path / "build/lib/file.py").touch() (tmp_path / "dist").mkdir() (tmp_path / "dist/file.py").touch() _run_build(tmp_path) sdist_files = get_sdist_members(next(tmp_path.glob("dist/*.tar.gz"))) print("~~~~~ sdist_members ~~~~~") print('\n'.join(sdist_files)) assert sdist_files >= set(files) wheel_files = get_wheel_members(next(tmp_path.glob("dist/*.whl"))) print("~~~~~ wheel_members ~~~~~") print('\n'.join(wheel_files)) orig_files = {f.replace("src/", "").replace("lib/", "") for f in files} assert wheel_files >= orig_files # Make sure build files are not included by mistake for file in wheel_files: assert "build" not in files assert "dist" not in files PURPOSEFULLY_EMPY = { "setup.cfg": DALS( """ [metadata] name = myproj version = 0.0.0 [options] {param} = """ ), "setup.py": DALS( """ __import__('setuptools').setup( name="myproj", version="0.0.0", {param}=[] ) """ ), "pyproject.toml": DALS( """ [build-system] requires = [] build-backend = 'setuptools.build_meta' [project] name = "myproj" version = "0.0.0" [tool.setuptools] {param} = [] """ ), "template-pyproject.toml": DALS( """ [build-system] requires = [] build-backend = 'setuptools.build_meta' """ ), } @pytest.mark.parametrize( ("config_file", "param", "circumstance"), product( ["setup.cfg", "setup.py", "pyproject.toml"], ["packages", "py_modules"], FILES.keys(), ), ) def test_purposefully_empty(self, tmp_path, config_file, param, circumstance): files = self.FILES[circumstance] + ["mod.py", "other.py", "src/pkg/__init__.py"] _populate_project_dir(tmp_path, files, {}) if config_file == "pyproject.toml": template_param = param.replace("_", "-") else: # Make sure build works with or without setup.cfg pyproject = self.PURPOSEFULLY_EMPY["template-pyproject.toml"] (tmp_path / "pyproject.toml").write_text(pyproject, encoding="utf-8") template_param = param config = self.PURPOSEFULLY_EMPY[config_file].format(param=template_param) (tmp_path / config_file).write_text(config, encoding="utf-8") dist = _get_dist(tmp_path, {}) # When either parameter package or py_modules is an empty list, # then there should be no discovery assert getattr(dist, param) == [] other = {"py_modules": "packages", "packages": "py_modules"}[param] assert getattr(dist, other) is None @pytest.mark.parametrize( ("extra_files", "pkgs"), [ (["venv/bin/simulate_venv"], {"pkg"}), (["pkg-stubs/__init__.pyi"], {"pkg", "pkg-stubs"}), (["other-stubs/__init__.pyi"], {"pkg", "other-stubs"}), ( # Type stubs can also be namespaced ["namespace-stubs/pkg/__init__.pyi"], {"pkg", "namespace-stubs", "namespace-stubs.pkg"}, ), ( # Just the top-level package can have `-stubs`, ignore nested ones ["namespace-stubs/pkg-stubs/__init__.pyi"], {"pkg", "namespace-stubs"}, ), (["_hidden/file.py"], {"pkg"}), (["news/finalize.py"], {"pkg"}), ], ) def test_flat_layout_with_extra_files(self, tmp_path, extra_files, pkgs): files = self.FILES["flat"] + extra_files _populate_project_dir(tmp_path, files, {}) dist = _get_dist(tmp_path, {}) assert set(dist.packages) == pkgs @pytest.mark.parametrize( "extra_files", [ ["other/__init__.py"], ["other/finalize.py"], ], ) def test_flat_layout_with_dangerous_extra_files(self, tmp_path, extra_files): files = self.FILES["flat"] + extra_files _populate_project_dir(tmp_path, files, {}) with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): _get_dist(tmp_path, {}) def test_flat_layout_with_single_module(self, tmp_path): files = self.FILES["single_module"] + ["invalid-module-name.py"] _populate_project_dir(tmp_path, files, {}) dist = _get_dist(tmp_path, {}) assert set(dist.py_modules) == {"pkg"} def test_flat_layout_with_multiple_modules(self, tmp_path): files = self.FILES["single_module"] + ["valid_module_name.py"] _populate_project_dir(tmp_path, files, {}) with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): _get_dist(tmp_path, {}) def test_py_modules_when_wheel_dir_is_cwd(self, tmp_path): """Regression for issue 3692""" from setuptools import build_meta pyproject = '[project]\nname = "test"\nversion = "1"' (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") (tmp_path / "foo.py").touch() with jaraco.path.DirectoryStack().context(tmp_path): build_meta.build_wheel(".") # Ensure py_modules are found wheel_files = get_wheel_members(next(tmp_path.glob("*.whl"))) assert "foo.py" in wheel_files class TestNoConfig: DEFAULT_VERSION = "0.0.0" # Default version given by setuptools EXAMPLES = { "pkg1": ["src/pkg1.py"], "pkg2": ["src/pkg2/__init__.py"], "pkg3": ["src/pkg3/__init__.py", "src/pkg3-stubs/__init__.py"], "pkg4": ["pkg4/__init__.py", "pkg4-stubs/__init__.py"], "ns.nested.pkg1": ["src/ns/nested/pkg1/__init__.py"], "ns.nested.pkg2": ["ns/nested/pkg2/__init__.py"], } @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_discover_name(self, tmp_path, example): _populate_project_dir(tmp_path, self.EXAMPLES[example], {}) dist = _get_dist(tmp_path, {}) assert dist.get_name() == example def test_build_with_discovered_name(self, tmp_path): files = ["src/ns/nested/pkg/__init__.py"] _populate_project_dir(tmp_path, files, {}) _run_build(tmp_path, "--sdist") # Expected distribution file dist_file = tmp_path / f"dist/ns_nested_pkg-{self.DEFAULT_VERSION}.tar.gz" assert dist_file.is_file() class TestWithAttrDirective: @pytest.mark.parametrize( ("folder", "opts"), [ ("src", {}), ("lib", {"packages": "find:", "packages.find": {"where": "lib"}}), ], ) def test_setupcfg_metadata(self, tmp_path, folder, opts): files = [f"{folder}/pkg/__init__.py", "setup.cfg"] _populate_project_dir(tmp_path, files, opts) config = (tmp_path / "setup.cfg").read_text(encoding="utf-8") overwrite = { folder: {"pkg": {"__init__.py": "version = 42"}}, "setup.cfg": "[metadata]\nversion = attr: pkg.version\n" + config, } jaraco.path.build(overwrite, prefix=tmp_path) dist = _get_dist(tmp_path, {}) assert dist.get_name() == "pkg" assert dist.get_version() == "42" assert dist.package_dir package_path = find_package_path("pkg", dist.package_dir, tmp_path) assert os.path.exists(package_path) assert folder in Path(package_path).parts() _run_build(tmp_path, "--sdist") dist_file = tmp_path / "dist/pkg-42.tar.gz" assert dist_file.is_file() def test_pyproject_metadata(self, tmp_path): _populate_project_dir(tmp_path, ["src/pkg/__init__.py"], {}) overwrite = { "src": {"pkg": {"__init__.py": "version = 42"}}, "pyproject.toml": ( "[project]\nname = 'pkg'\ndynamic = ['version']\n" "[tool.setuptools.dynamic]\nversion = {attr = 'pkg.version'}\n" ), } jaraco.path.build(overwrite, prefix=tmp_path) dist = _get_dist(tmp_path, {}) assert dist.get_version() == "42" assert dist.package_dir == {"": "src"} class TestWithCExtension: def _simulate_package_with_extension(self, tmp_path): # This example is based on: https://github.com/nucleic/kiwi/tree/1.4.0 files = [ "benchmarks/file.py", "docs/Makefile", "docs/requirements.txt", "docs/source/conf.py", "proj/header.h", "proj/file.py", "py/proj.cpp", "py/other.cpp", "py/file.py", "py/py.typed", "py/tests/test_proj.py", "README.rst", ] _populate_project_dir(tmp_path, files, {}) setup_script = """ from setuptools import Extension, setup ext_modules = [ Extension( "proj", ["py/proj.cpp", "py/other.cpp"], include_dirs=["."], language="c++", ), ] setup(ext_modules=ext_modules) """ (tmp_path / "setup.py").write_text(DALS(setup_script), encoding="utf-8") def test_skip_discovery_with_setupcfg_metadata(self, tmp_path): """Ensure that auto-discovery is not triggered when the project is based on C-extensions only, for backward compatibility. """ self._simulate_package_with_extension(tmp_path) pyproject = """ [build-system] requires = [] build-backend = 'setuptools.build_meta' """ (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") setupcfg = """ [metadata] name = proj version = 42 """ (tmp_path / "setup.cfg").write_text(DALS(setupcfg), encoding="utf-8") dist = _get_dist(tmp_path, {}) assert dist.get_name() == "proj" assert dist.get_version() == "42" assert dist.py_modules is None assert dist.packages is None assert len(dist.ext_modules) == 1 assert dist.ext_modules[0].name == "proj" def test_dont_skip_discovery_with_pyproject_metadata(self, tmp_path): """When opting-in to pyproject.toml metadata, auto-discovery will be active if the package lists C-extensions, but does not configure py-modules or packages. This way we ensure users with complex package layouts that would lead to the discovery of multiple top-level modules/packages see errors and are forced to explicitly set ``packages`` or ``py-modules``. """ self._simulate_package_with_extension(tmp_path) pyproject = """ [project] name = 'proj' version = '42' """ (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): _get_dist(tmp_path, {}) class TestWithPackageData: def _simulate_package_with_data_files(self, tmp_path, src_root): files = [ f"{src_root}/proj/__init__.py", f"{src_root}/proj/file1.txt", f"{src_root}/proj/nested/file2.txt", ] _populate_project_dir(tmp_path, files, {}) manifest = """ global-include *.py *.txt """ (tmp_path / "MANIFEST.in").write_text(DALS(manifest), encoding="utf-8") EXAMPLE_SETUPCFG = """ [metadata] name = proj version = 42 [options] include_package_data = True """ EXAMPLE_PYPROJECT = """ [project] name = "proj" version = "42" """ PYPROJECT_PACKAGE_DIR = """ [tool.setuptools] package-dir = {"" = "src"} """ @pytest.mark.parametrize( ("src_root", "files"), [ (".", {"setup.cfg": DALS(EXAMPLE_SETUPCFG)}), (".", {"pyproject.toml": DALS(EXAMPLE_PYPROJECT)}), ("src", {"setup.cfg": DALS(EXAMPLE_SETUPCFG)}), ("src", {"pyproject.toml": DALS(EXAMPLE_PYPROJECT)}), ( "src", { "setup.cfg": DALS(EXAMPLE_SETUPCFG) + DALS( """ packages = find: package_dir = =src [options.packages.find] where = src """ ) }, ), ( "src", { "pyproject.toml": DALS(EXAMPLE_PYPROJECT) + DALS( """ [tool.setuptools] package-dir = {"" = "src"} """ ) }, ), ], ) def test_include_package_data(self, tmp_path, src_root, files): """ Make sure auto-discovery does not affect package include_package_data. See issue #3196. """ jaraco.path.build(files, prefix=str(tmp_path)) self._simulate_package_with_data_files(tmp_path, src_root) expected = { os.path.normpath(f"{src_root}/proj/file1.txt").replace(os.sep, "/"), os.path.normpath(f"{src_root}/proj/nested/file2.txt").replace(os.sep, "/"), } _run_build(tmp_path) sdist_files = get_sdist_members(next(tmp_path.glob("dist/*.tar.gz"))) print("~~~~~ sdist_members ~~~~~") print('\n'.join(sdist_files)) assert sdist_files >= expected wheel_files = get_wheel_members(next(tmp_path.glob("dist/*.whl"))) print("~~~~~ wheel_members ~~~~~") print('\n'.join(wheel_files)) orig_files = {f.replace("src/", "").replace("lib/", "") for f in expected} assert wheel_files >= orig_files def test_compatible_with_numpy_configuration(tmp_path): files = [ "dir1/__init__.py", "dir2/__init__.py", "file.py", ] _populate_project_dir(tmp_path, files, {}) dist = Distribution({}) dist.configuration = object() dist.set_defaults() assert dist.py_modules is None assert dist.packages is None def test_name_discovery_doesnt_break_cli(tmpdir_cwd): jaraco.path.build({"pkg.py": ""}) dist = Distribution({}) dist.script_args = ["--name"] dist.set_defaults() dist.parse_command_line() # <-- no exception should be raised here. assert dist.get_name() == "pkg" def test_preserve_explicit_name_with_dynamic_version(tmpdir_cwd, monkeypatch): """According to #3545 it seems that ``name`` discovery is running, even when the project already explicitly sets it. This seems to be related to parsing of dynamic versions (via ``attr`` directive), which requires the auto-discovery of ``package_dir``. """ files = { "src": { "pkg": {"__init__.py": "__version__ = 42\n"}, }, "pyproject.toml": DALS( """ [project] name = "myproj" # purposefully different from package name dynamic = ["version"] [tool.setuptools.dynamic] version = {"attr" = "pkg.__version__"} """ ), } jaraco.path.build(files) dist = Distribution({}) orig_analyse_name = dist.set_defaults.analyse_name def spy_analyse_name(): # We can check if name discovery was triggered by ensuring the original # name remains instead of the package name. orig_analyse_name() assert dist.get_name() == "myproj" monkeypatch.setattr(dist.set_defaults, "analyse_name", spy_analyse_name) dist.parse_config_files() assert dist.get_version() == "42" assert set(dist.packages) == {"pkg"} def _populate_project_dir(root, files, options): # NOTE: Currently pypa/build will refuse to build the project if no # `pyproject.toml` or `setup.py` is found. So it is impossible to do # completely "config-less" projects. basic = { "setup.py": "import setuptools\nsetuptools.setup()", "README.md": "# Example Package", "LICENSE": "Copyright (c) 2018", } jaraco.path.build(basic, prefix=root) _write_setupcfg(root, options) paths = (root / f for f in files) for path in paths: path.parent.mkdir(exist_ok=True, parents=True) path.touch() def _write_setupcfg(root, options): if not options: print("~~~~~ **NO** setup.cfg ~~~~~") return setupcfg = ConfigParser() setupcfg.add_section("options") for key, value in options.items(): if key == "packages.find": setupcfg.add_section(f"options.{key}") setupcfg[f"options.{key}"].update(value) elif isinstance(value, list): setupcfg["options"][key] = ", ".join(value) elif isinstance(value, dict): str_value = "\n".join(f"\t{k} = {v}" for k, v in value.items()) setupcfg["options"][key] = "\n" + str_value else: setupcfg["options"][key] = str(value) with open(root / "setup.cfg", "w", encoding="utf-8") as f: setupcfg.write(f) print("~~~~~ setup.cfg ~~~~~") print((root / "setup.cfg").read_text(encoding="utf-8")) def _run_build(path, *flags): cmd = [sys.executable, "-m", "build", "--no-isolation", *flags, str(path)] return run(cmd, env={'DISTUTILS_DEBUG': ''}) def _get_dist(dist_path, attrs): root = "/".join(os.path.split(dist_path)) # POSIX-style script = dist_path / 'setup.py' if script.exists(): with Path(dist_path): dist = cast( Distribution, distutils.core.run_setup("setup.py", {}, stop_after="init"), ) else: dist = Distribution(attrs) dist.src_root = root dist.script_name = "setup.py" with Path(dist_path): dist.parse_config_files() dist.set_defaults() return dist def _run_sdist_programatically(dist_path, attrs): dist = _get_dist(dist_path, attrs) cmd = sdist(dist) cmd.ensure_finalized() assert cmd.distribution.packages or cmd.distribution.py_modules with quiet(), Path(dist_path): cmd.run() return dist, cmd tests/test_easy_install.py 0000644 00000150436 15030122015 0012004 0 ustar 00 """Easy install Tests""" import contextlib import io import itertools import logging import os import pathlib import re import site import subprocess import sys import tarfile import tempfile import time import warnings import zipfile from pathlib import Path from typing import NamedTuple from unittest import mock import pytest from jaraco import path import pkg_resources import setuptools.command.easy_install as ei from pkg_resources import Distribution as PRDistribution, normalize_path, working_set from setuptools import sandbox from setuptools._normalization import safer_name from setuptools.command.easy_install import PthDistributions from setuptools.dist import Distribution from setuptools.sandbox import run_setup from setuptools.tests import fail_on_ascii from setuptools.tests.server import MockServer, path_to_url from . import contexts from .textwrap import DALS import distutils.errors @pytest.fixture(autouse=True) def pip_disable_index(monkeypatch): """ Important: Disable the default index for pip to avoid querying packages in the index and potentially resolving and installing packages there. """ monkeypatch.setenv('PIP_NO_INDEX', 'true') class FakeDist: def get_entry_map(self, group): if group != 'console_scripts': return {} return {'name': 'ep'} def as_requirement(self): return 'spec' SETUP_PY = DALS( """ from setuptools import setup setup() """ ) class TestEasyInstallTest: def test_get_script_args(self): header = ei.CommandSpec.best().from_environment().as_header() dist = FakeDist() args = next(ei.ScriptWriter.get_args(dist)) _name, script = itertools.islice(args, 2) assert script.startswith(header) assert "'spec'" in script assert "'console_scripts'" in script assert "'name'" in script assert re.search('^# EASY-INSTALL-ENTRY-SCRIPT', script, flags=re.MULTILINE) def test_no_find_links(self): # new option '--no-find-links', that blocks find-links added at # the project level dist = Distribution() cmd = ei.easy_install(dist) cmd.check_pth_processing = lambda: True cmd.no_find_links = True cmd.find_links = ['link1', 'link2'] cmd.install_dir = os.path.join(tempfile.mkdtemp(), 'ok') cmd.args = ['ok'] cmd.ensure_finalized() assert cmd.package_index.scanned_urls == {} # let's try without it (default behavior) cmd = ei.easy_install(dist) cmd.check_pth_processing = lambda: True cmd.find_links = ['link1', 'link2'] cmd.install_dir = os.path.join(tempfile.mkdtemp(), 'ok') cmd.args = ['ok'] cmd.ensure_finalized() keys = sorted(cmd.package_index.scanned_urls.keys()) assert keys == ['link1', 'link2'] def test_write_exception(self): """ Test that `cant_write_to_target` is rendered as a DistutilsError. """ dist = Distribution() cmd = ei.easy_install(dist) cmd.install_dir = os.getcwd() with pytest.raises(distutils.errors.DistutilsError): cmd.cant_write_to_target() def test_all_site_dirs(self, monkeypatch): """ get_site_dirs should always return site dirs reported by site.getsitepackages. """ path = normalize_path('/setuptools/test/site-packages') def mock_gsp(): return [path] monkeypatch.setattr(site, 'getsitepackages', mock_gsp, raising=False) assert path in ei.get_site_dirs() def test_all_site_dirs_works_without_getsitepackages(self, monkeypatch): monkeypatch.delattr(site, 'getsitepackages', raising=False) assert ei.get_site_dirs() @pytest.fixture def sdist_unicode(self, tmpdir): files = [ ( 'setup.py', DALS( """ import setuptools setuptools.setup( name="setuptools-test-unicode", version="1.0", packages=["mypkg"], include_package_data=True, ) """ ), ), ( 'mypkg/__init__.py', "", ), ( 'mypkg/☃.txt', "", ), ] sdist_name = 'setuptools-test-unicode-1.0.zip' sdist = tmpdir / sdist_name # can't use make_sdist, because the issue only occurs # with zip sdists. sdist_zip = zipfile.ZipFile(str(sdist), 'w') for filename, content in files: sdist_zip.writestr(filename, content) sdist_zip.close() return str(sdist) @fail_on_ascii def test_unicode_filename_in_sdist(self, sdist_unicode, tmpdir, monkeypatch): """ The install command should execute correctly even if the package has unicode filenames. """ dist = Distribution({'script_args': ['easy_install']}) target = (tmpdir / 'target').ensure_dir() cmd = ei.easy_install( dist, install_dir=str(target), args=['x'], ) monkeypatch.setitem(os.environ, 'PYTHONPATH', str(target)) cmd.ensure_finalized() cmd.easy_install(sdist_unicode) @pytest.fixture def sdist_unicode_in_script(self, tmpdir): files = [ ( "setup.py", DALS( """ import setuptools setuptools.setup( name="setuptools-test-unicode", version="1.0", packages=["mypkg"], include_package_data=True, scripts=['mypkg/unicode_in_script'], ) """ ), ), ("mypkg/__init__.py", ""), ( "mypkg/unicode_in_script", DALS( """ #!/bin/sh # á non_python_fn() { } """ ), ), ] sdist_name = "setuptools-test-unicode-script-1.0.zip" sdist = tmpdir / sdist_name # can't use make_sdist, because the issue only occurs # with zip sdists. sdist_zip = zipfile.ZipFile(str(sdist), "w") for filename, content in files: sdist_zip.writestr(filename, content.encode('utf-8')) sdist_zip.close() return str(sdist) @fail_on_ascii def test_unicode_content_in_sdist( self, sdist_unicode_in_script, tmpdir, monkeypatch ): """ The install command should execute correctly even if the package has unicode in scripts. """ dist = Distribution({"script_args": ["easy_install"]}) target = (tmpdir / "target").ensure_dir() cmd = ei.easy_install(dist, install_dir=str(target), args=["x"]) monkeypatch.setitem(os.environ, "PYTHONPATH", str(target)) cmd.ensure_finalized() cmd.easy_install(sdist_unicode_in_script) @pytest.fixture def sdist_script(self, tmpdir): files = [ ( 'setup.py', DALS( """ import setuptools setuptools.setup( name="setuptools-test-script", version="1.0", scripts=["mypkg_script"], ) """ ), ), ( 'mypkg_script', DALS( """ #/usr/bin/python print('mypkg_script') """ ), ), ] sdist_name = 'setuptools-test-script-1.0.zip' sdist = str(tmpdir / sdist_name) make_sdist(sdist, files) return sdist @pytest.mark.skipif( not sys.platform.startswith('linux'), reason="Test can only be run on Linux" ) def test_script_install(self, sdist_script, tmpdir, monkeypatch): """ Check scripts are installed. """ dist = Distribution({'script_args': ['easy_install']}) target = (tmpdir / 'target').ensure_dir() cmd = ei.easy_install( dist, install_dir=str(target), args=['x'], ) monkeypatch.setitem(os.environ, 'PYTHONPATH', str(target)) cmd.ensure_finalized() cmd.easy_install(sdist_script) assert (target / 'mypkg_script').exists() @pytest.mark.filterwarnings('ignore:Unbuilt egg') class TestPTHFileWriter: def test_add_from_cwd_site_sets_dirty(self): """a pth file manager should set dirty if a distribution is in site but also the cwd """ pth = PthDistributions('does-not_exist', [os.getcwd()]) assert not pth.dirty pth.add(PRDistribution(os.getcwd())) assert pth.dirty def test_add_from_site_is_ignored(self): location = '/test/location/does-not-have-to-exist' # PthDistributions expects all locations to be normalized location = pkg_resources.normalize_path(location) pth = PthDistributions( 'does-not_exist', [ location, ], ) assert not pth.dirty pth.add(PRDistribution(location)) assert not pth.dirty def test_many_pth_distributions_merge_together(self, tmpdir): """ If the pth file is modified under the hood, then PthDistribution will refresh its content before saving, merging contents when necessary. """ # putting the pth file in a dedicated sub-folder, pth_subdir = tmpdir.join("pth_subdir") pth_subdir.mkdir() pth_path = str(pth_subdir.join("file1.pth")) pth1 = PthDistributions(pth_path) pth2 = PthDistributions(pth_path) assert pth1.paths == pth2.paths == [], ( "unless there would be some default added at some point" ) # and so putting the src_subdir in folder distinct than the pth one, # so to keep it absolute by PthDistributions new_src_path = tmpdir.join("src_subdir") new_src_path.mkdir() # must exist to be accounted new_src_path_str = str(new_src_path) pth1.paths.append(new_src_path_str) pth1.save() assert pth1.paths, ( "the new_src_path added must still be present/valid in pth1 after save" ) # now, assert new_src_path_str not in pth2.paths, ( "right before we save the entry should still not be present" ) pth2.save() assert new_src_path_str in pth2.paths, ( "the new_src_path entry should have been added by pth2 with its save() call" ) assert pth2.paths[-1] == new_src_path, ( "and it should match exactly on the last entry actually " "given we append to it in save()" ) # finally, assert PthDistributions(pth_path).paths == pth2.paths, ( "and we should have the exact same list at the end " "with a fresh PthDistributions instance" ) @pytest.fixture def setup_context(tmpdir): with (tmpdir / 'setup.py').open('w', encoding="utf-8") as f: f.write(SETUP_PY) with tmpdir.as_cwd(): yield tmpdir @pytest.mark.usefixtures("user_override") @pytest.mark.usefixtures("setup_context") class TestUserInstallTest: # prevent check that site-packages is writable. easy_install # shouldn't be writing to system site-packages during finalize # options, but while it does, bypass the behavior. prev_sp_write = mock.patch( 'setuptools.command.easy_install.easy_install.check_site_dir', mock.Mock(), ) # simulate setuptools installed in user site packages @mock.patch('setuptools.command.easy_install.__file__', site.USER_SITE) @mock.patch('site.ENABLE_USER_SITE', True) @prev_sp_write def test_user_install_not_implied_user_site_enabled(self): self.assert_not_user_site() @mock.patch('site.ENABLE_USER_SITE', False) @prev_sp_write def test_user_install_not_implied_user_site_disabled(self): self.assert_not_user_site() @staticmethod def assert_not_user_site(): # create a finalized easy_install command dist = Distribution() dist.script_name = 'setup.py' cmd = ei.easy_install(dist) cmd.args = ['py'] cmd.ensure_finalized() assert not cmd.user, 'user should not be implied' def test_multiproc_atexit(self): pytest.importorskip('multiprocessing') log = logging.getLogger('test_easy_install') logging.basicConfig(level=logging.INFO, stream=sys.stderr) log.info('this should not break') @pytest.fixture def foo_package(self, tmpdir): egg_file = tmpdir / 'foo-1.0.egg-info' with egg_file.open('w') as f: f.write('Name: foo\n') return str(tmpdir) @pytest.fixture def install_target(self, tmpdir): target = str(tmpdir) with mock.patch('sys.path', sys.path + [target]): python_path = os.path.pathsep.join(sys.path) with mock.patch.dict(os.environ, PYTHONPATH=python_path): yield target def test_local_index(self, foo_package, install_target): """ The local index must be used when easy_install locates installed packages. """ dist = Distribution() dist.script_name = 'setup.py' cmd = ei.easy_install(dist) cmd.install_dir = install_target cmd.args = ['foo'] cmd.ensure_finalized() cmd.local_index.scan([foo_package]) res = cmd.easy_install('foo') actual = os.path.normcase(os.path.realpath(res.location)) expected = os.path.normcase(os.path.realpath(foo_package)) assert actual == expected @contextlib.contextmanager def user_install_setup_context(self, *args, **kwargs): """ Wrap sandbox.setup_context to patch easy_install in that context to appear as user-installed. """ with self.orig_context(*args, **kwargs): import setuptools.command.easy_install as ei ei.__file__ = site.USER_SITE yield def patched_setup_context(self): self.orig_context = sandbox.setup_context return mock.patch( 'setuptools.sandbox.setup_context', self.user_install_setup_context, ) @pytest.fixture def distutils_package(): distutils_setup_py = SETUP_PY.replace( 'from setuptools import setup', 'from distutils.core import setup', ) with contexts.tempdir(cd=os.chdir): with open('setup.py', 'w', encoding="utf-8") as f: f.write(distutils_setup_py) yield @pytest.mark.usefixtures("distutils_package") class TestDistutilsPackage: def test_bdist_egg_available_on_distutils_pkg(self): run_setup('setup.py', ['bdist_egg']) @pytest.fixture def mock_index(): # set up a server which will simulate an alternate package index. p_index = MockServer() if p_index.server_port == 0: # Some platforms (Jython) don't find a port to which to bind, # so skip test for them. pytest.skip("could not find a valid port") p_index.start() return p_index class TestInstallRequires: def test_setup_install_includes_dependencies(self, tmp_path, mock_index): """ When ``python setup.py install`` is called directly, it will use easy_install to fetch dependencies. """ # TODO: Remove these tests once `setup.py install` is completely removed project_root = tmp_path / "project" project_root.mkdir(exist_ok=True) install_root = tmp_path / "install" install_root.mkdir(exist_ok=True) self.create_project(project_root) cmd = [ sys.executable, '-c', '__import__("setuptools").setup()', 'install', '--install-base', str(install_root), '--install-lib', str(install_root), '--install-headers', str(install_root), '--install-scripts', str(install_root), '--install-data', str(install_root), '--install-purelib', str(install_root), '--install-platlib', str(install_root), ] env = {**os.environ, "__EASYINSTALL_INDEX": mock_index.url} cp = subprocess.run( cmd, cwd=str(project_root), env=env, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, encoding="utf-8", ) assert cp.returncode != 0 try: assert '/does-not-exist/' in {r.path for r in mock_index.requests} assert next( line for line in cp.stdout.splitlines() if "not find suitable distribution for" in line and "does-not-exist" in line ) except Exception: if "failed to get random numbers" in cp.stdout: pytest.xfail(f"{sys.platform} failure - {cp.stdout}") raise def create_project(self, root): config = """ [metadata] name = project version = 42 [options] install_requires = does-not-exist py_modules = mod """ (root / 'setup.cfg').write_text(DALS(config), encoding="utf-8") (root / 'mod.py').touch() class TestSetupRequires: def test_setup_requires_honors_fetch_params(self, mock_index, monkeypatch): """ When easy_install installs a source distribution which specifies setup_requires, it should honor the fetch parameters (such as index-url, and find-links). """ monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') monkeypatch.setenv('PIP_NO_INDEX', 'false') with contexts.quiet(): # create an sdist that has a build-time dependency. with TestSetupRequires.create_sdist() as dist_file: with contexts.tempdir() as temp_install_dir: with contexts.environment(PYTHONPATH=temp_install_dir): cmd = [ sys.executable, '-c', '__import__("setuptools").setup()', 'easy_install', '--index-url', mock_index.url, '--exclude-scripts', '--install-dir', temp_install_dir, dist_file, ] subprocess.Popen(cmd).wait() # there should have been one requests to the server assert [r.path for r in mock_index.requests] == ['/does-not-exist/'] @staticmethod @contextlib.contextmanager def create_sdist(): """ Return an sdist with a setup_requires dependency (of something that doesn't exist) """ with contexts.tempdir() as dir: dist_path = os.path.join(dir, 'setuptools-test-fetcher-1.0.tar.gz') make_sdist( dist_path, [ ( 'setup.py', DALS( """ import setuptools setuptools.setup( name="setuptools-test-fetcher", version="1.0", setup_requires = ['does-not-exist'], ) """ ), ), ('setup.cfg', ''), ], ) yield dist_path use_setup_cfg = ( (), ('dependency_links',), ('setup_requires',), ('dependency_links', 'setup_requires'), ) @pytest.mark.parametrize('use_setup_cfg', use_setup_cfg) def test_setup_requires_overrides_version_conflict(self, use_setup_cfg): """ Regression test for distribution issue 323: https://bitbucket.org/tarek/distribute/issues/323 Ensures that a distribution's setup_requires requirements can still be installed and used locally even if a conflicting version of that requirement is already on the path. """ fake_dist = PRDistribution( 'does-not-matter', project_name='foobar', version='0.0' ) working_set.add(fake_dist) with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: test_pkg = create_setup_requires_package( temp_dir, use_setup_cfg=use_setup_cfg ) test_setup_py = os.path.join(test_pkg, 'setup.py') with contexts.quiet() as (stdout, _stderr): # Don't even need to install the package, just # running the setup.py at all is sufficient run_setup(test_setup_py, ['--name']) lines = stdout.readlines() assert len(lines) > 0 assert lines[-1].strip() == 'test_pkg' @pytest.mark.parametrize('use_setup_cfg', use_setup_cfg) def test_setup_requires_override_nspkg(self, use_setup_cfg): """ Like ``test_setup_requires_overrides_version_conflict`` but where the ``setup_requires`` package is part of a namespace package that has *already* been imported. """ with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: foobar_1_archive = os.path.join(temp_dir, 'foo_bar-0.1.tar.gz') make_nspkg_sdist(foobar_1_archive, 'foo.bar', '0.1') # Now actually go ahead an extract to the temp dir and add the # extracted path to sys.path so foo.bar v0.1 is importable foobar_1_dir = os.path.join(temp_dir, 'foo_bar-0.1') os.mkdir(foobar_1_dir) with tarfile.open(foobar_1_archive) as tf: tf.extraction_filter = lambda member, path: member tf.extractall(foobar_1_dir) sys.path.insert(1, foobar_1_dir) dist = PRDistribution( foobar_1_dir, project_name='foo.bar', version='0.1' ) working_set.add(dist) template = DALS( """\ import foo # Even with foo imported first the # setup_requires package should override import setuptools setuptools.setup(**%r) if not (hasattr(foo, '__path__') and len(foo.__path__) == 2): print('FAIL') if 'foo_bar-0.2' not in foo.__path__[0]: print('FAIL') """ ) test_pkg = create_setup_requires_package( temp_dir, 'foo.bar', '0.2', make_nspkg_sdist, template, use_setup_cfg=use_setup_cfg, ) test_setup_py = os.path.join(test_pkg, 'setup.py') with contexts.quiet() as (stdout, _stderr): try: # Don't even need to install the package, just # running the setup.py at all is sufficient run_setup(test_setup_py, ['--name']) except pkg_resources.VersionConflict: # pragma: nocover pytest.fail( 'Installing setup.py requirements caused a VersionConflict' ) assert 'FAIL' not in stdout.getvalue() lines = stdout.readlines() assert len(lines) > 0 assert lines[-1].strip() == 'test_pkg' @pytest.mark.parametrize('use_setup_cfg', use_setup_cfg) def test_setup_requires_with_attr_version(self, use_setup_cfg): def make_dependency_sdist(dist_path, distname, version): files = [ ( 'setup.py', DALS( f""" import setuptools setuptools.setup( name={distname!r}, version={version!r}, py_modules=[{distname!r}], ) """ ), ), ( distname + '.py', DALS( """ version = 42 """ ), ), ] make_sdist(dist_path, files) with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: test_pkg = create_setup_requires_package( temp_dir, setup_attrs=dict(version='attr: foobar.version'), make_package=make_dependency_sdist, use_setup_cfg=use_setup_cfg + ('version',), ) test_setup_py = os.path.join(test_pkg, 'setup.py') with contexts.quiet() as (stdout, _stderr): run_setup(test_setup_py, ['--version']) lines = stdout.readlines() assert len(lines) > 0 assert lines[-1].strip() == '42' def test_setup_requires_honors_pip_env(self, mock_index, monkeypatch): monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') monkeypatch.setenv('PIP_NO_INDEX', 'false') monkeypatch.setenv('PIP_INDEX_URL', mock_index.url) with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: test_pkg = create_setup_requires_package( temp_dir, 'python-xlib', '0.19', setup_attrs=dict(dependency_links=[]), ) test_setup_cfg = os.path.join(test_pkg, 'setup.cfg') with open(test_setup_cfg, 'w', encoding="utf-8") as fp: fp.write( DALS( """ [easy_install] index_url = https://pypi.org/legacy/ """ ) ) test_setup_py = os.path.join(test_pkg, 'setup.py') with pytest.raises(distutils.errors.DistutilsError): run_setup(test_setup_py, ['--version']) assert len(mock_index.requests) == 1 assert mock_index.requests[0].path == '/python-xlib/' def test_setup_requires_with_pep508_url(self, mock_index, monkeypatch): monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') monkeypatch.setenv('PIP_INDEX_URL', mock_index.url) with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: dep_sdist = os.path.join(temp_dir, 'dep.tar.gz') make_trivial_sdist(dep_sdist, 'dependency', '42') dep_url = path_to_url(dep_sdist, authority='localhost') test_pkg = create_setup_requires_package( temp_dir, # Ignored (overridden by setup_attrs) 'python-xlib', '0.19', setup_attrs=dict(setup_requires=f'dependency @ {dep_url}'), ) test_setup_py = os.path.join(test_pkg, 'setup.py') run_setup(test_setup_py, ['--version']) assert len(mock_index.requests) == 0 def test_setup_requires_with_allow_hosts(self, mock_index): """The `allow-hosts` option in not supported anymore.""" files = { 'test_pkg': { 'setup.py': DALS( """ from setuptools import setup setup(setup_requires='python-xlib') """ ), 'setup.cfg': DALS( """ [easy_install] allow_hosts = * """ ), } } with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: path.build(files, prefix=temp_dir) setup_py = str(pathlib.Path(temp_dir, 'test_pkg', 'setup.py')) with pytest.raises(distutils.errors.DistutilsError): run_setup(setup_py, ['--version']) assert len(mock_index.requests) == 0 def test_setup_requires_with_python_requires(self, monkeypatch, tmpdir): """Check `python_requires` is honored.""" monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') monkeypatch.setenv('PIP_NO_INDEX', '1') monkeypatch.setenv('PIP_VERBOSE', '1') dep_1_0_sdist = 'dep-1.0.tar.gz' dep_1_0_url = path_to_url(str(tmpdir / dep_1_0_sdist)) dep_1_0_python_requires = '>=2.7' make_python_requires_sdist( str(tmpdir / dep_1_0_sdist), 'dep', '1.0', dep_1_0_python_requires ) dep_2_0_sdist = 'dep-2.0.tar.gz' dep_2_0_url = path_to_url(str(tmpdir / dep_2_0_sdist)) dep_2_0_python_requires = ( f'!={sys.version_info.major}.{sys.version_info.minor}.*' ) make_python_requires_sdist( str(tmpdir / dep_2_0_sdist), 'dep', '2.0', dep_2_0_python_requires ) index = tmpdir / 'index.html' index.write_text( DALS( """ <!DOCTYPE html> <html><head><title>Links for dep</title></head> <body> <h1>Links for dep</h1> <a href="{dep_1_0_url}"\ data-requires-python="{dep_1_0_python_requires}">{dep_1_0_sdist}</a><br/> <a href="{dep_2_0_url}"\ data-requires-python="{dep_2_0_python_requires}">{dep_2_0_sdist}</a><br/> </body> </html> """ ).format( dep_1_0_url=dep_1_0_url, dep_1_0_sdist=dep_1_0_sdist, dep_1_0_python_requires=dep_1_0_python_requires, dep_2_0_url=dep_2_0_url, dep_2_0_sdist=dep_2_0_sdist, dep_2_0_python_requires=dep_2_0_python_requires, ), 'utf-8', ) index_url = path_to_url(str(index)) with contexts.save_pkg_resources_state(): test_pkg = create_setup_requires_package( str(tmpdir), 'python-xlib', '0.19', # Ignored (overridden by setup_attrs). setup_attrs=dict(setup_requires='dep', dependency_links=[index_url]), ) test_setup_py = os.path.join(test_pkg, 'setup.py') run_setup(test_setup_py, ['--version']) eggs = list( map(str, pkg_resources.find_distributions(os.path.join(test_pkg, '.eggs'))) ) assert eggs == ['dep 1.0'] @pytest.mark.parametrize('with_dependency_links_in_setup_py', (False, True)) def test_setup_requires_with_find_links_in_setup_cfg( self, monkeypatch, with_dependency_links_in_setup_py ): monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: make_trivial_sdist( os.path.join(temp_dir, 'python-xlib-42.tar.gz'), 'python-xlib', '42' ) test_pkg = os.path.join(temp_dir, 'test_pkg') test_setup_py = os.path.join(test_pkg, 'setup.py') test_setup_cfg = os.path.join(test_pkg, 'setup.cfg') os.mkdir(test_pkg) with open(test_setup_py, 'w', encoding="utf-8") as fp: if with_dependency_links_in_setup_py: dependency_links = [os.path.join(temp_dir, 'links')] else: dependency_links = [] fp.write( DALS( """ from setuptools import installer, setup setup(setup_requires='python-xlib==42', dependency_links={dependency_links!r}) """ ).format(dependency_links=dependency_links) ) with open(test_setup_cfg, 'w', encoding="utf-8") as fp: fp.write( DALS( """ [easy_install] index_url = {index_url} find_links = {find_links} """ ).format( index_url=os.path.join(temp_dir, 'index'), find_links=temp_dir, ) ) run_setup(test_setup_py, ['--version']) def test_setup_requires_with_transitive_extra_dependency(self, monkeypatch): """ Use case: installing a package with a build dependency on an already installed `dep[extra]`, which in turn depends on `extra_dep` (whose is not already installed). """ with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: # Create source distribution for `extra_dep`. make_trivial_sdist( os.path.join(temp_dir, 'extra_dep-1.0.tar.gz'), 'extra_dep', '1.0' ) # Create source tree for `dep`. dep_pkg = os.path.join(temp_dir, 'dep') os.mkdir(dep_pkg) path.build( { 'setup.py': DALS( """ import setuptools setuptools.setup( name='dep', version='2.0', extras_require={'extra': ['extra_dep']}, ) """ ), 'setup.cfg': '', }, prefix=dep_pkg, ) # "Install" dep. run_setup(os.path.join(dep_pkg, 'setup.py'), ['dist_info']) working_set.add_entry(dep_pkg) # Create source tree for test package. test_pkg = os.path.join(temp_dir, 'test_pkg') test_setup_py = os.path.join(test_pkg, 'setup.py') os.mkdir(test_pkg) with open(test_setup_py, 'w', encoding="utf-8") as fp: fp.write( DALS( """ from setuptools import installer, setup setup(setup_requires='dep[extra]') """ ) ) # Check... monkeypatch.setenv('PIP_FIND_LINKS', str(temp_dir)) monkeypatch.setenv('PIP_NO_INDEX', '1') monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') run_setup(test_setup_py, ['--version']) def test_setup_requires_with_distutils_command_dep(self, monkeypatch): """ Use case: ensure build requirements' extras are properly installed and activated. """ with contexts.save_pkg_resources_state(): with contexts.tempdir() as temp_dir: # Create source distribution for `extra_dep`. make_sdist( os.path.join(temp_dir, 'extra_dep-1.0.tar.gz'), [ ( 'setup.py', DALS( """ import setuptools setuptools.setup( name='extra_dep', version='1.0', py_modules=['extra_dep'], ) """ ), ), ('setup.cfg', ''), ('extra_dep.py', ''), ], ) # Create source tree for `epdep`. dep_pkg = os.path.join(temp_dir, 'epdep') os.mkdir(dep_pkg) path.build( { 'setup.py': DALS( """ import setuptools setuptools.setup( name='dep', version='2.0', py_modules=['epcmd'], extras_require={'extra': ['extra_dep']}, entry_points=''' [distutils.commands] epcmd = epcmd:epcmd [extra] ''', ) """ ), 'setup.cfg': '', 'epcmd.py': DALS( """ from distutils.command.build_py import build_py import extra_dep class epcmd(build_py): pass """ ), }, prefix=dep_pkg, ) # "Install" dep. run_setup(os.path.join(dep_pkg, 'setup.py'), ['dist_info']) working_set.add_entry(dep_pkg) # Create source tree for test package. test_pkg = os.path.join(temp_dir, 'test_pkg') test_setup_py = os.path.join(test_pkg, 'setup.py') os.mkdir(test_pkg) with open(test_setup_py, 'w', encoding="utf-8") as fp: fp.write( DALS( """ from setuptools import installer, setup setup(setup_requires='dep[extra]') """ ) ) # Check... monkeypatch.setenv('PIP_FIND_LINKS', str(temp_dir)) monkeypatch.setenv('PIP_NO_INDEX', '1') monkeypatch.setenv('PIP_RETRIES', '0') monkeypatch.setenv('PIP_TIMEOUT', '0') run_setup(test_setup_py, ['epcmd']) def make_trivial_sdist(dist_path, distname, version): """ Create a simple sdist tarball at dist_path, containing just a simple setup.py. """ make_sdist( dist_path, [ ( 'setup.py', DALS( f"""\ import setuptools setuptools.setup( name={distname!r}, version={version!r} ) """ ), ), ('setup.cfg', ''), ], ) def make_nspkg_sdist(dist_path, distname, version): """ Make an sdist tarball with distname and version which also contains one package with the same name as distname. The top-level package is designated a namespace package). """ # Assert that the distname contains at least one period assert '.' in distname parts = distname.split('.') nspackage = parts[0] packages = ['.'.join(parts[:idx]) for idx in range(1, len(parts) + 1)] setup_py = DALS( f"""\ import setuptools setuptools.setup( name={distname!r}, version={version!r}, packages={packages!r}, namespace_packages=[{nspackage!r}] ) """ ) init = "__import__('pkg_resources').declare_namespace(__name__)" files = [('setup.py', setup_py), (os.path.join(nspackage, '__init__.py'), init)] for package in packages[1:]: filename = os.path.join(*(package.split('.') + ['__init__.py'])) files.append((filename, '')) make_sdist(dist_path, files) def make_python_requires_sdist(dist_path, distname, version, python_requires): make_sdist( dist_path, [ ( 'setup.py', DALS( """\ import setuptools setuptools.setup( name={name!r}, version={version!r}, python_requires={python_requires!r}, ) """ ).format( name=distname, version=version, python_requires=python_requires ), ), ('setup.cfg', ''), ], ) def make_sdist(dist_path, files): """ Create a simple sdist tarball at dist_path, containing the files listed in ``files`` as ``(filename, content)`` tuples. """ # Distributions with only one file don't play well with pip. assert len(files) > 1 with tarfile.open(dist_path, 'w:gz') as dist: for filename, content in files: file_bytes = io.BytesIO(content.encode('utf-8')) file_info = tarfile.TarInfo(name=filename) file_info.size = len(file_bytes.getvalue()) file_info.mtime = int(time.time()) dist.addfile(file_info, fileobj=file_bytes) def create_setup_requires_package( path, distname='foobar', version='0.1', make_package=make_trivial_sdist, setup_py_template=None, setup_attrs=None, use_setup_cfg=(), ): """Creates a source tree under path for a trivial test package that has a single requirement in setup_requires--a tarball for that requirement is also created and added to the dependency_links argument. ``distname`` and ``version`` refer to the name/version of the package that the test package requires via ``setup_requires``. The name of the test package itself is just 'test_pkg'. """ normalized_distname = safer_name(distname) test_setup_attrs = { 'name': 'test_pkg', 'version': '0.0', 'setup_requires': [f'{normalized_distname}=={version}'], 'dependency_links': [os.path.abspath(path)], } if setup_attrs: test_setup_attrs.update(setup_attrs) test_pkg = os.path.join(path, 'test_pkg') os.mkdir(test_pkg) # setup.cfg if use_setup_cfg: options = [] metadata = [] for name in use_setup_cfg: value = test_setup_attrs.pop(name) if name in 'name version'.split(): section = metadata else: section = options if isinstance(value, (tuple, list)): value = ';'.join(value) section.append(f'{name}: {value}') test_setup_cfg_contents = DALS( """ [metadata] {metadata} [options] {options} """ ).format( options='\n'.join(options), metadata='\n'.join(metadata), ) else: test_setup_cfg_contents = '' with open(os.path.join(test_pkg, 'setup.cfg'), 'w', encoding="utf-8") as f: f.write(test_setup_cfg_contents) # setup.py if setup_py_template is None: setup_py_template = DALS( """\ import setuptools setuptools.setup(**%r) """ ) with open(os.path.join(test_pkg, 'setup.py'), 'w', encoding="utf-8") as f: f.write(setup_py_template % test_setup_attrs) foobar_path = os.path.join(path, f'{normalized_distname}-{version}.tar.gz') make_package(foobar_path, distname, version) return test_pkg @pytest.mark.skipif( sys.platform.startswith('java') and ei.is_sh(sys.executable), reason="Test cannot run under java when executable is sh", ) class TestScriptHeader: non_ascii_exe = '/Users/José/bin/python' exe_with_spaces = r'C:\Program Files\Python36\python.exe' def test_get_script_header(self): expected = f'#!{ei.nt_quote_arg(os.path.normpath(sys.executable))}\n' actual = ei.ScriptWriter.get_header('#!/usr/local/bin/python') assert actual == expected def test_get_script_header_args(self): expected = f'#!{ei.nt_quote_arg(os.path.normpath(sys.executable))} -x\n' actual = ei.ScriptWriter.get_header('#!/usr/bin/python -x') assert actual == expected def test_get_script_header_non_ascii_exe(self): actual = ei.ScriptWriter.get_header( '#!/usr/bin/python', executable=self.non_ascii_exe ) expected = f'#!{self.non_ascii_exe} -x\n' assert actual == expected def test_get_script_header_exe_with_spaces(self): actual = ei.ScriptWriter.get_header( '#!/usr/bin/python', executable='"' + self.exe_with_spaces + '"' ) expected = f'#!"{self.exe_with_spaces}"\n' assert actual == expected class TestCommandSpec: def test_custom_launch_command(self): """ Show how a custom CommandSpec could be used to specify a #! executable which takes parameters. """ cmd = ei.CommandSpec(['/usr/bin/env', 'python3']) assert cmd.as_header() == '#!/usr/bin/env python3\n' def test_from_param_for_CommandSpec_is_passthrough(self): """ from_param should return an instance of a CommandSpec """ cmd = ei.CommandSpec(['python']) cmd_new = ei.CommandSpec.from_param(cmd) assert cmd is cmd_new @mock.patch('sys.executable', TestScriptHeader.exe_with_spaces) @mock.patch.dict(os.environ) def test_from_environment_with_spaces_in_executable(self): os.environ.pop('__PYVENV_LAUNCHER__', None) cmd = ei.CommandSpec.from_environment() assert len(cmd) == 1 assert cmd.as_header().startswith('#!"') def test_from_simple_string_uses_shlex(self): """ In order to support `executable = /usr/bin/env my-python`, make sure from_param invokes shlex on that input. """ cmd = ei.CommandSpec.from_param('/usr/bin/env my-python') assert len(cmd) == 2 assert '"' not in cmd.as_header() def test_from_param_raises_expected_error(self) -> None: """ from_param should raise its own TypeError when the argument's type is unsupported """ with pytest.raises(TypeError) as exc_info: ei.CommandSpec.from_param(object()) # type: ignore[arg-type] # We want a type error here assert ( str(exc_info.value) == "Argument has an unsupported type <class 'object'>" ), exc_info.value class TestWindowsScriptWriter: def test_header(self): hdr = ei.WindowsScriptWriter.get_header('') assert hdr.startswith('#!') assert hdr.endswith('\n') hdr = hdr.lstrip('#!') hdr = hdr.rstrip('\n') # header should not start with an escaped quote assert not hdr.startswith('\\"') class VersionStub(NamedTuple): major: int minor: int micro: int releaselevel: str serial: int def test_use_correct_python_version_string(tmpdir, tmpdir_cwd, monkeypatch): # In issue #3001, easy_install wrongly uses the `python3.1` directory # when the interpreter is `python3.10` and the `--user` option is given. # See pypa/setuptools#3001. dist = Distribution() cmd = dist.get_command_obj('easy_install') cmd.args = ['ok'] cmd.optimize = 0 cmd.user = True cmd.install_userbase = str(tmpdir) cmd.install_usersite = None install_cmd = dist.get_command_obj('install') install_cmd.install_userbase = str(tmpdir) install_cmd.install_usersite = None with monkeypatch.context() as patch, warnings.catch_warnings(): warnings.simplefilter("ignore") version = '3.10.1 (main, Dec 21 2021, 09:17:12) [GCC 10.2.1 20210110]' info = VersionStub(3, 10, 1, "final", 0) patch.setattr('site.ENABLE_USER_SITE', True) patch.setattr('sys.version', version) patch.setattr('sys.version_info', info) patch.setattr(cmd, 'create_home_path', mock.Mock()) cmd.finalize_options() name = "pypy" if hasattr(sys, 'pypy_version_info') else "python" install_dir = cmd.install_dir.lower() # In some platforms (e.g. Windows), install_dir is mostly determined # via `sysconfig`, which define constants eagerly at module creation. # This means that monkeypatching `sys.version` to emulate 3.10 for testing # may have no effect. # The safest test here is to rely on the fact that 3.1 is no longer # supported/tested, and make sure that if 'python3.1' ever appears in the string # it is followed by another digit (e.g. 'python3.10'). if re.search(name + r'3\.?1', install_dir): assert re.search(name + r'3\.?1\d', install_dir) # The following "variables" are used for interpolation in distutils # installation schemes, so it should be fair to treat them as "semi-public", # or at least public enough so we can have a test to make sure they are correct assert cmd.config_vars['py_version'] == '3.10.1' assert cmd.config_vars['py_version_short'] == '3.10' assert cmd.config_vars['py_version_nodot'] == '310' @pytest.mark.xfail( sys.platform == "darwin", reason="https://github.com/pypa/setuptools/pull/4716#issuecomment-2447624418", ) def test_editable_user_and_build_isolation(setup_context, monkeypatch, tmp_path): """`setup.py develop` should honor `--user` even under build isolation""" # == Arrange == # Pretend that build isolation was enabled # e.g pip sets the environment variable PYTHONNOUSERSITE=1 monkeypatch.setattr('site.ENABLE_USER_SITE', False) # Patching $HOME for 2 reasons: # 1. setuptools/command/easy_install.py:create_home_path # tries creating directories in $HOME. # Given:: # self.config_vars['DESTDIRS'] = ( # "/home/user/.pyenv/versions/3.9.10 " # "/home/user/.pyenv/versions/3.9.10/lib " # "/home/user/.pyenv/versions/3.9.10/lib/python3.9 " # "/home/user/.pyenv/versions/3.9.10/lib/python3.9/lib-dynload") # `create_home_path` will:: # makedirs( # "/home/user/.pyenv/versions/3.9.10 " # "/home/user/.pyenv/versions/3.9.10/lib " # "/home/user/.pyenv/versions/3.9.10/lib/python3.9 " # "/home/user/.pyenv/versions/3.9.10/lib/python3.9/lib-dynload") # # 2. We are going to force `site` to update site.USER_BASE and site.USER_SITE # To point inside our new home monkeypatch.setenv('HOME', str(tmp_path / '.home')) monkeypatch.setenv('USERPROFILE', str(tmp_path / '.home')) monkeypatch.setenv('APPDATA', str(tmp_path / '.home')) monkeypatch.setattr('site.USER_BASE', None) monkeypatch.setattr('site.USER_SITE', None) user_site = Path(site.getusersitepackages()) user_site.mkdir(parents=True, exist_ok=True) sys_prefix = tmp_path / '.sys_prefix' sys_prefix.mkdir(parents=True, exist_ok=True) monkeypatch.setattr('sys.prefix', str(sys_prefix)) setup_script = ( "__import__('setuptools').setup(name='aproj', version=42, packages=[])\n" ) (tmp_path / "setup.py").write_text(setup_script, encoding="utf-8") # == Sanity check == assert list(sys_prefix.glob("*")) == [] assert list(user_site.glob("*")) == [] # == Act == run_setup('setup.py', ['develop', '--user']) # == Assert == # Should not install to sys.prefix assert list(sys_prefix.glob("*")) == [] # Should install to user site installed = {f.name for f in user_site.glob("*")} # sometimes easy-install.pth is created and sometimes not installed = installed - {"easy-install.pth"} assert installed == {'aproj.egg-link'} tests/indexes/test_links_priority/simple/foobar/index.html 0000644 00000000256 15030122015 0020213 0 ustar 00 <html><body> <a href="/foobar-0.1.tar.gz#md5=0_correct_md5">foobar-0.1.tar.gz</a><br/> <a href="../../external.html" rel="homepage">external homepage</a><br/> </body></html> tests/indexes/test_links_priority/external.html 0000644 00000000134 15030122015 0016160 0 ustar 00 <html><body> <a href="/foobar-0.1.tar.gz#md5=1__bad_md5___">bad old link</a> </body></html> tests/test_dist_info.py 0000644 00000015645 15030122015 0011275 0 ustar 00 """Test .dist-info style distributions.""" import pathlib import re import shutil import subprocess import sys from functools import partial import pytest import pkg_resources from setuptools.archive_util import unpack_archive from .textwrap import DALS read = partial(pathlib.Path.read_text, encoding="utf-8") class TestDistInfo: metadata_base = DALS( """ Metadata-Version: 1.2 Requires-Dist: splort (==4) Provides-Extra: baz Requires-Dist: quux (>=1.1); extra == 'baz' """ ) @classmethod def build_metadata(cls, **kwargs): lines = ('{key}: {value}\n'.format(**locals()) for key, value in kwargs.items()) return cls.metadata_base + ''.join(lines) @pytest.fixture def metadata(self, tmpdir): dist_info_name = 'VersionedDistribution-2.718.dist-info' versioned = tmpdir / dist_info_name versioned.mkdir() filename = versioned / 'METADATA' content = self.build_metadata( Name='VersionedDistribution', ) filename.write_text(content, encoding='utf-8') dist_info_name = 'UnversionedDistribution.dist-info' unversioned = tmpdir / dist_info_name unversioned.mkdir() filename = unversioned / 'METADATA' content = self.build_metadata( Name='UnversionedDistribution', Version='0.3', ) filename.write_text(content, encoding='utf-8') return str(tmpdir) def test_distinfo(self, metadata): dists = dict( (d.project_name, d) for d in pkg_resources.find_distributions(metadata) ) assert len(dists) == 2, dists unversioned = dists['UnversionedDistribution'] versioned = dists['VersionedDistribution'] assert versioned.version == '2.718' # from filename assert unversioned.version == '0.3' # from METADATA def test_conditional_dependencies(self, metadata): specs = 'splort==4', 'quux>=1.1' requires = list(map(pkg_resources.Requirement.parse, specs)) for d in pkg_resources.find_distributions(metadata): assert d.requires() == requires[:1] assert d.requires(extras=('baz',)) == [ requires[0], pkg_resources.Requirement.parse('quux>=1.1;extra=="baz"'), ] assert d.extras == ['baz'] def test_invalid_version(self, tmp_path): """ Supplying an invalid version crashes dist_info. """ config = "[metadata]\nname=proj\nversion=42\n[egg_info]\ntag_build=invalid!!!\n" (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") msg = re.compile("invalid version", re.M | re.I) proc = run_command_inner("dist_info", cwd=tmp_path, check=False) assert proc.returncode assert msg.search(proc.stdout) assert not list(tmp_path.glob("*.dist-info")) def test_tag_arguments(self, tmp_path): config = """ [metadata] name=proj version=42 [egg_info] tag_date=1 tag_build=.post """ (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") print(run_command("dist_info", "--no-date", cwd=tmp_path)) dist_info = next(tmp_path.glob("*.dist-info")) assert dist_info.name.startswith("proj-42") shutil.rmtree(dist_info) print(run_command("dist_info", "--tag-build", ".a", cwd=tmp_path)) dist_info = next(tmp_path.glob("*.dist-info")) assert dist_info.name.startswith("proj-42a") @pytest.mark.parametrize("keep_egg_info", (False, True)) def test_output_dir(self, tmp_path, keep_egg_info): config = "[metadata]\nname=proj\nversion=42\n" (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") out = tmp_path / "__out" out.mkdir() opts = ["--keep-egg-info"] if keep_egg_info else [] run_command("dist_info", "--output-dir", out, *opts, cwd=tmp_path) assert len(list(out.glob("*.dist-info"))) == 1 assert len(list(tmp_path.glob("*.dist-info"))) == 0 expected_egg_info = int(keep_egg_info) assert len(list(out.glob("*.egg-info"))) == expected_egg_info assert len(list(tmp_path.glob("*.egg-info"))) == 0 assert len(list(out.glob("*.__bkp__"))) == 0 assert len(list(tmp_path.glob("*.__bkp__"))) == 0 class TestWheelCompatibility: """Make sure the .dist-info directory produced with the ``dist_info`` command is the same as the one produced by ``bdist_wheel``. """ SETUPCFG = DALS( """ [metadata] name = {name} version = {version} [options] install_requires = foo>=12; sys_platform != "linux" [options.extras_require] test = pytest [options.entry_points] console_scripts = executable-name = my_package.module:function discover = myproj = my_package.other_module:function """ ) EGG_INFO_OPTS = [ # Related: #3088 #2872 ("", ""), (".post", "[egg_info]\ntag_build = post\n"), (".post", "[egg_info]\ntag_build = .post\n"), (".post", "[egg_info]\ntag_build = post\ntag_date = 1\n"), (".dev", "[egg_info]\ntag_build = .dev\n"), (".dev", "[egg_info]\ntag_build = .dev\ntag_date = 1\n"), ("a1", "[egg_info]\ntag_build = .a1\n"), ("+local", "[egg_info]\ntag_build = +local\n"), ] @pytest.mark.parametrize("name", "my-proj my_proj my.proj My.Proj".split()) @pytest.mark.parametrize("version", ["0.42.13"]) @pytest.mark.parametrize(("suffix", "cfg"), EGG_INFO_OPTS) def test_dist_info_is_the_same_as_in_wheel( self, name, version, tmp_path, suffix, cfg ): config = self.SETUPCFG.format(name=name, version=version) + cfg for i in "dir_wheel", "dir_dist": (tmp_path / i).mkdir() (tmp_path / i / "setup.cfg").write_text(config, encoding="utf-8") run_command("bdist_wheel", cwd=tmp_path / "dir_wheel") wheel = next(tmp_path.glob("dir_wheel/dist/*.whl")) unpack_archive(wheel, tmp_path / "unpack") wheel_dist_info = next(tmp_path.glob("unpack/*.dist-info")) run_command("dist_info", cwd=tmp_path / "dir_dist") dist_info = next(tmp_path.glob("dir_dist/*.dist-info")) assert dist_info.name == wheel_dist_info.name assert dist_info.name.startswith(f"my_proj-{version}{suffix}") for file in "METADATA", "entry_points.txt": assert read(dist_info / file) == read(wheel_dist_info / file) def run_command_inner(*cmd, **kwargs): opts = { "stderr": subprocess.STDOUT, "stdout": subprocess.PIPE, "text": True, "encoding": "utf-8", "check": True, **kwargs, } cmd = [sys.executable, "-c", "__import__('setuptools').setup()", *map(str, cmd)] return subprocess.run(cmd, **opts) def run_command(*args, **kwargs): return run_command_inner(*args, **kwargs).stdout tests/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000260 15030122015 0015624 0 ustar 00 o �h � @ s d S )N� r r r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/compat/__init__.py�<module> s tests/compat/__pycache__/py39.cpython-310.pyc 0000644 00000000455 15030122015 0014677 0 ustar 00 o �h� � @ s$ d dl mZmZ ed�ped�ZdS )� )�from_test_support� try_import� os_helper� can_symlinkN)�jaraco.test.cpythonr r r � r r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/tests/compat/py39.py�<module> s tests/compat/py39.py 0000644 00000000207 15030122015 0010333 0 ustar 00 from jaraco.test.cpython import from_test_support, try_import os_helper = try_import('os_helper') or from_test_support('can_symlink') tests/compat/__init__.py 0000644 00000000000 15030122015 0011255 0 ustar 00 tests/test_sdist.py 0000644 00000100150 15030122015 0010427 0 ustar 00 """sdist tests""" import contextlib import io import logging import os import pathlib import sys import tarfile import tempfile import unicodedata from inspect import cleandoc from pathlib import Path from unittest import mock import jaraco.path import pytest from setuptools import Command, SetuptoolsDeprecationWarning from setuptools._importlib import metadata from setuptools.command.egg_info import manifest_maker from setuptools.command.sdist import sdist from setuptools.dist import Distribution from setuptools.extension import Extension from setuptools.tests import fail_on_ascii from .text import Filenames import distutils from distutils.core import run_setup SETUP_ATTRS = { 'name': 'sdist_test', 'version': '0.0', 'packages': ['sdist_test'], 'package_data': {'sdist_test': ['*.txt']}, 'data_files': [("data", [os.path.join("d", "e.dat")])], } SETUP_PY = f"""\ from setuptools import setup setup(**{SETUP_ATTRS!r}) """ EXTENSION = Extension( name="sdist_test.f", sources=[os.path.join("sdist_test", "f.c")], depends=[os.path.join("sdist_test", "f.h")], ) EXTENSION_SOURCES = EXTENSION.sources + EXTENSION.depends @contextlib.contextmanager def quiet(): old_stdout, old_stderr = sys.stdout, sys.stderr sys.stdout, sys.stderr = io.StringIO(), io.StringIO() try: yield finally: sys.stdout, sys.stderr = old_stdout, old_stderr # Convert to POSIX path def posix(path): if not isinstance(path, str): return path.replace(os.sep.encode('ascii'), b'/') else: return path.replace(os.sep, '/') # HFS Plus uses decomposed UTF-8 def decompose(path): if isinstance(path, str): return unicodedata.normalize('NFD', path) try: path = path.decode('utf-8') path = unicodedata.normalize('NFD', path) path = path.encode('utf-8') except UnicodeError: pass # Not UTF-8 return path def read_all_bytes(filename): with open(filename, 'rb') as fp: return fp.read() def latin1_fail(): try: desc, filename = tempfile.mkstemp(suffix=Filenames.latin_1) os.close(desc) os.remove(filename) except Exception: return True fail_on_latin1_encoded_filenames = pytest.mark.xfail( latin1_fail(), reason="System does not support latin-1 filenames", ) skip_under_xdist = pytest.mark.skipif( "os.environ.get('PYTEST_XDIST_WORKER')", reason="pytest-dev/pytest-xdist#843", ) skip_under_stdlib_distutils = pytest.mark.skipif( not distutils.__package__.startswith('setuptools'), reason="the test is not supported with stdlib distutils", ) def touch(path): open(path, 'wb').close() return path def symlink_or_skip_test(src, dst): try: os.symlink(src, dst) except (OSError, NotImplementedError): pytest.skip("symlink not supported in OS") return None return dst class TestSdistTest: @pytest.fixture(autouse=True) def source_dir(self, tmpdir): tmpdir = tmpdir / "project_root" tmpdir.mkdir() (tmpdir / 'setup.py').write_text(SETUP_PY, encoding='utf-8') # Set up the rest of the test package test_pkg = tmpdir / 'sdist_test' test_pkg.mkdir() data_folder = tmpdir / 'd' data_folder.mkdir() # *.rst was not included in package_data, so c.rst should not be # automatically added to the manifest when not under version control for fname in ['__init__.py', 'a.txt', 'b.txt', 'c.rst']: touch(test_pkg / fname) touch(data_folder / 'e.dat') # C sources are not included by default, but they will be, # if an extension module uses them as sources or depends for fname in EXTENSION_SOURCES: touch(tmpdir / fname) with tmpdir.as_cwd(): yield tmpdir def assert_package_data_in_manifest(self, cmd): manifest = cmd.filelist.files assert os.path.join('sdist_test', 'a.txt') in manifest assert os.path.join('sdist_test', 'b.txt') in manifest assert os.path.join('sdist_test', 'c.rst') not in manifest assert os.path.join('d', 'e.dat') in manifest def setup_with_extension(self): setup_attrs = {**SETUP_ATTRS, 'ext_modules': [EXTENSION]} dist = Distribution(setup_attrs) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() return cmd def test_package_data_in_sdist(self): """Regression test for pull request #4: ensures that files listed in package_data are included in the manifest even if they're not added to version control. """ dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() self.assert_package_data_in_manifest(cmd) def test_package_data_and_include_package_data_in_sdist(self): """ Ensure package_data and include_package_data work together. """ setup_attrs = {**SETUP_ATTRS, 'include_package_data': True} assert setup_attrs['package_data'] dist = Distribution(setup_attrs) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() self.assert_package_data_in_manifest(cmd) def test_extension_sources_in_sdist(self): """ Ensure that the files listed in Extension.sources and Extension.depends are automatically included in the manifest. """ cmd = self.setup_with_extension() self.assert_package_data_in_manifest(cmd) manifest = cmd.filelist.files for path in EXTENSION_SOURCES: assert path in manifest def test_missing_extension_sources(self): """ Similar to test_extension_sources_in_sdist but the referenced files don't exist. Missing files should not be included in distribution (with no error raised). """ for path in EXTENSION_SOURCES: os.remove(path) cmd = self.setup_with_extension() self.assert_package_data_in_manifest(cmd) manifest = cmd.filelist.files for path in EXTENSION_SOURCES: assert path not in manifest def test_symlinked_extension_sources(self): """ Similar to test_extension_sources_in_sdist but the referenced files are instead symbolic links to project-local files. Referenced file paths should be included. Symlink targets themselves should NOT be included. """ symlinked = [] for path in EXTENSION_SOURCES: base, ext = os.path.splitext(path) target = base + "_target." + ext os.rename(path, target) symlink_or_skip_test(os.path.basename(target), path) symlinked.append(target) cmd = self.setup_with_extension() self.assert_package_data_in_manifest(cmd) manifest = cmd.filelist.files for path in EXTENSION_SOURCES: assert path in manifest for path in symlinked: assert path not in manifest _INVALID_PATHS = { "must be relative": lambda: ( os.path.abspath(os.path.join("sdist_test", "f.h")) ), "can't have `..` segments": lambda: ( os.path.join("sdist_test", "..", "sdist_test", "f.h") ), "doesn't exist": lambda: ( os.path.join("sdist_test", "this_file_does_not_exist.h") ), "must be inside the project root": lambda: ( symlink_or_skip_test( touch(os.path.join("..", "outside_of_project_root.h")), "symlink.h", ) ), } @skip_under_stdlib_distutils @pytest.mark.parametrize("reason", _INVALID_PATHS.keys()) def test_invalid_extension_depends(self, reason, caplog): """ Due to backwards compatibility reasons, `Extension.depends` should accept invalid/weird paths, but then ignore them when building a sdist. This test verifies that the source distribution is still built successfully with such paths, but that instead of adding these paths to the manifest, we emit an informational message, notifying the user that the invalid path won't be automatically included. """ invalid_path = self._INVALID_PATHS[reason]() extension = Extension( name="sdist_test.f", sources=[], depends=[invalid_path], ) setup_attrs = {**SETUP_ATTRS, 'ext_modules': [extension]} dist = Distribution(setup_attrs) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(), caplog.at_level(logging.INFO): cmd.run() self.assert_package_data_in_manifest(cmd) manifest = cmd.filelist.files assert invalid_path not in manifest expected_message = [ message for (logger, level, message) in caplog.record_tuples if ( logger == "root" # and level == logging.INFO # and invalid_path in message # ) ] assert len(expected_message) == 1 (expected_message,) = expected_message assert reason in expected_message def test_custom_build_py(self): """ Ensure projects defining custom build_py don't break when creating sdists (issue #2849) """ from distutils.command.build_py import build_py as OrigBuildPy using_custom_command_guard = mock.Mock() class CustomBuildPy(OrigBuildPy): """ Some projects have custom commands inheriting from `distutils` """ def get_data_files(self): using_custom_command_guard() return super().get_data_files() setup_attrs = {**SETUP_ATTRS, 'include_package_data': True} assert setup_attrs['package_data'] dist = Distribution(setup_attrs) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Make sure we use the custom command cmd.cmdclass = {'build_py': CustomBuildPy} cmd.distribution.cmdclass = {'build_py': CustomBuildPy} assert cmd.distribution.get_command_class('build_py') == CustomBuildPy msg = "setuptools instead of distutils" with quiet(), pytest.warns(SetuptoolsDeprecationWarning, match=msg): cmd.run() using_custom_command_guard.assert_called() self.assert_package_data_in_manifest(cmd) def test_setup_py_exists(self): dist = Distribution(SETUP_ATTRS) dist.script_name = 'foo.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert 'setup.py' in manifest def test_setup_py_missing(self): dist = Distribution(SETUP_ATTRS) dist.script_name = 'foo.py' cmd = sdist(dist) cmd.ensure_finalized() if os.path.exists("setup.py"): os.remove("setup.py") with quiet(): cmd.run() manifest = cmd.filelist.files assert 'setup.py' not in manifest def test_setup_py_excluded(self): with open("MANIFEST.in", "w", encoding="utf-8") as manifest_file: manifest_file.write("exclude setup.py") dist = Distribution(SETUP_ATTRS) dist.script_name = 'foo.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert 'setup.py' not in manifest def test_defaults_case_sensitivity(self, source_dir): """ Make sure default files (README.*, etc.) are added in a case-sensitive way to avoid problems with packages built on Windows. """ touch(source_dir / 'readme.rst') touch(source_dir / 'SETUP.cfg') dist = Distribution(SETUP_ATTRS) # the extension deliberately capitalized for this test # to make sure the actual filename (not capitalized) gets added # to the manifest dist.script_name = 'setup.PY' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() # lowercase all names so we can test in a # case-insensitive way to make sure the files # are not included. manifest = map(lambda x: x.lower(), cmd.filelist.files) assert 'readme.rst' not in manifest, manifest assert 'setup.py' not in manifest, manifest assert 'setup.cfg' not in manifest, manifest def test_exclude_dev_only_cache_folders(self, source_dir): included = { # Emulate problem in https://github.com/pypa/setuptools/issues/4601 "MANIFEST.in": ( "global-include LICEN[CS]E* COPYING* NOTICE* AUTHORS*\n" "global-include *.txt\n" ), # For the sake of being conservative and limiting unforeseen side-effects # we just exclude dev-only cache folders at the root of the repository: "test/.venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rst": "", "src/.nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txt": "", "doc/.tox/default/lib/python3.11/site-packages/foo-4.dist-info/LICENSE": "", # Let's test against false positives with similarly named files: ".venv-requirements.txt": "", ".tox-coveragerc.txt": "", ".noxy/coveragerc.txt": "", } excluded = { # .tox/.nox/.venv are well-know folders present at the root of Python repos # and therefore should be excluded ".tox/release/lib/python3.11/site-packages/foo-4.dist-info/LICENSE": "", ".nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txt": "", ".venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rst": "", } for file, content in {**excluded, **included}.items(): Path(source_dir, file).parent.mkdir(parents=True, exist_ok=True) Path(source_dir, file).write_text(content, encoding="utf-8") cmd = self.setup_with_extension() self.assert_package_data_in_manifest(cmd) manifest = {f.replace(os.sep, '/') for f in cmd.filelist.files} for path in excluded: assert os.path.exists(path) assert path not in manifest, (path, manifest) for path in included: assert os.path.exists(path) assert path in manifest, (path, manifest) @fail_on_ascii def test_manifest_is_written_with_utf8_encoding(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') # UTF-8 filename filename = os.path.join('sdist_test', 'smörbröd.py') # Must create the file or it will get stripped. touch(filename) # Add UTF-8 filename and write manifest with quiet(): mm.run() mm.filelist.append(filename) mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded u_contents = contents.decode('UTF-8') # The manifest should contain the UTF-8 filename assert posix(filename) in u_contents @fail_on_ascii def test_write_manifest_allows_utf8_filenames(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') filename = os.path.join(b'sdist_test', Filenames.utf_8) # Must touch the file or risk removal touch(filename) # Add filename and write manifest with quiet(): mm.run() u_filename = filename.decode('utf-8') mm.filelist.files.append(u_filename) # Re-write manifest mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded contents.decode('UTF-8') # The manifest should contain the UTF-8 filename assert posix(filename) in contents # The filelist should have been updated as well assert u_filename in mm.filelist.files @skip_under_xdist def test_write_manifest_skips_non_utf8_filenames(self): """ Files that cannot be encoded to UTF-8 (specifically, those that weren't originally successfully decoded and have surrogate escapes) should be omitted from the manifest. See https://bitbucket.org/tarek/distribute/issue/303 for history. """ dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' mm = manifest_maker(dist) mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') os.mkdir('sdist_test.egg-info') # Latin-1 filename filename = os.path.join(b'sdist_test', Filenames.latin_1) # Add filename with surrogates and write manifest with quiet(): mm.run() u_filename = filename.decode('utf-8', 'surrogateescape') mm.filelist.append(u_filename) # Re-write manifest mm.write_manifest() contents = read_all_bytes(mm.manifest) # The manifest should be UTF-8 encoded contents.decode('UTF-8') # The Latin-1 filename should have been skipped assert posix(filename) not in contents # The filelist should have been updated as well assert u_filename not in mm.filelist.files @fail_on_ascii def test_manifest_is_read_with_utf8_encoding(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Create manifest with quiet(): cmd.run() # Add UTF-8 filename to manifest filename = os.path.join(b'sdist_test', Filenames.utf_8) cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') manifest = open(cmd.manifest, 'ab') manifest.write(b'\n' + filename) manifest.close() # The file must exist to be included in the filelist touch(filename) # Re-read manifest cmd.filelist.files = [] with quiet(): cmd.read_manifest() # The filelist should contain the UTF-8 filename filename = filename.decode('utf-8') assert filename in cmd.filelist.files @fail_on_latin1_encoded_filenames def test_read_manifest_skips_non_utf8_filenames(self): # Test for #303. dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Create manifest with quiet(): cmd.run() # Add Latin-1 filename to manifest filename = os.path.join(b'sdist_test', Filenames.latin_1) cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') manifest = open(cmd.manifest, 'ab') manifest.write(b'\n' + filename) manifest.close() # The file must exist to be included in the filelist touch(filename) # Re-read manifest cmd.filelist.files = [] with quiet(): cmd.read_manifest() # The Latin-1 filename should have been skipped filename = filename.decode('latin-1') assert filename not in cmd.filelist.files @fail_on_ascii @fail_on_latin1_encoded_filenames def test_sdist_with_utf8_encoded_filename(self): # Test for #303. dist = Distribution(self.make_strings(SETUP_ATTRS)) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() filename = os.path.join(b'sdist_test', Filenames.utf_8) touch(filename) with quiet(): cmd.run() if sys.platform == 'darwin': filename = decompose(filename) fs_enc = sys.getfilesystemencoding() if sys.platform == 'win32': if fs_enc == 'cp1252': # Python mangles the UTF-8 filename filename = filename.decode('cp1252') assert filename in cmd.filelist.files else: filename = filename.decode('mbcs') assert filename in cmd.filelist.files else: filename = filename.decode('utf-8') assert filename in cmd.filelist.files @classmethod def make_strings(cls, item): if isinstance(item, dict): return {key: cls.make_strings(value) for key, value in item.items()} if isinstance(item, list): return list(map(cls.make_strings, item)) return str(item) @fail_on_latin1_encoded_filenames @skip_under_xdist def test_sdist_with_latin1_encoded_filename(self): # Test for #303. dist = Distribution(self.make_strings(SETUP_ATTRS)) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() # Latin-1 filename filename = os.path.join(b'sdist_test', Filenames.latin_1) touch(filename) assert os.path.isfile(filename) with quiet(): cmd.run() # not all windows systems have a default FS encoding of cp1252 if sys.platform == 'win32': # Latin-1 is similar to Windows-1252 however # on mbcs filesys it is not in latin-1 encoding fs_enc = sys.getfilesystemencoding() if fs_enc != 'mbcs': fs_enc = 'latin-1' filename = filename.decode(fs_enc) assert filename in cmd.filelist.files else: # The Latin-1 filename should have been skipped filename = filename.decode('latin-1') assert filename not in cmd.filelist.files _EXAMPLE_DIRECTIVES = { "setup.cfg - long_description and version": """ [metadata] name = testing version = file: src/VERSION.txt license_files = DOWHATYOUWANT long_description = file: README.rst, USAGE.rst """, "pyproject.toml - static readme/license files and dynamic version": """ [project] name = "testing" readme = "USAGE.rst" license-files = ["DOWHATYOUWANT"] dynamic = ["version"] [tool.setuptools.dynamic] version = {file = ["src/VERSION.txt"]} """, "pyproject.toml - directive with str instead of list": """ [project] name = "testing" readme = "USAGE.rst" license-files = ["DOWHATYOUWANT"] dynamic = ["version"] [tool.setuptools.dynamic] version = {file = "src/VERSION.txt"} """, "pyproject.toml - deprecated license table with file entry": """ [project] name = "testing" readme = "USAGE.rst" license = {file = "DOWHATYOUWANT"} dynamic = ["version"] [tool.setuptools.dynamic] version = {file = "src/VERSION.txt"} """, } @pytest.mark.parametrize("config", _EXAMPLE_DIRECTIVES.keys()) @pytest.mark.filterwarnings( "ignore:.project.license. as a TOML table is deprecated" ) def test_add_files_referenced_by_config_directives(self, source_dir, config): config_file, _, _ = config.partition(" - ") config_text = self._EXAMPLE_DIRECTIVES[config] (source_dir / 'src').mkdir() (source_dir / 'src/VERSION.txt').write_text("0.42", encoding="utf-8") (source_dir / 'README.rst').write_text("hello world!", encoding="utf-8") (source_dir / 'USAGE.rst').write_text("hello world!", encoding="utf-8") (source_dir / 'DOWHATYOUWANT').write_text("hello world!", encoding="utf-8") (source_dir / config_file).write_text(config_text, encoding="utf-8") dist = Distribution({"packages": []}) dist.script_name = 'setup.py' dist.parse_config_files() cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() assert ( 'src/VERSION.txt' in cmd.filelist.files or 'src\\VERSION.txt' in cmd.filelist.files ) assert 'USAGE.rst' in cmd.filelist.files assert 'DOWHATYOUWANT' in cmd.filelist.files assert '/' not in cmd.filelist.files assert '\\' not in cmd.filelist.files def test_pyproject_toml_in_sdist(self, source_dir): """ Check if pyproject.toml is included in source distribution if present """ touch(source_dir / 'pyproject.toml') dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert 'pyproject.toml' in manifest def test_pyproject_toml_excluded(self, source_dir): """ Check that pyproject.toml can excluded even if present """ touch(source_dir / 'pyproject.toml') with open('MANIFEST.in', 'w', encoding="utf-8") as mts: print('exclude pyproject.toml', file=mts) dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert 'pyproject.toml' not in manifest def test_build_subcommand_source_files(self, source_dir): touch(source_dir / '.myfile~') # Sanity check: without custom commands file list should not be affected dist = Distribution({**SETUP_ATTRS, "script_name": "setup.py"}) cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert '.myfile~' not in manifest # Test: custom command should be able to augment file list dist = Distribution({**SETUP_ATTRS, "script_name": "setup.py"}) build = dist.get_command_obj("build") build.sub_commands = [*build.sub_commands, ("build_custom", None)] class build_custom(Command): def initialize_options(self): ... def finalize_options(self): ... def run(self): ... def get_source_files(self): return ['.myfile~'] dist.cmdclass.update(build_custom=build_custom) cmd = sdist(dist) cmd.use_defaults = True cmd.ensure_finalized() with quiet(): cmd.run() manifest = cmd.filelist.files assert '.myfile~' in manifest @pytest.mark.skipif("os.environ.get('SETUPTOOLS_USE_DISTUTILS') == 'stdlib'") def test_build_base_pathlib(self, source_dir): """ Ensure if build_base is a pathlib.Path, the build still succeeds. """ dist = Distribution({ **SETUP_ATTRS, "script_name": "setup.py", "options": {"build": {"build_base": pathlib.Path('build')}}, }) cmd = sdist(dist) cmd.ensure_finalized() with quiet(): cmd.run() def test_default_revctrl(): """ When _default_revctrl was removed from the `setuptools.command.sdist` module in 10.0, it broke some systems which keep an old install of setuptools (Distribute) around. Those old versions require that the setuptools package continue to implement that interface, so this function provides that interface, stubbed. See #320 for details. This interface must be maintained until Ubuntu 12.04 is no longer supported (by Setuptools). """ (ep,) = metadata.EntryPoints._from_text( """ [setuptools.file_finders] svn_cvs = setuptools.command.sdist:_default_revctrl """ ) res = ep.load() assert hasattr(res, '__iter__') class TestRegressions: """ Can be removed/changed if the project decides to change how it handles symlinks or external files. """ @staticmethod def files_for_symlink_in_extension_depends(tmp_path, dep_path): return { "external": { "dir": {"file.h": ""}, }, "project": { "setup.py": cleandoc( f""" from setuptools import Extension, setup setup( name="myproj", version="42", ext_modules=[ Extension( "hello", sources=["hello.pyx"], depends=[{dep_path!r}] ) ], ) """ ), "hello.pyx": "", "MANIFEST.in": "global-include *.h", }, } @pytest.mark.parametrize( "dep_path", ("myheaders/dir/file.h", "myheaders/dir/../dir/file.h") ) def test_symlink_in_extension_depends(self, monkeypatch, tmp_path, dep_path): # Given a project with a symlinked dir and a "depends" targeting that dir files = self.files_for_symlink_in_extension_depends(tmp_path, dep_path) jaraco.path.build(files, prefix=str(tmp_path)) symlink_or_skip_test(tmp_path / "external", tmp_path / "project/myheaders") # When `sdist` runs, there should be no error members = run_sdist(monkeypatch, tmp_path / "project") # and the sdist should contain the symlinked files for expected in ( "myproj-42/hello.pyx", "myproj-42/myheaders/dir/file.h", ): assert expected in members @staticmethod def files_for_external_path_in_extension_depends(tmp_path, dep_path): head, _, tail = dep_path.partition("$tmp_path$/") dep_path = tmp_path / tail if tail else head return { "external": { "dir": {"file.h": ""}, }, "project": { "setup.py": cleandoc( f""" from setuptools import Extension, setup setup( name="myproj", version="42", ext_modules=[ Extension( "hello", sources=["hello.pyx"], depends=[{str(dep_path)!r}] ) ], ) """ ), "hello.pyx": "", "MANIFEST.in": "global-include *.h", }, } @pytest.mark.parametrize( "dep_path", ("$tmp_path$/external/dir/file.h", "../external/dir/file.h") ) def test_external_path_in_extension_depends(self, monkeypatch, tmp_path, dep_path): # Given a project with a "depends" targeting an external dir files = self.files_for_external_path_in_extension_depends(tmp_path, dep_path) jaraco.path.build(files, prefix=str(tmp_path)) # When `sdist` runs, there should be no error members = run_sdist(monkeypatch, tmp_path / "project") # and the sdist should not contain the external file for name in members: assert "file.h" not in name def run_sdist(monkeypatch, project): """Given a project directory, run the sdist and return its contents""" monkeypatch.chdir(project) with quiet(): run_setup("setup.py", ["sdist"]) archive = next((project / "dist").glob("*.tar.gz")) with tarfile.open(str(archive)) as tar: return set(tar.getnames()) def test_sanity_check_setuptools_own_sdist(setuptools_sdist): with tarfile.open(setuptools_sdist) as tar: files = tar.getnames() # setuptools sdist should not include the .tox folder tox_files = [name for name in files if ".tox" in name] assert len(tox_files) == 0, f"not empty {tox_files}" tests/test_install_scripts.py 0000644 00000006551 15030122015 0012530 0 ustar 00 """install_scripts tests""" import sys import pytest from setuptools.command.install_scripts import install_scripts from setuptools.dist import Distribution from . import contexts class TestInstallScripts: settings = dict( name='foo', entry_points={'console_scripts': ['foo=foo:foo']}, version='0.0', ) unix_exe = '/usr/dummy-test-path/local/bin/python' unix_spaces_exe = '/usr/bin/env dummy-test-python' win32_exe = 'C:\\Dummy Test Path\\Program Files\\Python 3.6\\python.exe' def _run_install_scripts(self, install_dir, executable=None): dist = Distribution(self.settings) dist.script_name = 'setup.py' cmd = install_scripts(dist) cmd.install_dir = install_dir if executable is not None: bs = cmd.get_finalized_command('build_scripts') bs.executable = executable cmd.ensure_finalized() with contexts.quiet(): cmd.run() @pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') def test_sys_executable_escaping_unix(self, tmpdir, monkeypatch): """ Ensure that shebang is not quoted on Unix when getting the Python exe from sys.executable. """ expected = f'#!{self.unix_exe}\n' monkeypatch.setattr('sys.executable', self.unix_exe) with tmpdir.as_cwd(): self._run_install_scripts(str(tmpdir)) with open(str(tmpdir.join('foo')), 'r', encoding="utf-8") as f: actual = f.readline() assert actual == expected @pytest.mark.skipif(sys.platform != 'win32', reason='Windows only') def test_sys_executable_escaping_win32(self, tmpdir, monkeypatch): """ Ensure that shebang is quoted on Windows when getting the Python exe from sys.executable and it contains a space. """ expected = f'#!"{self.win32_exe}"\n' monkeypatch.setattr('sys.executable', self.win32_exe) with tmpdir.as_cwd(): self._run_install_scripts(str(tmpdir)) with open(str(tmpdir.join('foo-script.py')), 'r', encoding="utf-8") as f: actual = f.readline() assert actual == expected @pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') def test_executable_with_spaces_escaping_unix(self, tmpdir): """ Ensure that shebang on Unix is not quoted, even when a value with spaces is specified using --executable. """ expected = f'#!{self.unix_spaces_exe}\n' with tmpdir.as_cwd(): self._run_install_scripts(str(tmpdir), self.unix_spaces_exe) with open(str(tmpdir.join('foo')), 'r', encoding="utf-8") as f: actual = f.readline() assert actual == expected @pytest.mark.skipif(sys.platform != 'win32', reason='Windows only') def test_executable_arg_escaping_win32(self, tmpdir): """ Ensure that shebang on Windows is quoted when getting a path with spaces from --executable, that is itself properly quoted. """ expected = f'#!"{self.win32_exe}"\n' with tmpdir.as_cwd(): self._run_install_scripts(str(tmpdir), '"' + self.win32_exe + '"') with open(str(tmpdir.join('foo-script.py')), 'r', encoding="utf-8") as f: actual = f.readline() assert actual == expected tests/test_distutils_adoption.py 0000644 00000013543 15030122015 0013233 0 ustar 00 import os import platform import sys import textwrap import pytest IS_PYPY = '__pypy__' in sys.builtin_module_names _TEXT_KWARGS = {"text": True, "encoding": "utf-8"} # For subprocess.run def win_sr(env): """ On Windows, SYSTEMROOT must be present to avoid > Fatal Python error: _Py_HashRandomization_Init: failed to > get random numbers to initialize Python """ if env and platform.system() == 'Windows': env['SYSTEMROOT'] = os.environ['SYSTEMROOT'] return env def find_distutils(venv, imports='distutils', env=None, **kwargs): py_cmd = 'import {imports}; print(distutils.__file__)'.format(**locals()) cmd = ['python', '-c', py_cmd] return venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS, **kwargs) def count_meta_path(venv, env=None): py_cmd = textwrap.dedent( """ import sys is_distutils = lambda finder: finder.__class__.__name__ == "DistutilsMetaFinder" print(len(list(filter(is_distutils, sys.meta_path)))) """ ) cmd = ['python', '-c', py_cmd] return int(venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS)) skip_without_stdlib_distutils = pytest.mark.skipif( sys.version_info >= (3, 12), reason='stdlib distutils is removed from Python 3.12+', ) @skip_without_stdlib_distutils def test_distutils_stdlib(venv): """ Ensure stdlib distutils is used when appropriate. """ env = dict(SETUPTOOLS_USE_DISTUTILS='stdlib') assert venv.name not in find_distutils(venv, env=env).split(os.sep) assert count_meta_path(venv, env=env) == 0 def test_distutils_local_with_setuptools(venv): """ Ensure local distutils is used when appropriate. """ env = dict(SETUPTOOLS_USE_DISTUTILS='local') loc = find_distutils(venv, imports='setuptools, distutils', env=env) assert venv.name in loc.split(os.sep) assert count_meta_path(venv, env=env) <= 1 @pytest.mark.xfail('IS_PYPY', reason='pypy imports distutils on startup') def test_distutils_local(venv): """ Even without importing, the setuptools-local copy of distutils is preferred. """ env = dict(SETUPTOOLS_USE_DISTUTILS='local') assert venv.name in find_distutils(venv, env=env).split(os.sep) assert count_meta_path(venv, env=env) <= 1 def test_pip_import(venv): """ Ensure pip can be imported. Regression test for #3002. """ cmd = ['python', '-c', 'import pip'] venv.run(cmd, **_TEXT_KWARGS) def test_distutils_has_origin(): """ Distutils module spec should have an origin. #2990. """ assert __import__('distutils').__spec__.origin ENSURE_IMPORTS_ARE_NOT_DUPLICATED = r""" # Depending on the importlib machinery and _distutils_hack, some imports are # duplicated resulting in different module objects being loaded, which prevents # patches as shown in #3042. # This script provides a way of verifying if this duplication is happening. from distutils import cmd import distutils.command.sdist as sdist # import last to prevent caching from distutils import {imported_module} for mod in (cmd, sdist): assert mod.{imported_module} == {imported_module}, ( f"\n{{mod.dir_util}}\n!=\n{{{imported_module}}}" ) print("success") """ @pytest.mark.usefixtures("tmpdir_cwd") @pytest.mark.parametrize( ('distutils_version', 'imported_module'), [ pytest.param("stdlib", "dir_util", marks=skip_without_stdlib_distutils), pytest.param("stdlib", "file_util", marks=skip_without_stdlib_distutils), pytest.param("stdlib", "archive_util", marks=skip_without_stdlib_distutils), ("local", "dir_util"), ("local", "file_util"), ("local", "archive_util"), ], ) def test_modules_are_not_duplicated_on_import(distutils_version, imported_module, venv): env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) script = ENSURE_IMPORTS_ARE_NOT_DUPLICATED.format(imported_module=imported_module) cmd = ['python', '-c', script] output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() assert output == "success" ENSURE_LOG_IMPORT_IS_NOT_DUPLICATED = r""" import types import distutils.dist as dist from distutils import log if isinstance(dist.log, types.ModuleType): assert dist.log == log, f"\n{dist.log}\n!=\n{log}" print("success") """ @pytest.mark.usefixtures("tmpdir_cwd") @pytest.mark.parametrize( "distutils_version", [ "local", pytest.param("stdlib", marks=skip_without_stdlib_distutils), ], ) def test_log_module_is_not_duplicated_on_import(distutils_version, venv): env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) cmd = ['python', '-c', ENSURE_LOG_IMPORT_IS_NOT_DUPLICATED] output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() assert output == "success" ENSURE_CONSISTENT_ERROR_FROM_MODIFIED_PY = r""" from setuptools.modified import newer from {imported_module}.errors import DistutilsError # Can't use pytest.raises in this context try: newer("", "") except DistutilsError: print("success") else: raise AssertionError("Expected to raise") """ @pytest.mark.usefixtures("tmpdir_cwd") @pytest.mark.parametrize( ('distutils_version', 'imported_module'), [ ("local", "distutils"), # Unfortunately we still get ._distutils.errors.DistutilsError with SETUPTOOLS_USE_DISTUTILS=stdlib # But that's a deprecated use-case we don't mind not fully supporting in newer code pytest.param( "stdlib", "setuptools._distutils", marks=skip_without_stdlib_distutils ), ], ) def test_consistent_error_from_modified_py(distutils_version, imported_module, venv): env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) cmd = [ 'python', '-c', ENSURE_CONSISTENT_ERROR_FROM_MODIFIED_PY.format( imported_module=imported_module ), ] output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() assert output == "success" tests/test_wheel.py 0000644 00000045652 15030122015 0010424 0 ustar 00 """wheel tests""" from __future__ import annotations import contextlib import glob import inspect import os import pathlib import shutil import stat import subprocess import sys import zipfile from typing import Any import pytest from jaraco import path from packaging.tags import parse_tag from packaging.utils import canonicalize_name from pkg_resources import PY_MAJOR, Distribution, PathMetadata from setuptools.wheel import Wheel from .contexts import tempdir from .textwrap import DALS from distutils.sysconfig import get_config_var from distutils.util import get_platform WHEEL_INFO_TESTS = ( ('invalid.whl', ValueError), ( 'simplewheel-2.0-1-py2.py3-none-any.whl', { 'project_name': 'simplewheel', 'version': '2.0', 'build': '1', 'py_version': 'py2.py3', 'abi': 'none', 'platform': 'any', }, ), ( 'simple.dist-0.1-py2.py3-none-any.whl', { 'project_name': 'simple.dist', 'version': '0.1', 'build': None, 'py_version': 'py2.py3', 'abi': 'none', 'platform': 'any', }, ), ( 'example_pkg_a-1-py3-none-any.whl', { 'project_name': 'example_pkg_a', 'version': '1', 'build': None, 'py_version': 'py3', 'abi': 'none', 'platform': 'any', }, ), ( 'PyQt5-5.9-5.9.1-cp35.cp36.cp37-abi3-manylinux1_x86_64.whl', { 'project_name': 'PyQt5', 'version': '5.9', 'build': '5.9.1', 'py_version': 'cp35.cp36.cp37', 'abi': 'abi3', 'platform': 'manylinux1_x86_64', }, ), ) @pytest.mark.parametrize( ('filename', 'info'), WHEEL_INFO_TESTS, ids=[t[0] for t in WHEEL_INFO_TESTS] ) def test_wheel_info(filename, info): if inspect.isclass(info): with pytest.raises(info): Wheel(filename) return w = Wheel(filename) assert {k: getattr(w, k) for k in info.keys()} == info @contextlib.contextmanager def build_wheel(extra_file_defs=None, **kwargs): file_defs = { 'setup.py': ( DALS( """ # -*- coding: utf-8 -*- from setuptools import setup import setuptools setup(**%r) """ ) % kwargs ).encode('utf-8'), } if extra_file_defs: file_defs.update(extra_file_defs) with tempdir() as source_dir: path.build(file_defs, source_dir) subprocess.check_call( (sys.executable, 'setup.py', '-q', 'bdist_wheel'), cwd=source_dir ) yield glob.glob(os.path.join(source_dir, 'dist', '*.whl'))[0] def tree_set(root): contents = set() for dirpath, dirnames, filenames in os.walk(root): for filename in filenames: contents.add(os.path.join(os.path.relpath(dirpath, root), filename)) return contents def flatten_tree(tree): """Flatten nested dicts and lists into a full list of paths""" output = set() for node, contents in tree.items(): if isinstance(contents, dict): contents = flatten_tree(contents) for elem in contents: if isinstance(elem, dict): output |= {os.path.join(node, val) for val in flatten_tree(elem)} else: output.add(os.path.join(node, elem)) return output def format_install_tree(tree): return { x.format( py_version=PY_MAJOR, platform=get_platform(), shlib_ext=get_config_var('EXT_SUFFIX') or get_config_var('SO'), ) for x in tree } def _check_wheel_install( filename, install_dir, install_tree_includes, project_name, version, requires_txt ): w = Wheel(filename) egg_path = os.path.join(install_dir, w.egg_name()) w.install_as_egg(egg_path) if install_tree_includes is not None: install_tree = format_install_tree(install_tree_includes) exp = tree_set(install_dir) assert install_tree.issubset(exp), install_tree - exp metadata = PathMetadata(egg_path, os.path.join(egg_path, 'EGG-INFO')) dist = Distribution.from_filename(egg_path, metadata=metadata) assert dist.project_name == project_name assert dist.version == version if requires_txt is None: assert not dist.has_metadata('requires.txt') else: # Order must match to ensure reproducibility. assert requires_txt == dist.get_metadata('requires.txt').lstrip() class Record: def __init__(self, id, **kwargs): self._id = id self._fields = kwargs def __repr__(self) -> str: return f'{self._id}(**{self._fields!r})' # Using Any to avoid possible type union issues later in test # making a TypedDict is not worth in a test and anonymous/inline TypedDict are experimental # https://github.com/python/mypy/issues/9884 WHEEL_INSTALL_TESTS: tuple[dict[str, Any], ...] = ( dict( id='basic', file_defs={'foo': {'__init__.py': ''}}, setup_kwargs=dict( packages=['foo'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': ['PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt'], 'foo': ['__init__.py'], } }), ), dict( id='utf-8', setup_kwargs=dict( description='Description accentuée', ), ), dict( id='data', file_defs={ 'data.txt': DALS( """ Some data... """ ), }, setup_kwargs=dict( data_files=[('data_dir', ['data.txt'])], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': ['PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt'], 'data_dir': ['data.txt'], } }), ), dict( id='extension', file_defs={ 'extension.c': DALS( """ #include "Python.h" #if PY_MAJOR_VERSION >= 3 static struct PyModuleDef moduledef = { PyModuleDef_HEAD_INIT, "extension", NULL, 0, NULL, NULL, NULL, NULL, NULL }; #define INITERROR return NULL PyMODINIT_FUNC PyInit_extension(void) #else #define INITERROR return void initextension(void) #endif { #if PY_MAJOR_VERSION >= 3 PyObject *module = PyModule_Create(&moduledef); #else PyObject *module = Py_InitModule("extension", NULL); #endif if (module == NULL) INITERROR; #if PY_MAJOR_VERSION >= 3 return module; #endif } """ ), }, setup_kwargs=dict( ext_modules=[ Record( 'setuptools.Extension', name='extension', sources=['extension.c'] ) ], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}-{platform}.egg': [ 'extension{shlib_ext}', { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt', ] }, ] }), ), dict( id='header', file_defs={ 'header.h': DALS( """ """ ), }, setup_kwargs=dict( headers=['header.h'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': [ 'header.h', { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt', ] }, ] }), ), dict( id='script', file_defs={ 'script.py': DALS( """ #/usr/bin/python print('hello world!') """ ), 'script.sh': DALS( """ #/bin/sh echo 'hello world!' """ ), }, setup_kwargs=dict( scripts=['script.py', 'script.sh'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt', {'scripts': ['script.py', 'script.sh']}, ] } }), ), dict( id='requires1', install_requires='foobar==2.0', install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'requires.txt', 'top_level.txt', ] } }), requires_txt=DALS( """ foobar==2.0 """ ), ), dict( id='requires2', install_requires=f""" bar foo<=2.0; {sys.platform!r} in sys_platform """, requires_txt=DALS( """ bar foo<=2.0 """ ), ), dict( id='requires3', install_requires=f""" bar; {sys.platform!r} != sys_platform """, ), dict( id='requires4', install_requires=""" foo """, extras_require={ 'extra': 'foobar>3', }, requires_txt=DALS( """ foo [extra] foobar>3 """ ), ), dict( id='requires5', extras_require={ 'extra': f'foobar; {sys.platform!r} != sys_platform', }, requires_txt=DALS( """ [extra] """ ), ), dict( id='requires_ensure_order', install_requires=""" foo bar baz qux """, extras_require={ 'extra': """ foobar>3 barbaz>4 bazqux>5 quxzap>6 """, }, requires_txt=DALS( """ foo bar baz qux [extra] foobar>3 barbaz>4 bazqux>5 quxzap>6 """ ), ), dict( id='namespace_package', file_defs={ 'foo': { 'bar': {'__init__.py': ''}, }, }, setup_kwargs=dict( namespace_packages=['foo'], packages=['foo.bar'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': [ 'foo-1.0-py{py_version}-nspkg.pth', { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'namespace_packages.txt', 'top_level.txt', ] }, { 'foo': [ '__init__.py', {'bar': ['__init__.py']}, ] }, ] }), ), dict( id='empty_namespace_package', file_defs={ 'foobar': { '__init__.py': ( "__import__('pkg_resources').declare_namespace(__name__)" ) }, }, setup_kwargs=dict( namespace_packages=['foobar'], packages=['foobar'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': [ 'foo-1.0-py{py_version}-nspkg.pth', { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'namespace_packages.txt', 'top_level.txt', ] }, { 'foobar': [ '__init__.py', ] }, ] }), ), dict( id='data_in_package', file_defs={ 'foo': { '__init__.py': '', 'data_dir': { 'data.txt': DALS( """ Some data... """ ), }, } }, setup_kwargs=dict( packages=['foo'], data_files=[('foo/data_dir', ['foo/data_dir/data.txt'])], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt', ], 'foo': [ '__init__.py', { 'data_dir': [ 'data.txt', ] }, ], } }), ), ) @pytest.mark.parametrize( 'params', WHEEL_INSTALL_TESTS, ids=[params['id'] for params in WHEEL_INSTALL_TESTS], ) def test_wheel_install(params): project_name = params.get('name', 'foo') version = params.get('version', '1.0') install_requires = params.get('install_requires', []) extras_require = params.get('extras_require', {}) requires_txt = params.get('requires_txt', None) install_tree = params.get('install_tree') file_defs = params.get('file_defs', {}) setup_kwargs = params.get('setup_kwargs', {}) with ( build_wheel( name=project_name, version=version, install_requires=install_requires, extras_require=extras_require, extra_file_defs=file_defs, **setup_kwargs, ) as filename, tempdir() as install_dir, ): _check_wheel_install( filename, install_dir, install_tree, project_name, version, requires_txt ) def test_wheel_install_pep_503(): project_name = 'Foo_Bar' # PEP 503 canonicalized name is "foo-bar" version = '1.0' with ( build_wheel( name=project_name, version=version, ) as filename, tempdir() as install_dir, ): new_filename = filename.replace(project_name, canonicalize_name(project_name)) shutil.move(filename, new_filename) _check_wheel_install( new_filename, install_dir, None, canonicalize_name(project_name), version, None, ) def test_wheel_no_dist_dir(): project_name = 'nodistinfo' version = '1.0' wheel_name = f'{project_name}-{version}-py2.py3-none-any.whl' with tempdir() as source_dir: wheel_path = os.path.join(source_dir, wheel_name) # create an empty zip file zipfile.ZipFile(wheel_path, 'w').close() with tempdir() as install_dir: with pytest.raises(ValueError): _check_wheel_install( wheel_path, install_dir, None, project_name, version, None ) def test_wheel_is_compatible(monkeypatch): def sys_tags(): return { (t.interpreter, t.abi, t.platform) for t in parse_tag('cp36-cp36m-manylinux1_x86_64') } monkeypatch.setattr('setuptools.wheel._get_supported_tags', sys_tags) assert Wheel('onnxruntime-0.1.2-cp36-cp36m-manylinux1_x86_64.whl').is_compatible() def test_wheel_mode(): @contextlib.contextmanager def build_wheel(extra_file_defs=None, **kwargs): file_defs = { 'setup.py': ( DALS( """ # -*- coding: utf-8 -*- from setuptools import setup import setuptools setup(**%r) """ ) % kwargs ).encode('utf-8'), } if extra_file_defs: file_defs.update(extra_file_defs) with tempdir() as source_dir: path.build(file_defs, source_dir) runsh = pathlib.Path(source_dir) / "script.sh" os.chmod(runsh, 0o777) subprocess.check_call( (sys.executable, 'setup.py', '-q', 'bdist_wheel'), cwd=source_dir ) yield glob.glob(os.path.join(source_dir, 'dist', '*.whl'))[0] params = dict( id='script', file_defs={ 'script.py': DALS( """ #/usr/bin/python print('hello world!') """ ), 'script.sh': DALS( """ #/bin/sh echo 'hello world!' """ ), }, setup_kwargs=dict( scripts=['script.py', 'script.sh'], ), install_tree=flatten_tree({ 'foo-1.0-py{py_version}.egg': { 'EGG-INFO': [ 'PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt', {'scripts': ['script.py', 'script.sh']}, ] } }), ) project_name = params.get('name', 'foo') version = params.get('version', '1.0') install_tree = params.get('install_tree') file_defs = params.get('file_defs', {}) setup_kwargs = params.get('setup_kwargs', {}) with ( build_wheel( name=project_name, version=version, install_requires=[], extras_require={}, extra_file_defs=file_defs, **setup_kwargs, ) as filename, tempdir() as install_dir, ): _check_wheel_install( filename, install_dir, install_tree, project_name, version, None ) w = Wheel(filename) base = pathlib.Path(install_dir) / w.egg_name() script_sh = base / "EGG-INFO" / "scripts" / "script.sh" assert script_sh.exists() if sys.platform != 'win32': # Editable file mode has no effect on Windows assert oct(stat.S_IMODE(script_sh.stat().st_mode)) == "0o777" tests/test_setuptools.py 0000644 00000021460 15030122015 0011530 0 ustar 00 """Tests for the 'setuptools' package""" import os import re import sys from zipfile import ZipFile import pytest from packaging.version import Version import setuptools import setuptools.depends as dep import setuptools.dist from setuptools.depends import Require import distutils.cmd import distutils.core from distutils.core import Extension from distutils.errors import DistutilsSetupError @pytest.fixture(autouse=True) def isolated_dir(tmpdir_cwd): return def makeSetup(**args): """Return distribution from 'setup(**args)', without executing commands""" distutils.core._setup_stop_after = "commandline" # Don't let system command line leak into tests! args.setdefault('script_args', ['install']) try: return setuptools.setup(**args) finally: distutils.core._setup_stop_after = None needs_bytecode = pytest.mark.skipif( not hasattr(dep, 'get_module_constant'), reason="bytecode support not available", ) class TestDepends: def testExtractConst(self): if not hasattr(dep, 'extract_constant'): # skip on non-bytecode platforms return def f1(): global x, y, z x = "test" y = z # pyright: ignore[reportUnboundVariable] # Explicitly testing for this runtime issue fc = f1.__code__ # unrecognized name assert dep.extract_constant(fc, 'q', -1) is None # constant assigned assert dep.extract_constant(fc, 'x', -1) == "test" # expression assigned assert dep.extract_constant(fc, 'y', -1) == -1 # recognized name, not assigned assert dep.extract_constant(fc, 'z', -1) is None def testFindModule(self): with pytest.raises(ImportError): dep.find_module('no-such.-thing') with pytest.raises(ImportError): dep.find_module('setuptools.non-existent') f, _p, _i = dep.find_module('setuptools.tests') f.close() @needs_bytecode def testModuleExtract(self): from json import __version__ assert dep.get_module_constant('json', '__version__') == __version__ assert dep.get_module_constant('sys', 'version') == sys.version assert ( dep.get_module_constant('setuptools.tests.test_setuptools', '__doc__') == __doc__ ) @needs_bytecode def testRequire(self): req = Require('Json', '1.0.3', 'json') assert req.name == 'Json' assert req.module == 'json' assert req.requested_version == Version('1.0.3') assert req.attribute == '__version__' assert req.full_name() == 'Json-1.0.3' from json import __version__ assert str(req.get_version()) == __version__ assert req.version_ok('1.0.9') assert not req.version_ok('0.9.1') assert not req.version_ok('unknown') assert req.is_present() assert req.is_current() req = Require('Do-what-I-mean', '1.0', 'd-w-i-m') assert not req.is_present() assert not req.is_current() @needs_bytecode def test_require_present(self): # In #1896, this test was failing for months with the only # complaint coming from test runners (not end users). # TODO: Evaluate if this code is needed at all. req = Require('Tests', None, 'tests', homepage="http://example.com") assert req.format is None assert req.attribute is None assert req.requested_version is None assert req.full_name() == 'Tests' assert req.homepage == 'http://example.com' from setuptools.tests import __path__ paths = [os.path.dirname(p) for p in __path__] assert req.is_present(paths) assert req.is_current(paths) class TestDistro: def setup_method(self, method): self.e1 = Extension('bar.ext', ['bar.c']) self.e2 = Extension('c.y', ['y.c']) self.dist = makeSetup( packages=['a', 'a.b', 'a.b.c', 'b', 'c'], py_modules=['b.d', 'x'], ext_modules=(self.e1, self.e2), package_dir={}, ) def testDistroType(self): assert isinstance(self.dist, setuptools.dist.Distribution) def testExcludePackage(self): self.dist.exclude_package('a') assert self.dist.packages == ['b', 'c'] self.dist.exclude_package('b') assert self.dist.packages == ['c'] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1, self.e2] self.dist.exclude_package('c') assert self.dist.packages == [] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1] # test removals from unspecified options makeSetup().exclude_package('x') def testIncludeExclude(self): # remove an extension self.dist.exclude(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2] # add it back in self.dist.include(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2, self.e1] # should not add duplicate self.dist.include(ext_modules=[self.e1]) assert self.dist.ext_modules == [self.e2, self.e1] def testExcludePackages(self): self.dist.exclude(packages=['c', 'b', 'a']) assert self.dist.packages == [] assert self.dist.py_modules == ['x'] assert self.dist.ext_modules == [self.e1] def testEmpty(self): dist = makeSetup() dist.include(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) dist = makeSetup() dist.exclude(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) def testContents(self): assert self.dist.has_contents_for('a') self.dist.exclude_package('a') assert not self.dist.has_contents_for('a') assert self.dist.has_contents_for('b') self.dist.exclude_package('b') assert not self.dist.has_contents_for('b') assert self.dist.has_contents_for('c') self.dist.exclude_package('c') assert not self.dist.has_contents_for('c') def testInvalidIncludeExclude(self): with pytest.raises(DistutilsSetupError): self.dist.include(nonexistent_option='x') with pytest.raises(DistutilsSetupError): self.dist.exclude(nonexistent_option='x') with pytest.raises(DistutilsSetupError): self.dist.include(packages={'x': 'y'}) with pytest.raises(DistutilsSetupError): self.dist.exclude(packages={'x': 'y'}) with pytest.raises(DistutilsSetupError): self.dist.include(ext_modules={'x': 'y'}) with pytest.raises(DistutilsSetupError): self.dist.exclude(ext_modules={'x': 'y'}) with pytest.raises(DistutilsSetupError): self.dist.include(package_dir=['q']) with pytest.raises(DistutilsSetupError): self.dist.exclude(package_dir=['q']) @pytest.fixture def example_source(tmpdir): tmpdir.mkdir('foo') (tmpdir / 'foo/bar.py').write('') (tmpdir / 'readme.txt').write('') return tmpdir def test_findall(example_source): found = list(setuptools.findall(str(example_source))) expected = ['readme.txt', 'foo/bar.py'] expected = [example_source.join(fn) for fn in expected] assert found == expected def test_findall_curdir(example_source): with example_source.as_cwd(): found = list(setuptools.findall()) expected = ['readme.txt', os.path.join('foo', 'bar.py')] assert found == expected @pytest.fixture def can_symlink(tmpdir): """ Skip if cannot create a symbolic link """ link_fn = 'link' target_fn = 'target' try: os.symlink(target_fn, link_fn) except (OSError, NotImplementedError, AttributeError): pytest.skip("Cannot create symbolic links") os.remove(link_fn) @pytest.mark.usefixtures("can_symlink") def test_findall_missing_symlink(tmpdir): with tmpdir.as_cwd(): os.symlink('foo', 'bar') found = list(setuptools.findall()) assert found == [] @pytest.mark.xfail(reason="unable to exclude tests; #4475 #3260") def test_its_own_wheel_does_not_contain_tests(setuptools_wheel): with ZipFile(setuptools_wheel) as zipfile: contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] for member in contents: assert '/tests/' not in member def test_wheel_includes_cli_scripts(setuptools_wheel): with ZipFile(setuptools_wheel) as zipfile: contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] assert any('cli-64.exe' in member for member in contents) def test_wheel_includes_vendored_metadata(setuptools_wheel): with ZipFile(setuptools_wheel) as zipfile: contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] assert any( re.search(r'_vendor/.*\.dist-info/METADATA', member) for member in contents ) tests/test_dist.py 0000644 00000021305 15030122015 0010250 0 ustar 00 import os import re import urllib.parse import urllib.request import pytest from setuptools import Distribution from setuptools.dist import check_package_data, check_specifier from .test_easy_install import make_trivial_sdist from .test_find_packages import ensure_files from .textwrap import DALS from distutils.errors import DistutilsSetupError def test_dist_fetch_build_egg(tmpdir): """ Check multiple calls to `Distribution.fetch_build_egg` work as expected. """ index = tmpdir.mkdir('index') index_url = urllib.parse.urljoin('file://', urllib.request.pathname2url(str(index))) def sdist_with_index(distname, version): dist_dir = index.mkdir(distname) dist_sdist = f'{distname}-{version}.tar.gz' make_trivial_sdist(str(dist_dir.join(dist_sdist)), distname, version) with dist_dir.join('index.html').open('w') as fp: fp.write( DALS( """ <!DOCTYPE html><html><body> <a href="{dist_sdist}" rel="internal">{dist_sdist}</a><br/> </body></html> """ ).format(dist_sdist=dist_sdist) ) sdist_with_index('barbazquux', '3.2.0') sdist_with_index('barbazquux-runner', '2.11.1') with tmpdir.join('setup.cfg').open('w') as fp: fp.write( DALS( """ [easy_install] index_url = {index_url} """ ).format(index_url=index_url) ) reqs = """ barbazquux-runner barbazquux """.split() with tmpdir.as_cwd(): dist = Distribution() dist.parse_config_files() resolved_dists = [dist.fetch_build_egg(r) for r in reqs] assert [dist.key for dist in resolved_dists if dist] == reqs EXAMPLE_BASE_INFO = dict( name="package", version="0.0.1", author="Foo Bar", author_email="foo@bar.net", long_description="Long\ndescription", description="Short description", keywords=["one", "two"], ) def test_provides_extras_deterministic_order(): attrs = dict(extras_require=dict(a=['foo'], b=['bar'])) dist = Distribution(attrs) assert list(dist.metadata.provides_extras) == ['a', 'b'] attrs['extras_require'] = dict(reversed(attrs['extras_require'].items())) dist = Distribution(attrs) assert list(dist.metadata.provides_extras) == ['b', 'a'] CHECK_PACKAGE_DATA_TESTS = ( # Valid. ( { '': ['*.txt', '*.rst'], 'hello': ['*.msg'], }, None, ), # Not a dictionary. ( ( ('', ['*.txt', '*.rst']), ('hello', ['*.msg']), ), ( "'package_data' must be a dictionary mapping package" " names to lists of string wildcard patterns" ), ), # Invalid key type. ( { 400: ['*.txt', '*.rst'], }, ("keys of 'package_data' dict must be strings (got 400)"), ), # Invalid value type. ( { 'hello': '*.msg', }, ( "\"values of 'package_data' dict\" must be of type <tuple[str, ...] | list[str]>" " (got '*.msg')" ), ), # Invalid value type (generators are single use) ( { 'hello': (x for x in "generator"), }, ( "\"values of 'package_data' dict\" must be of type <tuple[str, ...] | list[str]>" " (got <generator object" ), ), ) @pytest.mark.parametrize(('package_data', 'expected_message'), CHECK_PACKAGE_DATA_TESTS) def test_check_package_data(package_data, expected_message): if expected_message is None: assert check_package_data(None, 'package_data', package_data) is None else: with pytest.raises(DistutilsSetupError, match=re.escape(expected_message)): check_package_data(None, 'package_data', package_data) def test_check_specifier(): # valid specifier value attrs = {'name': 'foo', 'python_requires': '>=3.0, !=3.1'} dist = Distribution(attrs) check_specifier(dist, attrs, attrs['python_requires']) attrs = {'name': 'foo', 'python_requires': ['>=3.0', '!=3.1']} dist = Distribution(attrs) check_specifier(dist, attrs, attrs['python_requires']) # invalid specifier value attrs = {'name': 'foo', 'python_requires': '>=invalid-version'} with pytest.raises(DistutilsSetupError): dist = Distribution(attrs) def test_metadata_name(): with pytest.raises(DistutilsSetupError, match='missing.*name'): Distribution()._validate_metadata() @pytest.mark.parametrize( ('dist_name', 'py_module'), [ ("my.pkg", "my_pkg"), ("my-pkg", "my_pkg"), ("my_pkg", "my_pkg"), ("pkg", "pkg"), ], ) def test_dist_default_py_modules(tmp_path, dist_name, py_module): (tmp_path / f"{py_module}.py").touch() (tmp_path / "setup.py").touch() (tmp_path / "noxfile.py").touch() # ^-- make sure common tool files are ignored attrs = {**EXAMPLE_BASE_INFO, "name": dist_name, "src_root": str(tmp_path)} # Find `py_modules` corresponding to dist_name if not given dist = Distribution(attrs) dist.set_defaults() assert dist.py_modules == [py_module] # When `py_modules` is given, don't do anything dist = Distribution({**attrs, "py_modules": ["explicity_py_module"]}) dist.set_defaults() assert dist.py_modules == ["explicity_py_module"] # When `packages` is given, don't do anything dist = Distribution({**attrs, "packages": ["explicity_package"]}) dist.set_defaults() assert not dist.py_modules @pytest.mark.parametrize( ('dist_name', 'package_dir', 'package_files', 'packages'), [ ("my.pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), ("my-pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), ("my_pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), ("my.pkg", None, ["my/pkg/__init__.py"], ["my", "my.pkg"]), ( "my_pkg", None, ["src/my_pkg/__init__.py", "src/my_pkg2/__init__.py"], ["my_pkg", "my_pkg2"], ), ( "my_pkg", {"pkg": "lib", "pkg2": "lib2"}, ["lib/__init__.py", "lib/nested/__init__.pyt", "lib2/__init__.py"], ["pkg", "pkg.nested", "pkg2"], ), ], ) def test_dist_default_packages( tmp_path, dist_name, package_dir, package_files, packages ): ensure_files(tmp_path, package_files) (tmp_path / "setup.py").touch() (tmp_path / "noxfile.py").touch() # ^-- should not be included by default attrs = { **EXAMPLE_BASE_INFO, "name": dist_name, "src_root": str(tmp_path), "package_dir": package_dir, } # Find `packages` either corresponding to dist_name or inside src dist = Distribution(attrs) dist.set_defaults() assert not dist.py_modules assert not dist.py_modules assert set(dist.packages) == set(packages) # When `py_modules` is given, don't do anything dist = Distribution({**attrs, "py_modules": ["explicit_py_module"]}) dist.set_defaults() assert not dist.packages assert set(dist.py_modules) == {"explicit_py_module"} # When `packages` is given, don't do anything dist = Distribution({**attrs, "packages": ["explicit_package"]}) dist.set_defaults() assert not dist.py_modules assert set(dist.packages) == {"explicit_package"} @pytest.mark.parametrize( ('dist_name', 'package_dir', 'package_files'), [ ("my.pkg.nested", None, ["my/pkg/nested/__init__.py"]), ("my.pkg", None, ["my/pkg/__init__.py", "my/pkg/file.py"]), ("my_pkg", None, ["my_pkg.py"]), ("my_pkg", None, ["my_pkg/__init__.py", "my_pkg/nested/__init__.py"]), ("my_pkg", None, ["src/my_pkg/__init__.py", "src/my_pkg/nested/__init__.py"]), ( "my_pkg", {"my_pkg": "lib", "my_pkg.lib2": "lib2"}, ["lib/__init__.py", "lib/nested/__init__.pyt", "lib2/__init__.py"], ), # Should not try to guess a name from multiple py_modules/packages ("UNKNOWN", None, ["src/mod1.py", "src/mod2.py"]), ("UNKNOWN", None, ["src/pkg1/__ini__.py", "src/pkg2/__init__.py"]), ], ) def test_dist_default_name(tmp_path, dist_name, package_dir, package_files): """Make sure dist.name is discovered from packages/py_modules""" ensure_files(tmp_path, package_files) attrs = { **EXAMPLE_BASE_INFO, "src_root": "/".join(os.path.split(tmp_path)), # POSIX-style "package_dir": package_dir, } del attrs["name"] dist = Distribution(attrs) dist.set_defaults() assert dist.py_modules or dist.packages assert dist.get_name() == dist_name tests/test_archive_util.py 0000644 00000001515 15030122015 0011764 0 ustar 00 import io import tarfile import pytest from setuptools import archive_util @pytest.fixture def tarfile_with_unicode(tmpdir): """ Create a tarfile containing only a file whose name is a zero byte file called testimäge.png. """ tarobj = io.BytesIO() with tarfile.open(fileobj=tarobj, mode="w:gz") as tgz: data = b"" filename = "testimäge.png" t = tarfile.TarInfo(filename) t.size = len(data) tgz.addfile(t, io.BytesIO(data)) target = tmpdir / 'unicode-pkg-1.0.tar.gz' with open(str(target), mode='wb') as tf: tf.write(tarobj.getvalue()) return str(target) @pytest.mark.xfail(reason="#710 and #712") def test_unicode_files(tarfile_with_unicode, tmpdir): target = tmpdir / 'out' archive_util.unpack_archive(tarfile_with_unicode, str(target)) tests/test_find_py_modules.py 0000644 00000004544 15030122015 0012473 0 ustar 00 """Tests for automatic discovery of modules""" import os import pytest from setuptools.discovery import FlatLayoutModuleFinder, ModuleFinder from .compat.py39 import os_helper from .test_find_packages import ensure_files class TestModuleFinder: def find(self, path, *args, **kwargs): return set(ModuleFinder.find(str(path), *args, **kwargs)) EXAMPLES = { # circumstance: (files, kwargs, expected_modules) "simple_folder": ( ["file.py", "other.py"], {}, # kwargs ["file", "other"], ), "exclude": ( ["file.py", "other.py"], {"exclude": ["f*"]}, ["other"], ), "include": ( ["file.py", "fole.py", "other.py"], {"include": ["f*"], "exclude": ["fo*"]}, ["file"], ), "invalid-name": (["my-file.py", "other.file.py"], {}, []), } @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_finder(self, tmp_path, example): files, kwargs, expected_modules = self.EXAMPLES[example] ensure_files(tmp_path, files) assert self.find(tmp_path, **kwargs) == set(expected_modules) @pytest.mark.skipif(not os_helper.can_symlink(), reason='Symlink support required') def test_symlinked_packages_are_included(self, tmp_path): src = "_myfiles/file.py" ensure_files(tmp_path, [src]) os.symlink(tmp_path / src, tmp_path / "link.py") assert self.find(tmp_path) == {"link"} class TestFlatLayoutModuleFinder: def find(self, path, *args, **kwargs): return set(FlatLayoutModuleFinder.find(str(path))) EXAMPLES = { # circumstance: (files, expected_modules) "hidden-files": ([".module.py"], []), "private-modules": (["_module.py"], []), "common-names": ( ["setup.py", "conftest.py", "test.py", "tests.py", "example.py", "mod.py"], ["mod"], ), "tool-specific": ( ["tasks.py", "fabfile.py", "noxfile.py", "dodo.py", "manage.py", "mod.py"], ["mod"], ), } @pytest.mark.parametrize("example", EXAMPLES.keys()) def test_unwanted_files_not_included(self, tmp_path, example): files, expected_modules = self.EXAMPLES[example] ensure_files(tmp_path, files) assert self.find(tmp_path) == set(expected_modules) tests/textwrap.py 0000644 00000000142 15030122015 0010120 0 ustar 00 import textwrap def DALS(s): "dedent and left-strip" return textwrap.dedent(s).lstrip() tests/test_glob.py 0000644 00000001567 15030122015 0010240 0 ustar 00 import pytest from jaraco import path from setuptools.glob import glob @pytest.mark.parametrize( ('tree', 'pattern', 'matches'), ( ('', b'', []), ('', '', []), ( """ appveyor.yml CHANGES.rst LICENSE MANIFEST.in pyproject.toml README.rst setup.cfg setup.py """, '*.rst', ('CHANGES.rst', 'README.rst'), ), ( """ appveyor.yml CHANGES.rst LICENSE MANIFEST.in pyproject.toml README.rst setup.cfg setup.py """, b'*.rst', (b'CHANGES.rst', b'README.rst'), ), ), ) def test_glob(monkeypatch, tmpdir, tree, pattern, matches): monkeypatch.chdir(tmpdir) path.build({name: '' for name in tree.split()}) assert list(sorted(glob(pattern))) == list(sorted(matches)) tests/test_manifest.py 0000644 00000044202 15030122015 0011114 0 ustar 00 """sdist tests""" from __future__ import annotations import contextlib import io import itertools import logging import os import shutil import sys import tempfile import pytest from setuptools.command.egg_info import FileList, egg_info, translate_pattern from setuptools.dist import Distribution from setuptools.tests.textwrap import DALS from distutils import log from distutils.errors import DistutilsTemplateError IS_PYPY = '__pypy__' in sys.builtin_module_names def make_local_path(s): """Converts '/' in a string to os.sep""" return s.replace('/', os.sep) SETUP_ATTRS = { 'name': 'app', 'version': '0.0', 'packages': ['app'], } SETUP_PY = f"""\ from setuptools import setup setup(**{SETUP_ATTRS!r}) """ @contextlib.contextmanager def quiet(): old_stdout, old_stderr = sys.stdout, sys.stderr sys.stdout, sys.stderr = io.StringIO(), io.StringIO() try: yield finally: sys.stdout, sys.stderr = old_stdout, old_stderr def touch(filename): open(filename, 'wb').close() # The set of files always in the manifest, including all files in the # .egg-info directory default_files = frozenset( map( make_local_path, [ 'README.rst', 'MANIFEST.in', 'setup.py', 'app.egg-info/PKG-INFO', 'app.egg-info/SOURCES.txt', 'app.egg-info/dependency_links.txt', 'app.egg-info/top_level.txt', 'app/__init__.py', ], ) ) translate_specs: list[tuple[str, list[str], list[str]]] = [ ('foo', ['foo'], ['bar', 'foobar']), ('foo/bar', ['foo/bar'], ['foo/bar/baz', './foo/bar', 'foo']), # Glob matching ('*.txt', ['foo.txt', 'bar.txt'], ['foo/foo.txt']), ('dir/*.txt', ['dir/foo.txt', 'dir/bar.txt', 'dir/.txt'], ['notdir/foo.txt']), ('*/*.py', ['bin/start.py'], []), ('docs/page-?.txt', ['docs/page-9.txt'], ['docs/page-10.txt']), # Globstars change what they mean depending upon where they are ( 'foo/**/bar', ['foo/bing/bar', 'foo/bing/bang/bar', 'foo/bar'], ['foo/abar'], ), ( 'foo/**', ['foo/bar/bing.py', 'foo/x'], ['/foo/x'], ), ( '**', ['x', 'abc/xyz', '@nything'], [], ), # Character classes ( 'pre[one]post', ['preopost', 'prenpost', 'preepost'], ['prepost', 'preonepost'], ), ( 'hello[!one]world', ['helloxworld', 'helloyworld'], ['hellooworld', 'helloworld', 'hellooneworld'], ), ( '[]one].txt', ['o.txt', '].txt', 'e.txt'], ['one].txt'], ), ( 'foo[!]one]bar', ['fooybar'], ['foo]bar', 'fooobar', 'fooebar'], ), ] """ A spec of inputs for 'translate_pattern' and matches and mismatches for that input. """ match_params = itertools.chain.from_iterable( zip(itertools.repeat(pattern), matches) for pattern, matches, mismatches in translate_specs ) @pytest.fixture(params=match_params) def pattern_match(request): return map(make_local_path, request.param) mismatch_params = itertools.chain.from_iterable( zip(itertools.repeat(pattern), mismatches) for pattern, matches, mismatches in translate_specs ) @pytest.fixture(params=mismatch_params) def pattern_mismatch(request): return map(make_local_path, request.param) def test_translated_pattern_match(pattern_match): pattern, target = pattern_match assert translate_pattern(pattern).match(target) def test_translated_pattern_mismatch(pattern_mismatch): pattern, target = pattern_mismatch assert not translate_pattern(pattern).match(target) class TempDirTestCase: def setup_method(self, method): self.temp_dir = tempfile.mkdtemp() self.old_cwd = os.getcwd() os.chdir(self.temp_dir) def teardown_method(self, method): os.chdir(self.old_cwd) shutil.rmtree(self.temp_dir) class TestManifestTest(TempDirTestCase): def setup_method(self, method): super().setup_method(method) f = open(os.path.join(self.temp_dir, 'setup.py'), 'w', encoding="utf-8") f.write(SETUP_PY) f.close() """ Create a file tree like: - LICENSE - README.rst - testing.rst - .hidden.rst - app/ - __init__.py - a.txt - b.txt - c.rst - static/ - app.js - app.js.map - app.css - app.css.map """ for fname in ['README.rst', '.hidden.rst', 'testing.rst', 'LICENSE']: touch(os.path.join(self.temp_dir, fname)) # Set up the rest of the test package test_pkg = os.path.join(self.temp_dir, 'app') os.mkdir(test_pkg) for fname in ['__init__.py', 'a.txt', 'b.txt', 'c.rst']: touch(os.path.join(test_pkg, fname)) # Some compiled front-end assets to include static = os.path.join(test_pkg, 'static') os.mkdir(static) for fname in ['app.js', 'app.js.map', 'app.css', 'app.css.map']: touch(os.path.join(static, fname)) def make_manifest(self, contents): """Write a MANIFEST.in.""" manifest = os.path.join(self.temp_dir, 'MANIFEST.in') with open(manifest, 'w', encoding="utf-8") as f: f.write(DALS(contents)) def get_files(self): """Run egg_info and get all the files to include, as a set""" dist = Distribution(SETUP_ATTRS) dist.script_name = 'setup.py' cmd = egg_info(dist) cmd.ensure_finalized() cmd.run() return set(cmd.filelist.files) def test_no_manifest(self): """Check a missing MANIFEST.in includes only the standard files.""" assert (default_files - set(['MANIFEST.in'])) == self.get_files() def test_empty_files(self): """Check an empty MANIFEST.in includes only the standard files.""" self.make_manifest("") assert default_files == self.get_files() def test_include(self): """Include extra rst files in the project root.""" self.make_manifest("include *.rst") files = default_files | set(['testing.rst', '.hidden.rst']) assert files == self.get_files() def test_exclude(self): """Include everything in app/ except the text files""" ml = make_local_path self.make_manifest( """ include app/* exclude app/*.txt """ ) files = default_files | set([ml('app/c.rst')]) assert files == self.get_files() def test_include_multiple(self): """Include with multiple patterns.""" ml = make_local_path self.make_manifest("include app/*.txt app/static/*") files = default_files | set([ ml('app/a.txt'), ml('app/b.txt'), ml('app/static/app.js'), ml('app/static/app.js.map'), ml('app/static/app.css'), ml('app/static/app.css.map'), ]) assert files == self.get_files() def test_graft(self): """Include the whole app/static/ directory.""" ml = make_local_path self.make_manifest("graft app/static") files = default_files | set([ ml('app/static/app.js'), ml('app/static/app.js.map'), ml('app/static/app.css'), ml('app/static/app.css.map'), ]) assert files == self.get_files() def test_graft_glob_syntax(self): """Include the whole app/static/ directory.""" ml = make_local_path self.make_manifest("graft */static") files = default_files | set([ ml('app/static/app.js'), ml('app/static/app.js.map'), ml('app/static/app.css'), ml('app/static/app.css.map'), ]) assert files == self.get_files() def test_graft_global_exclude(self): """Exclude all *.map files in the project.""" ml = make_local_path self.make_manifest( """ graft app/static global-exclude *.map """ ) files = default_files | set([ml('app/static/app.js'), ml('app/static/app.css')]) assert files == self.get_files() def test_global_include(self): """Include all *.rst, *.js, and *.css files in the whole tree.""" ml = make_local_path self.make_manifest( """ global-include *.rst *.js *.css """ ) files = default_files | set([ '.hidden.rst', 'testing.rst', ml('app/c.rst'), ml('app/static/app.js'), ml('app/static/app.css'), ]) assert files == self.get_files() def test_graft_prune(self): """Include all files in app/, except for the whole app/static/ dir.""" ml = make_local_path self.make_manifest( """ graft app prune app/static """ ) files = default_files | set([ml('app/a.txt'), ml('app/b.txt'), ml('app/c.rst')]) assert files == self.get_files() class TestFileListTest(TempDirTestCase): """ A copy of the relevant bits of distutils/tests/test_filelist.py, to ensure setuptools' version of FileList keeps parity with distutils. """ @pytest.fixture(autouse=os.getenv("SETUPTOOLS_USE_DISTUTILS") == "stdlib") def _compat_record_logs(self, monkeypatch, caplog): """Account for stdlib compatibility""" def _log(_logger, level, msg, args): exc = sys.exc_info() rec = logging.LogRecord("distutils", level, "", 0, msg, args, exc) caplog.records.append(rec) monkeypatch.setattr(log.Log, "_log", _log) def get_records(self, caplog, *levels): return [r for r in caplog.records if r.levelno in levels] def assertNoWarnings(self, caplog): assert self.get_records(caplog, log.WARN) == [] caplog.clear() def assertWarnings(self, caplog): if IS_PYPY and not caplog.records: pytest.xfail("caplog checks may not work well in PyPy") else: assert len(self.get_records(caplog, log.WARN)) > 0 caplog.clear() def make_files(self, files): for file in files: file = os.path.join(self.temp_dir, file) dirname, _basename = os.path.split(file) os.makedirs(dirname, exist_ok=True) touch(file) def test_process_template_line(self): # testing all MANIFEST.in template patterns file_list = FileList() ml = make_local_path # simulated file list self.make_files([ 'foo.tmp', 'ok', 'xo', 'four.txt', 'buildout.cfg', # filelist does not filter out VCS directories, # it's sdist that does ml('.hg/last-message.txt'), ml('global/one.txt'), ml('global/two.txt'), ml('global/files.x'), ml('global/here.tmp'), ml('f/o/f.oo'), ml('dir/graft-one'), ml('dir/dir2/graft2'), ml('dir3/ok'), ml('dir3/sub/ok.txt'), ]) MANIFEST_IN = DALS( """\ include ok include xo exclude xo include foo.tmp include buildout.cfg global-include *.x global-include *.txt global-exclude *.tmp recursive-include f *.oo recursive-exclude global *.x graft dir prune dir3 """ ) for line in MANIFEST_IN.split('\n'): if not line: continue file_list.process_template_line(line) wanted = [ 'buildout.cfg', 'four.txt', 'ok', ml('.hg/last-message.txt'), ml('dir/graft-one'), ml('dir/dir2/graft2'), ml('f/o/f.oo'), ml('global/one.txt'), ml('global/two.txt'), ] file_list.sort() assert file_list.files == wanted def test_exclude_pattern(self): # return False if no match file_list = FileList() assert not file_list.exclude_pattern('*.py') # return True if files match file_list = FileList() file_list.files = ['a.py', 'b.py'] assert file_list.exclude_pattern('*.py') # test excludes file_list = FileList() file_list.files = ['a.py', 'a.txt'] file_list.exclude_pattern('*.py') file_list.sort() assert file_list.files == ['a.txt'] def test_include_pattern(self): # return False if no match file_list = FileList() self.make_files([]) assert not file_list.include_pattern('*.py') # return True if files match file_list = FileList() self.make_files(['a.py', 'b.txt']) assert file_list.include_pattern('*.py') # test * matches all files file_list = FileList() self.make_files(['a.py', 'b.txt']) file_list.include_pattern('*') file_list.sort() assert file_list.files == ['a.py', 'b.txt'] def test_process_template_line_invalid(self): # invalid lines file_list = FileList() for action in ( 'include', 'exclude', 'global-include', 'global-exclude', 'recursive-include', 'recursive-exclude', 'graft', 'prune', 'blarg', ): with pytest.raises(DistutilsTemplateError): file_list.process_template_line(action) def test_include(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # include file_list = FileList() self.make_files(['a.py', 'b.txt', ml('d/c.py')]) file_list.process_template_line('include *.py') file_list.sort() assert file_list.files == ['a.py'] self.assertNoWarnings(caplog) file_list.process_template_line('include *.rb') file_list.sort() assert file_list.files == ['a.py'] self.assertWarnings(caplog) def test_exclude(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # exclude file_list = FileList() file_list.files = ['a.py', 'b.txt', ml('d/c.py')] file_list.process_template_line('exclude *.py') file_list.sort() assert file_list.files == ['b.txt', ml('d/c.py')] self.assertNoWarnings(caplog) file_list.process_template_line('exclude *.rb') file_list.sort() assert file_list.files == ['b.txt', ml('d/c.py')] self.assertWarnings(caplog) def test_global_include(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # global-include file_list = FileList() self.make_files(['a.py', 'b.txt', ml('d/c.py')]) file_list.process_template_line('global-include *.py') file_list.sort() assert file_list.files == ['a.py', ml('d/c.py')] self.assertNoWarnings(caplog) file_list.process_template_line('global-include *.rb') file_list.sort() assert file_list.files == ['a.py', ml('d/c.py')] self.assertWarnings(caplog) def test_global_exclude(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # global-exclude file_list = FileList() file_list.files = ['a.py', 'b.txt', ml('d/c.py')] file_list.process_template_line('global-exclude *.py') file_list.sort() assert file_list.files == ['b.txt'] self.assertNoWarnings(caplog) file_list.process_template_line('global-exclude *.rb') file_list.sort() assert file_list.files == ['b.txt'] self.assertWarnings(caplog) def test_recursive_include(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # recursive-include file_list = FileList() self.make_files(['a.py', ml('d/b.py'), ml('d/c.txt'), ml('d/d/e.py')]) file_list.process_template_line('recursive-include d *.py') file_list.sort() assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] self.assertNoWarnings(caplog) file_list.process_template_line('recursive-include e *.py') file_list.sort() assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] self.assertWarnings(caplog) def test_recursive_exclude(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # recursive-exclude file_list = FileList() file_list.files = ['a.py', ml('d/b.py'), ml('d/c.txt'), ml('d/d/e.py')] file_list.process_template_line('recursive-exclude d *.py') file_list.sort() assert file_list.files == ['a.py', ml('d/c.txt')] self.assertNoWarnings(caplog) file_list.process_template_line('recursive-exclude e *.py') file_list.sort() assert file_list.files == ['a.py', ml('d/c.txt')] self.assertWarnings(caplog) def test_graft(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # graft file_list = FileList() self.make_files(['a.py', ml('d/b.py'), ml('d/d/e.py'), ml('f/f.py')]) file_list.process_template_line('graft d') file_list.sort() assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] self.assertNoWarnings(caplog) file_list.process_template_line('graft e') file_list.sort() assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] self.assertWarnings(caplog) def test_prune(self, caplog): caplog.set_level(logging.DEBUG) ml = make_local_path # prune file_list = FileList() file_list.files = ['a.py', ml('d/b.py'), ml('d/d/e.py'), ml('f/f.py')] file_list.process_template_line('prune d') file_list.sort() assert file_list.files == ['a.py', ml('f/f.py')] self.assertNoWarnings(caplog) file_list.process_template_line('prune e') file_list.sort() assert file_list.files == ['a.py', ml('f/f.py')] self.assertWarnings(caplog) tests/server.py 0000644 00000004535 15030122015 0007562 0 ustar 00 """Basic http server for tests to simulate PyPI or custom indexes""" import http.server import os import threading import time import urllib.parse import urllib.request class IndexServer(http.server.HTTPServer): """Basic single-threaded http server simulating a package index You can use this server in unittest like this:: s = IndexServer() s.start() index_url = s.base_url() + 'mytestindex' # do some test requests to the index # The index files should be located in setuptools/tests/indexes s.stop() """ def __init__( self, server_address=('', 0), RequestHandlerClass=http.server.SimpleHTTPRequestHandler, ): http.server.HTTPServer.__init__(self, server_address, RequestHandlerClass) self._run = True def start(self): self.thread = threading.Thread(target=self.serve_forever) self.thread.start() def stop(self): "Stop the server" # Let the server finish the last request and wait for a new one. time.sleep(0.1) self.shutdown() self.thread.join() self.socket.close() def base_url(self): port = self.server_port return f'http://127.0.0.1:{port}/setuptools/tests/indexes/' class RequestRecorder(http.server.BaseHTTPRequestHandler): def do_GET(self): requests = vars(self.server).setdefault('requests', []) requests.append(self) self.send_response(200, 'OK') class MockServer(http.server.HTTPServer, threading.Thread): """ A simple HTTP Server that records the requests made to it. """ def __init__(self, server_address=('', 0), RequestHandlerClass=RequestRecorder): http.server.HTTPServer.__init__(self, server_address, RequestHandlerClass) threading.Thread.__init__(self) self.daemon = True self.requests = [] def run(self): self.serve_forever() @property def netloc(self): return f'localhost:{self.server_port}' @property def url(self): return f'http://{self.netloc}/' def path_to_url(path, authority=None): """Convert a path to a file: URL.""" path = os.path.normpath(os.path.abspath(path)) base = 'file:' if authority is not None: base += '//' + authority return urllib.parse.urljoin(base, urllib.request.pathname2url(path)) tests/__init__.py 0000644 00000000517 15030122015 0010007 0 ustar 00 import locale import sys import pytest __all__ = ['fail_on_ascii'] if sys.version_info >= (3, 11): locale_encoding = locale.getencoding() else: locale_encoding = locale.getpreferredencoding(False) is_ascii = locale_encoding == 'ANSI_X3.4-1968' fail_on_ascii = pytest.mark.xfail(is_ascii, reason="Test fails in this locale") cli-arm64.exe 0000644 00000033000 15030122015 0006726 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ ���b���1���1���1��1���1��0���1�x1���1��0���1��0���1��0���1�0���1���1���1���0���1��z1���1���0���1Rich���1 PE d� �'hd � " $ @ � `� �8 � p � ` � $ �4 p3 @ 0 .text 4 `.rdata � 0 @ @.data � P . @ �.pdata ` 0 @ @.rsrc � p 2 @ @.reloc $ � 4 @ B �C �1 �1@��c1�� ��_� 1 ��@�1@��c0� � T�C ��_� ��� �{��C � ��{A��_� 0 �" �@� �A T�_�{��� �0 �" �1 �1 �@�1@��G�! � >� � ( � ��_� �{��� � 5( � !@�� 4 � @� �R ?� �R�{���_� �S��� ������ ��{��� �� ����� ��� @� �������� ��@� ?�{��� @��SŨ�_� �S���[��c��{��� �� �i�9�����*i 4 �8�5� � q� T�" �� Q �@�i�9� �i 4I �8�5I K) ! Q���5 �i@�! �� |@�� Q ?� �a ���� �& �i�9���" �� 4 �8�5�" �˟ q- T �@� �3��r � �ɂ_�*�9� �j 4 �8�5 K � QU��5���{���cB��[A��Sè�_� �R� �S���[��c��k��# ��{��� �� �i�9����i 4 �8�5 � �i@��� ?� � ��@���� � �`�9 �R �R ?� 4 �` �8(�@� ?֠��5 � �t�8� 4h�@��* ?�@ 4 4�rqa T� ����� q T� ra T_ q�� q���~� 4�*� �R��r ��B6� �R���4� 8�� 4�*� �R��h ��B6� �R� 8���( � �( �{(�� 4`�9(�@� ?� 4 �` �8��@� ?֠��5h�9H��5���{���#@��kC��cB��[A��SŨ�_��S���[��c�� ��{��� �� �i�9��i 4 �8�5˨z� � �i@�! �� ?�X�R �R� �� 9� �� q� T� �Rh�9 qqa T� � qa T� q� T�*� �R��$ ��B6� �R� 8 �Rh�8� Q� 8u��5� q� T�*� �R�� ��B6�� y���{���@��cB��[A��SĨ�_�{���S��[��c��k��+ �� �������� �@�� *���* �R�� �� ?� �@� ���Rd �R ��" �R �R�� ?� �@� �R �R�� ?���9��i 4 �8�5�� ���(��� �) T�� �9_� q� T 9 � �H��T 9 �� ���9��j 4* �8�5��R* 9)� �8*i(8��5 �R�� �� *� 1a T ��@�@ �R ?� �� �������@ �R ��� ��* �� �� ��* �� � � � �� T �9? q$Jz$Mz!��T 9 � � �A�B ��� � ?� 4 � ! �(@��W�( @���(1�9�� 9�S �� ���� �@���9��) 4� �R�� �?� qA Tj 9 �9I��5 �Y@��������C ��� ?��C�9h 5��9 qq T �Y@��������C ��� ?���9��i 4 �8�5�� ���*�H � �9?qq� TI��8H �?qq T�� � T 9 ��8_qqa��T �]@� �������C ��� ?� �i@�! �Ҁ �� ?��� �i@�! �Ҁ �� ?��� ��@�� �� � ?֗ � ��@�@ �R@� ?� �a ���!���@ �R| �@��Һ H@� � �i@� ?� ������6# � � q- T # �x Q� �`�@���� Q�� ����5������" �� �� q Ts" �� Q`�@����� Q � ����5 ������ 4 ��@� ?� ��@�@ �R ?� � �����@ �RG �*� ������ O��� �! �R� �=� �� OA �A�A�a � �R�C � � a� �@� ?�� �� ���� � �@� �� �� �R$ �R �� ���� �� ?�@ 5 ��@�@ �R ?� �A ����� �R �3@�( � ! � � @��@� � ?� � @��@��S � ?�@ 5 ��@�@ �R ?� �� ����� �R �@����f����+@��kD��cC��[B��SA��{ƨ�_��S��� ������ ��{��� �� ����� �~��� @����� ���� @� ��@� �� ?� q ��Z�{��� @��SŨ�_� #�{��� �h @��� �~�(ia�(�� ! �L��� �R�{���#�_� #�� ��{��� � �R� �� �� �� �� *� � � �R� � S� 42 � � !�k �� �� �� 5� �� �� 4 � � �} �� �� �� �� �� � SH 4{ �� �� �� 5�{���A��#�_�� �R� � >� #�{��� �� � �R�{���#�_�#�{��� �� �� �� ��{���#�_� #��S��� ��{��� � �R� � SH 4 �R�C 9i � S3 �h*@� q� Th 5( �Rh* � �� � � ! �N �` 4� �RB � � � ��C �H �Rh* � 5 �R�C 9�*� �� �� �h@�� �� � SH 4h@� ��A �R ���� �1 A� ?��?�t �� �h@�� �� � Sh 4`@�8 � �� � � @� � @�����E���� *i � S( 4U 5# � �R �R� ��* � *^ � S 4�C@9H 5 ��*�{¨� @��S¨�#�_�� �RM �� �RK ��* ��* � >� #�{��� �� ������{���#�_�#�{��� �� �� 4�� @�( � � � ?�` TH�_�h �I�ȱ��5�;�(��� �R�{���#�_� �R���#�{��� �) �(�@9 q�(� 9� �� � Sh 5 �R � � S� 5 �R� ���� �R�{���#�_�#��S���{��� �3 �h�A9� *h 5� q� T� �� 4t 5( � � �� �� 5( � A�� �� 4 �R ( �� � �� % � �( �A� % � �( �Rh�9 �R�{���S���#�_֠ �R� � >�#�{��� ��I�R�� �h@y k� Th=@�j�(� ��RH@� k! TH1@y -q� T �H)@y �a �I @y ��+! �� � �@ T @��A*� T @�) �A)� T� ���� ��h � �R %@�h �6 �R �R �R �R�{¨�#�_� #�� ��{��� � S1 �� 4� 5 �� � ��ȿ;�{���A��#�_�#�� ��{��� � ��@9 S) SH 4� 5�*c ��*a � �R�{���A��#�_� #�� ��{��� � �( @�� � �a TY � �� � �R � q`���{���A��#�_�#�{��� ��� ���Z�{���#�_� #��S���{��� � �h@� X � T� � �)@��c � ?��@�� � �%@� ?�� @� |@�(�� � �!@� ?�� @� |@�� �(�� � �-@� ?��@��#@� � �� @�)��C �(� �@�?� X��h ��(� � ��{è�S���#�_� �2��-�+ 3��-�+ �R�_� �R�_� �R�_� � �� �1@� � �_� � ��_� #�{��� �������� @�(� �� @�� ��{���#�_� �@� q���_� � A��_� � !��_� ` >�_��� #�{��� � �9@� �� ?֠ � @y�I�R k! T<@� ��R �(�H@� ka TH1@y -q TH�@� 9 q� TH�@� q�� �R�{���#�_� � !� �5@� � #��S���{��� �� ��@�� h@� k� Th@� q! Ti"@�� (K q) TH ?k� T �R�{���S���#�_�Q � ��@�Q � �� � >� �csm� � @� #��S���{��� � � � � �� �(! �3! � �B Th�@�� ��� �1 A� ?��?����T�{���S���#�_� #��S���{��� � � � � � �(! �3! � �B Th�@�� ��� �1 A� ?��?����T�{���S���#�_� �C �� �@ �R` >�C ��_� �@� q���_� �F@� � �B@� � �J@� � �N@� � ��@� � ��@� � ��@� � ��@� � �z@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � �r@� � �f@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � �R@� �#�{����� �( @� @����� �{���#�_�a �#�{���� @� @�� ?k���{���#�_�a � � �; �; �; �; < < .< F< ^@ t@ �@ D@ �@ �@ �@ z< p< �< �< �@ �< �< �> �< �> �= ? > H> R> \> �= �= > �> �> 2> ? �< = *> �= �= |= �> D= ? ,? $? *= = �> :> r= h= ^= �" @ � @ �& @ 8 @ X @ @ failed to create process. failed to get exit code from process. %s %s -script.py Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s �P @ 0Q @ @ P @ 2 @ 2 @ 2 @ (2 @ �'hd h 5 ! � .text � .text$mn �& d .text$x 0 .idata$5 2 .00cfg 02 .CRT$XCA 82 .CRT$XCAA @2 .CRT$XCZ H2 .CRT$XIA P2 .CRT$XIAA X2 .CRT$XIAC `2 .CRT$XIZ h2 .CRT$XPA p2 .CRT$XPZ x2 .CRT$XTA �2 .CRT$XTZ �2 p .rdata 5 h .rdata$zzzdbg h7 .rtc$IAA p7 .rtc$IZZ x7 .rtc$TAA �7 .rtc$TZZ �7 8 .xdata �8 � .idata$2 �9 .idata$3 �9 .idata$4 �; F .idata$6 P .data P � .bss ` .pdata p ` .rsrc$01 `p � .rsrc$02 `"����Ђ*�Ђ*��� `"����Ђ*�Ђ*���^0 �� Ɉ�Ȅ������ ���� @ � �� @ @ ���� @ �B�B� / @( @ ������k P] @ �Ђ$���h% � � �& � � �& � @ ���� @ @ �� �� 5 p��h% � \ ' \ @ ���� @ @ ��* @# @ �"�����% @ @ �"����� � �9 b< 0 : �< �0 h: 6? �0 P: V? �0 �: |? 1 H; �? �1 �; �? �1 �: �? �0 �: @ �0 �: "@ 1 �; �; �; �; < < .< F< ^@ t@ �@ D@ �@ �@ �@ z< p< �< �< �@ �< �< �> �< �> �= ? > H> R> \> �= �= > �> �> 2> ? �< = *> �= �= |= �> D= ? ,? $? *= = �> :> r= h= ^= � CreateFileA iGetFinalPathNameByHandleA WaitForSingleObject VGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll = memset __C_specific_handler __current_exception __current_exception_context VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace @ _seh_filter_exe B _set_app_type __setusermatherr _configure_narrow_argv 3 _initialize_narrow_environment ( _get_initial_narrow_environment 6 _initterm 7 _initterm_e U exit # _exit T _set_fmode _cexit _c_exit = _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 4 _initialize_onexit_table < _register_onexit_function _crt_atexit g terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll kQueryPerformanceCounter 2GetCurrentProcessId 6GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �SetUnhandledExceptionFilter �GetModuleHandleW ; memcpy �] �f��2��-�+ ���� �7 �7 P �7 p L8 � X8 � �8 � 5 � �7 p %f� �i0 �0 �7 � �7 = � X �7 ! � 8 % � ` 8 ! � 0 �8 � a � � �8 � `8 p A A� M A ! Q AP! % � x! � B�" = � 0# � � �# �8 `$ e B�$ e B0% � �& @8 ' �8 � 0 � H `p } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 0 $ ��(�8�P�X�X�`�ȣ�裠��� gui.exe 0000644 00000027000 15030122015 0006017 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ �z 2�da�da�da�c�a�dasee`�dase�a�dasea`�dase``�daseg`�da�ce`�da�ea�da�d``�da�d�a�da�df`�daRich�da PE L �'hd � $ � 0 @ p @� 6 � P � ` � �2 2 @ 0 .text � `.rdata � 0 @ @.data � @ ( @ �.rsrc � P * @ @.reloc � ` , @ B ��C@ �����������U��} u�@@ ��t j P� 0@ � ]���������������U��EPj �u �u����p�0� 1@ ��]�������������U��j�u �u� �� ]������������U���S�]VW�K��C��u�+�j�] P�x0@ �ȃ��M�3��"�q3ɉM���~S�U�<\uG�&<"u ��~Wj\V� �M��� �U�3��\F�3��A�F�M�;�| �~Wj\V�t �� ��E�_f�" ^[��]�������������U��� �@@ 3ʼnE��E�����E �����������h Pj �0@ j h� jj jh �������P� 0@ j h ������QP�0@ �������Q�A��u�+ʍ������������;�v�8.t� ������H;�w퍍����� If��A�I��u���1@ ���1@ �A��1@ W�A������j P� �������u2������Ph�1@ j��0@ ��P����� �G_�M�3��� ��]�Vh ������PW�� ������W��� ��������H@;�s���t �� t�� u�j� ������h�1@ P� 1@ �� ��t&��1@ �~�1@ �������1@ fօ����������������Q D �A��u�S+�jQ�x0@ �������������3ۉ���������Q�����1@ �� ��t�FFP�1@ ����u� � �F���������� ��P�1@ �������t��tm��������\uC�ƀ�"u0�Ã�����u 3��������3��9�����EȈ�������tSj\W�� �� �3ۊ��������o����G�g�����tSj\W� �� �3ۋ��������@� G������ �����<�t-�P�1@ ����t�FFP�1@ ����u�> ����������;�NJ��t ��@��/u�\���u�5h0@ ������P������P������P����PW�փ����� �� ������\�� ������P������P������P����P������P�֍��������Q�A��u�+ʊ� ������ �����Ӏ�\u�Q�3���\��������\t f � ������;�r � H�8\u�j W������P����P������P�l0@ �=x0@ jh �����h PV������1@ �������(�,�x0@ jh ��h �����WV�1@ �=x0@ ����u/�3h�1@ j��0@ ��P�r����� �F[^_�M�3��Q ��]Ë�������j� �����A�P��V����~�����{� �� 9���~*���� ������4��R����C����;�|勵���������P�3����� ����9���~/���� � ������4������C����;�|勵����} � t@���V��0@ ��Vh�1@ j��0@ ��P�l����� � [^_�M�3��I ��]ËQ�A��u�����+ʺ �y;�~0��� ��Y @ �A��u�+�GB�;�|ߋ���������x0@ jW��Vh�1@ P����� ���N��F��u�� +�;�~O @ ff � ����4������h�1@ P�d ����� � ��Q D �A��u�+�FG�;�|�W�Dž�� jh@ ����Dž����D f�����f�����f�����f�����f�����f�����f�����f������0@ �����P������Pj j j jj j ����j �0@ ��u,hP1@ j��0@ ��P������3�[^_�M�3�� ��]Ë����j�������@@ �0@ ����P������ 0@ ��u,hl1@ j��0@ ��P�v�����3�[^_�M�3��V ��]ËM�����3�[^_�? ��]����������U��EPj �u j��u�����p��Q��0@ ���� ��H�]�; @@ u��y Vj�v �V P� �D ��� j�0� �� ^��ts���l h"@ �n � P�> YY��uQ� �c ��t h� @ � Y�) �$ � �� P�G Y�� ��t� �� �T ��u�j�- ��� 3��� � P� Y�jh�5@ �/ j� Y���P 2ۈ]�e� �� �Eܡ<C@ 3�A;��/ ��uI� <C@ h<1@ h01@ � YY��t�E������� �� h,1@ h$1@ �[ YY�<C@ ��و]�u��� Y�i ��3�9>tV�9 Y��t�6WjW�� 1@ ���G ��9>tV� Y��t�6�$ Y�� ���� �0� WV�0�q����� ���. ��tk��u�� j j�{ YY�E��������5�M�� �E�QP�{ YYËe��� ��t2�}� u� �E������E�M�d� Y_^[��j� V�j �u��h ��� �t���U��j �D0@ �u�H0@ h ��@0@ P�<0@ ]�U���$ j�80@ ��tjY�)� A@ � A@ �A@ � A@ �5A@ �= A@ f�8A@ f� ,A@ f� A@ f�A@ f�% A@ f�-�@@ ��0A@ �E �$A@ �E�(A@ �E�4A@ ������p@@ �(A@ �,@@ � @@ ��$@@ �0@@ jXk� ǀ4@@ jXk� � @@ �L�jX�� � @@ �L�h2@ �����U��EV�H<��A�Q��Ak�(�;�t�M ;J r �BB ;�r ��(;�u�3�^]Ë��V� ��t d� �@C@ �P�;�t3�������u�2�^ð^�U��} u�DC@ �v �r ��u2�]��e ��u j �Z Y��]�U��=EC@ t�]�V�u��t��ub� ��t&��u"hHC@ � Y��uhTC@ �y Y��t+2��0��� HC@ � LC@ � PC@ � TC@ � XC@ � \C@ �EC@ �^]�j�/ �jh 6@ �K �e� �MZ f9 @ u]�< @ �� @ PE uL� f9� @ u>�E� @ +�PQ�|���YY��t'�x$ |!�E������� �E� 3Ɂ8 �����Ëe��E�����2��M�d� Y_^[��U��� ��t�} u 3��@C@ �]�U��=DC@ t�} u�u� �u� YY�]�U��=HC@ ��uu�T � hHC@ �B Y��Y���#E]�U��u������Y���H]�U����e� �E�e� P�(0@ �E�3E�E��,0@ 1E��00@ 1E��E�P�40@ �E�M�3E�3E�3��Ë @@ VW�N�@�� ��;�t��u&�����;�u�O�@����u G �� ȉ @@ ��_� @@ ^�3��3�@ø @ �h`C@ �$0@ ð�h h j �g �� ��u�j�? �� �hC@ ���H�$�H����H��H�3�9 @@ ��ø�C@ ø�C@ �U���$ Sj�80@ ��t�M�)j� �$� �����j P�F �� ��������������������������|�����x���f������f������f��t���f��p���f��l���f��h�����������E�������E������Dž��� �@�jP�������E�j P� �E�� �E� @�E� �E�� 0@ j �X��ۍE��E������ۉE���D0@ �E�P�H0@ ��u ��uj� Y[���e���j �L0@ ��t3�MZ f9u)�H<ȁ9PE u � f9Au�ytv ��� ���2��h�!@ �D0@ �U��VW�}�7�>csm�u%�~u �F= �t =!�t="�t= @�t_3�^]� �� �0�w�� �0�\ ̃%pC@ �SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[�SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[������h�"@ d�5 �D$�l$�l$+�SVW�@@ 1E�3�P�e�u��E��E������E��E�d� �U��V�u�6� �u��u�u Vh2@ h@@ � �� ^]�U��%tC@ ��$� @@ j �80@ ���� �e� 3�SVW3ɍ}�S���[���w�O3ɉW �E܋}�E�Genu�E�5ineI�E��E�5ntel�E�3�@S���[��]܉�E� E� ljs�K�S uC�E�%�?�=� t#=` t =p t=P t=` t=p u�=xC@ ���=xC@ ��=xC@ �M�jX�M�9E�|03�S���[��]܉�s�K�M��S �]�� t���=xC@ ��]�@@ ���tC@ �@@ �� �� ���tC@ �@@ �� ty�� tq3�ЉE�U�E�M�j^#�;�uW�@@ ���tC@ �@@ �� t;�� �tC@ �@@ � �#�;�u �E�� �M�#�;�u � @@ @�5tC@ _^[3���3�9@@ ���%T0@ �%X0@ �%`0@ �%\0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%1@ �%�0@ �%�0@ �%�0@ �%�0@ �%t0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ U��Q�=tC@ |f�}� �t �}� �uT�]��E���?��t?� u�� ��é t*� u�� ��é u�� ��é u�� ��ø� ��ËE�� 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � @ �@ @@ �@ failed to create process. failed to get exit code from process. %s %s -script.pyw Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s @@ p@@ � @@ 3@ 1@ 3@ 1@ �'hd l `3 ` �" �� 3 , H3 � � �" (# �# $ $ $ $ c$ k$ @ �" N% x � .text$mn 0 .idata$5 1 .00cfg $1 .CRT$XCA (1 .CRT$XCAA ,1 .CRT$XCZ 01 .CRT$XIA 41 .CRT$XIAA 81 .CRT$XIAC <1 .CRT$XIZ @1 .CRT$XPA D1 .CRT$XPZ H1 .CRT$XTA L1 .CRT$XTZ P1 � .rdata 3 .rdata$sxdata 3 \ .rdata$voltmd `3 l .rdata$zzzdbg �5 .rtc$IAA �5 .rtc$IZZ �5 .rtc$TAA �5 .rtc$TZZ �5 < .xdata$x 6 � .idata$2 �6 .idata$3 �6 .idata$4 8 � .idata$6 @ .data @ x .bss P ` .rsrc$01 `P � .rsrc$02 ���� ��� ����,@ @@ ���� ��� ����N @ a @ �6 �8 0 L7 ,9 T0 l7 �; t0 `7 �; h0 �7 �; �0 �7 < �0 8 4< 1 �7 V< �0 x7 v< �0 �7 �< �0 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � CreateFileA dGetFinalPathNameByHandleA �WaitForSingleObject QGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll H memset __current_exception __current_exception_context 5 _except_handler4_common VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace B _seh_filter_exe D _set_app_type . __setusermatherr _configure_narrow_argv 5 _initialize_narrow_environment * _get_initial_narrow_environment 8 _initterm 9 _initterm_e X exit % _exit T _set_fmode _cexit _c_exit ? _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 6 _initialize_onexit_table > _register_onexit_function _crt_atexit _controlfp_s j terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �UnhandledExceptionFilter �SetUnhandledExceptionFilter ,GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent mQueryPerformanceCounter -GetCurrentProcessId 1GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW ��DN�@����� � 0 � H `P } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 00'0[0�0J1u1�1�1�12 222:2�2�2�2�2�2�2+3>3g3&494s4M5S5w5�5�5�5�5�5�6�6�6>7I7�7�7(8P8Y8a8�8�8�8�8�8!949x9�9:3:H:M:R:s:x:�:�:�;�;�;�;�;�;�;�;�;�;�;�; <<<< <#<+<3<;<G<P<U<[<e<o<<�<�<�<=4=g=�=�=�=�=�=�=�=�=�=�=>>> >*>�>�>�>�>?'?0?=?S?�?�?�?�?�? � 0 00%0�011;1z1�1�1�1�1�122*2A2^2�2�2�2�2�2u3~3�3�3�3�3�3�3�3+444=4K4T4v4}4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�455555 5&5,52585>5D5J5T5 0 ( 1(1418122L2P2X2�2�2�5�566 command/install_lib.py 0000644 00000010337 15030122015 0011021 0 ustar 00 from __future__ import annotations import os import sys from itertools import product, starmap from .._path import StrPath from ..dist import Distribution import distutils.command.install_lib as orig class install_lib(orig.install_lib): """Don't add compiled flags to filenames of non-Python files""" distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution def run(self) -> None: self.build() outfiles = self.install() if outfiles is not None: # always compile, in case we have any extension stubs to deal with self.byte_compile(outfiles) def get_exclusions(self): """ Return a collections.Sized collections.Container of paths to be excluded for single_version_externally_managed installations. """ all_packages = ( pkg for ns_pkg in self._get_SVEM_NSPs() for pkg in self._all_packages(ns_pkg) ) excl_specs = product(all_packages, self._gen_exclusion_paths()) return set(starmap(self._exclude_pkg_path, excl_specs)) def _exclude_pkg_path(self, pkg, exclusion_path): """ Given a package name and exclusion path within that package, compute the full exclusion path. """ parts = pkg.split('.') + [exclusion_path] return os.path.join(self.install_dir, *parts) @staticmethod def _all_packages(pkg_name): """ >>> list(install_lib._all_packages('foo.bar.baz')) ['foo.bar.baz', 'foo.bar', 'foo'] """ while pkg_name: yield pkg_name pkg_name, _sep, _child = pkg_name.rpartition('.') def _get_SVEM_NSPs(self): """ Get namespace packages (list) but only for single_version_externally_managed installations and empty otherwise. """ # TODO: is it necessary to short-circuit here? i.e. what's the cost # if get_finalized_command is called even when namespace_packages is # False? if not self.distribution.namespace_packages: return [] install_cmd = self.get_finalized_command('install') svem = install_cmd.single_version_externally_managed return self.distribution.namespace_packages if svem else [] @staticmethod def _gen_exclusion_paths(): """ Generate file paths to be excluded for namespace packages (bytecode cache files). """ # always exclude the package module itself yield '__init__.py' yield '__init__.pyc' yield '__init__.pyo' if not hasattr(sys, 'implementation'): return base = os.path.join('__pycache__', '__init__.' + sys.implementation.cache_tag) yield base + '.pyc' yield base + '.pyo' yield base + '.opt-1.pyc' yield base + '.opt-2.pyc' def copy_tree( self, infile: StrPath, outfile: str, # override: Using actual booleans preserve_mode: bool = True, # type: ignore[override] preserve_times: bool = True, # type: ignore[override] preserve_symlinks: bool = False, # type: ignore[override] level: object = 1, ) -> list[str]: assert preserve_mode assert preserve_times assert not preserve_symlinks exclude = self.get_exclusions() if not exclude: return orig.install_lib.copy_tree(self, infile, outfile) # Exclude namespace package __init__.py* files from the output from setuptools.archive_util import unpack_directory from distutils import log outfiles: list[str] = [] def pf(src: str, dst: str): if dst in exclude: log.warn("Skipping installation of %s (namespace package)", dst) return False log.info("copying %s -> %s", src, os.path.dirname(dst)) outfiles.append(dst) return dst unpack_directory(infile, outfile, pf) return outfiles def get_outputs(self): outputs = orig.install_lib.get_outputs(self) exclude = self.get_exclusions() if exclude: return [f for f in outputs if f not in exclude] return outputs command/egg_info.py 0000644 00000062576 15030122015 0010316 0 ustar 00 """setuptools.command.egg_info Create a distribution's .egg-info directory and contents""" import functools import os import re import sys import time from collections.abc import Callable import packaging import packaging.requirements import packaging.version import setuptools.unicode_utils as unicode_utils from setuptools import Command from setuptools.command import bdist_egg from setuptools.command.sdist import sdist, walk_revctrl from setuptools.command.setopt import edit_config from setuptools.glob import glob from .. import _entry_points, _normalization from .._importlib import metadata from ..warnings import SetuptoolsDeprecationWarning from . import _requirestxt import distutils.errors import distutils.filelist from distutils import log from distutils.errors import DistutilsInternalError from distutils.filelist import FileList as _FileList from distutils.util import convert_path PY_MAJOR = f'{sys.version_info.major}.{sys.version_info.minor}' def translate_pattern(glob): # noqa: C901 # is too complex (14) # FIXME """ Translate a file path glob like '*.txt' in to a regular expression. This differs from fnmatch.translate which allows wildcards to match directory separators. It also knows about '**/' which matches any number of directories. """ pat = '' # This will split on '/' within [character classes]. This is deliberate. chunks = glob.split(os.path.sep) sep = re.escape(os.sep) valid_char = f'[^{sep}]' for c, chunk in enumerate(chunks): last_chunk = c == len(chunks) - 1 # Chunks that are a literal ** are globstars. They match anything. if chunk == '**': if last_chunk: # Match anything if this is the last component pat += '.*' else: # Match '(name/)*' pat += f'(?:{valid_char}+{sep})*' continue # Break here as the whole path component has been handled # Find any special characters in the remainder i = 0 chunk_len = len(chunk) while i < chunk_len: char = chunk[i] if char == '*': # Match any number of name characters pat += valid_char + '*' elif char == '?': # Match a name character pat += valid_char elif char == '[': # Character class inner_i = i + 1 # Skip initial !/] chars if inner_i < chunk_len and chunk[inner_i] == '!': inner_i = inner_i + 1 if inner_i < chunk_len and chunk[inner_i] == ']': inner_i = inner_i + 1 # Loop till the closing ] is found while inner_i < chunk_len and chunk[inner_i] != ']': inner_i = inner_i + 1 if inner_i >= chunk_len: # Got to the end of the string without finding a closing ] # Do not treat this as a matching group, but as a literal [ pat += re.escape(char) else: # Grab the insides of the [brackets] inner = chunk[i + 1 : inner_i] char_class = '' # Class negation if inner[0] == '!': char_class = '^' inner = inner[1:] char_class += re.escape(inner) pat += f'[{char_class}]' # Skip to the end ] i = inner_i else: pat += re.escape(char) i += 1 # Join each chunk with the dir separator if not last_chunk: pat += sep pat += r'\Z' return re.compile(pat, flags=re.MULTILINE | re.DOTALL) class InfoCommon: tag_build = None tag_date = None @property def name(self): return _normalization.safe_name(self.distribution.get_name()) def tagged_version(self): tagged = self._maybe_tag(self.distribution.get_version()) return _normalization.safe_version(tagged) def _maybe_tag(self, version): """ egg_info may be called more than once for a distribution, in which case the version string already contains all tags. """ return ( version if self.vtags and self._already_tagged(version) else version + self.vtags ) def _already_tagged(self, version: str) -> bool: # Depending on their format, tags may change with version normalization. # So in addition the regular tags, we have to search for the normalized ones. return version.endswith(self.vtags) or version.endswith(self._safe_tags()) def _safe_tags(self) -> str: # To implement this we can rely on `safe_version` pretending to be version 0 # followed by tags. Then we simply discard the starting 0 (fake version number) try: return _normalization.safe_version(f"0{self.vtags}")[1:] except packaging.version.InvalidVersion: return _normalization.safe_name(self.vtags.replace(' ', '.')) def tags(self) -> str: version = '' if self.tag_build: version += self.tag_build if self.tag_date: version += time.strftime("%Y%m%d") return version vtags = property(tags) class egg_info(InfoCommon, Command): description = "create a distribution's .egg-info directory" user_options = [ ( 'egg-base=', 'e', "directory containing .egg-info directories" " [default: top of the source tree]", ), ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), ('tag-build=', 'b', "Specify explicit tag to add to version number"), ('no-date', 'D', "Don't include date stamp [default]"), ] boolean_options = ['tag-date'] negative_opt = { 'no-date': 'tag-date', } def initialize_options(self): self.egg_base = None self.egg_name = None self.egg_info = None self.egg_version = None self.ignore_egg_info_in_manifest = False #################################### # allow the 'tag_svn_revision' to be detected and # set, supporting sdists built on older Setuptools. @property def tag_svn_revision(self) -> None: pass @tag_svn_revision.setter def tag_svn_revision(self, value): pass #################################### def save_version_info(self, filename) -> None: """ Materialize the value of date into the build tag. Install build keys in a deterministic order to avoid arbitrary reordering on subsequent builds. """ # follow the order these keys would have been added # when PYTHONHASHSEED=0 egg_info = dict(tag_build=self.tags(), tag_date=0) edit_config(filename, dict(egg_info=egg_info)) def finalize_options(self) -> None: # Note: we need to capture the current value returned # by `self.tagged_version()`, so we can later update # `self.distribution.metadata.version` without # repercussions. self.egg_name = self.name self.egg_version = self.tagged_version() parsed_version = packaging.version.Version(self.egg_version) try: is_version = isinstance(parsed_version, packaging.version.Version) spec = "%s==%s" if is_version else "%s===%s" packaging.requirements.Requirement(spec % (self.egg_name, self.egg_version)) except ValueError as e: raise distutils.errors.DistutilsOptionError( f"Invalid distribution name or version syntax: {self.egg_name}-{self.egg_version}" ) from e if self.egg_base is None: dirs = self.distribution.package_dir self.egg_base = (dirs or {}).get('', os.curdir) self.ensure_dirname('egg_base') self.egg_info = _normalization.filename_component(self.egg_name) + '.egg-info' if self.egg_base != os.curdir: self.egg_info = os.path.join(self.egg_base, self.egg_info) # Set package version for the benefit of dumber commands # (e.g. sdist, bdist_wininst, etc.) # self.distribution.metadata.version = self.egg_version def _get_egg_basename(self, py_version=PY_MAJOR, platform=None): """Compute filename of the output egg. Private API.""" return _egg_basename(self.egg_name, self.egg_version, py_version, platform) def write_or_delete_file(self, what, filename, data, force: bool = False) -> None: """Write `data` to `filename` or delete if empty If `data` is non-empty, this routine is the same as ``write_file()``. If `data` is empty but not ``None``, this is the same as calling ``delete_file(filename)`. If `data` is ``None``, then this is a no-op unless `filename` exists, in which case a warning is issued about the orphaned file (if `force` is false), or deleted (if `force` is true). """ if data: self.write_file(what, filename, data) elif os.path.exists(filename): if data is None and not force: log.warn("%s not set in setup(), but %s exists", what, filename) return else: self.delete_file(filename) def write_file(self, what, filename, data) -> None: """Write `data` to `filename` (if not a dry run) after announcing it `what` is used in a log message to identify what is being written to the file. """ log.info("writing %s to %s", what, filename) data = data.encode("utf-8") if not self.dry_run: f = open(filename, 'wb') f.write(data) f.close() def delete_file(self, filename) -> None: """Delete `filename` (if not a dry run) after announcing it""" log.info("deleting %s", filename) if not self.dry_run: os.unlink(filename) def run(self) -> None: # Pre-load to avoid iterating over entry-points while an empty .egg-info # exists in sys.path. See pypa/pyproject-hooks#206 writers = list(metadata.entry_points(group='egg_info.writers')) self.mkpath(self.egg_info) try: os.utime(self.egg_info, None) except OSError as e: msg = f"Cannot update time stamp of directory '{self.egg_info}'" raise distutils.errors.DistutilsFileError(msg) from e for ep in writers: writer = ep.load() writer(self, ep.name, os.path.join(self.egg_info, ep.name)) # Get rid of native_libs.txt if it was put there by older bdist_egg nl = os.path.join(self.egg_info, "native_libs.txt") if os.path.exists(nl): self.delete_file(nl) self.find_sources() def find_sources(self) -> None: """Generate SOURCES.txt manifest file""" manifest_filename = os.path.join(self.egg_info, "SOURCES.txt") mm = manifest_maker(self.distribution) mm.ignore_egg_info_dir = self.ignore_egg_info_in_manifest mm.manifest = manifest_filename mm.run() self.filelist = mm.filelist class FileList(_FileList): # Implementations of the various MANIFEST.in commands def __init__( self, warn=None, debug_print=None, ignore_egg_info_dir: bool = False ) -> None: super().__init__(warn, debug_print) self.ignore_egg_info_dir = ignore_egg_info_dir def process_template_line(self, line) -> None: # 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 # three are defined depends on the action; it'll be either # patterns, (dir and patterns), or (dir_pattern). (action, patterns, dir, dir_pattern) = self._parse_template_line(line) action_map: dict[str, Callable] = { 'include': self.include, 'exclude': self.exclude, 'global-include': self.global_include, 'global-exclude': self.global_exclude, 'recursive-include': functools.partial( self.recursive_include, dir, ), 'recursive-exclude': functools.partial( self.recursive_exclude, dir, ), 'graft': self.graft, 'prune': self.prune, } log_map = { 'include': "warning: no files found matching '%s'", 'exclude': ("warning: no previously-included files found matching '%s'"), 'global-include': ( "warning: no files found matching '%s' anywhere in distribution" ), 'global-exclude': ( "warning: no previously-included files matching " "'%s' found anywhere in distribution" ), 'recursive-include': ( "warning: no files found matching '%s' under directory '%s'" ), 'recursive-exclude': ( "warning: no previously-included files matching " "'%s' found under directory '%s'" ), 'graft': "warning: no directories found matching '%s'", 'prune': "no previously-included directories found matching '%s'", } try: process_action = action_map[action] except KeyError: msg = f"Invalid MANIFEST.in: unknown action {action!r} in {line!r}" raise DistutilsInternalError(msg) from None # OK, now we know that the action is valid and we have the # right number of words on the line for that action -- so we # can proceed with minimal error-checking. action_is_recursive = action.startswith('recursive-') if action in {'graft', 'prune'}: patterns = [dir_pattern] extra_log_args = (dir,) if action_is_recursive else () log_tmpl = log_map[action] self.debug_print( ' '.join( [action] + ([dir] if action_is_recursive else []) + patterns, ) ) for pattern in patterns: if not process_action(pattern): log.warn(log_tmpl, pattern, *extra_log_args) def _remove_files(self, predicate): """ Remove all files from the file list that match the predicate. Return True if any matching files were removed """ found = False for i in range(len(self.files) - 1, -1, -1): if predicate(self.files[i]): self.debug_print(" removing " + self.files[i]) del self.files[i] found = True return found def include(self, pattern): """Include files that match 'pattern'.""" found = [f for f in glob(pattern) if not os.path.isdir(f)] self.extend(found) return bool(found) def exclude(self, pattern): """Exclude files that match 'pattern'.""" match = translate_pattern(pattern) return self._remove_files(match.match) def recursive_include(self, dir, pattern): """ Include all files anywhere in 'dir/' that match the pattern. """ full_pattern = os.path.join(dir, '**', pattern) found = [f for f in glob(full_pattern, recursive=True) if not os.path.isdir(f)] self.extend(found) return bool(found) def recursive_exclude(self, dir, pattern): """ Exclude any file anywhere in 'dir/' that match the pattern. """ match = translate_pattern(os.path.join(dir, '**', pattern)) return self._remove_files(match.match) def graft(self, dir): """Include all files from 'dir/'.""" found = [ item for match_dir in glob(dir) for item in distutils.filelist.findall(match_dir) ] self.extend(found) return bool(found) def prune(self, dir): """Filter out files from 'dir/'.""" match = translate_pattern(os.path.join(dir, '**')) return self._remove_files(match.match) def global_include(self, pattern): """ Include all files anywhere in the current directory that match the pattern. This is very inefficient on large file trees. """ if self.allfiles is None: self.findall() match = translate_pattern(os.path.join('**', pattern)) found = [f for f in self.allfiles if match.match(f)] self.extend(found) return bool(found) def global_exclude(self, pattern): """ Exclude all files anywhere that match the pattern. """ match = translate_pattern(os.path.join('**', pattern)) return self._remove_files(match.match) def append(self, item) -> None: if item.endswith('\r'): # Fix older sdists built on Windows item = item[:-1] path = convert_path(item) if self._safe_path(path): self.files.append(path) def extend(self, paths) -> None: self.files.extend(filter(self._safe_path, paths)) def _repair(self): """ Replace self.files with only safe paths Because some owners of FileList manipulate the underlying ``files`` attribute directly, this method must be called to repair those paths. """ self.files = list(filter(self._safe_path, self.files)) def _safe_path(self, path): enc_warn = "'%s' not %s encodable -- skipping" # To avoid accidental trans-codings errors, first to unicode u_path = unicode_utils.filesys_decode(path) if u_path is None: log.warn(f"'{path}' in unexpected encoding -- skipping") return False # Must ensure utf-8 encodability utf8_path = unicode_utils.try_encode(u_path, "utf-8") if utf8_path is None: log.warn(enc_warn, path, 'utf-8') return False try: # ignore egg-info paths is_egg_info = ".egg-info" in u_path or b".egg-info" in utf8_path if self.ignore_egg_info_dir and is_egg_info: return False # accept is either way checks out if os.path.exists(u_path) or os.path.exists(utf8_path): return True # this will catch any encode errors decoding u_path except UnicodeEncodeError: log.warn(enc_warn, path, sys.getfilesystemencoding()) class manifest_maker(sdist): template = "MANIFEST.in" def initialize_options(self) -> None: self.use_defaults = True self.prune = True self.manifest_only = True self.force_manifest = True self.ignore_egg_info_dir = False def finalize_options(self) -> None: pass def run(self) -> None: self.filelist = FileList(ignore_egg_info_dir=self.ignore_egg_info_dir) if not os.path.exists(self.manifest): self.write_manifest() # it must exist so it'll get in the list self.add_defaults() if os.path.exists(self.template): self.read_template() self.add_license_files() self._add_referenced_files() self.prune_file_list() self.filelist.sort() self.filelist.remove_duplicates() self.write_manifest() def _manifest_normalize(self, path): path = unicode_utils.filesys_decode(path) return path.replace(os.sep, '/') def write_manifest(self) -> None: """ Write the file list in 'self.filelist' to the manifest file named by 'self.manifest'. """ self.filelist._repair() # Now _repairs should encodability, but not unicode files = [self._manifest_normalize(f) for f in self.filelist.files] msg = f"writing manifest file '{self.manifest}'" self.execute(write_file, (self.manifest, files), msg) def warn(self, msg) -> None: if not self._should_suppress_warning(msg): sdist.warn(self, msg) @staticmethod def _should_suppress_warning(msg): """ suppress missing-file warnings from sdist """ return re.match(r"standard file .*not found", msg) def add_defaults(self) -> None: sdist.add_defaults(self) self.filelist.append(self.template) self.filelist.append(self.manifest) rcfiles = list(walk_revctrl()) if rcfiles: self.filelist.extend(rcfiles) elif os.path.exists(self.manifest): self.read_manifest() if os.path.exists("setup.py"): # setup.py should be included by default, even if it's not # the script called to create the sdist self.filelist.append("setup.py") ei_cmd = self.get_finalized_command('egg_info') self.filelist.graft(ei_cmd.egg_info) def add_license_files(self) -> None: license_files = self.distribution.metadata.license_files or [] for lf in license_files: log.info("adding license file '%s'", lf) self.filelist.extend(license_files) def _add_referenced_files(self): """Add files referenced by the config (e.g. `file:` directive) to filelist""" referenced = getattr(self.distribution, '_referenced_files', []) # ^-- fallback if dist comes from distutils or is a custom class for rf in referenced: log.debug("adding file referenced by config '%s'", rf) self.filelist.extend(referenced) def _safe_data_files(self, build_py): """ The parent class implementation of this method (``sdist``) will try to include data files, which might cause recursion problems when ``include_package_data=True``. Therefore, avoid triggering any attempt of analyzing/building the manifest again. """ if hasattr(build_py, 'get_data_files_without_manifest'): return build_py.get_data_files_without_manifest() SetuptoolsDeprecationWarning.emit( "`build_py` command does not inherit from setuptools' `build_py`.", """ Custom 'build_py' does not implement 'get_data_files_without_manifest'. Please extend command classes from setuptools instead of distutils. """, see_url="https://peps.python.org/pep-0632/", # due_date not defined yet, old projects might still do it? ) return build_py.get_data_files() def write_file(filename, contents) -> None: """Create a file with the specified name and write 'contents' (a sequence of strings without line terminators) to it. """ contents = "\n".join(contents) # assuming the contents has been vetted for utf-8 encoding contents = contents.encode("utf-8") with open(filename, "wb") as f: # always write POSIX-style manifest f.write(contents) def write_pkg_info(cmd, basename, filename) -> None: log.info("writing %s", filename) if not cmd.dry_run: metadata = cmd.distribution.metadata metadata.version, oldver = cmd.egg_version, metadata.version metadata.name, oldname = cmd.egg_name, metadata.name try: # write unescaped data to PKG-INFO, so older pkg_resources # can still parse it metadata.write_pkg_info(cmd.egg_info) finally: metadata.name, metadata.version = oldname, oldver safe = getattr(cmd.distribution, 'zip_safe', None) bdist_egg.write_safety_flag(cmd.egg_info, safe) def warn_depends_obsolete(cmd, basename, filename) -> None: """ Unused: left to avoid errors when updating (from source) from <= 67.8. Old installations have a .dist-info directory with the entry-point ``depends.txt = setuptools.command.egg_info:warn_depends_obsolete``. This may trigger errors when running the first egg_info in build_meta. TODO: Remove this function in a version sufficiently > 68. """ # Export API used in entry_points write_requirements = _requirestxt.write_requirements write_setup_requirements = _requirestxt.write_setup_requirements def write_toplevel_names(cmd, basename, filename) -> None: pkgs = dict.fromkeys([ k.split('.', 1)[0] for k in cmd.distribution.iter_distribution_names() ]) cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n') def overwrite_arg(cmd, basename, filename) -> None: write_arg(cmd, basename, filename, True) def write_arg(cmd, basename, filename, force: bool = False) -> None: argname = os.path.splitext(basename)[0] value = getattr(cmd.distribution, argname, None) if value is not None: value = '\n'.join(value) + '\n' cmd.write_or_delete_file(argname, filename, value, force) def write_entries(cmd, basename, filename) -> None: eps = _entry_points.load(cmd.distribution.entry_points) defn = _entry_points.render(eps) cmd.write_or_delete_file('entry points', filename, defn, True) def _egg_basename(egg_name, egg_version, py_version=None, platform=None): """Compute filename of the output egg. Private API.""" name = _normalization.filename_component(egg_name) version = _normalization.filename_component(egg_version) egg = f"{name}-{version}-py{py_version or PY_MAJOR}" if platform: egg += f"-{platform}" return egg class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning): """Deprecated behavior warning for EggInfo, bypassing suppression.""" command/easy_install.py 0000644 00000253476 15030122015 0011231 0 ustar 00 """ Easy Install ------------ A tool for doing automatic download/extract/build of distutils-based Python packages. For detailed documentation, see the accompanying EasyInstall.txt file, or visit the `EasyInstall home page`__. __ https://setuptools.pypa.io/en/latest/deprecated/easy_install.html """ from __future__ import annotations import configparser import contextlib import io import os import random import re import shlex import shutil import site import stat import struct import subprocess import sys import sysconfig import tempfile import textwrap import warnings import zipfile import zipimport from collections.abc import Iterable from glob import glob from sysconfig import get_path from typing import TYPE_CHECKING, NoReturn, TypedDict from jaraco.text import yield_lines import pkg_resources from pkg_resources import ( DEVELOP_DIST, Distribution, DistributionNotFound, EggMetadata, Environment, PathMetadata, Requirement, VersionConflict, WorkingSet, find_distributions, get_distribution, normalize_path, resource_string, ) from setuptools import Command from setuptools.archive_util import unpack_archive from setuptools.command import bdist_egg, egg_info, setopt from setuptools.package_index import URL_SCHEME, PackageIndex, parse_requirement_arg from setuptools.sandbox import run_setup from setuptools.warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning from setuptools.wheel import Wheel from .._path import ensure_directory from .._shutil import attempt_chmod_verbose as chmod, rmtree as _rmtree from ..compat import py39, py312 from distutils import dir_util, log from distutils.command import install from distutils.command.build_scripts import first_line_re from distutils.errors import ( DistutilsArgError, DistutilsError, DistutilsOptionError, DistutilsPlatformError, ) from distutils.util import convert_path, get_platform, subst_vars if TYPE_CHECKING: from typing_extensions import Self # Turn on PEP440Warnings warnings.filterwarnings("default", category=pkg_resources.PEP440Warning) __all__ = [ 'easy_install', 'PthDistributions', 'extract_wininst_cfg', 'get_exe_prefixes', ] def is_64bit(): return struct.calcsize("P") == 8 def _to_bytes(s): return s.encode('utf8') def isascii(s): try: s.encode('ascii') except UnicodeError: return False return True def _one_liner(text): return textwrap.dedent(text).strip().replace('\n', '; ') class easy_install(Command): """Manage a download/build/install process""" description = "Find/get/install Python packages" command_consumes_arguments = True user_options = [ ('prefix=', None, "installation prefix"), ("zip-ok", "z", "install package as a zipfile"), ("multi-version", "m", "make apps have to require() a version"), ("upgrade", "U", "force upgrade (searches PyPI for latest versions)"), ("install-dir=", "d", "install package to DIR"), ("script-dir=", "s", "install scripts to DIR"), ("exclude-scripts", "x", "Don't install scripts"), ("always-copy", "a", "Copy all needed packages to install dir"), ("index-url=", "i", "base URL of Python Package Index"), ("find-links=", "f", "additional URL(s) to search for packages"), ("build-directory=", "b", "download/extract/build in DIR; keep the results"), ( 'optimize=', 'O', 'also compile with optimization: -O1 for "python -O", ' '-O2 for "python -OO", and -O0 to disable [default: -O0]', ), ('record=', None, "filename in which to record list of installed files"), ('always-unzip', 'Z', "don't install as a zipfile, no matter what"), ('site-dirs=', 'S', "list of directories where .pth files work"), ('editable', 'e', "Install specified packages in editable form"), ('no-deps', 'N', "don't install dependencies"), ('allow-hosts=', 'H', "pattern(s) that hostnames must match"), ('local-snapshots-ok', 'l', "allow building eggs from local checkouts"), ('version', None, "print version information and exit"), ( 'no-find-links', None, "Don't load find-links defined in packages being installed", ), ('user', None, f"install in user site-package '{site.USER_SITE}'"), ] boolean_options = [ 'zip-ok', 'multi-version', 'exclude-scripts', 'upgrade', 'always-copy', 'editable', 'no-deps', 'local-snapshots-ok', 'version', 'user', ] negative_opt = {'always-unzip': 'zip-ok'} create_index = PackageIndex def initialize_options(self): EasyInstallDeprecationWarning.emit() # the --user option seems to be an opt-in one, # so the default should be False. self.user = False self.zip_ok = self.local_snapshots_ok = None self.install_dir = self.script_dir = self.exclude_scripts = None self.index_url = None self.find_links = None self.build_directory = None self.args = None self.optimize = self.record = None self.upgrade = self.always_copy = self.multi_version = None self.editable = self.no_deps = self.allow_hosts = None self.root = self.prefix = self.no_report = None self.version = None self.install_purelib = None # for pure module distributions self.install_platlib = None # non-pure (dists w/ extensions) self.install_headers = None # for C/C++ headers self.install_lib = None # set to either purelib or platlib self.install_scripts = None self.install_data = None self.install_base = None self.install_platbase = None self.install_userbase = site.USER_BASE self.install_usersite = site.USER_SITE self.no_find_links = None # Options not specifiable via command line self.package_index = None self.pth_file = self.always_copy_from = None self.site_dirs = None self.installed_projects = {} # Always read easy_install options, even if we are subclassed, or have # an independent instance created. This ensures that defaults will # always come from the standard configuration file(s)' "easy_install" # section, even if this is a "develop" or "install" command, or some # other embedding. self._dry_run = None self.verbose = self.distribution.verbose self.distribution._set_command_options( self, self.distribution.get_option_dict('easy_install') ) def delete_blockers(self, blockers) -> None: extant_blockers = ( filename for filename in blockers if os.path.exists(filename) or os.path.islink(filename) ) list(map(self._delete_path, extant_blockers)) def _delete_path(self, path): log.info("Deleting %s", path) if self.dry_run: return is_tree = os.path.isdir(path) and not os.path.islink(path) remover = _rmtree if is_tree else os.unlink remover(path) @staticmethod def _render_version(): """ Render the Setuptools version and installation details, then exit. """ ver = f'{sys.version_info.major}.{sys.version_info.minor}' dist = get_distribution('setuptools') print(f'setuptools {dist.version} from {dist.location} (Python {ver})') raise SystemExit def finalize_options(self) -> None: # noqa: C901 # is too complex (25) # FIXME self.version and self._render_version() py_version = sys.version.split()[0] self.config_vars = dict(sysconfig.get_config_vars()) self.config_vars.update({ 'dist_name': self.distribution.get_name(), 'dist_version': self.distribution.get_version(), 'dist_fullname': self.distribution.get_fullname(), 'py_version': py_version, 'py_version_short': f'{sys.version_info.major}.{sys.version_info.minor}', 'py_version_nodot': f'{sys.version_info.major}{sys.version_info.minor}', 'sys_prefix': self.config_vars['prefix'], 'sys_exec_prefix': self.config_vars['exec_prefix'], # Only POSIX systems have abiflags 'abiflags': getattr(sys, 'abiflags', ''), # Only python 3.9+ has platlibdir 'platlibdir': getattr(sys, 'platlibdir', 'lib'), }) with contextlib.suppress(AttributeError): # only for distutils outside stdlib self.config_vars.update({ 'implementation_lower': install._get_implementation().lower(), 'implementation': install._get_implementation(), }) # pypa/distutils#113 Python 3.9 compat self.config_vars.setdefault( 'py_version_nodot_plat', getattr(sys, 'windir', '').replace('.', ''), ) self.config_vars['userbase'] = self.install_userbase self.config_vars['usersite'] = self.install_usersite if self.user and not site.ENABLE_USER_SITE: log.warn("WARNING: The user site-packages directory is disabled.") self._fix_install_dir_for_user_site() self.expand_basedirs() self.expand_dirs() self._expand( 'install_dir', 'script_dir', 'build_directory', 'site_dirs', ) # If a non-default installation directory was specified, default the # script directory to match it. if self.script_dir is None: self.script_dir = self.install_dir if self.no_find_links is None: self.no_find_links = False # Let install_dir get set by install_lib command, which in turn # gets its info from the install command, and takes into account # --prefix and --home and all that other crud. self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) # Likewise, set default script_dir from 'install_scripts.install_dir' self.set_undefined_options('install_scripts', ('install_dir', 'script_dir')) if self.user and self.install_purelib: self.install_dir = self.install_purelib self.script_dir = self.install_scripts # default --record from the install command self.set_undefined_options('install', ('record', 'record')) self.all_site_dirs = get_site_dirs() self.all_site_dirs.extend(self._process_site_dirs(self.site_dirs)) if not self.editable: self.check_site_dir() default_index = os.getenv("__EASYINSTALL_INDEX", "https://pypi.org/simple/") # ^ Private API for testing purposes only self.index_url = self.index_url or default_index self.shadow_path = self.all_site_dirs[:] for path_item in self.install_dir, normalize_path(self.script_dir): if path_item not in self.shadow_path: self.shadow_path.insert(0, path_item) if self.allow_hosts is not None: hosts = [s.strip() for s in self.allow_hosts.split(',')] else: hosts = ['*'] if self.package_index is None: self.package_index = self.create_index( self.index_url, search_path=self.shadow_path, hosts=hosts, ) self.local_index = Environment(self.shadow_path + sys.path) if self.find_links is not None: if isinstance(self.find_links, str): self.find_links = self.find_links.split() else: self.find_links = [] if self.local_snapshots_ok: self.package_index.scan_egg_links(self.shadow_path + sys.path) if not self.no_find_links: self.package_index.add_find_links(self.find_links) self.set_undefined_options('install_lib', ('optimize', 'optimize')) self.optimize = self._validate_optimize(self.optimize) if self.editable and not self.build_directory: raise DistutilsArgError( "Must specify a build directory (-b) when using --editable" ) if not self.args: raise DistutilsArgError( "No urls, filenames, or requirements specified (see --help)" ) self.outputs: list[str] = [] @staticmethod def _process_site_dirs(site_dirs): if site_dirs is None: return normpath = map(normalize_path, sys.path) site_dirs = [os.path.expanduser(s.strip()) for s in site_dirs.split(',')] for d in site_dirs: if not os.path.isdir(d): log.warn("%s (in --site-dirs) does not exist", d) elif normalize_path(d) not in normpath: raise DistutilsOptionError(d + " (in --site-dirs) is not on sys.path") else: yield normalize_path(d) @staticmethod def _validate_optimize(value): try: value = int(value) if value not in range(3): raise ValueError except ValueError as e: raise DistutilsOptionError("--optimize must be 0, 1, or 2") from e return value def _fix_install_dir_for_user_site(self): """ Fix the install_dir if "--user" was used. """ if not self.user: return self.create_home_path() if self.install_userbase is None: msg = "User base directory is not specified" raise DistutilsPlatformError(msg) self.install_base = self.install_platbase = self.install_userbase scheme_name = f'{os.name}_user' self.select_scheme(scheme_name) def _expand_attrs(self, attrs): for attr in attrs: val = getattr(self, attr) if val is not None: if os.name == 'posix' or os.name == 'nt': val = os.path.expanduser(val) val = subst_vars(val, self.config_vars) setattr(self, attr, val) def expand_basedirs(self) -> None: """Calls `os.path.expanduser` on install_base, install_platbase and root.""" self._expand_attrs(['install_base', 'install_platbase', 'root']) def expand_dirs(self) -> None: """Calls `os.path.expanduser` on install dirs.""" dirs = [ 'install_purelib', 'install_platlib', 'install_lib', 'install_headers', 'install_scripts', 'install_data', ] self._expand_attrs(dirs) def run(self, show_deprecation: bool = True) -> None: if show_deprecation: self.announce( "WARNING: The easy_install command is deprecated " "and will be removed in a future version.", log.WARN, ) if self.verbose != self.distribution.verbose: log.set_verbosity(self.verbose) try: for spec in self.args: self.easy_install(spec, not self.no_deps) if self.record: outputs = self.outputs if self.root: # strip any package prefix root_len = len(self.root) for counter in range(len(outputs)): outputs[counter] = outputs[counter][root_len:] from distutils import file_util self.execute( file_util.write_file, (self.record, outputs), f"writing list of installed files to '{self.record}'", ) self.warn_deprecated_options() finally: log.set_verbosity(self.distribution.verbose) def pseudo_tempname(self): """Return a pseudo-tempname base in the install directory. This code is intentionally naive; if a malicious party can write to the target directory you're already in deep doodoo. """ try: pid = os.getpid() except Exception: pid = random.randint(0, sys.maxsize) return os.path.join(self.install_dir, f"test-easy-install-{pid}") def warn_deprecated_options(self) -> None: pass def check_site_dir(self) -> None: # is too complex (12) # FIXME """Verify that self.install_dir is .pth-capable dir, if needed""" instdir = normalize_path(self.install_dir) pth_file = os.path.join(instdir, 'easy-install.pth') if not os.path.exists(instdir): try: os.makedirs(instdir) except OSError: self.cant_write_to_target() # Is it a configured, PYTHONPATH, implicit, or explicit site dir? is_site_dir = instdir in self.all_site_dirs if not is_site_dir and not self.multi_version: # No? Then directly test whether it does .pth file processing is_site_dir = self.check_pth_processing() else: # make sure we can write to target dir testfile = self.pseudo_tempname() + '.write-test' test_exists = os.path.exists(testfile) try: if test_exists: os.unlink(testfile) open(testfile, 'wb').close() os.unlink(testfile) except OSError: self.cant_write_to_target() if not is_site_dir and not self.multi_version: # Can't install non-multi to non-site dir with easy_install pythonpath = os.environ.get('PYTHONPATH', '') log.warn(self.__no_default_msg, self.install_dir, pythonpath) if is_site_dir: if self.pth_file is None: self.pth_file = PthDistributions(pth_file, self.all_site_dirs) else: self.pth_file = None if self.multi_version and not os.path.exists(pth_file): self.pth_file = None # don't create a .pth file self.install_dir = instdir __cant_write_msg = textwrap.dedent( """ can't create or remove files in install directory The following error occurred while trying to add or remove files in the installation directory: %s The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s """ ).lstrip() __not_exists_id = textwrap.dedent( """ This directory does not currently exist. Please create it and try again, or choose a different installation directory (using the -d or --install-dir option). """ ).lstrip() __access_msg = textwrap.dedent( """ Perhaps your account does not have write access to this directory? If the installation directory is a system-owned directory, you may need to sign in as the administrator or "root" account. If you do not have administrative access to this machine, you may wish to choose a different installation directory, preferably one that is listed in your PYTHONPATH environment variable. For information on other options, you may wish to consult the documentation at: https://setuptools.pypa.io/en/latest/deprecated/easy_install.html Please make the appropriate changes for your system and try again. """ ).lstrip() def cant_write_to_target(self) -> NoReturn: msg = self.__cant_write_msg % ( sys.exc_info()[1], self.install_dir, ) if not os.path.exists(self.install_dir): msg += '\n' + self.__not_exists_id else: msg += '\n' + self.__access_msg raise DistutilsError(msg) def check_pth_processing(self): # noqa: C901 """Empirically verify whether .pth files are supported in inst. dir""" instdir = self.install_dir log.info("Checking .pth file support in %s", instdir) pth_file = self.pseudo_tempname() + ".pth" ok_file = pth_file + '.ok' ok_exists = os.path.exists(ok_file) tmpl = ( _one_liner( """ import os f = open({ok_file!r}, 'w', encoding="utf-8") f.write('OK') f.close() """ ) + '\n' ) try: if ok_exists: os.unlink(ok_file) dirname = os.path.dirname(ok_file) os.makedirs(dirname, exist_ok=True) f = open(pth_file, 'w', encoding=py312.PTH_ENCODING) # ^-- Python<3.13 require encoding="locale" instead of "utf-8", # see python/cpython#77102. except OSError: self.cant_write_to_target() else: try: f.write(tmpl.format(**locals())) f.close() f = None executable = sys.executable if os.name == 'nt': dirname, basename = os.path.split(executable) alt = os.path.join(dirname, 'pythonw.exe') use_alt = basename.lower() == 'python.exe' and os.path.exists(alt) if use_alt: # use pythonw.exe to avoid opening a console window executable = alt from distutils.spawn import spawn spawn([executable, '-E', '-c', 'pass'], 0) if os.path.exists(ok_file): log.info("TEST PASSED: %s appears to support .pth files", instdir) return True finally: if f: f.close() if os.path.exists(ok_file): os.unlink(ok_file) if os.path.exists(pth_file): os.unlink(pth_file) if not self.multi_version: log.warn("TEST FAILED: %s does NOT support .pth files", instdir) return False def install_egg_scripts(self, dist) -> None: """Write all the scripts for `dist`, unless scripts are excluded""" if not self.exclude_scripts and dist.metadata_isdir('scripts'): for script_name in dist.metadata_listdir('scripts'): if dist.metadata_isdir('scripts/' + script_name): # The "script" is a directory, likely a Python 3 # __pycache__ directory, so skip it. continue self.install_script( dist, script_name, dist.get_metadata('scripts/' + script_name) ) self.install_wrapper_scripts(dist) def add_output(self, path) -> None: if os.path.isdir(path): for base, dirs, files in os.walk(path): for filename in files: self.outputs.append(os.path.join(base, filename)) else: self.outputs.append(path) def not_editable(self, spec) -> None: if self.editable: raise DistutilsArgError( f"Invalid argument {spec!r}: you can't use filenames or URLs " "with --editable (except via the --find-links option)." ) def check_editable(self, spec) -> None: if not self.editable: return if os.path.exists(os.path.join(self.build_directory, spec.key)): raise DistutilsArgError( f"{spec.key!r} already exists in {self.build_directory}; can't do a checkout there" ) @contextlib.contextmanager def _tmpdir(self): tmpdir = tempfile.mkdtemp(prefix="easy_install-") try: # cast to str as workaround for #709 and #710 and #712 yield str(tmpdir) finally: os.path.exists(tmpdir) and _rmtree(tmpdir) def easy_install(self, spec, deps: bool = False) -> Distribution | None: with self._tmpdir() as tmpdir: if not isinstance(spec, Requirement): if URL_SCHEME(spec): # It's a url, download it to tmpdir and process self.not_editable(spec) dl = self.package_index.download(spec, tmpdir) return self.install_item(None, dl, tmpdir, deps, True) elif os.path.exists(spec): # Existing file or directory, just process it directly self.not_editable(spec) return self.install_item(None, spec, tmpdir, deps, True) else: spec = parse_requirement_arg(spec) self.check_editable(spec) dist = self.package_index.fetch_distribution( spec, tmpdir, self.upgrade, self.editable, not self.always_copy, self.local_index, ) if dist is None: msg = f"Could not find suitable distribution for {spec!r}" if self.always_copy: msg += " (--always-copy skips system and development eggs)" raise DistutilsError(msg) elif dist.precedence == DEVELOP_DIST: # .egg-info dists don't need installing, just process deps self.process_distribution(spec, dist, deps, "Using") return dist else: return self.install_item(spec, dist.location, tmpdir, deps) def install_item( self, spec, download, tmpdir, deps, install_needed: bool = False ) -> Distribution | None: # Installation is also needed if file in tmpdir or is not an egg install_needed = install_needed or bool(self.always_copy) install_needed = install_needed or os.path.dirname(download) == tmpdir install_needed = install_needed or not download.endswith('.egg') install_needed = install_needed or ( self.always_copy_from is not None and os.path.dirname(normalize_path(download)) == normalize_path(self.always_copy_from) ) if spec and not install_needed: # at this point, we know it's a local .egg, we just don't know if # it's already installed. for dist in self.local_index[spec.project_name]: if dist.location == download: break else: install_needed = True # it's not in the local index log.info("Processing %s", os.path.basename(download)) if install_needed: dists = self.install_eggs(spec, download, tmpdir) for dist in dists: self.process_distribution(spec, dist, deps) else: dists = [self.egg_distribution(download)] self.process_distribution(spec, dists[0], deps, "Using") if spec is not None: for dist in dists: if dist in spec: return dist return None def select_scheme(self, name): try: install._select_scheme(self, name) except AttributeError: # stdlib distutils install.install.select_scheme(self, name.replace('posix', 'unix')) # FIXME: 'easy_install.process_distribution' is too complex (12) def process_distribution( # noqa: C901 self, requirement, dist, deps: bool = True, *info, ) -> None: self.update_pth(dist) self.package_index.add(dist) if dist in self.local_index[dist.key]: self.local_index.remove(dist) self.local_index.add(dist) self.install_egg_scripts(dist) self.installed_projects[dist.key] = dist log.info(self.installation_report(requirement, dist, *info)) if dist.has_metadata('dependency_links.txt') and not self.no_find_links: self.package_index.add_find_links( dist.get_metadata_lines('dependency_links.txt') ) if not deps and not self.always_copy: return elif requirement is not None and dist.key != requirement.key: log.warn("Skipping dependencies for %s", dist) return # XXX this is not the distribution we were looking for elif requirement is None or dist not in requirement: # if we wound up with a different version, resolve what we've got distreq = dist.as_requirement() requirement = Requirement(str(distreq)) log.info("Processing dependencies for %s", requirement) try: distros = WorkingSet([]).resolve( [requirement], self.local_index, self.easy_install ) except DistributionNotFound as e: raise DistutilsError(str(e)) from e except VersionConflict as e: raise DistutilsError(e.report()) from e if self.always_copy or self.always_copy_from: # Force all the relevant distros to be copied or activated for dist in distros: if dist.key not in self.installed_projects: self.easy_install(dist.as_requirement()) log.info("Finished processing dependencies for %s", requirement) def should_unzip(self, dist) -> bool: if self.zip_ok is not None: return not self.zip_ok if dist.has_metadata('not-zip-safe'): return True if not dist.has_metadata('zip-safe'): return True return False def maybe_move(self, spec, dist_filename, setup_base): dst = os.path.join(self.build_directory, spec.key) if os.path.exists(dst): msg = "%r already exists in %s; build directory %s will not be kept" log.warn(msg, spec.key, self.build_directory, setup_base) return setup_base if os.path.isdir(dist_filename): setup_base = dist_filename else: if os.path.dirname(dist_filename) == setup_base: os.unlink(dist_filename) # get it out of the tmp dir contents = os.listdir(setup_base) if len(contents) == 1: dist_filename = os.path.join(setup_base, contents[0]) if os.path.isdir(dist_filename): # if the only thing there is a directory, move it instead setup_base = dist_filename ensure_directory(dst) shutil.move(setup_base, dst) return dst def install_wrapper_scripts(self, dist) -> None: if self.exclude_scripts: return for args in ScriptWriter.best().get_args(dist): self.write_script(*args) def install_script(self, dist, script_name, script_text, dev_path=None) -> None: """Generate a legacy script wrapper and install it""" spec = str(dist.as_requirement()) is_script = is_python_script(script_text, script_name) if is_script: body = self._load_template(dev_path) % locals() script_text = ScriptWriter.get_header(script_text) + body self.write_script(script_name, _to_bytes(script_text), 'b') @staticmethod def _load_template(dev_path): """ There are a couple of template scripts in the package. This function loads one of them and prepares it for use. """ # See https://github.com/pypa/setuptools/issues/134 for info # on script file naming and downstream issues with SVR4 name = 'script.tmpl' if dev_path: name = name.replace('.tmpl', ' (dev).tmpl') raw_bytes = resource_string('setuptools', name) return raw_bytes.decode('utf-8') def write_script(self, script_name, contents, mode: str = "t", blockers=()) -> None: """Write an executable file to the scripts directory""" self.delete_blockers( # clean up old .py/.pyw w/o a script [os.path.join(self.script_dir, x) for x in blockers] ) log.info("Installing %s script to %s", script_name, self.script_dir) target = os.path.join(self.script_dir, script_name) self.add_output(target) if self.dry_run: return mask = current_umask() ensure_directory(target) if os.path.exists(target): os.unlink(target) encoding = None if "b" in mode else "utf-8" with open(target, "w" + mode, encoding=encoding) as f: f.write(contents) chmod(target, 0o777 - mask) def install_eggs(self, spec, dist_filename, tmpdir) -> list[Distribution]: # .egg dirs or files are already built, so just return them installer_map = { '.egg': self.install_egg, '.exe': self.install_exe, '.whl': self.install_wheel, } try: install_dist = installer_map[dist_filename.lower()[-4:]] except KeyError: pass else: return [install_dist(dist_filename, tmpdir)] # Anything else, try to extract and build setup_base = tmpdir if os.path.isfile(dist_filename) and not dist_filename.endswith('.py'): unpack_archive(dist_filename, tmpdir, self.unpack_progress) elif os.path.isdir(dist_filename): setup_base = os.path.abspath(dist_filename) if ( setup_base.startswith(tmpdir) # something we downloaded and self.build_directory and spec is not None ): setup_base = self.maybe_move(spec, dist_filename, setup_base) # Find the setup.py file setup_script = os.path.join(setup_base, 'setup.py') if not os.path.exists(setup_script): setups = glob(os.path.join(setup_base, '*', 'setup.py')) if not setups: raise DistutilsError( f"Couldn't find a setup script in {os.path.abspath(dist_filename)}" ) if len(setups) > 1: raise DistutilsError( f"Multiple setup scripts in {os.path.abspath(dist_filename)}" ) setup_script = setups[0] # Now run it, and return the result if self.editable: log.info(self.report_editable(spec, setup_script)) return [] else: return self.build_and_install(setup_script, setup_base) def egg_distribution(self, egg_path): if os.path.isdir(egg_path): metadata = PathMetadata(egg_path, os.path.join(egg_path, 'EGG-INFO')) else: metadata = EggMetadata(zipimport.zipimporter(egg_path)) return Distribution.from_filename(egg_path, metadata=metadata) # FIXME: 'easy_install.install_egg' is too complex (11) def install_egg(self, egg_path, tmpdir): destination = os.path.join( self.install_dir, os.path.basename(egg_path), ) destination = os.path.abspath(destination) if not self.dry_run: ensure_directory(destination) dist = self.egg_distribution(egg_path) if not ( os.path.exists(destination) and os.path.samefile(egg_path, destination) ): if os.path.isdir(destination) and not os.path.islink(destination): dir_util.remove_tree(destination, dry_run=self.dry_run) elif os.path.exists(destination): self.execute( os.unlink, (destination,), "Removing " + destination, ) try: new_dist_is_zipped = False if os.path.isdir(egg_path): if egg_path.startswith(tmpdir): f, m = shutil.move, "Moving" else: f, m = shutil.copytree, "Copying" elif self.should_unzip(dist): self.mkpath(destination) f, m = self.unpack_and_compile, "Extracting" else: new_dist_is_zipped = True if egg_path.startswith(tmpdir): f, m = shutil.move, "Moving" else: f, m = shutil.copy2, "Copying" self.execute( f, (egg_path, destination), (m + " %s to %s") % (os.path.basename(egg_path), os.path.dirname(destination)), ) update_dist_caches( destination, fix_zipimporter_caches=new_dist_is_zipped, ) except Exception: update_dist_caches(destination, fix_zipimporter_caches=False) raise self.add_output(destination) return self.egg_distribution(destination) def install_exe(self, dist_filename, tmpdir): # See if it's valid, get data cfg = extract_wininst_cfg(dist_filename) if cfg is None: raise DistutilsError( f"{dist_filename} is not a valid distutils Windows .exe" ) # Create a dummy distribution object until we build the real distro dist = Distribution( None, project_name=cfg.get('metadata', 'name'), version=cfg.get('metadata', 'version'), platform=get_platform(), ) # Convert the .exe to an unpacked egg egg_path = os.path.join(tmpdir, dist.egg_name() + '.egg') dist.location = egg_path egg_tmp = egg_path + '.tmp' _egg_info = os.path.join(egg_tmp, 'EGG-INFO') pkg_inf = os.path.join(_egg_info, 'PKG-INFO') ensure_directory(pkg_inf) # make sure EGG-INFO dir exists dist._provider = PathMetadata(egg_tmp, _egg_info) # XXX self.exe_to_egg(dist_filename, egg_tmp) # Write EGG-INFO/PKG-INFO if not os.path.exists(pkg_inf): with open(pkg_inf, 'w', encoding="utf-8") as f: f.write('Metadata-Version: 1.0\n') for k, v in cfg.items('metadata'): if k != 'target_version': k = k.replace('_', '-').title() f.write(f'{k}: {v}\n') script_dir = os.path.join(_egg_info, 'scripts') # delete entry-point scripts to avoid duping self.delete_blockers([ os.path.join(script_dir, args[0]) for args in ScriptWriter.get_args(dist) ]) # Build .egg file from tmpdir bdist_egg.make_zipfile( egg_path, egg_tmp, verbose=self.verbose, dry_run=self.dry_run, ) # install the .egg return self.install_egg(egg_path, tmpdir) # FIXME: 'easy_install.exe_to_egg' is too complex (12) def exe_to_egg(self, dist_filename, egg_tmp) -> None: # noqa: C901 """Extract a bdist_wininst to the directories an egg would use""" # Check for .pth file and set up prefix translations prefixes = get_exe_prefixes(dist_filename) to_compile = [] native_libs = [] top_level = set() def process(src, dst): s = src.lower() for old, new in prefixes: if s.startswith(old): src = new + src[len(old) :] parts = src.split('/') dst = os.path.join(egg_tmp, *parts) dl = dst.lower() if dl.endswith('.pyd') or dl.endswith('.dll'): parts[-1] = bdist_egg.strip_module(parts[-1]) top_level.add([os.path.splitext(parts[0])[0]]) native_libs.append(src) elif dl.endswith('.py') and old != 'SCRIPTS/': top_level.add([os.path.splitext(parts[0])[0]]) to_compile.append(dst) return dst if not src.endswith('.pth'): log.warn("WARNING: can't process %s", src) return None # extract, tracking .pyd/.dll->native_libs and .py -> to_compile unpack_archive(dist_filename, egg_tmp, process) stubs = [] for res in native_libs: if res.lower().endswith('.pyd'): # create stubs for .pyd's parts = res.split('/') resource = parts[-1] parts[-1] = bdist_egg.strip_module(parts[-1]) + '.py' pyfile = os.path.join(egg_tmp, *parts) to_compile.append(pyfile) stubs.append(pyfile) bdist_egg.write_stub(resource, pyfile) self.byte_compile(to_compile) # compile .py's bdist_egg.write_safety_flag( os.path.join(egg_tmp, 'EGG-INFO'), bdist_egg.analyze_egg(egg_tmp, stubs) ) # write zip-safety flag for name in 'top_level', 'native_libs': if locals()[name]: txt = os.path.join(egg_tmp, 'EGG-INFO', name + '.txt') if not os.path.exists(txt): with open(txt, 'w', encoding="utf-8") as f: f.write('\n'.join(locals()[name]) + '\n') def install_wheel(self, wheel_path, tmpdir): wheel = Wheel(wheel_path) assert wheel.is_compatible() destination = os.path.join(self.install_dir, wheel.egg_name()) destination = os.path.abspath(destination) if not self.dry_run: ensure_directory(destination) if os.path.isdir(destination) and not os.path.islink(destination): dir_util.remove_tree(destination, dry_run=self.dry_run) elif os.path.exists(destination): self.execute( os.unlink, (destination,), "Removing " + destination, ) try: self.execute( wheel.install_as_egg, (destination,), ( f"Installing {os.path.basename(wheel_path)} to {os.path.dirname(destination)}" ), ) finally: update_dist_caches(destination, fix_zipimporter_caches=False) self.add_output(destination) return self.egg_distribution(destination) __mv_warning = textwrap.dedent( """ Because this distribution was installed --multi-version, before you can import modules from this package in an application, you will need to 'import pkg_resources' and then use a 'require()' call similar to one of these examples, in order to select the desired version: pkg_resources.require("%(name)s") # latest installed version pkg_resources.require("%(name)s==%(version)s") # this exact version pkg_resources.require("%(name)s>=%(version)s") # this version or higher """ ).lstrip() __id_warning = textwrap.dedent( """ Note also that the installation directory must be on sys.path at runtime for this to work. (e.g. by being the application's script directory, by being on PYTHONPATH, or by being added to sys.path by your code.) """ ) def installation_report(self, req, dist, what: str = "Installed") -> str: """Helpful installation message for display to package users""" msg = "\n%(what)s %(eggloc)s%(extras)s" if self.multi_version and not self.no_report: msg += '\n' + self.__mv_warning if self.install_dir not in map(normalize_path, sys.path): msg += '\n' + self.__id_warning eggloc = dist.location name = dist.project_name version = dist.version extras = '' # TODO: self.report_extras(req, dist) return msg % locals() __editable_msg = textwrap.dedent( """ Extracted editable version of %(spec)s to %(dirname)s If it uses setuptools in its setup script, you can activate it in "development" mode by going to that directory and running:: %(python)s setup.py develop See the setuptools documentation for the "develop" command for more info. """ ).lstrip() def report_editable(self, spec, setup_script): dirname = os.path.dirname(setup_script) python = sys.executable return '\n' + self.__editable_msg % locals() def run_setup(self, setup_script, setup_base, args) -> None: sys.modules.setdefault('distutils.command.bdist_egg', bdist_egg) sys.modules.setdefault('distutils.command.egg_info', egg_info) args = list(args) if self.verbose > 2: v = 'v' * (self.verbose - 1) args.insert(0, '-' + v) elif self.verbose < 2: args.insert(0, '-q') if self.dry_run: args.insert(0, '-n') log.info("Running %s %s", setup_script[len(setup_base) + 1 :], ' '.join(args)) try: run_setup(setup_script, args) except SystemExit as v: raise DistutilsError(f"Setup script exited with {v.args[0]}") from v def build_and_install(self, setup_script, setup_base): args = ['bdist_egg', '--dist-dir'] dist_dir = tempfile.mkdtemp( prefix='egg-dist-tmp-', dir=os.path.dirname(setup_script) ) try: self._set_fetcher_options(os.path.dirname(setup_script)) args.append(dist_dir) self.run_setup(setup_script, setup_base, args) all_eggs = Environment([dist_dir]) eggs = [ self.install_egg(dist.location, setup_base) for key in all_eggs for dist in all_eggs[key] ] if not eggs and not self.dry_run: log.warn("No eggs found in %s (setup script problem?)", dist_dir) return eggs finally: _rmtree(dist_dir) log.set_verbosity(self.verbose) # restore our log verbosity def _set_fetcher_options(self, base): """ When easy_install is about to run bdist_egg on a source dist, that source dist might have 'setup_requires' directives, requiring additional fetching. Ensure the fetcher options given to easy_install are available to that command as well. """ # find the fetch options from easy_install and write them out # to the setup.cfg file. ei_opts = self.distribution.get_option_dict('easy_install').copy() fetch_directives = ( 'find_links', 'site_dirs', 'index_url', 'optimize', 'allow_hosts', ) fetch_options = {} for key, val in ei_opts.items(): if key not in fetch_directives: continue fetch_options[key] = val[1] # create a settings dictionary suitable for `edit_config` settings = dict(easy_install=fetch_options) cfg_filename = os.path.join(base, 'setup.cfg') setopt.edit_config(cfg_filename, settings) def update_pth(self, dist) -> None: # noqa: C901 # is too complex (11) # FIXME if self.pth_file is None: return for d in self.pth_file[dist.key]: # drop old entries if not self.multi_version and d.location == dist.location: continue log.info("Removing %s from easy-install.pth file", d) self.pth_file.remove(d) if d.location in self.shadow_path: self.shadow_path.remove(d.location) if not self.multi_version: if dist.location in self.pth_file.paths: log.info( "%s is already the active version in easy-install.pth", dist, ) else: log.info("Adding %s to easy-install.pth file", dist) self.pth_file.add(dist) # add new entry if dist.location not in self.shadow_path: self.shadow_path.append(dist.location) if self.dry_run: return self.pth_file.save() if dist.key != 'setuptools': return # Ensure that setuptools itself never becomes unavailable! # XXX should this check for latest version? filename = os.path.join(self.install_dir, 'setuptools.pth') if os.path.islink(filename): os.unlink(filename) with open(filename, 'wt', encoding=py312.PTH_ENCODING) as f: # ^-- Python<3.13 require encoding="locale" instead of "utf-8", # see python/cpython#77102. f.write(self.pth_file.make_relative(dist.location) + '\n') def unpack_progress(self, src, dst): # Progress filter for unpacking log.debug("Unpacking %s to %s", src, dst) return dst # only unpack-and-compile skips files for dry run def unpack_and_compile(self, egg_path, destination) -> None: to_compile = [] to_chmod = [] def pf(src, dst): if dst.endswith('.py') and not src.startswith('EGG-INFO/'): to_compile.append(dst) elif dst.endswith('.dll') or dst.endswith('.so'): to_chmod.append(dst) self.unpack_progress(src, dst) return not self.dry_run and dst or None unpack_archive(egg_path, destination, pf) self.byte_compile(to_compile) if not self.dry_run: for f in to_chmod: mode = ((os.stat(f)[stat.ST_MODE]) | 0o555) & 0o7755 chmod(f, mode) def byte_compile(self, to_compile) -> None: if sys.dont_write_bytecode: return from distutils.util import byte_compile try: # try to make the byte compile messages quieter log.set_verbosity(self.verbose - 1) byte_compile(to_compile, optimize=0, force=True, dry_run=self.dry_run) if self.optimize: byte_compile( to_compile, optimize=self.optimize, force=True, dry_run=self.dry_run, ) finally: log.set_verbosity(self.verbose) # restore original verbosity __no_default_msg = textwrap.dedent( """ bad install directory or PYTHONPATH You are attempting to install a package to a directory that is not on PYTHONPATH and which Python does not read ".pth" files from. The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s and your PYTHONPATH environment variable currently contains: %r Here are some of your options for correcting the problem: * You can choose a different installation directory, i.e., one that is on PYTHONPATH or supports .pth files * You can add the installation directory to the PYTHONPATH environment variable. (It must then also be on PYTHONPATH whenever you run Python and want to use the package(s) you are installing.) * You can set up the installation directory to support ".pth" files by using one of the approaches described here: https://setuptools.pypa.io/en/latest/deprecated/easy_install.html#custom-installation-locations Please make the appropriate changes for your system and try again. """ ).strip() def create_home_path(self) -> None: """Create directories under ~.""" if not self.user: return home = convert_path(os.path.expanduser("~")) for path in only_strs(self.config_vars.values()): if path.startswith(home) and not os.path.isdir(path): self.debug_print(f"os.makedirs('{path}', 0o700)") os.makedirs(path, 0o700) INSTALL_SCHEMES = dict( posix=dict( install_dir='$base/lib/python$py_version_short/site-packages', script_dir='$base/bin', ), ) DEFAULT_SCHEME = dict( install_dir='$base/Lib/site-packages', script_dir='$base/Scripts', ) def _expand(self, *attrs): config_vars = self.get_finalized_command('install').config_vars if self.prefix: # Set default install_dir/scripts from --prefix config_vars = dict(config_vars) config_vars['base'] = self.prefix scheme = self.INSTALL_SCHEMES.get(os.name, self.DEFAULT_SCHEME) for attr, val in scheme.items(): if getattr(self, attr, None) is None: setattr(self, attr, val) from distutils.util import subst_vars for attr in attrs: val = getattr(self, attr) if val is not None: val = subst_vars(val, config_vars) if os.name == 'posix': val = os.path.expanduser(val) setattr(self, attr, val) def _pythonpath(): items = os.environ.get('PYTHONPATH', '').split(os.pathsep) return filter(None, items) def get_site_dirs(): """ Return a list of 'site' dirs """ sitedirs = [] # start with PYTHONPATH sitedirs.extend(_pythonpath()) prefixes = [sys.prefix] if sys.exec_prefix != sys.prefix: prefixes.append(sys.exec_prefix) for prefix in prefixes: if not prefix: continue if sys.platform in ('os2emx', 'riscos'): sitedirs.append(os.path.join(prefix, "Lib", "site-packages")) elif os.sep == '/': sitedirs.extend([ os.path.join( prefix, "lib", f"python{sys.version_info.major}.{sys.version_info.minor}", "site-packages", ), os.path.join(prefix, "lib", "site-python"), ]) else: sitedirs.extend([ prefix, os.path.join(prefix, "lib", "site-packages"), ]) if sys.platform != 'darwin': continue # for framework builds *only* we add the standard Apple # locations. Currently only per-user, but /Library and # /Network/Library could be added too if 'Python.framework' not in prefix: continue home = os.environ.get('HOME') if not home: continue home_sp = os.path.join( home, 'Library', 'Python', f'{sys.version_info.major}.{sys.version_info.minor}', 'site-packages', ) sitedirs.append(home_sp) lib_paths = get_path('purelib'), get_path('platlib') sitedirs.extend(s for s in lib_paths if s not in sitedirs) if site.ENABLE_USER_SITE: sitedirs.append(site.USER_SITE) with contextlib.suppress(AttributeError): sitedirs.extend(site.getsitepackages()) return list(map(normalize_path, sitedirs)) def expand_paths(inputs): # noqa: C901 # is too complex (11) # FIXME """Yield sys.path directories that might contain "old-style" packages""" seen = set() for dirname in inputs: dirname = normalize_path(dirname) if dirname in seen: continue seen.add(dirname) if not os.path.isdir(dirname): continue files = os.listdir(dirname) yield dirname, files for name in files: if not name.endswith('.pth'): # We only care about the .pth files continue if name in ('easy-install.pth', 'setuptools.pth'): # Ignore .pth files that we control continue # Read the .pth file content = _read_pth(os.path.join(dirname, name)) lines = list(yield_lines(content)) # Yield existing non-dupe, non-import directory lines from it for line in lines: if line.startswith("import"): continue line = normalize_path(line.rstrip()) if line in seen: continue seen.add(line) if not os.path.isdir(line): continue yield line, os.listdir(line) def extract_wininst_cfg(dist_filename): """Extract configuration data from a bdist_wininst .exe Returns a configparser.RawConfigParser, or None """ f = open(dist_filename, 'rb') try: endrec = zipfile._EndRecData(f) if endrec is None: return None prepended = (endrec[9] - endrec[5]) - endrec[6] if prepended < 12: # no wininst data here return None f.seek(prepended - 12) tag, cfglen, _bmlen = struct.unpack("<iii", f.read(12)) if tag not in (0x1234567A, 0x1234567B): return None # not a valid tag f.seek(prepended - (12 + cfglen)) init = {'version': '', 'target_version': ''} cfg = configparser.RawConfigParser(init) try: part = f.read(cfglen) # Read up to the first null byte. config = part.split(b'\0', 1)[0] # Now the config is in bytes, but for RawConfigParser, it should # be text, so decode it. config = config.decode(sys.getfilesystemencoding()) cfg.read_file(io.StringIO(config)) except configparser.Error: return None if not cfg.has_section('metadata') or not cfg.has_section('Setup'): return None return cfg finally: f.close() def get_exe_prefixes(exe_filename): """Get exe->egg path translations for a given .exe file""" prefixes = [ ('PURELIB/', ''), ('PLATLIB/pywin32_system32', ''), ('PLATLIB/', ''), ('SCRIPTS/', 'EGG-INFO/scripts/'), ('DATA/lib/site-packages', ''), ] z = zipfile.ZipFile(exe_filename) try: for info in z.infolist(): name = info.filename parts = name.split('/') if len(parts) == 3 and parts[2] == 'PKG-INFO': if parts[1].endswith('.egg-info'): prefixes.insert(0, ('/'.join(parts[:2]), 'EGG-INFO/')) break if len(parts) != 2 or not name.endswith('.pth'): continue if name.endswith('-nspkg.pth'): continue if parts[0].upper() in ('PURELIB', 'PLATLIB'): contents = z.read(name).decode() for pth in yield_lines(contents): pth = pth.strip().replace('\\', '/') if not pth.startswith('import'): prefixes.append(((f'{parts[0]}/{pth}/'), '')) finally: z.close() prefixes = [(x.lower(), y) for x, y in prefixes] prefixes.sort() prefixes.reverse() return prefixes class PthDistributions(Environment): """A .pth file with Distribution paths in it""" def __init__(self, filename, sitedirs=()) -> None: self.filename = filename self.sitedirs = list(map(normalize_path, sitedirs)) self.basedir = normalize_path(os.path.dirname(self.filename)) self.paths, self.dirty = self._load() # keep a copy if someone manually updates the paths attribute on the instance self._init_paths = self.paths[:] super().__init__([], None, None) for path in yield_lines(self.paths): list(map(self.add, find_distributions(path, True))) def _load_raw(self): paths = [] dirty = saw_import = False seen = set(self.sitedirs) content = _read_pth(self.filename) for line in content.splitlines(): path = line.rstrip() # still keep imports and empty/commented lines for formatting paths.append(path) if line.startswith(('import ', 'from ')): saw_import = True continue stripped_path = path.strip() if not stripped_path or stripped_path.startswith('#'): continue # skip non-existent paths, in case somebody deleted a package # manually, and duplicate paths as well normalized_path = normalize_path(os.path.join(self.basedir, path)) if normalized_path in seen or not os.path.exists(normalized_path): log.debug("cleaned up dirty or duplicated %r", path) dirty = True paths.pop() continue seen.add(normalized_path) # remove any trailing empty/blank line while paths and not paths[-1].strip(): paths.pop() dirty = True return paths, dirty or (paths and saw_import) def _load(self): if os.path.isfile(self.filename): return self._load_raw() return [], False def save(self) -> None: """Write changed .pth file back to disk""" # first reload the file last_paths, last_dirty = self._load() # and check that there are no difference with what we have. # there can be difference if someone else has written to the file # since we first loaded it. # we don't want to lose the eventual new paths added since then. for path in last_paths[:]: if path not in self.paths: self.paths.append(path) log.info("detected new path %r", path) last_dirty = True else: last_paths.remove(path) # also, re-check that all paths are still valid before saving them for path in self.paths[:]: if path not in last_paths and not path.startswith(( 'import ', 'from ', '#', )): absolute_path = os.path.join(self.basedir, path) if not os.path.exists(absolute_path): self.paths.remove(path) log.info("removing now non-existent path %r", path) last_dirty = True self.dirty |= last_dirty or self.paths != self._init_paths if not self.dirty: return rel_paths = list(map(self.make_relative, self.paths)) if rel_paths: log.debug("Saving %s", self.filename) lines = self._wrap_lines(rel_paths) data = '\n'.join(lines) + '\n' if os.path.islink(self.filename): os.unlink(self.filename) with open(self.filename, 'wt', encoding=py312.PTH_ENCODING) as f: # ^-- Python<3.13 require encoding="locale" instead of "utf-8", # see python/cpython#77102. f.write(data) elif os.path.exists(self.filename): log.debug("Deleting empty %s", self.filename) os.unlink(self.filename) self.dirty = False self._init_paths[:] = self.paths[:] @staticmethod def _wrap_lines(lines): return lines def add(self, dist) -> None: """Add `dist` to the distribution map""" new_path = dist.location not in self.paths and ( dist.location not in self.sitedirs or # account for '.' being in PYTHONPATH dist.location == os.getcwd() ) if new_path: self.paths.append(dist.location) self.dirty = True super().add(dist) def remove(self, dist) -> None: """Remove `dist` from the distribution map""" while dist.location in self.paths: self.paths.remove(dist.location) self.dirty = True super().remove(dist) def make_relative(self, path): npath, last = os.path.split(normalize_path(path)) baselen = len(self.basedir) parts = [last] sep = os.altsep == '/' and '/' or os.sep while len(npath) >= baselen: if npath == self.basedir: parts.append(os.curdir) parts.reverse() return sep.join(parts) npath, last = os.path.split(npath) parts.append(last) else: return path class RewritePthDistributions(PthDistributions): @classmethod def _wrap_lines(cls, lines): yield cls.prelude yield from lines yield cls.postlude prelude = _one_liner( """ import sys sys.__plen = len(sys.path) """ ) postlude = _one_liner( """ import sys new = sys.path[sys.__plen:] del sys.path[sys.__plen:] p = getattr(sys, '__egginsert', 0) sys.path[p:p] = new sys.__egginsert = p + len(new) """ ) if os.environ.get('SETUPTOOLS_SYS_PATH_TECHNIQUE', 'raw') == 'rewrite': PthDistributions = RewritePthDistributions # type: ignore[misc] # Overwriting type def _first_line_re(): """ Return a regular expression based on first_line_re suitable for matching strings. """ if isinstance(first_line_re.pattern, str): return first_line_re # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern. return re.compile(first_line_re.pattern.decode()) def update_dist_caches(dist_path, fix_zipimporter_caches): """ Fix any globally cached `dist_path` related data `dist_path` should be a path of a newly installed egg distribution (zipped or unzipped). sys.path_importer_cache contains finder objects that have been cached when importing data from the original distribution. Any such finders need to be cleared since the replacement distribution might be packaged differently, e.g. a zipped egg distribution might get replaced with an unzipped egg folder or vice versa. Having the old finders cached may then cause Python to attempt loading modules from the replacement distribution using an incorrect loader. zipimport.zipimporter objects are Python loaders charged with importing data packaged inside zip archives. If stale loaders referencing the original distribution, are left behind, they can fail to load modules from the replacement distribution. E.g. if an old zipimport.zipimporter instance is used to load data from a new zipped egg archive, it may cause the operation to attempt to locate the requested data in the wrong location - one indicated by the original distribution's zip archive directory information. Such an operation may then fail outright, e.g. report having read a 'bad local file header', or even worse, it may fail silently & return invalid data. zipimport._zip_directory_cache contains cached zip archive directory information for all existing zipimport.zipimporter instances and all such instances connected to the same archive share the same cached directory information. If asked, and the underlying Python implementation allows it, we can fix all existing zipimport.zipimporter instances instead of having to track them down and remove them one by one, by updating their shared cached zip archive directory information. This, of course, assumes that the replacement distribution is packaged as a zipped egg. If not asked to fix existing zipimport.zipimporter instances, we still do our best to clear any remaining zipimport.zipimporter related cached data that might somehow later get used when attempting to load data from the new distribution and thus cause such load operations to fail. Note that when tracking down such remaining stale data, we can not catch every conceivable usage from here, and we clear only those that we know of and have found to cause problems if left alive. Any remaining caches should be updated by whomever is in charge of maintaining them, i.e. they should be ready to handle us replacing their zip archives with new distributions at runtime. """ # There are several other known sources of stale zipimport.zipimporter # instances that we do not clear here, but might if ever given a reason to # do so: # * Global setuptools pkg_resources.working_set (a.k.a. 'master working # set') may contain distributions which may in turn contain their # zipimport.zipimporter loaders. # * Several zipimport.zipimporter loaders held by local variables further # up the function call stack when running the setuptools installation. # * Already loaded modules may have their __loader__ attribute set to the # exact loader instance used when importing them. Python 3.4 docs state # that this information is intended mostly for introspection and so is # not expected to cause us problems. normalized_path = normalize_path(dist_path) _uncache(normalized_path, sys.path_importer_cache) if fix_zipimporter_caches: _replace_zip_directory_cache_data(normalized_path) else: # Here, even though we do not want to fix existing and now stale # zipimporter cache information, we still want to remove it. Related to # Python's zip archive directory information cache, we clear each of # its stale entries in two phases: # 1. Clear the entry so attempting to access zip archive information # via any existing stale zipimport.zipimporter instances fails. # 2. Remove the entry from the cache so any newly constructed # zipimport.zipimporter instances do not end up using old stale # zip archive directory information. # This whole stale data removal step does not seem strictly necessary, # but has been left in because it was done before we started replacing # the zip archive directory information cache content if possible, and # there are no relevant unit tests that we can depend on to tell us if # this is really needed. _remove_and_clear_zip_directory_cache_data(normalized_path) def _collect_zipimporter_cache_entries(normalized_path, cache): """ Return zipimporter cache entry keys related to a given normalized path. Alternative path spellings (e.g. those using different character case or those using alternative path separators) related to the same path are included. Any sub-path entries are included as well, i.e. those corresponding to zip archives embedded in other zip archives. """ result = [] prefix_len = len(normalized_path) for p in cache: np = normalize_path(p) if np.startswith(normalized_path) and np[prefix_len : prefix_len + 1] in ( os.sep, '', ): result.append(p) return result def _update_zipimporter_cache(normalized_path, cache, updater=None): """ Update zipimporter cache data for a given normalized path. Any sub-path entries are processed as well, i.e. those corresponding to zip archives embedded in other zip archives. Given updater is a callable taking a cache entry key and the original entry (after already removing the entry from the cache), and expected to update the entry and possibly return a new one to be inserted in its place. Returning None indicates that the entry should not be replaced with a new one. If no updater is given, the cache entries are simply removed without any additional processing, the same as if the updater simply returned None. """ for p in _collect_zipimporter_cache_entries(normalized_path, cache): # N.B. pypy's custom zipimport._zip_directory_cache implementation does # not support the complete dict interface: # * Does not support item assignment, thus not allowing this function # to be used only for removing existing cache entries. # * Does not support the dict.pop() method, forcing us to use the # get/del patterns instead. For more detailed information see the # following links: # https://github.com/pypa/setuptools/issues/202#issuecomment-202913420 # https://foss.heptapod.net/pypy/pypy/-/blob/144c4e65cb6accb8e592f3a7584ea38265d1873c/pypy/module/zipimport/interp_zipimport.py old_entry = cache[p] del cache[p] new_entry = updater and updater(p, old_entry) if new_entry is not None: cache[p] = new_entry def _uncache(normalized_path, cache): _update_zipimporter_cache(normalized_path, cache) def _remove_and_clear_zip_directory_cache_data(normalized_path): def clear_and_remove_cached_zip_archive_directory_data(path, old_entry): old_entry.clear() _update_zipimporter_cache( normalized_path, zipimport._zip_directory_cache, updater=clear_and_remove_cached_zip_archive_directory_data, ) # PyPy Python implementation does not allow directly writing to the # zipimport._zip_directory_cache and so prevents us from attempting to correct # its content. The best we can do there is clear the problematic cache content # and have PyPy repopulate it as needed. The downside is that if there are any # stale zipimport.zipimporter instances laying around, attempting to use them # will fail due to not having its zip archive directory information available # instead of being automatically corrected to use the new correct zip archive # directory information. if '__pypy__' in sys.builtin_module_names: _replace_zip_directory_cache_data = _remove_and_clear_zip_directory_cache_data else: def _replace_zip_directory_cache_data(normalized_path): def replace_cached_zip_archive_directory_data(path, old_entry): # N.B. In theory, we could load the zip directory information just # once for all updated path spellings, and then copy it locally and # update its contained path strings to contain the correct # spelling, but that seems like a way too invasive move (this cache # structure is not officially documented anywhere and could in # theory change with new Python releases) for no significant # benefit. old_entry.clear() zipimport.zipimporter(path) old_entry.update(zipimport._zip_directory_cache[path]) return old_entry _update_zipimporter_cache( normalized_path, zipimport._zip_directory_cache, updater=replace_cached_zip_archive_directory_data, ) def is_python(text, filename='<string>'): "Is this string a valid Python script?" try: compile(text, filename, 'exec') except (SyntaxError, TypeError): return False else: return True def is_sh(executable): """Determine if the specified executable is a .sh (contains a #! line)""" try: with open(executable, encoding='latin-1') as fp: magic = fp.read(2) except OSError: return executable return magic == '#!' def nt_quote_arg(arg): """Quote a command line argument according to Windows parsing rules""" return subprocess.list2cmdline([arg]) def is_python_script(script_text, filename): """Is this text, as a whole, a Python script? (as opposed to shell/bat/etc.""" if filename.endswith('.py') or filename.endswith('.pyw'): return True # extension says it's Python if is_python(script_text, filename): return True # it's syntactically valid Python if script_text.startswith('#!'): # It begins with a '#!' line, so check if 'python' is in it somewhere return 'python' in script_text.splitlines()[0].lower() return False # Not any Python I can recognize class _SplitArgs(TypedDict, total=False): comments: bool posix: bool class CommandSpec(list): """ A command spec for a #! header, specified as a list of arguments akin to those passed to Popen. """ options: list[str] = [] split_args = _SplitArgs() @classmethod def best(cls): """ Choose the best CommandSpec class based on environmental conditions. """ return cls @classmethod def _sys_executable(cls): _default = os.path.normpath(sys.executable) return os.environ.get('__PYVENV_LAUNCHER__', _default) @classmethod def from_param(cls, param: Self | str | Iterable[str] | None) -> Self: """ Construct a CommandSpec from a parameter to build_scripts, which may be None. """ if isinstance(param, cls): return param if isinstance(param, str): return cls.from_string(param) if isinstance(param, Iterable): return cls(param) if param is None: return cls.from_environment() raise TypeError(f"Argument has an unsupported type {type(param)}") @classmethod def from_environment(cls): return cls([cls._sys_executable()]) @classmethod def from_string(cls, string: str) -> Self: """ Construct a command spec from a simple string representing a command line parseable by shlex.split. """ items = shlex.split(string, **cls.split_args) return cls(items) def install_options(self, script_text: str): self.options = shlex.split(self._extract_options(script_text)) cmdline = subprocess.list2cmdline(self) if not isascii(cmdline): self.options[:0] = ['-x'] @staticmethod def _extract_options(orig_script): """ Extract any options from the first line of the script. """ first = (orig_script + '\n').splitlines()[0] match = _first_line_re().match(first) options = match.group(1) or '' if match else '' return options.strip() def as_header(self): return self._render(self + list(self.options)) @staticmethod def _strip_quotes(item): _QUOTES = '"\'' for q in _QUOTES: if item.startswith(q) and item.endswith(q): return item[1:-1] return item @staticmethod def _render(items): cmdline = subprocess.list2cmdline( CommandSpec._strip_quotes(item.strip()) for item in items ) return '#!' + cmdline + '\n' # For pbr compat; will be removed in a future version. sys_executable = CommandSpec._sys_executable() class WindowsCommandSpec(CommandSpec): split_args = _SplitArgs(posix=False) class ScriptWriter: """ Encapsulates behavior around writing entry point scripts for console and gui apps. """ template = textwrap.dedent( r""" # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r import re import sys # for compatibility with easy_install; see #2198 __requires__ = %(spec)r try: from importlib.metadata import distribution except ImportError: try: from importlib_metadata import distribution except ImportError: from pkg_resources import load_entry_point def importlib_load_entry_point(spec, group, name): dist_name, _, _ = spec.partition('==') matches = ( entry_point for entry_point in distribution(dist_name).entry_points if entry_point.group == group and entry_point.name == name ) return next(matches).load() globals().setdefault('load_entry_point', importlib_load_entry_point) if __name__ == '__main__': sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0]) sys.exit(load_entry_point(%(spec)r, %(group)r, %(name)r)()) """ ).lstrip() command_spec_class = CommandSpec @classmethod def get_args(cls, dist, header=None): """ Yield write_script() argument tuples for a distribution's console_scripts and gui_scripts entry points. """ if header is None: header = cls.get_header() spec = str(dist.as_requirement()) for type_ in 'console', 'gui': group = type_ + '_scripts' for name in dist.get_entry_map(group).keys(): cls._ensure_safe_name(name) script_text = cls.template % locals() args = cls._get_script_args(type_, name, header, script_text) yield from args @staticmethod def _ensure_safe_name(name): """ Prevent paths in *_scripts entry point names. """ has_path_sep = re.search(r'[\\/]', name) if has_path_sep: raise ValueError("Path separators not allowed in script names") @classmethod def best(cls): """ Select the best ScriptWriter for this environment. """ if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'): return WindowsScriptWriter.best() else: return cls @classmethod def _get_script_args(cls, type_, name, header, script_text): # Simply write the stub with no extension. yield (name, header + script_text) @classmethod def get_header( cls, script_text: str = "", executable: str | CommandSpec | Iterable[str] | None = None, ) -> str: """Create a #! line, getting options (if any) from script_text""" cmd = cls.command_spec_class.best().from_param(executable) cmd.install_options(script_text) return cmd.as_header() class WindowsScriptWriter(ScriptWriter): command_spec_class = WindowsCommandSpec @classmethod def best(cls): """ Select the best ScriptWriter suitable for Windows """ writer_lookup = dict( executable=WindowsExecutableLauncherWriter, natural=cls, ) # for compatibility, use the executable launcher by default launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable') return writer_lookup[launcher] @classmethod def _get_script_args(cls, type_, name, header, script_text): "For Windows, add a .py extension" ext = dict(console='.pya', gui='.pyw')[type_] if ext not in os.environ['PATHEXT'].lower().split(';'): msg = ( "{ext} not listed in PATHEXT; scripts will not be " "recognized as executables." ).format(**locals()) SetuptoolsWarning.emit(msg) old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe'] old.remove(ext) header = cls._adjust_header(type_, header) blockers = [name + x for x in old] yield name + ext, header + script_text, 't', blockers @classmethod def _adjust_header(cls, type_, orig_header): """ Make sure 'pythonw' is used for gui and 'python' is used for console (regardless of what sys.executable is). """ pattern = 'pythonw.exe' repl = 'python.exe' if type_ == 'gui': pattern, repl = repl, pattern pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE) new_header = pattern_ob.sub(string=orig_header, repl=repl) return new_header if cls._use_header(new_header) else orig_header @staticmethod def _use_header(new_header): """ Should _adjust_header use the replaced header? On non-windows systems, always use. On Windows systems, only use the replaced header if it resolves to an executable on the system. """ clean_header = new_header[2:-1].strip('"') return sys.platform != 'win32' or shutil.which(clean_header) class WindowsExecutableLauncherWriter(WindowsScriptWriter): @classmethod def _get_script_args(cls, type_, name, header, script_text): """ For Windows, add a .py extension and an .exe launcher """ if type_ == 'gui': launcher_type = 'gui' ext = '-script.pyw' old = ['.pyw'] else: launcher_type = 'cli' ext = '-script.py' old = ['.py', '.pyc', '.pyo'] hdr = cls._adjust_header(type_, header) blockers = [name + x for x in old] yield (name + ext, hdr + script_text, 't', blockers) yield ( name + '.exe', get_win_launcher(launcher_type), 'b', # write in binary mode ) if not is_64bit(): # install a manifest for the launcher to prevent Windows # from detecting it as an installer (which it will for # launchers like easy_install.exe). Consider only # adding a manifest for launchers detected as installers. # See Distribute #143 for details. m_name = name + '.exe.manifest' yield (m_name, load_launcher_manifest(name), 't') def get_win_launcher(type): """ Load the Windows launcher (executable) suitable for launching a script. `type` should be either 'cli' or 'gui' Returns the executable as a byte string. """ launcher_fn = f'{type}.exe' if is_64bit(): if get_platform() == "win-arm64": launcher_fn = launcher_fn.replace(".", "-arm64.") else: launcher_fn = launcher_fn.replace(".", "-64.") else: launcher_fn = launcher_fn.replace(".", "-32.") return resource_string('setuptools', launcher_fn) def load_launcher_manifest(name): manifest = pkg_resources.resource_string(__name__, 'launcher manifest.xml') return manifest.decode('utf-8') % vars() def current_umask(): tmp = os.umask(0o022) os.umask(tmp) return tmp def only_strs(values): """ Exclude non-str values. Ref #3063. """ return filter(lambda val: isinstance(val, str), values) def _read_pth(fullname: str) -> str: # Python<3.13 require encoding="locale" instead of "utf-8", see python/cpython#77102 # In the case old versions of setuptools are producing `pth` files with # different encodings that might be problematic... So we fallback to "locale". try: with open(fullname, encoding=py312.PTH_ENCODING) as f: return f.read() except UnicodeDecodeError: # pragma: no cover # This error may only happen for Python >= 3.13 # TODO: Possible deprecation warnings to be added in the future: # ``.pth file {fullname!r} is not UTF-8.`` # Your environment contain {fullname!r} that cannot be read as UTF-8. # This is likely to have been produced with an old version of setuptools. # Please be mindful that this is deprecated and in the future, non-utf8 # .pth files may cause setuptools to fail. with open(fullname, encoding=py39.LOCALE_ENCODING) as f: return f.read() class EasyInstallDeprecationWarning(SetuptoolsDeprecationWarning): _SUMMARY = "easy_install command is deprecated." _DETAILS = """ Please avoid running ``setup.py`` and ``easy_install``. Instead, use pypa/build, pypa/installer or other standards-based tools. """ _SEE_URL = "https://github.com/pypa/setuptools/issues/917" # _DUE_DATE not defined yet command/test.py 0000644 00000002477 15030122015 0007512 0 ustar 00 from __future__ import annotations from setuptools import Command from setuptools.warnings import SetuptoolsDeprecationWarning # Would restrict to Literal["test"], but mypy doesn't support it: https://github.com/python/mypy/issues/8203 def __getattr__(name: str) -> type[_test]: if name == 'test': SetuptoolsDeprecationWarning.emit( "The test command is disabled and references to it are deprecated.", "Please remove any references to `setuptools.command.test` in all " "supported versions of the affected package.", due_date=(2024, 11, 15), stacklevel=2, ) return _test raise AttributeError(name) class _test(Command): """ Stub to warn when test command is referenced or used. """ description = "stub for old test command (do not use)" user_options = [ ('test-module=', 'm', "Run 'test_suite' in specified module"), ( 'test-suite=', 's', "Run single test, case or suite (e.g. 'module.test_suite')", ), ('test-runner=', 'r', "Test runner to use"), ] def initialize_options(self): pass def finalize_options(self): pass def run(self): raise RuntimeError("Support for the test command was removed in Setuptools 72") command/install.py 0000644 00000015606 15030122015 0010177 0 ustar 00 from __future__ import annotations import glob import inspect import platform from collections.abc import Callable from typing import TYPE_CHECKING, Any, ClassVar, cast import setuptools from ..dist import Distribution from ..warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning from .bdist_egg import bdist_egg as bdist_egg_cls import distutils.command.install as orig from distutils.errors import DistutilsArgError if TYPE_CHECKING: # This is only used for a type-cast, don't import at runtime or it'll cause deprecation warnings from .easy_install import easy_install as easy_install_cls else: easy_install_cls = None def __getattr__(name: str): # pragma: no cover if name == "_install": SetuptoolsDeprecationWarning.emit( "`setuptools.command._install` was an internal implementation detail " + "that was left in for numpy<1.9 support.", due_date=(2025, 5, 2), # Originally added on 2024-11-01 ) return orig.install raise AttributeError(f"module {__name__!r} has no attribute {name!r}") class install(orig.install): """Use easy_install to install the package, w/dependencies""" distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution user_options = orig.install.user_options + [ ('old-and-unmanageable', None, "Try not to use this!"), ( 'single-version-externally-managed', None, "used by system package builders to create 'flat' eggs", ), ] boolean_options = orig.install.boolean_options + [ 'old-and-unmanageable', 'single-version-externally-managed', ] # Type the same as distutils.command.install.install.sub_commands # Must keep the second tuple item potentially None due to invariance new_commands: ClassVar[list[tuple[str, Callable[[Any], bool] | None]]] = [ ('install_egg_info', lambda self: True), ('install_scripts', lambda self: True), ] _nc = dict(new_commands) def initialize_options(self): SetuptoolsDeprecationWarning.emit( "setup.py install is deprecated.", """ Please avoid running ``setup.py`` directly. Instead, use pypa/build, pypa/installer or other standards-based tools. """, see_url="https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html", # TODO: Document how to bootstrap setuptools without install # (e.g. by unzipping the wheel file) # and then add a due_date to this warning. ) super().initialize_options() self.old_and_unmanageable = None self.single_version_externally_managed = None def finalize_options(self) -> None: super().finalize_options() if self.root: self.single_version_externally_managed = True elif self.single_version_externally_managed: if not self.root and not self.record: raise DistutilsArgError( "You must specify --record or --root when building system packages" ) def handle_extra_path(self): if self.root or self.single_version_externally_managed: # explicit backward-compatibility mode, allow extra_path to work return orig.install.handle_extra_path(self) # Ignore extra_path when installing an egg (or being run by another # command without --root or --single-version-externally-managed self.path_file = None self.extra_dirs = '' return None def run(self): # Explicit request for old-style install? Just do it if self.old_and_unmanageable or self.single_version_externally_managed: return super().run() if not self._called_from_setup(inspect.currentframe()): # Run in backward-compatibility mode to support bdist_* commands. super().run() else: self.do_egg_install() return None @staticmethod def _called_from_setup(run_frame): """ Attempt to detect whether run() was called from setup() or by another command. If called by setup(), the parent caller will be the 'run_command' method in 'distutils.dist', and *its* caller will be the 'run_commands' method. If called any other way, the immediate caller *might* be 'run_command', but it won't have been called by 'run_commands'. Return True in that case or if a call stack is unavailable. Return False otherwise. """ if run_frame is None: msg = "Call stack not available. bdist_* commands may fail." SetuptoolsWarning.emit(msg) if platform.python_implementation() == 'IronPython': msg = "For best results, pass -X:Frames to enable call stack." SetuptoolsWarning.emit(msg) return True frames = inspect.getouterframes(run_frame) for frame in frames[2:4]: (caller,) = frame[:1] info = inspect.getframeinfo(caller) caller_module = caller.f_globals.get('__name__', '') if caller_module == "setuptools.dist" and info.function == "run_command": # Starting from v61.0.0 setuptools overwrites dist.run_command continue return caller_module == 'distutils.dist' and info.function == 'run_commands' return False def do_egg_install(self) -> None: easy_install = self.distribution.get_command_class('easy_install') cmd = cast( # We'd want to cast easy_install as type[easy_install_cls] but a bug in # mypy makes it think easy_install() returns a Command on Python 3.12+ # https://github.com/python/mypy/issues/18088 easy_install_cls, easy_install( # type: ignore[call-arg] self.distribution, args="x", root=self.root, record=self.record, ), ) cmd.ensure_finalized() # finalize before bdist_egg munges install cmd cmd.always_copy_from = '.' # make sure local-dir eggs get installed # pick up setup-dir .egg files only: no .egg-info cmd.package_index.scan(glob.glob('*.egg')) self.run_command('bdist_egg') bdist_egg = cast(bdist_egg_cls, self.distribution.get_command_obj('bdist_egg')) args = [bdist_egg.egg_output] if setuptools.bootstrap_install_from: # Bootstrap self-installation of setuptools args.insert(0, setuptools.bootstrap_install_from) cmd.args = args cmd.run(show_deprecation=False) setuptools.bootstrap_install_from = None # XXX Python 3.1 doesn't see _nc if this is inside the class install.sub_commands = [ cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc ] + install.new_commands command/build_py.py 0000644 00000036263 15030122015 0010342 0 ustar 00 from __future__ import annotations import fnmatch import itertools import os import stat import textwrap from collections.abc import Iterable, Iterator from functools import partial from glob import glob from pathlib import Path from more_itertools import unique_everseen from .._path import StrPath, StrPathT from ..dist import Distribution from ..warnings import SetuptoolsDeprecationWarning import distutils.command.build_py as orig import distutils.errors from distutils.util import convert_path _IMPLICIT_DATA_FILES = ('*.pyi', 'py.typed') def make_writable(target) -> None: os.chmod(target, os.stat(target).st_mode | stat.S_IWRITE) class build_py(orig.build_py): """Enhanced 'build_py' command that includes data files with packages The data files are specified via a 'package_data' argument to 'setup()'. See 'setuptools.dist.Distribution' for more details. Also, this version of the 'build_py' command allows you to specify both 'py_modules' and 'packages' in the same setup operation. """ distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution editable_mode: bool = False existing_egg_info_dir: StrPath | None = None #: Private API, internal use only. def finalize_options(self): orig.build_py.finalize_options(self) self.package_data = self.distribution.package_data self.exclude_package_data = self.distribution.exclude_package_data or {} if 'data_files' in self.__dict__: del self.__dict__['data_files'] def copy_file( # type: ignore[override] # No overload, no bytes support self, infile: StrPath, outfile: StrPathT, preserve_mode: bool = True, preserve_times: bool = True, link: str | None = None, level: object = 1, ) -> tuple[StrPathT | str, bool]: # Overwrite base class to allow using links if link: infile = str(Path(infile).resolve()) outfile = str(Path(outfile).resolve()) # type: ignore[assignment] # Re-assigning a str when outfile is StrPath is ok return super().copy_file( # pyright: ignore[reportReturnType] # pypa/distutils#309 infile, outfile, preserve_mode, preserve_times, link, level ) def run(self) -> None: """Build modules, packages, and copy data files to build directory""" if not (self.py_modules or self.packages) or self.editable_mode: return if self.py_modules: self.build_modules() if self.packages: self.build_packages() self.build_package_data() # Only compile actual .py files, using our base class' idea of what our # output files are. self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=False)) def __getattr__(self, attr: str): "lazily compute data files" if attr == 'data_files': self.data_files = self._get_data_files() return self.data_files return orig.build_py.__getattr__(self, attr) def _get_data_files(self): """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" self.analyze_manifest() return list(map(self._get_pkg_data_files, self.packages or ())) def get_data_files_without_manifest(self): """ Generate list of ``(package,src_dir,build_dir,filenames)`` tuples, but without triggering any attempt to analyze or build the manifest. """ # Prevent eventual errors from unset `manifest_files` # (that would otherwise be set by `analyze_manifest`) self.__dict__.setdefault('manifest_files', {}) return list(map(self._get_pkg_data_files, self.packages or ())) def _get_pkg_data_files(self, package): # Locate package source directory src_dir = self.get_package_dir(package) # Compute package build directory build_dir = os.path.join(*([self.build_lib] + package.split('.'))) # Strip directory from globbed filenames filenames = [ os.path.relpath(file, src_dir) for file in self.find_data_files(package, src_dir) ] return package, src_dir, build_dir, filenames def find_data_files(self, package, src_dir): """Return filenames for package's data files in 'src_dir'""" patterns = self._get_platform_patterns( self.package_data, package, src_dir, extra_patterns=_IMPLICIT_DATA_FILES, ) globs_expanded = map(partial(glob, recursive=True), patterns) # flatten the expanded globs into an iterable of matches globs_matches = itertools.chain.from_iterable(globs_expanded) glob_files = filter(os.path.isfile, globs_matches) files = itertools.chain( self.manifest_files.get(package, []), glob_files, ) return self.exclude_data_files(package, src_dir, files) def get_outputs(self, include_bytecode: bool = True) -> list[str]: # type: ignore[override] # Using a real boolean instead of 0|1 """See :class:`setuptools.commands.build.SubCommand`""" if self.editable_mode: return list(self.get_output_mapping().keys()) return super().get_outputs(include_bytecode) def get_output_mapping(self) -> dict[str, str]: """See :class:`setuptools.commands.build.SubCommand`""" mapping = itertools.chain( self._get_package_data_output_mapping(), self._get_module_mapping(), ) return dict(sorted(mapping, key=lambda x: x[0])) def _get_module_mapping(self) -> Iterator[tuple[str, str]]: """Iterate over all modules producing (dest, src) pairs.""" for package, module, module_file in self.find_all_modules(): package = package.split('.') filename = self.get_module_outfile(self.build_lib, package, module) yield (filename, module_file) def _get_package_data_output_mapping(self) -> Iterator[tuple[str, str]]: """Iterate over package data producing (dest, src) pairs.""" for package, src_dir, build_dir, filenames in self.data_files: for filename in filenames: target = os.path.join(build_dir, filename) srcfile = os.path.join(src_dir, filename) yield (target, srcfile) def build_package_data(self) -> None: """Copy data files into build directory""" for target, srcfile in self._get_package_data_output_mapping(): self.mkpath(os.path.dirname(target)) _outf, _copied = self.copy_file(srcfile, target) make_writable(target) def analyze_manifest(self) -> None: self.manifest_files: dict[str, list[str]] = {} if not self.distribution.include_package_data: return src_dirs: dict[str, str] = {} for package in self.packages or (): # Locate package source directory src_dirs[assert_relative(self.get_package_dir(package))] = package if ( self.existing_egg_info_dir and Path(self.existing_egg_info_dir, "SOURCES.txt").exists() ): egg_info_dir = self.existing_egg_info_dir manifest = Path(egg_info_dir, "SOURCES.txt") files = manifest.read_text(encoding="utf-8").splitlines() else: self.run_command('egg_info') ei_cmd = self.get_finalized_command('egg_info') egg_info_dir = ei_cmd.egg_info files = ei_cmd.filelist.files check = _IncludePackageDataAbuse() for path in self._filter_build_files(files, egg_info_dir): d, f = os.path.split(assert_relative(path)) prev = None oldf = f while d and d != prev and d not in src_dirs: prev = d d, df = os.path.split(d) f = os.path.join(df, f) if d in src_dirs: if f == oldf: if check.is_module(f): continue # it's a module, not data else: importable = check.importable_subpackage(src_dirs[d], f) if importable: check.warn(importable) self.manifest_files.setdefault(src_dirs[d], []).append(path) def _filter_build_files( self, files: Iterable[str], egg_info: StrPath ) -> Iterator[str]: """ ``build_meta`` may try to create egg_info outside of the project directory, and this can be problematic for certain plugins (reported in issue #3500). Extensions might also include between their sources files created on the ``build_lib`` and ``build_temp`` directories. This function should filter this case of invalid files out. """ build = self.get_finalized_command("build") build_dirs = (egg_info, self.build_lib, build.build_temp, build.build_base) norm_dirs = [os.path.normpath(p) for p in build_dirs if p] for file in files: norm_path = os.path.normpath(file) if not os.path.isabs(file) or all(d not in norm_path for d in norm_dirs): yield file def get_data_files(self) -> None: pass # Lazily compute data files in _get_data_files() function. def check_package(self, package, package_dir): """Check namespace packages' __init__ for declare_namespace""" try: return self.packages_checked[package] except KeyError: pass init_py = orig.build_py.check_package(self, package, package_dir) self.packages_checked[package] = init_py if not init_py or not self.distribution.namespace_packages: return init_py for pkg in self.distribution.namespace_packages: if pkg == package or pkg.startswith(package + '.'): break else: return init_py with open(init_py, 'rb') as f: contents = f.read() if b'declare_namespace' not in contents: raise distutils.errors.DistutilsError( f"Namespace package problem: {package} is a namespace package, but " "its\n__init__.py does not call declare_namespace()! Please " 'fix it.\n(See the setuptools manual under ' '"Namespace Packages" for details.)\n"' ) return init_py def initialize_options(self): self.packages_checked = {} orig.build_py.initialize_options(self) self.editable_mode = False self.existing_egg_info_dir = None def get_package_dir(self, package): res = orig.build_py.get_package_dir(self, package) if self.distribution.src_root is not None: return os.path.join(self.distribution.src_root, res) return res def exclude_data_files(self, package, src_dir, files): """Filter filenames for package's data files in 'src_dir'""" files = list(files) patterns = self._get_platform_patterns( self.exclude_package_data, package, src_dir, ) match_groups = (fnmatch.filter(files, pattern) for pattern in patterns) # flatten the groups of matches into an iterable of matches matches = itertools.chain.from_iterable(match_groups) bad = set(matches) keepers = (fn for fn in files if fn not in bad) # ditch dupes return list(unique_everseen(keepers)) @staticmethod def _get_platform_patterns(spec, package, src_dir, extra_patterns=()): """ yield platform-specific path patterns (suitable for glob or fn_match) from a glob-based spec (such as self.package_data or self.exclude_package_data) matching package in src_dir. """ raw_patterns = itertools.chain( extra_patterns, spec.get('', []), spec.get(package, []), ) return ( # Each pattern has to be converted to a platform-specific path os.path.join(src_dir, convert_path(pattern)) for pattern in raw_patterns ) def assert_relative(path): if not os.path.isabs(path): return path from distutils.errors import DistutilsSetupError msg = ( textwrap.dedent( """ Error: setup script specifies an absolute path: %s setup() arguments must *always* be /-separated paths relative to the setup.py directory, *never* absolute paths. """ ).lstrip() % path ) raise DistutilsSetupError(msg) class _IncludePackageDataAbuse: """Inform users that package or module is included as 'data file'""" class _Warning(SetuptoolsDeprecationWarning): _SUMMARY = """ Package {importable!r} is absent from the `packages` configuration. """ _DETAILS = """ ############################ # Package would be ignored # ############################ Python recognizes {importable!r} as an importable package[^1], but it is absent from setuptools' `packages` configuration. This leads to an ambiguous overall configuration. If you want to distribute this package, please make sure that {importable!r} is explicitly added to the `packages` configuration field. Alternatively, you can also rely on setuptools' discovery methods (for example by using `find_namespace_packages(...)`/`find_namespace:` instead of `find_packages(...)`/`find:`). You can read more about "package discovery" on setuptools documentation page: - https://setuptools.pypa.io/en/latest/userguide/package_discovery.html If you don't want {importable!r} to be distributed and are already explicitly excluding {importable!r} via `find_namespace_packages(...)/find_namespace` or `find_packages(...)/find`, you can try to use `exclude_package_data`, or `include-package-data=False` in combination with a more fine grained `package-data` configuration. You can read more about "package data files" on setuptools documentation page: - https://setuptools.pypa.io/en/latest/userguide/datafiles.html [^1]: For Python, any directory (with suitable naming) can be imported, even if it does not contain any `.py` files. On the other hand, currently there is no concept of package data directory, all directories are treated like packages. """ # _DUE_DATE: still not defined as this is particularly controversial. # Warning initially introduced in May 2022. See issue #3340 for discussion. def __init__(self): self._already_warned = set() def is_module(self, file): return file.endswith(".py") and file[: -len(".py")].isidentifier() def importable_subpackage(self, parent, file): pkg = Path(file).parent parts = list(itertools.takewhile(str.isidentifier, pkg.parts)) if parts: return ".".join([parent, *parts]) return None def warn(self, importable): if importable not in self._already_warned: self._Warning.emit(importable=importable) self._already_warned.add(importable) command/launcher manifest.xml 0000644 00000001164 15030122015 0012263 0 ustar 00 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0"> <assemblyIdentity version="1.0.0.0" processorArchitecture="X86" name="%(name)s" type="win32"/> <!-- Identify the application security requirements. --> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level="asInvoker" uiAccess="false"/> </requestedPrivileges> </security> </trustInfo> </assembly> command/__pycache__/sdist.cpython-310.pyc 0000644 00000017501 15030122015 0014212 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ ddl m Z ddl m Z dd l mZ d dlm mZ d d lmZ eZdd d �ZG dd� dej�ZdS )� )� annotationsN)�chain)�ClassVar� )�metadata)� Distribution� )�_ORIGINAL_SUBCOMMANDS)�log� c c s* � t jdd�D ] }|�� | �E dH qdS )z%Find all files under revision controlzsetuptools.file_finders)�groupN)r � entry_points�load)�dirname�ep� r �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/sdist.py� walk_revctrl s ��r c s� e Zd ZU dZg d�Zded< i Zded< g d�Zedd � eD ��Z d,d d �Z d,dd�Z d,dd�Z e ejdd� ��Zd,� fdd� Z� fdd�Zdd� Zdd� Zd d � Zd d � Z� fd d!�Zd,� fd"d#� Zd,d$d%�Zd,d&d'�Zd(d)� Zd*d+� Z � Z S )-�sdistz=Smart sdist that finds anything supported by revision control))zformats=Nz6formats for source distribution (comma-separated list))z keep-temp�kz@keep the distribution tree around after creating archive file(s))z dist-dir=�dzFdirectory to put the source distribution archive(s) in [default: dist])zowner=�uz@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group]r � distributionzClassVar[dict[str, str]]� negative_opt)r z.rstz.txtz.mdc c s � | ]}d |� �V qdS )�READMENr )�.0�extr r r � <genexpr>8 � � zsdist.<genexpr>�return�Nonec C s� | � d� | �d�}|j| _| j�tj�|jd�� | �� | � � D ]}| � |� q"| � � t | j dg �}| j D ]}dd|f}||vrH|�|� q8d S )N�egg_infoz SOURCES.txt� dist_filesr r )� run_command�get_finalized_command�filelist�append�os�path�joinr" � check_readme�get_sub_commands�make_distribution�getattrr � archive_files)�self�ei_cmd�cmd_namer# �file�datar r r �run: s ��z sdist.runc C s t j�| � d S �N)�origr �initialize_options�r0 r r r r8 M s zsdist.initialize_optionsc C s: | � � � tj�| � W d � dS 1 sw Y dS )z% Workaround for #516 N)�_remove_os_linkr7 r r- r9 r r r r- P s "�zsdist.make_distributionc c sh � G dd� d�} t td| �}zt`W n ty Y nw zdV W || ur*|t_dS dS || ur3|t_w )zG In a context, remove and restore os.link if it exists c @ s e Zd ZdS )z&sdist._remove_os_link.<locals>.NoValueN)�__name__� __module__� __qualname__r r r r �NoValue^ s r> �linkN)r. r( r? � Exception)r> �orig_valr r r r: W s � � �zsdist._remove_os_linkc s t � �� | �� d S r6 )�super� add_defaults� _add_defaults_build_sub_commandsr9 �� __class__r r rC l s zsdist.add_defaultsc s* t � �� tj�d�r| j�d� d S d S )Nzpyproject.toml)rB �_add_defaults_optionalr( r) �isfiler& r' r9 rE r r rG p s �z sdist._add_defaults_optionalc C s< | j �� r | �d�}| j�|�� � | �| �|�� dS dS )zgetting python files�build_pyN)r �has_pure_modulesr% r& �extend�get_source_files�_add_data_files�_safe_data_files�r0 rI r r r �_add_defaults_pythonu s �zsdist._add_defaults_pythonc sP � � d�}t|�� �t }� fdd�|D �}dd� |D �}� j�t�|�� d S )N�buildc 3 s � | ]}� � |�V qd S r6 )r% �r �cr9 r r r � r z9sdist._add_defaults_build_sub_commands.<locals>.<genexpr>c s s" � | ] }t |d �r|�� V qdS )rL N)�hasattrrL rR r r r r � s � )r% �setr, r r& rK r � from_iterable)r0 rQ � missing_cmds�cmds�filesr r9 r rD | s z&sdist._add_defaults_build_sub_commandsc C s |j S )a� Since the ``sdist`` class is also used to compute the MANIFEST (via :obj:`setuptools.command.egg_info.manifest_maker`), there might be recursion problems when trying to obtain the list of data_files and ``include_package_data=True`` (which in turn depends on the files included in the MANIFEST). To avoid that, ``manifest_maker`` should be able to overwrite this method and avoid recursive attempts to build/analyze the MANIFEST. )� data_filesrO r r r rN � s zsdist._safe_data_filesc C s | j �dd� |D �� dS )zA Add data files as found in build_py.data_files. c s s0 � | ]\}}}}|D ] }t j�||�V q qd S r6 )r( r) r* )r �_�src_dir� filenames�namer r r r � s � � � �z(sdist._add_data_files.<locals>.<genexpr>N)r& rK )r0 rZ r r r rM � s �zsdist._add_data_filesc s0 zt � �� W d S ty t�d� Y d S w )Nz&data_files contains unexpected objects)rB �_add_defaults_data_files� TypeErrorr �warnr9 rE r r r_ � s �z sdist._add_defaults_data_filesc s. t � �� t�tj�}| jjd| dd� d S )Nz^(\.tox|\.nox|\.venv)T)�is_regex)rB �prune_file_list�re�escaper( �sepr& �exclude_pattern)r0 rf rE r r rc � s zsdist.prune_file_listc C s8 | j D ] }tj�|�r d S q| �dd�| j � � d S )Nz,standard file not found: should have one of z, )�READMESr( r) �existsra r* )r0 �fr r r r+ � s ��zsdist.check_readmec C s^ t j�| ||� tj�|d�}ttd�r%tj�|�r%t�|� | � d|� | � d�� |� d S )Nz setup.cfgr? r" ) r7 r �make_release_treer( r) r* rT ri �unlink� copy_filer% �save_version_info)r0 �base_dirrY �destr r r rk � s zsdist.make_release_treec C sT t j�| j�s dS t| jd��}|�� }W d � |dkS 1 s!w Y |dkS )NF�rbs+ # file GENERATED by distutils, do NOT edit )r( r) rH �manifest�open�readline)r0 �fp� first_liner r r �_manifest_is_not_generated� s ��z sdist._manifest_is_not_generatedc C s� t �d| j� t| jd�}|D ]-}z|�d�}W n ty) t �|�d�� Y qw |�� }|�d�s5|s6q| j � |� q|� � dS )z�Read the manifest file (named by 'self.manifest') and use it to fill in 'self.filelist', the list of files to include in the source distribution. zreading manifest file '%s'rq zUTF-8z not UTF-8 decodable -- skipping�#N) r �inforr rs �decode�UnicodeDecodeErrorra �strip� startswithr& r' �close)r0 rr � bytes_line�liner r r � read_manifest� s � zsdist.read_manifest)r r! ) r; r< r= �__doc__� user_options�__annotations__r �README_EXTENSIONS�tuplerh r5 r8 r- � staticmethod� contextlib�contextmanagerr: rC rG rP rD rN rM r_ rc r+ rk rw r� � __classcell__r r rE r r s2 r )r )� __future__r r� r( rd � itertoolsr �typingr � _importlibr �distr rQ r �distutils.command.sdist�commandr r7 � distutilsr �list�_default_revctrlr r r r r �<module> s command/__pycache__/egg_info.cpython-310.pyc 0000644 00000053423 15030122015 0014644 0 ustar 00 o �h~e � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlZddl Zddl Zddl m Z ddl mZ ddlmZ ddlmZmZ ddlmZ ddlmZ d d lmZmZ d d lm Z d d l m Z d dlm Z ddl Z!ddl"Z!ddl!m#Z# ddl m$Z$ ddl"m%Z& ddl'm(Z( ej)j*� dej)j+� �Z,dd� Z-G dd� d�Z.G dd� de.e�Z/G dd� de&�Z%G d d � d e�Z0d3d d �Z1d3d!d"�Z2d3d#d$�Z3e j4Z4e j5Z5d3d%d&�Z6d3d'd(�Z7d4d*e8d dfd+d,�Z9d3d-d.�Z:d5d/d0�Z;G d1d2� d2e �Z<dS )6zUsetuptools.command.egg_info Create a distribution's .egg-info directory and contents� N)�Callable)�Command)� bdist_egg)�sdist� walk_revctrl)� edit_config)�glob� )� _entry_points�_normalization)�metadata)� SetuptoolsDeprecationWarning� )� _requirestxt)�log)�DistutilsInternalError)�FileList)� convert_path�.c C s� d}| � tjj�}t�tj�}d|� d�}t|�D ]�\}}|t|�d k}|dkr<|r0|d7 }n |d|� d|� d �7 }qd }t|�} || k r�|| } | d krU||d 7 }n�| d kr^||7 }ny| d kr�|d } | | k rt|| dkrt| d } | | k r�|| dkr�| d } | | k r�|| dkr�| d } | | k r�|| dks�| | kr�|t�| �7 }n1||d | � } d} | d dkr�d} | dd� } | t�| �7 } |d | � d�7 }| }n|t�| �7 }|d7 }|| k sF|s�||7 }q|d7 }tj|tj tj B d�S )z� Translate a file path glob like '*.txt' in to a regular expression. This differs from fnmatch.translate which allows wildcards to match directory separators. It also knows about '**/' which matches any number of directories. � z[^�]r �**z.*z(?:�+z)*r �*�?�[�!�^Nz\Z)�flags) �split�os�path�sep�re�escape� enumerate�len�compile� MULTILINE�DOTALL)r �pat�chunksr" � valid_char�c�chunk� last_chunk�i� chunk_len�char�inner_i�inner� char_class� r6 �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/egg_info.py�translate_pattern& s\ � �-�r8 c @ sf e Zd ZdZdZedd� �Zdd� Zdd� Zde d e fd d �Z d e fd d �Z d e fdd�Z ee �ZdS )� InfoCommonNc C s t �| j�� �S �N)r � safe_name� distribution�get_name��selfr6 r6 r7 �name} s zInfoCommon.namec C s | � | j�� �}t�|�S r: )� _maybe_tagr< � get_versionr � safe_version)r? �taggedr6 r6 r7 �tagged_version� s zInfoCommon.tagged_versionc C s | j r | �|�r |S || j S )z� egg_info may be called more than once for a distribution, in which case the version string already contains all tags. )�vtags�_already_tagged�r? �versionr6 r6 r7 rA � s ����zInfoCommon._maybe_tagrI �returnc C s |� | j�p |� | �� �S r: )�endswithrF � _safe_tagsrH r6 r6 r7 rG � s zInfoCommon._already_taggedc C sH zt �d| j� ��dd � W S tjjy# t �| j�dd�� Y S w )N�0r � r )r rC rF � packagingrI �InvalidVersionr; �replacer> r6 r6 r7 rL � s �zInfoCommon._safe_tagsc C s, d}| j r || j 7 }| jr|t�d�7 }|S )Nr z%Y%m%d)� tag_build�tag_date�time�strftimerH r6 r6 r7 �tags� s zInfoCommon.tags)�__name__� __module__� __qualname__rR rS �propertyr@ rE rA �str�boolrG rL rV rF r6 r6 r6 r7 r9 y s r9 c @ s� e Zd ZdZg d�ZdgZddiZdd� Zed d d ��Z e j d d � �Z d d d �Z d dd�Z e dfdd�Zd deddfdd�Zd dd�Zd dd�Zd dd�Zd d d �ZdS ) �egg_infoz+create a distribution's .egg-info directory))z egg-base=�ezLdirectory containing .egg-info directories [default: top of the source tree])�tag-date�dz0Add date stamp (e.g. 20050528) to version number)z tag-build=�bz-Specify explicit tag to add to version number)�no-date�Dz"Don't include date stamp [default]r_ rb c C s" d | _ d | _d | _d | _d| _d S )NF)�egg_base�egg_namer] � egg_version�ignore_egg_info_in_manifestr> r6 r6 r7 �initialize_options� � zegg_info.initialize_optionsrJ Nc C � d S r: r6 r> r6 r6 r7 �tag_svn_revision� � zegg_info.tag_svn_revisionc C rj r: r6 )r? �valuer6 r6 r7 rk � rl c C s$ t | �� dd�}t|t |d�� dS )z� Materialize the value of date into the build tag. Install build keys in a deterministic order to avoid arbitrary reordering on subsequent builds. r )rR rS )r] N)�dictrV r )r? �filenamer] r6 r6 r7 �save_version_info� s zegg_info.save_version_infoc C s | j | _| �� | _tj�| j�}zt|tjj�}|r dnd}tj� || j| jf � W n t yF } zt j � d| j� d| j� ��|�d }~ww | jd u rZ| jj}|pSi �dtj�| _| �d� t�| j�d | _| jtjkrxtj�| j| j�| _| j| jj_d S )Nz%s==%sz%s===%sz-Invalid distribution name or version syntax: �-r rd � .egg-info)r@ re rE rf rO rI �Version� isinstance� requirements� Requirement� ValueError� distutils�errors�DistutilsOptionErrorrd r< � package_dir�getr �curdir�ensure_dirnamer �filename_componentr] r! �joinr )r? �parsed_version� is_version�specr^ �dirsr6 r6 r7 �finalize_options� s. ���� zegg_info.finalize_optionsc C s t | j| j||�S )�0Compute filename of the output egg. Private API.)� _egg_basenamere rf )r? � py_version�platformr6 r6 r7 �_get_egg_basename� s zegg_info._get_egg_basenameF�forcec C sR |r | � |||� dS tj�|�r'|du r |s t�d||� dS | �|� dS dS )a� Write `data` to `filename` or delete if empty If `data` is non-empty, this routine is the same as ``write_file()``. If `data` is empty but not ``None``, this is the same as calling ``delete_file(filename)`. If `data` is ``None``, then this is a no-op unless `filename` exists, in which case a warning is issued about the orphaned file (if `force` is false), or deleted (if `force` is true). Nz$%s not set in setup(), but %s exists)� write_filer r! �existsr �warn� delete_file)r? �whatro �datar� r6 r6 r7 �write_or_delete_file� s �z egg_info.write_or_delete_filec C sB t �d||� |�d�}| js t|d�}|�|� |�� dS dS )z�Write `data` to `filename` (if not a dry run) after announcing it `what` is used in a log message to identify what is being written to the file. zwriting %s to %s�utf-8�wbN)r �info�encode�dry_run�open�write�close)r? r� ro r� �fr6 r6 r7 r� s �zegg_info.write_filec C s$ t �d|� | jst�|� dS dS )z8Delete `filename` (if not a dry run) after announcing itz deleting %sN)r r� r� r �unlink)r? ro r6 r6 r7 r� s �zegg_info.delete_filec C s� t tjdd��}| �| j� z t�| jd � W n ty1 } zd| j� d�}tj � |�|�d }~ww |D ]}|� � }|| |j tj �| j|j �� q4tj �| jd�}tj �|�r\| �|� | �� d S )Nzegg_info.writers)�groupz'Cannot update time stamp of directory '�'znative_libs.txt)�listr � entry_points�mkpathr] r �utime�OSErrorrx ry �DistutilsFileError�loadr@ r! r� r� r� � find_sources)r? �writersr^ �msg�ep�writer�nlr6 r6 r7 �run$ s �� z egg_info.runc C s< t j�| jd�}t| j�}| j|_||_|� � |j | _ dS )z"Generate SOURCES.txt manifest filez SOURCES.txtN) r r! r� r] �manifest_makerr< rg �ignore_egg_info_dir�manifestr� �filelist)r? �manifest_filename�mmr6 r6 r7 r� : s zegg_info.find_sources�rJ N�F)rW rX rY � description� user_options�boolean_options� negative_optrh rZ rk �setterrp r� �PY_MAJORr� r\ r� r� r� r� r� r6 r6 r6 r7 r] � s& � r] c s� e Zd Z d#deddf� fdd� Zd$dd�Zd d � Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� Zd$dd �Zd$d d �Zd d � Zd!d"� Z� ZS )%r NFr� rJ c s t � �||� || _d S r: )�super�__init__r� )r? r� � debug_printr� �� __class__r6 r7 r� G s zFileList.__init__c C s | � |�\}}}}| j| j| j| jt�| j|�t�| j|�| j | j d�}dddddddd d�}z|| }W n t yI d |�d |��} t | �d �w |� d �} |d v rV|g}| r[|fnd} || } | �d�|g| rl|gng | �� |D ]} || �s�tj| | g| �R � qud S )N)�include�excludezglobal-includezglobal-excludezrecursive-includezrecursive-exclude�graft�prunez%warning: no files found matching '%s'z9warning: no previously-included files found matching '%s'z>warning: no files found matching '%s' anywhere in distributionzRwarning: no previously-included files matching '%s' found anywhere in distributionz:warning: no files found matching '%s' under directory '%s'zNwarning: no previously-included files matching '%s' found under directory '%s'z+warning: no directories found matching '%s'z6no previously-included directories found matching '%s'z$Invalid MANIFEST.in: unknown action z in z recursive-> r� r� r6 rN )�_parse_template_liner� r� �global_include�global_exclude� functools�partial�recursive_include�recursive_excluder� r� �KeyErrorr � startswithr� r� r r� )r? �line�action�patterns�dir� dir_pattern� action_map�log_map�process_actionr� �action_is_recursive�extra_log_args�log_tmpl�patternr6 r6 r7 �process_template_lineM s\ ���� � ����z FileList.process_template_linec C sR d}t t| j�d dd�D ]}|| j| �r&| �d| j| � | j|= d}q |S )z� Remove all files from the file list that match the predicate. Return True if any matching files were removed Fr ���z removing T)�ranger& �filesr� )r? � predicate�foundr0 r6 r6 r7 � _remove_files� s �zFileList._remove_filesc C �$ dd� t |�D �}| �|� t|�S )z#Include files that match 'pattern'.c S � g | ] }t j�|�s|�qS r6 �r r! �isdir��.0r� r6 r6 r7 � <listcomp>� � z$FileList.include.<locals>.<listcomp>�r �extendr\ �r? r� r� r6 r6 r7 r� � s zFileList.includec C s t |�}| �|j�S )z#Exclude files that match 'pattern'.)r8 r� �match�r? r� r� r6 r6 r7 r� � s zFileList.excludec C s8 t j�|d|�}dd� t|dd�D �}| �|� t|�S )zN Include all files anywhere in 'dir/' that match the pattern. r c S r� r6 r� r� r6 r6 r7 r� � r� z.FileList.recursive_include.<locals>.<listcomp>T)� recursive)r r! r� r r� r\ )r? r� r� � full_patternr� r6 r6 r7 r� � s zFileList.recursive_includec C s t tj�|d|��}| �|j�S )zM Exclude any file anywhere in 'dir/' that match the pattern. r �r8 r r! r� r� r� )r? r� r� r� r6 r6 r7 r� � s zFileList.recursive_excludec C r� )z Include all files from 'dir/'.c S s" g | ] }t j�|�D ]}|�q qS r6 )rx r� �findall)r� � match_dir�itemr6 r6 r7 r� � s ���z"FileList.graft.<locals>.<listcomp>r� )r? r� r� r6 r6 r7 r� � s � zFileList.graftc C s t tj�|d��}| �|j�S )z Filter out files from 'dir/'.r r� )r? r� r� r6 r6 r7 r� � s zFileList.prunec sJ | j du r | �� ttj�d|��� � fdd�| j D �}| �|� t|�S )z� Include all files anywhere in the current directory that match the pattern. This is very inefficient on large file trees. Nr c s g | ] }� � |�r|�qS r6 �r� r� r� r6 r7 r� � s z+FileList.global_include.<locals>.<listcomp>)�allfilesr� r8 r r! r� r� r\ r� r6 r� r7 r� � s zFileList.global_includec C s t tj�d|��}| �|j�S )zD Exclude all files anywhere that match the pattern. r r� r� r6 r6 r7 r� � s zFileList.global_excludec C s< |� d�r |d d� }t|�}| �|�r | j�|� d S d S )N� r� )rK r � _safe_pathr� �append)r? r� r! r6 r6 r7 r� � s �zFileList.appendc C s | j �t| j|�� d S r: )r� r� �filterr� )r? �pathsr6 r6 r7 r� � s zFileList.extendc C s t t| j| j��| _dS )z� Replace self.files with only safe paths Because some owners of FileList manipulate the underlying ``files`` attribute directly, this method must be called to repair those paths. N)r� r� r� r� r> r6 r6 r7 �_repair� s zFileList._repairc C s� d}t �|�}|d u rt�d|� d�� dS t �|d�}|d u r)t�||d� dS z"d|v p1d|v }| jr:|r:W dS tj�|�sFtj�|�rIW dS W d S t y^ t�||t � � � Y d S w ) Nz!'%s' not %s encodable -- skippingr� z$' in unexpected encoding -- skippingFr� rr s .egg-infoT) � unicode_utils�filesys_decoder r� � try_encoder� r r! r� �UnicodeEncodeError�sys�getfilesystemencoding)r? r! �enc_warn�u_path� utf8_path� is_egg_infor6 r6 r7 r� � s& � �zFileList._safe_path)NNFr� )rW rX rY r\ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� � __classcell__r6 r6 r� r7 r D s* ��� F r c @ sz e Zd ZdZddd�Zddd�Zddd �Zd d � Zdd d �Zddd�Z e dd� �Z ddd�Z ddd�Z dd� Zdd� ZdS )r� z MANIFEST.inrJ Nc C s" d| _ d| _d| _d| _d| _d S )NTF)� use_defaultsr� � manifest_only�force_manifestr� r> r6 r6 r7 rh ri z!manifest_maker.initialize_optionsc C rj r: r6 r> r6 r6 r7 r� s z manifest_maker.finalize_optionsc C sz t | jd�| _tj�| j�s| �� | �� tj�| j �r!| � � | � � | � � | � � | j�� | j�� | �� d S )N)r� )r r� r� r r! r� r� �write_manifest� add_defaults�template� read_template�add_license_files�_add_referenced_files�prune_file_list�sort�remove_duplicatesr> r6 r6 r7 r� s zmanifest_maker.runc C s t �|�}|�tjd�S )N�/)r� r� rQ r r" )r? r! r6 r6 r7 �_manifest_normalize) s z"manifest_maker._manifest_normalizec sF � j �� � fdd�� j jD �}d� j� d�}� �t� j|f|� dS )zo Write the file list in 'self.filelist' to the manifest file named by 'self.manifest'. c s g | ]}� � |��qS r6 )r r� r> r6 r7 r� 5 s z1manifest_maker.write_manifest.<locals>.<listcomp>zwriting manifest file 'r� N)r� r� r� r� �executer� )r? r� r� r6 r> r7 r - s z manifest_maker.write_manifestc C s | � |�s t�| |� d S d S r: )�_should_suppress_warningr r� )r? r� r6 r6 r7 r� 9 s �zmanifest_maker.warnc C s t �d| �S )z; suppress missing-file warnings from sdist zstandard file .*not found)r# r� )r� r6 r6 r7 r = s z'manifest_maker._should_suppress_warningc C s� t �| � | j�| j� | j�| j� tt� �}|r!| j�|� n t j � | j�r,| � � t j � d�r8| j�d� | � d�}| j�|j� d S )Nzsetup.pyr] )r r r� r� r r� r� r r� r r! r� � read_manifest�get_finalized_commandr� r] )r? �rcfiles�ei_cmdr6 r6 r7 r D s zmanifest_maker.add_defaultsc C s4 | j jjpg }|D ]}t�d|� q | j�|� d S )Nzadding license file '%s')r< r � license_filesr r� r� r� )r? r �lfr6 r6 r7 r V s z manifest_maker.add_license_filesc C s4 t | jdg �}|D ]}t�d|� q | j�|� dS )zGAdd files referenced by the config (e.g. `file:` directive) to filelist�_referenced_filesz%adding file referenced by config '%s'N)�getattrr< r �debugr� r� )r? � referenced�rfr6 r6 r7 r \ s z$manifest_maker._add_referenced_filesc C s* t |d�r |�� S tjdddd� |�� S )a0 The parent class implementation of this method (``sdist``) will try to include data files, which might cause recursion problems when ``include_package_data=True``. Therefore, avoid triggering any attempt of analyzing/building the manifest again. � get_data_files_without_manifestz@`build_py` command does not inherit from setuptools' `build_py`.z� Custom 'build_py' does not implement 'get_data_files_without_manifest'. Please extend command classes from setuptools instead of distutils. z!https://peps.python.org/pep-0632/)�see_url)�hasattrr! r �emit�get_data_files)r? �build_pyr6 r6 r7 �_safe_data_filesd s � z manifest_maker._safe_data_filesr� )rW rX rY r rh r� r� r r r� � staticmethodr r r r r' r6 r6 r6 r7 r� s r� rJ c C sN d� |�}|�d�}t| d��}|�|� W d � dS 1 s w Y dS )z{Create a file with the specified name and write 'contents' (a sequence of strings without line terminators) to it. � r� r� N)r� r� r� r� )ro �contentsr� r6 r6 r7 r� } s "�r� c C s� t �d|� | jsE| jj}| j|j|_}| j|j|_}z|� | j � W |||_|_n|||_|_w t | jdd �}t � | j |� d S d S )Nz writing %s�zip_safe)r r� r� r< r rf rI re r@ �write_pkg_infor] r r �write_safety_flag)�cmd�basenamero r �oldver�oldname�safer6 r6 r7 r, � s �r, c C s dS )aj Unused: left to avoid errors when updating (from source) from <= 67.8. Old installations have a .dist-info directory with the entry-point ``depends.txt = setuptools.command.egg_info:warn_depends_obsolete``. This may trigger errors when running the first egg_info in build_meta. TODO: Remove this function in a version sufficiently > 68. Nr6 �r. r/ ro r6 r6 r7 �warn_depends_obsolete� s r4 c C s: t �dd� | j�� D ��}| �d|d�t|��d � d S )Nc S s g | ] }|� d d�d �qS )r r r )r )r� �kr6 r6 r7 r� � s �z(write_toplevel_names.<locals>.<listcomp>ztop-level namesr) )rn �fromkeysr< �iter_distribution_namesr� r� �sorted)r. r/ ro �pkgsr6 r6 r7 �write_toplevel_names� s � r: c C s t | ||d� d S )NT)� write_argr3 r6 r6 r7 � overwrite_arg� s r< Fr� c C sH t j�|�d }t| j|d �}|d urd�|�d }| �||||� d S )Nr r) )r r! �splitextr r< r� r� )r. r/ ro r� �argnamerm r6 r6 r7 r; � s r; c C s, t �| jj�}t �|�}| �d||d� d S )Nz entry pointsT)r r� r< r� �renderr� )r. r/ ro �eps�defnr6 r6 r7 � write_entries� s rB c C sB t �| �}t �|�}|� d|� d|pt� �}|r |d|� �7 }|S )r� rq z-py)r r r� )re rf r� r� r@ rI �eggr6 r6 r7 r� � s r� c @ s e Zd ZdZdS )�EggInfoDeprecationWarningz?Deprecated behavior warning for EggInfo, bypassing suppression.N)rW rX rY �__doc__r6 r6 r6 r7 rD � s rD r� r� )NN)=rE r� r r# r� rT �collections.abcr rO �packaging.requirements�packaging.version�setuptools.unicode_utilsr� � setuptoolsr �setuptools.commandr �setuptools.command.sdistr r �setuptools.command.setoptr �setuptools.globr r r r � _importlibr �warningsr r �distutils.errorsrx �distutils.filelistr r r � _FileList�distutils.utilr � version_info�major�minorr� r8 r9 r] r� r� r, r4 �write_requirements�write_setup_requirementsr: r< r\ r; rB r� rD r6 r6 r6 r7 �<module> sZ S/ K o command/__pycache__/develop.cpython-310.pyc 0000644 00000013742 15030122015 0014525 0 ustar 00 o �h� � @ s� d dl Z d dlZd dlZd dlmZmZmZ d dlmZ ddlm Z d dl m Z d dl m Z d dlmZ G d d � d eje�ZG d d � d �ZdS ) � N)�_normalization�_path� namespaces)� easy_install� )�_read_utf8_with_fallback)�log)�DistutilsOptionError)� convert_pathc @ s| e Zd ZdZdZejddg Zejdg ZdZdd� Z d d � Z dd d�Z e dd� �Z ddd�Zddd�Zdd� Zdd� Zd S )�developz Set up package for developmentz%install package in 'development mode')� uninstall�uz Uninstall this source package)z egg-path=Nz-Set the path to be used in the .egg-link filer Fc C s2 | j rd| _| �� | �� n| �� | �� d S )NT)r � multi_version�uninstall_link�uninstall_namespaces�install_for_development�warn_deprecated_options��self� r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/develop.py�run s z develop.runc C s& d | _ d | _t�| � d | _d| _d S )N�.)r �egg_pathr �initialize_options� setup_path�always_copy_fromr r r r r & s zdevelop.initialize_options�returnNc C s dd l }| �d�}|jg| _t�| � | �� | �� | j� t � d�� t � |j�d }t j�| j|�| _|j| _| jd u rFt j�|j�| _t�| j�}t�t j�| j| j��}||krbtd| ��|j||�|t j�|j��|jd�| _| � | j| j| j�| _ d S )Nr �egg_infoz*.eggz .egg-linkzA--egg-path must be a relative path from the install directory to �� project_name) � pkg_resources�get_finalized_command�egg_name�argsr �finalize_options�expand_basedirs� expand_dirs� package_index�scan�globr �filename_component_broken�os�path�join� install_dir�egg_link�egg_baser �abspathr �normpathr � Distribution� PathMetadatar �dist�_resolve_setup_pathr )r r! �ei� egg_link_fn�targetr r r r r% - s> � ��� �zdevelop.finalize_optionsc C sj | � tjd��d�}|tjkrd|�d�d }t�tj� |||��}t�tj�}||kr3t d||��|S )z� Generate a path from egg_base back to '.' where the setup script resides and ensure that path points to the setup path from $install_dir/$egg_path. �/z../� zGCan't get a consistent path to setup script from installation directory) �replacer, �sep�rstrip�curdir�countr r3 r- r. r )r1 r/ r � path_to_setup�resolvedr@ r r r r7 V s �zdevelop._resolve_setup_pathc C s� | � d� | jddd� | � d� tjr | �tj� d t_| �� t�d| j| j � | j sPt | jddd��}|� | j d | j � W d � n1 sKw Y | �d | j| j � d S ) Nr � build_extT)�inplacezCreating %s (link to %s)�wzutf-8)�encoding� )� run_command�reinitialize_command� setuptools�bootstrap_install_fromr �install_namespacesr �infor0 r1 �dry_run�open�writer r �process_distributionr6 �no_deps)r �fr r r r k s �z develop.install_for_developmentc C s� t j�| j�r9t�d| j| j� dd� t| j��� D �}|| j g| j | j gfvr0t� d|� d S | j s9t � | j� | j sB| �| j� | jjrMt� d� d S d S )NzRemoving %s (link to %s)c S s g | ]}|� � �qS r )r? )�.0�liner r r � <listcomp>� s ��z*develop.uninstall_link.<locals>.<listcomp>z$Link points to %s: uninstall abortedz5Note: you must uninstall or replace scripts manually!)r, r- �existsr0 r rN r1 r � splitlinesr r �warnrO �unlink� update_pthr6 � distribution�scripts)r �contentsr r r r � s � �zdevelop.uninstall_linkc C sj || j ur t�| |�S | �|� | jjpg D ] }tj�t |��}tj� |�}t |�}| � ||||� qd S �N) r6 r �install_egg_scripts�install_wrapper_scriptsr] r^ r, r- r2 r �basenamer �install_script)r r6 � script_name� script_path� script_textr r r ra � s zdevelop.install_egg_scriptsc C s t |�}t�| |�S r` )�VersionlessRequirementr rb �r r6 r r r rb � s z develop.install_wrapper_scripts�r N)�__name__� __module__� __qualname__�__doc__� descriptionr � user_options�boolean_options�command_consumes_argumentsr r r% � staticmethodr7 r r ra rb r r r r r s$ � ) r c @ s0 e Zd ZdZd dd�Zdefdd�Zd d � ZdS ) rh a� Adapt a pkg_resources.Distribution to simply return the project name as the 'requirement' so that scripts will work across multiple versions. >>> from pkg_resources import Distribution >>> dist = Distribution(project_name='foo', version='1.0') >>> str(dist.as_requirement()) 'foo==1.0' >>> adapted_dist = VersionlessRequirement(dist) >>> str(adapted_dist.as_requirement()) 'foo' r Nc C s || _ d S r` )� _VersionlessRequirement__distri r r r �__init__� s z VersionlessRequirement.__init__�namec C s t | j|�S r` )�getattrrt )r rv r r r � __getattr__� s z"VersionlessRequirement.__getattr__c C s | j S r` r r r r r �as_requirement� s z%VersionlessRequirement.as_requirementrj )rk rl rm rn ru �strrx ry r r r r rh � s rh )r* r, rK r r r � setuptools.command.easy_installr � unicode_utilsr � distutilsr �distutils.errorsr �distutils.utilr �DevelopInstallerr rh r r r r �<module> s command/__pycache__/install_egg_info.cpython-310.pyc 0000644 00000004530 15030122015 0016365 0 ustar 00 o �h � @ sX d dl Z d dlmZmZ d dlmZ ddlmZ d dlm Z m Z G dd� dej e�Z dS ) � N)�Command� namespaces)�unpack_archive� )�ensure_directory)�dir_util�logc @ sH e Zd ZdZdZdgZdd� Zddd�Zdd d �Zd d � Z dd d�Z dS )�install_egg_infoz.Install an .egg-info directory for the package)z install-dir=�dzdirectory to install toc C s d | _ d S �N)� install_dir��self� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/install_egg_info.py�initialize_options s z#install_egg_info.initialize_options�returnNc C sH | � dd� | �d�}|�� � d�}|j| _tj�| j|�| _ g | _ d S )N� install_lib)r r �egg_infoz .egg-info) �set_undefined_options�get_finalized_command�_get_egg_basenamer �source�os�path�joinr �target�outputs)r �ei_cmd�basenamer r r �finalize_options s z!install_egg_info.finalize_optionsc C s� | � d� tj�| j�r tj�| j�s tj| j| jd� ntj� | j�r1| � tj | jfd| j � | js9t | j� | � | j dd| j� d| j� �� | �� d S )Nr )�dry_runz Removing r zCopying z to )� run_commandr r �isdirr �islinkr � remove_treer! �exists�execute�unlinkr �copytreer �install_namespacesr r r r �run s zinstall_egg_info.runc C s | j S r )r r r r r � get_outputs* s z install_egg_info.get_outputsc s � fdd�}t � j� j|� d S )Nc sD dD ]}| � |�sd| | v r d S q� j�|� t�d| |� |S )N)z.svn/zCVS/�/zCopying %s to %s)� startswithr �appendr �debug)�src�dst�skipr r r �skimmer/ s � z*install_egg_info.copytree.<locals>.skimmer)r r r )r r4 r r r r) - s zinstall_egg_info.copytree)r N) �__name__� __module__� __qualname__�__doc__� description� user_optionsr r r+ r, r) r r r r r s � r ) r � setuptoolsr r �setuptools.archive_utilr �_pathr � distutilsr r � Installerr r r r r �<module> s command/__pycache__/rotate.cpython-310.pyc 0000644 00000005130 15030122015 0014355 0 ustar 00 o �h� � @ sh d dl mZ d dlZd dlmZ ddlmZmZ d dlm Z d dl m Z d dl m Z G d d � d e�ZdS ) � )� annotationsN)�ClassVar� )�Command�_shutil)�log)�DistutilsOptionError)� convert_pathc @ sF e Zd ZU dZdZg d�Zg Zded< dd� Zdd d �Z dd d �Z dS )�rotatezDelete older distributionsz2delete older distributions, keeping N newest files))zmatch=�mz patterns to match (required))z dist-dir=�dz%directory where the distributions are)zkeep=�kz(number of matching distributions to keepzClassVar[list[str]]�boolean_optionsc C s d | _ d | _d | _d S )N)�match�dist_dir�keep)�self� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/rotate.py�initialize_options s zrotate.initialize_options�return�Nonec C s� | j d u r td��| jd u rtd��zt| j�| _W n ty+ } ztd�|�d }~ww t| j t�r>dd� | j �d�D �| _ | �dd� d S ) NzQMust specify one or more (comma-separated) match patterns (e.g. '.zip' or '.egg')z$Must specify number of files to keepz--keep must be an integerc S s g | ]}t |�� ��qS r )r �strip)�.0�pr r r � <listcomp>+ s z+rotate.finalize_options.<locals>.<listcomp>�,�bdist)r r ) r r r �int� ValueError� isinstance�str�split�set_undefined_options)r �er r r �finalize_options s � �� zrotate.finalize_optionsc C s� | � d� ddlm} | jD ]U}| j�� d | }|tj�| j|��}dd� |D �}|� � |� � t � dt |�|� || jd � }|D ] \}}t � d|� | jsbtj�|�r]t�|� qDt�|� qDqd S ) N�egg_infor )�glob�*c S s g | ] }t j�|�|f�qS r )�os�path�getmtime)r �fr r r r 5 s z rotate.run.<locals>.<listcomp>z%d file(s) matching %sz Deleting %s)� run_commandr' r � distribution�get_namer) r* �joinr �sort�reverser �info�lenr �dry_run�isdirr �rmtree�unlink)r r' �pattern�files�tr, r r r �run. s& ���z rotate.runN)r r ) �__name__� __module__� __qualname__�__doc__� description� user_optionsr �__annotations__r r% r< r r r r r s r )� __future__r r) �typingr � r r � distutilsr �distutils.errorsr �distutils.utilr r r r r r �<module> s command/__pycache__/saveopts.cpython-310.pyc 0000644 00000001642 15030122015 0014727 0 ustar 00 o �h� � @ s$ d dl mZmZ G dd� de�ZdS )� )� edit_config� option_basec @ s e Zd ZdZdZddd�ZdS )�saveoptsz#Save command-line options to a filez7save supplied options to setup.cfg or other config file�returnNc C sh | j }i }|jD ]!}|dkrq|�|��� D ]\}\}}|dkr(||�|i �|< qqt| j|| j� d S )Nr z command line)� distribution�command_options�get_option_dict�items� setdefaultr �filename�dry_run)�self�dist�settings�cmd�opt�src�val� r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/saveopts.py�run s ��z saveopts.run)r N)�__name__� __module__� __qualname__�__doc__� descriptionr r r r r r s r N)�setuptools.command.setoptr r r r r r r �<module> s command/__pycache__/__init__.cpython-310.pyc 0000644 00000000655 15030122015 0014625 0 ustar 00 o �h# � @ sj d dl Z d dlmZ dejvr1z dejd< W [[ dS ey0 dejd< ej�d� Y [[ dS w [[ dS )� N)�bdist�egg)� bdist_eggzPython .egg file)�sys�distutils.command.bdistr �format_commands� TypeError�format_command�append� r r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/__init__.py�<module> s � � command/__pycache__/build_clib.cpython-310.pyc 0000644 00000004726 15030122015 0015161 0 ustar 00 o �h� � @ sX d dl mZ d dlmZ ddlm mZ ddlm Z ddl m Z G dd� dej�ZdS ) � )� Distribution)�newer_pairwise_group� N)�log)�DistutilsSetupErrorc @ s$ e Zd ZU dZeed< ddd�ZdS )� build_clibav Override the default build_clib behaviour to do the following: 1. Implement a rudimentary timestamp-based dependency system so 'compile()' doesn't run every time. 2. Add more keys to the 'build_info' dictionary: * obj_deps - specify dependencies for each object compiled. this should be a dictionary mapping a key with the source filename to a list of dependencies. Use an empty string for global dependencies. * cflags - specify a list of additional flags to pass to the compiler. � distribution�returnNc C s� |D ]�\}}|� d�}|d u st|ttf�s td|� d���tt|��}t�d|� |� dt� �}t|t�s>td|� d���g }|� dt� �}t|ttf�sVtd|� d���|D ]*}|g} | � |� |� |t� �} t| ttf�sxtd|� d���| � | � |� | � qX| j j || j d�} t|| �g g fkr�|� d �} |� d �} |� d �}| j j|| j | | || jd � | j j| || j| jd � qd S )N�sourcesz in 'libraries' option (library 'zD'), 'sources' must be present and must be a list of source filenameszbuilding '%s' library�obj_depsz:'), 'obj_deps' must be a dictionary of type 'source: list'� )� output_dir�macros� include_dirs�cflags)r r r �extra_postargs�debug)r r )�get� isinstance�list�tupler �sortedr �info�dict�extend�append�compiler�object_filenames� build_tempr �compiler �create_static_libr )�self� libraries�lib_name� build_infor r � dependencies� global_deps�source�src_deps� extra_deps�expected_objectsr r r � r+ �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/build_clib.py�build_libraries sb � � � � � � ��zbuild_clib.build_libraries)r N)�__name__� __module__� __qualname__�__doc__r �__annotations__r- r+ r+ r+ r, r s r ) �distr �modifiedr � distutils.command.build_clib�commandr �orig� distutilsr �distutils.errorsr r+ r+ r+ r, �<module> s command/__pycache__/editable_wheel.cpython-310.pyc 0000644 00000105721 15030122015 0016023 0 ustar 00 o �h(� � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z ddlmZ ddlmZ ddlmZmZ dd lmZ dd lmZ dd lmZ dd lm Z m Z m Z m Z d dl m!Z!m"Z"m#Z#m$Z$m%Z%m&Z& d dl#m'Z' d dl(m)Z) d dl*m+Z+ d dl,m-Z- d dl.m/Z/m0Z0m1Z1 ddl2m2Z3 ddl4m4Z5 ddl6m6Z7 ddl8m8Z9 ddl:m:Z; ddl<m<Z= e r�ddl>m?Z? d d l@mAZA e d e'd �ZBe�CeD�ZEG d d � d e�ZFd!ZGd"ZHG d#d$� d$e!�ZIG d%d&� d&e �ZJG d'd(� d(�ZKG d)d*� d*eK�ZLG d+d,� d,�ZMdod1d2�ZNdpd6d7�ZOdqd>d?�ZPd@dA� ZQdrdEdF�ZRdrdGdH�ZSdsdKdL�ZTdtdNdO�ZUdudQdR�ZVdvdUdV�ZWdwdWdX�ZXdxd]d^�ZYdyd`da�ZZG dbdc� dce&j[�Z\ddZ]dzdidj�Z^G dkdl� dle%j_�Z`G dmdn� dne1�ZadS ){a� Create a wheel that, when installed, will make the source package 'editable' (add it to the interpreter's path, including metadata) per PEP 660. Replaces 'setup.py develop'. .. note:: One of the mechanisms briefly mentioned in PEP 660 to implement editable installs is to create a separated directory inside ``build`` and use a .pth file to point to that directory. In the context of this file such directory is referred as *auxiliary build directory* or ``auxiliary_dir``. � )� annotationsN)�Iterable�Iterator�Mapping)�suppress)�Enum)�cleandoc)�chain�starmap)�Path)�TemporaryDirectory)� TracebackType)� TYPE_CHECKING�Protocol�TypeVar�cast� )�Command�_normalization�_path�_shutil�errors� namespaces)�StrPath)�py312��find_package_path)� Distribution)�InformationOnly� SetuptoolsDeprecationWarning�SetuptoolsWarning� )�build)�build_py)� dist_info)�egg_info)�install)�install_scripts)�Self�� WheelFile�_P)�boundc @ s* e Zd ZdZdZdZdZed dd ��Zd S ) � _EditableModea Possible editable installation modes: `lenient` (new files automatically added to the package - DEFAULT); `strict` (requires a new installation when files are added/removed); or `compat` (attempts to emulate `python setup.py develop` - DEPRECATED). �strict�lenient�compat�mode� str | None�returnc C sN |st jS |�� }|t jvrt�d|�d���|dkr#tjdddd� t | S )NzInvalid editable mode: z. Try: 'strict'.�COMPATzCompat editable installsa The 'compat' editable mode is transitional and will be removed in future versions of `setuptools`. Please adapt your code accordingly to use either the 'strict' or the 'lenient' modes. � userguide/development_mode.html)�see_docs)r- �LENIENT�upper� __members__r � OptionErrorr �emit)�clsr1 �_mode� r> �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/editable_wheel.py�convert@ s �z_EditableMode.convertN)r1 r2 r3 r- ) �__name__� __module__� __qualname__�__doc__�STRICTr7 r4 � classmethodr@ r> r> r> r? r- 4 s r- zU New or renamed files may not be automatically picked up without a new installation. zt Options like `package-data`, `include/exclude-package-data` or `packages.find.exclude/include` may have no effect. c @ s� e Zd ZdZdZddddeejpd�fgZdd � Zd5d d �Z d5dd�Z dd� Z dd� Z d6dd�Z d7d d �Zd d � Zd8d"d#�Zd9d%d&�Zd5d'd(�Zd:d*d+�Zd,d-� Zd;d/d0�Zd<d3d4�ZdS )=�editable_wheelz�Build 'editable' wheel for development. This command is private and reserved for internal use of setuptools, users should rely on ``setuptools.build_meta`` APIs. zBDO NOT CALL DIRECTLY, INTERNAL ONLY: create PEP 660 editable wheel)z dist-dir=�dz-directory to put final built distributions in)zdist-info-dir=�Iz(path to a pre-build .dist-info directoryzmode=N� c C s d | _ d | _d | _d | _d S �N)�dist_dir� dist_info_dir� project_dirr1 ��selfr> r> r? �initialize_optionsu s z!editable_wheel.initialize_optionsr3 �Nonec C s@ | j }|jptj| _|jpi | _t| jptj� | jd��| _d S )N�dist) � distribution�src_root�os�curdirrN � package_dirr rL �path�join)rP rS r> r> r? �finalize_options{ s z editable_wheel.finalize_optionsc C s~ z#| j jdd� | �� | �d� | �d�}|�| j� | �|� W d S ty> t � � | j j p6| j � � }tj|d� � w )NT)�exist_ok� bdist_wheel)�project)rL �mkdir�_ensure_dist_info�reinitialize_command�get_finalized_command�write_wheelfilerM �_create_wheel_file� Exception� traceback� print_excrT �name�get_name�_DebuggingTipsr; )rP r] r^ r> r> r? �run� s �zeditable_wheel.runc C sj | j d u r tt| �d��}| j|_|�� |�� |j | _ d S t| j �� d�s)J �t | j d�� � s3J �d S )Nr$ z .dist-info�METADATA) rM r � dist_info_clsra rL � output_dir�ensure_finalizedrk �str�endswithr �exists)rP r$ r> r> r? r` � s z editable_wheel._ensure_dist_infoc C sD | j }|jsd S t| j| j�dd���� }t||||�}|�� d S )NrJ �.) rT �namespace_packagesr rN rX �get�resolve�_NamespaceInstaller�install_namespaces)rP �installation_dir� pth_prefixrS rU � installerr> r> r? �_install_namespaces� s z"editable_wheel._install_namespacesr2 c C s2 | j r t| j �jnt� }tt|�d��}t|d �S )Nz *.egg-info)rM r �parent�maprp �glob�next)rP � parent_dir� candidatesr> r> r? �_find_egg_info_dir� s z!editable_wheel._find_egg_info_dirrh rp �unpacked_wheelr � build_lib�tmp_dirc C s< | j }t|�}t|�}tt||� d�d��}tt||� d�d��}tt||� d�d��} tt|jddd��} t|�| _d| _tt|jddd��} tt |jd dd��} | | _ | _ | _ | | _ | _| _| | _| _|| _|| _tt|�d ��} d| _t|�| _tt|�d ��}d |_| �� |_| � � | � � | � � d S )a� Configure commands to behave in the following ways: - Build commands can write to ``build_lib`` if they really want to... (but this folder is expected to be ignored and modules are expected to live in the project directory...) - Binary extensions should be built in-place (editable_mode = True) - Data/header/script files are not part of the "editable" specification so they are written directly to the unpacked_wheel directory. z.data�data�headers�scriptsr% T)�reinit_subcommandsr" r& r' r# FN) rT rp r r � egg_info_clsra �egg_base�ignore_egg_info_in_manifest� build_cls� install_cls� build_platlib� build_purelibr� �install_purelib�install_platlib� install_libr' � build_scripts�install_headers� install_data�install_scripts_cls�get_command_obj�no_ep� build_temp� build_py_cls�compiler� �existing_egg_info_dir�_set_editable_modero )rP rh r� r� r� rS �wheelr� r� r� r% r" r& r' r# r> r> r? �_configure_build� sB � �� � z editable_wheel._configure_buildc C sN | j }|�d�}|�� D ]}|�|�}t|d�r d|_q t|d�r$d|_q dS )z8Set the ``editable_mode`` flag in the build sub-commandsr" � editable_modeT�inplaceN)rT r� �get_sub_commands�hasattrr� r� )rP rS r" �cmd_name�cmdr> r> r? r� � s ��z!editable_wheel._set_editable_mode� tuple[list[str], dict[str, str]]c C sj g }i }| � d�}|�� D ]#}| � |�}t|d�r"|�|�� p g � t|d�r0|�|�� p.i � q ||fS )Nr" � get_outputs�get_output_mapping)rb r� r� �extendr� �updater� )rP �files�mappingr" r� r� r> r> r? �_collect_build_outputs� s �z%editable_wheel._collect_build_outputs� dist_namec C sJ | � ||||� | �� | �� \}}| �d� | �d� | �d� ||fS )Nr� r� r� )r� �_run_build_subcommandsr� � _run_install)rP r� r� r� r� r� r� r> r> r? �_run_build_commands� s z"editable_wheel._run_build_commandsc C sP | � d�}|�� D ] }| � |�}|dkr t|�tur | �|� q | �|� q dS )a} Issue #3501 indicates that some plugins/customizations might rely on: 1. ``build_py`` not running 2. ``build_py`` always copying files to ``build_lib`` However both these assumptions may be false in editable_wheel. This method implements a temporary workaround to support the ecosystem while the implementations catch up. r" r# N)rb r� �typer� � _safely_run� run_command)rP r" rh r� r> r> r? r� s �z%editable_wheel._run_build_subcommandsr� c C sF z| � |�W S ty" t�ddt�� � d|� d|� d�� Y d S w )Nz0Customization incompatible with editable installz z� If you are seeing this warning it is very likely that a setuptools plugin or customization overrides the `a ` command, without taking into consideration how editable installs run build steps starting from setuptools v64.0.0. Plugin authors and developers relying on custom build steps are encouraged to update their `aa ` implementation considering the information about editable installs in https://setuptools.pypa.io/en/latest/userguide/extension.html. For the time being `setuptools` will silence this error and ignore the faulty command, but this behavior will change in future versions. )r� re r r; rf � format_exc)rP r� r> r> r? r� $ s �� � ��zeditable_wheel._safely_runc C s� ddl m} | �d�}|j}d�|�� �}d}|� d|� d|� d�}t| j|�}|�� r0|� � t |d�} t dd�} t d d�} | ��} | �s} | �a}t| t| j �j�}t � | j |� | �| |� | �|| | |�\}}| �||| �}|�( ||d ��}||||� |�| � W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y W d � |S W d � |S 1 s�w Y |S ) Nr r) r$ �-z 0.editablez.whl)�suffixz .build-libz .build-temp�w)�wheel.wheelfiler* rb rh rZ �get_tagr rL rr �unlinkr rM �shutil�copytreer| r� �_select_strategy� write_files)rP r] r* r$ r� �tag� build_tag� archive_name� wheel_pathr� r� � build_tmp�unpacked�lib�tmp�unpacked_dist_infor� r� �strategy� wheel_objr> r> r? rd @ sB �� � ��( � � z!editable_wheel._create_wheel_file�categoryc C sL t | jd|� �d �}|r"|� r$t�d|� d�� | �d|� �� d S d S d S )N�has_z Installing z as non editable�install_)�getattrrT �_logger�infor� )rP r� � has_categoryr> r> r? r� \ s �zeditable_wheel._run_installr� �EditableStrategyc C s� d|� d|� �}t | j�}t�| j�}|tju r)tt | jd|��}t| j|||�S t | j�}t || j |�} |tj u } t | j �dhkrD| sF| rX| j �dd�} t| j|t || �g�S t| j|�S )zDDecides which strategy to use to implement an editable installation.� __editable__.r� r" rJ rs )r rN r- r@ r1 rE � _empty_dir� _LinkTreerT �_find_packages�_simple_layoutrX r4 �setru � _StaticPth�_TopLevelFinder) rP rh r� r� � build_namerN r1 � auxiliary_dir�packages�has_simple_layout�is_compat_mode�src_dirr> r> r? r� b s z editable_wheel._select_strategy�r3 rR )r3 r2 )rh rp r� r r� r r� r )r3 r� ) r� rp r� r r� r r� r r3 r� )r� rp )r� rp )rh rp r� rp r� r r3 r� )rA rB rC rD � descriptionr r- � user_optionsrQ r[ rk r` r| r� r� r� r� r� r� r� rd r� r� r> r> r> r? rG g s, � : rG c @ s* e Zd Zdd d �Zdd d �Zddd�ZdS )r� r� r* r� � list[str]r� �Mapping[str, str]r3 �objectc C � d S rK r> �rP r� r� r� r> r> r? �__call__~ s zEditableStrategy.__call__r( c C r� rK r> rO r> r> r? � __enter__� s zEditableStrategy.__enter__� _exc_type�type[BaseException] | None� _exc_value�BaseException | None� _traceback�TracebackType | Nonec C r� rK r> �rP r� r� r� r> r> r? �__exit__� s zEditableStrategy.__exit__N)r� r* r� r� r� r� r3 r� �r3 r( )r� r� r� r� r� r� r3 r� )rA rB rC r� r� r� r> r> r> r? r� } s r� c @ s4 e Zd Zd d d �Zd dd�Zd dd�Zd dd�Zd S )!r� rS r rh rp � path_entries� list[Path]r3 rR c C s || _ || _|| _d S rK )rS rh r� )rP rS rh r� r> r> r? �__init__� s z_StaticPth.__init__r� r* r� r� r� r� c C s> d� dd� | jD ��}t|� d��}|�d| j� d�|� d S )N� c s s � | ] }t |�� �V qd S rK )rp rv )�.0�pr> r> r? � <genexpr>� � � z&_StaticPth.__call__.<locals>.<genexpr>r� �.pth)rZ r� � _encode_pth�writestrrh )rP r� r� r� �entries�contentsr> r> r? r� � s z_StaticPth.__call__r( c C s, dt ttj| j���d�}t�|t � | S )Nz_ Editable install will be performed using .pth file to extend `sys.path` with: z )�listr~ rV �fspathr� r� �warning�_LENIENT_WARNING�rP �msgr> r> r? r� � s �z_StaticPth.__enter__r� r� r� r� c C r� rK r> r� r> r> r? r� � s z_StaticPth.__exit__N)rS r rh rp r� r� r3 rR �r� r* r� r� r� r� r� �r� r� r� r� r� r� r3 rR )rA rB rC r� r� r� r� r> r> r> r? r� � s r� c sd e Zd ZdZd*� fd d � Zd+� fdd� Zd,dd�Zd-d.d d �Zd/d d �Zd0d"d#�Z d1d(d)�Z � Z S )2r� a` Creates a ``.pth`` file that points to a link tree in the ``auxiliary_dir``. This strategy will only link files (not dirs), so it can be implemented in any OS, even if that means using hardlinks instead of symlinks. By collocating ``auxiliary_dir`` and the original source code, limitations with hardlinks should be avoided. rS r rh rp r� r r� r3 rR c s> t |�| _t |��� | _|�d�j| _t� �||| jg� d S )Nr# ) r r� rv r� r� � copy_file�_file�superr� )rP rS rh r� r� �� __class__r> r? r� � s z_LinkTree.__init__r� r* r� r� r� r� c s | � ||� t� �|||� d S rK )� _create_linksr r� r� r r> r? r� � s z_LinkTree.__call__�filer2 c C sR t t�� t|��� �| j�}t|��tj d�W d � S 1 s"w Y d S )N�/) r � ValueErrorr rv � relative_tor� rp �replacerV �sep)rP r rY r> r> r? �_normalize_output� s �z_LinkTree._normalize_outputN�relative_output�src_filec C s6 | j | }|j�� s|jjdd� | j|||d� d S )NT)�parents��link)r� r} �is_dirr_ r )rP r r r �destr> r> r? � _create_file� s z_LinkTree._create_file�output_mappingc s� � j jddd� t� j �rdnd}� fdd�|�� D �}dd� |D �}|D ]}� �|�}|r8||vr8� �||� q%|�� D ] \}}� j|||d � q=d S ) NT)r r\ �sym�hardc 3 s" � | ] \}}� � |�|fV qd S rK )r �r� �k�vrO r> r? r� � s � z*_LinkTree._create_links.<locals>.<genexpr>c S s i | ] \}}|d ur||�qS rK r> r# r> r> r? � <dictcomp>� s z+_LinkTree._create_links.<locals>.<dictcomp>r )r� r_ �_can_symlink_files�itemsr r ) rP �outputsr � link_type� normalised�mappings�output�relative�srcr> rO r? r � s ��z_LinkTree._create_linksr( c C � d}t �|t � | S )Nz=Strict editable install will be performed using a link tree. )r� r �_STRICT_WARNINGr r> r> r? r� � � z_LinkTree.__enter__r� r� r� r� c C s d| j � d�}t�d|� d S )Nz\ Strict editable installation performed using the auxiliary directory: z� Please be careful to not remove this directory, otherwise you might not be able to import/use your package. �Editable installation.)r� r r; �rP r� r� r� r r> r> r? r� � s �z_LinkTree.__exit__) rS r rh rp r� r r� r r3 rR r )r rp r3 r2 rK )r rp r rp )r r� r� r ) rA rB rC rD r� r� r r r r� r� � __classcell__r> r> r r? r� � s r� c @ sH e Zd Zd!dd�Zd"d d �Zd#d d�Zd$dd�Zd%dd�Zd&d d �Zd S )'r� rS r rh rp r3 rR c C s || _ || _d S rK )rS rh )rP rS rh r> r> r? r� � s z_TopLevelFinder.__init__�5tuple[str, str, dict[str, str], dict[str, list[str]]]c s� �j jptj}tt�j �t�j ��}�j jpi }t|||�� t tt �j j p&g � �dd� t � �D ���}� �fdd��j j p>g D �}i � �|�}d�j� d�}t�|�}||||fS )Nc s s � | ]}|g fV qd S rK r> )r� �nsr> r> r? r� s � z0_TopLevelFinder.template_vars.<locals>.<genexpr>c s" i | ] }|t |� �jjp d ��qS )rJ )r rS rU �r� �pkg��rootsrP r> r? r& s ��z1_TopLevelFinder.template_vars.<locals>.<dictcomp>r� z.finder)rS rU rV rW r r� �_find_top_level_modulesrX �_find_package_roots�dict�_find_namespacesr� �_find_virtual_namespacesrt rh r �safe_identifier) rP rU � top_levelrX � namespaces_�legacy_namespacesr� rh �finderr> r: r? � template_vars� s" �� � z _TopLevelFinder.template_vars�Iterator[tuple[str, bytes]]c c sb � | � � \}}}}tt|||�d�}|� d�|fV td|� d|� d��}d| j� d�|fV d S )N�utf-8z.pyzimport z; z .install()r� r� )rF �bytes�_finder_templater� rh )rP rE rh r� rC �contentr> r> r? �get_implementation s �z"_TopLevelFinder.get_implementationr� r* r� r� r� r� c C s" | � � D ] \}}|�||� qd S rK )rL r )rP r� r� r� r rK r> r> r? r� s �z_TopLevelFinder.__call__r( c C r0 )Nz=Editable install will be performed using a meta path finder. )r� r r r r> r> r? r� r2 z_TopLevelFinder.__enter__r� r� r� r� c C s d}t �d|� d S )Nz� Please be careful with folders in your working directory with the same name as your package as they may take precedence during imports. r3 )r r; r4 r> r> r? r� $ s z_TopLevelFinder.__exit__N)rS r rh rp r3 rR )r3 r6 )r3 rG r r� r ) rA rB rC r� rF rL r� r� r� r> r> r> r? r� � s r� rK rp r3 rI c C s` t �� �"}t j|tjd�}|�| � |�� |�d� |�� W d � S 1 s)w Y dS )a� Prior to Python 3.13 (see https://github.com/python/cpython/issues/77102), .pth files are always read with 'locale' encoding, the recommendation from the cpython core developers is to write them as ``open(path, "w")`` and ignore warnings (see python/cpython#77102, pypa/setuptools#3937). This function tries to simulate this behavior without having to create an actual file, in a way that supports a range of active Python versions. (There seems to be some variety in the way different version of Python handle ``encoding=None``, not all of them use ``locale.getpreferredencoding(False)`` or ``locale.getencoding()``). ��encodingr N) �io�BytesIO� TextIOWrapperr � PTH_ENCODING�write�flush�seek�read)rK �buffer�wrapperr> r> r? r� 1 s $�r� �base_dirr �boolc C s t t| �� �d��o}t|d�t|d�}}|jddd� tttt��) t � ||� |� � rD|j dd�dkrD W d � W d � dS W d � n1 sNw Y zt � ||� W n tyn } zd}t|�|�d }~ww W d � d S 1 s{w Y d S ) N)�dirz file1.txtz file2.txt�file1rH rM Tz�File system does not seem to support either symlinks or hard links. Strict editable installs require one of them to be supported.F)r rp rv r � write_textr �AttributeError�NotImplementedError�OSErrorrV �symlink� is_symlink� read_textr re �LinksNotSupported)rY r� �path1�path2�exr r> r> r? r' F s* ��� � ��$�r' r� � Iterable[str]rX �dict[str, str]rN r c sZ � �fdd�| D �}|st � �i dhfv S tj�tt|�� ���t�fdd�|�� D ��S )a[ Return ``True`` if: - all packages are contained by the same parent directory, **and** - all packages become importable if the parent directory is added to ``sys.path``. >>> _simple_layout(['a'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.b'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.b'], {}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "a", "b": "b"}, ".") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a", "b": "_b"}, ".") False >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a"}, "/tmp/myproj") False >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a.a1.a2": "_a2"}, ".") False >>> _simple_layout(['a', 'a.b'], {"": "src", "a.b": "_ab"}, "/tmp/myproj") False >>> # Special cases, no packages yet: >>> _simple_layout([], {"": "src"}, "/tmp/myproj") True >>> _simple_layout([], {"a": "_a", "": "src"}, "/tmp/myproj") False c s i | ] }|t |� ���qS r> r r8 )rX rN r> r? r& y s z"_simple_layout.<locals>.<dictcomp>rJ c 3 s2 � | ]\}}t �t� g|�d ��R � |�V qdS �rs N)r � same_pathr �split)r� �key�value)r} r> r? r� } s � � �z!_simple_layout.<locals>.<genexpr>)r� rV rY � commonpathr � _parent_pathr( �all)r� rX rN �layoutr> )rX r} rN r? r� Z s �r� c C s0 |� | �r|dt| � � n|}|�dtj �S )a7 Infer the parent path containing a package, that if added to ``sys.path`` would allow importing that package. When ``pkg`` is directly mapped into a directory with a different name, return its own path. >>> _parent_path("a", "src/a") 'src' >>> _parent_path("b", "src/c") 'src/c' Nr )rq �len�rstriprV r )r9 �pkg_pathr} r> r> r? rp � s rp rS r � Iterator[str]c c s~ � t | jpg �E d H | jpg }dd� |D �}| jr | jV n| jp#g }|dd� |D �7 }|D ] }|�d�\}}}|V q/d S )Nc S s g | ]}d |v r|�qS �rs r> �r� �modr> r> r? � <listcomp>� s z"_find_packages.<locals>.<listcomp>c S s g | ] }d |j v r|j �qS rw �rh �r� �xr> r> r? rz � s rs )�iterr� � py_modules� ext_package� ext_modules� rpartition)rS r �nested_modulesr� �module�package�_r> r> r? r� � s � �r� c c sL � | j pg }dd� |D �E d H | js$| jpg }dd� |D �E d H d S d S )Nc s s � | ] }d |vr|V qdS rj r> rx r> r> r? r� � r� z*_find_top_level_modules.<locals>.<genexpr>c s s � | ] }d |j vr|j V qdS rj r{ r| r> r> r? r� � s � )r r� r� )rS r r� r> r> r? r< � s � �r< r� rU c s � �fdd�t | �D �}t|�S )Nc s i | ] }|t t|� ����qS r> )�_absolute_rootr r8 �rX rU r> r? r& � s ��z'_find_package_roots.<locals>.<dictcomp>)�sorted�_remove_nested)r� rX rU � pkg_rootsr> r� r? r= � s �r= rY c C s4 t | �}|j}|�� rt|�� �S t|�� |j �S )z(Works for packages and top-level modules)r r} rr rp rv rh )rY �path_r} r> r> r? r� � s r� r� c c sv � | D ]5}d|vr q|� d�}tt|�d dd�D ] }d�|d|� �}tt|| d��}|�� r4|| vr7|V qqdS )a8 By carefully designing ``package_dir``, it is possible to implement the logical structure of PEP 420 in a package without the corresponding directories. Moreover a parent package can be purposefully/accidentally skipped in the discovery phase (e.g. ``find_packages(include=["mypkg.*"])``, when ``mypkg.foo`` is included by ``mypkg`` itself is not). We consider this case to also be a virtual namespace (ignoring the original directory) to emulate a non-editable installation. This function will try to find these kinds of namespaces. rs r! r ���NrJ )rl �rangers rZ r r rr )r� r9 �parts�i� partial_namerY r> r> r? r@ � s � ���r@ r� � Iterator[tuple[str, list[str]]]c c sB � | D ]}t ||d�}t|��� r t|d��� s ||gfV qd S )NrJ z __init__.py)r r rr )r� r� r9 rY r> r> r? r? � s � ��r? c sP t | �� �}tt| �� ��D ]\�� t� �fdd�| �� D ��r%|��� q|S )Nc 3 s* � | ]\}}�|kot �� ||�V qd S rK )� _is_nested)r� �other� other_path�rY r9 r> r? r� � s � � �z!_remove_nested.<locals>.<genexpr>)r> �copy�reversedr r( �any�pop)r� r- r> r� r? r� � s � �r� r9 ru r} � parent_pathc C sH t �|�}| �|dd��d��d�}| �|�o#|t �t|g|�R � �kS )a� Return ``True`` if ``pkg`` is nested inside ``parent`` both logically and in the file system. >>> _is_nested("a.b", "path/a/b", "a", "path/a") True >>> _is_nested("a.b", "path/a/b", "a", "otherpath/a") False >>> _is_nested("a.b", "path/a/b", "c", "path/c") False >>> _is_nested("a.a", "path/a/a", "a", "path/a") True >>> _is_nested("b.a", "path/b/a", "a", "path/a") False rJ r! rs )r �normpathr �striprl � startswithr )r9 ru r} r� � norm_pkg_path�restr> r> r? r� � s �r� �dir_c C s t j| dd� t�| � | S )zFCreate a directory ensured to be empty. Existing files may be removed.T)� ignore_errors)r �rmtreerV �makedirs)r� r> r> r? r� s r� c @ s& e Zd Zd dd�Zdd� Zdd� Zd S ) rw r3 rR c C s( || _ || _|| _|| _g | _d| _d S )NF)rT rU ry � editable_namer) �dry_run)rP rT ry r� rU r> r> r? r� s z _NamespaceInstaller.__init__c C s t j�| j| j| j �S )zInstallation target.)rV rY rZ ry r� � nspkg_extrO r> r> r? �_get_nspkg_file s z#_NamespaceInstaller._get_nspkg_filec C s t t| j��S )z1Where the modules/packages should be loaded from.)�reprrp rU rO r> r> r? � _get_root s z _NamespaceInstaller._get_rootNr� )rA rB rC r� r� r� r> r> r> r? rw s rw a from __future__ import annotations import sys from importlib.machinery import ModuleSpec, PathFinder from importlib.machinery import all_suffixes as module_suffixes from importlib.util import spec_from_file_location from itertools import chain from pathlib import Path MAPPING: dict[str, str] = {mapping!r} NAMESPACES: dict[str, list[str]] = {namespaces!r} PATH_PLACEHOLDER = {name!r} + ".__path_hook__" class _EditableFinder: # MetaPathFinder @classmethod def find_spec(cls, fullname: str, path=None, target=None) -> ModuleSpec | None: # type: ignore # Top-level packages and modules (we know these exist in the FS) if fullname in MAPPING: pkg_path = MAPPING[fullname] return cls._find_spec(fullname, Path(pkg_path)) # Handle immediate children modules (required for namespaces to work) # To avoid problems with case sensitivity in the file system we delegate # to the importlib.machinery implementation. parent, _, child = fullname.rpartition(".") if parent and parent in MAPPING: return PathFinder.find_spec(fullname, path=[MAPPING[parent]]) # Other levels of nesting should be handled automatically by importlib # using the parent path. return None @classmethod def _find_spec(cls, fullname: str, candidate_path: Path) -> ModuleSpec | None: init = candidate_path / "__init__.py" candidates = (candidate_path.with_suffix(x) for x in module_suffixes()) for candidate in chain([init], candidates): if candidate.exists(): return spec_from_file_location(fullname, candidate) return None class _EditableNamespaceFinder: # PathEntryFinder @classmethod def _path_hook(cls, path) -> type[_EditableNamespaceFinder]: if path == PATH_PLACEHOLDER: return cls raise ImportError @classmethod def _paths(cls, fullname: str) -> list[str]: paths = NAMESPACES[fullname] if not paths and fullname in MAPPING: paths = [MAPPING[fullname]] # Always add placeholder, for 2 reasons: # 1. __path__ cannot be empty for the spec to be considered namespace. # 2. In the case of nested namespaces, we need to force # import machinery to query _EditableNamespaceFinder again. return [*paths, PATH_PLACEHOLDER] @classmethod def find_spec(cls, fullname: str, target=None) -> ModuleSpec | None: # type: ignore if fullname in NAMESPACES: spec = ModuleSpec(fullname, None, is_package=True) spec.submodule_search_locations = cls._paths(fullname) return spec return None @classmethod def find_module(cls, _fullname) -> None: return None def install(): if not any(finder == _EditableFinder for finder in sys.meta_path): sys.meta_path.append(_EditableFinder) if not NAMESPACES: return if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks): # PathEntryFinder is needed to create NamespaceSpec without private APIS sys.path_hooks.append(_EditableNamespaceFinder._path_hook) if PATH_PLACEHOLDER not in sys.path: sys.path.append(PATH_PLACEHOLDER) # Used just to trigger the path hook rh r� r �dict[str, list[str]]c C s( t t|�� dd� d��}tj| ||d�S )z_Create a string containing the code for the``MetaPathFinder`` and ``PathEntryFinder``. c S s | d S )Nr r> )r� r> r> r? �<lambda>~ s z"_finder_template.<locals>.<lambda>)rm �rh r� r )r> r� r( �_FINDER_TEMPLATE�formatr� r> r> r? rJ x s rJ c @ s e Zd ZdZdS )rd zCFile system does not seem to support either symlinks or hard links.N)rA rB rC rD r> r> r> r? rd � s rd c @ s e Zd ZdZdZdZdS )rj z!Problem in editable installation.a An error happened while installing `{project}` in editable mode. The following steps are recommended to help debug this problem: - Try to install the project normally, without using the editable mode. Does the error still persist? (If it does, try fixing the problem before attempting the editable mode). - If you are using binary extensions, make sure you have all OS-level dependencies installed (e.g. compilers, toolchains, binary libraries, ...). - Try the latest version of setuptools (maybe the error was already fixed). - If you (or your project dependencies) are using any setuptools extension or customization, make sure they support the editable mode. After following the steps above, if the problem still persists and you think this is related to how setuptools handles editable installations, please submit a reproducible example (see https://stackoverflow.com/help/minimal-reproducible-example) to: https://github.com/pypa/setuptools/issues r5 N)rA rB rC �_SUMMARY�_DETAILS� _SEE_DOCSr> r> r> r? rj � s rj )rK rp r3 rI )rY r r3 rZ )r� rh rX ri rN r r3 rZ )rS r r3 rv )r� rh rX r� rU r r3 ri )rY r r3 rp )r� ri r3 rv )r� r� r� ri r3 r� )r� ri r3 ri ) r9 rp ru rp r} rp r� rp r3 rZ )r� r+ r3 r+ )rh rp r� r� r r� r3 rp )brD � __future__r rO �loggingrV r� rf �collections.abcr r r � contextlibr �enumr �inspectr � itertoolsr r �pathlibr �tempfiler �typesr �typingr r r r rJ r r r r r r r r0 r � discoveryr rS r �warningsr r r r" r� r# r� r$ rm r% r� r& r� r' r� �typing_extensionsr( �_vendor.wheel.wheelfiler* r+ � getLoggerrA r� r- r1 r rG r� r� r� r� r� r' r� rp r� r< r= r� r@ r? r� r� r� � Installerrw r� rJ � FileErrorrd rj r> r> r> r? �<module> sz ) L ? ) Y command/__pycache__/bdist_egg.cpython-310.pyc 0000644 00000032641 15030122015 0015015 0 ustar 00 o �hLB � @ sp U d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z m Z ddl m Z ddl mZmZ ddlmZ ddlmZ d d lmZmZ dd lmZ dd lmZmZ er]dd l m Z ed Z de d< dd� Z dd� Z!dd� Z"d;dd�Z#G dd � d e�Z$e%�&d �'� �Z(d e d < d d!� Z)d"d#� Z*d;d$d%�Z+d&d'd(�Z,d)d*� Z-d+d,� Z.d<d.d/�Z/g d0�Z0 1 1 2 3d=d>d9d:�Z1dS )?z6setuptools.command.bdist_egg Build .egg distributions� )� annotationsN)�get_path�get_python_version)�CodeType)� TYPE_CHECKING�Literal)�Command)�Library� )�StrPathT�ensure_directory)�log)�mkpath� remove_tree)� TypeAlias)�r�w�x�ar � _ZipFileModec C s t d�S )N�purelib)r � r r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/bdist_egg.py� _get_purelib � r c C s2 d| v r t j�| �d } | �d�r| d d� } | S )N�.r �modulei����)�os�path�splitext�endswith)�filenamer r r � strip_module# s r" c c s8 � t �| �D ]\}}}|�� |�� |||fV qdS )zbDo os.walk in a reproducible way, independent of indeterministic filesystem readdir order N)r �walk�sort)�dir�base�dirs�filesr r r � sorted_walk+ s ��r) �return�Nonec C sP t �d��� }t|ddd��}|�|| � W d � d S 1 s!w Y d S )Na� def __bootstrap__(): global __bootstrap__, __loader__, __file__ import sys, pkg_resources, importlib.util __file__ = pkg_resources.resource_filename(__name__, %r) __loader__ = None; del __bootstrap__, __loader__ spec = importlib.util.spec_from_file_location(__name__,__file__) mod = importlib.util.module_from_spec(spec) spec.loader.exec_module(mod) __bootstrap__() r �utf-8��encoding)�textwrap�dedent�lstrip�open�write)�resource�pyfile�_stub_template�fr r r � write_stub5 s � � "�r8 c @ s� e Zd ZdZg d�Zg d�Zdd� Zd dd �Zd d d �Zd d � Z dd� Z dd� Z dd� Z dd� Z d dd�Zd dd�Zdd � Zd S ) � bdist_eggz create an "egg" distribution))z bdist-dir=�bz1temporary directory for creating the distribution)z plat-name=�pzdplatform name to embed in generated filenames (by default uses `pkg_resources.get_build_platform()`))�exclude-source-filesNz+remove all .py files from the generated egg)� keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z dist-dir=�dz-directory to put final built distributions in)� skip-buildNz2skip rebuilding everything (for testing/debugging))r= r@ r< c C s. d | _ d | _d| _d | _d| _d | _d | _d S )NF)� bdist_dir� plat_name� keep_temp�dist_dir� skip_build� egg_output�exclude_source_files��selfr r r �initialize_options_ s z bdist_egg.initialize_optionsr* r+ c C s� | � d� }| _|j| _| jd u r | � d�j}tj�|d�| _| jd u r.ddl m } |� | _| � dd� | j d u rT|j t� | j�� oD| jd�}tj�| j|d �| _ d S d S ) N�egg_info�bdist�eggr )�get_build_platform)rD rD )� py_version�platformz.egg)�get_finalized_command�ei_cmdrK rA � bdist_baser r �joinrB � pkg_resourcesrN �set_undefined_optionsrF �_get_egg_basenamer � distribution�has_ext_modulesrD )rI rR rS rN �basenamer r r �finalize_optionsh s ��zbdist_egg.finalize_optionsc C s� | j | �d�_tj�tj�t� ��}| jj g }| j_ |D ]D}t |t �rZt |�dkrZtj� |d �rZtj�|d �}tj�|�}||ksL|�|tj �rZ|t |�d d � |d f}| jj �|� q zt�d| j � | jddd d� W || j_ d S || j_ w ) N�installr r � z installing package data to %s� install_dataF)�force�root)rA rQ � install_libr r �normcase�realpathr rX � data_files� isinstance�tuple�len�isabs� startswith�sep�appendr �info� call_command)rI � site_packages�old�itemrc � normalizedr r r �do_install_data� s" � zbdist_egg.do_install_datac C s | j gS )N)rF rH r r r � get_outputs� r zbdist_egg.get_outputsc K sT t D ] }|�|| j� q|�d| j� |�d| j� | j|fi |��}| �|� |S )z8Invoke reinitialized command `cmdname` with keyword argsrE �dry_run)�INSTALL_DIRECTORY_ATTRS� setdefaultrA rE rt �reinitialize_command� run_command)rI �cmdname�kw�dirname�cmdr r r rm � s zbdist_egg.call_commandc C s� | � d� t�d| j� | �d�}|j}d |_| j�� r$| js$| � d� | j ddd�}||_| � � \}}g | _ g }t |�D ]>\}}t j�|�\} } t j�| jt| �d �} | j �| � t�d |� | jsmtt j�|�| � |�| � |�t jd �||< q=|r�|�|� | jjr�| �� | j} t j�| d �} | �| � | jj r�t j�| d �}t�d |� | j d|dd� | � | � t j�| d�}|r�t�d|� | js�t |� t |ddd��}|� d�|�� |� d� W d � n1 s�w Y nt j�!|��r t�d|� | j�s t �"|� t#t j�| d �| �$� � t j�%t j�| j&d���r't�'d� | j(�r/| �)� t*| j+| | j,| j| �-� d� | j.�sIt/| j| jd� t0| jd g ��d t1� | j+f� d S ) NrK z installing library code to %sr\ � build_clibra F)�warn_dir�.pyzcreating stub loader for %s�/�EGG-INFO�scriptszinstalling scripts to %s�install_scriptsT)� install_dir�no_epznative_libs.txtz writing %s�wtr, r- � z removing %sz depends.txtzxWARNING: 'depends.txt' will not be used by setuptools 0.6! Use the install_requires/extras_require setup() args instead.)�verbosert �mode�rt � dist_filesr9 )2rx r rl rA rQ r` rX �has_c_librariesrE rm �get_ext_outputs�stubs� enumerater r r rT r" rk rt r8 rZ �replacerj � byte_compilerd rr r r� �copy_metadata_tor r2 r3 �isfile�unlink�write_safety_flag�zip_safe�existsrK �warnrG � zap_pyfiles� make_zipfilerF r� � gen_headerrC r �getattrr )rI �instcmd�old_rootr| � all_outputs� ext_outputs� to_compiler; �ext_namer! �_extr5 � archive_rootrK � script_dir� native_libs� libs_filer r r �run� s� �� �� �z bdist_egg.runc C s� t �d� t| j�D ]a\}}}|D ]Y}tj�||�}|�d�r*t �d|� t� |� |�d�rj|}d}t � ||�}tj�|tj |� d�d �} t �d|� d | � d �� zt�| � W n tyc Y nw t�|| � qq d S ) Nz+Removing .py files from temporary directoryr z Deleting %s� __pycache__z#(?P<name>.+)\.(?P<magic>[^.]+)\.pyc�name�.pyczRenaming file from [z] to [�])r rl �walk_eggrA r r rT r �debugr� �re�match�pardir�group�remove�OSError�rename) rI r& r' r( r� r �path_old�pattern�m�path_newr r r r� � s, � ���zbdist_egg.zap_pyfilesc C s2 t | jdd �}|d ur |S t�d� t| j| j�S )Nr� z4zip_safe flag not set; analyzing archive contents...)r� rX r r� � analyze_eggrA r� )rI �safer r r r� s zbdist_egg.zip_safe� Literal['w']c C s dS )Nr r rH r r r r� s zbdist_egg.gen_headerc C sh t j�| j�}t j�|d�}| jjjD ] }|�|�r1t j�||t |�d� �}t |� | � ||� qdS )z*Copy metadata (egg info) to the target_dir� N) r r �normpathrK rT rR �filelistr( ri rg r � copy_file)rI � target_dir� norm_egg_info�prefixr �targetr r r r� s ��zbdist_egg.copy_metadata_toc s� g }g }| j di�t| j �D ]&\� }}|�� �fdd�|D �� |D ]}�� | d �tj�� |�< q"q| j�� rp| �d�}|j D ]-}t |t �rJqB|� |j �}|�|�}tj�|��d�sotj�tj�| j |��ro|�|� qB||fS )zAGet a list of relative paths to C extensions in the output distror� c 3 s4 � | ]}t j�|�d �� tv r�� | V qdS )r] N)r r r �lower�NATIVE_EXTENSIONS)�.0r! �r& �pathsr r � <genexpr>/ s � ��z,bdist_egg.get_ext_outputs.<locals>.<genexpr>r� � build_extzdl-)rA r) �extendr r rT rX rY rQ � extensionsre r �get_ext_fullnamer� �get_ext_filenamerZ ri r� rk ) rI r� r� r' r( r! � build_cmd�ext�fullnamer r� r r� ' s, � � �zbdist_egg.get_ext_outputsN�r* r+ )r* r� )�__name__� __module__� __qualname__� description� user_options�boolean_optionsrJ r[ rr rs rm r� r� r� r� r� r� r r r r r9 G s T r9 z.dll .so .dylib .pydzdict[str, None]r� c c sD � t | �}t|�\}}}d|v r|�d� |||fV |E dH dS )z@Walk an unpacked egg's contents, skipping the metadata directoryr� N)r) �nextr� )�egg_dir�walkerr& r' r( r r r r� H s � r� c C s� t �� D ]\}}tj�tj�| d|��r| S qt� s dS d}t| �D ](\}}}|D ] }|�d�s7|�d�r8q+|�d�sB|�d�rKt | |||�oJ|}q+q$|S )Nr� FTr z.pywr� z.pyo) � safety_flags�itemsr r r� rT �can_scanr� r � scan_module) r� r� �flag�fnr� r& r' r( r� r r r r� R s ���r� c C s� t �� D ]G\}}tj�| |�}tj�|�r%|d u s t|�|kr$t�|� q|d urKt|�|krKt|ddd�� }|� d� W d � n1 sFw Y qd S )Nr� r, r- r� ) r� r� r r rT r� �boolr� r2 r3 )r� r� r� r� r7 r r r r� d s � ���r� zzip-safez not-zip-safe)TFc C s� t j�||�}|dd� |v rdS |t| �d d� �t jd�}||r%dp&d t j�|�d }d}t|d �}|�|� t � |�} |� � d} t � t| ��} d D ]} | | v r_t�d || � d } qPd | v rvdD ]} | | v rut�d|| � d } qf| S )z;Check whether module possibly uses unsafe-for-zipfile stuffN���Tr] r r� r � �rb)�__file__�__path__z%s: module references %sF�inspect) � getsource� getabsfile�getfile� getsourcefile�getsourcelines� findsource� getcomments� getframeinfo�getinnerframes�getouterframes�stack�tracez"%s: module MAY be using inspect.%s)r r rT rg r� rj r r2 �read�marshal�load�close�dict�fromkeys� iter_symbolsr r� ) r� r& r� r� r! �pkgr �skipr7 �coder� �symbols�badr r r r� v s0 ��r� c c sH � | j E dH | jD ]}t|t�r|V q t|t�r!t|�E dH q dS )zBYield names and strings used by `code` and its nested code objectsN)�co_names� co_constsre �strr r� )r� �constr r r r� � s � ��r� r� c C s2 t j�d�s t jdkr dS t�d� t�d� dS )N�java�cliTz1Unable to analyze compiled code on this platform.zfPlease ask the author to include a 'zip_safe' setting (either True or False) in the package's setup.pyF)�sysrP ri r r� r r r r r� � s �r� )ra r� r^ � install_baseFTr � zip_filenamer r� rt r� c s� ddl }ttj�| ��d� t�d| � � � �fdd�}|r!|jn|j}�sD|j | ||d�} t � �D ] \} } } || | | � q2| � � | S t � �D ] \} } } |d| | � qH| S )aq Create a zip file from all the files under 'base_dir'. The output zip file will be named 'base_dir' + ".zip". Uses either the "zipfile" Python module (if available) or the InfoZIP "zip" utility (if installed and found on the default search path). If neither tool is available, raises DistutilsExecError. Returns the name of the output zip file. r Nr� z#creating '%s' and adding '%s' to itc s` |D ]+}t j�t j�||��}t j�|�r-|t� �d d � }�s'| �||� t�d|� qd S )Nr] z adding '%s') r r r� rT r� rg r3 r r� )�zr{ �namesr� r r; ��base_dirrt r r �visit� s ��zmake_zipfile.<locals>.visit)� compression) �zipfiler r r r{ r rl � ZIP_DEFLATED� ZIP_STORED�ZipFiler) r� ) r r r� rt �compressr� r r r r r{ r' r( r r r r� � s �r� r� )r* r� )FFTr ) r r r� r� rt r� r� r r* r )2�__doc__� __future__r r� r r� r r/ � sysconfigr r �typesr �typingr r � setuptoolsr �setuptools.extensionr �_pathr r � distutilsr �distutils.dir_utilr r �typing_extensionsr r �__annotations__r r" r) r8 r9 r� r� �splitr� r� r� r� r� r� r� r� ru r� r r r r �<module> sP �( � command/__pycache__/alias.cpython-310.pyc 0000644 00000004516 15030122015 0014157 0 ustar 00 o �hL � @ sD d dl mZmZmZ d dlmZ dd� ZG dd� de�Zdd� Zd S ) � )� config_file� edit_config� option_base)�DistutilsOptionErrorc C s8 dD ] }|| v rt | � S q| �� | gkrt | �S | S )z4Quote an argument for later parsing by shlex.split())�"�'�\�#)�repr�split)�arg�c� r �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/alias.py�shquote s �r c @ sL e Zd ZdZdZdZdgej Zejdg Zdd� Z dd d �Z dd d �Z d S )�aliasz3Define a shortcut that invokes one or more commandsz0define a shortcut to invoke one or more commandsT)�remove�rzremove (unset) the aliasr c C s t �| � d | _d | _d S )N)r �initialize_options�argsr ��selfr r r r s zalias.initialize_options�returnNc C s. t �| � | jrt| j�dkrtd��d S d S )N� zFMust specify exactly one argument (the alias name) when using --remove)r �finalize_optionsr �lenr r r r r r r ! s ��zalias.finalize_optionsc C s� | j �d�}| js td� td� |D ] }tdt||�� qd S t| j�dkrH| j\}| jr1d }n)||v r?tdt||�� d S td|��� d S | jd }d�tt | jdd � ��}t | j d||ii| j � d S ) N�aliaseszCommand Aliasesz---------------zsetup.py aliasr z No alias definition found for r � ) � distribution�get_option_dictr �print� format_aliasr r �join�mapr r �filename�dry_run)r r r �commandr r r �run( s& z alias.run)r N) �__name__� __module__� __qualname__�__doc__� description�command_consumes_argumentsr � user_options�boolean_optionsr r r' r r r r r s �� r c C s\ || \}}|t d�krd}n|t d�krd}n|t d�kr!d}nd|��}|| d | S ) N�globalz--global-config �userz--user-config �local� z --filename=r )r )�namer �sourcer& r r r r! C s r! N) �setuptools.command.setoptr r r �distutils.errorsr r r r! r r r r �<module> s 3 command/__pycache__/_requirestxt.cpython-310.pyc 0000644 00000011113 15030122015 0015613 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl m Z ddl m Z dd lmZ d d lmZ d d lmZ e d �Zeedf Zd(dd�Zd)dd�Zd*dd�Zd d � Zd d � Zd d!� Zd"d#� Z d$d%� Z d&d'� Z dS )+aS Helper code used to generate ``requires.txt`` files in the egg-info directory. The ``requires.txt`` file has an specific format: - Environment markers need to be part of the section headers and should not be part of the requirement spec itself. See https://setuptools.pypa.io/en/latest/deprecated/python_eggs.html#requires-txt � )� annotationsN)� defaultdict)�Mapping)� filterfalse)�TypeVar)� yield_lines)� Requirement� )�_reqs)� _StrOrIter�_T�install_requiresr �extras_require�Mapping[str, _StrOrIter]�return�&tuple[list[str], dict[str, list[str]]]c C s t |�}t| |�S )z�Given values for ``install_requires`` and ``extras_require`` create modified versions in a way that can be written in ``requires.txt`` )� _convert_extras_requirements�"_move_install_requirements_markers)r r �extras� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/_requirestxt.py�_prepare s r �'defaultdict[str, _Ordered[Requirement]]c C sX t ttt f t�}| �� D ]\}}|| t�|�D ] }||t|� � |� qq|S )z� Convert requirements in `extras_require` of the form `"extra": ["barbazquux; {marker}"]` to `"extra:{marker}": ["barbazquux"]`. ) r �str�_Orderedr �dict�itemsr �parse� _suffix_for� setdefault)r �output�section�v�rr r r r ' s �r �#Mapping[str, _Ordered[Requirement]]c C sp t t�| ��}tt|�}tt|�}t tt|��}|D ]}|dt|j� � |� qt dd� |� � D ��}||fS )a+ The ``requires.txt`` file has an specific format: - Environment markers need to be part of the section headers and should not be part of the requirement spec itself. Move requirements in ``install_requires`` that are using environment markers ``extras_require``. �:c s s6 � | ]\}}|t t�d d� tt|�D ���fV qdS )c s s � | ]}t |�V qd S �N)r )�.0r# r r r � <genexpr>R s � z?_move_install_requirements_markers.<locals>.<genexpr>.<genexpr>N)�listr �fromkeys�map� _clean_req)r' �kr" r r r r( P s � � �z5_move_install_requirements_markers.<locals>.<genexpr>) r) r r �filter� _no_markerr r+ r �markerr r r )r r � inst_reqs� simple_reqs� complex_reqs�simple_install_requiresr# �expanded_extrasr r r r 9 s �r c C s | j r dt| j � S dS )z;Return the 'extras_require' suffix for a given requirement.r% � )r0 r ��reqr r r r Y s r c C s t t| ��}d|_|S )z=Given a Requirement, remove environment markers and return itN)r r r0 )r8 r# r r r r, ^ s r, c C s | j S r& )r0 r7 r r r r/ e � r/ c C s, t |pd�}dd� }t||�}| �|� d S )Nr c S s | d S )N� r )�liner r r � append_crl r9 z&_write_requirements.<locals>.append_cr)r r+ � writelines)�stream�reqs�linesr< r r r �_write_requirementsi s rA c C s| | j }t�� }t|jp d|jpi �\}}t||� t|�D ]}|�dj di t � ��� t||| � q | � d||� � � d S )Nr z [{extra}] � requirements) � distribution�io�StringIOr r r rA �sorted�write�format�vars�write_or_delete_file�getvalue)�cmd�basename�filename�dist�datar r �extrar r r �write_requirementss s � rR c C s, t �� }t|| jj� | �d||�� � d S )Nzsetup-requirements)rD rE rA rC �setup_requiresrJ rK )rL rM rN rP r r r �write_setup_requirements� s rT )r r r r r r )r r r r )r r r r$ r r ) �__doc__� __future__r rD � collectionsr �collections.abcr � itertoolsr �typingr � jaraco.textr �packaging.requirementsr r6 r r r r r r r r r r, r/ rA rR rT r r r r �<module> s, command/__pycache__/easy_install.cpython-310.pyc 0000644 00000177273 15030122015 0015570 0 ustar 00 o �h>W � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZm Z m Z ddl m Z ddl Z dd l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z- dd l.m/Z/ dd l0m1Z1 dd l2m3Z3m4Z4m5Z5 dd l6m7Z7m8Z8m9Z9 ddl:m;Z; ddl<m=Z=m>Z> ddl?m@Z@ ddlAmBZB ddlCmDZEmFZG ddlHmIZImJZJ ddlKmLZLmMZM ddlNmOZO ddlPmQZQ ddlRmSZSmTZTmUZUmVZV ddlWmXZXmYZYmZZZ e�rddl[m\Z\ ej]de j^d � g d �Z_d d � Z`d d!� Zad"d#� Zbd$d%� ZcG d&d'� d'e/�Zdd(d)� Zed*d+� Zfd,d-� Zgd.d/� Zhd0d1� ZiG d2d3� d3e%�ZjG d4d5� d5ej�Zkejl�md6d7�d8k�riekZjd9d:� Znd;d<� Zod=d>� Zpdnd?d@�ZqdAdB� ZrdCdD� ZsdEejtv �r�esZundFdG� ZudodIdJ�ZvdKdL� ZwdMdN� ZxdOdP� ZyG dQdR� dRe dSdT�ZzG dUdV� dVe{�Z|e|�}� Z~G dWdX� dXe|�ZG dYdZ� dZ�Z�G d[d\� d\e��Z�G d]d^� d^e��Z�d_d`� Z�dadb� Z�dcdd� Z�dedf� Z�dpdjdk�Z�G dldm� dme=�Z�dS )qa) Easy Install ------------ A tool for doing automatic download/extract/build of distutils-based Python packages. For detailed documentation, see the accompanying EasyInstall.txt file, or visit the `EasyInstall home page`__. __ https://setuptools.pypa.io/en/latest/deprecated/easy_install.html � )� annotationsN)�Iterable)�glob)�get_path)� TYPE_CHECKING�NoReturn� TypedDict)� yield_lines) � DEVELOP_DIST� Distribution�DistributionNotFound� EggMetadata� Environment� PathMetadata� Requirement�VersionConflict� WorkingSet�find_distributions�get_distribution�normalize_path�resource_string)�Command)�unpack_archive)� bdist_egg�egg_info�setopt)� URL_SCHEME� PackageIndex�parse_requirement_arg)� run_setup)� SetuptoolsDeprecationWarning�SetuptoolsWarning)�Wheel� )�ensure_directory)�attempt_chmod_verbose�rmtree)�py39�py312)�dir_util�log)�install)� first_line_re)�DistutilsArgError�DistutilsError�DistutilsOptionError�DistutilsPlatformError)� convert_path� get_platform� subst_vars)�Self�default)�category)� easy_install�PthDistributions�extract_wininst_cfg�get_exe_prefixesc C s t �d�dkS )N�P� )�struct�calcsize� r? r? �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/easy_install.py�is_64bit^ � rA c C s | � d�S )N�utf8)�encode��sr? r? r@ � _to_bytesb s rG c C s& z| � d� W dS ty Y dS w )N�asciiFT)rD � UnicodeErrorrE r? r? r@ �isasciif s ��rJ c C s t �| ��� �dd�S )N� z; )�textwrap�dedent�strip�replace)�textr? r? r@ � _one_linern s rQ c @ s� e Zd ZdZdZdZdddddd d d d d ddddddddddddddej� d �fgZg d �Z d d iZ e Z d d!� Z d�d$d%�Zd&d'� Zed(d)� �Zd�d*d+�Zed,d-� �Zed.d/� �Zd0d1� Zd2d3� Zd�d4d5�Zd�d6d7�Zd�d�d:d;�Zd<d=� Zd�d>d?�Zd�d@dA�Z e � dB�� � Z e � dC�� � Z!e � dD�� � Z"d�dFdG�Z#dHdI� Z$d�dJdK�Z%d�dLdM�Z&d�dNdO�Z'd�dPdQ�Z(e)j*dRdS� �Z+d�d�dWdX�Z, Td�d�dZd[�Z-d\d]� Z. d�d�d^d_�Z/d�d`da�Z0dbdc� Z1d�ddde�Z2d�d�dfdg�Z3edhdi� �Z4d�d�dndo�Z5d�dqdr�Z6dsdt� Z7dudv� Z8dwdx� Z9d�dydz�Z:d{d|� Z;e � d}�� � Z<e � d~�Z=d�d�d�d��Z>e � d��� � Z?d�d�� Z@d�d�d��ZAd�d�� ZBd�d�� ZCd�d�d��ZDd�d�� ZEd�d�d��ZFd�d�d��ZGe � d���H� ZId�d�d��ZJeKeKd�d�d��d��ZLeKd�d�d��ZMd�d�� ZNdS )�r7 z'Manage a download/build/install processz Find/get/install Python packagesT)zprefix=Nzinstallation prefix)�zip-ok�zz install package as a zipfile)� multi-version�mz%make apps have to require() a version)�upgrade�Uz1force upgrade (searches PyPI for latest versions))z install-dir=�dzinstall package to DIR)z script-dir=rF zinstall scripts to DIR)�exclude-scripts�xzDon't install scripts)� always-copy�az'Copy all needed packages to install dir)z index-url=�iz base URL of Python Package Index)z find-links=�fz(additional URL(s) to search for packages)zbuild-directory=�bz/download/extract/build in DIR; keep the results)z optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])zrecord=Nz3filename in which to record list of installed files)� always-unzip�Zz*don't install as a zipfile, no matter what)z site-dirs=�Sz)list of directories where .pth files work)�editable�ez+Install specified packages in editable form)�no-deps�Nzdon't install dependencies)z allow-hosts=�Hz$pattern(s) that hostnames must match)�local-snapshots-ok�lz(allow building eggs from local checkouts)�versionNz"print version information and exit)z no-find-linksNz9Don't load find-links defined in packages being installed�userNz install in user site-package '�') rR rT rY rV r[ rd rf ri rk rl ra rR c C s t �� d| _d | _| _d | _ | _| _d | _d | _ d | _ d | _ d | _ | _ d | _ | _| _d | _ | _| _d | _ | _| _d | _d | _d | _d | _d | _d | _ d | _ d | _ d | _ t j!| _"t j#| _$d | _%d | _&d | _'| _(d | _)i | _*d | _+| j,j-| _-| j,�.| | j,�/d�� d S )NFr7 )0� EasyInstallDeprecationWarning�emitrl �zip_ok�local_snapshots_ok� install_dir� script_dir�exclude_scripts� index_url� find_links�build_directory�args�optimize�recordrV � always_copy� multi_versionrd �no_deps� allow_hosts�root�prefix� no_reportrk �install_purelib�install_platlib�install_headers� install_lib�install_scripts� install_data� install_base�install_platbase�site� USER_BASE�install_userbase� USER_SITE�install_usersite� no_find_links� package_index�pth_file�always_copy_from� site_dirs�installed_projects�_dry_run� distribution�verbose�_set_command_options�get_option_dict��selfr? r? r@ �initialize_options� sB �z easy_install.initialize_options�return�Nonec C s" dd� |D �}t t| j|�� d S )Nc s s, � | ]}t j�|�st j�|�r|V qd S �N)�os�path�exists�islink)�.0�filenamer? r? r@ � <genexpr>� s � � � �z/easy_install.delete_blockers.<locals>.<genexpr>)�list�map� _delete_path)r� �blockers�extant_blockersr? r? r@ �delete_blockers� s �z easy_install.delete_blockersc C sJ t �d|� | jr d S tj�|�otj�|� }|r tntj}||� d S )Nz Deleting %s) r* �info�dry_runr� r� �isdirr� �_rmtree�unlink)r� r� �is_tree�removerr? r? r@ r� � s zeasy_install._delete_pathc C sB t jj� dt jj� �} td�}td|j� d|j� d| � d�� t�)zT Render the Setuptools version and installation details, then exit. �.� setuptoolsz setuptools z from z (Python �)) �sys� version_info�major�minorr �printrk �location� SystemExit)�ver�distr? r? r@ �_render_version� s z easy_install._render_versionc C sH | j o| �� tj �� d }tt�� �| _| j�| j � � | j � � | j � � |tj j� dtj j� �tj j� tj j� �| jd | jd ttdd�ttdd�d � � t�t�� | j�t�� �� t�� d �� W d � n1 smw Y | j�d ttd d��dd�� | j| jd < | j| jd< | jr�t j s�t � d� | � � | �!� | �"� | �#dddd� | j$d u r�| j%| _$| j&d u r�d| _&| �'dd� | �'dd� | jr�| j(r�| j(| _%| j)| _$| �'dd� t*� | _+| j+�,| �-| j.�� | j/s�| �0� t1�2dd �}| j3p�|| _3| j+d d � | _4| j%t5| j$�fD ]}|| j4v�r | j4�6d|� �q| j7d u�r1d d � | j7�d �D �}nd g}| j8d u �rE| j9| j3| j4|d!�| _8t:| j4tj; �| _<| j=d u�rbt>| j=t?��ra| j=�� | _=ng | _=| j@�rs| j8�A| j4tj; � | j&�s~| j8�B| j=� | �'dd"� | �C| jD�| _D| j/�r�| jE�s�tFd#��| jG�s�tFd$��g | _Hd S )%Nr r� r� � exec_prefix�abiflags� � platlibdir�lib) � dist_name� dist_version� dist_fullname� py_version�py_version_short�py_version_nodot� sys_prefix�sys_exec_prefixr� r� )�implementation_lower�implementation�py_version_nodot_plat�windir�userbase�usersitez6WARNING: The user site-packages directory is disabled.rr rs rw r� Fr� )rr rr r� �rr rs r+ )rz rz �__EASYINSTALL_INDEXzhttps://pypi.org/simple/c S s g | ]}|� � �qS r? )rN �r� rF r? r? r@ � <listcomp>E � z1easy_install.finalize_options.<locals>.<listcomp>�,�*)� search_path�hosts)ry ry z9Must specify a build directory (-b) when using --editablez:No urls, filenames, or requirements specified (see --help))Irk r� r� �split�dict� sysconfig�get_config_vars� config_vars�updater� �get_name� get_version� get_fullnamer� r� r� �getattr� contextlib�suppress�AttributeErrorr+ �_get_implementation�lower� setdefaultrO r� r� rl r� �ENABLE_USER_SITEr* �warn� _fix_install_dir_for_user_site�expand_basedirs� expand_dirs�_expandrs rr r� �set_undefined_optionsr� r� � get_site_dirs� all_site_dirs�extend�_process_site_dirsr� rd �check_site_dirr� �getenvru � shadow_pathr �insertr~ r� � create_indexr r� � local_indexrv � isinstance�strrq �scan_egg_links�add_find_links�_validate_optimizery rw r- rx �outputs)r� r� � default_index� path_itemr� r? r? r@ �finalize_options� s� � � � �� � � � � �� z easy_install.finalize_optionsc c sx � | d u rd S t ttj�}dd� | �d�D �} | D ] }tj�|�s(t�d|� qt|�|vr4t |d ��t|�V qd S )Nc S s g | ] }t j�|�� ��qS r? )r� r� � expanduserrN r� r? r? r@ r� m � z3easy_install._process_site_dirs.<locals>.<listcomp>r� z"%s (in --site-dirs) does not existz$ (in --site-dirs) is not on sys.path) r� r r� r� r� r� r� r* r� r/ )r� �normpathrX r? r? r@ r� g s � �z easy_install._process_site_dirsc C sB zt | �} | td�vr t�W | S ty } ztd�|�d }~ww )N� z --optimize must be 0, 1, or 2)�int�range� ValueErrorr/ )�valuere r? r? r@ r v s �� ��z easy_install._validate_optimizec C sP | j sdS | �� | jdu rd}t|��| j | _| _tj� d�}| �|� dS )z; Fix the install_dir if "--user" was used. Nz$User base directory is not specified�_user) rl �create_home_pathr� r0 r� r� r� �name� select_scheme)r� �msg� scheme_namer? r? r@ r� � s z+easy_install._fix_install_dir_for_user_sitec C sX |D ]'}t | |�}|d ur)tjdkstjdkr tj�|�}t|| j�}t| ||� qd S )N�posix�nt)r� r� r r� r r3 r� �setattr)r� �attrs�attr�valr? r? r@ � _expand_attrs� s ��zeasy_install._expand_attrsc C s | � g d�� dS )zNCalls `os.path.expanduser` on install_base, install_platbase and root.)r� r� r N�r r� r? r? r@ r� � s z easy_install.expand_basedirsc C s g d�}| � |� dS )z+Calls `os.path.expanduser` on install dirs.)r� r� r� r� r� r� Nr )r� �dirsr? r? r@ r� � s zeasy_install.expand_dirs�show_deprecation�boolc C s� |r | � dtj� | j| jjkrt�| j� zS| jD ] }| �|| j � q| j r\| j }| j rFt | j �}t t |��D ] }|| |d � ||< q9ddlm} | �|j| j |fd| j � d�� | �� W t�| jj� d S t�| jj� w )NzXWARNING: The easy_install command is deprecated and will be removed in a future version.r )� file_utilz$writing list of installed files to 'rm )�announcer* �WARNr� r� � set_verbosityrx r7 r} rz r r �lenr � distutilsr �execute� write_file�warn_deprecated_options)r� r �specr �root_len�counterr r? r? r@ �run� s0 � � "zeasy_install.runc C sD zt �� }W n ty t�dtj�}Y nw t j�| j d|� ��S )z�Return a pseudo-tempname base in the install directory. This code is intentionally naive; if a malicious party can write to the target directory you're already in deep doodoo. r ztest-easy-install-) r� �getpid� Exception�random�randintr� �maxsizer� �joinrr )r� �pidr? r? r@ �pseudo_tempname� s �z easy_install.pseudo_tempnamec C s d S r� r? r� r? r? r@ r( � s z$easy_install.warn_deprecated_optionsc C s: t | j�}tj�|d�}tj�|�s'zt�|� W n ty& | �� Y nw || j v }|s6| j s6| � � }n/| � � d }tj�|�}z|rJt� |� t|d��� t� |� W n tyd | �� Y nw |sz| j sztj�dd�}t�| j| j|� |r�| jdu r�t|| j �| _nd| _| j r�tj�|�s�d| _|| _dS )z;Verify that self.install_dir is .pth-capable dir, if needed�easy-install.pthz .write-test�wb� PYTHONPATHr� N)r rr r� r� r2 r� �makedirs�OSError�cant_write_to_targetr� r| �check_pth_processingr4 r� �open�close�environ�getr* r� � _easy_install__no_default_msgr� r8 )r� �instdirr� � is_site_dir�testfile� test_exists� pythonpathr? r? r@ r� � s@ � � � zeasy_install.check_site_diraS can't create or remove files in install directory The following error occurred while trying to add or remove files in the installation directory: %s The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s z� This directory does not currently exist. Please create it and try again, or choose a different installation directory (using the -d or --install-dir option). a� Perhaps your account does not have write access to this directory? If the installation directory is a system-owned directory, you may need to sign in as the administrator or "root" account. If you do not have administrative access to this machine, you may wish to choose a different installation directory, preferably one that is listed in your PYTHONPATH environment variable. For information on other options, you may wish to consult the documentation at: https://setuptools.pypa.io/en/latest/deprecated/easy_install.html Please make the appropriate changes for your system and try again. r c C sR | j t�� d | jf }tj�| j�s |d| j 7 }t |��|d| j 7 }t |��)N� rK ) � _easy_install__cant_write_msgr� �exc_inforr r� r� r� � _easy_install__not_exists_id�_easy_install__access_msgr. )r� r r? r? r@ r: , s ��z!easy_install.cant_write_to_targetc C s | j }t�d|� | �� d }|d }tj�|�}td�d }z |r't�|� tj� |�}tj |dd� t |dt j d �}W n tyJ | �� Y n�w z�|�|jdi t� ��� |�� d }tj}tjd kr�tj�|�\}} tj�|d �} | �� d ko�tj�| �} | r�| }ddlm} | |dddgd� tj�|�r�t�d|� W |r�|�� tj�|�r�t�|� tj�|�r�t�|� dS dS W |r�|�� tj�|�r�t�|� tj�|�r�t�|� n |r�|�� tj�|�r�t�|� tj�|�r�t�|� w w | j �st� d|� dS )z@Empirically verify whether .pth files are supported in inst. dirz Checking .pth file support in %s�.pthz.okz� import os f = open({ok_file!r}, 'w', encoding="utf-8") f.write('OK') f.close() rK T)�exist_ok�w��encodingNr � pythonw.exe� python.exer )�spawnz-Ez-c�passz-TEST PASSED: %s appears to support .pth filesz+TEST FAILED: %s does NOT support .pth filesFr? ) rr r* r� r4 r� r� r� rQ r� �dirnamer8 r< r( � PTH_ENCODINGr9 r: �write�format�localsr= r� � executabler r� r2 r� �distutils.spawnrR r| r� ) r� rA r� �ok_file� ok_exists�tmplrT r^ rY �basename�alt�use_altrR r? r? r@ r; 8 sz ��� � �� �� � z!easy_install.check_pth_processingc C sV | j s$|�d�r$|�d�D ]}|�d| �rq | �|||�d| �� q | �|� dS )z=Write all the scripts for `dist`, unless scripts are excluded�scriptszscripts/N)rt �metadata_isdir�metadata_listdir�install_script� get_metadata�install_wrapper_scripts)r� r� � script_namer? r? r@ �install_egg_scriptst s �z easy_install.install_egg_scriptsc C sV t j�|�r#t �|�D ]\}}}|D ] }| j�t j�||�� qq d S | j�|� d S r� )r� r� r� �walkr �appendr2 )r� r� �baser �filesr� r? r? r@ � add_output� s ��zeasy_install.add_outputc C s | j r td|�d���d S )NzInvalid argument zW: you can't use filenames or URLs with --editable (except via the --find-links option).)rd r- �r� r) r? r? r@ � not_editable� s ��zeasy_install.not_editablec C s@ | j sd S tj�tj�| j|j��r t|j�d| j� d���d S )Nz already exists in z; can't do a checkout there)rd r� r� r� r2 rw �keyr- rn r? r? r@ �check_editable� s ��zeasy_install.check_editablec c sT � t jdd�}zt|�V W tj�|�ot|� d S d S tj�|�o(t|� w w )Nz easy_install-)r� )�tempfile�mkdtempr� r� r� r� r� )r� �tmpdirr? r? r@ �_tmpdir� s � 8zeasy_install._tmpdirF�deps�Distribution | Nonec C sD | � � ��}t|t�sIt|�r*| �|� | j�||�}| �d |||d�W d � S tj � |�rE| �|� | �d |||d�W d � S t |�}| � |� | j� ||| j| j| j | j�}|d u rrd|��}| jrn|d7 }t|��|jtkr�| �|||d� |W d � S | �||j||�W d � S 1 s�w Y d S )NTz)Could not find suitable distribution for z2 (--always-copy skips system and development eggs)�Using)ru r� r r ro r� �download� install_itemr� r� r� r rq �fetch_distributionrV rd r{ r� r. � precedencer �process_distributionr� )r� r) rv rt �dlr� r r? r? r@ r7 � s@ � � � �"$�zeasy_install.easy_install�install_neededc C s |pt | j�}|ptj�|�|k}|p|�d� }|p,| jd uo,tj�t|��t| j�k}|rC|sC| j|j D ] }|j |kr@ nq7d}t � dtj� |�� |rc| �|||�}|D ] }| �|||� qXn| �|�g}| �||d |d� |d ur�|D ] }||v r�| S qyd S )N�.eggTz Processing %sr rx )r r{ r� r� rT �endswithr� r r� � project_namer� r* r� r^ � install_eggsr} �egg_distribution)r� r) ry rt rv r r� �distsr? r? r@ rz � s: �� �� �zeasy_install.install_itemc C s> z t �| |� W d S ty t j �| |�dd�� Y d S w )Nr �unix)r+ �_select_schemer� r rO )r� r r? r? r@ r � s �zeasy_install.select_schemec G s� | � |� | j�|� || j|j v r| j�|� | j�|� | �|� || j|j< t� | j ||g|�R � � |� d�rH| j sH| j� |�d�� |sO| jsOd S |d ura|j|jkrat�d|� d S |d u si||vrs|�� }tt|��}t� d|� ztg ��|g| j| j�}W n% ty� } ztt|��|�d }~w ty� } zt|�� �|�d }~ww | js�| jr�|D ]}|j| jvr�| �|�� � q�t� d|� d S )Nzdependency_links.txtz Skipping dependencies for %sz Processing dependencies for %sz'Finished processing dependencies for %s) � update_pthr� �addr� rp �removerh r� r* r� �installation_report� has_metadatar� r �get_metadata_linesr{ r� �as_requirementr r� r �resolver7 r r. r �reportr� )r� � requirementr� rv r� �distreq�distrosre r? r? r@ r} � sL � ���� �z!easy_install.process_distributionc C s2 | j d ur | j S |�d�rdS |�d�sdS dS )Nz not-zip-safeTzzip-safeF)rp r� �r� r� r? r? r@ � should_unzip! s zeasy_install.should_unzipc C s� t j�| j|j�}t j�|�r d}t�||j| j|� |S t j�|�r&|}n)t j� |�|kr3t � |� t � |�}t |�dkrOt j�||d �}t j�|�rO|}t |� t�||� |S )Nz<%r already exists in %s; build directory %s will not be keptrF r )r� r� r2 rw rp r� r* r� r� rT r� �listdirr$ r$ �shutil�move)r� r) � dist_filename� setup_base�dstr �contentsr? r? r@ � maybe_move* s" zeasy_install.maybe_movec C s, | j rd S t�� �|�D ]}| j|� q d S r� )rt � ScriptWriter�best�get_args� write_script)r� r� rx r? r? r@ rf ? s �z$easy_install.install_wrapper_scriptsc C sN t |�� �}t||�}|r | �|�t� }t�|�| }| �|t|�d� dS )z/Generate a legacy script wrapper and install itr_ N) r� r� �is_python_script�_load_templaterX r� � get_headerr� rG )r� r� rg � script_text�dev_pathr) � is_script�bodyr? r? r@ rd E s zeasy_install.install_scriptc C s( d}| r |� dd�}td|�}|�d�S )z� There are a couple of template scripts in the package. This function loads one of them and prepares it for use. z script.tmplz.tmplz (dev).tmplr� �utf-8)rO r �decode)r� r � raw_bytesr? r? r@ r� O s zeasy_install._load_template�tr? �moder� c s� � � � fdd�|D �� t�d|� j� tj�� j|�}� �|� � jr&dS t � }t |� tj� |�r8t� |� d|v r>dnd}t |d| |d�� }|�|� W d � n1 sYw Y t|d | � dS ) z1Write an executable file to the scripts directoryc s g | ] }t j�� j|��qS r? )r� r� r2 rs �r� rZ r� r? r@ r� a r z-easy_install.write_script.<locals>.<listcomp>zInstalling %s script to %sNr_ r� rM rN i� )r� r* r� rs r� r� r2 rm r� � current_umaskr$ r� r� r< rV �chmod) r� rg r� r� r� �target�maskrO r^ r? r� r@ r� ^ s" � �zeasy_install.write_script�list[Distribution]c C sL | j | j| jd�}z ||�� dd � }W n ty Y nw |||�gS |}tj�|�r:|�d�s:t ||| j � n tj� |�rFtj� |�}|� |�rY| jrY|d urY| �|||�}tj�|d�}tj�|�s�ttj�|dd��}|s}tdtj� |�� ���t|�dkr�tdtj� |�� ���|d }| jr�t�| �||�� g S | �||�S ) N)r� �.exez.whl����.pyzsetup.pyr� z Couldn't find a setup script in rF zMultiple setup scripts in r )� install_egg� install_exe� install_wheelr� �KeyErrorr� r� �isfiler� r �unpack_progressr� �abspath� startswithrw r� r2 r� r r. r$ rd r* r� �report_editable�build_and_install) r� r) r� rt � installer_map� install_distr� � setup_script�setupsr? r? r@ r� t sJ � � �� � � zeasy_install.install_eggsc C s> t j�|�rt|t j�|d��}ntt�|��}tj ||d�S )N�EGG-INFO)�metadata) r� r� r� r r2 r � zipimport� zipimporterr � from_filename)r� �egg_pathr� r? r? r@ r� � s z easy_install.egg_distributionc C s� t j�| jt j�|��}t j�|�}| jst|� | �|�}t j� |�r+t j� ||�s�t j� |�r@t j� |�s@t j|| jd� nt j� |�rQ| �t j|fd| � z_d}t j� |�rm|�|�rftjd}}n,tjd}}n%| �|�r~| �|� | jd}}nd}|�|�r�tjd}}ntjd}}| �|||f|d t j�|�t j�|�f � t||d � W n ty� t|dd � � w | � |� | �|�S ) N�r� � Removing F�Moving�Copying� ExtractingTz %s to %s��fix_zipimporter_caches) r� r� r2 rr r^ r� r� r$ r� r� �samefiler� r� r) � remove_treer& r� r� r� r� �copytreer� �mkpath�unpack_and_compile�copy2rT �update_dist_cachesr. rm )r� r� rt � destinationr� �new_dist_is_zippedr^ rU r? r? r@ r� � sd � � � � �� � � zeasy_install.install_eggc st t |�}|d u rt|� d���td |�dd�|�dd�t� d�}tj�||�� d �}||_ |d }tj�|d�}tj�|d �}t |� t ||�|_ | � ||� tj�|�s�t|d d d ��.} | �d � |�d�D ]\} } | dkr�| �dd��� } | �| � d| � d�� qhW d � n1 s�w Y tj�|d�� | �� fdd�t�|�D �� tj||| j| jd� | �||�S )Nz& is not a valid distutils Windows .exer� r rk )r� rk �platformr� z.tmpr� �PKG-INFOrM r� rN zMetadata-Version: 1.0 �target_version�_�-z: rK ra c s g | ] }t j�� |d ��qS )r )r� r� r2 )r� rx �rs r? r@ r� s �z,easy_install.install_exe.<locals>.<listcomp>)r� r� ) r9 r. r r? r2 r� r� r2 �egg_namer� r$ r � _provider� exe_to_eggr� r< rV �itemsrO �titler� r� r� r � make_zipfiler� r� r� ) r� r� rt �cfgr� r� �egg_tmp� _egg_info�pkg_infr^ �k�vr? r� r@ r� � sP � � �� ��� zeasy_install.install_exec sV t |��g �g �t� �� ����fdd�}t|� |� g }�D ]7}|�� �d�rV|�d�}|d }t�|d �d |d< tj j � g|�R � }�� |� |� |� t� ||� q | � �� t�tj � � d�t�� |�� dD ];} t� | r�tj � � d| d �} tj �| �s�t| d d d ��} | �d � t� | �d � W d � n1 s�w Y qmdS )z;Extract a bdist_wininst to the directories an egg would usec s | � � }�D ]p\}}|�|�rv|| t|�d � } | �d�}tjj� g|�R � }|� � }|�d�s6|�d�rVt� |d �|d< �� tj� |d �d g� �� | � | S |�d�rr|dkrr�� tj� |d �d g� �� |� | S q| �d�s�t �d | � d S ) N�/�.pyd�.dll���r r� �SCRIPTS/rK zWARNING: can't process %s)r� r� r$ r� r� r� r2 r� r � strip_moduler� �splitextrj r* r� )�srcr� rF �old�new�partsr~ �r� � native_libs�prefixes� to_compile� top_levelr? r@ �process s( � � z(easy_install.exe_to_egg.<locals>.processr� r� r� r� r� )r� r� z.txtrM r� rN rK N)r: �setr r� r� r� r r� r� r� r2 rj � write_stub� byte_compile�write_safety_flag� analyze_eggrX r� r< rV ) r� r� r� r� �stubs�resr� �resource�pyfiler �txtr^ r? r� r@ r� s< � � ���zeasy_install.exe_to_eggc C s� t |�}|�� s J �tj�| j|�� �}tj�|�}| js!t |� tj� |�r6tj� |�s6t j || jd� ntj�|�rG| �tj|fd| � z | �|j|fdtj�|�� dtj�|�� �� W t|dd� nt|dd� w | �|� | �|�S )Nr� r� z Installing z to Fr� )r" � is_compatibler� r� r2 rr r� r� r� r$ r� r� r) r� r� r& r� �install_as_eggr^ rT r� rm r� )r� � wheel_pathrt �wheelr� r? r? r@ r� I s. � � zeasy_install.install_wheela( Because this distribution was installed --multi-version, before you can import modules from this package in an application, you will need to 'import pkg_resources' and then use a 'require()' call similar to one of these examples, in order to select the desired version: pkg_resources.require("%(name)s") # latest installed version pkg_resources.require("%(name)s==%(version)s") # this exact version pkg_resources.require("%(name)s>=%(version)s") # this version or higher z� Note also that the installation directory must be on sys.path at runtime for this to work. (e.g. by being the application's script directory, by being on PYTHONPATH, or by being added to sys.path by your code.) � Installed�whatc C s^ d}| j r | js |d| j 7 }| jtttj�vr |d| j 7 }|j }|j }|j }d}|t � S )z9Helpful installation message for display to package usersz %(what)s %(eggloc)s%(extras)srK r� ) r| r� �_easy_install__mv_warningrr r� r r� r� �_easy_install__id_warningr� r� rk rX ) r� �reqr� r r �egglocr rk �extrasr? r? r@ r� z s z easy_install.installation_reportaR Extracted editable version of %(spec)s to %(dirname)s If it uses setuptools in its setup script, you can activate it in "development" mode by going to that directory and running:: %(python)s setup.py develop See the setuptools documentation for the "develop" command for more info. c C s" t j�|�}tj}d| jt� S )NrK )r� r� rT r� rY �_easy_install__editable_msgrX )r� r) r� rT �pythonr? r? r@ r� � s z easy_install.report_editablec C s� t j�dt� t j�dt� t|�}| jdkr'd| jd }|�dd| � n | jdk r2|�dd� | jr;|�dd � t � d |t |�d d � d � |�� zt ||� W d S tyl } z td |jd � ��|�d }~ww ) Nzdistutils.command.bdist_eggzdistutils.command.egg_infor# r� rF r r� z-qz-nz Running %s %s� zSetup script exited with )r� �modulesr� r r r� r� r� r� r* r� r$ r2 r r� r. rx )r� r� r� rx r� r? r? r@ r � s" $��zeasy_install.run_setupc s� ddg}t jdtj�|�d�}z=��tj�|�� |�|� ��|�|� t|g�� � ��fdd�� D �}|s@�j s@t � d|� |W t |� t � �j� S t |� t � �j� w )Nr z --dist-dirz egg-dist-tmp-)r� �dirc s( g | ]}� | D ] }�� |j���qqS r? )r� r� )r� rp r� ��all_eggsr� r� r? r@ r� � s � ��z2easy_install.build_and_install.<locals>.<listcomp>z+No eggs found in %s (setup script problem?))rr rs r� r� rT �_set_fetcher_optionsrj r r r� r* r� r� r# r� )r� r� r� rx �dist_dir�eggsr? r r@ r� � s& � � �z easy_install.build_and_installc C sh | j �d��� }d}i }|�� D ]\}}||vrq|d ||< qt|d�}tj�|d�}t� ||� dS )a When easy_install is about to run bdist_egg on a source dist, that source dist might have 'setup_requires' directives, requiring additional fetching. Ensure the fetcher options given to easy_install are available to that command as well. r7 )rv r� ru ry r~ rF )r7 z setup.cfgN) r� r� �copyr� r� r� r� r2 r � edit_config) r� rk �ei_opts�fetch_directives� fetch_optionsrp r �settings� cfg_filenamer? r? r@ r � s z!easy_install._set_fetcher_optionsc C sP | j d u rd S | j |j D ]%}| js|j|jkrq t�d|� | j �|� |j| jv r2| j�|j� q | js]|j| j jv rDt�d|� nt�d|� | j � |� |j| jvr]| j� |j� | j rbd S | j � � |jdkrnd S t j�| jd�}t j�|�r�t �|� t|dtjd��}|�| j �|j�d � W d � d S 1 s�w Y d S ) Nz&Removing %s from easy-install.pth filez4%s is already the active version in easy-install.pthz"Adding %s to easy-install.pth filer� �setuptools.pth�wtrN rK )r� rp r| r� r* r� r� r� �pathsr� rj r� �saver� r� r2 rr r� r� r< r( rU rV � make_relative)r� r� rX r� r^ r? r? r@ r� � s> �� "�zeasy_install.update_pthc C s t �d||� |S )NzUnpacking %s to %s)r* �debug)r� r� r� r? r? r@ r� s z easy_install.unpack_progressc sh g �g �� ��fdd�}t |||� � ��� � js0�D ]}t�|�tj dB d@ }t||� q d S d S )Nc sZ |� d�r| �d�s��|� n|� d�s|� d�r ��|� � �| |� � j r+|p,d S )Nr� � EGG-INFO/r� z.so)r� r� rj r� r� )r� r� �r� �to_chmodr� r? r@ �pf s z+easy_install.unpack_and_compile.<locals>.pfim i� )r r r� r� �stat�ST_MODEr� )r� r� r� r- r^ r� r? r+ r@ r� s �z easy_install.unpack_and_compilec C s� t jrd S ddlm} z0t�| jd � ||dd| jd� | jr3||| jd| jd� W t�| j� d S W t�| j� d S t�| j� w )Nr )r rF T)ry �forcer� ) r� �dont_write_bytecode�distutils.utilr r* r# r� r� ry )r� r� r r? r? r@ r # s �� zeasy_install.byte_compilea� bad install directory or PYTHONPATH You are attempting to install a package to a directory that is not on PYTHONPATH and which Python does not read ".pth" files from. The installation directory you specified (via --install-dir, --prefix, or the distutils default setting) was: %s and your PYTHONPATH environment variable currently contains: %r Here are some of your options for correcting the problem: * You can choose a different installation directory, i.e., one that is on PYTHONPATH or supports .pth files * You can add the installation directory to the PYTHONPATH environment variable. (It must then also be on PYTHONPATH whenever you run Python and want to use the package(s) you are installing.) * You can set up the installation directory to support ".pth" files by using one of the approaches described here: https://setuptools.pypa.io/en/latest/deprecated/easy_install.html#custom-installation-locations Please make the appropriate changes for your system and try again. c C sf | j sdS ttj�d��}t| j�� �D ] }|�|�r0tj� |�s0| � d|� d�� t� |d� qdS )zCreate directories under ~.N�~z os.makedirs('z ', 0o700)i� ) rl r1 r� r� r � only_strsr� �valuesr� r� � debug_printr8 )r� �homer� r? r? r@ r Z s ��z easy_install.create_home_pathz/$base/lib/python$py_version_short/site-packagesz $base/binr� �r z$base/Lib/site-packagesz $base/Scriptsc G s� | � d�j}| jr2t|�}| j|d< | j�tj| j�}|� � D ]\}}t | |d �d u r1t | ||� q ddl m } |D ]!}t | |�}|d ur[|||�}tjdkrUtj�|�}t | ||� q:d S )Nr+ rk r )r3 r )�get_finalized_commandr� r� r� �INSTALL_SCHEMESr? r� r �DEFAULT_SCHEMEr� r� r r2 r3 r� r )r� r r� �schemer r r3 r? r? r@ r� p s& � ��zeasy_install._expand�r� r� )T)r r r� r� )r� r )F)rv r r� rw )r r r� rw )rv r r� r� )r� r r� )r� r? )r� r� r� r� )r� r� )r )r r� r� r� )O�__name__� __module__� __qualname__�__doc__� description�command_consumes_argumentsr� r� � user_options�boolean_options� negative_optr r� r� r� r� � staticmethodr� r r� r r� r r� r� r, r4 r( r� rL rM �lstriprG rI rJ r: r; rh rm ro rq r� �contextmanagerru r7 rz r r} r� r� rf rd r� r� r� r� r� r� r� r� r r r� r r� r r� r r� r� r� r rN r@ r r� r: r; r� r? r? r? r@ r7 r s �! - v -������ < & �& � , 26 14 � � � � � , � � " ��� r7 c C s t j�dd��t j�} td | �S )Nr7 r� )r� r> r? r� �pathsep�filter)r� r? r? r@ � _pythonpath� s rL c s� g � � � t� � tjg} tjtjkr| �tj� | D ]s}|s qtjdv r0� �tj� |dd�� n1tj dkrT� � tj� |ddtj j � dtj j � �d�tj� |dd�g� n � � |tj� |dd�g� tjd krgqd |vrlqtj�d �}|suqtj� |d d tj j � dtj j � �d�}� �|� qtd�td�f}� � � fdd�|D �� tjr�� �tj� t�t�� � � t�� � W d � n1 s�w Y ttt� ��S )z& Return a list of 'site' dirs )�os2emx�riscos�Libz site-packagesr� r� r r� z site-python�darwinzPython.framework�HOME�Library�Python�purelib�platlibc 3 s � | ] }|� vr|V qd S r� r? r� ��sitedirsr? r@ r� � s � z get_site_dirs.<locals>.<genexpr>N)r� rL r� r� r� rj r� r� r� r2 �sepr� r� r� r> r? r r� r� r� r� r� r� �getsitepackagesr� r� r )r� r� r7 �home_sp� lib_pathsr? rV r@ r� � s^ �� � � �r� c c s� � t � }| D ]j}t|�}||v rq|�|� tj�|�s qt�|�}||fV |D ]F}|�d�s1q)|dv r6q)ttj� ||��}t t |��}|D ]'}|� d�rOqGt|� � �}||v rZqG|�|� tj�|�sfqG|t�|�fV qGq)qdS )zBYield sys.path directories that might contain "old-style" packagesrK )r5 r$ �importN)r� r r� r� r� r� r� r� � _read_pthr2 r� r r� �rstrip)�inputs�seenrT rl r �content�lines�liner? r? r@ � expand_paths� s> � ���rd c C sT t | d�}z�t�|�}|du rW |�� dS |d |d |d }|dk r-W |�� dS |�|d � t�d|�d��\}}}|dvrKW |�� dS |�|d| � d d d �}t� |�}z |�|�} | � d d �d } | � t � � �} |�t�| �� W n tjy� Y W |�� dS w |�d�r�|�d�s�W |�� dS |W |�� S |�� w )znExtract configuration data from a bdist_wininst .exe Returns a configparser.RawConfigParser, or None �rbN� � � � z<iii)izV4i{V4r� )rk r� � rF r r� �Setup)r< �zipfile� _EndRecDatar= �seekr= �unpack�read� configparser�RawConfigParserr� r� r� �getfilesystemencoding� read_file�io�StringIO�Error� has_section) r� r^ �endrec� prepended�tag�cfglen�_bmlen�initr� �part�configr? r? r@ r9 � s@ � � � � �r9 c C s: g d�}t �| �}z}|�� D ]r}|j}|�d�}t|�dkr<|d dkr<|d �d�r<|�dd�|d d� �d f� nEt|�dksG|�d �sHq|�d �rNq|d � � d v r�|� |�� � }t |�D ] }|� � �dd�}|�d�s|�|d � d|� d�df� qaqW |�� n|�� w dd� |D �}|�� |�� |S )z4Get exe->egg path translations for a given .exe file))zPURELIB/r� )zPLATLIB/pywin32_system32r� )zPLATLIB/r� )r� zEGG-INFO/scripts/)zDATA/lib/site-packagesr� r� r r# r� rF z .egg-infor Nr* rK z -nspkg.pth)�PURELIB�PLATLIB�\r\ r� c S s g | ] \}}|� � |f�qS r? )r� )r� rZ �yr? r? r@ r� E r z$get_exe_prefixes.<locals>.<listcomp>)rl �ZipFile�infolistr� r� r$ r� r� r2 �upperrp r� r rN rO r� rj r= �sort�reverse)� exe_filenamer� rS r� r r� r� �pthr? r? r@ r: & s4 �r: c sn e Zd ZdZdd� fdd� Zdd� Zd d � Zdd d �Zed d� �Z d� fdd� Z d� fdd� Z dd� Z � Z S )r8 z)A .pth file with Distribution paths in itr? r� r� c s� || _ ttt|��| _ttj�| j ��| _| � � \| _ | _ | j d d � | _ t � �g d d � t| j �D ] }tt| jt|d��� q2d S )NT)r� r� r� r rW r� r� rT �basedir�_loadr& �dirty� _init_paths�super�__init__r r� r )r� r� rW r� �� __class__r? r@ r� N s �zPthDistributions.__init__c C s� g }d }}t | j�}t| j�}|�� D ]E}|�� }|�|� |�d�r'd}q|�� }|r2|�d�r3qt t j � | j |��} | |v sGt j �| �sTt�d|� d}|�� q|�| � q|rp|d �� sp|�� d}|rp|d �� rb||pv|ov|fS )NF)�import �from T�#z!cleaned up dirty or duplicated %rr� )r� rW r] r� � splitlinesr^ rj r� rN r r� r� r2 r� r� r* r) �popr� ) r� r& r� � saw_importr` ra rc r� � stripped_path�normalized_pathr? r? r@ � _load_rawY s2 �zPthDistributions._load_rawc C s t j�| j�r | �� S g dfS )NF)r� r� r� r� r� r� r? r? r@ r� w s zPthDistributions._loadc C s� | � � \}}|dd� D ]}|| jvr"| j�|� t�d|� d}q |�|� q | jdd� D ]'}||vrV|�d�sVtj� | j |�}tj� |�sV| j�|� t�d|� d}q/| j |pa| j| j kO _ | j sidS tt| j| j��}|r�t�d| j� | �|�}d� |�d }tj�| j�r�t�| j� t| jdtjd �� }|�|� W d � n1 s�w Y ntj� | j�r�t�d | j� t�| j� d | _ | jdd� | j dd�< dS ) z$Write changed .pth file back to diskNzdetected new path %rT)r� r� r� z!removing now non-existent path %rz Saving %srK r% rN zDeleting empty %sF)r� r& rj r* r� r� r� r� r� r2 r� r� r� r� r� r� r( r) r� � _wrap_linesr� r� r< r( rU rV ) r� � last_paths� last_dirtyr� � absolute_path� rel_pathsrb �datar^ r? r? r@ r' | sD � �� zPthDistributions.savec C � | S r� r? )rb r? r? r@ r� � s z PthDistributions._wrap_linesc sN |j | jvo|j | jvp|j t�� k}|r | j�|j � d| _t� �|� dS )z"Add `dist` to the distribution mapTN) r� r& rW r� �getcwdrj r� r� r� )r� r� �new_pathr� r? r@ r� � s �zPthDistributions.addc s< |j | jv r| j�|j � d| _|j | jv st� �|� dS )z'Remove `dist` from the distribution mapTN)r� r& r� r� r� r� r� r? r@ r� � s �zPthDistributions.removec C s� t j�t|��\}}t| j�}|g}t jdkrdpt j}t|�|krI|| jkr6|�t j � |� � |� |�S t j�|�\}}|�|� t|�|ks"|S )Nr� ) r� r� r� r r$ r� �altseprX rj �curdirr� r2 )r� r� �npath�last�baselenr� rX r? r? r@ r( � s �z PthDistributions.make_relative)r? r= )r> r? r@ rA r� r� r� r' rG r� r� r� r( � __classcell__r? r? r� r@ r8 K s 2 r8 c @ s( e Zd Zedd� �Zed�Zed�ZdS )�RewritePthDistributionsc c s � | j V |E d H | jV d S r� )�prelude�postlude)�clsrb r? r? r@ r� � s � z#RewritePthDistributions._wrap_linesz? import sys sys.__plen = len(sys.path) z� import sys new = sys.path[sys.__plen:] del sys.path[sys.__plen:] p = getattr(sys, '__egginsert', 0) sys.path[p:p] = new sys.__egginsert = p + len(new) N)r> r? r@ � classmethodr� rQ r� r� r? r? r? r@ r� � s ��r� � SETUPTOOLS_SYS_PATH_TECHNIQUE�raw�rewritec C s t tjt�rtS t�tj�� �S )z_ Return a regular expression based on first_line_re suitable for matching strings. )r� r, �patternr� �re�compiler� r? r? r? r@ �_first_line_re� s r� c C s0 t | �}t|tj� |rt|� dS t|� dS )aa Fix any globally cached `dist_path` related data `dist_path` should be a path of a newly installed egg distribution (zipped or unzipped). sys.path_importer_cache contains finder objects that have been cached when importing data from the original distribution. Any such finders need to be cleared since the replacement distribution might be packaged differently, e.g. a zipped egg distribution might get replaced with an unzipped egg folder or vice versa. Having the old finders cached may then cause Python to attempt loading modules from the replacement distribution using an incorrect loader. zipimport.zipimporter objects are Python loaders charged with importing data packaged inside zip archives. If stale loaders referencing the original distribution, are left behind, they can fail to load modules from the replacement distribution. E.g. if an old zipimport.zipimporter instance is used to load data from a new zipped egg archive, it may cause the operation to attempt to locate the requested data in the wrong location - one indicated by the original distribution's zip archive directory information. Such an operation may then fail outright, e.g. report having read a 'bad local file header', or even worse, it may fail silently & return invalid data. zipimport._zip_directory_cache contains cached zip archive directory information for all existing zipimport.zipimporter instances and all such instances connected to the same archive share the same cached directory information. If asked, and the underlying Python implementation allows it, we can fix all existing zipimport.zipimporter instances instead of having to track them down and remove them one by one, by updating their shared cached zip archive directory information. This, of course, assumes that the replacement distribution is packaged as a zipped egg. If not asked to fix existing zipimport.zipimporter instances, we still do our best to clear any remaining zipimport.zipimporter related cached data that might somehow later get used when attempting to load data from the new distribution and thus cause such load operations to fail. Note that when tracking down such remaining stale data, we can not catch every conceivable usage from here, and we clear only those that we know of and have found to cause problems if left alive. Any remaining caches should be updated by whomever is in charge of maintaining them, i.e. they should be ready to handle us replacing their zip archives with new distributions at runtime. N)r �_uncacher� �path_importer_cache�!_replace_zip_directory_cache_data�*_remove_and_clear_zip_directory_cache_data)� dist_pathr� r� r? r? r@ r� � s < r� c C sP g }t | �}|D ] }t|�}|�| �r%|||d � tjdfv r%|�|� q|S )ap Return zipimporter cache entry keys related to a given normalized path. Alternative path spellings (e.g. those using different character case or those using alternative path separators) related to the same path are included. Any sub-path entries are included as well, i.e. those corresponding to zip archives embedded in other zip archives. rF r� )r$ r r� r� rX rj )r� �cache�result� prefix_len�p�npr? r? r@ �"_collect_zipimporter_cache_entriesQ s � �r� c C s@ t | |�D ]}|| }||= |o|||�}|dur |||< qdS )a� Update zipimporter cache data for a given normalized path. Any sub-path entries are processed as well, i.e. those corresponding to zip archives embedded in other zip archives. Given updater is a callable taking a cache entry key and the original entry (after already removing the entry from the cache), and expected to update the entry and possibly return a new one to be inserted in its place. Returning None indicates that the entry should not be replaced with a new one. If no updater is given, the cache entries are simply removed without any additional processing, the same as if the updater simply returned None. N)r� )r� r� �updaterr� � old_entry� new_entryr? r? r@ �_update_zipimporter_cacheg s ��r� c C s t | |� d S r� )r� )r� r� r? r? r@ r� � rB r� c C � dd� }t | tj|d� d S )Nc S s |� � d S r� )�clear�r� r� r? r? r@ �2clear_and_remove_cached_zip_archive_directory_data� s zf_remove_and_clear_zip_directory_cache_data.<locals>.clear_and_remove_cached_zip_archive_directory_data�r� �r� r� �_zip_directory_cache)r� r� r? r? r@ r� � s �r� �__pypy__c C r� )Nc S s& |� � t�| � |�tj| � |S r� )r� r� r� r� r� r� r? r? r@ �)replace_cached_zip_archive_directory_data� s zT_replace_zip_directory_cache_data.<locals>.replace_cached_zip_archive_directory_datar� r� )r� r� r? r? r@ r� � s �r� �<string>c C s, z t | |d� W dS ttfy Y dS w )z%Is this string a valid Python script?�execFT)r� � SyntaxError� TypeError)rP r� r? r? r@ � is_python� s ��r� c C sb z%t | dd�� }|�d�}W d � n 1 sw Y W |dkS W |dkS ty0 | Y S w )zCDetermine if the specified executable is a .sh (contains a #! line)zlatin-1rN r# N�#!)r< rp r9 )rY �fp�magicr? r? r@ �is_sh� s �� ��r� c C s t �| g�S )z@Quote a command line argument according to Windows parsing rules�� subprocess� list2cmdline)�argr? r? r@ � nt_quote_arg� s r� c C sH |� d�s |� d�r dS t| |�rdS | �d�r"d| �� d �� v S dS )zHIs this text, as a whole, a Python script? (as opposed to shell/bat/etc.r� �.pywTr� r r F)r� r� r� r� r� )r� r� r? r? r@ r� � s r� c @ s e Zd ZU ded< ded< dS )� _SplitArgsr �commentsr N)r> r? r@ �__annotations__r? r? r? r@ r� � s r� F)�totalc @ s� e Zd ZU dZg Zded< e� Zedd� �Z edd� �Z ed d d ��Z edd� �Z ed!dd��Z d"dd�Zedd� �Zdd� Zedd � �Zed d � �Zd S )#� CommandSpeczm A command spec for a #! header, specified as a list of arguments akin to those passed to Popen. z list[str]�optionsc C r� )zV Choose the best CommandSpec class based on environmental conditions. r? �r� r? r? r@ r� � s zCommandSpec.bestc C s t j�tj�}t j�d|�S )N�__PYVENV_LAUNCHER__)r� r� r r� rY r> r? )r� �_defaultr? r? r@ �_sys_executable� s zCommandSpec._sys_executable�param�!Self | str | Iterable[str] | Noner� r4 c C sV t || �r|S t |t�r| �|�S t |t�r| |�S |du r"| �� S tdt|�� ���)zg Construct a CommandSpec from a parameter to build_scripts, which may be None. Nz!Argument has an unsupported type )r� r� � from_stringr �from_environmentr� �type)r� r� r? r? r@ � from_param� s zCommandSpec.from_paramc C s | | � � g�S r� )r� r� r? r? r@ r� s z CommandSpec.from_environment�stringr� c C s t j|fi | j��}| |�S )z} Construct a command spec from a simple string representing a command line parseable by shlex.split. )�shlexr� � split_args)r� r� r� r? r? r@ r� s zCommandSpec.from_stringr� c C s< t �| �|��| _t�| �}t|�s dg| jd d�< d S d S )Nz-xr )r� r� �_extract_optionsr� r� r� rJ )r� r� �cmdliner? r? r@ �install_options s �zCommandSpec.install_optionsc C s: | d � � d }t� �|�}|r|�d�pdnd}|�� S )zH Extract any options from the first line of the script. rK r rF r� )r� r� �match�grouprN )� orig_script�firstr� r� r? r? r@ r� s � z CommandSpec._extract_optionsc C s | � | t| j� �S r� )�_renderr� r� r� r? r? r@ � as_header$ s zCommandSpec.as_headerc C s6 d}|D ]}| � |�r| �|�r| dd� S q| S )Nz"'rF r� )r� r� )�item�_QUOTES�qr? r? r@ � _strip_quotes' s �zCommandSpec._strip_quotesc C s t �dd� | D ��}d| d S )Nc s s � | ] }t �|�� �V qd S r� )r� r� rN )r� r� r? r? r@ r� 1 s � �z&CommandSpec._render.<locals>.<genexpr>r� rK r� )r� r� r? r? r@ r� / s � zCommandSpec._renderN)r� r� r� r4 )r� r� r� r4 )r� r� )r> r? r@ rA r� r� r� r� r� r� r� r� r� r� r� rG r� r� r� r� r? r? r? r@ r� � s, r� c @ s e Zd Zedd�ZdS )�WindowsCommandSpecFr8 N)r> r? r@ r� r� r? r? r? r@ r� ; s r� c @ sh e Zd ZdZe�d��� ZeZ e ddd��Z e dd� �Z e dd � �Ze d d � �Ze dddd��ZdS )r� z` Encapsulates behavior around writing entry point scripts for console and gui apps. aJ # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r import re import sys # for compatibility with easy_install; see #2198 __requires__ = %(spec)r try: from importlib.metadata import distribution except ImportError: try: from importlib_metadata import distribution except ImportError: from pkg_resources import load_entry_point def importlib_load_entry_point(spec, group, name): dist_name, _, _ = spec.partition('==') matches = ( entry_point for entry_point in distribution(dist_name).entry_points if entry_point.group == group and entry_point.name == name ) return next(matches).load() globals().setdefault('load_entry_point', importlib_load_entry_point) if __name__ == '__main__': sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0]) sys.exit(load_entry_point(%(spec)r, %(group)r, %(name)r)()) Nc c sx � |du r | � � }t|�� �}dD ](}|d }|�|��� D ]}| �|� | jt� }| �||||�}|E dH q qdS )z� Yield write_script() argument tuples for a distribution's console_scripts and gui_scripts entry points. N��console�gui�_scripts) r� r� r� � get_entry_map�keys�_ensure_safe_name�templaterX �_get_script_args) r� r� �headerr) �type_r� r r� rx r? r? r@ r� l s � ��zScriptWriter.get_argsc C s t �d| �}|r td��dS )z? Prevent paths in *_scripts entry point names. z[\\/]z+Path separators not allowed in script namesN)r� �searchr )r � has_path_sepr? r? r@ r } s �z ScriptWriter._ensure_safe_namec C s* t jdkstjdkrtjdkrt�� S | S )zD Select the best ScriptWriter for this environment. �win32�javar )r� r� r� r �_name�WindowsScriptWriterr� r� r? r? r@ r� � s zScriptWriter.bestc c s � ||| fV d S r� r? )r� r r r r� r? r? r@ r � s �z ScriptWriter._get_script_argsr� r� r� rY �(str | CommandSpec | Iterable[str] | Noner� c C s" | j �� �|�}|�|� |�� S )z;Create a #! line, getting options (if any) from script_text)�command_spec_classr� r� r� r� )r� r� rY �cmdr? r? r@ r� � s zScriptWriter.get_headerr� )r� N)r� r� rY r r� r� )r> r? r@ rA rL rM rH r r� r r� r� rG r r� r r� r? r? r? r@ r� ? s( �#�% �r� c @ s@ e Zd ZeZedd� �Zedd� �Zedd� �Ze dd� �Z d S ) r c C s" t t| d�}tj�dd�}|| S )zC Select the best ScriptWriter suitable for Windows )rY �natural�SETUPTOOLS_LAUNCHERrY )r� � WindowsExecutableLauncherWriterr� r> r? )r� � writer_lookup�launcherr? r? r@ r� � s �zWindowsScriptWriter.bestc # s� � t ddd�| }|tjd �� �d�vr#djd i t� ��}t�|� g d�}|� |� | � ||�}� fdd �|D �}� | || d |fV d S ) z For Windows, add a .py extension�.pyar� r �PATHEXT�;zK{ext} not listed in PATHEXT; scripts will not be recognized as executables.)r r� � -script.py�.pyc�.pyor� r� c � g | ]}� | �qS r? r? r� �r r? r@ r� � r� z8WindowsScriptWriter._get_script_args.<locals>.<listcomp>r� Nr? ) r� r� r> r� r� rW rX r! ro r� �_adjust_header) r� r r r r� �extr r� r� r? r r@ r � s ��� z$WindowsScriptWriter._get_script_argsc C sN d}d}|dkr ||}}t �t �|�t j�}|j||d�}| �|�r%|S |S )z� Make sure 'pythonw' is used for gui and 'python' is used for console (regardless of what sys.executable is). rP rQ r )r� �repl)r� r� �escape� IGNORECASE�sub� _use_header)r� r � orig_headerr� r# � pattern_ob� new_headerr? r? r@ r! � s z"WindowsScriptWriter._adjust_headerc C s& | dd� � d�}tjdkpt�|�S )z� Should _adjust_header use the replaced header? On non-windows systems, always use. On Windows systems, only use the replaced header if it resolves to an executable on the system. r# r� �"r )rN r� r� r� �which)r* � clean_headerr? r? r@ r' � s z WindowsScriptWriter._use_headerN) r> r? r@ r� r r� r� r r! rG r' r? r? r? r@ r � s r c @ s e Zd Zedd� �ZdS )r c # s� � |dkr d}d}dg}nd}d}g d�}| � ||�}� fdd�|D �} � | || d | fV � d t|�d fV t� sJ� d } | t� �d fV d S d S )zG For Windows, add a .py extension and an .exe launcher r z -script.pywr� �clir )r� r r c r r? r? r� r r? r@ r� � r� zDWindowsExecutableLauncherWriter._get_script_args.<locals>.<listcomp>r� r� r_ z .exe.manifestN)r! �get_win_launcherrA �load_launcher_manifest) r� r r r r� � launcher_typer" r� �hdrr� �m_namer? r r@ r � s& � ��z0WindowsExecutableLauncherWriter._get_script_argsN)r> r? r@ r� r r? r? r? r@ r � s r c C sL | � d�}t � rt� dkr|�dd�}n |�dd�}n|�dd�}td|�S )z� Load the Windows launcher (executable) suitable for launching a script. `type` should be either 'cli' or 'gui' Returns the executable as a byte string. r� z win-arm64r� z-arm64.z-64.z-32.r� )rA r2 rO r )r� � launcher_fnr? r? r@ r/ � s r/ c C s t �td�}|�d�t� S )Nzlauncher manifest.xmlr� )� pkg_resourcesr r> r� �vars)r �manifestr? r? r@ r0 s r0 c C s t �d�} t �| � | S )N� )r� �umask)�tmpr? r? r@ r� s r� c C s t dd� | �S )z, Exclude non-str values. Ref #3063. c S s t | t�S r� )r� r� )r r? r? r@ �<lambda> s zonly_strs.<locals>.<lambda>)rK )r5 r? r? r@ r4 s r4 �fullnamer� r� c C s� z t | tjd�� }|�� W d � W S 1 sw Y W d S tyF t | tjd��}|�� W d � Y S 1 s>w Y Y d S w )NrN )r< r( rU rp �UnicodeDecodeErrorr' �LOCALE_ENCODING)r< r^ r? r? r@ r] ! s (� *��r] c @ s e Zd ZdZdZdZdS )rn z#easy_install command is deprecated.z� Please avoid running ``setup.py`` and ``easy_install``. Instead, use pypa/build, pypa/installer or other standards-based tools. z-https://github.com/pypa/setuptools/issues/917N)r> r? r@ �_SUMMARY�_DETAILS�_SEE_URLr? r? r? r@ rn 5 s rn r� )r� )r< r� r� r� )�rA � __future__r rq r� ru r� r/ r� r� r� r� r. r= r� r� r� rr rL �warningsrl r� �collections.abcr r r �typingr r r � jaraco.textr r5 r r r r r r r r r r r r r r� r �setuptools.archive_utilr �setuptools.commandr r r �setuptools.package_indexr r r �setuptools.sandboxr �setuptools.warningsr r! �setuptools.wheelr" �_pathr$ �_shutilr% r� r& r� �compatr' r( r% r) r* �distutils.commandr+ � distutils.command.build_scriptsr, �distutils.errorsr- r. r/ r0 r2 r1 r2 r3 �typing_extensionsr4 �filterwarnings� PEP440Warning�__all__rA rG rJ rQ r7 rL r� rd r9 r: r8 r� r> r? r� r� r� r� r� r� �builtin_module_namesr� r� r� r� r� r� r� r� r� �sys_executabler� r� r r r/ r0 r� r4 r] rn r? r? r? r@ �<module> s� < D-)% R Vb; command/__pycache__/setopt.cpython-310.pyc 0000644 00000011244 15030122015 0014400 0 ustar 00 o �h� � @ s� d dl Z d dlZddlmZ ddlmZ d dlZd dlmZ d dlm Z d dl m Z g d�Z dd d �Z dd d�ZG dd� de�ZG dd� de�ZdS )� N� )�Command)� _cfg_read_utf8_with_fallback)�log)�DistutilsOptionError)� convert_path)� config_file� edit_config� option_base�setopt�localc C sh | dkrdS | dkrt j�t j�tj�d�S | dkr/t jdkr!dp"d}t j�td |� d ���S t d | ��) z�Get the filename of the distutils, local, global, or per-user config `kind` must be one of "local", "global", or "user" r z setup.cfg�globalz distutils.cfg�user�posix�.� z~/zpydistutils.cfgz7config_file() type must be 'local', 'global', or 'user') �os�path�join�dirname� distutils�__file__�name� expanduserr � ValueError)�kind�dot� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/setopt.pyr s r Fc C sJ t �d| � t�� }dd� |_t|| � |�� D ]c\}}|du r-t �d|| � |�|� q|� |�s>t �d|| � |� |� |�� D ]8\}}|du rjt �d||| � |� ||� |� |�sit �d|| � |�|� qBt �d |||| � |� |||� qBqt �d | � |s�t| d d d ��}|�|� W d � dS 1 s�w Y dS dS )aY Edit a configuration file to include `settings` `settings` is a dictionary of dictionaries or ``None`` values, keyed by command/section name. A ``None`` value means to delete the entire section, while a dictionary lists settings to be changed or deleted in that section. A setting of ``None`` means to delete that setting. z Reading configuration from %sc S s | S �Nr )� optionstrr r r �<lambda>( s z edit_config.<locals>.<lambda>Nz Deleting section [%s] from %sz Adding new section [%s] to %szDeleting %s.%s from %sz#Deleting empty [%s] section from %szSetting %s.%s to %r in %sz Writing %s�wzutf-8)�encoding)r �debug� configparser�RawConfigParser� optionxformr �items�info�remove_section� has_section� add_section� remove_option�options�set�open�write) �filename�settings�dry_run�opts�sectionr. �option�value�fr r r r s@ � � �� "��r c @ s0 e Zd ZdZg d�ZddgZdd� Zdd� Zd S ) r z<Abstract base class for commands that mess with config files))� global-config�gz0save options to the site-wide distutils.cfg file)� user-config�uz7save options to the current user's pydistutils.cfg file)z filename=r9 z-configuration file to use (default=setup.cfg)r: r< c C s d | _ d | _d | _d S r )� global_config� user_configr2 ��selfr r r �initialize_optionsV s z option_base.initialize_optionsc C sv g }| j r |�td�� | jr|�td�� | jd ur!|�| j� |s*|�td�� t|�dkr5td|��|\| _d S )Nr r r � z/Must specify only one configuration file option)r> �appendr r? r2 �lenr )rA � filenamesr r r �finalize_options[ s � z option_base.finalize_optionsN)�__name__� __module__� __qualname__�__doc__� user_options�boolean_optionsrB rG r r r r r H s � r c @ sJ e Zd ZdZdZg d�ej Zejdg Zdd� Zd d d �Z d d d �Z dS )r z#Save command-line options to a filez1set an option in setup.cfg or another config file))zcommand=�cz command to set an option for)zoption=�oz option to set)z set-value=�szvalue of the option)�remove�rzremove (unset) the valuerQ c C s& t �| � d | _d | _d | _d | _d S r )r rB �commandr7 � set_valuerQ r@ r r r rB z s zsetopt.initialize_options�returnNc C sF t �| � | jd u s| jd u rtd��| jd u r | js!td��d S d S )Nz%Must specify --command *and* --optionz$Must specify --set-value or --remove)r rG rS r7 r rT rQ r@ r r r rG � s �zsetopt.finalize_optionsc C s* t | j| j| j�dd�| jii| j� d S )N�-�_)r r2 rS r7 �replacerT r4 r@ r r r �run� s �z setopt.run)rU N) rH rI rJ rK � descriptionr rL rM rB rG rY r r r r r l s � r )r )F)r% r r r � unicode_utilsr r r �distutils.errorsr �distutils.utilr �__all__r r r r r r r r �<module> s *$ command/__pycache__/bdist_wheel.cpython-310.pyc 0000644 00000035643 15030122015 0015364 0 ustar 00 o �h�V � @ sp d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z ddl mZ ddlmZ ddlmZmZ ddlmZmZ dd lmZmZ dd lm Z d d l m Z m Z m Z d d l!m"Z" d dl#m$Z$ d dl m%Z% ddl&m&Z' ddl(m)Z) d0dd�Z*e+e �,d�d �Z-dZ.d1dd �Z/d2d d �Z0d3d!d"�Z1 #d4d5d(d)�Z2d6d*d+�Z3d0d,d-�Z4G d.d/� d/e �Z5dS )7zI Create a wheel (.whl) distribution. A wheel is a built archive format. � )� annotationsN)�Iterable�Sequence)�BytesGenerator)�iglob)�Literal�cast)� ZIP_DEFLATED� ZIP_STORED)�tags�version)� WheelFile� )�Command� __version__�_shutil)�_safe_license_file)� safer_name)� SetuptoolsDeprecationWarning� )�egg_info)�logr �str�returnc C s@ zt t�| ��W S tjy | �dd�} t�dd| � Y S w )zB Convert an arbitrary string to a standard version string � �.z[^A-Za-z0-9.]+�-)r �_packaging_version�Version�InvalidVersion�replace�re�sub�r � r$ �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/bdist_wheel.py� safe_version" s �r& r zcp3\d�boolc C s t �d�dkS )N�P� )�struct�calcsizer$ r$ r$ r% �_is_32bit_interpreter3 � r, c C s dt jj� �S )N�py)�sys� version_info�majorr$ r$ r$ r% � python_tag7 r- r2 � archive_root� str | Nonec C s^ t �� }|�d�r| durddlm} || |�}nt� r)|dkr#d}n|dkr)d}|�d d �S ) z0Return our platform name 'win32', 'linux_x86_64'�macosxNr )� calculate_macosx_platform_tag� linux-x86_64z linux-i686� linux-aarch64z linux-armv7lr �_)� sysconfig� get_platform� startswith�wheel.macosx_libfiler6 r, r )r3 �resultr6 r$ r$ r% r; ; s r; T�var�fallback�expected�warnc C s: t �| �}|du r|rtjd| � d�tdd� |S ||kS )zfUse a fallback value for determining SOABI flags if the needed config var is unset or unavailable.NzConfig variable 'z+' is unset, Python ABI tag may be incorrectr �� stacklevel)r: �get_config_var�warningsrB �RuntimeWarning)r? r@ rA rB �valr$ r$ r% �get_flagO s �rI c C sj t �d�} t�� }| s4|dv r4ttd�r4d}d}tdttd�|dkd�r&d }|� t�� � |� |� �}|S | rJ|dkrJ| �d �rJd| � d �d }|S | rg|dkrg| �d�rg| � d �d }ttd�re|d 7 }|S | r�|dkr�d � | � d �dd� �}|� dd�� d d�}|S | r�|dkr�d � | � d �dd� �}|� dd�� d d�}|S | r�| � dd�� d d�}|S d}|S )zJReturn the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2).�SOABI)�cp�pp� maxunicode� �Py_DEBUG�gettotalrefcountrK )rB �d�cpythonr r r rL Nr r r9 �graalpy� ) r: rE r �interpreter_name�hasattrr/ rI �interpreter_versionr< �split�joinr )�soabi�implrQ �u�abir$ r$ r% � get_abi_tag` s< �� � ���r^ c C s t | ��dd�S )Nr r9 )r& r r# r$ r$ r% � safer_version� s r_ c @ s� e Zd ZdZeed�Zdddded�� d�fd d d d d dddddd�e�� d�fddde � � d�fdddgZ g d�Z d>d d �Z d>d d �Z d>d!d"�Zed?d$d%��Zd@d'd(�Zd)d*� Zd+e� d,�fdAd/d0�ZdBd2d3�ZedCd5d6��ZdDd9d:�ZdEd<d=�ZdS )F� bdist_wheelzcreate a wheel distribution)�stored�deflated)z bdist-dir=�bz1temporary directory for creating the distributionz plat-name=�pz8platform name to embed in generated filenames [default: N�])� keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z dist-dir=rQ z-directory to put final built distributions in)� skip-buildNz2skip rebuilding everything (for testing/debugging))�relativeNz7build the archive using relative paths [default: false])zowner=r\ z@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group])� universalNz4*DEPRECATED* make a universal wheel [default: false]z compression=z zipfile compression (one of: z, z) [default: 'deflated']z python-tag=z3Python implementation compatibility tag [default: 'z'])z build-number=NzqBuild number for this particular version. As specified in PEP-0427, this must start with a digit. [default: None])zpy-limited-api=Nz?Python tag (cp32|cp33|cpNN) for abi3 wheel tag [default: false])zdist-info-dir=Nz�directory where a pre-generated dist-info can be found (e.g. as a result of calling the PEP517 'prepare_metadata_for_build_wheel' method))rf rh ri rk r �Nonec C s~ d | _ d| _d | _d | _d| _d| _d | _d | _d | _d | _ d| _ d| _ d | _ d | _ d| _d| _t� | _d | _d| _d| _d S )NrN �zipFrb )� bdist_dir�data_dir� plat_name�plat_tag�format� keep_temp�dist_dir� dist_info_dir� egginfo_dir� root_is_pure� skip_buildri �owner�grouprk � compressionr2 � build_number�py_limited_api�plat_name_supplied��selfr$ r$ r% �initialize_options� s( z bdist_wheel.initialize_optionsc C s | j s| �d�j}tj�|d�| _ | jd u r#tt| j � d��}|� � | j d | _ t| j�| _d}| jdgt||��R � | j �� pF| j �� | _| �� | j �d�}d|v rmt�d� |d d �� }|�� d v rmd | _ | j rxt j d d d d� | j d ur�| j d d� � � s�t!d��d S d S )N�bdist�wheelr z.data)rt rp rx rk z=The [wheel] section is deprecated. Use [bdist_wheel] instead.r )�1�true�yesTz#bdist_wheel.universal is deprecatedaj With Python 2.7 end-of-life, support for building universal wheels (i.e., wheels that support both Python 2 and Python 3) is being obviated. Please discontinue using this option, or if you still need it, file an issue with pypa/setuptools describing your use case. )i� � � )�due_datez1Build tag (build-number) must start with a digit.)"rn �get_finalized_command� bdist_base�os�pathrY ru r � egg_info_cls� distribution�get_command_obj�ensure_finalized�wheel_dist_namero r' rp r~ �set_undefined_optionsrm �has_ext_modules�has_c_librariesrw �_validate_py_limited_api�get_option_dictr rB �strip�lowerrk r �emitr| �isdigit� ValueError)r� r� r � need_optionsr� rH r$ r$ r% �finalize_options� s8 � � �z bdist_wheel.finalize_optionsc C sH | j sd S t�t| j �stdt� d���t�d�r"td| j �d���d S )Nzpy-limited-api must match '�'�Py_GIL_DISABLEDz`py_limited_api=z�` not supported. `Py_LIMITED_API` is currently incompatible with `Py_GIL_DISABLED`.See https://github.com/python/cpython/issues/111506.)r} r! �match�PY_LIMITED_API_PATTERNr� r: rE r r$ r$ r% r� s ��z$bdist_wheel._validate_py_limited_apir c C s8 t | j�� �t| j�� �g}| jr|�| j� d�|�S )z4Return distribution full name with - replaced with _r )r r� �get_namer_ � get_versionr| �appendrY )r� � componentsr$ r$ r% r� $ s � zbdist_wheel.wheel_dist_name�tuple[str, str, str]c s( | j r | jr | j� n'| jrd� n!| jr | j�d�s | j� nt| j�� t� r1� dv r+d� � dv r1d� � �� �dd��d d��d d�� | jrT| j rJd }n| j }|d � f}|S t � � }t � � }|| }| jrp|| �d �rp| j}d}ntt� ��� }||� f}� fdd�t �� D �}||v s�J d|� ���|S )N�anyr5 )r7 � linux_x86_64� linux_i686)r8 � linux_aarch64� linux_armv7lr r9 r r zpy2.py3�none�cp3�abi3c s g | ] }|j |j� f�qS r$ )� interpreterr] )�.0�t�rp r$ r% � <listcomp>a s �z'bdist_wheel.get_tag.<locals>.<listcomp>z'would build wheel with unsupported tag )r~ rp rw r< r; rn r, r� r rk r2 r rU rW r} r r^ �sys_tags)r� r[ �tag� impl_name�impl_ver�abi_tag�supported_tagsr$ r� r% �get_tag/ sF � � � �zbdist_wheel.get_tagc C s� | � d�}d|_d|_| � d�}d|_| js| �d� | j ddd�}| j|_d|_| j|_d|_ | � d �}d|_ d D ]}t |d | t j �| j|�� q:d }t jd krdt j �t j �| jd��}| | _| _t || jrkdnd|� t�d| j� �� | �d� | �� \}}} | j� d|� d|� d| � �} | js�| j} n t j �| j| �|j��} | � dd� t | j � � �� dt | j �!� �� d�} t j �| j| �} | j"r�t�#d| j"� �� t$�%| j"| � t&�'| j(� n| �)| j(| � | �*| � t j �+| j,�s�t �-| j,� t j �| j,| d �}t.|d| �/� �� }|�0| � W d � n 1 �sw Y t1| j dg ��2dt3j4j5� dt3j4j6� �|f� | j7�sOt�d | j� �� | j8�sQt&�'| j� d S d S d S ) N� build_scripts�pythonT� build_extF�build�install)�reinit_subcommands�install_scripts)�headers�scripts�data�purelib�platlib�install_rN �ntz..�install_purelib�install_platlibzinstalling to r �install_egg_info)�targetrv z .dist-infozreusing z.whl�w� dist_filesr` r z removing )9�reinitialize_command� executable�force�inplacerx � run_commandrn �root�compile�warn_dir�no_ep�setattrr� r� rY ro �name�normpath�install_libbase� install_librw r �infor� r� ri �_ensure_relative� install_baser� r r� r� r_ r� ru �debug�shutil�copytreer �rmtreerv �egg2dist�write_wheelfile�existsrt �makedirsr �_zip_compression� write_files�getattrr� r/ r0 r1 �minorrs �dry_run)r� r� r� r� r� �key�basedir_observed�impl_tagr� rq �archive_basenamer3 �distinfo_dirname� distinfo_dir� wheel_path�wfr$ r$ r% �runi s~ � � �� ���zbdist_wheel.runz setuptools (�)�wheelfile_base� generatorc C s� ddl m} |� }d|d< ||d< t| j��� |d< | jd ur$| j|d< | �� \}}}|�d�D ] }|�d�D ]} |�d�D ] } d �|| | f�|d < q>q7q0t j �|d �} t � d | � �� t | d ��} t| dd��|� W d � d S 1 svw Y d S )Nr )�Messagez1.0z Wheel-Version� GeneratorzRoot-Is-Purelib�Buildr r �Tag�WHEELz creating �wb)� maxheaderlen)� email.messager� r rw r� r| r� rX rY r� r� r r� �openr �flatten) r� r� r� r� �msgr� r� rq r[ r] �plat�wheelfile_path�fr$ r$ r% r� � s& �� "�zbdist_wheel.write_wheelfiler� c C s6 t j�|�\}}|dd� t jkr||dd � }|S )Nr r )r� r� � splitdrive�sep)r� r� �driver$ r$ r% r� � s z bdist_wheel._ensure_relative� Iterable[str]c C s t dkr | jjjp dS tt � }| j�d�}t dkr%ttt | jjj�}nd|v r2|d d � � }nd}d|v rIt j dt d d � |� |d d � |sT|sTt|t�sTd }|D ]3}t|�D ],}|�d �rmt�d |� d�� q\||vr�tj�|�r�t�d|� d|� d�� |� |� q\qV|S )N�9 r$ �metadata�* � license_filesr � license_filezEThe "license_file" option is deprecated. Use "license_files" instead.r rC )z LICEN[CS]E*zCOPYING*zNOTICE*zAUTHORS*�~zignoring license file "z" as it looks like a backupzadding license file "z" (matched pattern "z"))�setuptools_major_versionr� r r �setr r� r r rX rF rB �DeprecationWarning�add� isinstance�listr �endswithr r� r� r� �isfiler� )r� �filesr �patterns�patternr� r$ r$ r% � license_paths� sB � �� �� zbdist_wheel.license_paths� egginfo_path� distinfo_pathc C sj ddd�}||� t j�|�s?ddl}t j�t j�|�d �}|�|�}d |� d �}|r;t j�|d �}|d |� d �7 }t|��t j�|d�} tj ||dd� d� t j�|d�} t | dd��} | � � � � } W d � n1 snw Y | sy|| � t j�|d�} t� | | � t j�|d�}| jD ] }t|�}t j�||�}t jt j�|�dd� t� ||� q�||� dS )z:Convert an .egg-info directory into a .dist-info directoryrd r r rl c S sP t j�| �rt j�| �st j�| �rt�| � dS t j�| �r&t �| � dS dS )z-Appropriately delete directory, file or link.N)r� r� r� �islink�isdirr r� �unlink)rd r$ r$ r% �adios s $ �z#bdist_wheel.egg2dist.<locals>.adiosr Nz *.egg-infozEgg metadata expected at z but not foundz (z) found - possible misnamed archive file?)�PKG-INFOc S s h d�S )N> � SOURCES.txt� not-zip-safe� requires.txtr$ r$ )�x�yr$ r$ r% �<lambda>6 s z&bdist_wheel.egg2dist.<locals>.<lambda>)�ignorezdependency_links.txtzutf-8)�encoding�METADATA�licensesT)�exist_ok)rd r r rl )r� r� r� �globrY �dirname�basenamer� r� r� r �readr� �copyr r r� )r� r r r# r0 �pat�possible�err�alt� pkginfo_path�dependency_links_path�dependency_links_file�dependency_links� metadata_path�licenses_folder_path� license_path� safe_path�dist_info_license_pathr$ r$ r% r� s@ � � zbdist_wheel.egg2dist�intc C sP t | jt�r| j| j�� v r| jS | j�t| j��}|d ur |S td| j����)NzUnsupported compression: )r r{ rB �supported_compressions�values�getr r� )r� r{ r$ r$ r% r� Q s �z bdist_wheel._zip_compression)r rl �r r )r r� )r� r r� r r rl )r� r r r )r r )r r r r r rl )r rB )�__name__� __module__� __qualname__� descriptionr r rC r; rY r2 � user_options�boolean_optionsr� r� r� �propertyr� r� r� r r� r� r r� r� r$ r$ r$ r% r` � s\ ���� ��? / : _ � ,>r` )r r r r )r r' rF )r3 r4 r r )TT) r? r r@ r' rA r' rB r' r r' )r r4 )6�__doc__� __future__r r� r! r� r* r/ r: rF �collections.abcr r �email.generatorr r0 r �typingr r �zipfiler r � packagingr r r �wheel.wheelfiler rN r r r �_core_metadatar �_normalizationr r r r� � distutilsr r& rB rX r r� r, r2 r; rI r^ r_ r` r$ r$ r$ r% �<module> sB � # command/__pycache__/build_py.cpython-310.pyc 0000644 00000035215 15030122015 0014675 0 ustar 00 o �h�< � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlmZm Z d dl m Z d dl m Z d dl mZ d dlmZ dd lmZmZ dd lmZ dd lmZ d dlm mZ d dl Z d d l m Z d Z ddd�Z!G dd� dej�Zdd� Z"G dd� d�Z#dS )� )� annotationsN)�Iterable�Iterator)�partial)�glob)�Path)�unique_everseen� )�StrPath�StrPathT)� Distribution)� SetuptoolsDeprecationWarning)� convert_path)z*.pyizpy.typed�return�Nonec C s t �| t �| �jtjB � d S �N)�os�chmod�stat�st_mode�S_IWRITE)�target� r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/build_py.py� make_writable s r c s e Zd ZU dZded< dZded< dZded < d d � Z dNdO� fdd� ZdPd d �Z dQd!d"�Z d#d$� Z d%d&� Z d'd(� Z d)d*� ZdRdS� fd-d.� ZdTd0d1�ZdUd3d4�ZdUd5d6�ZdPd7d8�ZdPd9d:�ZdVd?d@�ZdPdAdB�ZdCdD� ZdEdF� ZdGdH� ZdIdJ� ZedWdLdM��Z � Z S )X�build_pyaX Enhanced 'build_py' command that includes data files with packages The data files are specified via a 'package_data' argument to 'setup()'. See 'setuptools.dist.Distribution' for more details. Also, this version of the 'build_py' command allows you to specify both 'py_modules' and 'packages' in the same setup operation. r � distributionF�bool� editable_modeNzStrPath | None�existing_egg_info_dirc C s> t j�| � | jj| _| jjpi | _d| jv r | jd= d S d S )N� data_files)�origr �finalize_optionsr � package_data�exclude_package_data�__dict__��selfr r r r" , s �zbuild_py.finalize_optionsT� �infiler �outfiler � preserve_mode�preserve_times�link� str | None�level�objectr �tuple[StrPathT | str, bool]c s: |rt t|��� �}t t|��� �}t� �||||||�S r )�strr �resolve�super� copy_file)r' r) r* r+ r, r- r/ �� __class__r r r5 3 s �zbuild_py.copy_filer c C sT | j s| jr | jr dS | j r| �� | jr | �� | �� | �tjj | dd�� dS )z?Build modules, packages, and copy data files to build directoryNF)�include_bytecode) � py_modules�packagesr � build_modules�build_packages�build_package_data� byte_compiler! r � get_outputsr& r r r �runD s z build_py.run�attrr2 c C s& |dkr | � � | _| jS tj�| |�S )zlazily compute data filesr )�_get_data_filesr r! r � __getattr__)r' rA r r r rC T s zbuild_py.__getattr__c C s | � � tt| j| jp d��S )z?Generate list of '(package,src_dir,build_dir,filenames)' tuplesr )�analyze_manifest�list�map�_get_pkg_data_filesr: r& r r r rB [ s zbuild_py._get_data_filesc C s$ | j �di � tt| j| jpd��S )z� Generate list of ``(package,src_dir,build_dir,filenames)`` tuples, but without triggering any attempt to analyze or build the manifest. �manifest_filesr )r% � setdefaultrE rF rG r: r& r r r � get_data_files_without_manifest` s z(build_py.get_data_files_without_manifestc sJ | � |�� tjj| jg|�d� � }� fdd�| �|� �D �}|� ||fS )N�.c s g | ] }t j�|� ��qS r )r �path�relpath)�.0�file��src_dirr r � <listcomp>r s ��z0build_py._get_pkg_data_files.<locals>.<listcomp>)�get_package_dirr rL �join� build_lib�split�find_data_files)r' �package� build_dir� filenamesr rP r rG j s � z build_py._get_pkg_data_filesc C sd | j | j||td�}tttdd�|�}tj�|�}t t j j |�}t�| j �|g �|�}| �|||�S )z6Return filenames for package's data files in 'src_dir')�extra_patternsT)� recursive)�_get_platform_patternsr# �_IMPLICIT_DATA_FILESrF r r � itertools�chain� from_iterable�filterr rL �isfilerH �get�exclude_data_files)r' rX rQ �patterns�globs_expanded� globs_matches� glob_files�filesr r r rW x s � �zbuild_py.find_data_filesr8 � list[str]c s" | j r t| �� �� �S t� �|�S )�1See :class:`setuptools.commands.build.SubCommand`)r rE �get_output_mapping�keysr4 r? )r' r8 r6 r r r? � s zbuild_py.get_outputs�dict[str, str]c C s( t �| �� | �� �}tt|dd� d��S )rl c S s | d S )Nr r )�xr r r �<lambda>� s z-build_py.get_output_mapping.<locals>.<lambda>)�key)r_ r` � _get_package_data_output_mapping�_get_module_mapping�dict�sorted)r' �mappingr r r rm � s �zbuild_py.get_output_mapping�Iterator[tuple[str, str]]c c s> � | � � D ]\}}}|�d�}| �| j||�}||fV qdS )z5Iterate over all modules producing (dest, src) pairs.rK N)�find_all_modulesrV �get_module_outfilerU )r' rX �module� module_file�filenamer r r rt � s � �z build_py._get_module_mappingc c sJ � | j D ] \}}}}|D ]}tj�||�}tj�||�}||fV q qdS )z6Iterate over package data producing (dest, src) pairs.N)r r rL rT )r' rX rQ rY rZ r} r �srcfiler r r rs � s � ��z)build_py._get_package_data_output_mappingc C s@ | � � D ]\}}| �tj�|�� | �||�\}}t|� qdS )z$Copy data files into build directoryN)rs �mkpathr rL �dirnamer5 r )r' r r~ �_outf�_copiedr r r r= � s �zbuild_py.build_package_datac C sh i | _ | jjs d S i }| jpdD ] }||t| �|��< q| jr8t| jd��� r8| j}t|d�}|j dd�� � }n| � d� | � d�}|j }|jj}t� }| �||�D ]_}tj�t|��\} } d } | } | r�| | kr�| |vr�| } tj�| �\} } tj�| | �} | r�| | kr�| |vsl| |v r�| | kr�|�| �r�qRn|�|| | �}|r�|�|� | j �|| g ��|� qRd S )Nr z SOURCES.txtzutf-8)�encoding�egg_info)rH r �include_package_datar: �assert_relativerS r r �exists� read_text� splitlines� run_command�get_finalized_commandr� �filelistrj �_IncludePackageDataAbuse�_filter_build_filesr rL rV rT � is_module�importable_subpackage�warnrI �append)r' �src_dirsrX � egg_info_dir�manifestrj �ei_cmd�checkrL �d�f�prev�oldf�df� importabler r r rD � sL �� � � ��zbuild_py.analyze_manifestrj � Iterable[str]r� � Iterator[str]c # sn � | � d�}|| j|j|jf}dd� |D �}|D ] }tj�|�� tj�|�r1t� fdd�|D ��r4|V qdS )a} ``build_meta`` may try to create egg_info outside of the project directory, and this can be problematic for certain plugins (reported in issue #3500). Extensions might also include between their sources files created on the ``build_lib`` and ``build_temp`` directories. This function should filter this case of invalid files out. �buildc S s g | ] }|rt j�|��qS r )r rL �normpath)rN �pr r r rR � s z0build_py._filter_build_files.<locals>.<listcomp>c 3 s � | ]}|� vV qd S r r )rN r� �� norm_pathr r � <genexpr>� s � z/build_py._filter_build_files.<locals>.<genexpr>N) r� rU � build_temp� build_baser rL r� �isabs�all)r' rj r� r� � build_dirs� norm_dirsrO r r� r r� � s � "��z build_py._filter_build_filesc C s d S r r r& r r r �get_data_files� s zbuild_py.get_data_filesc C s� z| j | W S ty Y nw tj�| ||�}|| j |< |r#| jjs%|S | jjD ]}||ks6|�|d �r8 nq)|S t|d�� }|� � }W d � n1 sOw Y d|vrbt j � d|� d���|S )z8Check namespace packages' __init__ for declare_namespacerK �rbNs declare_namespacezNamespace package problem: z� is a namespace package, but its __init__.py does not call declare_namespace()! Please fix it. (See the setuptools manual under "Namespace Packages" for details.) ") �packages_checked�KeyErrorr! r � check_packager �namespace_packages� startswith�open�read� distutils�errors�DistutilsError)r' rX � package_dir�init_py�pkgr� �contentsr r r r� � s, � � � �zbuild_py.check_packagec C s" i | _ tj�| � d| _d | _d S )NF)r� r! r �initialize_optionsr r r& r r r r� s zbuild_py.initialize_optionsc C s0 t j�| |�}| jjd urtj�| jj|�S |S r )r! r rS r �src_rootr rL rT )r' rX �resr r r rS s zbuild_py.get_package_dirc s\ t ���| �| j||�}�fdd�|D �}tj�|�}t|�� � fdd��D �}t t|��S )z6Filter filenames for package's data files in 'src_dir'c 3 s � | ] }t �� |�V qd S r )�fnmatchrb �rN �pattern)rj r r r� ! � � z.build_py.exclude_data_files.<locals>.<genexpr>c 3 s � | ] }|� vr|V qd S r r )rN �fn)�badr r r� % r� )rE r] r$ r_ r` ra �setr )r' rX rQ rj rf � match_groups�matches�keepersr )r� rj r re s � zbuild_py.exclude_data_filesr c s0 t �|| �dg �| �|g ��}� fdd�|D �S )z� yield platform-specific path patterns (suitable for glob or fn_match) from a glob-based spec (such as self.package_data or self.exclude_package_data) matching package in src_dir. � c 3 s" � | ] }t j�� t|��V qd S r )r rL rT r r� rP r r r� 6 s � � �z2build_py._get_platform_patterns.<locals>.<genexpr>)r_ r` rd )�specrX rQ r[ � raw_patternsr rP r r] ) s � �z build_py._get_platform_patterns)TTNr( )r) r r* r r+ r r, r r- r. r/ r0 r r1 �r r )rA r2 )T)r8 r r rk )r ro )r rx )rj r� r� r r r� )r ) �__name__� __module__� __qualname__�__doc__�__annotations__r r r" r5 r@ rC rB rJ rG rW r? rm rt rs r= rD r� r� r� r� rS re � staticmethodr] � __classcell__r r r6 r r s> � ) r c C s6 t j�| �s| S ddlm} t�d��� | }||��)Nr )�DistutilsSetupErrorz� Error: setup script specifies an absolute path: %s setup() arguments must *always* be /-separated paths relative to the setup.py directory, *never* absolute paths. )r rL r� �distutils.errorsr� �textwrap�dedent�lstrip)rL r� �msgr r r r� = s � �� r� c @ s@ e Zd ZdZG dd� de�Zdd� Zdd� Zdd � Zd d � Z d S ) r� z>Inform users that package or module is included as 'data file'c @ s e Zd ZdZdZdS )z!_IncludePackageDataAbuse._WarningzU Package {importable!r} is absent from the `packages` configuration. a| ############################ # Package would be ignored # ############################ Python recognizes {importable!r} as an importable package[^1], but it is absent from setuptools' `packages` configuration. This leads to an ambiguous overall configuration. If you want to distribute this package, please make sure that {importable!r} is explicitly added to the `packages` configuration field. Alternatively, you can also rely on setuptools' discovery methods (for example by using `find_namespace_packages(...)`/`find_namespace:` instead of `find_packages(...)`/`find:`). You can read more about "package discovery" on setuptools documentation page: - https://setuptools.pypa.io/en/latest/userguide/package_discovery.html If you don't want {importable!r} to be distributed and are already explicitly excluding {importable!r} via `find_namespace_packages(...)/find_namespace` or `find_packages(...)/find`, you can try to use `exclude_package_data`, or `include-package-data=False` in combination with a more fine grained `package-data` configuration. You can read more about "package data files" on setuptools documentation page: - https://setuptools.pypa.io/en/latest/userguide/datafiles.html [^1]: For Python, any directory (with suitable naming) can be imported, even if it does not contain any `.py` files. On the other hand, currently there is no concept of package data directory, all directories are treated like packages. N)r� r� r� �_SUMMARY�_DETAILSr r r r �_WarningU s r� c C s t � | _d S r )r� �_already_warnedr& r r r �__init__� s z!_IncludePackageDataAbuse.__init__c C s |� d�o|d td� � �� S )Nz.py)�endswith�len� isidentifier)r' rO r r r r� � s z"_IncludePackageDataAbuse.is_modulec C s6 t |�j}tt�tj|j��}|rd�|g|��S d S )NrK ) r �parentrE r_ � takewhiler2 r� �partsrT )r' r� rO r� r� r r r r� � s z._IncludePackageDataAbuse.importable_subpackagec C s, || j vr| jj|d� | j �|� d S d S )N)r� )r� r� �emit�add)r' r� r r r r� � s �z _IncludePackageDataAbuse.warnN) r� r� r� r� r r� r� r� r� r� r r r r r� R s + r� r� )$� __future__r r� r_ r r r� �collections.abcr r � functoolsr r �pathlibr �more_itertoolsr �_pathr r �distr �warningsr �distutils.command.build_py�commandr r! r� r� �distutils.utilr r^ r r� r� r r r r �<module> s0 ! command/__pycache__/dist_info.cpython-310.pyc 0000644 00000006312 15030122015 0015040 0 ustar 00 o �hz � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl m Z ddl m Z d d lmZ dd lmZ dd lmZ G d d� de�ZdS )zD Create a dist_info directory As defined in the wheel specification � N)�contextmanager)�Path)�cast� )�_normalization)�rmdir� )�egg_info)�log)�Commandc @ s^ e Zd ZdZdZg d�ZddgZddiZdd� Zdd d �Z e d e de fdd��Z ddd�Zd S )� dist_infoz� This command is private and reserved for internal use of setuptools, users should rely on ``setuptools.build_meta`` APIs. z@DO NOT CALL DIRECTLY, INTERNAL ONLY: create .dist-info directory))z output-dir=�ozYdirectory inside of which the .dist-info will becreated [default: top of the source tree])�tag-date�dz0Add date stamp (e.g. 20050528) to version number)z tag-build=�bz-Specify explicit tag to add to version number)�no-date�Dz"Don't include date stamp [default])� keep-egg-infoNz,*TRANSITIONAL* will be removed in the futurer r r c C s( d | _ d | _d | _d | _d | _d| _d S )NF)� output_dir�name� dist_info_dir�tag_date� tag_build� keep_egg_info)�self� r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/dist_info.py�initialize_options, s z dist_info.initialize_options�returnNc C s� | j }|jptj}t| jp|�| _tt| �d��}t | j�|_ | j r'| j |_ n|j | _ | j r3| j |_ n|j | _ |� � || _t�|�� �}t�|�� �}|� d|� �| _tj�| j| j� d��| _d S )Nr �-z .dist-info)� distribution�src_root�os�curdirr r r � egg_info_cls�reinitialize_command�str�egg_baser r �finalize_optionsr r � safer_name�get_name�safer_best_effort_version� get_versionr �path�joinr )r �dist� project_dirr r �versionr r r r( 4 s" zdist_info.finalize_options�dir_path� requires_bkpc c sx � |r7|� d�}t |dd� tj||ddd� zd V W t |dd� t�||� d S t |dd� t�||� w d V d S )Nz.__bkp__T)� ignore_errors)� dirs_exist_ok�symlinks)�_rm�shutil�copytree�move)r r2 r3 �bkp_namer r r �_maybe_bkp_dirN s � � zdist_info._maybe_bkp_dirc C s� | j jddd� | j�� | jj}tj�|�sJ d��t�dtj� | j �� d�� | � d�}| � || j �� |�|| j � W d � d S 1 sHw Y d S )NT)�parents�exist_okz&.egg-info dir should have been createdz creating '�'� bdist_wheel)r �mkdirr �runr" r- �isdirr �info�abspathr �get_finalized_commandr< r �egg2dist)r � egg_info_dirr@ r r r rB \ s "�z dist_info.run)r N)�__name__� __module__� __qualname__�__doc__� description� user_options�boolean_options� negative_optr r( r r& �boolr< rB r r r r r s r )rL r" r8 � contextlibr �pathlibr �typingr � r �_shutilr r7 r r$ � distutilsr �distutils.corer r r r r r �<module> s command/__pycache__/build.cpython-310.pyc 0000644 00000012266 15030122015 0014166 0 ustar 00 o �h� � @ s\ d dl mZ d dlmZ ddlmZ d dlmZ h d�Z G dd� de�ZG d d � d e�Z d S ) � )� annotations)�Protocol� )� Distribution)�build> �build_py� build_ext� build_clib� build_scriptsc @ s$ e Zd ZU ded< ejdd� ZdS )r r � distributionN)�__name__� __module__� __qualname__�__annotations__�_build� sub_commands� r r �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/build.pyr s r c @ sf e Zd ZU dZdZded< ded< dd d �Zdd d �Zdd d�Zddd�Z ddd�Z ddd�Z dS )� SubCommanda. In order to support editable installations (see :pep:`660`) all build subcommands **SHOULD** implement this protocol. They also **MUST** inherit from ``setuptools.Command``. When creating an :pep:`editable wheel <660>`, ``setuptools`` will try to evaluate custom ``build`` subcommands using the following procedure: 1. ``setuptools`` will set the ``editable_mode`` attribute to ``True`` 2. ``setuptools`` will execute the ``run()`` command. .. important:: Subcommands **SHOULD** take advantage of ``editable_mode=True`` to adequate its behaviour or perform optimisations. For example, if a subcommand doesn't need to generate an extra file and all it does is to copy a source file into the build directory, ``run()`` **SHOULD** simply "early return". Similarly, if the subcommand creates files that would be placed alongside Python files in the final distribution, during an editable install the command **SHOULD** generate these files "in place" (i.e. write them to the original source directory, instead of using the build directory). Note that ``get_output_mapping()`` should reflect that and include mappings for "in place" builds accordingly. 3. ``setuptools`` use any knowledge it can derive from the return values of ``get_outputs()`` and ``get_output_mapping()`` to create an editable wheel. When relevant ``setuptools`` **MAY** attempt to use file links based on the value of ``get_output_mapping()``. Alternatively, ``setuptools`` **MAY** attempt to use :doc:`import hooks <python:reference/import>` to redirect any attempt to import to the directory with the original source code and other files built in place. Please note that custom sub-commands **SHOULD NOT** rely on ``run()`` being executed (or not) to provide correct return values for ``get_outputs()``, ``get_output_mapping()`` or ``get_source_files()``. The ``get_*`` methods should work independently of ``run()``. F�bool� editable_mode�str� build_lib�return�Nonec C � dS �z@(Required by the original :class:`setuptools.Command` interface)Nr ��selfr r r �initialize_optionsX � z SubCommand.initialize_optionsc C r r r r r r r �finalize_options\ r zSubCommand.finalize_optionsc C r r r r r r r �run` r zSubCommand.run� list[str]c C r )a� Return a list of all files that are used by the command to create the expected outputs. For example, if your build command transpiles Java files into Python, you should list here all the Java files. The primary purpose of this function is to help populating the ``sdist`` with all the files necessary to build the distribution. All files should be strings relative to the project root directory. Nr r r r r �get_source_filesd s zSubCommand.get_source_filesc C r )a� Return a list of files intended for distribution as they would have been produced by the build. These files should be strings in the form of ``"{build_lib}/destination/file/path"``. .. note:: The return value of ``get_output()`` should include all files used as keys in ``get_output_mapping()`` plus files that are generated during the build and don't correspond to any source file already present in the project. Nr r r r r � get_outputsp s zSubCommand.get_outputs�dict[str, str]c C r )a� Return a mapping between destination files as they would be produced by the build (dict keys) into the respective existing (source) files (dict values). Existing (source) files should be represented as strings relative to the project root directory. Destination files should be strings in the form of ``"{build_lib}/destination/file/path"``. Nr r r r r �get_output_mapping~ s z SubCommand.get_output_mappingN)r r )r r# )r r& ) r r r �__doc__r r r r! r" r$ r% r' r r r r r s & r N) � __future__r �typingr �distr �distutils.command.buildr r �_ORIGINAL_SUBCOMMANDSr r r r r �<module> s command/__pycache__/bdist_rpm.cpython-310.pyc 0000644 00000003412 15030122015 0015043 0 ustar 00 o �h� � @ s@ d dl mZ d dlmZ ddlm mZ G dd� dej�ZdS )� )� Distribution)� SetuptoolsDeprecationWarning� Nc @ s, e Zd ZU dZeed< d dd�Zdd� ZdS ) � bdist_rpma Override the default bdist_rpm behavior to do the following: 1. Run egg_info to ensure the name and version are properly calculated. 2. Always run 'install' using --single-version-externally-managed to disable eggs in RPM distributions. � distribution�returnNc C s, t jddddd� | �d� tj�| � d S )NzDeprecated commandz� bdist_rpm is deprecated and will be removed in a future version. Use bdist_wheel (wheel packages) instead. z.https://github.com/pypa/setuptools/issues/1988)i� � � )�see_url�due_date�egg_info)r �emit� run_command�origr �run)�self� r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/bdist_rpm.pyr s � z bdist_rpm.runc C s t j�| �}dd� |D �S )Nc S s g | ] }|� d d�� dd��qS )zsetup.py install z5setup.py install --single-version-externally-managed z%setupz&%setup -n %{name}-%{unmangled_version})�replace)�.0�liner r r � <listcomp>$ s ���z-bdist_rpm._make_spec_file.<locals>.<listcomp>)r r �_make_spec_file)r �specr r r r " s �zbdist_rpm._make_spec_file)r N)�__name__� __module__� __qualname__�__doc__r �__annotations__r r r r r r r s r )�distr �warningsr �distutils.command.bdist_rpm�commandr r r r r r �<module> s command/__pycache__/install.cpython-310.pyc 0000644 00000012503 15030122015 0014527 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlZd dlZd dlmZ d dlmZm Z m Z m Z d dl Z ddl mZ ddlmZmZ dd lmZ d dlm mZ d d lmZ erTdd lmZ ndZddd�Z G dd� dej�Zdd� ejj D �ej e_ dS )� )� annotationsN)�Callable)� TYPE_CHECKING�Any�ClassVar�cast� )� Distribution)� SetuptoolsDeprecationWarning�SetuptoolsWarning� )� bdist_egg)�DistutilsArgError)� easy_install�name�strc C s0 | dkrt jddd� tjS tdt�d| ����)N�_installzk`setuptools.command._install` was an internal implementation detail that was left in for numpy<1.9 support.)i� � r )�due_datezmodule z has no attribute )r �emit�orig�install�AttributeError�__name__)r � r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/install.py� __getattr__ s �r c s� e Zd ZU dZded< ejjddg Zejjddg Zdd d � fd d d � fgZ d ed< e e �Z � fdd�Z d � fdd� Z dd� Z� fdd�Zedd� �Zd dd �Z� ZS ) r z7Use easy_install to install the package, w/dependenciesr � distribution)�old-and-unmanageableNzTry not to use this!)�!single-version-externally-managedNz5used by system package builders to create 'flat' eggsr r �install_egg_infoc C � dS �NTr ��selfr r r �<lambda>8 � zinstall.<lambda>�install_scriptsc C r! r" r r# r r r r% 9 r& z8ClassVar[list[tuple[str, Callable[[Any], bool] | None]]]� new_commandsc s* t jdddd� t� �� d | _d | _d S )Nz setup.py install is deprecated.z� Please avoid running ``setup.py`` directly. Instead, use pypa/build, pypa/installer or other standards-based tools. zAhttps://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html)�see_url)r r �super�initialize_options�old_and_unmanageable�!single_version_externally_managedr# �� __class__r r r+ = s � zinstall.initialize_options�return�Nonec s@ t � �� | jr d| _d S | jr| js | js td��d S d S d S )NTzAYou must specify --record or --root when building system packages)r* �finalize_options�rootr- �recordr r# r. r r r2 O s ��zinstall.finalize_optionsc C s( | j s| jr tj�| �S d | _d| _d S )N� )r3 r- r r �handle_extra_path� path_file� extra_dirsr# r r r r6 Y s zinstall.handle_extra_pathc s> | j s| jr t� �� S | �t�� �st� �� d S | �� d S )N)r, r- r* �run�_called_from_setup�inspect� currentframe�do_egg_installr# r. r r r9 d s �z install.runc C s� | du rd}t �|� t�� dkrd}t �|� dS t�| �}|dd� D ])}|dd� \}t�|�}|j�d d �}|d krD|j d krDq%|d koL|j dk S dS )a� Attempt to detect whether run() was called from setup() or by another command. If called by setup(), the parent caller will be the 'run_command' method in 'distutils.dist', and *its* caller will be the 'run_commands' method. If called any other way, the immediate caller *might* be 'run_command', but it won't have been called by 'run_commands'. Return True in that case or if a call stack is unavailable. Return False otherwise. Nz4Call stack not available. bdist_* commands may fail.� IronPythonz6For best results, pass -X:Frames to enable call stack.Tr � r r r5 zsetuptools.dist� run_commandzdistutils.dist� run_commandsF) r r �platform�python_implementationr; �getouterframes� getframeinfo� f_globals�get�function)� run_frame�msg�frames�frame�caller�info� caller_moduler r r r: q s zinstall._called_from_setupc C s� | j �d�}tt|| j d| j| jd��}|�� d|_|j� t � d�� | � d� tt | j � d��}|jg}tjr@|�dtj� ||_|jdd � d t_d S ) Nr �x)�argsr3 r4 �.z*.eggr r F)�show_deprecation)r �get_command_classr �easy_install_clsr3 r4 �ensure_finalized�always_copy_from� package_index�scan�globr@ � bdist_egg_cls�get_command_obj� egg_output� setuptools�bootstrap_install_from�insertrQ r9 )r$ r �cmdr rQ r r r r= � s* �� zinstall.do_egg_install)r0 r1 )r � __module__� __qualname__�__doc__�__annotations__r r � user_options�boolean_optionsr( �dict�_ncr+ r2 r6 r9 � staticmethodr: r= � __classcell__r r r. r r $ s, �� � r c C s g | ] }|d t jvr|�qS )r )r ri )�.0ra r r r � <listcomp>� s rm )r r ) � __future__r rZ r; rB �collections.abcr �typingr r r r r^ �distr �warningsr r r r[ �distutils.command.install�commandr r �distutils.errorsr r rU r � sub_commandsr( r r r r �<module> s. � � command/__pycache__/test.cpython-310.pyc 0000644 00000003304 15030122015 0014037 0 ustar 00 o �h? � @ sB d dl mZ d dlmZ d dlmZ d dd �ZG d d � d e�Zd S )� )� annotations)�Command)� SetuptoolsDeprecationWarning�name�str�return� type[_test]c C s& | dkrt jddddd� tS t| ��)N�testzAThe test command is disabled and references to it are deprecated.zlPlease remove any references to `setuptools.command.test` in all supported versions of the affected package.)i� � � � )�due_date� stacklevel)r �emit�_test�AttributeError)r � r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/test.py� __getattr__ s �r c @ s4 e Zd ZdZdZg d�Zdd� Zdd� Zdd � Zd S ) r z? Stub to warn when test command is referenced or used. z&stub for old test command (do not use)))z test-module=�mz$Run 'test_suite' in specified module)z test-suite=�sz9Run single test, case or suite (e.g. 'module.test_suite'))z test-runner=�rzTest runner to usec C � d S �Nr ��selfr r r �initialize_options& � z_test.initialize_optionsc C r r r r r r r �finalize_options) r z_test.finalize_optionsc C s t d��)Nz9Support for the test command was removed in Setuptools 72)� RuntimeErrorr r r r �run, s z _test.runN) �__name__� __module__� __qualname__�__doc__� description� user_optionsr r r r r r r r s r N)r r r r )� __future__r � setuptoolsr �setuptools.warningsr r r r r r r �<module> s command/__pycache__/install_lib.cpython-310.pyc 0000644 00000010666 15030122015 0015365 0 ustar 00 o �h� � @ sl d dl mZ d dlZd dlZd dlmZmZ ddlmZ ddl m Z d dl m m Z G dd� dej �Z dS ) � )� annotationsN)�product�starmap� )�StrPath)� Distributionc @ sp e Zd ZU dZded< d%dd�Zdd � Zd d � Zed d � �Z dd� Z edd� �Z d&d'd d!�Z d"d#� Z d$S )(� install_libz9Don't add compiled flags to filenames of non-Python filesr � distribution�return�Nonec C s* | � � | �� }|d ur| �|� d S d S �N)�build�install� byte_compile)�self�outfiles� r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/install_lib.py�run s �zinstall_lib.runc s4 � fdd�� � � D �}t|� �� �}tt� j|��S )z� Return a collections.Sized collections.Container of paths to be excluded for single_version_externally_managed installations. c 3 s$ � | ] }� � |�D ]}|V q qd S r )� _all_packages)�.0�ns_pkg�pkg�r r r � <genexpr> s � �� �z-install_lib.get_exclusions.<locals>.<genexpr>)�_get_SVEM_NSPsr �_gen_exclusion_paths�setr �_exclude_pkg_path)r � all_packages� excl_specsr r r �get_exclusions s �zinstall_lib.get_exclusionsc C s& |� d�|g }tjj| jg|�R � S )zw Given a package name and exclusion path within that package, compute the full exclusion path. �.)�split�os�path�join� install_dir)r r �exclusion_path�partsr r r r ' s z install_lib._exclude_pkg_pathc c s( � | r| V | � d�\} }}| sdS dS )zn >>> list(install_lib._all_packages('foo.bar.baz')) ['foo.bar.baz', 'foo.bar', 'foo'] r" N)� rpartition)�pkg_name�_sep�_childr r r r / s � �zinstall_lib._all_packagesc C s, | j jsg S | �d�}|j}|r| j jS g S )z� Get namespace packages (list) but only for single_version_externally_managed installations and empty otherwise. r )r �namespace_packages�get_finalized_command�!single_version_externally_managed)r � install_cmd�svemr r r r 9 s zinstall_lib._get_SVEM_NSPsc c sd � dV dV dV t td�sdS tj�ddtjj �} | d V | d V | d V | d V dS ) zk Generate file paths to be excluded for namespace packages (bytecode cache files). z __init__.pyz __init__.pycz __init__.pyo�implementationN� __pycache__z __init__.z.pycz.pyoz .opt-1.pycz .opt-2.pyc)�hasattr�sysr$ r% r& r3 � cache_tag)�baser r r r I s � z install_lib._gen_exclusion_pathsTF� �infiler �outfile�str� preserve_mode�bool�preserve_times�preserve_symlinks�level�object� list[str]c sr |sJ �|sJ �|r J �| � � � � stj�| ||�S ddlm} ddlm� g �d � ��fdd� }||||� �S ) Nr )�unpack_directory)�log�srcr< �dstc s< |� v r �� d|� dS ��d| tj�|�� ��|� |S )Nz/Skipping installation of %s (namespace package)Fzcopying %s -> %s)�warn�infor$ r% �dirname�append)rF rG ��excluderE r r r �pfx s z!install_lib.copy_tree.<locals>.pf)rF r< rG r< )r! �origr � copy_tree�setuptools.archive_utilrD � distutilsrE ) r r: r; r= r? r@ rA rD rN r rL r rP ^ s zinstall_lib.copy_treec s. t j�| �}| �� � � r� fdd�|D �S |S )Nc s g | ]}|� vr|�qS r r )r �f�rM r r � <listcomp>� s z+install_lib.get_outputs.<locals>.<listcomp>)rO r � get_outputsr! )r �outputsr rT r rV � s zinstall_lib.get_outputsN)r r )TTFr9 )r: r r; r< r= r> r? r> r@ r> rA rB r rC )�__name__� __module__� __qualname__�__doc__�__annotations__r r! r � staticmethodr r r rP rV r r r r r s" � &r )� __future__r r$ r6 � itertoolsr r �_pathr �distr � distutils.command.install_lib�commandr rO r r r r �<module> s command/__pycache__/install_scripts.cpython-310.pyc 0000644 00000005051 15030122015 0016276 0 ustar 00 o �hM � @ sh d dl mZ d dlZd dlZddlmZ ddlmZ d dlm m Z d dl m Z G dd� de j �Z dS ) � )� annotationsN� )�ensure_directory)� Distribution)�logc @ sB e Zd ZU dZded< ddd�Zddd �Zd d � Zdddd�ZdS )�install_scriptsz;Do normal script install, plus any egg_info wrapper scriptsr � distribution�return�Nonec C s t j�| � d| _d S )NF)�origr �initialize_options�no_ep��self� r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/install_scripts.pyr s z"install_scripts.initialize_optionsc C s< | � d� | jjrtj�| � ng | _| jrd S | �� d S )N�egg_info) � run_commandr �scriptsr r �run�outfilesr �_install_ep_scriptsr r r r r s zinstall_scripts.runc C s� ddl m}m} ddlm} | �d�}||j||j|j�|j|j �}| �d�}t |dd �}|j }|t j kr8|g}|�� }|j�� �|�} |�|| �� �D ]} | j| � qLd S )Nr )r � PathMetadata� )� easy_installr � build_scripts� executable)� pkg_resourcesr r � r �get_finalized_command�egg_baser �egg_name� egg_version�getattr� ScriptWriter�sysr �best�command_spec_class� from_param�get_args� as_header� write_script) r r r �ei�ei_cmd�dist�bs_cmd� exec_param�writer�cmd�argsr r r r ! s& � �z#install_scripts._install_ep_scripts�t�mode�strc G s� ddl m}m} t�d|| j� tj�| j|�}| j � |� d|v r$dnd}|� } | j sWt |� t |d| |d�� } | �|� W d � n1 sIw Y ||d | � dS dS ) z1Write an executable file to the scripts directoryr )�chmod� current_umaskzInstalling %s script to %s�bNzutf-8�w)�encodingi� )� setuptools.command.easy_installr7 r8 r �info� install_dir�os�path�joinr �append�dry_runr �open�write) r � script_name�contentsr5 �ignoredr7 r8 �targetr; �mask�fr r r r+ ; s ��z install_scripts.write_scriptN)r r )r4 )r5 r6 r r ) �__name__� __module__� __qualname__�__doc__�__annotations__r r r r+ r r r r r s r )� __future__r r? r% �_pathr r. r �!distutils.command.install_scripts�commandr r � distutilsr r r r r �<module> s command/__pycache__/build_ext.cpython-310.pyc 0000644 00000033364 15030122015 0015050 0 ustar 00 o �h�G � @ s� d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ d dl m Z d dl m Z d dlmZ d dlmZ d d lmZ d d lmZmZ d d lmZ d d lmZ d d lm Z m Z erad dl m Z n z d dl!m Z e"d� W n e#y| d dl m Z Y nw e d� d dlm$Z% dd� Z&dZ'dZ(dZ)ej*dkr�dZ(n ej+dkr�z d dl,Z,e-e,d� Z(Z'W n e#y� Y nw dd� Z.d d � Z/G d d � d e �Z e(s�ej+dkr� d(d)d$d%�Z0dS d&Z) d(d)d'd%�Z0dS )*� )� annotationsN)�Iterator��EXTENSION_SUFFIXES)�cache_from_source)�Path)� TYPE_CHECKING)� Distribution)� BaseError)� Extension�Library)�log)� new_compiler)�customize_compiler�get_config_var)� build_extzCython.Compiler.Main�LDSHARED)� _config_varsc C sl t jdkr0t�� }z dtd< dtd< dtd< t| � W t�� t�|� d S t�� t�|� w t| � d S )N�darwinz0gcc -Wl,-x -dynamiclib -undefined dynamic_lookupr z -dynamiclib�CCSHAREDz.dylib�SO)�sys�platform� _CONFIG_VARS�copyr �clear�update)�compiler�tmp� r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/command/build_ext.py� _customize_compiler_for_shlib) s � � r! F�sharedr T�nt�RTLD_NOWc C s t r| S dS )N� )� have_rtld)�sr r r �if_dlM s r( c C s. t D ]} d| v r | S | dkr| S qdS )z;Return the file extension for an abi3-compliant Extension()z.abi3z.pydNr )�suffixr r r �get_abi3_suffixQ s �r* c @ s� e Zd ZU ded< dZdZdd� Zd<d d �Zd=d d�Zd>dd�Z d?dd�Z d@dd�Z dd� Z d=dd �Z d d � Zd d � Zd=d!d"�Zd#d$� ZdAd&d'�ZdBd)d*�ZdAd+d,�ZdCd.d/�Zd0d1� Zd2d3� ZdDd=d4d5�ZdDdEd7d8�ZdFd9d:�Zd;S )Gr r � distributionFc C s2 | j d}| _ t�| � || _ |r| �� dS dS )z;Build extensions in build directory, then copy if --inplaceFN)�inplace� _build_ext�run�copy_extensions_to_source)�self� old_inplacer r r r. ` s �z build_ext.run�extr �return�tuple[str, str]c C sj | � |j�}| �|�}|�d�}d�|d d� �}|�|�}tj�|tj�|��}tj�| j |�} || fS )N�.���) �get_ext_fullname�name�get_ext_filename�split�join�get_package_dir�os�path�basename� build_lib) r0 �build_pyr2 �fullname�filename�modpath�package� package_dir� inplace_file� regular_filer r r �_get_inplace_equivalenth s z!build_ext._get_inplace_equivalent�Nonec C sp | � d�}| jD ]-}| �||�\}}tj�|�s|js$| j||| jd� |j r5| � ||�}| j ||dd� qd S )NrA )�levelT)�compile) �get_finalized_command� extensionsrI r= r> �exists�optional� copy_file�verbose� _needs_stub�_get_equivalent_stub�_write_stub_file)r0 rA r2 rG rH � inplace_stubr r r r/ r s ��z#build_ext.copy_extensions_to_source� output_file�strc C s2 t j�|�}|j�d�\}}}t j�||�� d�S �Nr5 �.py)r= r> �dirnamer8 � rpartitionr; )r0 r2 rW �dir_�_r8 r r r rT � s z build_ext._get_equivalent_stub�Iterator[tuple[str, str]]c c s� � | j sd S | �d�}| �d�jpd}| jD ]/}| �||�\}}||fV |jrE| �||�}| �||�}t||d�}t||d�} | |fV qd S )NrA � install_libr% )� optimization)r, rM �optimizerN rI rS rT �_compiled_file_name) r0 rA �optr2 rG rH rV � regular_stub� inplace_cache� output_cacher r r �_get_output_mapping� s � ��z build_ext._get_output_mappingrB c C s� t �d�}|rt jj|�d�� | }nt�| |�}td�}t|t �s&t d��|}|| j v ro| j | }t � }|j rE|rE|d t|� � | }t|t�rYt j�|�\}}| j�|t�S tro|jrot j�|�\}}t j�|d| �S |S )N�SETUPTOOLS_EXT_SUFFIXr5 � EXT_SUFFIXzwConfiguration variable EXT_SUFFIX not found for this platform and environment variable SETUPTOOLS_EXT_SUFFIX is missingzdl-)r= �getenvr> r; r: r- r9 r � isinstancerX �OSError�ext_mapr* �py_limited_api�lenr �splitext�shlib_compiler�library_filename�libtype� use_stubs�_links_to_dynamic) r0 rB �so_extrC � ext_suffixr2 � abi3_suffix�fn�dr r r r9 � s, � zbuild_ext.get_ext_filenamec C s& t �| � d | _g | _i | _d| _d S )NF)r- �initialize_optionsrr �shlibsrn � editable_mode�r0 r r r r| � s z build_ext.initialize_optionsc C s8 t �| � | jp g | _| �| j� dd� | jD �| _| jr!| �� | jD ] }| �|j�|_q$| jD ]`}|j}|| j |< || j |� d�d < | jrM| � |�pNd}|oXt oXt |t� }||_||_| �|� }|_tj�tj�| j|��}|r�||jvr�|j�|� |r�t r�tj|jvr�|j�tj� q1| j r�d| _ d S d S )Nc S s g | ] }t |t�r|�qS r )rl r ��.0r2 r r r � <listcomp>� s z.build_ext.finalize_options.<locals>.<listcomp>r5 r6 FT) r- �finalize_optionsrN �check_extensions_listr} �setup_shlib_compilerr7 r8 � _full_namern r: �links_to_dynamicru rl r rv rS r9 � _file_namer= r> r[ r; r@ � library_dirs�append�curdir�runtime_library_dirsr~ r, )r0 r2 rB �ltd�nsrC �libdirr r r r� � s4 � �zbuild_ext.finalize_optionsc C s� t | j| j| jd� }| _t|� | jd ur |�| j� | jd ur/| jD ] \}}|� ||� q$| j d ur?| j D ]}|� |� q7| j d urJ|� | j � | jd urU|�| j� | jd ur`|�| j� | jd urk|�| j� t�|�|_d S )N)r �dry_run�force)r r r� r� rr r! � include_dirs�set_include_dirs�define� define_macro�undef�undefine_macro� libraries� set_librariesr� �set_library_dirs�rpath�set_runtime_library_dirs� link_objects�set_link_objects�link_shared_object�__get__)r0 r r8 �value�macror r r r� � s* � z build_ext.setup_shlib_compilerc C s t |t�r|jS t�| |�S �N)rl r �export_symbolsr- �get_export_symbols�r0 r2 r r r r� � s z build_ext.get_export_symbolsc C sl |� � | j}z*t|t�r| j| _t�| |� |jr,| �d�j }| � ||� W || _d S W || _d S || _w )NrA ) � _convert_pyx_sources_to_langr rl r rr r- �build_extensionrS rM r@ � write_stub)r0 r2 � _compilerr@ r r r r� s �zbuild_ext.build_extensionc sP t �dd� | jD ��� d�|j�d�dd� dg ��t� �fdd�|jD ��S ) z?Return true if 'ext' links to a dynamic lib in the same packagec S s g | ]}|j �qS r )r� )r� �libr r r r� s z.build_ext.links_to_dynamic.<locals>.<listcomp>r5 Nr6 r% c 3 s � | ] }�| � v V qd S r� r )r� �libname��libnames�pkgr r � <genexpr> � � z-build_ext.links_to_dynamic.<locals>.<genexpr>)�dict�fromkeysr} r; r� r: �anyr� r� r r� r r� s zbuild_ext.links_to_dynamic� list[str]c C s g t �| ��| �� �S r� )r- �get_source_files�_get_internal_dependsr r r r r� s zbuild_ext.get_source_files� Iterator[str]c c s� � t | jjptj��� }dd� | jD �}ddd �}|D ]O}t |�}|�� r+||d � qd |jv r6||d � qz || jd d�}W n t yN ||d� Y qw z|� |� W n t yd ||d� Y qw |� � V qdS )zAYield ``ext.depends`` that are contained by the project directoryc s s � | ] }|j D ]}|V qqd S r� )�depends)r� r2 �depr r r r� s � z2build_ext._get_internal_depends.<locals>.<genexpr>� orig_pathrX �reasonr3 rJ c S s t �d| |� d S )NzJdependency %s won't be automatically included in the manifest: the path %s)r �info)r� r� r r r �skip s �z-build_ext._get_internal_depends.<locals>.skipzmust be relativez..zcan't have `..` segmentsT)�strictz doesn't existz must be inside the project rootN)r� rX r� rX r3 rJ ) r r+ �src_rootr= r� �resolverN � is_absolute�partsrm � relative_to� ValueError�as_posix)r0 � project_rootr� r� r� r> �resolvedr r r r� s4 � � � �z build_ext._get_internal_dependsc C s, | j r t| �� �� �S tt�| �| �� �S r� )r, �list�get_output_mapping�keys�sortedr- � get_outputs� _build_ext__get_stubs_outputsr r r r r� A s zbuild_ext.get_outputs�dict[str, str]c C s | � � }tt|dd� d��S )z1See :class:`setuptools.commands.build.SubCommand`c S s | d S )Nr r )�xr r r �<lambda>I s z.build_ext.get_output_mapping.<locals>.<lambda>)�key)rh r� r� )r0 �mappingr r r r� F s z build_ext.get_output_mappingc s6 � fdd�� j D �}t�|� �� �}tdd� |D ��S )Nc 3 s4 � | ]}|j rtjj� jg|j�d ��R � V qdS )r5 N)rS r= r> r; r@ r� r: r� r r r r� M s � � �z0build_ext.__get_stubs_outputs.<locals>.<genexpr>c s s � | ] \}}|| V qd S r� r )r� �base�fnextr r r r� T r� )rN � itertools�product�!_build_ext__get_output_extensionsr� )r0 � ns_ext_bases�pairsr r r �__get_stubs_outputsK s �z build_ext.__get_stubs_outputsc c s( � dV dV | � d�jrdV d S d S )NrZ z.pycrA z.pyo)rM rb r r r r �__get_output_extensionsV s � �z!build_ext.__get_output_extensionsc C s2 t jj|g|j�d��R � d }| �|||� d S rY )r= r> r; r� r: rU )r0 � output_dirr2 rL � stub_filer r r r� \ s zbuild_ext.write_stubr� c C s� t �d|j|� |rtj�|�rt|d ��| jsbt|ddd��:}d� ddd t d � d tj� |j ��d �d ddt d�dddt d�dddddt d�dd d g�}|� |� W d � n1 s]w Y |rk| �|� d S d S ) Nz writing stub loader for %s to %sz already exists! Please delete.�wzutf-8)�encoding� zdef __bootstrap__():z- global __bootstrap__, __file__, __loader__z0 import sys, os, pkg_resources, importlib.utilz, dlz7 __file__ = pkg_resources.resource_filename(__name__,�)z del __bootstrap__z if '__loader__' in globals():z del __loader__z# old_flags = sys.getdlopenflags()z old_dir = os.getcwd()z try:z( os.chdir(os.path.dirname(__file__))z$ sys.setdlopenflags(dl.RTLD_NOW)z3 spec = importlib.util.spec_from_file_location(z# __name__, __file__)z0 mod = importlib.util.module_from_spec(spec)z! spec.loader.exec_module(mod)z finally:z" sys.setdlopenflags(old_flags)z os.chdir(old_dir)z__bootstrap__()r% )r r� r� r= r> rO r r� �openr; r( r? r� �write�_compile_and_remove_stub)r0 r� r2 rL �f�contentr r r rU ` sF �� ��zbuild_ext._write_stub_filec C sp ddl m} ||gdd| jd� | �d�j}|dkr$||g|d| jd� tj�|�r4| js6t�|� d S d S d S )Nr )� byte_compileT)rb r� r� r` ) �distutils.utilr� r� rM rb r= r> rO �unlink)r0 r� r� rb r r r r� � s ��z"build_ext._compile_and_remove_stubN)r2 r r3 r4 )r3 rJ )r2 r rW rX r3 rX )r3 r_ )rB rX r3 rX )r3 r� )r3 r� )r3 r� )F)r� rX r2 r )r� rX )�__name__� __module__� __qualname__�__annotations__r~ r, r. rI r/ rT rh r9 r| r� r� r� r� r� r� r� r� r� r� r� r� rU r� r r r r r [ s2 & "r �debug�boolr3 rJ c C s( | � | j||||||||| | | | � d S r� )�link�SHARED_LIBRARY) r0 �objects�output_libnamer� r� r� r� r� r� � extra_preargs�extra_postargs� build_temp� target_langr r r r� � s �r� �staticc C s^ |d u sJ �t j�|�\}} t j�| �\}}| �d��d�r$|dd � }| �||||| � d S )Nr� r� � )r= r> r: rq rs � startswith�create_static_lib)r0 r� r� r� r� r� r� r� r� r� r� r� r� rC r? �_extr r r r� � s ) NNNNNFNNNN)r� r� r3 rJ )1� __future__r r� r= r �collections.abcr �importlib.machineryr �importlib.utilr rc �pathlibr �typingr �setuptools.distr �setuptools.errorsr �setuptools.extensionr r � distutilsr �distutils.ccompilerr �distutils.sysconfigr r �distutils.command.build_extr r- �Cython.Distutils.build_ext� __import__� ImportErrorr r r! r& ru rt r r8 �dl�hasattrr( r* r� r r r r �<module> s� � � 9�!� command/dist_info.py 0000644 00000006572 15030122015 0010511 0 ustar 00 """ Create a dist_info directory As defined in the wheel specification """ import os import shutil from contextlib import contextmanager from pathlib import Path from typing import cast from .. import _normalization from .._shutil import rmdir as _rm from .egg_info import egg_info as egg_info_cls from distutils import log from distutils.core import Command class dist_info(Command): """ This command is private and reserved for internal use of setuptools, users should rely on ``setuptools.build_meta`` APIs. """ description = "DO NOT CALL DIRECTLY, INTERNAL ONLY: create .dist-info directory" user_options = [ ( 'output-dir=', 'o', "directory inside of which the .dist-info will be" "created [default: top of the source tree]", ), ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), ('tag-build=', 'b', "Specify explicit tag to add to version number"), ('no-date', 'D', "Don't include date stamp [default]"), ('keep-egg-info', None, "*TRANSITIONAL* will be removed in the future"), ] boolean_options = ['tag-date', 'keep-egg-info'] negative_opt = {'no-date': 'tag-date'} def initialize_options(self): self.output_dir = None self.name = None self.dist_info_dir = None self.tag_date = None self.tag_build = None self.keep_egg_info = False def finalize_options(self) -> None: dist = self.distribution project_dir = dist.src_root or os.curdir self.output_dir = Path(self.output_dir or project_dir) egg_info = cast(egg_info_cls, self.reinitialize_command("egg_info")) egg_info.egg_base = str(self.output_dir) if self.tag_date: egg_info.tag_date = self.tag_date else: self.tag_date = egg_info.tag_date if self.tag_build: egg_info.tag_build = self.tag_build else: self.tag_build = egg_info.tag_build egg_info.finalize_options() self.egg_info = egg_info name = _normalization.safer_name(dist.get_name()) version = _normalization.safer_best_effort_version(dist.get_version()) self.name = f"{name}-{version}" self.dist_info_dir = os.path.join(self.output_dir, f"{self.name}.dist-info") @contextmanager def _maybe_bkp_dir(self, dir_path: str, requires_bkp: bool): if requires_bkp: bkp_name = f"{dir_path}.__bkp__" _rm(bkp_name, ignore_errors=True) shutil.copytree(dir_path, bkp_name, dirs_exist_ok=True, symlinks=True) try: yield finally: _rm(dir_path, ignore_errors=True) shutil.move(bkp_name, dir_path) else: yield def run(self) -> None: self.output_dir.mkdir(parents=True, exist_ok=True) self.egg_info.run() egg_info_dir = self.egg_info.egg_info assert os.path.isdir(egg_info_dir), ".egg-info dir should have been created" log.info(f"creating '{os.path.abspath(self.dist_info_dir)}'") bdist_wheel = self.get_finalized_command('bdist_wheel') # TODO: if bdist_wheel if merged into setuptools, just add "keep_egg_info" there with self._maybe_bkp_dir(egg_info_dir, self.keep_egg_info): bdist_wheel.egg2dist(egg_info_dir, self.dist_info_dir) command/build.py 0000644 00000013644 15030122015 0007630 0 ustar 00 from __future__ import annotations from typing import Protocol from ..dist import Distribution from distutils.command.build import build as _build _ORIGINAL_SUBCOMMANDS = {"build_py", "build_clib", "build_ext", "build_scripts"} class build(_build): distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution # copy to avoid sharing the object with parent class sub_commands = _build.sub_commands[:] class SubCommand(Protocol): """In order to support editable installations (see :pep:`660`) all build subcommands **SHOULD** implement this protocol. They also **MUST** inherit from ``setuptools.Command``. When creating an :pep:`editable wheel <660>`, ``setuptools`` will try to evaluate custom ``build`` subcommands using the following procedure: 1. ``setuptools`` will set the ``editable_mode`` attribute to ``True`` 2. ``setuptools`` will execute the ``run()`` command. .. important:: Subcommands **SHOULD** take advantage of ``editable_mode=True`` to adequate its behaviour or perform optimisations. For example, if a subcommand doesn't need to generate an extra file and all it does is to copy a source file into the build directory, ``run()`` **SHOULD** simply "early return". Similarly, if the subcommand creates files that would be placed alongside Python files in the final distribution, during an editable install the command **SHOULD** generate these files "in place" (i.e. write them to the original source directory, instead of using the build directory). Note that ``get_output_mapping()`` should reflect that and include mappings for "in place" builds accordingly. 3. ``setuptools`` use any knowledge it can derive from the return values of ``get_outputs()`` and ``get_output_mapping()`` to create an editable wheel. When relevant ``setuptools`` **MAY** attempt to use file links based on the value of ``get_output_mapping()``. Alternatively, ``setuptools`` **MAY** attempt to use :doc:`import hooks <python:reference/import>` to redirect any attempt to import to the directory with the original source code and other files built in place. Please note that custom sub-commands **SHOULD NOT** rely on ``run()`` being executed (or not) to provide correct return values for ``get_outputs()``, ``get_output_mapping()`` or ``get_source_files()``. The ``get_*`` methods should work independently of ``run()``. """ editable_mode: bool = False """Boolean flag that will be set to ``True`` when setuptools is used for an editable installation (see :pep:`660`). Implementations **SHOULD** explicitly set the default value of this attribute to ``False``. When subcommands run, they can use this flag to perform optimizations or change their behaviour accordingly. """ build_lib: str """String representing the directory where the build artifacts should be stored, e.g. ``build/lib``. For example, if a distribution wants to provide a Python module named ``pkg.mod``, then a corresponding file should be written to ``{build_lib}/package/module.py``. A way of thinking about this is that the files saved under ``build_lib`` would be eventually copied to one of the directories in :obj:`site.PREFIXES` upon installation. A command that produces platform-independent files (e.g. compiling text templates into Python functions), **CAN** initialize ``build_lib`` by copying its value from the ``build_py`` command. On the other hand, a command that produces platform-specific files **CAN** initialize ``build_lib`` by copying its value from the ``build_ext`` command. In general this is done inside the ``finalize_options`` method with the help of the ``set_undefined_options`` command:: def finalize_options(self): self.set_undefined_options("build_py", ("build_lib", "build_lib")) ... """ def initialize_options(self) -> None: """(Required by the original :class:`setuptools.Command` interface)""" ... def finalize_options(self) -> None: """(Required by the original :class:`setuptools.Command` interface)""" ... def run(self) -> None: """(Required by the original :class:`setuptools.Command` interface)""" ... def get_source_files(self) -> list[str]: """ Return a list of all files that are used by the command to create the expected outputs. For example, if your build command transpiles Java files into Python, you should list here all the Java files. The primary purpose of this function is to help populating the ``sdist`` with all the files necessary to build the distribution. All files should be strings relative to the project root directory. """ ... def get_outputs(self) -> list[str]: """ Return a list of files intended for distribution as they would have been produced by the build. These files should be strings in the form of ``"{build_lib}/destination/file/path"``. .. note:: The return value of ``get_output()`` should include all files used as keys in ``get_output_mapping()`` plus files that are generated during the build and don't correspond to any source file already present in the project. """ ... def get_output_mapping(self) -> dict[str, str]: """ Return a mapping between destination files as they would be produced by the build (dict keys) into the respective existing (source) files (dict values). Existing (source) files should be represented as strings relative to the project root directory. Destination files should be strings in the form of ``"{build_lib}/destination/file/path"``. """ ... command/install_egg_info.py 0000644 00000004033 15030122015 0012024 0 ustar 00 import os from setuptools import Command, namespaces from setuptools.archive_util import unpack_archive from .._path import ensure_directory from distutils import dir_util, log class install_egg_info(namespaces.Installer, Command): """Install an .egg-info directory for the package""" description = "Install an .egg-info directory for the package" user_options = [ ('install-dir=', 'd', "directory to install to"), ] def initialize_options(self): self.install_dir = None def finalize_options(self) -> None: self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) ei_cmd = self.get_finalized_command("egg_info") basename = f"{ei_cmd._get_egg_basename()}.egg-info" self.source = ei_cmd.egg_info self.target = os.path.join(self.install_dir, basename) self.outputs: list[str] = [] def run(self) -> None: self.run_command('egg_info') if os.path.isdir(self.target) and not os.path.islink(self.target): dir_util.remove_tree(self.target, dry_run=self.dry_run) elif os.path.exists(self.target): self.execute(os.unlink, (self.target,), "Removing " + self.target) if not self.dry_run: ensure_directory(self.target) self.execute(self.copytree, (), f"Copying {self.source} to {self.target}") self.install_namespaces() def get_outputs(self): return self.outputs def copytree(self) -> None: # Copy the .egg-info tree to site-packages def skimmer(src, dst): # filter out source-control directories; note that 'src' is always # a '/'-separated path, regardless of platform. 'dst' is a # platform-specific path. for skip in '.svn/', 'CVS/': if src.startswith(skip) or '/' + skip in src: return None self.outputs.append(dst) log.debug("Copying %s to %s", src, dst) return dst unpack_archive(self.source, self.target, skimmer) command/develop.py 0000644 00000015346 15030122015 0010170 0 ustar 00 import glob import os import setuptools from setuptools import _normalization, _path, namespaces from setuptools.command.easy_install import easy_install from ..unicode_utils import _read_utf8_with_fallback from distutils import log from distutils.errors import DistutilsOptionError from distutils.util import convert_path class develop(namespaces.DevelopInstaller, easy_install): """Set up package for development""" description = "install package in 'development mode'" user_options = easy_install.user_options + [ ("uninstall", "u", "Uninstall this source package"), ("egg-path=", None, "Set the path to be used in the .egg-link file"), ] boolean_options = easy_install.boolean_options + ['uninstall'] command_consumes_arguments = False # override base def run(self): if self.uninstall: self.multi_version = True self.uninstall_link() self.uninstall_namespaces() else: self.install_for_development() self.warn_deprecated_options() def initialize_options(self): self.uninstall = None self.egg_path = None easy_install.initialize_options(self) self.setup_path = None self.always_copy_from = '.' # always copy eggs installed in curdir def finalize_options(self) -> None: import pkg_resources ei = self.get_finalized_command("egg_info") self.args = [ei.egg_name] easy_install.finalize_options(self) self.expand_basedirs() self.expand_dirs() # pick up setup-dir .egg files only: no .egg-info self.package_index.scan(glob.glob('*.egg')) egg_link_fn = ( _normalization.filename_component_broken(ei.egg_name) + '.egg-link' ) self.egg_link = os.path.join(self.install_dir, egg_link_fn) self.egg_base = ei.egg_base if self.egg_path is None: self.egg_path = os.path.abspath(ei.egg_base) target = _path.normpath(self.egg_base) egg_path = _path.normpath(os.path.join(self.install_dir, self.egg_path)) if egg_path != target: raise DistutilsOptionError( "--egg-path must be a relative path from the install" " directory to " + target ) # Make a distribution for the package's source self.dist = pkg_resources.Distribution( target, pkg_resources.PathMetadata(target, os.path.abspath(ei.egg_info)), project_name=ei.egg_name, ) self.setup_path = self._resolve_setup_path( self.egg_base, self.install_dir, self.egg_path, ) @staticmethod def _resolve_setup_path(egg_base, install_dir, egg_path): """ Generate a path from egg_base back to '.' where the setup script resides and ensure that path points to the setup path from $install_dir/$egg_path. """ path_to_setup = egg_base.replace(os.sep, '/').rstrip('/') if path_to_setup != os.curdir: path_to_setup = '../' * (path_to_setup.count('/') + 1) resolved = _path.normpath(os.path.join(install_dir, egg_path, path_to_setup)) curdir = _path.normpath(os.curdir) if resolved != curdir: raise DistutilsOptionError( "Can't get a consistent path to setup script from" " installation directory", resolved, curdir, ) return path_to_setup def install_for_development(self) -> None: self.run_command('egg_info') # Build extensions in-place self.reinitialize_command('build_ext', inplace=True) self.run_command('build_ext') if setuptools.bootstrap_install_from: self.easy_install(setuptools.bootstrap_install_from) setuptools.bootstrap_install_from = None self.install_namespaces() # create an .egg-link in the installation dir, pointing to our egg log.info("Creating %s (link to %s)", self.egg_link, self.egg_base) if not self.dry_run: with open(self.egg_link, "w", encoding="utf-8") as f: f.write(self.egg_path + "\n" + self.setup_path) # postprocess the installed distro, fixing up .pth, installing scripts, # and handling requirements self.process_distribution(None, self.dist, not self.no_deps) def uninstall_link(self) -> None: if os.path.exists(self.egg_link): log.info("Removing %s (link to %s)", self.egg_link, self.egg_base) contents = [ line.rstrip() for line in _read_utf8_with_fallback(self.egg_link).splitlines() ] if contents not in ([self.egg_path], [self.egg_path, self.setup_path]): log.warn("Link points to %s: uninstall aborted", contents) return if not self.dry_run: os.unlink(self.egg_link) if not self.dry_run: self.update_pth(self.dist) # remove any .pth link to us if self.distribution.scripts: # XXX should also check for entry point scripts! log.warn("Note: you must uninstall or replace scripts manually!") def install_egg_scripts(self, dist): if dist is not self.dist: # Installing a dependency, so fall back to normal behavior return easy_install.install_egg_scripts(self, dist) # create wrapper scripts in the script dir, pointing to dist.scripts # new-style... self.install_wrapper_scripts(dist) # ...and old-style for script_name in self.distribution.scripts or []: script_path = os.path.abspath(convert_path(script_name)) script_name = os.path.basename(script_path) script_text = _read_utf8_with_fallback(script_path) self.install_script(dist, script_name, script_text, script_path) return None def install_wrapper_scripts(self, dist): dist = VersionlessRequirement(dist) return easy_install.install_wrapper_scripts(self, dist) class VersionlessRequirement: """ Adapt a pkg_resources.Distribution to simply return the project name as the 'requirement' so that scripts will work across multiple versions. >>> from pkg_resources import Distribution >>> dist = Distribution(project_name='foo', version='1.0') >>> str(dist.as_requirement()) 'foo==1.0' >>> adapted_dist = VersionlessRequirement(dist) >>> str(adapted_dist.as_requirement()) 'foo' """ def __init__(self, dist) -> None: self.__dist = dist def __getattr__(self, name: str): return getattr(self.__dist, name) def as_requirement(self): return self.project_name command/build_ext.py 0000644 00000043711 15030122015 0010506 0 ustar 00 from __future__ import annotations import itertools import os import sys from collections.abc import Iterator from importlib.machinery import EXTENSION_SUFFIXES from importlib.util import cache_from_source as _compiled_file_name from pathlib import Path from typing import TYPE_CHECKING from setuptools.dist import Distribution from setuptools.errors import BaseError from setuptools.extension import Extension, Library from distutils import log from distutils.ccompiler import new_compiler from distutils.sysconfig import customize_compiler, get_config_var if TYPE_CHECKING: # Cython not installed on CI tests, causing _build_ext to be `Any` from distutils.command.build_ext import build_ext as _build_ext else: try: # Attempt to use Cython for building extensions, if available from Cython.Distutils.build_ext import build_ext as _build_ext # Additionally, assert that the compiler module will load # also. Ref #1229. __import__('Cython.Compiler.Main') except ImportError: from distutils.command.build_ext import build_ext as _build_ext # make sure _config_vars is initialized get_config_var("LDSHARED") # Not publicly exposed in typeshed distutils stubs, but this is done on purpose # See https://github.com/pypa/setuptools/pull/4228#issuecomment-1959856400 from distutils.sysconfig import _config_vars as _CONFIG_VARS # noqa: E402 def _customize_compiler_for_shlib(compiler): if sys.platform == "darwin": # building .dylib requires additional compiler flags on OSX; here we # temporarily substitute the pyconfig.h variables so that distutils' # 'customize_compiler' uses them before we build the shared libraries. tmp = _CONFIG_VARS.copy() try: # XXX Help! I don't have any idea whether these are right... _CONFIG_VARS['LDSHARED'] = ( "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup" ) _CONFIG_VARS['CCSHARED'] = " -dynamiclib" _CONFIG_VARS['SO'] = ".dylib" customize_compiler(compiler) finally: _CONFIG_VARS.clear() _CONFIG_VARS.update(tmp) else: customize_compiler(compiler) have_rtld = False use_stubs = False libtype = 'shared' if sys.platform == "darwin": use_stubs = True elif os.name != 'nt': try: import dl # type: ignore[import-not-found] # https://github.com/python/mypy/issues/13002 use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW') except ImportError: pass def if_dl(s): return s if have_rtld else '' def get_abi3_suffix(): """Return the file extension for an abi3-compliant Extension()""" for suffix in EXTENSION_SUFFIXES: if '.abi3' in suffix: # Unix return suffix elif suffix == '.pyd': # Windows return suffix return None class build_ext(_build_ext): distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution editable_mode = False inplace = False def run(self): """Build extensions in build directory, then copy if --inplace""" old_inplace, self.inplace = self.inplace, False _build_ext.run(self) self.inplace = old_inplace if old_inplace: self.copy_extensions_to_source() def _get_inplace_equivalent(self, build_py, ext: Extension) -> tuple[str, str]: fullname = self.get_ext_fullname(ext.name) filename = self.get_ext_filename(fullname) modpath = fullname.split('.') package = '.'.join(modpath[:-1]) package_dir = build_py.get_package_dir(package) inplace_file = os.path.join(package_dir, os.path.basename(filename)) regular_file = os.path.join(self.build_lib, filename) return (inplace_file, regular_file) def copy_extensions_to_source(self) -> None: build_py = self.get_finalized_command('build_py') for ext in self.extensions: inplace_file, regular_file = self._get_inplace_equivalent(build_py, ext) # Always copy, even if source is older than destination, to ensure # that the right extensions for the current Python/platform are # used. if os.path.exists(regular_file) or not ext.optional: self.copy_file(regular_file, inplace_file, level=self.verbose) if ext._needs_stub: inplace_stub = self._get_equivalent_stub(ext, inplace_file) self._write_stub_file(inplace_stub, ext, compile=True) # Always compile stub and remove the original (leave the cache behind) # (this behaviour was observed in previous iterations of the code) def _get_equivalent_stub(self, ext: Extension, output_file: str) -> str: dir_ = os.path.dirname(output_file) _, _, name = ext.name.rpartition(".") return f"{os.path.join(dir_, name)}.py" def _get_output_mapping(self) -> Iterator[tuple[str, str]]: if not self.inplace: return build_py = self.get_finalized_command('build_py') opt = self.get_finalized_command('install_lib').optimize or "" for ext in self.extensions: inplace_file, regular_file = self._get_inplace_equivalent(build_py, ext) yield (regular_file, inplace_file) if ext._needs_stub: # This version of `build_ext` always builds artifacts in another dir, # when "inplace=True" is given it just copies them back. # This is done in the `copy_extensions_to_source` function, which # always compile stub files via `_compile_and_remove_stub`. # At the end of the process, a `.pyc` stub file is created without the # corresponding `.py`. inplace_stub = self._get_equivalent_stub(ext, inplace_file) regular_stub = self._get_equivalent_stub(ext, regular_file) inplace_cache = _compiled_file_name(inplace_stub, optimization=opt) output_cache = _compiled_file_name(regular_stub, optimization=opt) yield (output_cache, inplace_cache) def get_ext_filename(self, fullname: str) -> str: so_ext = os.getenv('SETUPTOOLS_EXT_SUFFIX') if so_ext: filename = os.path.join(*fullname.split('.')) + so_ext else: filename = _build_ext.get_ext_filename(self, fullname) ext_suffix = get_config_var('EXT_SUFFIX') if not isinstance(ext_suffix, str): raise OSError( "Configuration variable EXT_SUFFIX not found for this platform " "and environment variable SETUPTOOLS_EXT_SUFFIX is missing" ) so_ext = ext_suffix if fullname in self.ext_map: ext = self.ext_map[fullname] abi3_suffix = get_abi3_suffix() if ext.py_limited_api and abi3_suffix: # Use abi3 filename = filename[: -len(so_ext)] + abi3_suffix if isinstance(ext, Library): fn, ext = os.path.splitext(filename) return self.shlib_compiler.library_filename(fn, libtype) elif use_stubs and ext._links_to_dynamic: d, fn = os.path.split(filename) return os.path.join(d, 'dl-' + fn) return filename def initialize_options(self): _build_ext.initialize_options(self) self.shlib_compiler = None self.shlibs = [] self.ext_map = {} self.editable_mode = False def finalize_options(self) -> None: _build_ext.finalize_options(self) self.extensions = self.extensions or [] self.check_extensions_list(self.extensions) self.shlibs = [ext for ext in self.extensions if isinstance(ext, Library)] if self.shlibs: self.setup_shlib_compiler() for ext in self.extensions: ext._full_name = self.get_ext_fullname(ext.name) for ext in self.extensions: fullname = ext._full_name self.ext_map[fullname] = ext # distutils 3.1 will also ask for module names # XXX what to do with conflicts? self.ext_map[fullname.split('.')[-1]] = ext ltd = self.shlibs and self.links_to_dynamic(ext) or False ns = ltd and use_stubs and not isinstance(ext, Library) ext._links_to_dynamic = ltd ext._needs_stub = ns filename = ext._file_name = self.get_ext_filename(fullname) libdir = os.path.dirname(os.path.join(self.build_lib, filename)) if ltd and libdir not in ext.library_dirs: ext.library_dirs.append(libdir) if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs: ext.runtime_library_dirs.append(os.curdir) if self.editable_mode: self.inplace = True def setup_shlib_compiler(self): compiler = self.shlib_compiler = new_compiler( compiler=self.compiler, dry_run=self.dry_run, force=self.force ) _customize_compiler_for_shlib(compiler) if self.include_dirs is not None: compiler.set_include_dirs(self.include_dirs) if self.define is not None: # 'define' option is a list of (name,value) tuples for name, value in self.define: compiler.define_macro(name, value) if self.undef is not None: for macro in self.undef: compiler.undefine_macro(macro) if self.libraries is not None: compiler.set_libraries(self.libraries) if self.library_dirs is not None: compiler.set_library_dirs(self.library_dirs) if self.rpath is not None: compiler.set_runtime_library_dirs(self.rpath) if self.link_objects is not None: compiler.set_link_objects(self.link_objects) # hack so distutils' build_extension() builds a library instead compiler.link_shared_object = link_shared_object.__get__(compiler) # type: ignore[method-assign] def get_export_symbols(self, ext): if isinstance(ext, Library): return ext.export_symbols return _build_ext.get_export_symbols(self, ext) def build_extension(self, ext) -> None: ext._convert_pyx_sources_to_lang() _compiler = self.compiler try: if isinstance(ext, Library): self.compiler = self.shlib_compiler _build_ext.build_extension(self, ext) if ext._needs_stub: build_lib = self.get_finalized_command('build_py').build_lib self.write_stub(build_lib, ext) finally: self.compiler = _compiler def links_to_dynamic(self, ext): """Return true if 'ext' links to a dynamic lib in the same package""" # XXX this should check to ensure the lib is actually being built # XXX as dynamic, and not just using a locally-found version or a # XXX static-compiled version libnames = dict.fromkeys([lib._full_name for lib in self.shlibs]) pkg = '.'.join(ext._full_name.split('.')[:-1] + ['']) return any(pkg + libname in libnames for libname in ext.libraries) def get_source_files(self) -> list[str]: return [*_build_ext.get_source_files(self), *self._get_internal_depends()] def _get_internal_depends(self) -> Iterator[str]: """Yield ``ext.depends`` that are contained by the project directory""" project_root = Path(self.distribution.src_root or os.curdir).resolve() depends = (dep for ext in self.extensions for dep in ext.depends) def skip(orig_path: str, reason: str) -> None: log.info( "dependency %s won't be automatically " "included in the manifest: the path %s", orig_path, reason, ) for dep in depends: path = Path(dep) if path.is_absolute(): skip(dep, "must be relative") continue if ".." in path.parts: skip(dep, "can't have `..` segments") continue try: resolved = (project_root / path).resolve(strict=True) except OSError: skip(dep, "doesn't exist") continue try: resolved.relative_to(project_root) except ValueError: skip(dep, "must be inside the project root") continue yield path.as_posix() def get_outputs(self) -> list[str]: if self.inplace: return list(self.get_output_mapping().keys()) return sorted(_build_ext.get_outputs(self) + self.__get_stubs_outputs()) def get_output_mapping(self) -> dict[str, str]: """See :class:`setuptools.commands.build.SubCommand`""" mapping = self._get_output_mapping() return dict(sorted(mapping, key=lambda x: x[0])) def __get_stubs_outputs(self): # assemble the base name for each extension that needs a stub ns_ext_bases = ( os.path.join(self.build_lib, *ext._full_name.split('.')) for ext in self.extensions if ext._needs_stub ) # pair each base with the extension pairs = itertools.product(ns_ext_bases, self.__get_output_extensions()) return list(base + fnext for base, fnext in pairs) def __get_output_extensions(self): yield '.py' yield '.pyc' if self.get_finalized_command('build_py').optimize: yield '.pyo' def write_stub(self, output_dir, ext, compile=False) -> None: stub_file = os.path.join(output_dir, *ext._full_name.split('.')) + '.py' self._write_stub_file(stub_file, ext, compile) def _write_stub_file(self, stub_file: str, ext: Extension, compile=False): log.info("writing stub loader for %s to %s", ext._full_name, stub_file) if compile and os.path.exists(stub_file): raise BaseError(stub_file + " already exists! Please delete.") if not self.dry_run: with open(stub_file, 'w', encoding="utf-8") as f: content = '\n'.join([ "def __bootstrap__():", " global __bootstrap__, __file__, __loader__", " import sys, os, pkg_resources, importlib.util" + if_dl(", dl"), " __file__ = pkg_resources.resource_filename" f"(__name__,{os.path.basename(ext._file_name)!r})", " del __bootstrap__", " if '__loader__' in globals():", " del __loader__", if_dl(" old_flags = sys.getdlopenflags()"), " old_dir = os.getcwd()", " try:", " os.chdir(os.path.dirname(__file__))", if_dl(" sys.setdlopenflags(dl.RTLD_NOW)"), " spec = importlib.util.spec_from_file_location(", " __name__, __file__)", " mod = importlib.util.module_from_spec(spec)", " spec.loader.exec_module(mod)", " finally:", if_dl(" sys.setdlopenflags(old_flags)"), " os.chdir(old_dir)", "__bootstrap__()", "", # terminal \n ]) f.write(content) if compile: self._compile_and_remove_stub(stub_file) def _compile_and_remove_stub(self, stub_file: str): from distutils.util import byte_compile byte_compile([stub_file], optimize=0, force=True, dry_run=self.dry_run) optimize = self.get_finalized_command('install_lib').optimize if optimize > 0: byte_compile( [stub_file], optimize=optimize, force=True, dry_run=self.dry_run, ) if os.path.exists(stub_file) and not self.dry_run: os.unlink(stub_file) if use_stubs or os.name == 'nt': # Build shared libraries # def link_shared_object( self, objects, output_libname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug: bool = False, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None, ) -> None: self.link( self.SHARED_LIBRARY, objects, output_libname, output_dir, libraries, library_dirs, runtime_library_dirs, export_symbols, debug, extra_preargs, extra_postargs, build_temp, target_lang, ) else: # Build static libraries everywhere else libtype = 'static' def link_shared_object( self, objects, output_libname, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug: bool = False, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None, ) -> None: # XXX we need to either disallow these attrs on Library instances, # or warn/abort here if set, or something... # libraries=None, library_dirs=None, runtime_library_dirs=None, # export_symbols=None, extra_preargs=None, extra_postargs=None, # build_temp=None assert output_dir is None # distutils build_ext doesn't pass this output_dir, filename = os.path.split(output_libname) basename, _ext = os.path.splitext(filename) if self.library_filename("x").startswith('lib'): # strip 'lib' prefix; this is kludgy if some platform uses # a different prefix basename = basename[3:] self.create_static_lib(objects, basename, output_dir, debug, target_lang) command/saveopts.py 0000644 00000001264 15030122015 0010370 0 ustar 00 from setuptools.command.setopt import edit_config, option_base class saveopts(option_base): """Save command-line options to a file""" description = "save supplied options to setup.cfg or other config file" def run(self) -> None: dist = self.distribution settings: dict[str, dict[str, str]] = {} for cmd in dist.command_options: if cmd == 'saveopts': continue # don't save our own options! for opt, (src, val) in dist.get_option_dict(cmd).items(): if src == "command line": settings.setdefault(cmd, {})[opt] = val edit_config(self.filename, settings, self.dry_run) command/rotate.py 0000644 00000004213 15030122015 0010017 0 ustar 00 from __future__ import annotations import os from typing import ClassVar from .. import Command, _shutil from distutils import log from distutils.errors import DistutilsOptionError from distutils.util import convert_path class rotate(Command): """Delete older distributions""" description = "delete older distributions, keeping N newest files" user_options = [ ('match=', 'm', "patterns to match (required)"), ('dist-dir=', 'd', "directory where the distributions are"), ('keep=', 'k', "number of matching distributions to keep"), ] boolean_options: ClassVar[list[str]] = [] def initialize_options(self): self.match = None self.dist_dir = None self.keep = None def finalize_options(self) -> None: if self.match is None: raise DistutilsOptionError( "Must specify one or more (comma-separated) match patterns " "(e.g. '.zip' or '.egg')" ) if self.keep is None: raise DistutilsOptionError("Must specify number of files to keep") try: self.keep = int(self.keep) except ValueError as e: raise DistutilsOptionError("--keep must be an integer") from e if isinstance(self.match, str): self.match = [convert_path(p.strip()) for p in self.match.split(',')] self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) def run(self) -> None: self.run_command("egg_info") from glob import glob for pattern in self.match: pattern = self.distribution.get_name() + '*' + pattern files = glob(os.path.join(self.dist_dir, pattern)) files = [(os.path.getmtime(f), f) for f in files] files.sort() files.reverse() log.info("%d file(s) matching %s", len(files), pattern) files = files[self.keep :] for t, f in files: log.info("Deleting %s", f) if not self.dry_run: if os.path.isdir(f): _shutil.rmtree(f) else: os.unlink(f) command/_requirestxt.py 0000644 00000010204 15030122015 0011254 0 ustar 00 """Helper code used to generate ``requires.txt`` files in the egg-info directory. The ``requires.txt`` file has an specific format: - Environment markers need to be part of the section headers and should not be part of the requirement spec itself. See https://setuptools.pypa.io/en/latest/deprecated/python_eggs.html#requires-txt """ from __future__ import annotations import io from collections import defaultdict from collections.abc import Mapping from itertools import filterfalse from typing import TypeVar from jaraco.text import yield_lines from packaging.requirements import Requirement from .. import _reqs from .._reqs import _StrOrIter # dict can work as an ordered set _T = TypeVar("_T") _Ordered = dict[_T, None] def _prepare( install_requires: _StrOrIter, extras_require: Mapping[str, _StrOrIter] ) -> tuple[list[str], dict[str, list[str]]]: """Given values for ``install_requires`` and ``extras_require`` create modified versions in a way that can be written in ``requires.txt`` """ extras = _convert_extras_requirements(extras_require) return _move_install_requirements_markers(install_requires, extras) def _convert_extras_requirements( extras_require: Mapping[str, _StrOrIter], ) -> defaultdict[str, _Ordered[Requirement]]: """ Convert requirements in `extras_require` of the form `"extra": ["barbazquux; {marker}"]` to `"extra:{marker}": ["barbazquux"]`. """ output = defaultdict[str, _Ordered[Requirement]](dict) for section, v in extras_require.items(): # Do not strip empty sections. output[section] for r in _reqs.parse(v): output[section + _suffix_for(r)].setdefault(r) return output def _move_install_requirements_markers( install_requires: _StrOrIter, extras_require: Mapping[str, _Ordered[Requirement]] ) -> tuple[list[str], dict[str, list[str]]]: """ The ``requires.txt`` file has an specific format: - Environment markers need to be part of the section headers and should not be part of the requirement spec itself. Move requirements in ``install_requires`` that are using environment markers ``extras_require``. """ # divide the install_requires into two sets, simple ones still # handled by install_requires and more complex ones handled by extras_require. inst_reqs = list(_reqs.parse(install_requires)) simple_reqs = filter(_no_marker, inst_reqs) complex_reqs = filterfalse(_no_marker, inst_reqs) simple_install_requires = list(map(str, simple_reqs)) for r in complex_reqs: extras_require[':' + str(r.marker)].setdefault(r) expanded_extras = dict( # list(dict.fromkeys(...)) ensures a list of unique strings (k, list(dict.fromkeys(str(r) for r in map(_clean_req, v)))) for k, v in extras_require.items() ) return simple_install_requires, expanded_extras def _suffix_for(req): """Return the 'extras_require' suffix for a given requirement.""" return ':' + str(req.marker) if req.marker else '' def _clean_req(req): """Given a Requirement, remove environment markers and return it""" r = Requirement(str(req)) # create a copy before modifying r.marker = None return r def _no_marker(req): return not req.marker def _write_requirements(stream, reqs): lines = yield_lines(reqs or ()) def append_cr(line): return line + '\n' lines = map(append_cr, lines) stream.writelines(lines) def write_requirements(cmd, basename, filename): dist = cmd.distribution data = io.StringIO() install_requires, extras_require = _prepare( dist.install_requires or (), dist.extras_require or {} ) _write_requirements(data, install_requires) for extra in sorted(extras_require): data.write('\n[{extra}]\n'.format(**vars())) _write_requirements(data, extras_require[extra]) cmd.write_or_delete_file("requirements", filename, data.getvalue()) def write_setup_requirements(cmd, basename, filename): data = io.StringIO() _write_requirements(data, cmd.distribution.setup_requires) cmd.write_or_delete_file("setup-requirements", filename, data.getvalue()) command/bdist_egg.py 0000644 00000041114 15030122015 0010451 0 ustar 00 """setuptools.command.bdist_egg Build .egg distributions""" from __future__ import annotations import marshal import os import re import sys import textwrap from sysconfig import get_path, get_python_version from types import CodeType from typing import TYPE_CHECKING, Literal from setuptools import Command from setuptools.extension import Library from .._path import StrPathT, ensure_directory from distutils import log from distutils.dir_util import mkpath, remove_tree if TYPE_CHECKING: from typing_extensions import TypeAlias # Same as zipfile._ZipFileMode from typeshed _ZipFileMode: TypeAlias = Literal["r", "w", "x", "a"] def _get_purelib(): return get_path("purelib") def strip_module(filename): if '.' in filename: filename = os.path.splitext(filename)[0] if filename.endswith('module'): filename = filename[:-6] return filename def sorted_walk(dir): """Do os.walk in a reproducible way, independent of indeterministic filesystem readdir order """ for base, dirs, files in os.walk(dir): dirs.sort() files.sort() yield base, dirs, files def write_stub(resource, pyfile) -> None: _stub_template = textwrap.dedent( """ def __bootstrap__(): global __bootstrap__, __loader__, __file__ import sys, pkg_resources, importlib.util __file__ = pkg_resources.resource_filename(__name__, %r) __loader__ = None; del __bootstrap__, __loader__ spec = importlib.util.spec_from_file_location(__name__,__file__) mod = importlib.util.module_from_spec(spec) spec.loader.exec_module(mod) __bootstrap__() """ ).lstrip() with open(pyfile, 'w', encoding="utf-8") as f: f.write(_stub_template % resource) class bdist_egg(Command): description = 'create an "egg" distribution' user_options = [ ('bdist-dir=', 'b', "temporary directory for creating the distribution"), ( 'plat-name=', 'p', "platform name to embed in generated filenames " "(by default uses `pkg_resources.get_build_platform()`)", ), ('exclude-source-files', None, "remove all .py files from the generated egg"), ( 'keep-temp', 'k', "keep the pseudo-installation tree around after " "creating the distribution archive", ), ('dist-dir=', 'd', "directory to put final built distributions in"), ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), ] boolean_options = ['keep-temp', 'skip-build', 'exclude-source-files'] def initialize_options(self): self.bdist_dir = None self.plat_name = None self.keep_temp = False self.dist_dir = None self.skip_build = False self.egg_output = None self.exclude_source_files = None def finalize_options(self) -> None: ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info") self.egg_info = ei_cmd.egg_info if self.bdist_dir is None: bdist_base = self.get_finalized_command('bdist').bdist_base self.bdist_dir = os.path.join(bdist_base, 'egg') if self.plat_name is None: from pkg_resources import get_build_platform self.plat_name = get_build_platform() self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) if self.egg_output is None: # Compute filename of the output egg basename = ei_cmd._get_egg_basename( py_version=get_python_version(), platform=self.distribution.has_ext_modules() and self.plat_name, ) self.egg_output = os.path.join(self.dist_dir, basename + '.egg') def do_install_data(self) -> None: # Hack for packages that install data to install's --install-lib self.get_finalized_command('install').install_lib = self.bdist_dir site_packages = os.path.normcase(os.path.realpath(_get_purelib())) old, self.distribution.data_files = self.distribution.data_files, [] for item in old: if isinstance(item, tuple) and len(item) == 2: if os.path.isabs(item[0]): realpath = os.path.realpath(item[0]) normalized = os.path.normcase(realpath) if normalized == site_packages or normalized.startswith( site_packages + os.sep ): item = realpath[len(site_packages) + 1 :], item[1] # XXX else: raise ??? self.distribution.data_files.append(item) try: log.info("installing package data to %s", self.bdist_dir) self.call_command('install_data', force=False, root=None) finally: self.distribution.data_files = old def get_outputs(self): return [self.egg_output] def call_command(self, cmdname, **kw): """Invoke reinitialized command `cmdname` with keyword args""" for dirname in INSTALL_DIRECTORY_ATTRS: kw.setdefault(dirname, self.bdist_dir) kw.setdefault('skip_build', self.skip_build) kw.setdefault('dry_run', self.dry_run) cmd = self.reinitialize_command(cmdname, **kw) self.run_command(cmdname) return cmd def run(self): # noqa: C901 # is too complex (14) # FIXME # Generate metadata first self.run_command("egg_info") # We run install_lib before install_data, because some data hacks # pull their data path from the install_lib command. log.info("installing library code to %s", self.bdist_dir) instcmd = self.get_finalized_command('install') old_root = instcmd.root instcmd.root = None if self.distribution.has_c_libraries() and not self.skip_build: self.run_command('build_clib') cmd = self.call_command('install_lib', warn_dir=False) instcmd.root = old_root all_outputs, ext_outputs = self.get_ext_outputs() self.stubs = [] to_compile = [] for p, ext_name in enumerate(ext_outputs): filename, _ext = os.path.splitext(ext_name) pyfile = os.path.join(self.bdist_dir, strip_module(filename) + '.py') self.stubs.append(pyfile) log.info("creating stub loader for %s", ext_name) if not self.dry_run: write_stub(os.path.basename(ext_name), pyfile) to_compile.append(pyfile) ext_outputs[p] = ext_name.replace(os.sep, '/') if to_compile: cmd.byte_compile(to_compile) if self.distribution.data_files: self.do_install_data() # Make the EGG-INFO directory archive_root = self.bdist_dir egg_info = os.path.join(archive_root, 'EGG-INFO') self.mkpath(egg_info) if self.distribution.scripts: script_dir = os.path.join(egg_info, 'scripts') log.info("installing scripts to %s", script_dir) self.call_command('install_scripts', install_dir=script_dir, no_ep=True) self.copy_metadata_to(egg_info) native_libs = os.path.join(egg_info, "native_libs.txt") if all_outputs: log.info("writing %s", native_libs) if not self.dry_run: ensure_directory(native_libs) with open(native_libs, 'wt', encoding="utf-8") as libs_file: libs_file.write('\n'.join(all_outputs)) libs_file.write('\n') elif os.path.isfile(native_libs): log.info("removing %s", native_libs) if not self.dry_run: os.unlink(native_libs) write_safety_flag(os.path.join(archive_root, 'EGG-INFO'), self.zip_safe()) if os.path.exists(os.path.join(self.egg_info, 'depends.txt')): log.warn( "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n" "Use the install_requires/extras_require setup() args instead." ) if self.exclude_source_files: self.zap_pyfiles() # Make the archive make_zipfile( self.egg_output, archive_root, verbose=self.verbose, dry_run=self.dry_run, mode=self.gen_header(), ) if not self.keep_temp: remove_tree(self.bdist_dir, dry_run=self.dry_run) # Add to 'Distribution.dist_files' so that the "upload" command works getattr(self.distribution, 'dist_files', []).append(( 'bdist_egg', get_python_version(), self.egg_output, )) def zap_pyfiles(self): log.info("Removing .py files from temporary directory") for base, dirs, files in walk_egg(self.bdist_dir): for name in files: path = os.path.join(base, name) if name.endswith('.py'): log.debug("Deleting %s", path) os.unlink(path) if base.endswith('__pycache__'): path_old = path pattern = r'(?P<name>.+)\.(?P<magic>[^.]+)\.pyc' m = re.match(pattern, name) path_new = os.path.join(base, os.pardir, m.group('name') + '.pyc') log.info(f"Renaming file from [{path_old}] to [{path_new}]") try: os.remove(path_new) except OSError: pass os.rename(path_old, path_new) def zip_safe(self): safe = getattr(self.distribution, 'zip_safe', None) if safe is not None: return safe log.warn("zip_safe flag not set; analyzing archive contents...") return analyze_egg(self.bdist_dir, self.stubs) def gen_header(self) -> Literal["w"]: return 'w' def copy_metadata_to(self, target_dir) -> None: "Copy metadata (egg info) to the target_dir" # normalize the path (so that a forward-slash in egg_info will # match using startswith below) norm_egg_info = os.path.normpath(self.egg_info) prefix = os.path.join(norm_egg_info, '') for path in self.ei_cmd.filelist.files: if path.startswith(prefix): target = os.path.join(target_dir, path[len(prefix) :]) ensure_directory(target) self.copy_file(path, target) def get_ext_outputs(self): """Get a list of relative paths to C extensions in the output distro""" all_outputs = [] ext_outputs = [] paths = {self.bdist_dir: ''} for base, dirs, files in sorted_walk(self.bdist_dir): all_outputs.extend( paths[base] + filename for filename in files if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS ) for filename in dirs: paths[os.path.join(base, filename)] = paths[base] + filename + '/' if self.distribution.has_ext_modules(): build_cmd = self.get_finalized_command('build_ext') for ext in build_cmd.extensions: if isinstance(ext, Library): continue fullname = build_cmd.get_ext_fullname(ext.name) filename = build_cmd.get_ext_filename(fullname) if not os.path.basename(filename).startswith('dl-'): if os.path.exists(os.path.join(self.bdist_dir, filename)): ext_outputs.append(filename) return all_outputs, ext_outputs NATIVE_EXTENSIONS: dict[str, None] = dict.fromkeys('.dll .so .dylib .pyd'.split()) def walk_egg(egg_dir): """Walk an unpacked egg's contents, skipping the metadata directory""" walker = sorted_walk(egg_dir) base, dirs, files = next(walker) if 'EGG-INFO' in dirs: dirs.remove('EGG-INFO') yield base, dirs, files yield from walker def analyze_egg(egg_dir, stubs): # check for existing flag in EGG-INFO for flag, fn in safety_flags.items(): if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)): return flag if not can_scan(): return False safe = True for base, dirs, files in walk_egg(egg_dir): for name in files: if name.endswith('.py') or name.endswith('.pyw'): continue elif name.endswith('.pyc') or name.endswith('.pyo'): # always scan, even if we already know we're not safe safe = scan_module(egg_dir, base, name, stubs) and safe return safe def write_safety_flag(egg_dir, safe) -> None: # Write or remove zip safety flag file(s) for flag, fn in safety_flags.items(): fn = os.path.join(egg_dir, fn) if os.path.exists(fn): if safe is None or bool(safe) != flag: os.unlink(fn) elif safe is not None and bool(safe) == flag: with open(fn, 'wt', encoding="utf-8") as f: f.write('\n') safety_flags = { True: 'zip-safe', False: 'not-zip-safe', } def scan_module(egg_dir, base, name, stubs): """Check whether module possibly uses unsafe-for-zipfile stuff""" filename = os.path.join(base, name) if filename[:-1] in stubs: return True # Extension module pkg = base[len(egg_dir) + 1 :].replace(os.sep, '.') module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0] skip = 16 # skip magic & reserved? & date & file size f = open(filename, 'rb') f.read(skip) code = marshal.load(f) f.close() safe = True symbols = dict.fromkeys(iter_symbols(code)) for bad in ['__file__', '__path__']: if bad in symbols: log.warn("%s: module references %s", module, bad) safe = False if 'inspect' in symbols: for bad in [ 'getsource', 'getabsfile', 'getfile', 'getsourcefile', 'getsourcelines', 'findsource', 'getcomments', 'getframeinfo', 'getinnerframes', 'getouterframes', 'stack', 'trace', ]: if bad in symbols: log.warn("%s: module MAY be using inspect.%s", module, bad) safe = False return safe def iter_symbols(code): """Yield names and strings used by `code` and its nested code objects""" yield from code.co_names for const in code.co_consts: if isinstance(const, str): yield const elif isinstance(const, CodeType): yield from iter_symbols(const) def can_scan() -> bool: if not sys.platform.startswith('java') and sys.platform != 'cli': # CPython, PyPy, etc. return True log.warn("Unable to analyze compiled code on this platform.") log.warn( "Please ask the author to include a 'zip_safe'" " setting (either True or False) in the package's setup.py" ) return False # Attribute names of options for commands that might need to be convinced to # install to the egg build directory INSTALL_DIRECTORY_ATTRS = ['install_lib', 'install_dir', 'install_data', 'install_base'] def make_zipfile( zip_filename: StrPathT, base_dir, verbose: bool = False, dry_run: bool = False, compress=True, mode: _ZipFileMode = 'w', ) -> StrPathT: """Create a zip file from all the files under 'base_dir'. The output zip file will be named 'base_dir' + ".zip". Uses either the "zipfile" Python module (if available) or the InfoZIP "zip" utility (if installed and found on the default search path). If neither tool is available, raises DistutilsExecError. Returns the name of the output zip file. """ import zipfile mkpath(os.path.dirname(zip_filename), dry_run=dry_run) # type: ignore[arg-type] # python/mypy#18075 log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) def visit(z, dirname, names): for name in names: path = os.path.normpath(os.path.join(dirname, name)) if os.path.isfile(path): p = path[len(base_dir) + 1 :] if not dry_run: z.write(path, p) log.debug("adding '%s'", p) compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED if not dry_run: z = zipfile.ZipFile(zip_filename, mode, compression=compression) for dirname, dirs, files in sorted_walk(base_dir): visit(z, dirname, files) z.close() else: for dirname, dirs, files in sorted_walk(base_dir): visit(None, dirname, files) return zip_filename command/setopt.py 0000644 00000011754 15030122015 0010047 0 ustar 00 import configparser import os from .. import Command from ..unicode_utils import _cfg_read_utf8_with_fallback import distutils from distutils import log from distutils.errors import DistutilsOptionError from distutils.util import convert_path __all__ = ['config_file', 'edit_config', 'option_base', 'setopt'] def config_file(kind="local"): """Get the filename of the distutils, local, global, or per-user config `kind` must be one of "local", "global", or "user" """ if kind == 'local': return 'setup.cfg' if kind == 'global': return os.path.join(os.path.dirname(distutils.__file__), 'distutils.cfg') if kind == 'user': dot = os.name == 'posix' and '.' or '' return os.path.expanduser(convert_path(f"~/{dot}pydistutils.cfg")) raise ValueError("config_file() type must be 'local', 'global', or 'user'", kind) def edit_config(filename, settings, dry_run=False): """Edit a configuration file to include `settings` `settings` is a dictionary of dictionaries or ``None`` values, keyed by command/section name. A ``None`` value means to delete the entire section, while a dictionary lists settings to be changed or deleted in that section. A setting of ``None`` means to delete that setting. """ log.debug("Reading configuration from %s", filename) opts = configparser.RawConfigParser() opts.optionxform = lambda optionstr: optionstr # type: ignore[method-assign] # overriding method _cfg_read_utf8_with_fallback(opts, filename) for section, options in settings.items(): if options is None: log.info("Deleting section [%s] from %s", section, filename) opts.remove_section(section) else: if not opts.has_section(section): log.debug("Adding new section [%s] to %s", section, filename) opts.add_section(section) for option, value in options.items(): if value is None: log.debug("Deleting %s.%s from %s", section, option, filename) opts.remove_option(section, option) if not opts.options(section): log.info( "Deleting empty [%s] section from %s", section, filename ) opts.remove_section(section) else: log.debug( "Setting %s.%s to %r in %s", section, option, value, filename ) opts.set(section, option, value) log.info("Writing %s", filename) if not dry_run: with open(filename, 'w', encoding="utf-8") as f: opts.write(f) class option_base(Command): """Abstract base class for commands that mess with config files""" user_options = [ ('global-config', 'g', "save options to the site-wide distutils.cfg file"), ('user-config', 'u', "save options to the current user's pydistutils.cfg file"), ('filename=', 'f', "configuration file to use (default=setup.cfg)"), ] boolean_options = [ 'global-config', 'user-config', ] def initialize_options(self): self.global_config = None self.user_config = None self.filename = None def finalize_options(self): filenames = [] if self.global_config: filenames.append(config_file('global')) if self.user_config: filenames.append(config_file('user')) if self.filename is not None: filenames.append(self.filename) if not filenames: filenames.append(config_file('local')) if len(filenames) > 1: raise DistutilsOptionError( "Must specify only one configuration file option", filenames ) (self.filename,) = filenames class setopt(option_base): """Save command-line options to a file""" description = "set an option in setup.cfg or another config file" user_options = [ ('command=', 'c', 'command to set an option for'), ('option=', 'o', 'option to set'), ('set-value=', 's', 'value of the option'), ('remove', 'r', 'remove (unset) the value'), ] + option_base.user_options boolean_options = option_base.boolean_options + ['remove'] def initialize_options(self): option_base.initialize_options(self) self.command = None self.option = None self.set_value = None self.remove = None def finalize_options(self) -> None: option_base.finalize_options(self) if self.command is None or self.option is None: raise DistutilsOptionError("Must specify --command *and* --option") if self.set_value is None and not self.remove: raise DistutilsOptionError("Must specify --set-value or --remove") def run(self) -> None: edit_config( self.filename, {self.command: {self.option.replace('-', '_'): self.set_value}}, self.dry_run, ) command/bdist_wheel.py 0000644 00000053346 15030122015 0011025 0 ustar 00 """ Create a wheel (.whl) distribution. A wheel is a built archive format. """ from __future__ import annotations import os import re import shutil import struct import sys import sysconfig import warnings from collections.abc import Iterable, Sequence from email.generator import BytesGenerator from glob import iglob from typing import Literal, cast from zipfile import ZIP_DEFLATED, ZIP_STORED from packaging import tags, version as _packaging_version from wheel.wheelfile import WheelFile from .. import Command, __version__, _shutil from .._core_metadata import _safe_license_file from .._normalization import safer_name from ..warnings import SetuptoolsDeprecationWarning from .egg_info import egg_info as egg_info_cls from distutils import log def safe_version(version: str) -> str: """ Convert an arbitrary string to a standard version string """ try: # normalize the version return str(_packaging_version.Version(version)) except _packaging_version.InvalidVersion: version = version.replace(" ", ".") return re.sub("[^A-Za-z0-9.]+", "-", version) setuptools_major_version = int(__version__.split(".")[0]) PY_LIMITED_API_PATTERN = r"cp3\d" def _is_32bit_interpreter() -> bool: return struct.calcsize("P") == 4 def python_tag() -> str: return f"py{sys.version_info.major}" def get_platform(archive_root: str | None) -> str: """Return our platform name 'win32', 'linux_x86_64'""" result = sysconfig.get_platform() if result.startswith("macosx") and archive_root is not None: # pragma: no cover from wheel.macosx_libfile import calculate_macosx_platform_tag result = calculate_macosx_platform_tag(archive_root, result) elif _is_32bit_interpreter(): if result == "linux-x86_64": # pip pull request #3497 result = "linux-i686" elif result == "linux-aarch64": # packaging pull request #234 # TODO armv8l, packaging pull request #690 => this did not land # in pip/packaging yet result = "linux-armv7l" return result.replace("-", "_") def get_flag( var: str, fallback: bool, expected: bool = True, warn: bool = True ) -> bool: """Use a fallback value for determining SOABI flags if the needed config var is unset or unavailable.""" val = sysconfig.get_config_var(var) if val is None: if warn: warnings.warn( f"Config variable '{var}' is unset, Python ABI tag may be incorrect", RuntimeWarning, stacklevel=2, ) return fallback return val == expected def get_abi_tag() -> str | None: """Return the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2).""" soabi: str = sysconfig.get_config_var("SOABI") impl = tags.interpreter_name() if not soabi and impl in ("cp", "pp") and hasattr(sys, "maxunicode"): d = "" u = "" if get_flag("Py_DEBUG", hasattr(sys, "gettotalrefcount"), warn=(impl == "cp")): d = "d" abi = f"{impl}{tags.interpreter_version()}{d}{u}" elif soabi and impl == "cp" and soabi.startswith("cpython"): # non-Windows abi = "cp" + soabi.split("-")[1] elif soabi and impl == "cp" and soabi.startswith("cp"): # Windows abi = soabi.split("-")[0] if hasattr(sys, "gettotalrefcount"): # using debug build; append "d" flag abi += "d" elif soabi and impl == "pp": # we want something like pypy36-pp73 abi = "-".join(soabi.split("-")[:2]) abi = abi.replace(".", "_").replace("-", "_") elif soabi and impl == "graalpy": abi = "-".join(soabi.split("-")[:3]) abi = abi.replace(".", "_").replace("-", "_") elif soabi: abi = soabi.replace(".", "_").replace("-", "_") else: abi = None return abi def safer_version(version: str) -> str: return safe_version(version).replace("-", "_") class bdist_wheel(Command): description = "create a wheel distribution" supported_compressions = { "stored": ZIP_STORED, "deflated": ZIP_DEFLATED, } user_options = [ ("bdist-dir=", "b", "temporary directory for creating the distribution"), ( "plat-name=", "p", "platform name to embed in generated filenames " f"[default: {get_platform(None)}]", ), ( "keep-temp", "k", "keep the pseudo-installation tree around after " "creating the distribution archive", ), ("dist-dir=", "d", "directory to put final built distributions in"), ("skip-build", None, "skip rebuilding everything (for testing/debugging)"), ( "relative", None, "build the archive using relative paths [default: false]", ), ( "owner=", "u", "Owner name used when creating a tar file [default: current user]", ), ( "group=", "g", "Group name used when creating a tar file [default: current group]", ), ("universal", None, "*DEPRECATED* make a universal wheel [default: false]"), ( "compression=", None, f"zipfile compression (one of: {', '.join(supported_compressions)}) [default: 'deflated']", ), ( "python-tag=", None, f"Python implementation compatibility tag [default: '{python_tag()}']", ), ( "build-number=", None, "Build number for this particular version. " "As specified in PEP-0427, this must start with a digit. " "[default: None]", ), ( "py-limited-api=", None, "Python tag (cp32|cp33|cpNN) for abi3 wheel tag [default: false]", ), ( "dist-info-dir=", None, "directory where a pre-generated dist-info can be found (e.g. as a " "result of calling the PEP517 'prepare_metadata_for_build_wheel' " "method)", ), ] boolean_options = ["keep-temp", "skip-build", "relative", "universal"] def initialize_options(self) -> None: self.bdist_dir: str | None = None self.data_dir = "" self.plat_name: str | None = None self.plat_tag: str | None = None self.format = "zip" self.keep_temp = False self.dist_dir: str | None = None self.dist_info_dir = None self.egginfo_dir: str | None = None self.root_is_pure: bool | None = None self.skip_build = False self.relative = False self.owner = None self.group = None self.universal = False self.compression: str | int = "deflated" self.python_tag = python_tag() self.build_number: str | None = None self.py_limited_api: str | Literal[False] = False self.plat_name_supplied = False def finalize_options(self) -> None: if not self.bdist_dir: bdist_base = self.get_finalized_command("bdist").bdist_base self.bdist_dir = os.path.join(bdist_base, "wheel") if self.dist_info_dir is None: egg_info = cast(egg_info_cls, self.distribution.get_command_obj("egg_info")) egg_info.ensure_finalized() # needed for correct `wheel_dist_name` self.data_dir = self.wheel_dist_name + ".data" self.plat_name_supplied = bool(self.plat_name) need_options = ("dist_dir", "plat_name", "skip_build") self.set_undefined_options("bdist", *zip(need_options, need_options)) self.root_is_pure = not ( self.distribution.has_ext_modules() or self.distribution.has_c_libraries() ) self._validate_py_limited_api() # Support legacy [wheel] section for setting universal wheel = self.distribution.get_option_dict("wheel") if "universal" in wheel: # pragma: no cover # please don't define this in your global configs log.warn("The [wheel] section is deprecated. Use [bdist_wheel] instead.") val = wheel["universal"][1].strip() if val.lower() in ("1", "true", "yes"): self.universal = True if self.universal: SetuptoolsDeprecationWarning.emit( "bdist_wheel.universal is deprecated", """ With Python 2.7 end-of-life, support for building universal wheels (i.e., wheels that support both Python 2 and Python 3) is being obviated. Please discontinue using this option, or if you still need it, file an issue with pypa/setuptools describing your use case. """, due_date=(2025, 8, 30), # Introduced in 2024-08-30 ) if self.build_number is not None and not self.build_number[:1].isdigit(): raise ValueError("Build tag (build-number) must start with a digit.") def _validate_py_limited_api(self) -> None: if not self.py_limited_api: return if not re.match(PY_LIMITED_API_PATTERN, self.py_limited_api): raise ValueError(f"py-limited-api must match '{PY_LIMITED_API_PATTERN}'") if sysconfig.get_config_var("Py_GIL_DISABLED"): raise ValueError( f"`py_limited_api={self.py_limited_api!r}` not supported. " "`Py_LIMITED_API` is currently incompatible with " "`Py_GIL_DISABLED`." "See https://github.com/python/cpython/issues/111506." ) @property def wheel_dist_name(self) -> str: """Return distribution full name with - replaced with _""" components = [ safer_name(self.distribution.get_name()), safer_version(self.distribution.get_version()), ] if self.build_number: components.append(self.build_number) return "-".join(components) def get_tag(self) -> tuple[str, str, str]: # bdist sets self.plat_name if unset, we should only use it for purepy # wheels if the user supplied it. if self.plat_name_supplied and self.plat_name: plat_name = self.plat_name elif self.root_is_pure: plat_name = "any" else: # macosx contains system version in platform name so need special handle if self.plat_name and not self.plat_name.startswith("macosx"): plat_name = self.plat_name else: # on macosx always limit the platform name to comply with any # c-extension modules in bdist_dir, since the user can specify # a higher MACOSX_DEPLOYMENT_TARGET via tools like CMake # on other platforms, and on macosx if there are no c-extension # modules, use the default platform name. plat_name = get_platform(self.bdist_dir) if _is_32bit_interpreter(): if plat_name in ("linux-x86_64", "linux_x86_64"): plat_name = "linux_i686" if plat_name in ("linux-aarch64", "linux_aarch64"): # TODO armv8l, packaging pull request #690 => this did not land # in pip/packaging yet plat_name = "linux_armv7l" plat_name = ( plat_name.lower().replace("-", "_").replace(".", "_").replace(" ", "_") ) if self.root_is_pure: if self.universal: impl = "py2.py3" else: impl = self.python_tag tag = (impl, "none", plat_name) else: impl_name = tags.interpreter_name() impl_ver = tags.interpreter_version() impl = impl_name + impl_ver # We don't work on CPython 3.1, 3.0. if self.py_limited_api and (impl_name + impl_ver).startswith("cp3"): impl = self.py_limited_api abi_tag = "abi3" else: abi_tag = str(get_abi_tag()).lower() tag = (impl, abi_tag, plat_name) # issue gh-374: allow overriding plat_name supported_tags = [ (t.interpreter, t.abi, plat_name) for t in tags.sys_tags() ] assert tag in supported_tags, ( f"would build wheel with unsupported tag {tag}" ) return tag def run(self): build_scripts = self.reinitialize_command("build_scripts") build_scripts.executable = "python" build_scripts.force = True build_ext = self.reinitialize_command("build_ext") build_ext.inplace = False if not self.skip_build: self.run_command("build") install = self.reinitialize_command("install", reinit_subcommands=True) install.root = self.bdist_dir install.compile = False install.skip_build = self.skip_build install.warn_dir = False # A wheel without setuptools scripts is more cross-platform. # Use the (undocumented) `no_ep` option to setuptools' # install_scripts command to avoid creating entry point scripts. install_scripts = self.reinitialize_command("install_scripts") install_scripts.no_ep = True # Use a custom scheme for the archive, because we have to decide # at installation time which scheme to use. for key in ("headers", "scripts", "data", "purelib", "platlib"): setattr(install, "install_" + key, os.path.join(self.data_dir, key)) basedir_observed = "" if os.name == "nt": # win32 barfs if any of these are ''; could be '.'? # (distutils.command.install:change_roots bug) basedir_observed = os.path.normpath(os.path.join(self.data_dir, "..")) self.install_libbase = self.install_lib = basedir_observed setattr( install, "install_purelib" if self.root_is_pure else "install_platlib", basedir_observed, ) log.info(f"installing to {self.bdist_dir}") self.run_command("install") impl_tag, abi_tag, plat_tag = self.get_tag() archive_basename = f"{self.wheel_dist_name}-{impl_tag}-{abi_tag}-{plat_tag}" if not self.relative: archive_root = self.bdist_dir else: archive_root = os.path.join( self.bdist_dir, self._ensure_relative(install.install_base) ) self.set_undefined_options("install_egg_info", ("target", "egginfo_dir")) distinfo_dirname = ( f"{safer_name(self.distribution.get_name())}-" f"{safer_version(self.distribution.get_version())}.dist-info" ) distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname) if self.dist_info_dir: # Use the given dist-info directly. log.debug(f"reusing {self.dist_info_dir}") shutil.copytree(self.dist_info_dir, distinfo_dir) # Egg info is still generated, so remove it now to avoid it getting # copied into the wheel. _shutil.rmtree(self.egginfo_dir) else: # Convert the generated egg-info into dist-info. self.egg2dist(self.egginfo_dir, distinfo_dir) self.write_wheelfile(distinfo_dir) # Make the archive if not os.path.exists(self.dist_dir): os.makedirs(self.dist_dir) wheel_path = os.path.join(self.dist_dir, archive_basename + ".whl") with WheelFile(wheel_path, "w", self._zip_compression()) as wf: wf.write_files(archive_root) # Add to 'Distribution.dist_files' so that the "upload" command works getattr(self.distribution, "dist_files", []).append(( "bdist_wheel", f"{sys.version_info.major}.{sys.version_info.minor}", wheel_path, )) if not self.keep_temp: log.info(f"removing {self.bdist_dir}") if not self.dry_run: _shutil.rmtree(self.bdist_dir) def write_wheelfile( self, wheelfile_base: str, generator: str = f"setuptools ({__version__})" ) -> None: from email.message import Message msg = Message() msg["Wheel-Version"] = "1.0" # of the spec msg["Generator"] = generator msg["Root-Is-Purelib"] = str(self.root_is_pure).lower() if self.build_number is not None: msg["Build"] = self.build_number # Doesn't work for bdist_wininst impl_tag, abi_tag, plat_tag = self.get_tag() for impl in impl_tag.split("."): for abi in abi_tag.split("."): for plat in plat_tag.split("."): msg["Tag"] = "-".join((impl, abi, plat)) wheelfile_path = os.path.join(wheelfile_base, "WHEEL") log.info(f"creating {wheelfile_path}") with open(wheelfile_path, "wb") as f: BytesGenerator(f, maxheaderlen=0).flatten(msg) def _ensure_relative(self, path: str) -> str: # copied from dir_util, deleted drive, path = os.path.splitdrive(path) if path[0:1] == os.sep: path = drive + path[1:] return path @property def license_paths(self) -> Iterable[str]: if setuptools_major_version >= 57: # Setuptools has resolved any patterns to actual file names return self.distribution.metadata.license_files or () files = set[str]() metadata = self.distribution.get_option_dict("metadata") if setuptools_major_version >= 42: # Setuptools recognizes the license_files option but does not do globbing patterns = cast(Sequence[str], self.distribution.metadata.license_files) else: # Prior to those, wheel is entirely responsible for handling license files if "license_files" in metadata: patterns = metadata["license_files"][1].split() else: patterns = () if "license_file" in metadata: warnings.warn( 'The "license_file" option is deprecated. Use "license_files" instead.', DeprecationWarning, stacklevel=2, ) files.add(metadata["license_file"][1]) if not files and not patterns and not isinstance(patterns, list): patterns = ("LICEN[CS]E*", "COPYING*", "NOTICE*", "AUTHORS*") for pattern in patterns: for path in iglob(pattern): if path.endswith("~"): log.debug( f'ignoring license file "{path}" as it looks like a backup' ) continue if path not in files and os.path.isfile(path): log.info( f'adding license file "{path}" (matched pattern "{pattern}")' ) files.add(path) return files def egg2dist(self, egginfo_path: str, distinfo_path: str) -> None: """Convert an .egg-info directory into a .dist-info directory""" def adios(p: str) -> None: """Appropriately delete directory, file or link.""" if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p): _shutil.rmtree(p) elif os.path.exists(p): os.unlink(p) adios(distinfo_path) if not os.path.exists(egginfo_path): # There is no egg-info. This is probably because the egg-info # file/directory is not named matching the distribution name used # to name the archive file. Check for this case and report # accordingly. import glob pat = os.path.join(os.path.dirname(egginfo_path), "*.egg-info") possible = glob.glob(pat) err = f"Egg metadata expected at {egginfo_path} but not found" if possible: alt = os.path.basename(possible[0]) err += f" ({alt} found - possible misnamed archive file?)" raise ValueError(err) # .egg-info is a directory pkginfo_path = os.path.join(egginfo_path, "PKG-INFO") # ignore common egg metadata that is useless to wheel shutil.copytree( egginfo_path, distinfo_path, ignore=lambda x, y: { "PKG-INFO", "requires.txt", "SOURCES.txt", "not-zip-safe", }, ) # delete dependency_links if it is only whitespace dependency_links_path = os.path.join(distinfo_path, "dependency_links.txt") with open(dependency_links_path, encoding="utf-8") as dependency_links_file: dependency_links = dependency_links_file.read().strip() if not dependency_links: adios(dependency_links_path) metadata_path = os.path.join(distinfo_path, "METADATA") shutil.copy(pkginfo_path, metadata_path) licenses_folder_path = os.path.join(distinfo_path, "licenses") for license_path in self.license_paths: safe_path = _safe_license_file(license_path) dist_info_license_path = os.path.join(licenses_folder_path, safe_path) os.makedirs(os.path.dirname(dist_info_license_path), exist_ok=True) shutil.copy(license_path, dist_info_license_path) adios(egginfo_path) def _zip_compression(self) -> int: if ( isinstance(self.compression, int) and self.compression in self.supported_compressions.values() ): return self.compression compression = self.supported_compressions.get(str(self.compression)) if compression is not None: return compression raise ValueError(f"Unsupported compression: {self.compression!r}") command/sdist.py 0000644 00000016316 15030122015 0007656 0 ustar 00 from __future__ import annotations import contextlib import os import re from itertools import chain from typing import ClassVar from .._importlib import metadata from ..dist import Distribution from .build import _ORIGINAL_SUBCOMMANDS import distutils.command.sdist as orig from distutils import log _default_revctrl = list def walk_revctrl(dirname=''): """Find all files under revision control""" for ep in metadata.entry_points(group='setuptools.file_finders'): yield from ep.load()(dirname) class sdist(orig.sdist): """Smart sdist that finds anything supported by revision control""" user_options = [ ('formats=', None, "formats for source distribution (comma-separated list)"), ( 'keep-temp', 'k', "keep the distribution tree around after creating " + "archive file(s)", ), ( 'dist-dir=', 'd', "directory to put the source distribution archive(s) in [default: dist]", ), ( 'owner=', 'u', "Owner name used when creating a tar file [default: current user]", ), ( 'group=', 'g', "Group name used when creating a tar file [default: current group]", ), ] distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution negative_opt: ClassVar[dict[str, str]] = {} README_EXTENSIONS = ['', '.rst', '.txt', '.md'] READMES = tuple(f'README{ext}' for ext in README_EXTENSIONS) def run(self) -> None: self.run_command('egg_info') ei_cmd = self.get_finalized_command('egg_info') self.filelist = ei_cmd.filelist self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt')) self.check_readme() # Run sub commands for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) self.make_distribution() dist_files = getattr(self.distribution, 'dist_files', []) for file in self.archive_files: data = ('sdist', '', file) if data not in dist_files: dist_files.append(data) def initialize_options(self) -> None: orig.sdist.initialize_options(self) def make_distribution(self) -> None: """ Workaround for #516 """ with self._remove_os_link(): orig.sdist.make_distribution(self) @staticmethod @contextlib.contextmanager def _remove_os_link(): """ In a context, remove and restore os.link if it exists """ class NoValue: pass orig_val = getattr(os, 'link', NoValue) try: del os.link except Exception: pass try: yield finally: if orig_val is not NoValue: os.link = orig_val def add_defaults(self) -> None: super().add_defaults() self._add_defaults_build_sub_commands() def _add_defaults_optional(self): super()._add_defaults_optional() if os.path.isfile('pyproject.toml'): self.filelist.append('pyproject.toml') def _add_defaults_python(self): """getting python files""" if self.distribution.has_pure_modules(): build_py = self.get_finalized_command('build_py') self.filelist.extend(build_py.get_source_files()) self._add_data_files(self._safe_data_files(build_py)) def _add_defaults_build_sub_commands(self): build = self.get_finalized_command("build") missing_cmds = set(build.get_sub_commands()) - _ORIGINAL_SUBCOMMANDS # ^-- the original built-in sub-commands are already handled by default. cmds = (self.get_finalized_command(c) for c in missing_cmds) files = (c.get_source_files() for c in cmds if hasattr(c, "get_source_files")) self.filelist.extend(chain.from_iterable(files)) def _safe_data_files(self, build_py): """ Since the ``sdist`` class is also used to compute the MANIFEST (via :obj:`setuptools.command.egg_info.manifest_maker`), there might be recursion problems when trying to obtain the list of data_files and ``include_package_data=True`` (which in turn depends on the files included in the MANIFEST). To avoid that, ``manifest_maker`` should be able to overwrite this method and avoid recursive attempts to build/analyze the MANIFEST. """ return build_py.data_files def _add_data_files(self, data_files): """ Add data files as found in build_py.data_files. """ self.filelist.extend( os.path.join(src_dir, name) for _, src_dir, _, filenames in data_files for name in filenames ) def _add_defaults_data_files(self): try: super()._add_defaults_data_files() except TypeError: log.warn("data_files contains unexpected objects") def prune_file_list(self) -> None: super().prune_file_list() # Prevent accidental inclusion of test-related cache dirs at the project root sep = re.escape(os.sep) self.filelist.exclude_pattern(r"^(\.tox|\.nox|\.venv)" + sep, is_regex=True) def check_readme(self) -> None: for f in self.READMES: if os.path.exists(f): return else: self.warn( "standard file not found: should have one of " + ', '.join(self.READMES) ) def make_release_tree(self, base_dir, files) -> None: orig.sdist.make_release_tree(self, base_dir, files) # Save any egg_info command line options used to create this sdist dest = os.path.join(base_dir, 'setup.cfg') if hasattr(os, 'link') and os.path.exists(dest): # unlink and re-copy, since it might be hard-linked, and # we don't want to change the source version os.unlink(dest) self.copy_file('setup.cfg', dest) self.get_finalized_command('egg_info').save_version_info(dest) def _manifest_is_not_generated(self): # check for special comment used in 2.7.1 and higher if not os.path.isfile(self.manifest): return False with open(self.manifest, 'rb') as fp: first_line = fp.readline() return first_line != b'# file GENERATED by distutils, do NOT edit\n' def read_manifest(self): """Read the manifest file (named by 'self.manifest') and use it to fill in 'self.filelist', the list of files to include in the source distribution. """ log.info("reading manifest file '%s'", self.manifest) manifest = open(self.manifest, 'rb') for bytes_line in manifest: # The manifest must contain UTF-8. See #303. try: line = bytes_line.decode('UTF-8') except UnicodeDecodeError: log.warn(f"{line!r} not UTF-8 decodable -- skipping") continue # ignore comments and blank lines line = line.strip() if line.startswith('#') or not line: continue self.filelist.append(line) manifest.close() command/alias.py 0000644 00000004514 15030122015 0007616 0 ustar 00 from setuptools.command.setopt import config_file, edit_config, option_base from distutils.errors import DistutilsOptionError def shquote(arg): """Quote an argument for later parsing by shlex.split()""" for c in '"', "'", "\\", "#": if c in arg: return repr(arg) if arg.split() != [arg]: return repr(arg) return arg class alias(option_base): """Define a shortcut that invokes one or more commands""" description = "define a shortcut to invoke one or more commands" command_consumes_arguments = True user_options = [ ('remove', 'r', 'remove (unset) the alias'), ] + option_base.user_options boolean_options = option_base.boolean_options + ['remove'] def initialize_options(self): option_base.initialize_options(self) self.args = None self.remove = None def finalize_options(self) -> None: option_base.finalize_options(self) if self.remove and len(self.args) != 1: raise DistutilsOptionError( "Must specify exactly one argument (the alias name) when using --remove" ) def run(self) -> None: aliases = self.distribution.get_option_dict('aliases') if not self.args: print("Command Aliases") print("---------------") for alias in aliases: print("setup.py alias", format_alias(alias, aliases)) return elif len(self.args) == 1: (alias,) = self.args if self.remove: command = None elif alias in aliases: print("setup.py alias", format_alias(alias, aliases)) return else: print(f"No alias definition found for {alias!r}") return else: alias = self.args[0] command = ' '.join(map(shquote, self.args[1:])) edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run) def format_alias(name, aliases): source, command = aliases[name] if source == config_file('global'): source = '--global-config ' elif source == config_file('user'): source = '--user-config ' elif source == config_file('local'): source = '' else: source = f'--filename={source!r}' return source + name + ' ' + command command/build_clib.py 0000644 00000010660 15030122015 0010614 0 ustar 00 from ..dist import Distribution from ..modified import newer_pairwise_group import distutils.command.build_clib as orig from distutils import log from distutils.errors import DistutilsSetupError class build_clib(orig.build_clib): """ Override the default build_clib behaviour to do the following: 1. Implement a rudimentary timestamp-based dependency system so 'compile()' doesn't run every time. 2. Add more keys to the 'build_info' dictionary: * obj_deps - specify dependencies for each object compiled. this should be a dictionary mapping a key with the source filename to a list of dependencies. Use an empty string for global dependencies. * cflags - specify a list of additional flags to pass to the compiler. """ distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution def build_libraries(self, libraries) -> None: for lib_name, build_info in libraries: sources = build_info.get('sources') if sources is None or not isinstance(sources, (list, tuple)): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'sources' must be present and must be " "a list of source filenames" ) sources = sorted(list(sources)) log.info("building '%s' library", lib_name) # Make sure everything is the correct type. # obj_deps should be a dictionary of keys as sources # and a list/tuple of files that are its dependencies. obj_deps = build_info.get('obj_deps', dict()) if not isinstance(obj_deps, dict): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'obj_deps' must be a dictionary of " "type 'source: list'" ) dependencies = [] # Get the global dependencies that are specified by the '' key. # These will go into every source's dependency list. global_deps = obj_deps.get('', list()) if not isinstance(global_deps, (list, tuple)): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'obj_deps' must be a dictionary of " "type 'source: list'" ) # Build the list to be used by newer_pairwise_group # each source will be auto-added to its dependencies. for source in sources: src_deps = [source] src_deps.extend(global_deps) extra_deps = obj_deps.get(source, list()) if not isinstance(extra_deps, (list, tuple)): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'obj_deps' must be a dictionary of " "type 'source: list'" ) src_deps.extend(extra_deps) dependencies.append(src_deps) expected_objects = self.compiler.object_filenames( sources, output_dir=self.build_temp, ) if newer_pairwise_group(dependencies, expected_objects) != ([], []): # First, compile the source code to object files in the library # directory. (This should probably change to putting object # files in a temporary build directory.) macros = build_info.get('macros') include_dirs = build_info.get('include_dirs') cflags = build_info.get('cflags') self.compiler.compile( sources, output_dir=self.build_temp, macros=macros, include_dirs=include_dirs, extra_postargs=cflags, debug=self.debug, ) # Now "link" the object files together into a static library. # (On Unix at least, this isn't really linking -- it just # builds an archive. Whatever.) self.compiler.create_static_lib( expected_objects, lib_name, output_dir=self.build_clib, debug=self.debug ) command/install_scripts.py 0000644 00000005115 15030122015 0011740 0 ustar 00 from __future__ import annotations import os import sys from .._path import ensure_directory from ..dist import Distribution import distutils.command.install_scripts as orig from distutils import log class install_scripts(orig.install_scripts): """Do normal script install, plus any egg_info wrapper scripts""" distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution def initialize_options(self) -> None: orig.install_scripts.initialize_options(self) self.no_ep = False def run(self) -> None: self.run_command("egg_info") if self.distribution.scripts: orig.install_scripts.run(self) # run first to set up self.outfiles else: self.outfiles: list[str] = [] if self.no_ep: # don't install entry point scripts into .egg file! return self._install_ep_scripts() def _install_ep_scripts(self): # Delay import side-effects from pkg_resources import Distribution, PathMetadata from . import easy_install as ei ei_cmd = self.get_finalized_command("egg_info") dist = Distribution( ei_cmd.egg_base, PathMetadata(ei_cmd.egg_base, ei_cmd.egg_info), ei_cmd.egg_name, ei_cmd.egg_version, ) bs_cmd = self.get_finalized_command('build_scripts') exec_param = getattr(bs_cmd, 'executable', None) writer = ei.ScriptWriter if exec_param == sys.executable: # In case the path to the Python executable contains a space, wrap # it so it's not split up. exec_param = [exec_param] # resolve the writer to the environment writer = writer.best() cmd = writer.command_spec_class.best().from_param(exec_param) for args in writer.get_args(dist, cmd.as_header()): self.write_script(*args) def write_script(self, script_name, contents, mode: str = "t", *ignored) -> None: """Write an executable file to the scripts directory""" from setuptools.command.easy_install import chmod, current_umask log.info("Installing %s script to %s", script_name, self.install_dir) target = os.path.join(self.install_dir, script_name) self.outfiles.append(target) encoding = None if "b" in mode else "utf-8" mask = current_umask() if not self.dry_run: ensure_directory(target) with open(target, "w" + mode, encoding=encoding) as f: f.write(contents) chmod(target, 0o777 - mask) command/bdist_rpm.py 0000644 00000002633 15030122015 0010510 0 ustar 00 from ..dist import Distribution from ..warnings import SetuptoolsDeprecationWarning import distutils.command.bdist_rpm as orig class bdist_rpm(orig.bdist_rpm): """ Override the default bdist_rpm behavior to do the following: 1. Run egg_info to ensure the name and version are properly calculated. 2. Always run 'install' using --single-version-externally-managed to disable eggs in RPM distributions. """ distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution def run(self) -> None: SetuptoolsDeprecationWarning.emit( "Deprecated command", """ bdist_rpm is deprecated and will be removed in a future version. Use bdist_wheel (wheel packages) instead. """, see_url="https://github.com/pypa/setuptools/issues/1988", due_date=(2023, 10, 30), # Deprecation introduced in 22 Oct 2021. ) # ensure distro name is up-to-date self.run_command('egg_info') orig.bdist_rpm.run(self) def _make_spec_file(self): spec = orig.bdist_rpm._make_spec_file(self) return [ line.replace( "setup.py install ", "setup.py install --single-version-externally-managed ", ).replace("%setup", "%setup -n %{name}-%{unmangled_version}") for line in spec ] command/editable_wheel.py 0000644 00000105450 15030122015 0011463 0 ustar 00 """ Create a wheel that, when installed, will make the source package 'editable' (add it to the interpreter's path, including metadata) per PEP 660. Replaces 'setup.py develop'. .. note:: One of the mechanisms briefly mentioned in PEP 660 to implement editable installs is to create a separated directory inside ``build`` and use a .pth file to point to that directory. In the context of this file such directory is referred as *auxiliary build directory* or ``auxiliary_dir``. """ from __future__ import annotations import io import logging import os import shutil import traceback from collections.abc import Iterable, Iterator, Mapping from contextlib import suppress from enum import Enum from inspect import cleandoc from itertools import chain, starmap from pathlib import Path from tempfile import TemporaryDirectory from types import TracebackType from typing import TYPE_CHECKING, Protocol, TypeVar, cast from .. import Command, _normalization, _path, _shutil, errors, namespaces from .._path import StrPath from ..compat import py312 from ..discovery import find_package_path from ..dist import Distribution from ..warnings import InformationOnly, SetuptoolsDeprecationWarning, SetuptoolsWarning from .build import build as build_cls from .build_py import build_py as build_py_cls from .dist_info import dist_info as dist_info_cls from .egg_info import egg_info as egg_info_cls from .install import install as install_cls from .install_scripts import install_scripts as install_scripts_cls if TYPE_CHECKING: from typing_extensions import Self from .._vendor.wheel.wheelfile import WheelFile _P = TypeVar("_P", bound=StrPath) _logger = logging.getLogger(__name__) class _EditableMode(Enum): """ Possible editable installation modes: `lenient` (new files automatically added to the package - DEFAULT); `strict` (requires a new installation when files are added/removed); or `compat` (attempts to emulate `python setup.py develop` - DEPRECATED). """ STRICT = "strict" LENIENT = "lenient" COMPAT = "compat" # TODO: Remove `compat` after Dec/2022. @classmethod def convert(cls, mode: str | None) -> _EditableMode: if not mode: return _EditableMode.LENIENT # default _mode = mode.upper() if _mode not in _EditableMode.__members__: raise errors.OptionError(f"Invalid editable mode: {mode!r}. Try: 'strict'.") if _mode == "COMPAT": SetuptoolsDeprecationWarning.emit( "Compat editable installs", """ The 'compat' editable mode is transitional and will be removed in future versions of `setuptools`. Please adapt your code accordingly to use either the 'strict' or the 'lenient' modes. """, see_docs="userguide/development_mode.html", # TODO: define due_date # There is a series of shortcomings with the available editable install # methods, and they are very controversial. This is something that still # needs work. # Moreover, `pip` is still hiding this warning, so users are not aware. ) return _EditableMode[_mode] _STRICT_WARNING = """ New or renamed files may not be automatically picked up without a new installation. """ _LENIENT_WARNING = """ Options like `package-data`, `include/exclude-package-data` or `packages.find.exclude/include` may have no effect. """ class editable_wheel(Command): """Build 'editable' wheel for development. This command is private and reserved for internal use of setuptools, users should rely on ``setuptools.build_meta`` APIs. """ description = "DO NOT CALL DIRECTLY, INTERNAL ONLY: create PEP 660 editable wheel" user_options = [ ("dist-dir=", "d", "directory to put final built distributions in"), ("dist-info-dir=", "I", "path to a pre-build .dist-info directory"), ("mode=", None, cleandoc(_EditableMode.__doc__ or "")), ] def initialize_options(self): self.dist_dir = None self.dist_info_dir = None self.project_dir = None self.mode = None def finalize_options(self) -> None: dist = self.distribution self.project_dir = dist.src_root or os.curdir self.package_dir = dist.package_dir or {} self.dist_dir = Path(self.dist_dir or os.path.join(self.project_dir, "dist")) def run(self) -> None: try: self.dist_dir.mkdir(exist_ok=True) self._ensure_dist_info() # Add missing dist_info files self.reinitialize_command("bdist_wheel") bdist_wheel = self.get_finalized_command("bdist_wheel") bdist_wheel.write_wheelfile(self.dist_info_dir) self._create_wheel_file(bdist_wheel) except Exception: traceback.print_exc() project = self.distribution.name or self.distribution.get_name() _DebuggingTips.emit(project=project) raise def _ensure_dist_info(self): if self.dist_info_dir is None: dist_info = cast(dist_info_cls, self.reinitialize_command("dist_info")) dist_info.output_dir = self.dist_dir dist_info.ensure_finalized() dist_info.run() self.dist_info_dir = dist_info.dist_info_dir else: assert str(self.dist_info_dir).endswith(".dist-info") assert Path(self.dist_info_dir, "METADATA").exists() def _install_namespaces(self, installation_dir, pth_prefix): # XXX: Only required to support the deprecated namespace practice dist = self.distribution if not dist.namespace_packages: return src_root = Path(self.project_dir, self.package_dir.get("", ".")).resolve() installer = _NamespaceInstaller(dist, installation_dir, pth_prefix, src_root) installer.install_namespaces() def _find_egg_info_dir(self) -> str | None: parent_dir = Path(self.dist_info_dir).parent if self.dist_info_dir else Path() candidates = map(str, parent_dir.glob("*.egg-info")) return next(candidates, None) def _configure_build( self, name: str, unpacked_wheel: StrPath, build_lib: StrPath, tmp_dir: StrPath ): """Configure commands to behave in the following ways: - Build commands can write to ``build_lib`` if they really want to... (but this folder is expected to be ignored and modules are expected to live in the project directory...) - Binary extensions should be built in-place (editable_mode = True) - Data/header/script files are not part of the "editable" specification so they are written directly to the unpacked_wheel directory. """ # Non-editable files (data, headers, scripts) are written directly to the # unpacked_wheel dist = self.distribution wheel = str(unpacked_wheel) build_lib = str(build_lib) data = str(Path(unpacked_wheel, f"{name}.data", "data")) headers = str(Path(unpacked_wheel, f"{name}.data", "headers")) scripts = str(Path(unpacked_wheel, f"{name}.data", "scripts")) # egg-info may be generated again to create a manifest (used for package data) egg_info = cast( egg_info_cls, dist.reinitialize_command("egg_info", reinit_subcommands=True) ) egg_info.egg_base = str(tmp_dir) egg_info.ignore_egg_info_in_manifest = True build = cast( build_cls, dist.reinitialize_command("build", reinit_subcommands=True) ) install = cast( install_cls, dist.reinitialize_command("install", reinit_subcommands=True) ) build.build_platlib = build.build_purelib = build.build_lib = build_lib install.install_purelib = install.install_platlib = install.install_lib = wheel install.install_scripts = build.build_scripts = scripts install.install_headers = headers install.install_data = data install_scripts = cast( install_scripts_cls, dist.get_command_obj("install_scripts") ) install_scripts.no_ep = True build.build_temp = str(tmp_dir) build_py = cast(build_py_cls, dist.get_command_obj("build_py")) build_py.compile = False build_py.existing_egg_info_dir = self._find_egg_info_dir() self._set_editable_mode() build.ensure_finalized() install.ensure_finalized() def _set_editable_mode(self): """Set the ``editable_mode`` flag in the build sub-commands""" dist = self.distribution build = dist.get_command_obj("build") for cmd_name in build.get_sub_commands(): cmd = dist.get_command_obj(cmd_name) if hasattr(cmd, "editable_mode"): cmd.editable_mode = True elif hasattr(cmd, "inplace"): cmd.inplace = True # backward compatibility with distutils def _collect_build_outputs(self) -> tuple[list[str], dict[str, str]]: files: list[str] = [] mapping: dict[str, str] = {} build = self.get_finalized_command("build") for cmd_name in build.get_sub_commands(): cmd = self.get_finalized_command(cmd_name) if hasattr(cmd, "get_outputs"): files.extend(cmd.get_outputs() or []) if hasattr(cmd, "get_output_mapping"): mapping.update(cmd.get_output_mapping() or {}) return files, mapping def _run_build_commands( self, dist_name: str, unpacked_wheel: StrPath, build_lib: StrPath, tmp_dir: StrPath, ) -> tuple[list[str], dict[str, str]]: self._configure_build(dist_name, unpacked_wheel, build_lib, tmp_dir) self._run_build_subcommands() files, mapping = self._collect_build_outputs() self._run_install("headers") self._run_install("scripts") self._run_install("data") return files, mapping def _run_build_subcommands(self) -> None: """ Issue #3501 indicates that some plugins/customizations might rely on: 1. ``build_py`` not running 2. ``build_py`` always copying files to ``build_lib`` However both these assumptions may be false in editable_wheel. This method implements a temporary workaround to support the ecosystem while the implementations catch up. """ # TODO: Once plugins/customizations had the chance to catch up, replace # `self._run_build_subcommands()` with `self.run_command("build")`. # Also remove _safely_run, TestCustomBuildPy. Suggested date: Aug/2023. build = self.get_finalized_command("build") for name in build.get_sub_commands(): cmd = self.get_finalized_command(name) if name == "build_py" and type(cmd) is not build_py_cls: self._safely_run(name) else: self.run_command(name) def _safely_run(self, cmd_name: str): try: return self.run_command(cmd_name) except Exception: SetuptoolsDeprecationWarning.emit( "Customization incompatible with editable install", f""" {traceback.format_exc()} If you are seeing this warning it is very likely that a setuptools plugin or customization overrides the `{cmd_name}` command, without taking into consideration how editable installs run build steps starting from setuptools v64.0.0. Plugin authors and developers relying on custom build steps are encouraged to update their `{cmd_name}` implementation considering the information about editable installs in https://setuptools.pypa.io/en/latest/userguide/extension.html. For the time being `setuptools` will silence this error and ignore the faulty command, but this behavior will change in future versions. """, # TODO: define due_date # There is a series of shortcomings with the available editable install # methods, and they are very controversial. This is something that still # needs work. ) def _create_wheel_file(self, bdist_wheel): from wheel.wheelfile import WheelFile dist_info = self.get_finalized_command("dist_info") dist_name = dist_info.name tag = "-".join(bdist_wheel.get_tag()) build_tag = "0.editable" # According to PEP 427 needs to start with digit archive_name = f"{dist_name}-{build_tag}-{tag}.whl" wheel_path = Path(self.dist_dir, archive_name) if wheel_path.exists(): wheel_path.unlink() unpacked_wheel = TemporaryDirectory(suffix=archive_name) build_lib = TemporaryDirectory(suffix=".build-lib") build_tmp = TemporaryDirectory(suffix=".build-temp") with unpacked_wheel as unpacked, build_lib as lib, build_tmp as tmp: unpacked_dist_info = Path(unpacked, Path(self.dist_info_dir).name) shutil.copytree(self.dist_info_dir, unpacked_dist_info) self._install_namespaces(unpacked, dist_name) files, mapping = self._run_build_commands(dist_name, unpacked, lib, tmp) strategy = self._select_strategy(dist_name, tag, lib) with strategy, WheelFile(wheel_path, "w") as wheel_obj: strategy(wheel_obj, files, mapping) wheel_obj.write_files(unpacked) return wheel_path def _run_install(self, category: str): has_category = getattr(self.distribution, f"has_{category}", None) if has_category and has_category(): _logger.info(f"Installing {category} as non editable") self.run_command(f"install_{category}") def _select_strategy( self, name: str, tag: str, build_lib: StrPath, ) -> EditableStrategy: """Decides which strategy to use to implement an editable installation.""" build_name = f"__editable__.{name}-{tag}" project_dir = Path(self.project_dir) mode = _EditableMode.convert(self.mode) if mode is _EditableMode.STRICT: auxiliary_dir = _empty_dir(Path(self.project_dir, "build", build_name)) return _LinkTree(self.distribution, name, auxiliary_dir, build_lib) packages = _find_packages(self.distribution) has_simple_layout = _simple_layout(packages, self.package_dir, project_dir) is_compat_mode = mode is _EditableMode.COMPAT if set(self.package_dir) == {""} and has_simple_layout or is_compat_mode: # src-layout(ish) is relatively safe for a simple pth file src_dir = self.package_dir.get("", ".") return _StaticPth(self.distribution, name, [Path(project_dir, src_dir)]) # Use a MetaPathFinder to avoid adding accidental top-level packages/modules return _TopLevelFinder(self.distribution, name) class EditableStrategy(Protocol): def __call__( self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str] ) -> object: ... def __enter__(self) -> Self: ... def __exit__( self, _exc_type: type[BaseException] | None, _exc_value: BaseException | None, _traceback: TracebackType | None, ) -> object: ... class _StaticPth: def __init__(self, dist: Distribution, name: str, path_entries: list[Path]) -> None: self.dist = dist self.name = name self.path_entries = path_entries def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): entries = "\n".join(str(p.resolve()) for p in self.path_entries) contents = _encode_pth(f"{entries}\n") wheel.writestr(f"__editable__.{self.name}.pth", contents) def __enter__(self) -> Self: msg = f""" Editable install will be performed using .pth file to extend `sys.path` with: {list(map(os.fspath, self.path_entries))!r} """ _logger.warning(msg + _LENIENT_WARNING) return self def __exit__( self, _exc_type: object, _exc_value: object, _traceback: object, ) -> None: pass class _LinkTree(_StaticPth): """ Creates a ``.pth`` file that points to a link tree in the ``auxiliary_dir``. This strategy will only link files (not dirs), so it can be implemented in any OS, even if that means using hardlinks instead of symlinks. By collocating ``auxiliary_dir`` and the original source code, limitations with hardlinks should be avoided. """ def __init__( self, dist: Distribution, name: str, auxiliary_dir: StrPath, build_lib: StrPath, ) -> None: self.auxiliary_dir = Path(auxiliary_dir) self.build_lib = Path(build_lib).resolve() self._file = dist.get_command_obj("build_py").copy_file super().__init__(dist, name, [self.auxiliary_dir]) def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): self._create_links(files, mapping) super().__call__(wheel, files, mapping) def _normalize_output(self, file: str) -> str | None: # Files relative to build_lib will be normalized to None with suppress(ValueError): path = Path(file).resolve().relative_to(self.build_lib) return str(path).replace(os.sep, '/') return None def _create_file(self, relative_output: str, src_file: str, link=None): dest = self.auxiliary_dir / relative_output if not dest.parent.is_dir(): dest.parent.mkdir(parents=True) self._file(src_file, dest, link=link) def _create_links(self, outputs, output_mapping: Mapping[str, str]): self.auxiliary_dir.mkdir(parents=True, exist_ok=True) link_type = "sym" if _can_symlink_files(self.auxiliary_dir) else "hard" normalised = ((self._normalize_output(k), v) for k, v in output_mapping.items()) # remove files that are not relative to build_lib mappings = {k: v for k, v in normalised if k is not None} for output in outputs: relative = self._normalize_output(output) if relative and relative not in mappings: self._create_file(relative, output) for relative, src in mappings.items(): self._create_file(relative, src, link=link_type) def __enter__(self) -> Self: msg = "Strict editable install will be performed using a link tree.\n" _logger.warning(msg + _STRICT_WARNING) return self def __exit__( self, _exc_type: object, _exc_value: object, _traceback: object, ) -> None: msg = f"""\n Strict editable installation performed using the auxiliary directory: {self.auxiliary_dir} Please be careful to not remove this directory, otherwise you might not be able to import/use your package. """ InformationOnly.emit("Editable installation.", msg) class _TopLevelFinder: def __init__(self, dist: Distribution, name: str) -> None: self.dist = dist self.name = name def template_vars(self) -> tuple[str, str, dict[str, str], dict[str, list[str]]]: src_root = self.dist.src_root or os.curdir top_level = chain(_find_packages(self.dist), _find_top_level_modules(self.dist)) package_dir = self.dist.package_dir or {} roots = _find_package_roots(top_level, package_dir, src_root) namespaces_ = dict( chain( _find_namespaces(self.dist.packages or [], roots), ((ns, []) for ns in _find_virtual_namespaces(roots)), ) ) legacy_namespaces = { pkg: find_package_path(pkg, roots, self.dist.src_root or "") for pkg in self.dist.namespace_packages or [] } mapping = {**roots, **legacy_namespaces} # ^-- We need to explicitly add the legacy_namespaces to the mapping to be # able to import their modules even if another package sharing the same # namespace is installed in a conventional (non-editable) way. name = f"__editable__.{self.name}.finder" finder = _normalization.safe_identifier(name) return finder, name, mapping, namespaces_ def get_implementation(self) -> Iterator[tuple[str, bytes]]: finder, name, mapping, namespaces_ = self.template_vars() content = bytes(_finder_template(name, mapping, namespaces_), "utf-8") yield (f"{finder}.py", content) content = _encode_pth(f"import {finder}; {finder}.install()") yield (f"__editable__.{self.name}.pth", content) def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): for file, content in self.get_implementation(): wheel.writestr(file, content) def __enter__(self) -> Self: msg = "Editable install will be performed using a meta path finder.\n" _logger.warning(msg + _LENIENT_WARNING) return self def __exit__( self, _exc_type: object, _exc_value: object, _traceback: object, ) -> None: msg = """\n Please be careful with folders in your working directory with the same name as your package as they may take precedence during imports. """ InformationOnly.emit("Editable installation.", msg) def _encode_pth(content: str) -> bytes: """ Prior to Python 3.13 (see https://github.com/python/cpython/issues/77102), .pth files are always read with 'locale' encoding, the recommendation from the cpython core developers is to write them as ``open(path, "w")`` and ignore warnings (see python/cpython#77102, pypa/setuptools#3937). This function tries to simulate this behavior without having to create an actual file, in a way that supports a range of active Python versions. (There seems to be some variety in the way different version of Python handle ``encoding=None``, not all of them use ``locale.getpreferredencoding(False)`` or ``locale.getencoding()``). """ with io.BytesIO() as buffer: wrapper = io.TextIOWrapper(buffer, encoding=py312.PTH_ENCODING) # TODO: Python 3.13 replace the whole function with `bytes(content, "utf-8")` wrapper.write(content) wrapper.flush() buffer.seek(0) return buffer.read() def _can_symlink_files(base_dir: Path) -> bool: with TemporaryDirectory(dir=str(base_dir.resolve())) as tmp: path1, path2 = Path(tmp, "file1.txt"), Path(tmp, "file2.txt") path1.write_text("file1", encoding="utf-8") with suppress(AttributeError, NotImplementedError, OSError): os.symlink(path1, path2) if path2.is_symlink() and path2.read_text(encoding="utf-8") == "file1": return True try: os.link(path1, path2) # Ensure hard links can be created except Exception as ex: msg = ( "File system does not seem to support either symlinks or hard links. " "Strict editable installs require one of them to be supported." ) raise LinksNotSupported(msg) from ex return False def _simple_layout( packages: Iterable[str], package_dir: dict[str, str], project_dir: StrPath ) -> bool: """Return ``True`` if: - all packages are contained by the same parent directory, **and** - all packages become importable if the parent directory is added to ``sys.path``. >>> _simple_layout(['a'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.b'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.b'], {}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"": "src"}, "/tmp/myproj") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "a", "b": "b"}, ".") True >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a", "b": "_b"}, ".") False >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a"}, "/tmp/myproj") False >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a.a1.a2": "_a2"}, ".") False >>> _simple_layout(['a', 'a.b'], {"": "src", "a.b": "_ab"}, "/tmp/myproj") False >>> # Special cases, no packages yet: >>> _simple_layout([], {"": "src"}, "/tmp/myproj") True >>> _simple_layout([], {"a": "_a", "": "src"}, "/tmp/myproj") False """ layout = {pkg: find_package_path(pkg, package_dir, project_dir) for pkg in packages} if not layout: return set(package_dir) in ({}, {""}) parent = os.path.commonpath(starmap(_parent_path, layout.items())) return all( _path.same_path(Path(parent, *key.split('.')), value) for key, value in layout.items() ) def _parent_path(pkg, pkg_path): """Infer the parent path containing a package, that if added to ``sys.path`` would allow importing that package. When ``pkg`` is directly mapped into a directory with a different name, return its own path. >>> _parent_path("a", "src/a") 'src' >>> _parent_path("b", "src/c") 'src/c' """ parent = pkg_path[: -len(pkg)] if pkg_path.endswith(pkg) else pkg_path return parent.rstrip("/" + os.sep) def _find_packages(dist: Distribution) -> Iterator[str]: yield from iter(dist.packages or []) py_modules = dist.py_modules or [] nested_modules = [mod for mod in py_modules if "." in mod] if dist.ext_package: yield dist.ext_package else: ext_modules = dist.ext_modules or [] nested_modules += [x.name for x in ext_modules if "." in x.name] for module in nested_modules: package, _, _ = module.rpartition(".") yield package def _find_top_level_modules(dist: Distribution) -> Iterator[str]: py_modules = dist.py_modules or [] yield from (mod for mod in py_modules if "." not in mod) if not dist.ext_package: ext_modules = dist.ext_modules or [] yield from (x.name for x in ext_modules if "." not in x.name) def _find_package_roots( packages: Iterable[str], package_dir: Mapping[str, str], src_root: StrPath, ) -> dict[str, str]: pkg_roots: dict[str, str] = { pkg: _absolute_root(find_package_path(pkg, package_dir, src_root)) for pkg in sorted(packages) } return _remove_nested(pkg_roots) def _absolute_root(path: StrPath) -> str: """Works for packages and top-level modules""" path_ = Path(path) parent = path_.parent if path_.exists(): return str(path_.resolve()) else: return str(parent.resolve() / path_.name) def _find_virtual_namespaces(pkg_roots: dict[str, str]) -> Iterator[str]: """By carefully designing ``package_dir``, it is possible to implement the logical structure of PEP 420 in a package without the corresponding directories. Moreover a parent package can be purposefully/accidentally skipped in the discovery phase (e.g. ``find_packages(include=["mypkg.*"])``, when ``mypkg.foo`` is included by ``mypkg`` itself is not). We consider this case to also be a virtual namespace (ignoring the original directory) to emulate a non-editable installation. This function will try to find these kinds of namespaces. """ for pkg in pkg_roots: if "." not in pkg: continue parts = pkg.split(".") for i in range(len(parts) - 1, 0, -1): partial_name = ".".join(parts[:i]) path = Path(find_package_path(partial_name, pkg_roots, "")) if not path.exists() or partial_name not in pkg_roots: # partial_name not in pkg_roots ==> purposefully/accidentally skipped yield partial_name def _find_namespaces( packages: list[str], pkg_roots: dict[str, str] ) -> Iterator[tuple[str, list[str]]]: for pkg in packages: path = find_package_path(pkg, pkg_roots, "") if Path(path).exists() and not Path(path, "__init__.py").exists(): yield (pkg, [path]) def _remove_nested(pkg_roots: dict[str, str]) -> dict[str, str]: output = dict(pkg_roots.copy()) for pkg, path in reversed(list(pkg_roots.items())): if any( pkg != other and _is_nested(pkg, path, other, other_path) for other, other_path in pkg_roots.items() ): output.pop(pkg) return output def _is_nested(pkg: str, pkg_path: str, parent: str, parent_path: str) -> bool: """ Return ``True`` if ``pkg`` is nested inside ``parent`` both logically and in the file system. >>> _is_nested("a.b", "path/a/b", "a", "path/a") True >>> _is_nested("a.b", "path/a/b", "a", "otherpath/a") False >>> _is_nested("a.b", "path/a/b", "c", "path/c") False >>> _is_nested("a.a", "path/a/a", "a", "path/a") True >>> _is_nested("b.a", "path/b/a", "a", "path/a") False """ norm_pkg_path = _path.normpath(pkg_path) rest = pkg.replace(parent, "", 1).strip(".").split(".") return pkg.startswith(parent) and norm_pkg_path == _path.normpath( Path(parent_path, *rest) ) def _empty_dir(dir_: _P) -> _P: """Create a directory ensured to be empty. Existing files may be removed.""" _shutil.rmtree(dir_, ignore_errors=True) os.makedirs(dir_) return dir_ class _NamespaceInstaller(namespaces.Installer): def __init__(self, distribution, installation_dir, editable_name, src_root) -> None: self.distribution = distribution self.src_root = src_root self.installation_dir = installation_dir self.editable_name = editable_name self.outputs: list[str] = [] self.dry_run = False def _get_nspkg_file(self): """Installation target.""" return os.path.join(self.installation_dir, self.editable_name + self.nspkg_ext) def _get_root(self): """Where the modules/packages should be loaded from.""" return repr(str(self.src_root)) _FINDER_TEMPLATE = """\ from __future__ import annotations import sys from importlib.machinery import ModuleSpec, PathFinder from importlib.machinery import all_suffixes as module_suffixes from importlib.util import spec_from_file_location from itertools import chain from pathlib import Path MAPPING: dict[str, str] = {mapping!r} NAMESPACES: dict[str, list[str]] = {namespaces!r} PATH_PLACEHOLDER = {name!r} + ".__path_hook__" class _EditableFinder: # MetaPathFinder @classmethod def find_spec(cls, fullname: str, path=None, target=None) -> ModuleSpec | None: # type: ignore # Top-level packages and modules (we know these exist in the FS) if fullname in MAPPING: pkg_path = MAPPING[fullname] return cls._find_spec(fullname, Path(pkg_path)) # Handle immediate children modules (required for namespaces to work) # To avoid problems with case sensitivity in the file system we delegate # to the importlib.machinery implementation. parent, _, child = fullname.rpartition(".") if parent and parent in MAPPING: return PathFinder.find_spec(fullname, path=[MAPPING[parent]]) # Other levels of nesting should be handled automatically by importlib # using the parent path. return None @classmethod def _find_spec(cls, fullname: str, candidate_path: Path) -> ModuleSpec | None: init = candidate_path / "__init__.py" candidates = (candidate_path.with_suffix(x) for x in module_suffixes()) for candidate in chain([init], candidates): if candidate.exists(): return spec_from_file_location(fullname, candidate) return None class _EditableNamespaceFinder: # PathEntryFinder @classmethod def _path_hook(cls, path) -> type[_EditableNamespaceFinder]: if path == PATH_PLACEHOLDER: return cls raise ImportError @classmethod def _paths(cls, fullname: str) -> list[str]: paths = NAMESPACES[fullname] if not paths and fullname in MAPPING: paths = [MAPPING[fullname]] # Always add placeholder, for 2 reasons: # 1. __path__ cannot be empty for the spec to be considered namespace. # 2. In the case of nested namespaces, we need to force # import machinery to query _EditableNamespaceFinder again. return [*paths, PATH_PLACEHOLDER] @classmethod def find_spec(cls, fullname: str, target=None) -> ModuleSpec | None: # type: ignore if fullname in NAMESPACES: spec = ModuleSpec(fullname, None, is_package=True) spec.submodule_search_locations = cls._paths(fullname) return spec return None @classmethod def find_module(cls, _fullname) -> None: return None def install(): if not any(finder == _EditableFinder for finder in sys.meta_path): sys.meta_path.append(_EditableFinder) if not NAMESPACES: return if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks): # PathEntryFinder is needed to create NamespaceSpec without private APIS sys.path_hooks.append(_EditableNamespaceFinder._path_hook) if PATH_PLACEHOLDER not in sys.path: sys.path.append(PATH_PLACEHOLDER) # Used just to trigger the path hook """ def _finder_template( name: str, mapping: Mapping[str, str], namespaces: dict[str, list[str]] ) -> str: """Create a string containing the code for the``MetaPathFinder`` and ``PathEntryFinder``. """ mapping = dict(sorted(mapping.items(), key=lambda p: p[0])) return _FINDER_TEMPLATE.format(name=name, mapping=mapping, namespaces=namespaces) class LinksNotSupported(errors.FileError): """File system does not seem to support either symlinks or hard links.""" class _DebuggingTips(SetuptoolsWarning): _SUMMARY = "Problem in editable installation." _DETAILS = """ An error happened while installing `{project}` in editable mode. The following steps are recommended to help debug this problem: - Try to install the project normally, without using the editable mode. Does the error still persist? (If it does, try fixing the problem before attempting the editable mode). - If you are using binary extensions, make sure you have all OS-level dependencies installed (e.g. compilers, toolchains, binary libraries, ...). - Try the latest version of setuptools (maybe the error was already fixed). - If you (or your project dependencies) are using any setuptools extension or customization, make sure they support the editable mode. After following the steps above, if the problem still persists and you think this is related to how setuptools handles editable installations, please submit a reproducible example (see https://stackoverflow.com/help/minimal-reproducible-example) to: https://github.com/pypa/setuptools/issues """ _SEE_DOCS = "userguide/development_mode.html" command/__init__.py 0000644 00000001443 15030122015 0010262 0 ustar 00 # mypy: disable_error_code=call-overload # pyright: reportCallIssue=false, reportArgumentType=false # Can't disable on the exact line because distutils doesn't exists on Python 3.12 # and type-checkers aren't aware of distutils_hack, # causing distutils.command.bdist.bdist.format_commands to be Any. import sys from distutils.command.bdist import bdist if 'egg' not in bdist.format_commands: try: # format_commands is a dict in vendored distutils # It used to be a list in older (stdlib) distutils # We support both for backwards compatibility bdist.format_commands['egg'] = ('bdist_egg', "Python .egg file") except TypeError: bdist.format_command['egg'] = ('bdist_egg', "Python .egg file") bdist.format_commands.append('egg') del bdist, sys cli-64.exe 0000644 00000034000 15030122015 0006227 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ ��b�c�1�c�1�c�1�61�c�1 �0�c�1 X1�c�1 �0�c�1 �0�c�1 �0�c�1��0�c�1�c�1�c�1� �0�c�1� Z1�c�1� �0�c�1Rich�c�1 PE d� �'hd � " $ " @ @ � `� : � p � ` � � 0 5 �3 @ 0 P .text � `.rdata , 0 @ @.data H P 0 @ �.pdata � ` 2 @ @.rsrc � p 4 @ @.reloc 0 � 6 @ B H�)F ���������H��(��u� "@ ��t3� � H��(�������������H�T$L�D$L�L$ SVWH��0H��H�t$`H�����E3�H�t$ L��H��H���! H��0_^[������������E3��8 ��������H�\$H�l$H�t$H�|$ ATAVAWH�� H��L��H����� D H���< u�� �, 3�L��A�?L��3�H�� �3! ��t�KH��"! ��u��3H��@��ta@�� ! ��t��tO@��\u����@��"u �׃�u 3�������3����E���tL�Dz\I���$ L�3�@��t�A�6I��딅�tL�Dz\I��� L�3�A� I��Ic�AA�M�t�@��t,� �y ��t D �KH��c ��u�; �8���H�\$@I��H�l$HH�t$PH�|$XH�� A_A^A\�����H�\$H�l$H�t$H�|$ AVH�� H��H�����H�ǀ<9 u��?� Hc�H���� 3�Hc�L��� "H�X��~X�<\u���&<"u ��~���\D��H��� H�3��\H���3��H�ƈH��H��u���~���\D��H���� H�H�l$8I��H�t$@H�|$Hf�" H�\$0H�� A^�@UVWATH��$����H��H H� = H3�H�� D�D$dD��H�T$xA� �L$`H�U3� 3�H�MH�t$0E3��D$(� � ��D$ D�F�� E3�H�UH��A� �� H�MH�����H��@84u�H�MH�H�MH;�v�8.t@�0H�MH��H;�w�H�M@�0H��f�@8qH�Iu��� 3��u �f�A�p �A H�M�\ �����u$�H�" H��L�EH�L �G����G� H��$� H�� L��$8 A� ��L��$0 � Hc�H�� Hً�� H�� H�� D H��H;�s���t �� t�� u�A� @�0H�� H�� �� ��t)�� �� �� �� �� �� H�T$XH�� ����L��H�H�����tL��H����/uA� \���u�H�� H��L�� H�D$ L�� H�T$P�� @8t$P�� �� \�� H�� L�� H�D$ L�� H�T$PH�M�� H�� H�����@8tH�@u�D�� H�� A��\uD�A�H�A�HE�A��\t!ff � H�� H;�r @�0H�Ȁ8\u�L��H�t$ L�� H�T$PH�� � � � �( H�� �� � � H��A� H��L���" M��u(I� A�O�� L��H�6 H������A�G�W �|$X� L��$@ A�<Lc�L�l$hI�M�� I��H�D$XH�����H�H�s��~#I�^�� @ H� �h���H�H�[H��H��u�H�EH�����H�À< u��� Hc�H���> E3�Lc�H�D$pA��� "H�x��~lE3�f�B�D5<\u���(<"u!��~�ٲ\D��H���{ H�A���\H���A��B�D5I�ƈH��M;�|�L�l$h��~�ٲ\D��H���? H�E3�H�D$pf�" Hc|$`H�H��H��~%L�d$x� I� ��w���H�H��H��H;�|�|$d L�6t5H�T$XI��� � �M M��H�� H���s���� � H�����f�H��A�< u�L�d$X��I��~-A� f�K��H����� D H���< u���I���M;�|�Hcɺ �� M��H�� H��H��� H������H��A�< u�I��~F� fff � M��H�� Hc�H��J I� �H�����H���< u���H���I;�|�W�D�t$P3��E�h W�H�E�H� K����EE��PM�M�M�M�M�M�C H�E�E3�H�D$HE3�H�E�H��H�D$@3�L�t$8L�t$0D�t$(�D$ �� ��u�H�� H��H�� ����J�E������H�M���6 �� H�M�H�T$P�� ��u�H�� H��H�} ����D�t$PA��L��$@ L��$8 H��$� L��$0 H�� H3�� H��H A\_^]���H�T$L�D$L�L$ SVWH��0H��H�t$`H��� ���L��H�t$(H�����H�D$ L��H��H�H���� ��H�H��0_^[���H��(M�A8H��I��� � H��(����@SE�H��A��L��A� L��tA�@McP��L�Hc�L#�Ic�J�H�C�HH�C�Dt �D���L�L3�I��[� �����������ff � H; A5 uH��f����u�H��� ��@SH�� � �� �� ���� �� ��� � ��D ��ts�7 H� l �� � ��� ��uR� �� ��t H� ~ �m � � �j ��� � ��t�U �P � ��uH�� [ù � ���H��(�_ 3�H��(�H��(�7 � ��H��(�M ���H�\$H�t$WH��0� �/ ���6 @2�@�t$ �� �؋ �9 ���# ��uJ��9 H�� H� � � ��t �� �� H�_ H� H � �q9 �@�@�t$ ��� �� H��H�8 t H���n ��tE3�A�P3�H��� � H��H�8 tH���B ��tH� �T � H���� H��� L��H�Ӌ���� ��tU@��u� 3ұ� ������ ��t;�|$ u�� ��H�\$@H�t$HH��0_ù � �� � ��� ���� �H��(�� H��(�r�����@SH�� H��3�� H��� �� H�Ⱥ �H�� [H�%� H�L$H��8� � ��t� �)H� B3 � H�D$8H�)4 H�D$8H��H��3 H�4 H��2 H�D$@H��3 �]2 ��W2 �a2 � Hk� H� Y2 H� � Hk� H� �1 H�L � Hk�H� �1 H�L H� X ���H��8���@SVWH��@H��C H��� 3�E3�H�T$`H��� H��t9H�d$8 H�L$hH�T$`L��H�L$0L��H�L$pH�L$(3�H�\$ �� �ǃ�|�H��@_^[����H��(� ��t!eH�%0 H�H�H;�t3��H� �6 u�2�H��(ð����@SH�� ��6 �ɻ DÈ�6 � � ��u2��� ��u 3�� ���H�� [����@SH�� �=l6 ��ug��wj� ��t(��u$H� V6 � ��uH� ^6 � ��t.2��3fo H���%6 H�.6 �.6 H�76 �6 �H�� [ù �^ ��H��L���MZ f9 �uxHc <�H����Hʁ9PE u_� f9AuTL+��QH��H��AH� �L� �H�$I;�t�J L;�r �B�L;�rH��(��3�H��u2���z$ }2�� ��2��2�H���@SH�� ���� 3҅�t ��uH�.5 H�� [�@SH�� �=#5 ��t��u �6 ���/ �H�� [����@SH�� H�=�4 �H��u�B �H��H� �4 �+ 3҅�HD�H��H�� [���H��(���H������H��(��H�\$UH��H��0H��. H�2��-�+ H;�utH�e H�M�6 H�EH�E�0 ��H1E�, ��H�MH1E�$ �EH�M�H�� H3EH3E�H3�H������� H#�H�3��-�+ H;�HD�H�Q. H�\$PH��H�:. H��0]�3��̸ ��̸ @ ���H� )4 H�%� �̰��� �H�!4 �H��(��H�$���H�H��(��3�9�- ���H�4 �H�4 Ã%�3 �H�\$UH��$@���H�� �ٹ �F ��t���)� ����3�H�M�A�� � H�M�! H��� H��� H��E3��� H��t<H�d$8 H��� H��� L��H�L$0L��H��� H�L$(H�M�H�L$ 3�^ H��� H�L$PH��� 3�H��� A�� H��H��� �t H��� H�D$`�D$P @�D$T �: ��H�D$PH�D$@H�E���H�D$H3�� H�L$@�� ��u ��u�H���H��$� H�� ]���;������H��(3�� H��t9�MZ f9u/HcH<Hȁ9PE u � f9Au��� v ��� ���2�H��(����H� H�%b ��H�\$WH�� H�H���;csm�u �{u�S ���l�v�� @�t H�\$03�H�� _��^ H�H�_�X H��� ��H�\$WH�� H� H�=� �H�H��t�� H��H;�r�H�\$0H�� _�H�\$WH�� H� � H�=� �H�H��t�� H��H;�r�H�\$0H�� _�H�\$H�t$WH��3�3��D��E3�D��A��ntelA��ineID�ˋ�3�A�CE ��A��Genu�$E щ\$���L$�T$ u[H� �* �%�?�H��* � =� t(=` t!=p t������ w$H� H��sD��0 A��D��0 �D��0 � D�H�;�|&3���$D�ۉ\$�L$�T$ �� s E �D�r0 �T* D� Q* ���� D� <* � � 5* ��sy�� ss3��H�� H �H�T$ H�D$ "�:�uW�* ����) ��) A�� t8�� ��) ��) � �D#�D;�uH�D$ $�<�u � �) @� �) H�\$(3�H�t$0H��_�3�9�) ���������������%2 �%$ �%. �%0 �%� �%� �%� �%� �%j �%� �%� �%� �%� �%� �%� �%� �%� �%d �%n �%� �% �%� �%� �%0 �%2 �%� �%6 �%� �%� �%� �%� ������������ff � ����������������������ff � �%� @UH�� H��H�H�ы�����H�� ]��@UH��H�3Ɂ8 �����]�� 0= >= Z= p= �= �= �= �= �A �A B "B @B TB C �B �B �B �B �B �B hB �A �= �= > (> "C b> n> @ X> @ ? �@ @@ \@ �? �@ �? �? �? |> �? n? �> �> ? �? L? 2? x@ �? �@ �? �> �> �> �@ 0@ �@ �> �> �> �! @ �! @ `' @ �' @ �' @ D' @ � @ � @ � @ failed to create process. failed to get exit code from process. %s %s -script.py Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s PP @ �P @ ����������������@ P @ P2 @ `2 @ �5 @ X2 @ h2 @ p2 @ x2 @ �2 @ �'hd � �5 �! ���5 , �5 � / D � � � �" # �% & N& � � � �' 6 P .text$mn P' 6 .text$mn$00 �' 6 .text$x 0 P .idata$5 P2 8 .00cfg �2 .CRT$XCA �2 .CRT$XCAA �2 .CRT$XCZ �2 .CRT$XIA �2 .CRT$XIAA �2 .CRT$XIAC �2 .CRT$XIZ �2 .CRT$XPA �2 .CRT$XPZ �2 .CRT$XTA �2 .CRT$XTZ �2 � .rdata �5 \ .rdata$voltmd �5 � .rdata$zzzdbg `8 .rtc$IAA h8 .rtc$IZZ p8 .rtc$TAA x8 .rtc$TZZ �8 � .xdata : � .idata$2 �: .idata$3 �: P .idata$4 0= � .idata$6 P @ .data @P .bss ` � .pdata p ` .rsrc$01 `p � .rsrc$02 Rp`0 t d T 4 2� t d T 4 2��� B & � �p`P0 !' '�� �� 4� � �8 ! �� L �8 ! L �8 ! � �8 0 20 d 4 R p�& � � �' � & 8 �' � 2P b rp`0 " �& � u �' u P 4 RP 4� � P 4 2p d 4 p �: �= 0 �; F> �0 �; �@ 1 �; �@ �0 0< �@ P1 �< A �1 = >A 02 < `A 01 < �A 1 < �A @1 0= >= Z= p= �= �= �= �= �A �A B "B @B TB C �B �B �B �B �B �B hB �A �= �= > (> "C b> n> @ X> @ ? �@ @@ \@ �? �@ �? �? �? |> �? n? �> �> ? �? L? 2? x@ �? �@ �? �> �> �> �@ 0@ �@ �> �> �> � CreateFileA kGetFinalPathNameByHandleA WaitForSingleObject XGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll > memset __C_specific_handler __current_exception __current_exception_context VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace @ _seh_filter_exe B _set_app_type __setusermatherr _configure_narrow_argv 3 _initialize_narrow_environment ( _get_initial_narrow_environment 6 _initterm 7 _initterm_e U exit # _exit T _set_fmode _cexit _c_exit = _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 4 _initialize_onexit_table < _register_onexit_function _crt_atexit g terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �RtlCaptureContext �RtlLookupFunctionEntry RtlVirtualUnwind �UnhandledExceptionFilter �SetUnhandledExceptionFilter 2GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent pQueryPerformanceCounter 3GetCurrentProcessId 7GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW < memcpy �] �f��2��-�+ ���� 4 �8 @ � �8 � � �8 � �8 � �8 L �8 L � �8 � � 9 � � 9 � . �8 0 M �8 P � 09 � � 89 � � <9 � � �8 � � �8 � @ D9 @ R �8 T � <9 � Z �9 \ � �9 � �8 U <9 X � <9 � | �9 | � <9 � � <9 � ! <9 ! ! �8 ! �! �9 " " �8 @" �# �9 �# �# �8 �# S$ �9 T$ �$ �9 �$ �$ �9 �$ x& �9 `' b' �9 �' �' : �' �' |9 �' �' �9 � 0 � H `p } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 0 0 P�X�`�h�p�������������(�@�H�Ф�� �� config/pyprojecttoml.py 0000644 00000043620 15030122015 0011270 0 ustar 00 """ Load setuptools configuration from ``pyproject.toml`` files. **PRIVATE MODULE**: API reserved for setuptools internal usage only. To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``tomllib`` or ``tomli``. """ from __future__ import annotations import logging import os from collections.abc import Mapping from contextlib import contextmanager from functools import partial from types import TracebackType from typing import TYPE_CHECKING, Any, Callable from .._path import StrPath from ..errors import FileError, InvalidConfigError from ..warnings import SetuptoolsWarning from . import expand as _expand from ._apply_pyprojecttoml import _PREVIOUSLY_DEFINED, _MissingDynamic, apply as _apply if TYPE_CHECKING: from typing_extensions import Self from setuptools.dist import Distribution _logger = logging.getLogger(__name__) def load_file(filepath: StrPath) -> dict: from ..compat.py310 import tomllib with open(filepath, "rb") as file: return tomllib.load(file) def validate(config: dict, filepath: StrPath) -> bool: from . import _validate_pyproject as validator trove_classifier = validator.FORMAT_FUNCTIONS.get("trove-classifier") if hasattr(trove_classifier, "_disable_download"): # Improve reproducibility by default. See abravalheri/validate-pyproject#31 trove_classifier._disable_download() # type: ignore[union-attr] try: return validator.validate(config) except validator.ValidationError as ex: summary = f"configuration error: {ex.summary}" if ex.name.strip("`") != "project": # Probably it is just a field missing/misnamed, not worthy the verbosity... _logger.debug(summary) _logger.debug(ex.details) error = f"invalid pyproject.toml config: {ex.name}." raise ValueError(f"{error}\n{summary}") from None def apply_configuration( dist: Distribution, filepath: StrPath, ignore_option_errors: bool = False, ) -> Distribution: """Apply the configuration from a ``pyproject.toml`` file into an existing distribution object. """ config = read_configuration(filepath, True, ignore_option_errors, dist) return _apply(dist, config, filepath) def read_configuration( filepath: StrPath, expand: bool = True, ignore_option_errors: bool = False, dist: Distribution | None = None, ) -> dict[str, Any]: """Read given configuration file and returns options from it as a dict. :param str|unicode filepath: Path to configuration file in the ``pyproject.toml`` format. :param bool expand: Whether to expand directives and other computed values (i.e. post-process the given configuration) :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :param Distribution|None: Distribution object to which the configuration refers. If not given a dummy object will be created and discarded after the configuration is read. This is used for auto-discovery of packages and in the case a dynamic configuration (e.g. ``attr`` or ``cmdclass``) is expanded. When ``expand=False`` this object is simply ignored. :rtype: dict """ filepath = os.path.abspath(filepath) if not os.path.isfile(filepath): raise FileError(f"Configuration file {filepath!r} does not exist.") asdict = load_file(filepath) or {} project_table = asdict.get("project", {}) tool_table = asdict.get("tool", {}) setuptools_table = tool_table.get("setuptools", {}) if not asdict or not (project_table or setuptools_table): return {} # User is not using pyproject to configure setuptools if "setuptools" in asdict.get("tools", {}): # let the user know they probably have a typo in their metadata _ToolsTypoInMetadata.emit() if "distutils" in tool_table: _ExperimentalConfiguration.emit(subject="[tool.distutils]") # There is an overall sense in the community that making include_package_data=True # the default would be an improvement. # `ini2toml` backfills include_package_data=False when nothing is explicitly given, # therefore setting a default here is backwards compatible. if dist and dist.include_package_data is not None: setuptools_table.setdefault("include-package-data", dist.include_package_data) else: setuptools_table.setdefault("include-package-data", True) # Persist changes: asdict["tool"] = tool_table tool_table["setuptools"] = setuptools_table if "ext-modules" in setuptools_table: _ExperimentalConfiguration.emit(subject="[tool.setuptools.ext-modules]") with _ignore_errors(ignore_option_errors): # Don't complain about unrelated errors (e.g. tools not using the "tool" table) subset = {"project": project_table, "tool": {"setuptools": setuptools_table}} validate(subset, filepath) if expand: root_dir = os.path.dirname(filepath) return expand_configuration(asdict, root_dir, ignore_option_errors, dist) return asdict def expand_configuration( config: dict, root_dir: StrPath | None = None, ignore_option_errors: bool = False, dist: Distribution | None = None, ) -> dict: """Given a configuration with unresolved fields (e.g. dynamic, cmdclass, ...) find their final values. :param dict config: Dict containing the configuration for the distribution :param str root_dir: Top-level directory for the distribution/project (the same directory where ``pyproject.toml`` is place) :param bool ignore_option_errors: see :func:`read_configuration` :param Distribution|None: Distribution object to which the configuration refers. If not given a dummy object will be created and discarded after the configuration is read. Used in the case a dynamic configuration (e.g. ``attr`` or ``cmdclass``). :rtype: dict """ return _ConfigExpander(config, root_dir, ignore_option_errors, dist).expand() class _ConfigExpander: def __init__( self, config: dict, root_dir: StrPath | None = None, ignore_option_errors: bool = False, dist: Distribution | None = None, ) -> None: self.config = config self.root_dir = root_dir or os.getcwd() self.project_cfg = config.get("project", {}) self.dynamic = self.project_cfg.get("dynamic", []) self.setuptools_cfg = config.get("tool", {}).get("setuptools", {}) self.dynamic_cfg = self.setuptools_cfg.get("dynamic", {}) self.ignore_option_errors = ignore_option_errors self._dist = dist self._referenced_files = set[str]() def _ensure_dist(self) -> Distribution: from setuptools.dist import Distribution attrs = {"src_root": self.root_dir, "name": self.project_cfg.get("name", None)} return self._dist or Distribution(attrs) def _process_field(self, container: dict, field: str, fn: Callable): if field in container: with _ignore_errors(self.ignore_option_errors): container[field] = fn(container[field]) def _canonic_package_data(self, field="package-data"): package_data = self.setuptools_cfg.get(field, {}) return _expand.canonic_package_data(package_data) def expand(self): self._expand_packages() self._canonic_package_data() self._canonic_package_data("exclude-package-data") # A distribution object is required for discovering the correct package_dir dist = self._ensure_dist() ctx = _EnsurePackagesDiscovered(dist, self.project_cfg, self.setuptools_cfg) with ctx as ensure_discovered: package_dir = ensure_discovered.package_dir self._expand_data_files() self._expand_cmdclass(package_dir) self._expand_all_dynamic(dist, package_dir) dist._referenced_files.update(self._referenced_files) return self.config def _expand_packages(self): packages = self.setuptools_cfg.get("packages") if packages is None or isinstance(packages, (list, tuple)): return find = packages.get("find") if isinstance(find, dict): find["root_dir"] = self.root_dir find["fill_package_dir"] = self.setuptools_cfg.setdefault("package-dir", {}) with _ignore_errors(self.ignore_option_errors): self.setuptools_cfg["packages"] = _expand.find_packages(**find) def _expand_data_files(self): data_files = partial(_expand.canonic_data_files, root_dir=self.root_dir) self._process_field(self.setuptools_cfg, "data-files", data_files) def _expand_cmdclass(self, package_dir: Mapping[str, str]): root_dir = self.root_dir cmdclass = partial(_expand.cmdclass, package_dir=package_dir, root_dir=root_dir) self._process_field(self.setuptools_cfg, "cmdclass", cmdclass) def _expand_all_dynamic(self, dist: Distribution, package_dir: Mapping[str, str]): special = ( # need special handling "version", "readme", "entry-points", "scripts", "gui-scripts", "classifiers", "dependencies", "optional-dependencies", ) # `_obtain` functions are assumed to raise appropriate exceptions/warnings. obtained_dynamic = { field: self._obtain(dist, field, package_dir) for field in self.dynamic if field not in special } obtained_dynamic.update( self._obtain_entry_points(dist, package_dir) or {}, version=self._obtain_version(dist, package_dir), readme=self._obtain_readme(dist), classifiers=self._obtain_classifiers(dist), dependencies=self._obtain_dependencies(dist), optional_dependencies=self._obtain_optional_dependencies(dist), ) # `None` indicates there is nothing in `tool.setuptools.dynamic` but the value # might have already been set by setup.py/extensions, so avoid overwriting. updates = {k: v for k, v in obtained_dynamic.items() if v is not None} self.project_cfg.update(updates) def _ensure_previously_set(self, dist: Distribution, field: str): previous = _PREVIOUSLY_DEFINED[field](dist) if previous is None and not self.ignore_option_errors: msg = ( f"No configuration found for dynamic {field!r}.\n" "Some dynamic fields need to be specified via `tool.setuptools.dynamic`" "\nothers must be specified via the equivalent attribute in `setup.py`." ) raise InvalidConfigError(msg) def _expand_directive( self, specifier: str, directive, package_dir: Mapping[str, str] ): from more_itertools import always_iterable with _ignore_errors(self.ignore_option_errors): root_dir = self.root_dir if "file" in directive: self._referenced_files.update(always_iterable(directive["file"])) return _expand.read_files(directive["file"], root_dir) if "attr" in directive: return _expand.read_attr(directive["attr"], package_dir, root_dir) raise ValueError(f"invalid `{specifier}`: {directive!r}") return None def _obtain(self, dist: Distribution, field: str, package_dir: Mapping[str, str]): if field in self.dynamic_cfg: return self._expand_directive( f"tool.setuptools.dynamic.{field}", self.dynamic_cfg[field], package_dir, ) self._ensure_previously_set(dist, field) return None def _obtain_version(self, dist: Distribution, package_dir: Mapping[str, str]): # Since plugins can set version, let's silently skip if it cannot be obtained if "version" in self.dynamic and "version" in self.dynamic_cfg: return _expand.version( # We already do an early check for the presence of "version" self._obtain(dist, "version", package_dir) # pyright: ignore[reportArgumentType] ) return None def _obtain_readme(self, dist: Distribution) -> dict[str, str] | None: if "readme" not in self.dynamic: return None dynamic_cfg = self.dynamic_cfg if "readme" in dynamic_cfg: return { # We already do an early check for the presence of "readme" "text": self._obtain(dist, "readme", {}), "content-type": dynamic_cfg["readme"].get("content-type", "text/x-rst"), } # pyright: ignore[reportReturnType] self._ensure_previously_set(dist, "readme") return None def _obtain_entry_points( self, dist: Distribution, package_dir: Mapping[str, str] ) -> dict[str, dict[str, Any]] | None: fields = ("entry-points", "scripts", "gui-scripts") if not any(field in self.dynamic for field in fields): return None text = self._obtain(dist, "entry-points", package_dir) if text is None: return None groups = _expand.entry_points(text) # Any is str | dict[str, str], but causes variance issues expanded: dict[str, dict[str, Any]] = {"entry-points": groups} def _set_scripts(field: str, group: str): if group in groups: value = groups.pop(group) if field not in self.dynamic: raise InvalidConfigError(_MissingDynamic.details(field, value)) expanded[field] = value _set_scripts("scripts", "console_scripts") _set_scripts("gui-scripts", "gui_scripts") return expanded def _obtain_classifiers(self, dist: Distribution): if "classifiers" in self.dynamic: value = self._obtain(dist, "classifiers", {}) if value: return value.splitlines() return None def _obtain_dependencies(self, dist: Distribution): if "dependencies" in self.dynamic: value = self._obtain(dist, "dependencies", {}) if value: return _parse_requirements_list(value) return None def _obtain_optional_dependencies(self, dist: Distribution): if "optional-dependencies" not in self.dynamic: return None if "optional-dependencies" in self.dynamic_cfg: optional_dependencies_map = self.dynamic_cfg["optional-dependencies"] assert isinstance(optional_dependencies_map, dict) return { group: _parse_requirements_list( self._expand_directive( f"tool.setuptools.dynamic.optional-dependencies.{group}", directive, {}, ) ) for group, directive in optional_dependencies_map.items() } self._ensure_previously_set(dist, "optional-dependencies") return None def _parse_requirements_list(value): return [ line for line in value.splitlines() if line.strip() and not line.strip().startswith("#") ] @contextmanager def _ignore_errors(ignore_option_errors: bool): if not ignore_option_errors: yield return try: yield except Exception as ex: _logger.debug(f"ignored error: {ex.__class__.__name__} - {ex}") class _EnsurePackagesDiscovered(_expand.EnsurePackagesDiscovered): def __init__( self, distribution: Distribution, project_cfg: dict, setuptools_cfg: dict ) -> None: super().__init__(distribution) self._project_cfg = project_cfg self._setuptools_cfg = setuptools_cfg def __enter__(self) -> Self: """When entering the context, the values of ``packages``, ``py_modules`` and ``package_dir`` that are missing in ``dist`` are copied from ``setuptools_cfg``. """ dist, cfg = self._dist, self._setuptools_cfg package_dir: dict[str, str] = cfg.setdefault("package-dir", {}) package_dir.update(dist.package_dir or {}) dist.package_dir = package_dir # needs to be the same object dist.set_defaults._ignore_ext_modules() # pyproject.toml-specific behaviour # Set `name`, `py_modules` and `packages` in dist to short-circuit # auto-discovery, but avoid overwriting empty lists purposefully set by users. if dist.metadata.name is None: dist.metadata.name = self._project_cfg.get("name") if dist.py_modules is None: dist.py_modules = cfg.get("py-modules") if dist.packages is None: dist.packages = cfg.get("packages") return super().__enter__() def __exit__( self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, ) -> None: """When exiting the context, if values of ``packages``, ``py_modules`` and ``package_dir`` are missing in ``setuptools_cfg``, copy from ``dist``. """ # If anything was discovered set them back, so they count in the final config. self._setuptools_cfg.setdefault("packages", self._dist.packages) self._setuptools_cfg.setdefault("py-modules", self._dist.py_modules) return super().__exit__(exc_type, exc_value, traceback) class _ExperimentalConfiguration(SetuptoolsWarning): _SUMMARY = ( "`{subject}` in `pyproject.toml` is still *experimental* " "and likely to change in future releases." ) class _ToolsTypoInMetadata(SetuptoolsWarning): _SUMMARY = ( "Ignoring [tools.setuptools] in pyproject.toml, did you mean [tool.setuptools]?" ) config/_apply_pyprojecttoml.py 0000644 00000045260 15030122015 0012636 0 ustar 00 """Translation layer between pyproject config and setuptools distribution and metadata objects. The distribution and metadata objects are modeled after (an old version of) core metadata, therefore configs in the format specified for ``pyproject.toml`` need to be processed before being applied. **PRIVATE MODULE**: API reserved for setuptools internal usage only. """ from __future__ import annotations import logging import os from collections.abc import Mapping from email.headerregistry import Address from functools import partial, reduce from inspect import cleandoc from itertools import chain from types import MappingProxyType from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union from .. import _static from .._path import StrPath from ..errors import InvalidConfigError, RemovedConfigError from ..extension import Extension from ..warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning if TYPE_CHECKING: from typing_extensions import TypeAlias from setuptools._importlib import metadata from setuptools.dist import Distribution from distutils.dist import _OptionsList # Comes from typeshed EMPTY: Mapping = MappingProxyType({}) # Immutable dict-like _ProjectReadmeValue: TypeAlias = Union[str, dict[str, str]] _Correspondence: TypeAlias = Callable[["Distribution", Any, Union[StrPath, None]], None] _T = TypeVar("_T") _logger = logging.getLogger(__name__) def apply(dist: Distribution, config: dict, filename: StrPath) -> Distribution: """Apply configuration dict read with :func:`read_configuration`""" if not config: return dist # short-circuit unrelated pyproject.toml file root_dir = os.path.dirname(filename) or "." _apply_project_table(dist, config, root_dir) _apply_tool_table(dist, config, filename) current_directory = os.getcwd() os.chdir(root_dir) try: dist._finalize_requires() dist._finalize_license_expression() dist._finalize_license_files() finally: os.chdir(current_directory) return dist def _apply_project_table(dist: Distribution, config: dict, root_dir: StrPath): orig_config = config.get("project", {}) if not orig_config: return # short-circuit project_table = {k: _static.attempt_conversion(v) for k, v in orig_config.items()} _handle_missing_dynamic(dist, project_table) _unify_entry_points(project_table) for field, value in project_table.items(): norm_key = json_compatible_key(field) corresp = PYPROJECT_CORRESPONDENCE.get(norm_key, norm_key) if callable(corresp): corresp(dist, value, root_dir) else: _set_config(dist, corresp, value) def _apply_tool_table(dist: Distribution, config: dict, filename: StrPath): tool_table = config.get("tool", {}).get("setuptools", {}) if not tool_table: return # short-circuit if "license-files" in tool_table: if "license-files" in config.get("project", {}): # https://github.com/pypa/setuptools/pull/4837#discussion_r2004983349 raise InvalidConfigError( "'project.license-files' is defined already. " "Remove 'tool.setuptools.license-files'." ) pypa_guides = "guides/writing-pyproject-toml/#license-files" SetuptoolsDeprecationWarning.emit( "'tool.setuptools.license-files' is deprecated in favor of " "'project.license-files' (available on setuptools>=77.0.0).", see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", due_date=(2026, 2, 18), # Warning introduced on 2025-02-18 ) for field, value in tool_table.items(): norm_key = json_compatible_key(field) if norm_key in TOOL_TABLE_REMOVALS: suggestion = cleandoc(TOOL_TABLE_REMOVALS[norm_key]) msg = f""" The parameter `tool.setuptools.{field}` was long deprecated and has been removed from `pyproject.toml`. """ raise RemovedConfigError("\n".join([cleandoc(msg), suggestion])) norm_key = TOOL_TABLE_RENAMES.get(norm_key, norm_key) corresp = TOOL_TABLE_CORRESPONDENCE.get(norm_key, norm_key) if callable(corresp): corresp(dist, value) else: _set_config(dist, corresp, value) _copy_command_options(config, dist, filename) def _handle_missing_dynamic(dist: Distribution, project_table: dict): """Be temporarily forgiving with ``dynamic`` fields not listed in ``dynamic``""" dynamic = set(project_table.get("dynamic", [])) for field, getter in _PREVIOUSLY_DEFINED.items(): if not (field in project_table or field in dynamic): value = getter(dist) if value: _MissingDynamic.emit(field=field, value=value) project_table[field] = _RESET_PREVIOUSLY_DEFINED.get(field) def json_compatible_key(key: str) -> str: """As defined in :pep:`566#json-compatible-metadata`""" return key.lower().replace("-", "_") def _set_config(dist: Distribution, field: str, value: Any): val = _PREPROCESS.get(field, _noop)(dist, value) setter = getattr(dist.metadata, f"set_{field}", None) if setter: setter(val) elif hasattr(dist.metadata, field) or field in SETUPTOOLS_PATCHES: setattr(dist.metadata, field, val) else: setattr(dist, field, val) _CONTENT_TYPES = { ".md": "text/markdown", ".rst": "text/x-rst", ".txt": "text/plain", } def _guess_content_type(file: str) -> str | None: _, ext = os.path.splitext(file.lower()) if not ext: return None if ext in _CONTENT_TYPES: return _static.Str(_CONTENT_TYPES[ext]) valid = ", ".join(f"{k} ({v})" for k, v in _CONTENT_TYPES.items()) msg = f"only the following file extensions are recognized: {valid}." raise ValueError(f"Undefined content type for {file}, {msg}") def _long_description( dist: Distribution, val: _ProjectReadmeValue, root_dir: StrPath | None ): from setuptools.config import expand file: str | tuple[()] if isinstance(val, str): file = val text = expand.read_files(file, root_dir) ctype = _guess_content_type(file) else: file = val.get("file") or () text = val.get("text") or expand.read_files(file, root_dir) ctype = val["content-type"] # XXX: Is it completely safe to assume static? _set_config(dist, "long_description", _static.Str(text)) if ctype: _set_config(dist, "long_description_content_type", _static.Str(ctype)) if file: dist._referenced_files.add(file) def _license(dist: Distribution, val: str | dict, root_dir: StrPath | None): from setuptools.config import expand if isinstance(val, str): if getattr(dist.metadata, "license", None): SetuptoolsWarning.emit("`license` overwritten by `pyproject.toml`") dist.metadata.license = None _set_config(dist, "license_expression", _static.Str(val)) else: pypa_guides = "guides/writing-pyproject-toml/#license" SetuptoolsDeprecationWarning.emit( "`project.license` as a TOML table is deprecated", "Please use a simple string containing a SPDX expression for " "`project.license`. You can also use `project.license-files`. " "(Both options available on setuptools>=77.0.0).", see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", due_date=(2026, 2, 18), # Introduced on 2025-02-18 ) if "file" in val: # XXX: Is it completely safe to assume static? value = expand.read_files([val["file"]], root_dir) _set_config(dist, "license", _static.Str(value)) dist._referenced_files.add(val["file"]) else: _set_config(dist, "license", _static.Str(val["text"])) def _people(dist: Distribution, val: list[dict], _root_dir: StrPath | None, kind: str): field = [] email_field = [] for person in val: if "name" not in person: email_field.append(person["email"]) elif "email" not in person: field.append(person["name"]) else: addr = Address(display_name=person["name"], addr_spec=person["email"]) email_field.append(str(addr)) if field: _set_config(dist, kind, _static.Str(", ".join(field))) if email_field: _set_config(dist, f"{kind}_email", _static.Str(", ".join(email_field))) def _project_urls(dist: Distribution, val: dict, _root_dir: StrPath | None): _set_config(dist, "project_urls", val) def _python_requires(dist: Distribution, val: str, _root_dir: StrPath | None): _set_config(dist, "python_requires", _static.SpecifierSet(val)) def _dependencies(dist: Distribution, val: list, _root_dir: StrPath | None): if getattr(dist, "install_requires", []): msg = "`install_requires` overwritten in `pyproject.toml` (dependencies)" SetuptoolsWarning.emit(msg) dist.install_requires = val def _optional_dependencies(dist: Distribution, val: dict, _root_dir: StrPath | None): if getattr(dist, "extras_require", None): msg = "`extras_require` overwritten in `pyproject.toml` (optional-dependencies)" SetuptoolsWarning.emit(msg) dist.extras_require = val def _ext_modules(dist: Distribution, val: list[dict]) -> list[Extension]: existing = dist.ext_modules or [] args = ({k.replace("-", "_"): v for k, v in x.items()} for x in val) new = [Extension(**kw) for kw in args] return [*existing, *new] def _noop(_dist: Distribution, val: _T) -> _T: return val def _identity(val: _T) -> _T: return val def _unify_entry_points(project_table: dict): project = project_table given = project.pop("entry-points", project.pop("entry_points", {})) entry_points = dict(given) # Avoid problems with static renaming = {"scripts": "console_scripts", "gui_scripts": "gui_scripts"} for key, value in list(project.items()): # eager to allow modifications norm_key = json_compatible_key(key) if norm_key in renaming: # Don't skip even if value is empty (reason: reset missing `dynamic`) entry_points[renaming[norm_key]] = project.pop(key) if entry_points: project["entry-points"] = { name: [f"{k} = {v}" for k, v in group.items()] for name, group in entry_points.items() if group # now we can skip empty groups } # Sometimes this will set `project["entry-points"] = {}`, and that is # intentional (for resetting configurations that are missing `dynamic`). def _copy_command_options(pyproject: dict, dist: Distribution, filename: StrPath): tool_table = pyproject.get("tool", {}) cmdclass = tool_table.get("setuptools", {}).get("cmdclass", {}) valid_options = _valid_command_options(cmdclass) cmd_opts = dist.command_options for cmd, config in pyproject.get("tool", {}).get("distutils", {}).items(): cmd = json_compatible_key(cmd) valid = valid_options.get(cmd, set()) cmd_opts.setdefault(cmd, {}) for key, value in config.items(): key = json_compatible_key(key) cmd_opts[cmd][key] = (str(filename), value) if key not in valid: # To avoid removing options that are specified dynamically we # just log a warn... _logger.warning(f"Command option {cmd}.{key} is not defined") def _valid_command_options(cmdclass: Mapping = EMPTY) -> dict[str, set[str]]: from setuptools.dist import Distribution from .._importlib import metadata valid_options = {"global": _normalise_cmd_options(Distribution.global_options)} unloaded_entry_points = metadata.entry_points(group='distutils.commands') loaded_entry_points = (_load_ep(ep) for ep in unloaded_entry_points) entry_points = (ep for ep in loaded_entry_points if ep) for cmd, cmd_class in chain(entry_points, cmdclass.items()): opts = valid_options.get(cmd, set()) opts = opts | _normalise_cmd_options(getattr(cmd_class, "user_options", [])) valid_options[cmd] = opts return valid_options def _load_ep(ep: metadata.EntryPoint) -> tuple[str, type] | None: if ep.value.startswith("wheel.bdist_wheel"): # Ignore deprecated entrypoint from wheel and avoid warning pypa/wheel#631 # TODO: remove check when `bdist_wheel` has been fully removed from pypa/wheel return None # Ignore all the errors try: return (ep.name, ep.load()) except Exception as ex: msg = f"{ex.__class__.__name__} while trying to load entry-point {ep.name}" _logger.warning(f"{msg}: {ex}") return None def _normalise_cmd_option_key(name: str) -> str: return json_compatible_key(name).strip("_=") def _normalise_cmd_options(desc: _OptionsList) -> set[str]: return {_normalise_cmd_option_key(fancy_option[0]) for fancy_option in desc} def _get_previous_entrypoints(dist: Distribution) -> dict[str, list]: ignore = ("console_scripts", "gui_scripts") value = getattr(dist, "entry_points", None) or {} return {k: v for k, v in value.items() if k not in ignore} def _get_previous_scripts(dist: Distribution) -> list | None: value = getattr(dist, "entry_points", None) or {} return value.get("console_scripts") def _get_previous_gui_scripts(dist: Distribution) -> list | None: value = getattr(dist, "entry_points", None) or {} return value.get("gui_scripts") def _set_static_list_metadata(attr: str, dist: Distribution, val: list) -> None: """Apply distutils metadata validation but preserve "static" behaviour""" meta = dist.metadata setter, getter = getattr(meta, f"set_{attr}"), getattr(meta, f"get_{attr}") setter(val) setattr(meta, attr, _static.List(getter())) def _attrgetter(attr): """ Similar to ``operator.attrgetter`` but returns None if ``attr`` is not found >>> from types import SimpleNamespace >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) >>> _attrgetter("a")(obj) 42 >>> _attrgetter("b.c")(obj) 13 >>> _attrgetter("d")(obj) is None True """ return partial(reduce, lambda acc, x: getattr(acc, x, None), attr.split(".")) def _some_attrgetter(*items): """ Return the first "truth-y" attribute or None >>> from types import SimpleNamespace >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) >>> _some_attrgetter("d", "a", "b.c")(obj) 42 >>> _some_attrgetter("d", "e", "b.c", "a")(obj) 13 >>> _some_attrgetter("d", "e", "f")(obj) is None True """ def _acessor(obj): values = (_attrgetter(i)(obj) for i in items) return next((i for i in values if i is not None), None) return _acessor PYPROJECT_CORRESPONDENCE: dict[str, _Correspondence] = { "readme": _long_description, "license": _license, "authors": partial(_people, kind="author"), "maintainers": partial(_people, kind="maintainer"), "urls": _project_urls, "dependencies": _dependencies, "optional_dependencies": _optional_dependencies, "requires_python": _python_requires, } TOOL_TABLE_RENAMES = {"script_files": "scripts"} TOOL_TABLE_REMOVALS = { "namespace_packages": """ Please migrate to implicit native namespaces instead. See https://packaging.python.org/en/latest/guides/packaging-namespace-packages/. """, } TOOL_TABLE_CORRESPONDENCE = { # Fields with corresponding core metadata need to be marked as static: "obsoletes": partial(_set_static_list_metadata, "obsoletes"), "provides": partial(_set_static_list_metadata, "provides"), "platforms": partial(_set_static_list_metadata, "platforms"), } SETUPTOOLS_PATCHES = { "long_description_content_type", "project_urls", "provides_extras", "license_file", "license_files", "license_expression", } _PREPROCESS = { "ext_modules": _ext_modules, } _PREVIOUSLY_DEFINED = { "name": _attrgetter("metadata.name"), "version": _attrgetter("metadata.version"), "description": _attrgetter("metadata.description"), "readme": _attrgetter("metadata.long_description"), "requires-python": _some_attrgetter("python_requires", "metadata.python_requires"), "license": _some_attrgetter("metadata.license_expression", "metadata.license"), # XXX: `license-file` is currently not considered in the context of `dynamic`. # See TestPresetField.test_license_files_exempt_from_dynamic "authors": _some_attrgetter("metadata.author", "metadata.author_email"), "maintainers": _some_attrgetter("metadata.maintainer", "metadata.maintainer_email"), "keywords": _attrgetter("metadata.keywords"), "classifiers": _attrgetter("metadata.classifiers"), "urls": _attrgetter("metadata.project_urls"), "entry-points": _get_previous_entrypoints, "scripts": _get_previous_scripts, "gui-scripts": _get_previous_gui_scripts, "dependencies": _attrgetter("install_requires"), "optional-dependencies": _attrgetter("extras_require"), } _RESET_PREVIOUSLY_DEFINED: dict = { # Fix improper setting: given in `setup.py`, but not listed in `dynamic` # Use "immutable" data structures to avoid in-place modification. # dict: pyproject name => value to which reset "license": "", # XXX: `license-file` is currently not considered in the context of `dynamic`. # See TestPresetField.test_license_files_exempt_from_dynamic "authors": _static.EMPTY_LIST, "maintainers": _static.EMPTY_LIST, "keywords": _static.EMPTY_LIST, "classifiers": _static.EMPTY_LIST, "urls": _static.EMPTY_DICT, "entry-points": _static.EMPTY_DICT, "scripts": _static.EMPTY_DICT, "gui-scripts": _static.EMPTY_DICT, "dependencies": _static.EMPTY_LIST, "optional-dependencies": _static.EMPTY_DICT, } class _MissingDynamic(SetuptoolsWarning): _SUMMARY = "`{field}` defined outside of `pyproject.toml` is ignored." _DETAILS = """ The following seems to be defined outside of `pyproject.toml`: `{field} = {value!r}` According to the spec (see the link below), however, setuptools CANNOT consider this value unless `{field}` is listed as `dynamic`. https://packaging.python.org/en/latest/specifications/pyproject-toml/#declaring-project-metadata-the-project-table To prevent this problem, you can list `{field}` under `dynamic` or alternatively remove the `[project]` table from your file and rely entirely on other means of configuration. """ # TODO: Consider removing this check in the future? # There is a trade-off here between improving "debug-ability" and the cost # of running/testing/maintaining these unnecessary checks... @classmethod def details(cls, field: str, value: Any) -> str: return cls._DETAILS.format(field=field, value=value) config/__pycache__/__init__.cpython-310.pyc 0000644 00000003135 15030122015 0014450 0 ustar 00 o �h� � @ sv d Z ddlmZ ddlmZmZmZ ddlmZ ddl m Z eded �Z d Z d e d e fd d�Z e e j�Ze e j�ZdS )zVFor backward compatibility, expose main functions from ``setuptools.config.setupcfg`` � )�wraps)�Callable�TypeVar�cast� )� SetuptoolsDeprecationWarning� )�setupcfg�Fn)�bound)�parse_configuration�read_configuration�fn�returnc s t � �� fdd��}tt|�S )Nc s2 t �ddt� d� j� dtj� d�� � | i |��S )NzDeprecated API usage.zZ As setuptools moves its configuration towards `pyproject.toml`, `�.zG` became deprecated. For the time being, you can use the `a� ` module to access a backward compatible API, but this module is provisional and might be removed in the future. To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``configparser``. )r �emit�__name__r )�args�kwargs�r � �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/__init__.py�_wrapper s ����z%_deprecation_notice.<locals>._wrapper)r r r )r r r r r �_deprecation_notice s r N)�__doc__� functoolsr �typingr r r �warningsr � r r �__all__r r r r r r r �<module> s config/__pycache__/_apply_pyprojecttoml.cpython-310.pyc 0000644 00000043112 15030122015 0017167 0 ustar 00 o �h�J � @ s� U d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z m Z ddl m Z ddlmZ dd lmZ dd lmZmZmZmZmZ d d lmZ d d lmZ d dl m Z m Z d dl m Z d dl!m"Z"m#Z# er�ddl$m%Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+ ei �Z,de-d< ee.e/e.e.f f Z0de-d< edeeedf gdf Z1de-d< ed�Z2e�3e4�Z5d�d"d#�Z6d�d%d&�Z7d�d'd(�Z8d�d*d+�Z9d�d.d/�Z:d�d3d4�Z;d5d6d7d8�Z<d�d;d<�Z=d�d?d@�Z>d�dBdC�Z?d�dGdH�Z@d�dIdJ�ZAd�dKdL�ZBd�dNdO�ZCd�dPdQ�ZDd�dSdT�ZEd�dVdW�ZFd�dXdY�ZGd�dZd[�ZHd�d]d^�ZIe,fd�dadb�ZJd�dfdg�ZKd�didj�ZLd�dndo�ZMd�dqdr�ZNd�dtdu�ZOd�dvdw�ZPd�dzd{�ZQd|d}� ZRd~d� ZSe>e?e e@d�d��e e@d�d��eAeCeDeBd��ZTd�e-d�< d�d�iZUd�d�iZVe eQd��e eQd��e eQd��d��ZWh d��ZXd�eEiZYi dheRd���d�eRd���d�eRd���d�eRd���d�eSd�d���d�eSd�d���d�eSd�d���d�eSd�d���d�eRd���d�eRd���d�eRd���d�eN�d�eO�d�eP�d�eRd���d�eRd���ZZd�ej[ej[ej[ej[ej\ej\ej\ej\ej[ej\d�� Z]d e-d�< G d�d�� d�e#�Z^dS )�ak Translation layer between pyproject config and setuptools distribution and metadata objects. The distribution and metadata objects are modeled after (an old version of) core metadata, therefore configs in the format specified for ``pyproject.toml`` need to be processed before being applied. **PRIVATE MODULE**: API reserved for setuptools internal usage only. � )� annotationsN)�Mapping)�Address)�partial�reduce)�cleandoc)�chain)�MappingProxyType)� TYPE_CHECKING�Any�Callable�TypeVar�Union� )�_static)�StrPath)�InvalidConfigError�RemovedConfigError�� Extension)� SetuptoolsDeprecationWarning�SetuptoolsWarning)� TypeAlias��metadata�� Distribution)� _OptionsListr �EMPTYr �_ProjectReadmeValuer �_Correspondence�_T�dist�config�dict�filenamer �returnc C sx |s| S t j�|�p d}t| ||� t| ||� t �� }t �|� z| �� | �� | � � W t �|� | S t �|� w )z=Apply configuration dict read with :func:`read_configuration`�.) �os�path�dirname�_apply_project_table�_apply_tool_table�getcwd�chdir�_finalize_requires� _finalize_license_expression�_finalize_license_files)r" r# r% �root_dir�current_directory� r4 �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_apply_pyprojecttoml.py�apply. s �r6 r2 c C s� |� di �}|s d S dd� |�� D �}t| |� t|� |�� D ] \}}t|�}t� ||�}t|�r9|| ||� q t| ||� q d S )N�projectc S s i | ] \}}|t �|��qS r4 )r �attempt_conversion��.0�k�vr4 r4 r5 � <dictcomp>J s z(_apply_project_table.<locals>.<dictcomp>)�get�items�_handle_missing_dynamic�_unify_entry_points�json_compatible_key�PYPROJECT_CORRESPONDENCE�callable� _set_config) r" r# r2 � orig_config� project_table�field�value�norm_key�correspr4 r4 r5 r+ E s �r+ c C s� |� di �� di �}|sd S d|v r+d|� di �v r td��d}tjdd|� �d d � |�� D ]?\}}t|�}|tv rRtt| �}d |� d �} td � t| �|g���t � ||�}t � ||�} t | �rh| | |� q/t | | |� q/t|| |� d S )N�tool� setuptoolsz license-filesr7 zS'project.license-files' is defined already. Remove 'tool.setuptools.license-files'.z,guides/writing-pyproject-toml/#license-fileszt'tool.setuptools.license-files' is deprecated in favor of 'project.license-files' (available on setuptools>=77.0.0).�'https://packaging.python.org/en/latest/�i� r � ��see_url�due_datez, The parameter `tool.setuptools.zZ` was long deprecated and has been removed from `pyproject.toml`. � )r> r r �emitr? rB �TOOL_TABLE_REMOVALSr r �join�TOOL_TABLE_RENAMES�TOOL_TABLE_CORRESPONDENCErD rE �_copy_command_options) r" r# r% � tool_table� pypa_guidesrH rI rJ � suggestion�msgrK r4 r4 r5 r, W s8 �� � r, rG c C s^ t |�dg ��}t�� D ] \}}||v s,||v s,|| �}|r,tj||d� t�|�||< q dS )zJBe temporarily forgiving with ``dynamic`` fields not listed in ``dynamic``�dynamic�rH rI N)�setr> �_PREVIOUSLY_DEFINEDr? �_MissingDynamicrU �_RESET_PREVIOUSLY_DEFINED)r" rG r_ rH �getterrI r4 r4 r5 r@ � s ��r@ �key�strc C s | � � �dd�S )z1As defined in :pep:`566#json-compatible-metadata`�-�_)�lower�replace)rf r4 r4 r5 rB � � rB rH rI r c C sl t �|t�| |�}t| jd|� �d �}|r||� d S t| j|�s%|tv r.t| j||� d S t| ||� d S )N�set_)� _PREPROCESSr> �_noop�getattrr �hasattr�SETUPTOOLS_PATCHES�setattr)r" rH rI �val�setterr4 r4 r5 rE � s rE z text/markdownz text/x-rstz text/plain)z.mdz.rstz.txt�file� str | Nonec C sj t j�| �� �\}}|sd S |tv rt�t| �S d�dd� t�� D ��}d|� d�}t d| � d|� ���)N�, c s s$ � | ] \}}|� d |� d�V qdS )z (�)Nr4 r9 r4 r4 r5 � <genexpr>� s �" z&_guess_content_type.<locals>.<genexpr>z3only the following file extensions are recognized: r' zUndefined content type for ) r( r) �splitextrj �_CONTENT_TYPESr �StrrW r? � ValueError)rv ri �ext�validr^ r4 r4 r5 �_guess_content_type� s r� rt �StrPath | Nonec C s� ddl m} t|t�r|}|�||�}t|�}n|�d�p d}|�d�p)|�||�}|d }t| dt� |�� |rBt| dt� |�� |rL| j � |� d S d S ) Nr ��expandrv r4 �textz content-type�long_description� long_description_content_type) �setuptools.configr� � isinstancerg � read_filesr� r> rE r r} �_referenced_files�add)r" rt r2 r� rv r� �ctyper4 r4 r5 �_long_description� s �r� � str | dictc C s� ddl m} t|t�r&t| jdd �rt�d� d | j_t | dt � |�� d S d}t jddd |� �d d � d |v rT|� |d g|�}t | dt � |�� | j�|d � d S t | dt � |d �� d S )Nr r� �licensez)`license` overwritten by `pyproject.toml`�license_expressionz&guides/writing-pyproject-toml/#licensez/`project.license` as a TOML table is deprecatedz�Please use a simple string containing a SPDX expression for `project.license`. You can also use `project.license-files`. (Both options available on setuptools>=77.0.0).rN rO rQ rv r� )r� r� r� rg rp r r rU r� rE r r} r r� r� r� )r" rt r2 r� r\ rI r4 r4 r5 �_license� s$ �r� � list[dict]� _root_dir�kindc C s� g }g }|D ]+}d|vr|� |d � qd|vr |� |d � qt|d |d d�}|� t|�� q|r@t| |t�d�|��� |rSt| |� d�t�d�|��� d S d S )N�name�email)� display_name� addr_specrx �_email)�appendr rg rE r r} rW )r" rt r� r� rH � email_field�person�addrr4 r4 r5 �_people� s "�r� c C s t | d|� d S )N� project_urls)rE �r" rt r� r4 r4 r5 � _project_urls� s r� c C s t | dt�|�� d S )N�python_requires)rE r � SpecifierSetr� r4 r4 r5 �_python_requires� s r� �listc C s$ t | dg �r d}t�|� || _d S )N�install_requireszA`install_requires` overwritten in `pyproject.toml` (dependencies))rp r rU r� �r" rt r� r^ r4 r4 r5 � _dependencies� � r� c C s$ t | dd �r d}t�|� || _d S )N�extras_requirezH`extras_require` overwritten in `pyproject.toml` (optional-dependencies))rp r rU r� r� r4 r4 r5 �_optional_dependencies r� r� �list[Extension]c C s2 | j pg }dd� |D �}dd� |D �}g |�|�S )Nc s s" � | ] }d d� |� � D �V qdS )c S s i | ] \}}|� d d�|�qS )rh ri )rk r9 r4 r4 r5 r= � z*_ext_modules.<locals>.<genexpr>.<dictcomp>N�r? )r: �xr4 r4 r5 rz s � z _ext_modules.<locals>.<genexpr>c S s g | ] }t d i |���qS )r4 r )r: �kwr4 r4 r5 � <listcomp> s z _ext_modules.<locals>.<listcomp>)� ext_modules)r" rt �existing�args�newr4 r4 r5 � _ext_modules s r� �_distc C s |S �Nr4 )r� rt r4 r4 r5 ro � ro c C s | S r� r4 )rt r4 r4 r5 � _identity r� r� c C s� | }|� d|� di ��}t|�}ddd�}t|�� �D ]\}}t|�}||v r0|� |�||| < q|r@dd� |�� D �|d< d S d S )N� entry-points� entry_points�console_scripts� gui_scripts)�scriptsr� c S s( i | ]\}}|r|d d� |� � D ��qS )c S s g | ] \}}|� d |� ��qS )z = r4 r9 r4 r4 r5 r� ( r� z2_unify_entry_points.<locals>.<dictcomp>.<listcomp>r� )r: r� �groupr4 r4 r5 r= ' s ��z'_unify_entry_points.<locals>.<dictcomp>)�popr$ r� r? rB )rG r7 �givenr� �renamingrf rI rJ r4 r4 r5 rA s ���rA � pyprojectc C s� | � di �}|� di �� di �}t|�}|j}| � di �� di ��� D ]<\}}t|�}|� |t� �} |�|i � |�� D ]"\} } t| �} t|�| f|| | < | | vr^t� d|� d| � d�� q<q#d S )NrL rM �cmdclass� distutilszCommand option r' z is not defined) r> �_valid_command_options�command_optionsr? rB ra � setdefaultrg �_logger�warning) r� r" r% r[ r� � valid_options�cmd_opts�cmdr# r� rf rI r4 r4 r5 rZ 0 s ���rZ r� �dict[str, set[str]]c C s� ddl m} ddlm} dt|j�i}|jdd�}dd � |D �}d d � |D �}t|| �� �D ]\}}|� |t � �} | tt |d g ��B } | ||< q.|S ) Nr r r r �globalzdistutils.commands)r� c s s � | ]}t |�V qd S r� )�_load_ep�r: �epr4 r4 r5 rz K � � z)_valid_command_options.<locals>.<genexpr>c s s � | ]}|r|V qd S r� r4 r� r4 r4 r5 rz L r� � user_options) �setuptools.distr � _importlibr �_normalise_cmd_options�global_optionsr� r r? r> ra rp ) r� r r r� �unloaded_entry_points�loaded_entry_pointsr� r� � cmd_class�optsr4 r4 r5 r� C s r� r� �metadata.EntryPoint�tuple[str, type] | Nonec C sp | j �d�rd S z| j| �� fW S ty7 } z|jj� d| j� �}t�|� d|� �� W Y d }~d S d }~ww )Nzwheel.bdist_wheelz" while trying to load entry-point z: ) rI � startswithr� �load� Exception� __class__�__name__r� r� )r� �exr^ r4 r4 r5 r� U s ��r� r� c C s t | ��d�S )Nz_=)rB �strip)r� r4 r4 r5 �_normalise_cmd_option_keyd � r� �descr �set[str]c C s dd� | D �S )Nc S s h | ]}t |d ��qS )r )r� )r: � fancy_optionr4 r4 r5 � <setcomp>i s z)_normalise_cmd_options.<locals>.<setcomp>r4 )r� r4 r4 r5 r� h r� r� �dict[str, list]c s* d� t | dd �p i }� fdd�|�� D �S )N)r� r� r� c s i | ] \}}|� vr||�qS r4 r4 r9 ��ignorer4 r5 r= o r� z-_get_previous_entrypoints.<locals>.<dictcomp>)rp r? �r" rI r4 r� r5 �_get_previous_entrypointsl s r� � list | Nonec C � t | dd �pi }|�d�S )Nr� r� �rp r> r� r4 r4 r5 �_get_previous_scriptsr � r� c C r� )Nr� r� r� r� r4 r4 r5 �_get_previous_gui_scriptsw r� r� �attr�Nonec C sH |j }t|d| � ��t|d| � ��}}||� t|| t�|� �� dS )zCApply distutils metadata validation but preserve "static" behaviourrm �get_N)r rp rs r �List)r� r" rt �metaru re r4 r4 r5 �_set_static_list_metadata| s "r� c C s t tdd� | �d��S )a8 Similar to ``operator.attrgetter`` but returns None if ``attr`` is not found >>> from types import SimpleNamespace >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) >>> _attrgetter("a")(obj) 42 >>> _attrgetter("b.c")(obj) 13 >>> _attrgetter("d")(obj) is None True c S s t | |d �S r� )rp )�accr� r4 r4 r5 �<lambda>� s z _attrgetter.<locals>.<lambda>r' )r r �split)r� r4 r4 r5 � _attrgetter� s r c s � fdd�}|S )aL Return the first "truth-y" attribute or None >>> from types import SimpleNamespace >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) >>> _some_attrgetter("d", "a", "b.c")(obj) 42 >>> _some_attrgetter("d", "e", "b.c", "a")(obj) 13 >>> _some_attrgetter("d", "e", "f")(obj) is None True c s& � fdd��D �}t dd� |D �d �S )Nc 3 s � | ] }t |�� �V qd S r� )r �r: �i��objr4 r5 rz � � � z5_some_attrgetter.<locals>._acessor.<locals>.<genexpr>c s s � | ] }|d ur|V qd S r� r4 r r4 r4 r5 rz � r )�next)r �valuesr� r r5 �_acessor� s z"_some_attrgetter.<locals>._acessorr4 )r? r r4 r� r5 �_some_attrgetter� s r �author)r� � maintainer)�readmer� �authors� maintainers�urls� dependencies�optional_dependencies�requires_pythonzdict[str, _Correspondence]rC � script_filesr� �namespace_packagesz� Please migrate to implicit native namespaces instead. See https://packaging.python.org/en/latest/guides/packaging-namespace-packages/. � obsoletes�provides� platforms)r r r > � license_filer� � license_files�provides_extrasr� r� r� z metadata.name�versionzmetadata.version� descriptionzmetadata.descriptionr zmetadata.long_descriptionzrequires-pythonr� zmetadata.python_requiresr� zmetadata.license_expressionzmetadata.licenser zmetadata.authorzmetadata.author_emailr zmetadata.maintainerzmetadata.maintainer_email�keywordszmetadata.keywords� classifierszmetadata.classifiersr zmetadata.project_urlsr� � gui-scriptsr r� �optional-dependenciesr� � ) r� r r r r r r� r� r! r r" rd c @ s" e Zd ZdZdZed dd ��Zd S ) rc z9`{field}` defined outside of `pyproject.toml` is ignored.a% The following seems to be defined outside of `pyproject.toml`: `{field} = {value!r}` According to the spec (see the link below), however, setuptools CANNOT consider this value unless `{field}` is listed as `dynamic`. https://packaging.python.org/en/latest/specifications/pyproject-toml/#declaring-project-metadata-the-project-table To prevent this problem, you can list `{field}` under `dynamic` or alternatively remove the `[project]` table from your file and rely entirely on other means of configuration. rH rg rI r r& c C s | j j||d�S )Nr` )�_DETAILS�format)�clsrH rI r4 r4 r5 �details rl z_MissingDynamic.detailsN)rH rg rI r r& rg )r� � __module__� __qualname__�_SUMMARYr$ � classmethodr' r4 r4 r4 r5 rc � s rc )r" r r# r$ r% r r& r )r" r r# r$ r2 r )r" r r# r$ r% r )r" r rG r$ )rf rg r& rg )r" r rH rg rI r )rv rg r& rw )r" r rt r r2 r� )r" r rt r� r2 r� )r" r rt r� r� r� r� rg )r" r rt r$ r� r� )r" r rt rg r� r� )r" r rt r� r� r� )r" r rt r� r& r� )r� r rt r! r& r! )rt r! r& r! )rG r$ )r� r$ r" r r% r )r� r r& r� )r� r� r& r� )r� rg r& rg )r� r r& r� )r" r r& r� )r" r r& r� )r� rg r" r rt r� r& r� )_�__doc__� __future__r �loggingr( �collections.abcr �email.headerregistryr � functoolsr r �inspectr � itertoolsr �typesr �typingr r r r r r# r �_pathr �errorsr r � extensionr �warningsr r �typing_extensionsr �setuptools._importlibr r� r �distutils.distr r �__annotations__rg r$ r r r! � getLoggerr� r� r6 r+ r, r@ rB rE r| r� r� r� r� r� r� r� r� r� ro r� rA rZ r� r� r� r� r� r� r� r� r r rC rX rV rY rr rn rb � EMPTY_LIST� EMPTY_DICTrd rc r4 r4 r4 r5 �<module> s� " * � � �� ����� � � � � � � ������� config/__pycache__/expand.cpython-310.pyc 0000644 00000043471 15030122015 0014177 0 ustar 00 o �h�> � @ s2 d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z ddlmZ ddlmZmZ ddlmZ dd lmZ dd lmZmZ dd lmZmZm Z m Z d d l m Z d dl m!Z!m"Z# d dl$m%Z% d dl&m'Z' ddl(m)Z) er�ddl*m+Z+ ddl,m-Z- e d�Z.e ddd�Z/G dd� d�Z0 dmdnd d!�Z1 dmdod%d&�Z2dpd)d*�Z3dqd-d.�Z4drd0d1�Z5 dsdtd6d7�Z6dud;d<�Z7dvd?d@�Z8dwdBdC�Z9 dsdxdFdG�Z: dsdydKdL�Z;ddddM�dzdPdQ�Z<d{dTdU�Z=d|dXdY�Z>d}d\d]�Z? dmd~dadb�Z@ cdd�dgdh�ZAG didj� dj�ZBG dkdl� dle e.e/f �ZCdS )�ai Utility functions to expand configuration directives or special values (such glob patterns). We can split the process of interpreting configuration files into 2 steps: 1. The parsing the file contents from strings to value objects that can be understand by Python (for example a string with a comma separated list of keywords into an actual Python list of strings). 2. The expansion (or post-processing) of these values according to the semantics ``setuptools`` assign to them (for example a configuration field with the ``file:`` directive should be expanded from a list of file paths to a single string with the contents of those files concatenated) This module focus on the second step, and therefore allow sharing the expansion functions among several configuration file formats. **PRIVATE MODULE**: API reserved for setuptools internal usage only. � )� annotationsN)�Iterable�Iterator�Mapping)� ConfigParser)�iglob)� ModuleSpec� all_suffixes)�chain)�Path)� ModuleType� TracebackType)� TYPE_CHECKING�Any�Callable�TypeVar� )�_static)�StrPath� same_path)�find_package_path)�SetuptoolsWarning)�DistutilsOptionError)�Self)� Distribution�_K�_V_coT)� covariantc @ s. e Zd ZdZddd �Zdd d �Zddd�ZdS )� StaticModulez>Proxy to a module object that avoids executing arbitrary code.�name�str�specr �return�Nonec C s. t �t�|j��� �}t| ��t� � | ` d S �N) �ast�parse�pathlibr �origin� read_bytes�vars�update�locals�self)r- r r! �module� r/ �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/expand.py�__init__8 s zStaticModule.__init__�!Iterator[tuple[ast.AST, ast.AST]]c # s\ � | j jD ]&� t� tj�r� fdd�� jD �E d H qt� tj�r+� jr+� j� jfV qd S )Nc 3 s � | ]}|� j fV qd S r$ ��value)�.0�target�� statementr/ r0 � <genexpr>@ s � z1StaticModule._find_assignments.<locals>.<genexpr>) r. �body� isinstancer% �Assign�targets� AnnAssignr4 r6 �r- r/ r7 r0 �_find_assignments= s � ��z StaticModule._find_assignments�attrc sL zt � fdd�| �� D ��W S ty% } z t| j� d� � ��|�d}~ww )zHAttempt to load an attribute "statically", via :func:`ast.literal_eval`.c 3 s4 � | ]\}}t |tj�r|j� krt�|�V qd S r$ )r; r% �Name�id� literal_eval)r5 r6 r4 �rA r/ r0 r9 G s � � ��z+StaticModule.__getattr__.<locals>.<genexpr>z has no attribute N)�nextr@ � Exception�AttributeErrorr )r- rA �er/ rE r0 � __getattr__D s ���zStaticModule.__getattr__N)r r r! r r" r# )r" r2 )rA r )�__name__� __module__� __qualname__�__doc__r1 r@ rJ r/ r/ r/ r0 r 5 s r �patterns� Iterable[str]�root_dir�StrPath | Noner" � list[str]c s� h d�}g }� p t �� � | D ]<�t�fdd�|D ��r9t j�t j�� ���}|�t� fdd�t|dd�D ��� qt j� �� �� t j d�}|� |� q|S )a Expand the list of glob patterns, but preserving relative paths. :param list[str] patterns: List of glob patterns :param str root_dir: Path to which globs should be relative (current directory by default) :rtype: list > �*�{�}�?�[�]c 3 s � | ]}|� v V qd S r$ r/ )r5 �charr3 r/ r0 r9 _ s � z glob_relative.<locals>.<genexpr>c 3 s( � | ]}t j�|� ��t jd �V qdS )�/N)�os�path�relpath�replace�sep�r5 r] �rQ r/ r0 r9 c s � � �T)� recursiver[ ) r\ �getcwd�anyr] �abspath�join�extend�sortedr r^ r_ r` �append)rO rQ �glob_characters�expanded_values� glob_pathr] r/ )rQ r4 r0 � glob_relativeP s �� rn � filepaths�StrPath | Iterable[StrPath]r c sR ddl m} tj�� pt�� �� � fdd�|| �D �}d�� fdd�t|�D ��S )z�Return the content of the files concatenated using `` `` as str This function is sandboxed and won't reach anything outside ``root_dir`` (By default ``root_dir`` is the current directory). r )�always_iterablec 3 s � | ] }t j�� |�V qd S r$ �r\ r] rg ra rb r/ r0 r9 } s � z read_files.<locals>.<genexpr>� c 3 s" � | ] }t |� �rt|�V qd S r$ )� _assert_local� _read_filera rb r/ r0 r9 ~ s � � �)�more_itertoolsrq r\ r] rf rd rg �_filter_existing_files)ro rQ rq � _filepathsr/ rb r0 � read_filesq s �ry �Iterable[StrPath]�Iterator[StrPath]c c s6 � | D ]}t j�|�r|V qt�d|�d�� qd S )NzFile z cannot be found)r\ r] �isfiler �emit)ro r] r/ r/ r0 rw � s � �rw �filepath�bytes | StrPathc C s8 t | dd�� }|�� W d � S 1 sw Y d S )Nzutf-8)�encoding)�open�read)r~ �fr/ r/ r0 ru � s $�ru r c C s@ t tj�|��t tj�| ��jvr d| �d|�d�}t|��dS )NzCannot access z (or anything outside �)T)r r\ r] rf �parentsr )r~ rQ �msgr/ r/ r0 rt � s "rt � attr_desc� package_dir�Mapping[str, str] | Noner c C s� |pt �� }| �� �d�}|�� }d�|�}|pd}t|||�}t||�}ztt ||�|�}t � |�W S t yF t ||�} t| |� Y S w )a� Reads the value of an attribute from a module. This function will try to read the attributed statically first (via :func:`ast.literal_eval`), and only evaluate the module if it fails. Examples: read_attr("package.attr") read_attr("package.module.attr") :param str attr_desc: Dot-separated string describing how to reach the attribute (see examples above) :param dict[str, str] package_dir: Mapping of package names to their location in disk (represented by paths relative to ``root_dir``). :param str root_dir: Path to directory containing all the packages in ``package_dir`` (current directory by default). :rtype: str �.r1 )r\ rd �strip�split�poprg � _find_module� _find_spec�getattrr r �attempt_conversionrG � _load_spec) r� r� rQ � attrs_path� attr_name� module_namer] r! r4 r. r/ r/ r0 � read_attr� s �r� r� � module_pathr c C s2 t j�| |�}|pt j�| �}|d u rt| ��|S r$ )� importlib�util�spec_from_file_location� find_spec�ModuleNotFoundError)r� r� r! r/ r/ r0 r� � s r� r! r c C sT t | d|�}|tjv rtj| S tj�| �}|tj|< | jd us"J �| j�|� |S )NrK )r� �sys�modulesr� r� �module_from_spec�loader� exec_module)r! r� r r. r/ r/ r0 r� � s r� � str | Nonec s> t | |pi |�� t�� fdd�t� D ��}tdd� |D �d�S )a� Find the path to the module named ``module_name``, considering the ``package_dir`` in the build configuration and ``root_dir``. >>> tmp = getfixture('tmpdir') >>> _ = tmp.ensure("a/b/c.py") >>> _ = tmp.ensure("a/b/d/__init__.py") >>> r = lambda x: x.replace(str(tmp), "tmp").replace(os.sep, "/") >>> r(_find_module("a.b.c", None, tmp)) 'tmp/a/b/c.py' >>> r(_find_module("f.g.h", {"": "1", "f": "2", "f.g": "3", "f.g.h": "a/b/d"}, tmp)) 'tmp/a/b/d/__init__.py' c 3 s0 � | ]}� � |� �t j�� d |� ��fV qdS )r1 Nrr )r5 �ext�� path_startr/ r0 r9 � s � � �z _find_module.<locals>.<genexpr>c s s � | ] }t j�|�r|V qd S r$ )r\ r] r| �r5 �xr/ r/ r0 r9 � � � N)r r � from_iterabler rF )r� r� rQ � candidatesr/ r� r0 r� � s �r� �qualified_class_namer c C sX |pt �� }| �d�}| |d d� }| d|� }t|||�}tt||�|�}t||�S )z@Given a qualified class name, return the associated class objectr� � N)r\ rd �rfindr� r� r� r� )r� r� rQ �idx� class_name�pkg_namer] r. r/ r/ r0 � resolve_class� s r� �values�dict[str, str]�dict[str, Callable]c s � �fdd�| � � D �S )z�Given a dictionary mapping command names to strings for qualified class names, apply :func:`resolve_class` to the dict values. c s i | ] \}}|t |� ���qS r/ )r� �r5 �k�v�r� rQ r/ r0 � <dictcomp> � z cmdclass.<locals>.<dictcomp>)�items)r� r� rQ r/ r� r0 �cmdclass� s r� )� namespaces�fill_package_dirrQ r� �dict[str, str] | Nonec s ddl m}m} ddlm} | sddlm} nddlm} |p!tj}|� ddg�}g } |du r1i n|}t |||���� t � �d krVt � fd d �d|fD ��rV|� d � d � � D ]-} t|| �} |j| fi |��} | �| � | r�|�d �| ks�tj�| |�s�|�|| | �� qX| S ) a Works similarly to :func:`setuptools.find_packages`, but with all arguments given as keyword arguments. Moreover, ``where`` can be given as a list (the results will be simply concatenated). When the additional keyword argument ``namespaces`` is ``True``, it will behave like :func:`setuptools.find_namespace_packages`` (i.e. include implicit namespaces as per :pep:`420`). The ``where`` argument will be considered relative to ``root_dir`` (or the current working directory when ``root_dir`` is not given). If the ``fill_package_dir`` argument is passed, this function will consider it as a similar data structure to the ``package_dir`` configuration parameter add fill-in any missing package location. :rtype: list r )rq �unique_everseen)�construct_package_dir)� PackageFinder)�PEP420PackageFinder�wherer� Nr� c 3 s � | ] }t � d |� V qdS )r N)� _same_pathr� ��searchr/ r0 r9 1 r� z find_packages.<locals>.<genexpr>� )rv rq r� �setuptools.discoveryr� r� r� r\ �curdirr� �list�len�all� setdefault� _nest_path�findrh �getr] �samefiler+ ) r� r� rQ �kwargsrq r� r� r� r� �packagesr] � package_path�pkgsr/ r� r0 � find_packages s* & �r� �parentr] c C s& |dv r| nt j�| |�}t j�|�S )N> r� r� )r\ r] rg �normpath)r� r] r/ r/ r0 r� @ s r� r4 �$Callable | Iterable[str | int] | strc C s@ t | �r| � n| }t|t�r|S t|d�r d�tt|��S |� S )z`When getting the version directly from an attribute, it should be normalised to string. �__iter__r� )�callabler; r �hasattrrg �map)r4 �_valuer/ r/ r0 �versionE s r� � package_data�dictc C s d| v r | � d�| d< | S )NrT r� )r� )r� r/ r/ r0 �canonic_package_dataR s r� � data_files� list | dict�list[tuple[str, list[str]]]c s$ t | t�r| S � fdd�| �� D �S )z�For compatibility with ``setup.py``, ``data_files`` should be a list of pairs instead of a dict. This function also expands glob patterns. c s g | ] \}}|t |� �f�qS r/ )rn )r5 �destrO rb r/ r0 � <listcomp>c s ��z&canonic_data_files.<locals>.<listcomp>)r; r� r� )r� rQ r/ rb r0 �canonic_data_filesX s �r� � entry-points�text� text_source�dict[str, dict[str, str]]c C sB t ddd�}t|_|�| |� dd� |�� D �}|�|jd� |S )a? Given the contents of entry-points file, process it into a 2-level dictionary (``dict[str, dict[str, str]]``). The first level keys are entry-point groups, the second level keys are entry-point names, and the second level values are references to objects (that correspond to the entry-point value). N)�=)�default_section� delimitersc S s i | ] \}}|t |�� ��qS r/ )r� r� r� r/ r/ r0 r� v r� z entry_points.<locals>.<dictcomp>)r r � optionxform� read_stringr� r� r� )r� r� �parser�groupsr/ r/ r0 � entry_pointsi s r� c @ sN e Zd ZdZddd�Zdd � Zd d d �Zd dd�Zd dd�Ze d dd��Z dS ) �EnsurePackagesDiscovereda� Some expand functions require all the packages to already be discovered before they run, e.g. :func:`read_attr`, :func:`resolve_class`, :func:`cmdclass`. Therefore in some cases we will need to run autodiscovery during the evaluation of the configuration. However, it is better to postpone calling package discovery as much as possible, because some parameters can influence it (e.g. ``package_dir``), and those might not have been processed yet. � distributionr r" r# c C s || _ d| _d S )NF)�_dist�_called)r- r� r/ r/ r0 r1 � � z!EnsurePackagesDiscovered.__init__c C s" | j sd| _ | jjdd� dS dS )zBTrigger the automatic package discovery, if it is still necessary.TF)r N)r� r� � set_defaultsr? r/ r/ r0 �__call__� s �z!EnsurePackagesDiscovered.__call__r c C s | S r$ r/ r? r/ r/ r0 � __enter__� s z"EnsurePackagesDiscovered.__enter__�exc_type�type[BaseException] | None� exc_value�BaseException | None� traceback�TracebackType | Nonec C s | j r | jj�� d S d S r$ )r� r� r� � analyse_name)r- r� r r r/ r/ r0 �__exit__� s �z!EnsurePackagesDiscovered.__exit__�Mapping[str, str]c C s | � | j j}|d u r i S |S r$ )r� r� )r- �pkg_dirr/ r/ r0 �_get_package_dir� s z)EnsurePackagesDiscovered._get_package_dirc C s t | j�S )zCProxy to ``package_dir`` that may trigger auto-discovery when used.)�LazyMappingProxyr r? r/ r/ r0 r� � s z$EnsurePackagesDiscovered.package_dirN)r� r r" r# )r" r )r� r� r r r r )r" r ) rK rL rM rN r1 r� r� r r �propertyr� r/ r/ r/ r0 r� { s r� c @ sB e Zd ZdZddd�Zdd d �Zddd�Zddd�Zddd�ZdS ) r a� Mapping proxy that delays resolving the target object, until really needed. >>> def obtain_mapping(): ... print("Running expensive function!") ... return {"key": "value", "other key": "other value"} >>> mapping = LazyMappingProxy(obtain_mapping) >>> mapping["key"] Running expensive function! 'value' >>> mapping["other key"] 'other value' �obtain_mapping_value� Callable[[], Mapping[_K, _V_co]]r" r# c C s || _ d | _d S r$ )�_obtainr� )r- r r/ r/ r0 r1 � r� zLazyMappingProxy.__init__�Mapping[_K, _V_co]c C s | j d u r | �� | _ | j S r$ )r� r r? r/ r/ r0 �_target� s zLazyMappingProxy._target�keyr r c C s | � � | S r$ )r )r- r r/ r/ r0 � __getitem__� � z LazyMappingProxy.__getitem__�intc C � t | �� �S r$ )r� r r? r/ r/ r0 �__len__� r zLazyMappingProxy.__len__� Iterator[_K]c C r r$ )�iterr r? r/ r/ r0 r� � r zLazyMappingProxy.__iter__N)r r r" r# )r" r )r r r" r )r" r )r" r ) rK rL rM rN r1 r r r r� r/ r/ r/ r0 r � s r r$ )rO rP rQ rR r" rS )ro rp rQ rR r" r )ro rz r" r{ )r~ r r" r )r~ r rQ r )NN)r� r r� r� rQ rR r" r )r� r r� rR r" r )r! r r� r r" r )r� r r� r� rQ r r" r� )r� r r� r� rQ rR r" r )r� r� r� r� rQ rR r" r� )r� r� rQ rR r" rS )r� r r] r r" r )r4 r� r" r )r� r� r" r� )r� r� rQ rR r" r� )r� )r� r r� r r" r� )DrN � __future__r r% r� r\ r' r� �collections.abcr r r � configparserr �globr �importlib.machineryr r � itertoolsr r �typesr r �typingr r r r r� r �_pathr r r� � discoveryr �warningsr �distutils.errorsr �typing_extensionsr �setuptools.distr r r r rn ry rw ru rt r� r� r� r� r� r� r� r� r� r� r� r� r� r r/ r/ r/ r0 �<module> st �" � � ( � � � 7 � � + config/__pycache__/setupcfg.cpython-310.pyc 0000644 00000057201 15030122015 0014534 0 ustar 00 o �h�g � @ s U d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z m Z ddlm Z m Z ddl mZmZmZmZmZmZmZ ddlmZ dd lmZmZ dd lm Z m Z d d l m Z d d l m!Z! d dl"m#Z#m$Z$ d dl%m&Z& ddl m'Z' er�ddl(m)Z) ddl*m+Z+ ddl,m-Z- e.e/e0e/ef f Z1de2d< e.e/e1f Z3de2d< eddd�Z4 dLdMd#d$�Z5dNd&d'�Z6 ( dOdPd,d-�Z7dQd2d3�Z8dRd6d7�Z9 dSdTd:d;�Z:dUd@dA�Z;G dBdC� dCee4 �Z<G dDdE� dEe<d �Z=G dFdG� dGe<d �Z>G dHdI� dIe&�Z?G dJdK� dKe&�Z@dS )Va< Load setuptools configuration from ``setup.cfg`` files. **API will be made private in the future** To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``configparser``. � )� annotationsN)� defaultdict)�Iterable�Iterator)�partial�wraps)� TYPE_CHECKING�Any�Callable�ClassVar�Generic�TypeVar�cast)�default_environment)�InvalidRequirement� Requirement)�InvalidVersion�Version� )�_static)�StrPath)� FileError� OptionError)� SetuptoolsDeprecationWarning� )�expand)� TypeAlias�� Distribution)�DistributionMetadatar �SingleCommandOptions�AllCommandOptions�Targetr r F�filepathr � find_others�bool�ignore_option_errors�return�dictc C s8 ddl m} |� }|r|�� ng }t|| ||�}t|�S )a, Read given configuration file and returns options from it as a dict. :param str|unicode filepath: Path to configuration file to get options from. :param bool find_others: Whether to search for other configuration files which could be on in various places. :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :rtype: dict r r )�setuptools.distr �find_config_files�_apply�configuration_to_dict)r# r$ r& r �dist� filenames�handlers� r0 �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/setupcfg.py�read_configuration2 s r2 r- c C s t | |� | �� | S )z`Apply the configuration from a ``setup.cfg`` file into an existing distribution object. )r+ �_finalize_requires)r- r# r0 r0 r1 �apply_configurationL s r4 r0 � other_files�Iterable[StrPath]�2tuple[ConfigMetadataHandler, ConfigOptionsHandler]c C s� ddl m} tj�|�}tj�|�std|� d���t�� }t�tj� |�� g |�|�}z |j | t t t |�d� t| | j|d�}| �� W t�|� |S t�|� w )zHRead configuration from ``filepath`` and applies to the ``dist`` object.r )� _DistributionzConfiguration file z does not exist.)r. )r& )r) r8 �os�path�abspath�isfiler �getcwd�chdir�dirname�parse_config_filesr �list�str�parse_configuration�command_options�_finalize_license_files)r- r# r5 r& r8 �current_directoryr. r/ r0 r0 r1 r+ U s � �r+ � target_obj�#Distribution | DistributionMetadata�keyrB c C s* d|� �}t �t| |�}t| ||�}|� S )z� Given a target object and option key, get that option from the target object, either through a get_{key} method or from an attribute directly. �get_)� functoolsr �getattr)rG rI � getter_name� by_attribute�getterr0 r0 r1 � _get_optiont s rP r/ �KIterable[ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata]]c C s< t t�}| D ]}|jD ]}t|j|�}|||j |< q q|S )z�Returns configuration data gathered by given handlers as a dict. :param Iterable[ConfigHandler] handlers: Handlers list, usually from parse_configuration() :rtype: dict )r r( � set_optionsrP rG �section_prefix)r/ � config_dict�handler�option�valuer0 r0 r1 r, � s �r, � distributionrD c C s� t �| ��6}t| |||�}|�� | js|j| _t| j|||| j| j�}|�� | j� |j|j� W d � ||fS 1 s>w Y ||fS )a� Performs additional parsing of configuration options for a distribution. Returns a list of used option handlers. :param Distribution distribution: :param dict command_options: :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :rtype: list N) r �EnsurePackagesDiscovered�ConfigOptionsHandler�parse� package_dir�ConfigMetadataHandler�metadata�src_root�_referenced_files�update)rX rD r& �ensure_discovered�options�metar0 r0 r1 rC � s4 ��� ��rC �label� orig_value�parsedrA c s� d|v s t � �dkr dS t� �� }zt� d �}|j|v r)tj| � d d� W dS W dS tyW } z t� fdd�|D ��rLtj | � d d�}t|�|�W Y d}~dS d}~ww )am Because users sometimes misinterpret this configuration: [options.extras_require] foo = bar;python_version<"4" It looks like one requirement with an environment marker but because there is no newline, it's parsed as two requirements with a semicolon as separator. Therefore, if: * input string does not contain a newline AND * parsed result contains two requirements AND * parsing of the two parts from the result ("<first>;<second>") leads in a valid Requirement with a valid marker a UserWarning is shown to inform the user about the possible problem. � r Nr )�field�reqc 3 s � | ] }� d � |�V qdS )r N�� startswith)�.0�marker�rg r0 r1 � <genexpr>� � � z8_warn_accidental_env_marker_misconfig.<locals>.<genexpr>) �len� marker_env�keysr �name�_AmbiguousMarker�emitr �any�message)re rf rg �markersrj �ex�msgr0 ro r1 �%_warn_accidental_env_marker_misconfig� s � ���r} c @ s� e Zd ZU dZded< i Zded< d4dd�Zed5dd��Ze dd� �Z d6dd�Z ed7dd��Z edd� �Z ed d � �Zed d � �Zd8d"d#�Zd9d%d&�Zed'd(� �Zed)d*� �Zed:d,d-��Zd6d.d/�Zd6d0d1�Zd2d3� Zd+S );� ConfigHandlerz1Handles metadata supplied in configuration files.rB rS zClassVar[dict[str, str]]�aliasesrG r" rc r! rb � expand.EnsurePackagesDiscoveredr' �Nonec C s8 || _ || _t| �|��| _g | _|| _tt � | _ d S �N) r& rG r( �_section_options�sectionsrR rb �setrB r` ��selfrG rc r& rb r0 r0 r1 �__init__� s zConfigHandler.__init__�*Iterator[tuple[str, SingleCommandOptions]]c c s@ � |� � D ]\}}|�| j�\}}}|rq|�d�|fV qd S )N�.)�items� partitionrS �lstrip)�clsrc � full_namerW �pre�_sepru r0 r0 r1 r� s ��z ConfigHandler._section_optionsc C s t | jj� d���)�.Metadata item name to parser function mapping.z must provide .parsers property)�NotImplementedError� __class__�__name__�r� r0 r0 r1 �parsers s �zConfigHandler.parsersc C s� | j }| j�||�}zt||�}W n ty" } zt|�|�d }~ww |r'd S z | j�|dd� �|�}W n tf| j yB Y d S w t � |j |�}t|d|� �|�}||� | j � |� d S )Nc S s | S r� r0 )�xr0 r0 r1 �<lambda>& � z+ConfigHandler.__setitem__.<locals>.<lambda>�set_)rG r �getrL �AttributeError�KeyErrorr� � Exceptionr& rK r � __setattr__rR �append) r� � option_namerW rG � current_value�erg � simple_setter�setterr0 r0 r1 � __setitem__ s& ���zConfigHandler.__setitem__�,c C s8 t |t�r|S d|v r|�� }n|�|�}dd� |D �S )z�Represents value as a list. Value is split either by separator (defaults to comma) or by lines. :param value: :param separator: List items separator character. :rtype: list rh c S s g | ] }|� � r|� � �qS r0 ��strip)rm �chunkr0 r0 r1 � <listcomp>B s z-ConfigHandler._parse_list.<locals>.<listcomp>)� isinstancerA � splitlines�split)r� rW � separatorr0 r0 r1 � _parse_list0 s zConfigHandler._parse_listc C sR d}i }| � |�D ] }|�|�\}}}||kr td|� ���|�� ||�� < q |S )zPRepresents value as a dict. :param value: :rtype: dict �=z&Unable to parse option value to dict: )r� r� r r� )r� rW r� �result�linerI �sep�valr0 r0 r1 � _parse_dictD s zConfigHandler._parse_dictc C s |� � }|dv S )zQRepresents value as boolean. :param value: :rtype: bool )�1�true�yes)�lower�r� rW r0 r0 r1 � _parse_boolU s zConfigHandler._parse_boolc � � fdd�}|S )z�Returns a parser function to make sure field inputs are not files. Parses a value after getting the key so error messages are more informative. :param key: :rtype: callable c s( d}| � |�rtd� � d���t�| �S )N�file:z"Only strings are accepted for the z field, files are not accepted)rl � ValueErrorr �Str)rW �exclude_directive�rI r0 r1 �parserk s � z3ConfigHandler._exclude_files_parser.<locals>.parserr0 )r� rI r� r0 r� r1 �_exclude_files_parser_ s z#ConfigHandler._exclude_files_parser�root_dir�StrPath | Nonec C sh d}t |t�s |S |�|�st�|�S |t|�d� }dd� |�d�D �}| j�|� t�t � ||��S )aO Represents value as a string, allowing including text from nearest files using `file:` directive. Directive is sandboxed and won't reach anything outside directory with setup.py. Examples: file: README.rst, CHANGELOG.md, src/file.txt :param str value: :rtype: str r� Nc S s g | ]}|� � �qS r0 r� )rm r: r0 r0 r1 r� � � z-ConfigHandler._parse_file.<locals>.<listcomp>r� ) r� rB rl r r� rr r� r` ra r � read_files)r� rW r� �include_directive�spec� filepathsr0 r0 r1 � _parse_filev s zConfigHandler._parse_filer c C s@ d}|� |�s t�|�S |�|d�}|�| jj� t�|||�S )z�Represents value as a module attribute. Examples: attr: package.attr attr: package.module.attr :param str value: :rtype: str zattr:� ) rl r r� �replacera rb r\ r � read_attr)r� rW r\ r� �attr_directive� attr_descr0 r0 r1 � _parse_attr� s zConfigHandler._parse_attrc r� )z�Returns parser function to represents value as a list. Parses a value applying given methods one after another. :param parse_methods: :rtype: callable c s | }� D ]}||�}q|S r� r0 )rW rg �method�� parse_methodsr0 r1 r[ � s z1ConfigHandler._get_parser_compound.<locals>.parser0 )r� r� r[ r0 r� r1 �_get_parser_compound� s z"ConfigHandler._get_parser_compoundc C s, i }|� � D ] \}\}}|||�||< q|S )a Parses section options into a dictionary. Applies a given parser to each option in a section. :param dict section_options: :param callable values_parser: function with 2 args corresponding to key, value :rtype: dict )r� )r� �section_options� values_parserrW rI �_r� r0 r0 r1 � _parse_section_to_dict_with_key� s z-ConfigHandler._parse_section_to_dict_with_keyNc s$ � r� fdd�ndd� }| � ||�S )a Parses section options into a dictionary. Optionally applies a given parser to each value. :param dict section_options: :param callable values_parser: function with 1 arg corresponding to option value :rtype: dict c s � |�S r� r0 �r� �v�r� r0 r1 r� � s z6ConfigHandler._parse_section_to_dict.<locals>.<lambda>c S s |S r� r0 r� r0 r0 r1 r� � r� )r� )r� r� r� r� r0 r� r1 �_parse_section_to_dict� s z$ConfigHandler._parse_section_to_dictc C sL |� � D ] \}\}}t�t�� || |< W d � n1 s w Y qdS )zQParses configuration file section. :param dict section_options: N)r� � contextlib�suppressr� )r� r� ru r� rW r0 r0 r1 � parse_section� s ���zConfigHandler.parse_sectionc C sl | j �� D ].\}}d}|rd|� �}t| d|� ��dd�d�}|du r/td| j� d|� d���||� qdS ) zTParses configuration file items from one or more related sections. r� r� r� r� �__Nz*Unsupported distribution option section: [�])r� r� rL r� r rS )r� � section_namer� �method_postfix�section_parser_methodr0 r0 r1 r[ � s& ���� �zConfigHandler.parsec s t � �� ��fdd��}|S )z�this function will wrap around parameters that are deprecated :param msg: deprecation message :param func: function to be wrapped around c s. �� dd� tjd�fi ��� � | i |��S )N� stacklevelr z Deprecated config in `setup.cfg`)� setdefault�_DeprecatedConfigrw )�args�kwargs��func�kwr| r0 r1 �config_handler� s z@ConfigHandler._deprecated_config_handler.<locals>.config_handler)r )r� r� r| r� r� r0 r� r1 �_deprecated_config_handler� s z(ConfigHandler._deprecated_config_handler)rG r" rc r! rb r� r' r� )rc r! r' r� �r' r� )r� )r� r� )r� r r� )r� � __module__� __qualname__�__doc__�__annotations__r r� � classmethodr� �propertyr� r� r� r� r� r� r� r� r� r� r� r� r[ r� r0 r0 r0 r1 r~ � s> r~ c sR e Zd ZdZddddd�ZdZ dejfd � fdd� Ze dd� �Z dd � Z � Z S ) r] r^ �url� description� classifiers� platforms)� home_page�summary� classifier�platformFNrG r rc r! r& r% rb r� r\ � dict | Noner� r� r' r� c s" t � �||||� || _|| _d S r� )�superr� r\ r� )r� rG rc r& rb r\ r� �r� r0 r1 r� s z ConfigMetadataHandler.__init__c C s� | � | jtj�}| � | jtj�}t| j| jd�}| j }i dtj �dtj �dtj �dtj �d|�d|�d|�d |�d | � ||��d |d ��d |�d |�d|�dtj �d| j �dtj �d|�S )r� �r� �author� author_email� maintainer�maintainer_emailr� �keywords�provides� obsoletesr� �license� license_filesr� �long_description� long_description_content_type�versionr� � project_urls) r� r� r �Listr� �Dictr r� r� r� r� �_parse_version)r� �parse_list_static�parse_dict_static� parse_file�exclude_files_parserr0 r0 r1 r� % sN �������� � � � � �����z ConfigMetadataHandler.parsersc C st | � || j�}||kr.|�� }zt|� W |S ty- } z td|� d|� ��|�d}~ww t�| �|| j | j��S )zSParses `version` option value. :param value: :rtype: str zVersion loaded from z does not comply with PEP 440: N) r� r� r� r r r r r r� r\ )r� rW r r� r0 r0 r1 r A s" ������z$ConfigMetadataHandler._parse_version)rG r rc r! r& r% rb r� r\ r r� r� r' r� ) r� r� r� rS r � strict_moder9 �curdirr� r� r� r � __classcell__r0 r0 r r1 r] s � � r] c s� e Zd ZdZd*� fd d � Zed d� �Zdd� Zd+dd�Ze dd� �Z dd� Z dd� Z d d � Z d,d d �Zd d!� Zd,d"d#�Zd,d$d%�Zd,d&d'�Zd,d(d)�Z� ZS )-rZ rc rG r r! r& r% rb r� r' r� c s$ t � �||||� |j| _i | _d S r� )r r� r_ r� r\ r� r r0 r1 r� ^ s z ConfigOptionsHandler.__init__c C s | j |dd�S )N�;)r� )r� r� r0 r0 r1 �_parse_list_semicoloni s z*ConfigOptionsHandler._parse_list_semicolonc C s | j || jd�S )Nr )r� r� )r� rW r0 r0 r1 �_parse_file_in_rootm s z(ConfigOptionsHandler._parse_file_in_rootre rB rW c C s0 | � | �|��}t|||� t�dd� |D ��S )Nc s s � | ] }|� d �s|V qdS )�#Nrk )rm r� r0 r0 r1 rp v rq z@ConfigOptionsHandler._parse_requirements_list.<locals>.<genexpr>)r r r} r r )r� re rW rg r0 r0 r1 �_parse_requirements_listp s z-ConfigOptionsHandler._parse_requirements_listc C sN | j }| j}| j}||| j|||| �|d�t| jd�| j| j| j |t j |d�S )r� zeThe namespace_packages parameter is deprecated, consider using implicit namespaces instead (PEP 420).�install_requires)�zip_safe�include_package_datar\ �scripts�eager_resources�dependency_links�namespace_packagesr! �setup_requires�packages� entry_points� py_modules�python_requires�cmdclass) r� r� �_parse_cmdclassr� r� r r r �_parse_packagesr r � SpecifierSet)r� � parse_list� parse_bool�parse_cmdclassr0 r0 r1 r� y s. ���z ConfigOptionsHandler.parsersc C s | j j}t�| �|�|| j�S r� )rb r\ r r- r� r� )r� rW r\ r0 r0 r1 r. � s z$ConfigOptionsHandler._parse_cmdclassc C sb ddg}|� � }||vr| �|�S | �| j�di ��}|j||d k| j| jd� tj di |��S )zTParses `packages` option value. :param value: :rtype: list zfind:zfind_namespace:z packages.findr )� namespacesr� �fill_package_dirNr0 ) r� r� � parse_section_packages__findr� r� ra r� r\ r � find_packages)r� rW �find_directives� trimmed_value� find_kwargsr0 r0 r1 r/ � s � �z$ConfigOptionsHandler._parse_packagesc sN | � || j�}g d�� � fdd�|�� D �}|�d�}|dur%|d |d< |S )z�Parses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: )�where�include�excludec s" i | ] \}}|� v r|r||�qS r0 r0 )rm �kr� �� valid_keysr0 r1 � <dictcomp>� s " zEConfigOptionsHandler.parse_section_packages__find.<locals>.<dictcomp>r; Nr )r� r� r� r� )r� r� � section_datar: r; r0 r? r1 r6 � s z1ConfigOptionsHandler.parse_section_packages__findc C s | � || j�}|| d< dS )z`Parses `entry_points` configuration file section. :param dict section_options: r* N)r� r� �r� r� rg r0 r0 r1 �parse_section_entry_points� s z/ConfigOptionsHandler.parse_section_entry_pointsc C s | � || j�}t�|�S r� )r� r� r �canonic_package_data)r� r� � package_datar0 r0 r1 �_parse_package_data� s z(ConfigOptionsHandler._parse_package_datac C � | � |�| d< dS )z`Parses `package_data` configuration file section. :param dict section_options: rF N�rG �r� r� r0 r0 r1 �parse_section_package_data� � z/ConfigOptionsHandler.parse_section_package_datac C rH )zhParses `exclude_package_data` configuration file section. :param dict section_options: �exclude_package_dataNrI rJ r0 r0 r1 �"parse_section_exclude_package_data� rL z7ConfigOptionsHandler.parse_section_exclude_package_datac s& � � |� fdd��}t�|�� d< dS )zbParses `extras_require` configuration file section. :param dict section_options: c s � � d| � d�|�S )Nzextras_require[r� )r )r> r� r� r0 r1 r� � r� zCConfigOptionsHandler.parse_section_extras_require.<locals>.<lambda>�extras_requireN)r� r r rC r0 r� r1 � parse_section_extras_require� s �z1ConfigOptionsHandler.parse_section_extras_requirec C s$ | � || j�}t�|| j�| d< dS )z^Parses `data_files` configuration file section. :param dict section_options: � data_filesN)r� r� r �canonic_data_filesr� rC r0 r0 r1 �parse_section_data_files� s z-ConfigOptionsHandler.parse_section_data_files) rG r rc r! r& r% rb r� r' r� )re rB rW rB r� )r� r� r� rS r� r� r r r r� r� r. r/ r6 rD rG rK rN rP rS r r0 r0 r r1 rZ [ s$ rZ c @ s$ e Zd ZdZdZdZedd� �ZdS )rv z Ambiguous requirement marker.z� One of the parsed requirements in `{field}` looks like a valid environment marker: {req!r} Please make sure that the configuration file is correct. You can use dangling lines to avoid this problem. z'userguide/declarative_config.html#opt-2c K s" d| j � �}| j| j| j||d�S )Nz%https://setuptools.pypa.io/en/latest/)�see_url� format_args)� _SEE_DOCS�_format�_SUMMARY�_DETAILS)r� r� �docsr0 r0 r1 ry s z_AmbiguousMarker.messageN)r� r� r� rX rY rV r� ry r0 r0 r0 r1 rv � s rv c @ s e Zd ZdZdS )r� z!userguide/declarative_config.htmlN)r� r� r� rV r0 r0 r0 r1 r� s r� )FF)r# r r$ r% r& r% r' r( )r- r r# r r' r )r0 F) r- r r# r r5 r6 r& r% r' r7 )rG rH rI rB )r/ rQ r' r( )F)rX r rD r! r& r% r' r7 )re rB rf rB rg rA )Ar� � __future__r r� rK r9 � collectionsr �collections.abcr r r r �typingr r r r r r r �packaging.markersr rs �packaging.requirementsr r �packaging.versionr r r� r �_pathr �errorsr r �warningsr r �typing_extensionsr r) r �distutils.distr r( rB �tupler r� r! r" r2 r4 r+ rP r, rC r} r~ r] rZ rv r� r0 r0 r0 r1 �<module> sZ $ � � � . &S config/__pycache__/pyprojecttoml.cpython-310.pyc 0000644 00000037222 15030122015 0015630 0 ustar 00 o �h�G � @ sr d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z ddl m Z ddl mZmZmZ d d lmZ d d lmZmZ d d lmZ d dlmZ d dlm Z m Z m Z erdddl m!Z! ddl"m#Z# e�$e%�Z&d8dd�Z'd9dd�Z( d:d;d d!�Z) " d<d=d&d'�Z* d>d?d*d+�Z+G d,d-� d-�Z,d.d/� Z-ed@d0d1��Z.G d2d3� d3ej/�Z0G d4d5� d5e�Z1G d6d7� d7e�Z2dS )Aac Load setuptools configuration from ``pyproject.toml`` files. **PRIVATE MODULE**: API reserved for setuptools internal usage only. To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``tomllib`` or ``tomli``. � )� annotationsN)�Mapping)�contextmanager)�partial)� TracebackType)� TYPE_CHECKING�Any�Callable� )�StrPath)� FileError�InvalidConfigError)�SetuptoolsWarning� )�expand)�_PREVIOUSLY_DEFINED�_MissingDynamic�apply)�Self�� Distribution�filepathr �return�dictc C sD ddl m} t| d�� }|�|�W d � S 1 sw Y d S )Nr )�tomllib�rb)� compat.py310r �open�load)r r �file� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/pyprojecttoml.py� load_file$ s $�r" �config�boolc C s� ddl m} |j�d�}t|d�r|�� z|�| �W S |jyR } z*d|j� �}|j � d�dkr=t � |� t � |j � d|j � d �}t|� d |� ��d �d }~ww ) Nr )�_validate_pyprojectztrove-classifier�_disable_downloadzconfiguration error: �`�projectz invalid pyproject.toml config: �.� )� r% �FORMAT_FUNCTIONS�get�hasattrr& �validate�ValidationError�summary�name�strip�_logger�debug�details� ValueError)r# r � validator�trove_classifier�exr1 �errorr r r! r/ + s ��r/ F�distr �ignore_option_errorsc C s t |d|| �}t| ||�S )zeApply the configuration from a ``pyproject.toml`` file into an existing distribution object. T)�read_configuration�_apply)r< r r= r# r r r! �apply_configuration@ s r@ Tr �Distribution | None�dict[str, Any]c C sD t j�| �} t j�| �std| �d���t| �pi }|�di �}|�di �}|�di �}|r2|s4|s4i S d|�di �v r@t�� d|v rJt jdd � |rY|j d urY|� d |j � n|� d d � ||d< ||d< d |v rqt jdd � t |�� |d|id�}t || � W d � n1 s�w Y |r�t j�| �} t|| ||�S |S )a� Read given configuration file and returns options from it as a dict. :param str|unicode filepath: Path to configuration file in the ``pyproject.toml`` format. :param bool expand: Whether to expand directives and other computed values (i.e. post-process the given configuration) :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :param Distribution|None: Distribution object to which the configuration refers. If not given a dummy object will be created and discarded after the configuration is read. This is used for auto-discovery of packages and in the case a dynamic configuration (e.g. ``attr`` or ``cmdclass``) is expanded. When ``expand=False`` this object is simply ignored. :rtype: dict zConfiguration file z does not exist.r( �tool� setuptools�tools� distutilsz[tool.distutils])�subjectNzinclude-package-dataTz ext-modulesz [tool.setuptools.ext-modules])r( rC )�os�path�abspath�isfiler r" r- �_ToolsTypoInMetadata�emit�_ExperimentalConfiguration�include_package_data� setdefault�_ignore_errorsr/ �dirname�expand_configuration) r r r= r< �asdict� project_table� tool_table�setuptools_table�subset�root_dirr r r! r> L s8 � r> rY �StrPath | Nonec C s t | |||��� S )a� Given a configuration with unresolved fields (e.g. dynamic, cmdclass, ...) find their final values. :param dict config: Dict containing the configuration for the distribution :param str root_dir: Top-level directory for the distribution/project (the same directory where ``pyproject.toml`` is place) :param bool ignore_option_errors: see :func:`read_configuration` :param Distribution|None: Distribution object to which the configuration refers. If not given a dummy object will be created and discarded after the configuration is read. Used in the case a dynamic configuration (e.g. ``attr`` or ``cmdclass``). :rtype: dict )�_ConfigExpanderr )r# rY r= r< r r r! rS � s rS c @ s� e Zd Z d=d>d d�Zd?dd�Zd@dd�ZdAdd�Zd d � Zd d � Zd d!� Z dBd$d%�Z dCd&d'�Z dDd(d)�Z dEd+d,�Z dFd-d.�ZdCd/d0�ZdGd2d3�ZdHd5d6�ZdId7d8�ZdId9d:�ZdId;d<�ZdS )Jr[ NFr# r rY rZ r= r$ r< rA r �Nonec C st || _ |pt�� | _|�di �| _| j�dg �| _|�di ��di �| _| j�di �| _|| _ || _ t t � | _ d S )Nr( �dynamicrC rD )r# rH �getcwdrY r- � project_cfgr] �setuptools_cfg� dynamic_cfgr= �_dist�set�str�_referenced_files)�selfr# rY r= r< r r r! �__init__� s z_ConfigExpander.__init__r c C s0 ddl m} | j| j�dd �d�}| jp||�S )Nr r r2 )�src_rootr2 )�setuptools.distr rY r_ r- rb )rf r �attrsr r r! � _ensure_dist� s z _ConfigExpander._ensure_dist� container�fieldrd �fnr c C sL ||v r$t | j�� ||| �||< W d � d S 1 s w Y d S d S �N)rQ r= )rf rl rm rn r r r! �_process_field� s "��z _ConfigExpander._process_field� package-datac C s | j �|i �}t�|�S ro )r` r- �_expand�canonic_package_data)rf rm � package_datar r r! �_canonic_package_data� s z%_ConfigExpander._canonic_package_datac C s� | � � | �� | �d� | �� }t|| j| j�}|�}|j}| �� | �|� | � ||� W d � n1 s8w Y |j � | j � | j S )Nzexclude-package-data) �_expand_packagesru rk �_EnsurePackagesDiscoveredr_ r` � package_dir�_expand_data_files�_expand_cmdclass�_expand_all_dynamicre �updater# )rf r< �ctx�ensure_discoveredrx r r r! r � s �z_ConfigExpander.expandc C s� | j �d�}|d u st|ttf�rd S |�d�}t|t�rN| j|d< | j �di �|d< t| j �� t j di |��| j d< W d � d S 1 sGw Y d S d S )N�packages�findrY � package-dir�fill_package_dirr ) r` r- � isinstance�list�tupler rY rP rQ r= rr � find_packages)rf r r� r r r! rv � s "��z _ConfigExpander._expand_packagesc C s$ t tj| jd�}| �| jd|� d S )N)rY z data-files)r rr �canonic_data_filesrY rp r` )rf � data_filesr r r! ry � s z"_ConfigExpander._expand_data_filesrx �Mapping[str, str]c C s* | j }ttj||d�}| �| jd|� d S )N)rx rY �cmdclass)rY r rr r� rp r` )rf rx rY r� r r r! rz � s z _ConfigExpander._expand_cmdclassc s� d�� ���fdd��j D �}|j��� ��pi ��� ����� ���� ���� ���� �d� dd� |�� D �}�j �|� d S )N)�version�readme� entry-points�scripts� gui-scripts� classifiers� dependencies�optional-dependenciesc s$ i | ]}|�vr|�� � |���qS r )�_obtain��.0rm �r< rx rf �specialr r! � <dictcomp>� s �z7_ConfigExpander._expand_all_dynamic.<locals>.<dictcomp>)r� r� r� r� �optional_dependenciesc S s i | ] \}}|d ur||�qS ro r )r� �k�vr r r! r� s ) r] r| �_obtain_entry_points�_obtain_version�_obtain_readme�_obtain_classifiers�_obtain_dependencies� _obtain_optional_dependencies�itemsr_ )rf r< rx �obtained_dynamic�updatesr r� r! r{ � s � � z#_ConfigExpander._expand_all_dynamicc C s6 t | |�}|d u r| jsd|�d�}t|��d S d S )Nz#No configuration found for dynamic z�. Some dynamic fields need to be specified via `tool.setuptools.dynamic` others must be specified via the equivalent attribute in `setup.py`.)r r= r )rf r< rm �previous�msgr r r! �_ensure_previously_set s ��z&_ConfigExpander._ensure_previously_set� specifierc C s� ddl m} t| j��? | j}d|v r,| j�||d �� t�|d |�W d � S d|v r@t� |d ||�W d � S t d|� d|����1 sMw Y d S )Nr )�always_iterabler �attrz invalid `z`: ) �more_itertoolsr� rQ r= rY re r| rr � read_files� read_attrr7 )rf r� � directiverx r� rY r r r! �_expand_directive s ���z!_ConfigExpander._expand_directivec C s4 || j v r| �d|� �| j | |�S | �||� d S )Nztool.setuptools.dynamic.)ra r� r� )rf r< rm rx r r r! r� * s � z_ConfigExpander._obtainc C s, d| j v rd| jv rt�| �|d|��S d S )Nr� )r] ra rr r� r� )rf r< rx r r r! r� 4 s �z _ConfigExpander._obtain_version�dict[str, str] | Nonec C sL d| j vrd S | j}d|v r | �|di �|d �dd�d�S | �|d� d S )Nr� � content-typez text/x-rst)�textr� )r] ra r� r- r� )rf r< ra r r r! r� = s � z _ConfigExpander._obtain_readme� dict[str, dict[str, Any]] | Nonec st d}t �fdd�|D ��sd S ��|d|�}|d u r d S t�|��d�i� d� ��fdd � }|d d � |d d � � S )N)r� r� r� c 3 s � | ]}|� j v V qd S ro )r] r� �rf r r! � <genexpr>P s � z7_ConfigExpander._obtain_entry_points.<locals>.<genexpr>r� rm rd �groupc s< |�v r �� |�}| �jvrtt�| |���|� | < d S d S ro )�popr] r r r6 )rm r� �value��expanded�groupsrf r r! � _set_scripts[ s �z:_ConfigExpander._obtain_entry_points.<locals>._set_scriptsr� �console_scriptsr� � gui_scripts)rm rd r� rd )�anyr� rr � entry_points)rf r< rx �fieldsr� r� r r� r! r� L s z$_ConfigExpander._obtain_entry_pointsc C s( d| j v r| �|di �}|r|�� S d S )Nr� )r] r� � splitlines�rf r< r� r r r! r� g � z#_ConfigExpander._obtain_classifiersc C s( d| j v r| �|di �}|rt|�S d S )Nr� )r] r� �_parse_requirements_listr� r r r! r� n r� z$_ConfigExpander._obtain_dependenciesc sV d� j vrd S d� jv r#� jd }t|t�sJ �� fdd�|�� D �S � �|d� d S )Nr� c s* i | ]\}}|t � �d |� �|i ���qS )z.tool.setuptools.dynamic.optional-dependencies.)r� r� )r� r� r� r� r r! r� { s ����zA_ConfigExpander._obtain_optional_dependencies.<locals>.<dictcomp>)r] ra r� r r� r� )rf r< �optional_dependencies_mapr r� r! r� u s � z-_ConfigExpander._obtain_optional_dependencies�NFN) r# r rY rZ r= r$ r< rA r r\ )r r )rl r rm rd rn r )rq )rx r� )r< r rx r� )r< r rm rd )r� rd rx r� )r< r rm rd rx r� )r< r r r� )r< r rx r� r r� )r< r )�__name__� __module__� __qualname__rg rk rp ru r rv ry rz r{ r� r� r� r� r� r� r� r� r� r r r r! r[ � s, � r[ c C s dd� | � � D �S )Nc S s& g | ]}|� � r|� � �d �s|�qS )�#)r3 � startswith)r� �liner r r! � <listcomp>� s � ��z,_parse_requirements_list.<locals>.<listcomp>)r� )r� r r r! r� � s �r� c c s^ � | sd V d S zd V W d S t y. } zt�d|jj� d|� �� W Y d }~d S d }~ww )Nzignored error: z - )� Exceptionr4 r5 � __class__r� )r= r: r r r! rQ � s � (��rQ c s: e Zd Zd� fdd � Zd� fd d � Zd� fdd� Z� ZS )rw � distributionr r_ r r` r r\ c s t � �|� || _|| _d S ro )�superrg � _project_cfg�_setuptools_cfg)rf r� r_ r` �r� r r! rg � s z"_EnsurePackagesDiscovered.__init__r c s� | j | j}}|�di �}|�|jpi � ||_|j�� |jjdu r+| j � d�|j_|j du r6|� d�|_ |j du rA|� d�|_ t � �� S )z�When entering the context, the values of ``packages``, ``py_modules`` and ``package_dir`` that are missing in ``dist`` are copied from ``setuptools_cfg``. r� Nr2 � py-modulesr )rb r� rP r| rx � set_defaults�_ignore_ext_modules�metadatar2 r� r- � py_modulesr r� � __enter__)rf r< �cfgrx r� r r! r� � s z#_EnsurePackagesDiscovered.__enter__�exc_type�type[BaseException] | None� exc_value�BaseException | None� traceback�TracebackType | Nonec s4 | j �d| jj� | j �d| jj� t� �|||�S )z�When exiting the context, if values of ``packages``, ``py_modules`` and ``package_dir`` are missing in ``setuptools_cfg``, copy from ``dist``. r r� )r� rP rb r r� r� �__exit__)rf r� r� r� r� r r! r� � s z"_EnsurePackagesDiscovered.__exit__)r� r r_ r r` r r r\ )r r )r� r� r� r� r� r� r r\ )r� r� r� rg r� r� � __classcell__r r r� r! rw � s rw c @ � e Zd ZdZdS )rN z``{subject}` in `pyproject.toml` is still *experimental* and likely to change in future releases.N�r� r� r� �_SUMMARYr r r r! rN � � �rN c @ r� )rL zNIgnoring [tools.setuptools] in pyproject.toml, did you mean [tool.setuptools]?Nr� r r r r! rL � r� rL )r r r r )r# r r r r r$ )F)r< r r r r= r$ r r )TFN) r r r r$ r= r$ r< rA r rB r� ) r# r rY rZ r= r$ r< rA r r )r= r$ )3�__doc__� __future__r �loggingrH �collections.abcr � contextlibr � functoolsr �typesr �typingr r r �_pathr �errorsr r �warningsr r+ r rr �_apply_pyprojecttomlr r r r? �typing_extensionsr ri r � getLoggerr� r4 r" r/ r@ r> rS r[ r� rQ �EnsurePackagesDiscoveredrw rN rL r r r r! �<module> sL � �K � ^ - config/setuptools.schema.json 0000644 00000037307 15030122015 0012363 0 ustar 00 { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html", "title": "``tool.setuptools`` table", "$$description": [ "``setuptools``-specific configurations that can be set by users that require", "customization.", "These configurations are completely optional and probably can be skipped when", "creating simple packages. They are equivalent to some of the `Keywords", "<https://setuptools.pypa.io/en/latest/references/keywords.html>`_", "used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.", "It considers only ``setuptools`` `parameters", "<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_", "that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``", "and ``setup_requires`` (incompatible with modern workflows/standards)." ], "type": "object", "additionalProperties": false, "properties": { "platforms": { "type": "array", "items": {"type": "string"} }, "provides": { "$$description": [ "Package and virtual package names contained within this package", "**(not supported by pip)**" ], "type": "array", "items": {"type": "string", "format": "pep508-identifier"} }, "obsoletes": { "$$description": [ "Packages which this package renders obsolete", "**(not supported by pip)**" ], "type": "array", "items": {"type": "string", "format": "pep508-identifier"} }, "zip-safe": { "$$description": [ "Whether the project can be safely installed and run from a zip file.", "**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and", "``setup.py install`` in the context of ``eggs`` (**DEPRECATED**)." ], "type": "boolean" }, "script-files": { "$$description": [ "Legacy way of defining scripts (entry-points are preferred).", "Equivalent to the ``script`` keyword in ``setup.py``", "(it was renamed to avoid confusion with entry-point based ``project.scripts``", "defined in :pep:`621`).", "**DISCOURAGED**: generic script wrappers are tricky and may not work properly.", "Whenever possible, please use ``project.scripts`` instead." ], "type": "array", "items": {"type": "string"}, "$comment": "TODO: is this field deprecated/should be removed?" }, "eager-resources": { "$$description": [ "Resources that should be extracted together, if any of them is needed,", "or if any C extensions included in the project are imported.", "**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and", "``setup.py install`` in the context of ``eggs`` (**DEPRECATED**)." ], "type": "array", "items": {"type": "string"} }, "packages": { "$$description": [ "Packages that should be included in the distribution.", "It can be given either as a list of package identifiers", "or as a ``dict``-like structure with a single key ``find``", "which corresponds to a dynamic call to", "``setuptools.config.expand.find_packages`` function.", "The ``find`` key is associated with a nested ``dict``-like structure that can", "contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,", "mimicking the keyword arguments of the associated function." ], "oneOf": [ { "title": "Array of Python package identifiers", "type": "array", "items": {"$ref": "#/definitions/package-name"} }, {"$ref": "#/definitions/find-directive"} ] }, "package-dir": { "$$description": [ ":class:`dict`-like structure mapping from package names to directories where their", "code can be found.", "The empty string (as key) means that all packages are contained inside", "the given directory will be included in the distribution." ], "type": "object", "additionalProperties": false, "propertyNames": { "anyOf": [{"const": ""}, {"$ref": "#/definitions/package-name"}] }, "patternProperties": { "^.*$": {"type": "string" } } }, "package-data": { "$$description": [ "Mapping from package names to lists of glob patterns.", "Usually this option is not needed when using ``include-package-data = true``", "For more information on how to include data files, check ``setuptools`` `docs", "<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_." ], "type": "object", "additionalProperties": false, "propertyNames": { "anyOf": [{"type": "string", "format": "python-module-name"}, {"const": "*"}] }, "patternProperties": { "^.*$": {"type": "array", "items": {"type": "string"}} } }, "include-package-data": { "$$description": [ "Automatically include any data files inside the package directories", "that are specified by ``MANIFEST.in``", "For more information on how to include data files, check ``setuptools`` `docs", "<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_." ], "type": "boolean" }, "exclude-package-data": { "$$description": [ "Mapping from package names to lists of glob patterns that should be excluded", "For more information on how to include data files, check ``setuptools`` `docs", "<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_." ], "type": "object", "additionalProperties": false, "propertyNames": { "anyOf": [{"type": "string", "format": "python-module-name"}, {"const": "*"}] }, "patternProperties": { "^.*$": {"type": "array", "items": {"type": "string"}} } }, "namespace-packages": { "type": "array", "items": {"type": "string", "format": "python-module-name-relaxed"}, "$comment": "https://setuptools.pypa.io/en/latest/userguide/package_discovery.html", "description": "**DEPRECATED**: use implicit namespaces instead (:pep:`420`)." }, "py-modules": { "description": "Modules that setuptools will manipulate", "type": "array", "items": {"type": "string", "format": "python-module-name-relaxed"}, "$comment": "TODO: clarify the relationship with ``packages``" }, "ext-modules": { "description": "Extension modules to be compiled by setuptools", "type": "array", "items": {"$ref": "#/definitions/ext-module"} }, "data-files": { "$$description": [ "``dict``-like structure where each key represents a directory and", "the value is a list of glob patterns that should be installed in them.", "**DISCOURAGED**: please notice this might not work as expected with wheels.", "Whenever possible, consider using data files inside the package directories", "(or create a new namespace package that only contains data files).", "See `data files support", "<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_." ], "type": "object", "patternProperties": { "^.*$": {"type": "array", "items": {"type": "string"}} } }, "cmdclass": { "$$description": [ "Mapping of distutils-style command names to ``setuptools.Command`` subclasses", "which in turn should be represented by strings with a qualified class name", "(i.e., \"dotted\" form with module), e.g.::\n\n", " cmdclass = {mycmd = \"pkg.subpkg.module.CommandClass\"}\n\n", "The command class should be a directly defined at the top-level of the", "containing module (no class nesting)." ], "type": "object", "patternProperties": { "^.*$": {"type": "string", "format": "python-qualified-identifier"} } }, "license-files": { "type": "array", "items": {"type": "string"}, "$$description": [ "**PROVISIONAL**: list of glob patterns for all license files being distributed.", "(likely to become standard with :pep:`639`).", "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``" ], "$comment": "TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?" }, "dynamic": { "type": "object", "description": "Instructions for loading :pep:`621`-related metadata dynamically", "additionalProperties": false, "properties": { "version": { "$$description": [ "A version dynamically loaded via either the ``attr:`` or ``file:``", "directives. Please make sure the given file or attribute respects :pep:`440`.", "Also ensure to set ``project.dynamic`` accordingly." ], "oneOf": [ {"$ref": "#/definitions/attr-directive"}, {"$ref": "#/definitions/file-directive"} ] }, "classifiers": {"$ref": "#/definitions/file-directive"}, "description": {"$ref": "#/definitions/file-directive"}, "entry-points": {"$ref": "#/definitions/file-directive"}, "dependencies": {"$ref": "#/definitions/file-directive-for-dependencies"}, "optional-dependencies": { "type": "object", "propertyNames": {"type": "string", "format": "pep508-identifier"}, "additionalProperties": false, "patternProperties": { ".+": {"$ref": "#/definitions/file-directive-for-dependencies"} } }, "readme": { "type": "object", "anyOf": [ {"$ref": "#/definitions/file-directive"}, { "type": "object", "properties": { "content-type": {"type": "string"}, "file": { "$ref": "#/definitions/file-directive/properties/file" } }, "additionalProperties": false} ], "required": ["file"] } } } }, "definitions": { "package-name": { "$id": "#/definitions/package-name", "title": "Valid package name", "description": "Valid package name (importable or :pep:`561`).", "type": "string", "anyOf": [ {"type": "string", "format": "python-module-name-relaxed"}, {"type": "string", "format": "pep561-stub-name"} ] }, "ext-module": { "$id": "#/definitions/ext-module", "title": "Extension module", "description": "Parameters to construct a :class:`setuptools.Extension` object", "type": "object", "required": ["name", "sources"], "additionalProperties": false, "properties": { "name": { "type": "string", "format": "python-module-name-relaxed" }, "sources": { "type": "array", "items": {"type": "string"} }, "include-dirs":{ "type": "array", "items": {"type": "string"} }, "define-macros": { "type": "array", "items": { "type": "array", "items": [ {"description": "macro name", "type": "string"}, {"description": "macro value", "oneOf": [{"type": "string"}, {"type": "null"}]} ], "additionalItems": false } }, "undef-macros": { "type": "array", "items": {"type": "string"} }, "library-dirs": { "type": "array", "items": {"type": "string"} }, "libraries": { "type": "array", "items": {"type": "string"} }, "runtime-library-dirs": { "type": "array", "items": {"type": "string"} }, "extra-objects": { "type": "array", "items": {"type": "string"} }, "extra-compile-args": { "type": "array", "items": {"type": "string"} }, "extra-link-args": { "type": "array", "items": {"type": "string"} }, "export-symbols": { "type": "array", "items": {"type": "string"} }, "swig-opts": { "type": "array", "items": {"type": "string"} }, "depends": { "type": "array", "items": {"type": "string"} }, "language": {"type": "string"}, "optional": {"type": "boolean"}, "py-limited-api": {"type": "boolean"} } }, "file-directive": { "$id": "#/definitions/file-directive", "title": "'file:' directive", "description": "Value is read from a file (or list of files and then concatenated)", "type": "object", "additionalProperties": false, "properties": { "file": { "oneOf": [ {"type": "string"}, {"type": "array", "items": {"type": "string"}} ] } }, "required": ["file"] }, "file-directive-for-dependencies": { "title": "'file:' directive for dependencies", "allOf": [ { "$$description": [ "**BETA**: subset of the ``requirements.txt`` format", "without ``pip`` flags and options", "(one :pep:`508`-compliant string per line,", "lines that are blank or start with ``#`` are excluded).", "See `dynamic metadata", "<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_." ] }, {"$ref": "#/definitions/file-directive"} ] }, "attr-directive": { "title": "'attr:' directive", "$id": "#/definitions/attr-directive", "$$description": [ "Value is read from a module attribute. Supports callables and iterables;", "unsupported types are cast via ``str()``" ], "type": "object", "additionalProperties": false, "properties": { "attr": {"type": "string", "format": "python-qualified-identifier"} }, "required": ["attr"] }, "find-directive": { "$id": "#/definitions/find-directive", "title": "'find:' directive", "type": "object", "additionalProperties": false, "properties": { "find": { "type": "object", "$$description": [ "Dynamic `package discovery", "<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_." ], "additionalProperties": false, "properties": { "where": { "description": "Directories to be searched for packages (Unix-style relative path)", "type": "array", "items": {"type": "string"} }, "exclude": { "type": "array", "$$description": [ "Exclude packages that match the values listed in this field.", "Can container shell-style wildcards (e.g. ``'pkg.*'``)" ], "items": {"type": "string"} }, "include": { "type": "array", "$$description": [ "Restrict the found packages to just the ones listed in this field.", "Can container shell-style wildcards (e.g. ``'pkg.*'``)" ], "items": {"type": "string"} }, "namespaces": { "type": "boolean", "$$description": [ "When ``True``, directories without a ``__init__.py`` file will also", "be scanned for :pep:`420`-style implicit namespaces" ] } } } } } } } config/_validate_pyproject/__pycache__/error_reporting.cpython-310.pyc 0000644 00000027375 15030122015 0022176 0 ustar 00 o �h%. � @ s\ d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZ d dlm Z m Z d dlm Z m Z m Z mZmZmZmZmZ ddlmZ ejrYd dlZejdk rSd dlmZ nd dlmZ e�e�Z d d d d d �Z dZ h d�Z e� d�Z!e� dej"�Z#ddddd�Z$dZ%G dd� de�Z&ede d fdd ��Z'G d d � d �Z(G d d � d �Z)d!e*dee* fd"d#�Z+dS )$� N)�contextmanager)�indent�wrap)�Any�Dict� Generator�Iterator�List�Optional�Sequence�Union� )�JsonSchemaValueException)� � )�Selfzkeys must be named byz at least one item that matches� z"only items matching the definition)z(must be named by propertyName definitionzone of contains definitionz same as const definition:zonly specified items)zmust not be emptyzis always invalidzmust not be there> �not�allOf�anyOf�items�oneOf�contains� propertyNamesz\W+|([A-Z][^A-Z\W]*)z^[\w_]+$�table�key�keys)�object�property� properties�property namesz} For more details about `format` see https://validate-pyproject.readthedocs.io/en/latest/api/validate_pyproject.formats.html c @ s2 e Zd ZdZdZdZdZededdfdd��Z dS ) �ValidationErrora� Report violations of a given JSON schema. This class extends :exc:`~fastjsonschema.JsonSchemaValueException` by adding the following properties: - ``summary``: an improved version of the ``JsonSchemaValueException`` error message with only the necessary information) - ``details``: more contextual information about the error like the failing schema itself and the value that violates the schema. Depending on the level of the verbosity of the ``logging`` configuration the exception message will be only ``summary`` (default) or a combination of ``summary`` and ``details`` (when the logging level is set to :obj:`logging.DEBUG`). r �ex�returnr c C sj t |�}| t|�|j|j|j|j�}t�dd��� }|dkr'|j |j |_ |_ |j |_ |j |_ |j|_|S )N� JSONSCHEMA_DEBUG_CODE_GENERATION�false)�_ErrorFormatting�str�value�name� definition�rule�os�getenv�lower� __cause__� __traceback__�message�_original_message�summary�details)�clsr" � formatter�obj� debug_code� r9 �h/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/error_reporting.py�_from_jsonschemaK s z ValidationError._from_jsonschemaN) �__name__� __module__� __qualname__�__doc__r3 r4 r2 � classmethodr r; r9 r9 r9 r: r! 6 s r! r# )NNNc c s4 � zd V W d S t y } zt�| �d �d } ~ ww �N)r r! r; )r" r9 r9 r: �detailed_errorsX s � ��rB c @ s~ e Zd Zdefdd�Zdefdd�Zedefdd��Zedefd d ��Z e d edefd d ��Z defdd�Z defdd�Z dS )r& r" c C sB || _ d| �|j�� d�| _| j j�|j| j�| _d| _d| _d S )N�`r )r" �_simplify_namer) r1 �replacer2 �_summary�_details)�selfr" r9 r9 r: �__init__a s z_ErrorFormatting.__init__r# c C s, t �� tjkr| jr| j� d| j� �S | jS )N� )�_logger�getEffectiveLevel�logging�DEBUGr4 r3 �rH r9 r9 r: �__str__h s z_ErrorFormatting.__str__c C � | j s| �� | _ | j S rA )rF �_expand_summaryrO r9 r9 r: r3 n � z_ErrorFormatting.summaryc C rQ rA )rG �_expand_detailsrO r9 r9 r: r4 u rS z_ErrorFormatting.detailsr) c C s" t d�}| �d�r| |d � S | S )Nzdata.)�len� startswith)r) �xr9 r9 r: rD | s z _ErrorFormatting._simplify_namec sz | j � t�� D ] \}}� �||�� qt� fdd�tD ��r � S | jj}| jjt v r;|r;t t �}� � dt ||�d�� �S � S )Nc 3 � � | ]}|� v V qd S rA r9 )�.0� substring��msgr9 r: � <genexpr>� � � z3_ErrorFormatting._expand_summary.<locals>.<genexpr>z: � ) r2 �_MESSAGE_REPLACEMENTSr rE �any� _SKIP_DETAILSr" �rule_definitionr+ � _NEED_DETAILS�_SummaryWriter� _TOML_JARGONr )rH �bad�repl�schemar3 r9 r[ r: rR � s z _ErrorFormatting._expand_summaryc C s� g }| j jpi }|�dg �}|�dd �pd�|�}|r/d�t|ddddd��}|�d |� �� tj|d d �}tj| j jd d �}d t |d�� �d | j j ��dt |d�� �g}d�|| �} d| � � v rgdt � �nd} | | S )Nz $$description� description� � �P r_ F)�width�initial_indent�subsequent_indent�break_long_wordsz DESCRIPTION: � )r z GIVEN VALUE: zOFFENDING RULE: z DEFINITION: rJ �formatr ) r" r* �pop�joinr �append�json�dumpsr( r r+ r. � _FORMATS_HELP) rH �optionalr* � desc_lines�descrj ri r( �defaultsr\ �epilogr9 r9 r: rT � s0 �� �z _ErrorFormatting._expand_detailsN)r< r= r> r rI r' rP r r3 r4 � staticmethodrD rR rT r9 r9 r9 r: r& ` s r& c @ s� e Zd Zed�Zd)deeeef fdd�Zde ee e f de ee e f fdd �Z d*d d �d e e e e f dede e defdd�Zde e defdd�Zd eeef de e deeef fdd�Zde de e dee fdd�Z d+dedede e defdd �Zde e defd d �Zde e defd d �Zdede e defd!d"�Zd e de e dee fd#d$�Zd%ed&edefd'd(�ZdS ),re )rj �default�title�examplesN�jargonc C sZ |pi | _ dddd| �d�� d�ddd| �d �� �| �d �� d �d d d� | _g d�| _d S )Nz at least one of the followingz exactly one of the followingzall of the followingz(*NOT* the following)r z (in order)zcontains at least one ofznon-predefined acceptable r r z named via patternzpredefined valuezone of) r r r r � prefixItemsr r r �patternProperties�const�enum) r� r� � maxLength� minLength�patternrs �minimum�maximum�exclusiveMinimum�exclusiveMaximum� multipleOf)r� �_jargon�_terms�_guess_inline_defs)rH r� r9 r9 r: rI � s �z_SummaryWriter.__init__�termr# c s* t |t�r� fdd�|D �S � j�||�S )Nc s g | ] }� j �||��qS r9 )r� �get)rY �trO r9 r: � <listcomp>� s z*_SummaryWriter._jargon.<locals>.<listcomp>)� isinstance�listr� r� )rH r� r9 rO r: r� � s z_SummaryWriter._jargonr r9 ��_pathri �prefixr� c C s� t |t�r | �|||�S | �||�}| �||�}|r |� |� �S | �|d�}| �|d�}t|�d }t�� ��} t |� � �D ]|\} \} } g |�| �} | dkrO|n|}| � |� | � | �� d�� t | t �r�| �| | �}| �|| �}| � |rxd|� �n d| | || d�� �� q=t | t�r�| dks�| �| �r�| �| || �}|�d �r�dnd}| � |� |� �� q=| � d| �| | �� d�� q=| �� W d � S 1 s�w Y d S ) Nz �- rk r �:rl r� �type�[)r� r� � _handle_list�_filter_unecessary�_handle_simple_dict� _child_prefixrU �io�StringIO� enumerater �write�_label�dict� _is_propertyrV �_value�getvalue)rH ri r� r� �filtered�simple� child_prefix� item_prefixr �buffer�ir r( � child_path� line_prefix�children�sepr9 r9 r: �__call__� s< �� $�z_SummaryWriter.__call__�pathc s: | � |�s|s dS |d � t� fdd�dD ��p � | jv S )NF���c 3 s � | ]}� � |�V qd S rA )rV )rY �k�r r9 r: r] s � z0_SummaryWriter._is_unecessary.<locals>.<genexpr>z$_)r� ra �_IGNORE)rH r� r9 r� r: �_is_unecessary s z _SummaryWriter._is_unecessaryc s � �fdd�|� � D �S )Nc s( i | ]\}}�� g � �|��s||�qS r9 )r� )rY r r( �r� rH r9 r: � <dictcomp> s ��z5_SummaryWriter._filter_unecessary.<locals>.<dictcomp>)r )rH ri r� r9 r� r: r� s �z!_SummaryWriter._filter_unecessaryr( c sV t � fdd�| jD ��}t dd� � �� D �� }|s |r)dd�| �� |��� d�S d S )Nc 3 rX rA r9 )rY �p�r( r9 r: r] r^ z5_SummaryWriter._handle_simple_dict.<locals>.<genexpr>c s s � | ] }t |ttf�V qd S rA )r� r� r� )rY �vr9 r9 r: r] s � �{�, z} )ra r� �valuesru � _inline_attrs)rH r( r� �inliner� r9 r� r: r� s z"_SummaryWriter._handle_simple_dict�schemasc sj �� ��rdS t|�}tdd� |D ��r t|�dk r |� d�S ��|d�� d�� ��fdd�t|�D ��S )Nr c s s � | ] }t |ttf� V qd S rA )r� r� r� )rY �er9 r9 r: r] s � z._SummaryWriter._handle_list.<locals>.<genexpr>�< rl r� c 3 s2 � | ]\}}�|� g ��d |� d��d�V qdS )r� �]r� Nr9 )rY r� r� �r� r� rH r9 r: r] " s � " �)r� �repr�allrU r� ru r� )rH r� r� r� �repr_r9 r� r: r� s �z_SummaryWriter._handle_listc C s8 d}|ddd� D ] }|dvr n|d7 }q |d dkS )zGCheck if the given path can correspond to an arbitrarily named propertyr ���Nr� > r r� r � r9 )rH r� �counterr r9 r9 r: r� & s z_SummaryWriter._is_propertyc C sX |�^ }}| � |�s t|�}| j�|�pd�| �|��S |d dkr(d|�d�S t|�S )Nrk r� r� z(regex �))r� �_separate_termsr� r� ru r� r� )rH r� �parentsr �norm_keyr9 r9 r: r� 2 s z_SummaryWriter._labelc C sH |d dkr | � |�s | �|�}t|t�r dd�|�� d�S |S t|�S )Nr� r� r� r� r� )r� r� r� r� ru r� )rH r( r� �type_r9 r9 r: r� < s z_SummaryWriter._valuec c sB � |� � D ]\}}g |�|�}| �|�� d| �||�� �V qd S )Nz: )r r� r� )rH ri r� r r( r� r9 r9 r: r� B s � �z _SummaryWriter._inline_attrs� parent_prefixr� c C s t |�d | S )Nrk )rU )rH r� r� r9 r9 r: r� G s z _SummaryWriter._child_prefixrA )r )r r9 ) r< r= r> � frozensetr� r r r' rI r r r� r� r r� �boolr� r r� r� r� r� r� r� r� r r� r� r9 r9 r9 r: re � sP *"����� �* �� � ���� � re �wordc C s dd� t �| �D �S )zE >>> _separate_terms("FooBar-foo") ['foo', 'bar', 'foo'] c S s g | ]}|r|� � �qS r9 )r. )rY �wr9 r9 r: r� P s z#_separate_terms.<locals>.<listcomp>)�_CAMEL_CASE_SPLITTER�split)r� r9 r9 r: r� K s r� ),r� rw rM r, �re�typing� contextlibr �textwrapr r r r r r r r r r �fastjsonschema_exceptionsr � TYPE_CHECKING�sys� version_info�typing_extensionsr � getLoggerr< rK r` rb rd �compiler� �I� _IDENTIFIERrf ry r! rB r& re r' r� r9 r9 r9 r: �<module> sL ( � �"M config/_validate_pyproject/__pycache__/formats.cpython-310.pyc 0000644 00000031567 15030122015 0020425 0 ustar 00 o �h�4 � @ sD d Z ddlZddlZddlZddlZddlZddlZddlmZ ej r)ddl m Z e� e�ZdZe�de d ejejB �Zded efd d �Zd Ze�d e� d�ej�Zded efdd�Zz#zddlm Z W n e yu ddl m Z Y nw ded efdd�Z W n e y� e�!d� ded efdd�Z Y nw ded efdd�Z"ded efdd�Z#d efd d �Z$G d d � d �Z%zdd l&m'Z( ded efd!d"�Z)W n e y� e%� Z)Y nw ded efd#d$�Z*ded efd%d&�Z+d'Z,e�d e,� d�ej�Z-d(Z.e�d e.� d�ej�Z/d)Z0e�d e0� d�ej�Z1ded efd*d+�Z2ded efd,d-�Z3ded efd.d/�Z4ded efd0d1�Z5ded efd2d3�Z6ded efd4d5�Z7ded efd6d7�Z8dej9d efd8d9�Z:dej9d efd:d;�Z;dej9d efd<d=�Z<dej9d efd>d?�Z9zdd@lm=Z> ded efdAdB�Z?W dS e �y� e�!dC� ded efdDdB�Z?Y dS w )Ea@ The functions in this module are used to validate schemas with the `format JSON Schema keyword <https://json-schema.org/understanding-json-schema/reference/string#format>`_. The correspondence is given by replacing the ``_`` character in the name of the function with a ``-`` to obtain the format name and vice versa. � N)�chain)�Literala� v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version z^\s*z\s*$�version�returnc C � t �| �duS )zpSee :ref:`PyPA's version specification <pypa:version-specifiers>` (initially introduced in :pep:`440`). N)� VERSION_REGEX�match)r � r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/formats.py�pep440< � r z'([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])�^�$�namec C r )zlSee :ref:`PyPA's name specification <pypa:name-format>` (initially introduced in :pep:`508#names`). N)�PEP508_IDENTIFIER_REGEXr )r r r r �pep508_identifierJ r r )� requirements�valuec C �( zt �| � W dS t jy Y dS w )z{See :ref:`PyPA's dependency specifiers <pypa:dependency-specifiers>` (initially introduced in :pep:`508`). TF)�_req� Requirement�InvalidRequirement�r r r r �pep508Z � �r z�Could not find an installation of `packaging`. Requirements, dependencies and versions might not be validated. To enforce validation, please install `packaging`.c C � dS �NTr r r r r r k � c s( t � fdd�dD ��r dS td� � ��S )z�Expression that can be used to specify/lock versions (including ranges) See ``versionspec`` in :ref:`PyPA's dependency specifiers <pypa:dependency-specifiers>` (initially introduced in :pep:`508`). c 3 s � | ]}|� v V qd S �Nr )�.0�cr r r � <genexpr>t � � z%pep508_versionspec.<locals>.<genexpr>)�;�]�@F� requirement)�anyr r r r r �pep508_versionspeco s r( c C sB | � d�\}}}dd� t|�d�|�d��D �}tdd� |D ��S )z�See PyPA's specification for defining build-backend references introduced in :pep:`517#source-trees`. This is similar to an entry-point reference (e.g., ``package.module:object``). �:c s � � | ]}|� � V qd S r ��strip�r �ir r r r! � r" z+pep517_backend_reference.<locals>.<genexpr>�.c s s � | ] }|rt |�V qd S r ��python_identifierr- r r r r! � � � )� partition�_chain�split�all)r �module�_�obj� identifiersr r r �pep517_backend_reference� s r; c C s� dd l } ddlm} ddlm} d}| �� }|||d�� }|� }|�dd�|d< |�� �|� d d ��W d � S 1 s=w Y d S ) Nr )�Message)�urlopenz.https://pypi.org/pypi?:action=list_classifiers)�contextz content-typez text/plain� content_type�charsetzutf-8) �ssl� email.messager< �urllib.requestr= �create_default_context� getheader�read�decode� get_param)rA r< r= �urlr> �response�headersr r r �_download_classifiers� s $�rL c @ sT e Zd ZU dZejddeje f ed< d dd�Z d dd �Z d ede fd d �Z dS )�_TroveClassifierak The ``trove_classifiers`` package is the official way of validating classifiers, however this package might not be always available. As a workaround we can still download a list from PyPI. We also don't want to be over strict about it, so simply skipping silently is an option (classifiers will be validated anyway during the upload to PyPI). NzLiteral[False]� downloadedr c C s d | _ d| _d| _d S )NF�trove_classifier)rN �_skip_download�__name__��selfr r r �__init__� s z_TroveClassifier.__init__c C s d| _ d S r )rP rR r r r �_disable_download� s z"_TroveClassifier._disable_downloadr c C s� | j du s | jdu r dS t�d�st�d�r"d| _ d}t�|� dS | j d u rKd}t�|� z tt� �� �| _ W n t yJ d| _ t�d� Y dS w || j v pV|� � � d�S ) NFT� NO_NETWORK� VALIDATE_PYPROJECT_NO_NETWORKzxInstall ``trove-classifiers`` to ensure proper validation. Skipping download of classifiers list from PyPI (NO_NETWORK).zxInstall ``trove-classifiers`` to ensure proper validation. Meanwhile a list of classifiers will be downloaded from PyPI.z*Problem with download, skipping validation� private ::) rN rP �os�getenv�_logger�debug�setrL � splitlines� Exception�lower� startswith)rS r �msgr r r �__call__� s( � � �z_TroveClassifier.__call__)r N) rQ � __module__� __qualname__�__doc__�typing�Union�Set�str�__annotations__rT rU �boolrc r r r r rM � s rM )� classifiersc C s | t v p | �� �d�S )z!See https://pypi.org/classifiers/rX )�_trove_classifiersr` ra r r r r rO � s rO c C s> | � d�^}}|�d�sdS td�|dtd� � g|���S )z�Name of a directory containing type stubs. It must follow the name scheme ``<package>-stubs`` as defined in :pep:`561#stub-only-packages`. r/ �-stubsFN)r5 �endswith�python_module_name�join�len)r �top�childrenr r r �pep561_stub_name� s "rv c C s| ddl m} z-|| �}|js+t�d| � �� | �d�s+| �d�s+d| v s+|d| � ��}t|jo1|j�W S ty= Y dS w ) z�Valid URL (validation uses :obj:`urllib.parse`). For maximum compatibility please make sure to include a ``scheme`` prefix in your URL (e.g. ``http://``). r )�urlparsezsFor maximum compatibility please make sure to include a `scheme` prefix in your URL (e.g. 'http://'). Given value: �/�\r% zhttp://F) � urllib.parserw �schemer[ �warningra rl �netlocr_ )r rw �partsr r r rI � s �� �rI z[^\[\s=]([^=]*[^\s=])?z[\w.-]+z \w+(\.\w+)*c C s | � � S )zXCan be used as identifier in Python. (Validation uses :obj:`str.isidentifier`). )� isidentifierr r r r r1 � r1 c C s0 | � d�s | �d�r dS tdd� | �d�D ��S )z� Python "dotted identifier", i.e. a sequence of :obj:`python_identifier` concatenated with ``"."`` (e.g.: ``package.module.submodule``). r/ Fc s � � | ]}t |�V qd S r r0 )r �mr r r r! r" z.python_qualified_identifier.<locals>.<genexpr>)ra rp r6 r5 r r r r �python_qualified_identifier s r� c C s t | �S )zsModule name that can be used in an ``import``-statement in Python. See :obj:`python_qualified_identifier`. )r� r r r r rq " r� rq c C s6 | � d�s | �d�r dS | �d�rdS t| �dd��S )a� Similar to :obj:`python_module_name`, but relaxed to also accept dash characters (``-``) and cover special cases like ``pip-run``. It is recommended, however, that beginners avoid dash characters, as they require advanced knowledge about Python internals. The following are disallowed: * names starting/ending in dashes, * names ending in ``-stubs`` (potentially collide with :obj:`pep561_stub_name`). �-Fro r8 )ra rp rq �replacer r r r �python_module_name_relaxed) s r� c C r )zhSee ``Data model > group`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. N)�ENTRYPOINT_GROUP_REGEXr r r r r �python_entrypoint_group< r r� c C s: t �| �sdS t�| �sd| � d�}|t7 }t�|� dS )zgSee ``Data model > name`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. Fz Entry point `z'` does not follow recommended pattern: T)�ENTRYPOINT_REGEXr �RECOMMEDED_ENTRYPOINT_REGEX� RECOMMEDED_ENTRYPOINT_PATTERNr[ r| )r rb r r r �python_entrypoint_nameC s r� c C s� | � d�\}}}d|v rC|� d�\}}}|�� d dkr dS dd� |�tjd ��d �D �}td d� |D ��s9dS t�d | � d �� n|}|�d �}|rTt||�d ��nt |�}tdd� |D ��S )z�Reference to a Python object using in the format:: importable.module:object.attr See ``Data model >object reference`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. r) �[���r$ Fc s r* r r+ )r �xr r r r! ] r" z.python_entrypoint_reference.<locals>.<genexpr>z[]�,c s r� r )r )r �er r r r! ^ r" �`z4` - using extras for entry points is not recommendedr/ c s s � | ] }t |�� �V qd S r )r1 r, r- r r r r! f r2 ) r3 r, �string� whitespacer5 r6 r[ r| r4 �iter) r r7 r8 �restr9 �extras_�extras� module_partsr: r r r �python_entrypoint_referenceP s r� c C � d| ko dk S S )z/Unsigned 8-bit integer (:math:`0 \leq x < 2^8`)r � r r r r r �uint8i � r� c C r� )z3Unsigned 16-bit integer (:math:`0 \leq x < 2^{16}`)r i r r r r r �uint16n r� r� c C r� )z3Unsigned 64-bit integer (:math:`0 \leq x < 2^{64}`)r l r r r r r �uints r� r� c C r� )z7Signed 64-bit integer (:math:`-2^{63} \leq x < 2^{63}`)l���� l r r r r r �intx r� r� )�licensesc C r )z�See :ref:`PyPA's License-Expression specification <pypa:core-metadata-license-expression>` (added in :pep:`639`). TF)� _licenses� canonicalize_license_expression�InvalidLicenseExpressionr r r r �SPDX� r r� z�Could not find an up-to-date installation of `packaging`. License expressions might not be validated. To enforce validation, please install `packaging>=24.2`.c C r r r r r r r r� � r )@rf �builtins�loggingrY �rer� rg � itertoolsr r4 � TYPE_CHECKING�typing_extensionsr � getLoggerrQ r[ �VERSION_PATTERN�compile�X�Ir rj rl r �PEP508_IDENTIFIER_PATTERNr r � packagingr r � ImportError� setuptools._vendor.packagingr r| r( r; rL rM �trove_classifiersrm rn rO rv rI �ENTRYPOINT_PATTERNr� r� r� �ENTRYPOINT_GROUP_PATTERNr� r1 r� rq r� r� r� r� r� r� r� r� r� r� r� r r r r �<module> s� � �� 5 � �� config/_validate_pyproject/__pycache__/__init__.cpython-310.pyc 0000644 00000002745 15030122015 0020505 0 ustar 00 o �h � @ s� U d dl mZ d dlmZmZmZ ddlmZ ddlm Z m Z ddl m Z ddl mZmZ ddlmZ g d �Zd d � ej�� D �Zeeeegef f ed < d edefdd�ZdS )� )�reduce)�Any�Callable�Dict� )�formats)�detailed_errors�ValidationError)�EXTRA_VALIDATIONS)�JsonSchemaException�JsonSchemaValueException)�validate)r �FORMAT_FUNCTIONSr r r r c C s0 i | ]}t |�r|j�d �s|j�d d�|�qS )�_�-)�callable�__name__� startswith�replace)�.0�fn� r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/__init__.py� <dictcomp> s � ��r r �data�returnc C sH t � � t| td� tdd� t| � W d � dS 1 s w Y dS )z~Validate the given ``data`` object using JSON Schema This function raises ``ValidationError`` if ``data`` is invalid. )�custom_formatsc S s || �S )Nr )�accr r r r �<lambda>! s zvalidate.<locals>.<lambda>NT)r � _validater r r )r r r r r s ��r N)� functoolsr �typingr r r � r �error_reportingr r �extra_validationsr �fastjsonschema_exceptionsr r �fastjsonschema_validationsr r �__all__�__dict__�valuesr �str�bool�__annotations__r r r r �<module> s � config/_validate_pyproject/__pycache__/extra_validations.cpython-310.pyc 0000644 00000004474 15030122015 0022467 0 ustar 00 o �h* � @ s� d Z ddlmZ ddlmZmZ ddlmZ eded�ZG dd � d e�Z G d d � d e�Z d ed efdd�Z d ed efdd�Z e e fZ dS )z�The purpose of this module is implement PEP 621 validations that are difficult to express as a JSON Schema (or that are not supported by the current JSON Schema library). � )�cleandoc)�Mapping�TypeVar� )�ValidationError�T)�boundc @ � e Zd ZdZeZdZdS )� RedefiningStaticFieldAsDynamicz�According to PEP 621: Build back-ends MUST raise an error if the metadata specifies a field statically as well as being listed in dynamic. zMhttps://packaging.python.org/en/latest/specifications/pyproject-toml/#dynamicN��__name__� __module__� __qualname__�_DESC�__doc__�_URL� r r �j/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/extra_validations.pyr s �r c @ r )� IncludedDependencyGroupMustExistzDAn included dependency group must exist and must not be cyclic. z!https://peps.python.org/pep-0735/Nr r r r r r s r � pyproject�returnc C sl | � di �}|� dg �}|D ]%}||v r3td|� d�||| ddd|id|� �ttj�tjd�d d ��q| S ) N�project�dynamicz(You cannot provide a value for `project.z6` and list it under `project.dynamic` at the same timez...z # ...z data.project.�� description�seezPEP 621��message�value�name� definition�rule)�getr r r r )r � project_tabler �fieldr r r �validate_project_dynamic" s$ ����r% c C sz | � di �}|�� D ]0\}}|D ])}t|t�r9|� d� }r9||vr9td|� d�|d|� �ttj�tjd�dd��qq | S ) Nzdependency-groupsz include-groupz The included dependency group z doesn't existzdata.dependency_groups.r zPEP 735r )r" �items� isinstance�dictr r r r )r �dependency_groups�keyr �each� include_groupr r r �validate_include_depenency; s( � � ����r- N)r �inspectr �typingr r �error_reportingr r r r r% r- �EXTRA_VALIDATIONSr r r r �<module> s config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-310.pyc 0000644 00000261220 15030122015 0024346 0 ustar 00 o �hzi � @ s0 d Z ddlmZ ddlZddlmZ e�d�e�d�e�d�e�d �e�d �d �Zed�Z i dfd d �Z i dfdd�Z i dfdd�Z i dfdd�Z i dfdd�Zi dfdd�Zi dfdd�Zi dfdd�Zi dfd d �Zi dfd d �Zi dfd d!�Zi dfd"d#�Zi dfd$d%�Zi dfd&d'�Zi dfd(d)�ZdS )*z2.20.0� )�DecimalN� )�JsonSchemaValueExceptionz6^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])\Z�^.*$�.+�^.+$z^[^@]+@[^@]+\.[^@]+\Z)�5^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$r r r �idn-email_re_patternc C � t | ||pdd � | S �N�data� )�[validate_https___packaging_python_org_en_latest_specifications_declaring_build_dependencies�r �custom_formats� name_prefix� r �s/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py�validate � r c ' ( C s�) t | t��s�td|p d d | d|pd d dddg d�dd dd d d g d �d did�dddd�d ddgddd�d�d�dgd�dddd d gdi d dd d d��d!dd"d#d��d$dd%d&gd'��d(g d)�dg d*�d'�dd+d,dd-d.gd'�id,gd/�d0dd1d2�id0gd/�gid3dg d4�d5d6�id3gd/�gd7�gd8��d9dd:d;d<gd=��d>d?dd@dAd�dd,ddBdCgd'�id,gdD�dd0dg dE�d'�id0gdD�gdF��dGdHd d didI��dJd dKdLig dM�dN��dOd dKdLidPdQgdN��dRd d didSdT��dUd ddVdWdX�dYdZgdN��d[dd\d d]dd^d_�id`��dadbdcddgde��dfdbg dg�de��dhg di�djdkid d]dKdbiidl��dmd dndKdoidp��dqddrdjd id d]d dKdoids�idt��dud dvdwgdxg dy�id�i�d gd dugdudzd!id{gd|�id}�g d~�d�d!gd�gd��d��d�dGgid�d>d diiid��gdLd�d�dd dd�d�gd'�dd�d�dX�d��d��dbd�dg d��djd�id d]dd�d�gd�d�d��id��dod�dd�d�d��d��d�� ddd�d�g d��dd�dd�d2�id�d diid�d��dd�d�g d��dd i d�d d dids��d�d�d�gd dd d_�d���d�d�d�gd dd d_�d���d�g d��d�d���d�g d��d d did�d���d�g d��d d did���d�g d��d�d dKd�id��dKd�igd8��d�g d��dd d+dzdidKd�igid�d diid���d�g dâdd d+dd�d_�dzd�igid�d d dids�id���d�g dǢd�d���d�g dɢdd d+dd�d_�dzd�igid�d d dids�id���d�d dd�d_�d�d�dΜ�d�d�d dd�d_�d�dҜ�d�d�d dKd�idI��d�g dעdd�d d dids�id�d�g dڢdd�dd�d_�id�dGd d dig dܢd�dޜ�dudd�d g d�dKd�idKd�igd8�dKd�idKd�idKd�idKd�iddd d_�d d�dKd�iid�ddKd�idd didKd�id�d d�gd,gd�d�d�i�d�d�d�ddd�d_�dd�d_�gd�d�d�d�dd d�gd i d dd�d_��d�d d dids��d�d d dids��d�d d d�dd��d�d did d�igdF�gd d��ds��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids���d d d dids���dd d dids���dd d dids���dd di��dd d�i��dd d�i��d�d�d�ddd d,�d d did d dids�giid,g�d ��d �d g �d �idKd�ig�d��dd�d�dgdd �ddd�d_�i�dg�d�d��ddd �dd�d�dgd �dd d didI�d �d�dgd did�d �d�dgd did�d��d �d gd'��d ��d �i�d ��d!��d"��d#��d$�d�d%d �d&d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gids�id`��d,�dddd d gdi d dd d d��d!dd"d#d��d$dd%d&gd'��d(g d)�dg d*�d'�dd+d,dd-d.gd'�id,gd/�d0dd1d2�id0gd/�gid3dg d4�d5d6�id3gd/�gd7�gd8��d9dd:d;d<gd=��d>d?dd@dAd�dd,ddBdCgd'�id,gdD�dd0dg dE�d'�id0gdD�gdF��dGdHd d didI��dJd dKdLig dM�dN��dOd dKdLidPdQgdN��dRd d didSdT��dUd ddVdWdX�dYdZgdN��d[dd\d d]dd^d_�id`��dadbdcddgde��dfdbg dg�de��dhg di�djdkid d]dKdbiidl��dmd dndKdoidp��dqddrdjd id d]d dKdoids�idt��dud dvdwgdxg dy�id�i�d gd dugdudzd!id{gd|�id}�g d~�d�d!gd�gd��d��d�dGgid�d>d diiid��gdLd�d�dd dd�d�gd'�dd�d�dX�d��d��dbd�dg d��djd�id d]dd�d�gd�d�d��id��dod�dd�d�d��d��d�� �d-�d �d.��t | t�}|�r�t| �� �}�d/|v �rN|��d/� | �d/ }t |t��s9td|�pd �d0 |d|�pd �d1 dd d d g d �d did�dddd�d ddgddd�d�d�dgd�d �d.��t |t�}|�rNtdg�|�� }|�r�td|�pSd �d2 tt|���d3 |d|�pfd �d1 dd d d g d �d did�dddd�d ddgddd�d�d�dgd�d��d.��t|�� �}d|v �r |�d� |d } t | tt f��s�td|�p�d �d4 | d|�p�d �d5 d g d �d did�d �d.��t | tt f�} | �r t | �} t | �D ]<\} } t | t��std|�p�d �d6j �d]i t � �� �d7 | d|�pd �d6j �d]i t � �� d d did �d.���q�d8|v �r}|��d8� |�d8 }t |t��sRtd|�p:d �d9 |d|�pDd �d: dddd�d �d.��t |t��r}|d |��s}td|�ped �d; |d|�pod �d: dddd�dj�d.���d<|v �r |��d<� |�d< }t |tt f��s�td|�p�d �d= |d|�p�d �d> d ddgddd�d�d �d.��t |tt f�}|�r t |�}t |�D ]=\}}t |t��std|�p�d �d?j �d]i t � �� �d7 |d|�p�d �d?j �d]i t � �� d ddd�d �d.���q�|�rNtd|�pd �d@ t|� �d3 |d|�p#d �d1 dd d d g d �d did�dddd�d ddgddd�d�d�dgd��dA�d.���dB|v �rk|��dB� | �dB }t|||�pfd�dC � �dD|v � ro|��dD� | �dD }t |t�� s'td|�p�d �dE |d|�p�d �dF ddd�d�g d��dd�dd�d2�id�d diid�d��dd�d�g d��dd i d�d d dids��d�d�d�gd dd d_�d���d�d�d�gd dd d_�d���d�g d��d�d���d�g d��d d did�d���d�g d��d d did���d�g d��d�d dKd�id��dKd�igd8��d�g d��dd d+dzdidKd�igid�d diid���d�g dâdd d+dd�d_�dzd�igid�d d dids�id���d�g dǢd�d���d�g dɢdd d+dd�d_�dzd�igid�d d dids�id���d�d dd�d_�d�d�dΜ�d�d�d dd�d_�d�dҜ�d�d�d dKd�idI��d�g dעdd�d d dids�id�d�g dڢdd�dd�d_�id�dGd d dig dܢd�dޜ�dudd�d g d�dKd�idKd�igd8�dKd�idKd�idKd�idKd�iddd d_�d d�dKd�iid�ddKd�idd didKd�id�d d�gd,gd�d�d�i�d�d�d�ddd�d_�dd�d_�gd�d�d�d�dd d�gd i d dd�d_��d�d d dids��d�d d dids��d�d d d�dd��d�d did d�igdF�gd d��ds��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids���d d d dids���dd d dids���dd d dids���dd di��dd d�i��dd d�i��d�d�d�ddd d,�d d did d dids�giid,g�d ��d �d g �d �idKd�ig�d��dd�d�dgdd �ddd�d_�i�dg�d�d��ddd �dd�d�dgd �dd d didI�d �d�dgd did�d �d�dgd did�d��d �d gd'��d ��d �i�d ��d!��d"��d#��d$�d �d.��t |t�}|� rot|�� �}�dG|v � rR|��dG� |�dG }t|||� pMd�dH � �dI|v � ro|��dI� |�dI }t|||� pjd�dJ � �dK|v �r�|��dK� | �dK }t |t�� s�td|� p�d �dL |d|� p�d �dM d�d%d �d&d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gids�id`�d �d.��t |t�}|�r�t|�� �} |�� D �]�\} } t�d& �| ��r�| | v � r�| �| � t | tt f�� sBtd|� p�d �dNj �d]i t � �� �dO | d|� pd �dNj �d]i t � �� d d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gids�d �d.��t | tt f�} | �r�t | �} t | �D �]:\}!}"�dP}#|#�dQk � r�z�t |"t�� s�td|� pod �dRj �d]i t � �� �d7 |"d|� p�d �dRj �d]i t � �� d d�d'd�d�d �d.��t |"t�� r�|d� |"�� s�td|� p�d �dRj �d]i t � �� �dS |"d|� p�d �dRj �d]i t � �� d d�d'd�d�dj�d.��|#�dT7 }#W n t� y� Y nw |#�dQk �r5�z4t |"t�� s:td|� pd �dRj �d]i t � �� d |"d|� pd �dRj �d]i t � �� d dd �d(�d)d�d&�d*�i�d+�d �d.��t |"t�}$|$�r$t|"�� �}%�d(|%v � r�|%��d(� |"�d( }&t |&t�� s�td|� ped �dUj �d]i t � �� �d7 |&d|� pzd �dUj �d]i t � �� d �d)d�d&�d*�d �d.��t |&t�� r�t�d& �|&�� s�td|� p�d �dUj �d]i t � �� �dV |&d|� p�d �dUj �d]i t � �� d �d)d�d&�d*��dW�d.��|%�r$td|� p�d �dRj �d]i t � �� �dX t|%� �d3 |"d|�p d �dRj �d]i t � �� d dd �d(�d)d�d&�d*�i�d+��dA�d.��|#�dT7 }#W n t�y4 Y nw |#�dTk�r�td|�pAd �dRj �d]i t � �� �dY �dZt|#� �d[ |"d|�p`d �dRj �d]i t � �� d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gi�d �d.��� qT� q�| �r�td|�p�d �d\ t| � �d3 |d|�p�d �dM d�d%d �d&d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gids�id`��dA�d.��|�r�td|�p�d �dX t|� �d3 | d|�p�d d dddg d�dd dd d d g d �d did�dddd�d ddgddd�d�d�dgd�dddd d gdi d dd d d��d!dd"d#d��d$dd%d&gd'��d(g d)�dg d*�d'�dd+d,dd-d.gd'�id,gd/�d0dd1d2�id0gd/�gid3dg d4�d5d6�id3gd/�gd7�gd8��d9dd:d;d<gd=��d>d?dd@dAd�dd,ddBdCgd'�id,gdD�dd0dg dE�d'�id0gdD�gdF��dGdHd d didI��dJd dKdLig dM�dN��dOd dKdLidPdQgdN��dRd d didSdT��dUd ddVdWdX�dYdZgdN��d[dd\d d]dd^d_�id`��dadbdcddgde��dfdbg dg�de��dhg di�djdkid d]dKdbiidl��dmd dndKdoidp��dqddrdjd id d]d dKdoids�idt��dud dvdwgdxg dy�id�i�d gd dugdudzd!id{gd|�id}�g d~�d�d!gd�gd��d��d�dGgid�d>d diiid��gdLd�d�dd dd�d�gd'�dd�d�dX�d��d��dbd�dg d��djd�id d]dd�d�gd�d�d��id��dod�dd�d�d��d��d�� ddd�d�g d��dd�dd�d2�id�d diid�d��dd�d�g d��dd i d�d d dids��d�d�d�gd dd d_�d���d�d�d�gd dd d_�d���d�g d��d�d���d�g d��d d did�d���d�g d��d d did���d�g d��d�d dKd�id��dKd�igd8��d�g d��dd d+dzdidKd�igid�d diid���d�g dâdd d+dd�d_�dzd�igid�d d dids�id���d�g dǢd�d���d�g dɢdd d+dd�d_�dzd�igid�d d dids�id���d�d dd�d_�d�d�dΜ�d�d�d dd�d_�d�dҜ�d�d�d dKd�idI��d�g dעdd�d d dids�id�d�g dڢdd�dd�d_�id�dGd d dig dܢd�dޜ�dudd�d g d�dKd�idKd�igd8�dKd�idKd�idKd�idKd�iddd d_�d d�dKd�iid�ddKd�idd didKd�id�d d�gd,gd�d�d�i�d�d�d�ddd�d_�dd�d_�gd�d�d�d�dd d�gd i d dd�d_��d�d d dids��d�d d dids��d�d d d�dd��d�d did d�igdF�gd d��ds��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids��d�d d dids���d d d dids���dd d dids���dd d dids���dd di��dd d�i��dd d�i��d�d�d�ddd d,�d d did d dids�giid,g�d ��d �d g �d �idKd�ig�d��dd�d�dgdd �ddd�d_�i�dg�d�d��ddd �dd�d�dgd �dd d didI�d �d�dgd did�d �d�dgd did�d��d �d gd'��d ��d �i�d ��d!��d"��d#��d$�d�d%d �d&d �d d�d'd�d�dd �d(�d)d�d&�d*�i�d+�gids�id`��d,�dddd d gdi d dd d d��d!dd"d#d��d$dd%d&gd'��d(g d)�dg d*�d'�dd+d,dd-d.gd'�id,gd/�d0dd1d2�id0gd/�gid3dg d4�d5d6�id3gd/�gd7�gd8��d9dd:d;d<gd=��d>d?dd@dAd�dd,ddBdCgd'�id,gdD�dd0dg dE�d'�id0gdD�gdF��dGdHd d didI��dJd dKdLig dM�dN��dOd dKdLidPdQgdN��dRd d didSdT��dUd ddVdWdX�dYdZgdN��d[dd\d d]dd^d_�id`��dadbdcddgde��dfdbg dg�de��dhg di�djdkid d]dKdbiidl��dmd dndKdoidp��dqddrdjd id d]d dKdoids�idt��dud dvdwgdxg dy�id�i�d gd dugdudzd!id{gd|�id}�g d~�d�d!gd�gd��d��d�dGgid�d>d diiid��gdLd�d�dd dd�d�gd'�dd�d�dX�d��d��dbd�dg d��djd�id d]dd�d�gd�d�d��id��dod�dd�d�d��d��d�� �d-��dA�d.��| S (^ Nr r � must be object�'http://json-schema.org/draft-07/schema#zShttps://packaging.python.org/en/latest/specifications/declaring-build-dependencies/z+Data structure for ``pyproject.toml`` files)zKFile format containing build-time configurations for the Python ecosystem. zO:pep:`517` initially defined a build-system independent format for source treeszQwhich was complemented by :pep:`518` to provide a way of specifying dependencies z for building Python projects.zYPlease notice the ``project`` table (as initially defined in :pep:`621`) is not includedz3in this schema and should be considered separately.�objectFz&Table used to store build-related data�array)zKList of dependencies in the :pep:`508` format required to execute the buildz9system. Please notice that the resulting dependency graphz**MUST NOT contain cycles**�type�string�r � $$description�itemszLPython object that will be used to perform the build according to :pep:`517`zpep517-backend-reference�r � description�formatzDList of directories to be prepended to ``sys.path`` when loading thez back-end, and running its hooksz0Should be a path (TODO: enforce it with format?))r �$comment)�requires� build-backend� backend-pathr# )r r �additionalProperties� properties�required�Ehttps://packaging.python.org/en/latest/specifications/pyproject-toml/�0Package metadata stored in the ``project`` table�BData structure for the **project** table inside ``pyproject.toml``�$(as initially defined in :pep:`621`)�name�IThe name (primary identifier) of the project. MUST be statically defined.�pep508-identifier�version�6The version of the project as supported by :pep:`440`.�pep440r �'The `summary description of the project�F<https://packaging.python.org/specifications/core-metadata/#summary>`_�r r �readme�zA`Full/detailed description of the project in the form of a READMEz,<https://peps.python.org/pep-0621/#readme>`_zGwith meaning similar to the one defined in `core metadata's DescriptionzJ<https://packaging.python.org/specifications/core-metadata/#description>`_�zDRelative path to a text file (UTF-8) containing the full descriptionzDof the project. If the file path ends in case-insensitive ``.md`` orz8``.rst`` suffixes, then the content-type is respectivelyz#``text/markdown`` or ``text/x-rst``�anyOf�file�<Relative path to a text file containing the full description�of the project.�r' r( �text�!Full text describing the project.�r r � content-type�z2Content-type (:rfc:`1341`) of the full descriptionz>(e.g. ``text/markdown``). The ``charset`` parameter is assumedzUTF-8 when not present.�"TODO: add regex pattern or format?�r r r" �r �allOf�r �oneOf�requires-python�pep508-versionspec�/`The Python version requirements of the project�O<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.�r r! r �license�?`Project license <https://peps.python.org/pep-0621/#license>`_.�An SPDX license identifier�SPDX�DRelative path to the file (UTF-8) which contains the license for the�project.�r r' r( �z7The license of the project whose meaning is that of thez%`License field from the core metadatazG<https://packaging.python.org/specifications/core-metadata/#license>`_.�r rH � license-files�(Paths or globs to paths of license files�r r r �authors�$ref�#/definitions/author�zJThe people or organizations considered to be the 'authors' of the project.zNThe exact meaning is open to interpretation (e.g. original or primary authors,z/current maintainers, or owners of the package).�r r r � maintainers�NThe people or organizations considered to be the 'maintainers' of the project.�FSimilarly to ``authors``, the exact meaning is open to interpretation.�keywords�NList of keywords to assist searching for the distribution in a larger catalog.�r r r � classifiers�trove-classifier�3`PyPI classifier <https://pypi.org/classifiers/>`_.�r r! r �4`Trove classifiers <https://pypi.org/classifiers/>`_�which apply to the project.�urls�@URLs associated with the project in the form ``label => value``.r �url�r r! �r r r& �patternProperties�scripts� #/definitions/entry-point-groupzDInstruct the installer to create command-line wrappers for the given�L`entry points <https://packaging.python.org/specifications/entry-points/>`_.)r[ r � gui-scripts)z;Instruct the installer to create GUI wrappers for the givenrs zJThe difference between ``scripts`` and ``gui-scripts`` is only relevant inzWindows.� entry-points�z@Instruct the installer to expose the given modules/functions viaz9``entry-point`` discovery mechanism (useful for plugins).z9More information available in the `Python packaging guidez><https://packaging.python.org/specifications/entry-points/>`_.r! �python-entrypoint-group�r � propertyNamesr& rp � dependencies�!Project (mandatory) dependencies.�#/definitions/dependency�r r r �optional-dependencies�#Optional dependency for the project�r r �r r ry r& rp �dynamic�GSpecifies which fields are intentionally unspecified and expected to be�#dynamically provided by build tools�enum�r0 r r6 rI rN rW rZ r_ rb re rk rq rt ru rz r~ �const� version is listed in ``dynamic``��containsr �r( r' � zAccording to :pep:`621`:zH If the core metadata specification lists a field as "Required", thenzH the metadata MUST specify the field statically or list it in dynamicz"In turn, `core metadata`_ defines:z= The required fields are: Metadata-Version, Name, Version.z& All the other fields are optional.zISince ``Metadata-Version`` is defined by the build back-end, ``name`` andzE``version`` are the only mandatory information in ``pyproject.toml``.zM.. _core metadata: https://packaging.python.org/specifications/core-metadata/��notz $$comment�=version should be statically defined in the ``version`` field�r( r ��if�thenr( r' �Author or Maintainer�5https://peps.python.org/pep-0621/#authors-maintainers�IMUST be a valid email name, i.e. whatever can be put as a name, before an�email, in :rfc:`822`.� idn-email� MUST be a valid email address�r- �email��$id�titler" r r& r' � Entry-points�zLEntry-points are grouped together to indicate what sort of capabilities theyzprovide.zSee the `packaging guidesz=<https://packaging.python.org/specifications/entry-points/>`_zand `setuptools docszC<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_zfor more information.�python-entrypoint-name�6Reference to a Python object. It is either in the form�<``importable.module``, or ``importable.module:object.attr``.�python-entrypoint-reference�9https://packaging.python.org/specifications/entry-points/�r r r! r" �r� r� r r ry r& rp � Dependency�5Project dependency specification according to PEP 508�pep508�r� r� r r r! ��authorzentry-point-group� dependency� �$schemar� r� r r r' r( r& rF � definitions�Ihttps://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html�``tool.distutils`` table�zC**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``z<subtables to configure arguments for ``distutils`` commands.zGOriginally, ``distutils`` allowed developers to configure arguments forz8``setup.py`` commands via `distutils configuration fileszN<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.zHSee also `the old Python docs <https://docs.python.org/3.11/install/>_`.�global�4Global options applied to all ``distutils`` commandsr �CTODO: Is there a practical way of making this schema more specific?�r� r� r� r r r' rp r" �Dhttps://setuptools.pypa.io/en/latest/userguide/pyproject_config.html�``tool.setuptools`` table� zL``setuptools``-specific configurations that can be set by users that requirezcustomization.zMThese configurations are completely optional and probably can be skipped whenzFcreating simple packages. They are equivalent to some of the `KeywordszA<https://setuptools.pypa.io/en/latest/references/keywords.html>`_zPused by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.z,It considers only ``setuptools`` `parameterszj<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_zSthat are not covered by :pep:`621`; and intentionally excludes ``dependency_links``zFand ``setup_requires`` (incompatible with modern workflows/standards).� platforms�provides�?Package and virtual package names contained within this package�**(not supported by pip)**�r r r � obsoletes�,Packages which this package renders obsolete�zip-safe�zDWhether the project can be safely installed and run from a zip file.�G**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and�A``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).�boolean�r r � script-files�z<Legacy way of defining scripts (entry-points are preferred).z4Equivalent to the ``script`` keyword in ``setup.py``zM(it was renamed to avoid confusion with entry-point based ``project.scripts``zdefined in :pep:`621`).zN**DISCOURAGED**: generic script wrappers are tricky and may not work properly.z:Whenever possible, please use ``project.scripts`` instead.�1TODO: is this field deprecated/should be removed?�r r r r" �eager-resources�zFResources that should be extracted together, if any of them is needed,z<or if any C extensions included in the project are imported.r� r� �packages�z5Packages that should be included in the distribution.z7It can be given either as a list of package identifiersz:or as a ``dict``-like structure with a single key ``find``z&which corresponds to a dynamic call toz4``setuptools.config.expand.find_packages`` function.zMThe ``find`` key is associated with a nested ``dict``-like structure that canzDcontain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,z;mimicking the keyword arguments of the associated function.�#Array of Python package identifiers�#/definitions/package-name�r� r r � #/definitions/find-directive� package-dir�zR:class:`dict`-like structure mapping from package names to directories where theirzcode can be found.zFThe empty string (as key) means that all packages are contained insidez9the given directory will be included in the distribution.r �r r r& ry rp � package-data�z5Mapping from package names to lists of glob patterns.zLUsually this option is not needed when using ``include-package-data = true``�MFor more information on how to include data files, check ``setuptools`` `docs�B<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.�python-module-name�*�include-package-data�zCAutomatically include any data files inside the package directoriesz%that are specified by ``MANIFEST.in``r� r� �exclude-package-data�zLMapping from package names to lists of glob patterns that should be excludedr� r� �namespace-packages�python-module-name-relaxed�Ehttps://setuptools.pypa.io/en/latest/userguide/package_discovery.html�=**DEPRECATED**: use implicit namespaces instead (:pep:`420`).�r r r" r � py-modules�'Modules that setuptools will manipulate�0TODO: clarify the relationship with ``packages``�r r r r" � ext-modules�.Extension modules to be compiled by setuptools�#/definitions/ext-module� data-files�zA``dict``-like structure where each key represents a directory andzFthe value is a list of glob patterns that should be installed in them.zK**DISCOURAGED**: please notice this might not work as expected with wheels.zKWhenever possible, consider using data files inside the package directorieszB(or create a new namespace package that only contains data files).zSee `data files supportr� �r r rp �cmdclass�zMMapping of distutils-style command names to ``setuptools.Command`` subclasseszJwhich in turn should be represented by strings with a qualified class namez+(i.e., "dotted" form with module), e.g.:: z; cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"} zFThe command class should be a directly defined at the top-level of thez%containing module (no class nesting).�python-qualified-identifier�zO**PROVISIONAL**: list of glob patterns for all license files being distributed.z,(likely to become standard with :pep:`639`).zBBy default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``�HTODO: revise if PEP 639 is accepted. Probably ``project.license-files``?�r r r r" �@Instructions for loading :pep:`621`-related metadata dynamically�zBA version dynamically loaded via either the ``attr:`` or ``file:``zMdirectives. Please make sure the given file or attribute respects :pep:`440`.z3Also ensure to set ``project.dynamic`` accordingly.� #/definitions/attr-directive� #/definitions/file-directivez-#/definitions/file-directive-for-dependencies�r ry r& rp z,#/definitions/file-directive/properties/file�rA r: �r r' r& �r r9 r( �r0 re r ru rz r~ r6 �r r r& r' �Valid package name�.Valid package name (importable or :pep:`561`).�pep561-stub-name�r� r� r r r9 �Extension module�>Parameters to construct a :class:`setuptools.Extension` object�sources� include-dirs� define-macros� macro name�r r � macro value�null�r r �additionalItems� undef-macros� library-dirs� libraries�runtime-library-dirs� extra-objects�extra-compile-args�extra-link-args�export-symbols� swig-opts�depends�language�optional�py-limited-api�r� r� r r r( r& r' �'file:' directive�BValue is read from a file (or list of files and then concatenated)rH �r� r� r r r& r' r( �"'file:' directive for dependenciesr �z3**BETA**: subset of the ``requirements.txt`` formatz!without ``pip`` flags and optionsz*(one :pep:`508`-compliant string per line,z7lines that are blank or start with ``#`` are excluded).zSee `dynamic metadatazZ<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.�r� rF �'attr:' directive�HValue is read from a module attribute. Supports callables and iterables;�(unsupported types are cast via ``str()``�attr�r� r� r r r& r' r( �'find:' directive�find�Dynamic `package discovery�J<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.�BDirectories to be searched for packages (Unix-style relative path)�<Exclude packages that match the values listed in this field.�6Can container shell-style wildcards (e.g. ``'pkg.*'``)�BRestrict the found packages to just the ones listed in this field.�CWhen ``True``, directories without a ``__init__.py`` file will also�3be scanned for :pep:`420`-style implicit namespaces��where�exclude�include� namespaces�r r r& r' �r� r� r r& r' �z package-namez ext-modulezfile-directivez file-directive-for-dependencieszattr-directivezfind-directive�r� r� r� r r r& r' r� )� distutils� setuptools)r r' z#Dependency groups following PEP 735r z+Python package specifiers following PEP 508z include-groupz/Another dependency group to include in this one)r r �pattern)r r& r' )� build-system�project�tool�dependency-groups)r� r� r� r r r& r' r@ ��valuer- � definition�ruler? z .build-system must be objectz .build-systemz.build-system must contain � propertiesz$.build-system.requires must be arrayz.build-system.requiresz7.build-system.requires[{data__buildsystem__requires_x}]� must be stringr$ z*.build-system.build-backend must be stringz.build-system.build-backendz<.build-system.build-backend must be pep517-backend-referencer% z(.build-system.backend-path must be arrayz.build-system.backend-pathz>.build-system.backend-path[{data__buildsystem__backendpath_x}]z .build-system must not contain r& r@ z.projectrA z.tool must be objectz.toolr< z.tool.distutilsr= z.tool.setuptoolsrB z!.dependency-groups must be objectz.dependency-groupsz/.dependency-groups.{data__dependencygroups_key}� must be arrayr � zO.dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]� must be pep508r z].dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-groupzI must match pattern ^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$r> � must not contain �( must be valid exactly by one definition� (� matches found)z$.dependency-groups must not contain r )� isinstance�dictr �set�keys�remove�str�sorted�list�tuple�len� enumerater! �locals�Mvalidate_https___packaging_python_org_en_latest_specifications_pyproject_toml�Rvalidate_https___setuptools_pypa_io_en_latest_deprecated_distutils_configfile_html�Mvalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_htmlr �REGEX_PATTERNS�search)'r r r � data_is_dict� data_keys�data__buildsystem�data__buildsystem_is_dict� data__buildsystem__missing_keys�data__buildsystem_keys�data__buildsystem__requires�#data__buildsystem__requires_is_list� data__buildsystem__requires_len� data__buildsystem__requires_x� data__buildsystem__requires_item� data__buildsystem__buildbackend� data__buildsystem__backendpath�&data__buildsystem__backendpath_is_list�"data__buildsystem__backendpath_len� data__buildsystem__backendpath_x�#data__buildsystem__backendpath_item� data__project� data__tool�data__tool_is_dict�data__tool_keys�data__tool__distutils�data__tool__setuptools�data__dependencygroups� data__dependencygroups_is_dict�data__dependencygroups_keys�data__dependencygroups_key�data__dependencygroups_val�"data__dependencygroups_val_is_list� data__dependencygroups_val_len� data__dependencygroups_val_x� data__dependencygroups_val_item�-data__dependencygroups_val_item_one_of_count1�'data__dependencygroups_val_item_is_dict�$data__dependencygroups_val_item_keys�-data__dependencygroups_val_item__includegroupr r r r ! s2 �� � � � � � � � � � � t � D b� < < F d�� �� � � � T ~ � h h z l n� ������ � � � � � � � � � � r c ! C s�: t | t��s�td|p d d | d|pd d dddg d�dd i d d d d id��dddgd d dd�d��dddgd d dd�d��dg d�dd��dg d �d d d id d ��d g d �d d d id��d!g d"�d#d d$d%d&d d d'd�d d(d�gd)�d*�d+d,dd d-dd.d/gd d0d d d id1�d d2d3gd d id4�d d5d3gd d id4�dd6d7gd8�d9�d:�id;�gd<��d=g d>�dd d?d@did$d%d&d d d'd�d d(d�gd)�gidAd d iidB��dCg dD�dd d?d dEd�d@dFigidAd d d id�idB��dGg dH�dd��dIg dJ�dd d?d dEd�d@dFigidAd d d id�idB��dKd d d'd�dLdMdN��dOdPd d d'd�dQdR��dSdTd dUdVdWddXdYgd i dXd d'd��dYd d d id��dZd d d id��d[d d d\d d]�d^d d id d_igd`�gd da�d��dbd d d id��dcd d d id��ddd d d id��ded d d id��dfd d d id��dgd d d id��dhd d d id��did d d id��djd d d id��dkd d d id��dld d i�dmd di�dnd di�do�d1��dpg dq�ddAd d d id�idr��dsg dt�ddAd dud�idr��dvd d d ig dw�dxdy��dzdd{d g d|�d}d~dd�gdd d�d dud�id�gd��d�d�d�dd d�d�d d id d d id�giid�gd��gd<�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�igd��dd dd�d d�d�d�g d��id�d�igd��id��dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d��d��i�d$d%d&d d d'd�d d(d�gd)�dUdVdWddXdYgd i dXd d'd��dYd d d id��dZd d d id��d[d d d\d d]�d^d d id d_igd`�gd da�d��dbd d d id��dcd d d id��ddd d d id��ded d d id��dfd d d id��dgd d d id��dhd d d id��did d d id��djd d d id��dkd d d id��dld d i�dmd di�dnd di�do�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�d�dd d�d�d d id d d id�giid�gd��gd��d}d~dd�gdd d�d dud�id�gd��d+d,dd d-dd.d/gd d0d d d id1�d d2d3gd d id4�d d5d3gd d id4�dd6d7gd8�d9�d:�id;�d��d��d d���t | t�}|� rHt| �� �}d |v �rk|�d � | d }t |ttf��s td|�p d d� |d|�pd d� d d d id�d d���t |ttf�}|�rkt|�}t |�D ]8\}} t | t ��sitd|�pBd d�j �di t � �� d� | d|�pUd d�j �di t � �� d d d id d����q2d|v �r(|�d� | d } t | ttf��s�td|�p�d d� | d|�p�d d� ddgd d dd�d�d d���t | ttf�} | �r(t| �} t | �D ]t\} }t |t ��s�td|�p�d d�j �di t � �� d� |d|�p�d d�j �di t � �� d d dd�d d���t |t ��r&|d |��s&td|�p�d d�j �di t � �� d� |d|�pd d�j �di t � �� d d dd�d�d����q�d|v �r�|�d� | d }t |ttf��s^td|�pDd d� |d|�pMd d� ddgd d dd�d�d d���t |ttf�}|�r�t|�}t |�D ]t\}}t |t ��s�td|�p�d d�j �di t � �� d� |d|�p�d d�j �di t � �� d d dd�d d���t |t ��r�|d |��s�td|�p�d d�j �di t � �� d� |d|�p�d d�j �di t � �� d d dd�d�d����qpd|v �r|�d� | d }t |t ��std|�p�d d� |d|�pd d� g d�dd�d d���d|v �r�|�d� | d }t |ttf��sKtd|�p1d d� |d|�p:d d� g d �d d d id d �d d���t |ttf�}|�r�t|�}t |�D ]8\}}t |t ��s�td|�pmd d�j �di t � �� d� |d|�p�d d�j �di t � �� d d d id d����q]d |v �r|�d � | d }t |ttf��s�td|�p�d d� |d|�p�d d� g d �d d d id�d d���t |ttf�}|�rt|�} t |�D ]8\} } t | t ��std|�p�d d�j �di t � �� d� | d|�p d d�j �di t � �� d d d id d����q�d!|v �r%|�d!� | d! } d�} | d�k �r�zbt | ttf��s]td|�p:d d� | d|�pCd d� d#d d$d%d&d d d'd�d d(d�gd)�d*�d d���t | ttf�}!|!�r�t| �}"t | �D ]\}#}$t|$||�pzdd�j �di t � �� � �qo| d�7 } W n t�y� Y nw | d�k �r�zt| ||�p�dd� � | d�7 } W n t�y� Y nw | d�k�r%td|�p�d d� d�t | � d� | d|�p�d d� g d"�d#d d$d%d&d d d'd�d d(d�gd)�d*�d+d,dd d-dd.d/gd d0d d d id1�d d2d3gd d id4�d d5d3gd d id4�dd6d7gd8�d9�d:�id;�gd<�d�d���d=|v � r�|�d=� | d= }%t |%t��sptd|�p?d d� |%d|�pHd d� g d>�dd d?d@did$d%d&d d d'd�d d(d�gd)�gidAd d iidB�d d���t |%t�}&|&� r�t|%�� �}'|%�� D ]J\}(})tdA �|(��r�|(|'v �r�|'�|(� t |)t ��s�td|�p�d d�j �di t � �� d� |)d|�p�d d�j �di t � �� d d d id d����q�|'� r td|�p�d d� t |'� d� |%d|�p�d d� g d>�dd d?d@did$d%d&d d d'd�d d(d�gd)�gidAd d iidB�d�d���t|%�}*|*d�k� r�d�}+|%D ]�}(z�d�},|,� sQz$|(dk� rAtd|� p.d d� |(d|� p7d d� d@did@d���|,d�7 },W n t� yP Y nw |,� spzt|(||� p\dd� � |,d�7 },W n t� yo Y nw |,� s�td|� pyd d� |(d|� p�d d� d?d@did$d%d&d d d'd�d d(d�gd)�gid?d���W � q t� y� d }+Y � qw |+� s�td|� p�d d� |%d|� p�d d� g d>�dd d?d@did$d%d&d d d'd�d d(d�gd)�gidAd d iidB�d�d���dC|v � r|�dC� | dC }-t |-t�� s+td|� pd d� |-d|� p d d� g dD�dd d?d dEd�d@dFigidAd d d id�idB�d d���t |-t�}.|.� rt|-�� �}/|-�� D ]�\}0}1tdA �|0�� r�|0|/v � rS|/�|0� t |1ttf�� s�td|� pad d�j �di t � �� d� |1d|� ptd d�j �di t � �� d d d d id�d d���t |1ttf�}2|2� r�t|1�}3t |1�D ]8\}4}5t |5t �� s�td|� p�d d�j �di t � �� d� |5d|� p�d d�j �di t � �� d d d id d���� q�� q=|/� rtd|� p�d d� t |/� d� |-d|� p�d d� g dD�dd d?d dEd�d@dFigidAd d d id�idB�d�d���t|-�}6|6d�k� rd�}7|-D ]�}0z�d�}8|8� s}zMt |0t �� sFtd|� p2d d� |0d|� p;d d� d dEd�d d���t |0t �� rm|dE |0�� smtd|� pYd d� |0d|� pbd d� d dEd�d�d���|8d�7 }8W n t� y| Y nw |8� s�z$|0dFk� r�td|� p�d d� |0d|� p�d d� d@dFid@d���|8d�7 }8W n t� y� Y nw |8� s�td|� p�d d� |0d|� p�d d� d?d dEd�d@dFigid?d���W � q t� y� d }7Y � q w |7� std|� p�d d� |-d|� p�d d� g dD�dd d?d dEd�d@dFigidAd d d id�idB�d�d���dG|v � rD|�dG� | dG }9t |9t �� sDtd|� p.d d� |9d|� p7d d� g dH�dd�d d���dI|v �rp|�dI� | dI }:t |:t�� s�td|� p^d d� |:d|� pgd d� g dJ�dd d?d dEd�d@dFigidAd d d id�idB�d d���t |:t�};|;�rpt|:�� �}<|:�� D ]�\}=}>tdA �|=�� r2|=|<v � r�|<�|=� t |>ttf�� s�td|� p�d d�j �di t � �� d� |>d|� p�d d�j �di t � �� d d d d id�d d���t |>ttf�}?|?� r2t|>�}@t |>�D ]8\}A}Bt |Bt �� s0td|� p d d�j �di t � �� d� |Bd|� p d d�j �di t � �� d d d id d���� q�� q�|<� rltd|� p=d d� t |<� d� |:d|� pLd d� g dJ�dd d?d dEd�d@dFigidAd d d id�idB�d�d���t|:�}C|Cd�k�rpd�}D|:D ]�}=z�d�}E|E� s�zMt |=t �� s�td|� p�d d� |=d|� p�d d� d dEd�d d���t |=t �� r�|dE |=�� s�td|� p�d d� |=d|� p�d d� d dEd�d�d���|Ed�7 }EW n t� y� Y nw |E�s z$|=dFk� r�td|� p�d d� |=d|� p�d d� d@dFid@d���|Ed�7 }EW n t�y Y nw |E�s.td|�pd d� |=d|�p d d� d?d dEd�d@dFigid?d���W � qy t�y= d }DY � qyw |D�sptd|�pGd d� |:d|�pPd d� g dJ�dd d?d dEd�d@dFigidAd d d id�idB�d�d���dK|v �r,|�dK� | dK }Ft |Fttf��s�td|�p�d d� |Fd|�p�d d� d d d'd�dLdMdN�d d���t |Fttf�}G|G�r,t|F�}Ht |F�D ]t\}I}Jt |Jt ��s�td|�p�d d�j �di t � �� d� |Jd|�p�d d�j �di t � �� d d d'd�d d���t |Jt ��r*|d' |J��s*td|�pd d�j �di t � �� d� |Jd|�pd d�j �di t � �� d d d'd�d�d����q�dO|v �r�|�dO� | dO }Kt |Kttf��satd|�pHd d� |Kd|�pQd d� dPd d d'd�dQdR�d d���t |Kttf�}L|L�r�t|K�}Mt |K�D ]t\}N}Ot |Ot ��s�td|�p�d d�j �di t � �� d� |Od|�p�d d�j �di t � �� d d d'd�d d���t |Ot ��r�|d' |O��s�td|�p�d d�j �di t � �� d� |Od|�p�d d�j �di t � �� d d d'd�d�d����qsdS|v �r�|�dS� | dS }Pt |Pttf��s�td|�pd d� |Pd|�p d d� dTd dUdVdWddXdYgd i dXd d'd��dYd d d id��dZd d d id��d[d d d\d d]�d^d d id d_igd`�gd da�d��dbd d d id��dcd d d id��ddd d d id��ded d d id��dfd d d id��dgd d d id��dhd d d id��did d d id��djd d d id��dkd d d id��dld d i�dmd di�dnd di�do�d1�d d���t |Pttf�}Q|Q�r�t|P�}Rt |P�D ]\}S}Tt|T||�p�dd�j �di t � �� � �q�dp|v �r�|�dp� | dp }Ut |Ut��std|�p�d d� |Ud|�p�d d� g dq�ddAd d d id�idr�d d���t |Ut�}V|V�r�t|U�� �}W|U�� D ]�\}X}YtdA �|X��r�|X|Wv �r;|W�|X� t |Yttf��sstd|�pId d�j �di t � �� d� |Yd|�p\d d�j �di t � �� d d d d id�d d���t |Yttf�}Z|Z�r�t|Y�}[t |Y�D ]8\}\}]t |]t ��s�td|�p�d d�j �di t � �� d� |]d|�p�d d�j �di t � �� d d d id d����q��q%ds|v �r�|�ds� | ds }^t |^t��s�td|�p�d d� |^d|�p�d d� g dt�ddAd dud�idr�d d���t |^t�}_|_�r�t|^�� �}`|^�� D ]�\}a}btdA �|a��r�|a|`v �r |`�|a� t |bt ��sRtd|�p*d d�j �di t � �� d� |bd|�p=d d�j �di t � �� d d dud�d d���t |bt ��r�|du |b��s�td|�ped d�j �di t � �� d� |bd|�pxd d�j �di t � �� d d dud�d�d����qdv|v �r|�dv� | dv }ct |cttf��s�td|�p�d d� |cd|�p�d d� d d d ig dw�dxdy�d d���t |cttf�}d|d�rt|c�}et |c�D ]8\}f}gt |gt ��std|�p�d d�j �di t � �� d� |gd|�p�d d�j �di t � �� d d d id d����q�dz|v �rb|�dz� | dz }ht |ht��std|�p*d d� |hd|�p3d d� dd{d g d|�d}d~dd�gdd d�d dud�id�gd��d�d�d�dd d�d�d d id d d id�giid�gd��gd<�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�igd��dd dd�d d�d�d�g d��id�d�igd��id��dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d��d��d d���t |ht�}i|i�rbt|h�� �}jd�|jv �r�|j�d� |hd� }kd�}l|ld�k �rGzt|k||�p3dd� � |ld�7 }lW n t�yF Y nw |ld�k �rhzt|k||�pTdd� � |ld�7 }lW n t�yg Y nw |ld�k�r�td|�psd d� d�t |l� d� |kd|�p�d d� g d|�d}d~dd�gdd d�d dud�id�gd��d�d�d�dd d�d�d d id d d id�giid�gd��gd<�d�d���d�|jv �r�|j�d� |hd� }mt|m||�p�dd� � d�|jv �r�|j�d� |hd� }nt|n||�p�dd� � d�|jv �r|j�d�� |hd� }ot|o||�p dd� � d�|jv �r |j�d�� |hd� }pt|p||�pdd� � d�|jv �rf|j�d�� |hd� }qt |qt��s]td|�p7d d� |qd|�p@d d� dd dd�d d�d�d�g d��id�d�igd��id��d d���t |qt�}r|r�rft|q�� �}s|q�� D ]*\}t}utd� �|t��r�|t|sv �r�|s�|t� t|u||�p�dd�j �di t � �� � �qo|s�r�td|�p�d d� t |s� d� |qd|�p�d d� dd dd�d d�d�d�g d��id�d�igd��id��d�d���t|q�}v|vd�k�rfd�}w|qD ]Y}tzJt |tt ��s�td|�p�d d� |td|�p�d d� d dd�d d���t |tt ��r&|d |t��s&td|�pd d� |td|�pd d� d dd�d�d���W �q� t�y5 d }wY �q�w |w�sftd|�p?d �d |qd|�pId d� dd dd�d d�d�d�g d��id�d�igd��id��d�d����d|jv �rt|j��d� |h�d }xt |xt��s�td|�p�d �d |xd|�p�d �d dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d d���d�}y|y�s�zt|x||�p�d�d � |yd�7 }yW n t�y� Y nw |y�s�z�t |xt��s td|�p�d �d |xd|�pd �d dd d id�d d id d d id�gid��d d��d d���t |xt�}z|z�r�t|x�� �}{�d|{v �r`|{��d� |x�d }|t ||t ��s`td|�pKd �d ||d|�pUd �d d d id d���d�|{v �rz|{�d�� |xd� }}t|}||�pud�d � |{�r�td|�p�d �d t |{� d� |xd|�p�d �d dd d id�d d id d d id�gid��d d��d�d���|yd�7 }yW n t�y� Y nw |y�s td|�p�d �d |xd|�p�d �d dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d?d���t |xt�}z|z�rttd�g�|x�� }~|~�rttd|�p'd �d t t|~��d� |xd|�p9d �d dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd���d d���|j�rbtd|�p}d �d t |j� d� |hd|�p�d d� dd{d g d|�d}d~dd�gdd d�d dud�id�gd��d�d�d�dd d�d�d d id d d id�giid�gd��gd<�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�igd��dd dd�d d�d�d�g d��id�d�igd��id��dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d��d��d�d���|� rHtd|�pkd �d t |� d� | d|�p{d d dddg d�dd i d d d d id��dddgd d dd�d��dddgd d dd�d��dg d�dd��dg d �d d d id d ��d g d �d d d id��d!g d"�d#d d$d%d&d d d'd�d d(d�gd)�d*�d+d,dd d-dd.d/gd d0d d d id1�d d2d3gd d id4�d d5d3gd d id4�dd6d7gd8�d9�d:�id;�gd<��d=g d>�dd d?d@did$d%d&d d d'd�d d(d�gd)�gidAd d iidB��dCg dD�dd d?d dEd�d@dFigidAd d d id�idB��dGg dH�dd��dIg dJ�dd d?d dEd�d@dFigidAd d d id�idB��dKd d d'd�dLdMdN��dOdPd d d'd�dQdR��dSdTd dUdVdWddXdYgd i dXd d'd��dYd d d id��dZd d d id��d[d d d\d d]�d^d d id d_igd`�gd da�d��dbd d d id��dcd d d id��ddd d d id��ded d d id��dfd d d id��dgd d d id��dhd d d id��did d d id��djd d d id��dkd d d id��dld d i�dmd di�dnd di�do�d1��dpg dq�ddAd d d id�idr��dsg dt�ddAd dud�idr��dvd d d ig dw�dxdy��dzdd{d g d|�d}d~dd�gdd d�d dud�id�gd��d�d�d�dd d�d�d d id d d id�giid�gd��gd<�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�igd��dd dd�d d�d�d�g d��id�d�igd��id��dd�d�d�dd d�d�d d id d d id�giid�gd��dd d id�d d id d d id�gid��d d��gd�gd��d��d��i�d$d%d&d d d'd�d d(d�gd)�dUdVdWddXdYgd i dXd d'd��dYd d d id��dZd d d id��d[d d d\d d]�d^d d id d_igd`�gd da�d��dbd d d id��dcd d d id��ddd d d id��ded d d id��dfd d d id��dgd d d id��dhd d d id��did d d id��djd d d id��dkd d d id��dld d i�dmd di�dnd di�do�d�d�d�dd d�d�d d id d d id�giid�gd��d�d�g d��id�d�d�dd d�d�d d id d d id�giid�gd��gd��d}d~dd�gdd d�d dud�id�gd��d+d,dd d-dd.d/gd d0d d d id1�d d2d3gd d id4�d d5d3gd d id4�dd6d7gd8�d9�d:�id;�d��d��d�d���| S ( Nr r r r r� r� r� r Fr� r r r r� r� r� r� r/ rn r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r� r r r� r� r) r* r+ r, r- rY r. r/ r r0 r1 r2 r5 r3 r8 r9 rG r� r� r9 r� r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r- r r r r r r r rV r r r r r r r r r r r r r r r r� r� r� r� r� r� rW r� r� r� r� r� r� r$ r� r% r& r' r( r� r r r: rH r r! r r" r[ r# r r� r� r� r� r� r r: r; rC z.platforms must be arrayz .platformsz .platforms[{data__platforms_x}]rH z.provides must be arrayz .providesz .provides[{data__provides_x}]z must be pep508-identifierr! z.obsoletes must be arrayz .obsoletesz .obsoletes[{data__obsoletes_x}]z.zip-safe must be booleanz .zip-safez.script-files must be arrayz .script-filesz$.script-files[{data__scriptfiles_x}]z .eager-resources must be arrayz.eager-resourcesz*.eager-resources[{data__eagerresources_x}]r rJ z.packages must be arrayz .packagesz .packages[{data__packages_x}]r z1.packages must be valid exactly by one definitionrN rO z.package-dir must be objectz .package-dirz#.package-dir.{data__packagedir_key}z .package-dir must not contain rG r& Tz/.package-dir must be same as const definition: z2.package-dir cannot be validated by any definitionz5.package-dir must be named by propertyName definitionry z .package-data must be objectz .package-dataz%.package-data.{data__packagedata_key}rI z@.package-data.{data__packagedata_key}[{data__packagedata_val_x}]z .package-data must not contain z .package-data must be stringz(.package-data must be python-module-namez1.package-data must be same as const definition: *z3.package-data cannot be validated by any definitionz6.package-data must be named by propertyName definitionz%.include-package-data must be booleanz.include-package-dataz$.exclude-package-data must be objectz.exclude-package-dataz4.exclude-package-data.{data__excludepackagedata_key}zV.exclude-package-data.{data__excludepackagedata_key}[{data__excludepackagedata_val_x}]z'.exclude-package-data must not contain z$.exclude-package-data must be stringz0.exclude-package-data must be python-module-namez9.exclude-package-data must be same as const definition: *z;.exclude-package-data cannot be validated by any definitionz>.exclude-package-data must be named by propertyName definitionz!.namespace-packages must be arrayz.namespace-packagesz0.namespace-packages[{data__namespacepackages_x}]�# must be python-module-name-relaxedz.py-modules must be arrayz .py-modulesz .py-modules[{data__pymodules_x}]z.ext-modules must be arrayz .ext-modulesz".ext-modules[{data__extmodules_x}]z.data-files must be objectz .data-filesz!.data-files.{data__datafiles_key}z:.data-files.{data__datafiles_key}[{data__datafiles_val_x}]z.cmdclass must be objectz .cmdclassz .cmdclass.{data__cmdclass_key}z$ must be python-qualified-identifier� .license-files must be array�.license-files�&.license-files[{data__licensefiles_x}]z.dynamic must be object�.dynamicr0 z.dynamic.versionz8.dynamic.version must be valid exactly by one definitionre z.dynamic.classifiersr z.dynamic.descriptionru z.dynamic.entry-pointsrz z.dynamic.dependenciesr~ z-.dynamic.optional-dependencies must be objectz .dynamic.optional-dependencieszH.dynamic.optional-dependencies.{data__dynamic__optionaldependencies_key}z0.dynamic.optional-dependencies must not contain z-.dynamic.optional-dependencies must be stringz8.dynamic.optional-dependencies must be pep508-identifierzG.dynamic.optional-dependencies must be named by propertyName definitionr6 z .dynamic.readme must be objectz.dynamic.readmerA z+.dynamic.readme.content-type must be stringz .dynamic.readme.content-typez.dynamic.readme.filez!.dynamic.readme must not contain z5.dynamic.readme cannot be validated by any definitionz .dynamic.readme must contain r( z.dynamic must not contain rL r )rP rQ r rR rS rT rW rX rY rZ rU r! r[ �bool�gvalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name�ivalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_find_directiver r_ r` �evalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_ext_module�ivalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_attr_directive�ivalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive�zvalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies�yvalidate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_properties_filerV )r r r ra rb �data__platforms�data__platforms_is_list�data__platforms_len�data__platforms_x�data__platforms_item�data__provides�data__provides_is_list�data__provides_len�data__provides_x�data__provides_item�data__obsoletes�data__obsoletes_is_list�data__obsoletes_len�data__obsoletes_x�data__obsoletes_item� data__zipsafe�data__scriptfiles�data__scriptfiles_is_list�data__scriptfiles_len�data__scriptfiles_x�data__scriptfiles_item�data__eagerresources� data__eagerresources_is_list�data__eagerresources_len�data__eagerresources_x�data__eagerresources_item�data__packages� data__packages_one_of_count2�data__packages_is_list�data__packages_len�data__packages_x�data__packages_item�data__packagedir�data__packagedir_is_dict�data__packagedir_keys�data__packagedir_key�data__packagedir_val�data__packagedir_len� data__packagedir_property_names�"data__packagedir_key_any_of_count3�data__packagedata�data__packagedata_is_dict�data__packagedata_keys�data__packagedata_key�data__packagedata_val� data__packagedata_val_is_list�data__packagedata_val_len�data__packagedata_val_x�data__packagedata_val_item�data__packagedata_len� data__packagedata_property_names�#data__packagedata_key_any_of_count4�data__includepackagedata�data__excludepackagedata� data__excludepackagedata_is_dict� data__excludepackagedata_keys� data__excludepackagedata_key� data__excludepackagedata_val�$data__excludepackagedata_val_is_list� data__excludepackagedata_val_len� data__excludepackagedata_val_x�!data__excludepackagedata_val_item� data__excludepackagedata_len�'data__excludepackagedata_property_names�*data__excludepackagedata_key_any_of_count5�data__namespacepackages� data__namespacepackages_is_list�data__namespacepackages_len�data__namespacepackages_x� data__namespacepackages_item�data__pymodules�data__pymodules_is_list�data__pymodules_len�data__pymodules_x�data__pymodules_item�data__extmodules�data__extmodules_is_list�data__extmodules_len�data__extmodules_x�data__extmodules_item�data__datafiles�data__datafiles_is_dict�data__datafiles_keys�data__datafiles_key�data__datafiles_val�data__datafiles_val_is_list�data__datafiles_val_len�data__datafiles_val_x�data__datafiles_val_item�data__cmdclass�data__cmdclass_is_dict�data__cmdclass_keys�data__cmdclass_key�data__cmdclass_val�data__licensefiles�data__licensefiles_is_list�data__licensefiles_len�data__licensefiles_x�data__licensefiles_item� data__dynamic�data__dynamic_is_dict�data__dynamic_keys�data__dynamic__version�$data__dynamic__version_one_of_count6�data__dynamic__classifiers�data__dynamic__description�data__dynamic__entrypoints�data__dynamic__dependencies�#data__dynamic__optionaldependencies�+data__dynamic__optionaldependencies_is_dict�(data__dynamic__optionaldependencies_keys�'data__dynamic__optionaldependencies_key�'data__dynamic__optionaldependencies_val�'data__dynamic__optionaldependencies_len�2data__dynamic__optionaldependencies_property_names�data__dynamic__readme�#data__dynamic__readme_any_of_count7� data__dynamic__readme_is_dict�data__dynamic__readme_keys�"data__dynamic__readme__contenttype�data__dynamic__readme__file�#data__dynamic__readme__missing_keysr r r r^ � s� �� � � � � � � 8 Z� @ \ \� @ \ \� 8 @ Z� > Z� R* � n Z�z 2 V� �n ^ ` Z��j 4 4 2 @� �^ 8 ^ ` Z��j 4 4 2 @� �^ > \ \� > \ \� �f * H ` Z�� D \ \� @ Z� �� � X &�d 4 4� �Z � Z 6 f � ��� �� � � � � � � r^ c C s� d}|dk r2z"t | t�s#td|pd d | d|pd d ddidd��|d 7 }W n ty1 Y nw |dk r�zkt | ttf�sXtd|pCd d | d|pKd d d ddid �dd��t | ttf�}|r�t| �}t| �D ]2\}}t |t�s�td|pwd d jdi t� �� d |d|p�d d jdi t� �� d ddidd��qi|d 7 }W n ty� Y nw |d kr�td|p�d d dt|� d | d|p�d d dddid ddid �gidd��| S )Nr rJ r r rH r r rC r rI r r� z [{data_x}]rM rN rO rH r ) rP rU r rW rX rY rZ r! r[ )r r r �data_one_of_count8� data_is_list�data_len�data_x� data_itemr r r r� P s. . 4 R� Pr� c C r r )r� r r r r r� h r r� c C sD t | t�s0td|p d d | d|pd d dddddd d d d id d d id�giid gd�d d��t | t�}|�r�td g�| �� }|rvtd|pHd d tt|��d | d|pXd d dddddd d d d id d d id�giid gd�dd��t| �� �}d |v �rj|�d � | d }d}|dk r�z"t |t�s�td|p�d d |d|p�d d d d id d��|d7 }W n ty� Y nw |dk �r;zot |tt f�s�td|p�d d |d|p�d d d d d id�d d��t |tt f�}|�r+t |�} t |�D ]5\} } t | t��s*td|�pd dj d!i t � �� d | d|�pd dj d!i t � �� d d d id d��q�|d7 }W n t�y: Y nw |dk�rjtd|�pFd d d t|� d |d|�pWd d d d d id d d id�gid d��|�r�td|�psd d t|� d | d|�p�d d dddddd d d d id d d id�giid gd�d d��| S )"Nr r r r� r r r Fr: rH r r r r� r rC � must contain rG r( r rJ z.file must be stringz.filer z.file must be arrayz.file[{data__file_x}]rH z-.file must be valid exactly by one definitionrN rO rL r& r )rP rQ r rR rS rU rV rT rW rX rY rZ r! r[ ) r r r ra �data__missing_keysrb � data__file�data__file_one_of_count9�data__file_is_list�data__file_len� data__file_x�data__file_itemr r r r� l sH V f . 4 V� Tfr� c C s� t | t�s*td|p d d | d|pd d ddddgdd d d d d �id gd�dd��t | t�}|r�td g�| �� }|ritd|pAd d tt|��d | d|pQd d ddddgdd d d d d �id gd�dd��t| �� �}d |v r�|�d � | d }t |t�s�td|p�d d |d|p�d d d d d �dd��t |t�r�|d |�s�td|p�d d |d|p�d d d d d �dd��|r�td|p�d d t|� d | d|p�d d ddddgdd d d d d �id gd�dd��| S )Nr r r r$ r� r% r& r Fr' r r� rn r( r rC r rG r( z.attr must be stringz.attrz).attr must be python-qualified-identifierr! rL r& )rP rQ r rR rS rU rV rT )r r r ra r rb � data__attrr r r r� � s& J Z 0 0Vr� c P C s� t | t�s�td|p d d | d|pd d dddddd gd i dd d d ��d ddd id��dddd id��ddddd d�ddd iddigd�gd d�d��dddd id��dddd id��dddd id��d ddd id��d ddd id��d ddd id��d ddd id��d ddd id��d!ddd id��d"ddd id��d#dd i�d$dd%i�d&dd%i�d'�dd(��t | t�}|� r�tdd g�| �� }|�rztd|p�d d) tt|��d* | d|p�d d dddddd gd i dd d d ��d ddd id��dddd id��ddddd d�ddd iddigd�gd d�d��dddd id��dddd id��dddd id��d ddd id��d ddd id��d ddd id��d ddd id��d ddd id��d!ddd id��d"ddd id��d#dd i�d$dd%i�d&dd%i�d'�d+d(��t| �� �}d|v �r�|�d� | d }t |t��s�td|�p�d d, |d|�p�d d- d d d �dd(��t |t��r�|d |��s�td|�p�d d. |d|�p�d d- d d d �d/d(��d |v �rP|�d � | d }t |tt f��std|�p�d d0 |d|�p�d d1 ddd id�dd(��t |tt f�}|�rPt |�} t |�D ]6\} } t | t��sNtd|�p)d d2j dmi t � �� d3 | d|�p;d d2j dmi t � �� d dd idd(���qd|v �r�|�d� | d } t | tt f��s�td|�pld d4 | d|�pud d5 ddd id�dd(��t | tt f�} | �r�t | �}t | �D ]6\}}t |t��s�td|�p�d d6j dmi t � �� d3 |d|�p�d d6j dmi t � �� d dd idd(���q�d|v �r�|�d� | d }t |tt f��s td|�p�d d7 |d|�p�d d8 dddd d�ddd iddigd�gd d�d�dd(��t |tt f�}|�r�t |�}t |�D �]�\}}t |tt f��sgtd|�p2d d9j dmi t � �� d: |d|�pDd d9j dmi t � �� d ddd d�ddd iddigd�gd d�dd(��t |tt f�}|�r�t |�}|d;k�r�|d; }t |t��s�td|�p�d d<j dmi t � �� d3 |d|�p�d d<j dmi t � �� d dd d�dd(��|d=k�r�|d= }d;}|d>k �rz7t |t��s�td|�p�d d?j dmi t � �� d3 |d|�p�d d?j dmi t � �� d dd idd(��|d=7 }W n t�y Y nw |d>k �rIz7t |t��s9td|�pd d?j dmi t � �� d@ |d|�p&d d?j dmi t � �� d ddidd(��|d=7 }W n t�yH Y nw |d=k�r�td|�pTd d?j dmi t � �� dA dBt|� dC |d|�pnd d?j dmi t � �� d ddd iddigd�dDd(��|d>k�r�td|�p�d d9j dmi t � �� dE |d|�p�d d9j dmi t � �� d ddd d�ddd iddigd�gd d�dFd(���q d|v �rE|�d� | d }t |tt f��s�td|�p�d dG |d|�p�d dH ddd id�dd(��t |tt f�} | �rEt |�} t |�D ]6\} } t | t��sCtd|�p d dIj dmi t � �� d3 | d|�p0d dIj dmi t � �� d dd idd(���qd|v �r�|�d� | d } t | tt f��swtd|�pad dJ | d|�pjd dK ddd id�dd(��t | tt f�}!|!�r�t | �}"t | �D ]6\}#}$t |$t��s�td|�p�d dLj dmi t � �� d3 |$d|�p�d dLj dmi t � �� d dd idd(���q�d|v �r;|�d� | d }%t |%tt f��s�td|�p�d dM |%d|�p�d dN ddd id�dd(��t |%tt f�}&|&�r;t |%�}'t |%�D ]6\}(})t |)t��s9td|�pd dOj dmi t � �� d3 |)d|�p&d dOj dmi t � �� d dd idd(���qd |v �r�|�d � | d }*t |*tt f��smtd|�pWd dP |*d|�p`d dQ ddd id�dd(��t |*tt f�}+|+�r�t |*�},t |*�D ]6\}-}.t |.t��s�td|�p�d dRj dmi t � �� d3 |.d|�p�d dRj dmi t � �� d dd idd(���qd |v �r1|�d � | d }/t |/tt f��s�td|�p�d dS |/d|�p�d dT ddd id�dd(��t |/tt f�}0|0�r1t |/�}1t |/�D ]6\}2}3t |3t��s/td|�p d dUj dmi t � �� d3 |3d|�p d dUj dmi t � �� d dd idd(���q�d |v �r�|�d � | d }4t |4tt f��sctd|�pMd dV |4d|�pVd dW ddd id�dd(��t |4tt f�}5|5�r�t |4�}6t |4�D ]6\}7}8t |8t��s�td|�p�d dXj dmi t � �� d3 |8d|�p�d dXj dmi t � �� d dd idd(���qud |v �r'|�d � | d }9t |9tt f��s�td|�p�d dY |9d|�p�d dZ ddd id�dd(��t |9tt f�}:|:�r't |9�};t |9�D ]6\}<}=t |=t��s%td|�p d d[j dmi t � �� d3 |=d|�pd d[j dmi t � �� d dd idd(���q�d |v �r�|�d � | d }>t |>tt f��sYtd|�pCd d\ |>d|�pLd d] ddd id�dd(��t |>tt f�}?|?�r�t |>�}@t |>�D ]6\}A}Bt |Bt��s�td|�p{d d^j dmi t � �� d3 |Bd|�p�d d^j dmi t � �� d dd idd(���qkd!|v � r |�d!� | d! }Ct |Ctt f��s�td|�p�d d_ |Cd|�p�d d` ddd id�dd(��t |Ctt f�}D|D� r t |C�}Et |C�D ]6\}F}Gt |Gt�� std|�p�d daj dmi t � �� d3 |Gd|� pd daj dmi t � �� d dd idd(���q�d"|v � r�|�d"� | d" }Ht |Htt f�� sOtd|� p9d db |Hd|� pBd dc ddd id�dd(��t |Htt f�}I|I� r�t |H�}Jt |H�D ]6\}K}Lt |Lt�� s�td|� pqd ddj dmi t � �� d3 |Ld|� p�d ddj dmi t � �� d dd idd(��� qad#|v � r�|�d#� | d# }Mt |Mt�� s�td|� p�d de |Md|� p�d df dd idd(��d$|v � r�|�d$� | d$ }Nt |Nt�� s�td|� p�d dg |Nd|� p�d dh dd%idd(��d&|v � r |�d&� | d& }Ot |Ot�� s td|� p d di |Od|� pd dj dd%idd(��|� r�td|� p(d dk t|� d* | d|� p7d d dddddd gd i dd d d ��d ddd id��dddd id��ddddd d�ddd iddigd�gd d�d��dddd id��dddd id��dddd id��d ddd id��d ddd id��d ddd id��d ddd id��d ddd id��d!ddd id��d"ddd id��d#dd i�d$dd%i�d&dd%i�d'�dld(��| S )nNr r r r� r r r r- r Fr r� rn r r r� r r r r r r rV r r r r r r r r r r r r r r� r r rC r rG r( �.name must be string�.namez(.name must be python-module-name-relaxedr! z.sources must be arrayz.sourcesz.sources[{data__sources_x}]rH z.include-dirs must be arrayz .include-dirsz$.include-dirs[{data__includedirs_x}]z .define-macros must be arrayz.define-macrosz&.define-macros[{data__definemacros_x}]rI r z).define-macros[{data__definemacros_x}][0]r rJ z).define-macros[{data__definemacros_x}][1]z must be nullrM rN rO rH z" must contain only specified itemsr z.undef-macros must be arrayz .undef-macrosz$.undef-macros[{data__undefmacros_x}]z.library-dirs must be arrayz .library-dirsz$.library-dirs[{data__librarydirs_x}]z.libraries must be arrayz .librariesz .libraries[{data__libraries_x}]z#.runtime-library-dirs must be arrayz.runtime-library-dirsz3.runtime-library-dirs[{data__runtimelibrarydirs_x}]z .extra-objects must be arrayz.extra-objectsz&.extra-objects[{data__extraobjects_x}]z!.extra-compile-args must be arrayz.extra-compile-argsz/.extra-compile-args[{data__extracompileargs_x}]z .extra-link-args must be arrayz.extra-link-argsz).extra-link-args[{data__extralinkargs_x}]z .export-symbols must be arrayz.export-symbolsz(.export-symbols[{data__exportsymbols_x}]z.swig-opts must be arrayz .swig-optsz .swig-opts[{data__swigopts_x}]z.depends must be arrayz.dependsz.depends[{data__depends_x}]z.language must be stringz .languagez.optional must be booleanz .optionalz .py-limited-api must be booleanz.py-limited-apirL r& r )rP rQ r rR rS rU rV rT rW rX rY rZ r! r[ �NoneTyper� )Pr r r ra r rb � data__name� data__sources�data__sources_is_list�data__sources_len�data__sources_x�data__sources_item�data__includedirs�data__includedirs_is_list�data__includedirs_len�data__includedirs_x�data__includedirs_item�data__definemacros�data__definemacros_is_list�data__definemacros_len�data__definemacros_x�data__definemacros_item� data__definemacros_item_is_list�data__definemacros_item_len�data__definemacros_item__0�data__definemacros_item__1�)data__definemacros_item__1_one_of_count10�data__undefmacros�data__undefmacros_is_list�data__undefmacros_len�data__undefmacros_x�data__undefmacros_item�data__librarydirs�data__librarydirs_is_list�data__librarydirs_len�data__librarydirs_x�data__librarydirs_item�data__libraries�data__libraries_is_list�data__libraries_len�data__libraries_x�data__libraries_item�data__runtimelibrarydirs� data__runtimelibrarydirs_is_list� data__runtimelibrarydirs_len�data__runtimelibrarydirs_x� data__runtimelibrarydirs_item�data__extraobjects�data__extraobjects_is_list�data__extraobjects_len�data__extraobjects_x�data__extraobjects_item�data__extracompileargs� data__extracompileargs_is_list�data__extracompileargs_len�data__extracompileargs_x�data__extracompileargs_item�data__extralinkargs�data__extralinkargs_is_list�data__extralinkargs_len�data__extralinkargs_x�data__extralinkargs_item�data__exportsymbols�data__exportsymbols_is_list�data__exportsymbols_len�data__exportsymbols_x�data__exportsymbols_item�data__swigopts�data__swigopts_is_list�data__swigopts_len�data__swigopts_x�data__swigopts_item� data__depends�data__depends_is_list�data__depends_len�data__depends_x�data__depends_item�data__language�data__optional�data__pylimitedapir r r r� � s� �Z �j 4 4 8 V� 8 V� Xv X V V t v� 8 V� 8 V� 8 V� 8 V� 8 V� 8 V� 8 V� 8 V� 8 V� 8 V� 2 2 2�j r� c C s� t | t�sItd|p d d | d|pd d ddddddd d gdd d d did�d ddgd did�d ddgd did�dddgd�d�d�id�d d��t | t�}|�r�t| �� �}d|v �r�|�d� | d }t |t�s�td|pod d |d|pwd d dd d gdd d d did�d ddgd did�d ddgd did�dddgd�d�d�d d��t |t�}|�r�t|�� �}d |v �r,|�d � |d }t |ttf�s�td|p�d d |d|p�d d d d d did�d d��t |ttf�} | �r,t|�} t |�D ]5\} } t | t ��s+td|�pd d!j d2i t � �� d" | d|�pd d!j d2i t � �� d d did d��q�d#|v �r�|�d#� |d# } t | ttf��satd|�pHd d$ | d|�pQd d% d ddgd did�d d��t | ttf�}|�r�t| �}t | �D ]6\}}t |t ��s�td|�p�d d&j d2i t � �� d" |d|�p�d d&j d2i t � �� d d did d���qsd'|v �r(|�d'� |d' }t |ttf��s�td|�p�d d( |d|�p�d d) d ddgd did�d d��t |ttf�}|�r(t|�}t |�D ]6\}}t |t ��s&td|�pd d*j d2i t � �� d" |d|�pd d*j d2i t � �� d d did d���q�d+|v �rX|�d+� |d+ }t |t ��sXtd|�pBd d, |d|�pKd d- dddgd�d d��|�r�td|�pad d. t |� d/ |d|�ppd d dd d gdd d d did�d ddgd did�d ddgd did�dddgd�d�d�d0d��|�r�td|�p�d d1 t |� d/ | d|�p�d d ddddddd d gdd d d did�d ddgd did�d ddgd did�dddgd�d�d�id�d0d��| S )3Nr r r r� r) r Fr* r+ r, r- r r r rY r. r/ r r0 r� r1 r2 r5 r3 r8 r9 rC z.find must be objectz.findr4 z.find.where must be arrayz .find.wherez".find.where[{data__find__where_x}]rH r5 z.find.exclude must be arrayz .find.excludez&.find.exclude[{data__find__exclude_x}]r6 z.find.include must be arrayz .find.includez&.find.include[{data__find__include_x}]r7 z .find.namespaces must be booleanz.find.namespacesz.find must not contain rG r& rL r )rP rQ r rR rS rT rW rX rY rZ rU r! r[ r� )r r r ra rb � data__find�data__find_is_dict�data__find_keys�data__find__where�data__find__where_is_list�data__find__where_len�data__find__where_x�data__find__where_item�data__find__exclude�data__find__exclude_is_list�data__find__exclude_len�data__find__exclude_x�data__find__exclude_item�data__find__include�data__find__include_is_list�data__find__include_len�data__find__include_x�data__find__include_item�data__find__namespacesr r r r� s sv � x 6 V� > V� > V� 8��r� c C s� t | t�s(td|p d d | d|pd d ddddddd �dd d �gd �d d ��d}|s|zFt | t�sJtd|p7d d | d|p?d d ddd �d d ��t | t�rm|d | �smtd|pZd d | d|pbd d ddd �dd ��|d7 }W n ty{ Y nw |s�zFt | t�s�td|p�d d | d|p�d d dd d �d d ��t | t�r�|d | �s�td|p�d d | d|p�d d dd d �dd ��|d7 }W n ty� Y nw |s�td|p�d d | d|p�d d ddddddd �dd d �gd �dd ��| S )Nr r rH r� r r r r� rn r r r rC r r� r! r z must be pep561-stub-namez& cannot be validated by any definitionr9 �rP rU r )r r r �data_any_of_count11r r r r� � s0 F 0 0 0 0 Fr� c C s\ t | t�s.td|p d d | d|pd d dddg d�dd dd d �id d diidd�d d��t | t�}|r�t| �� �}d |v re|�d � | d }t |t�setd|pRd d |d|pZd d dd d �d d��| �� D ]B\}}td �|�r�||v r}|�|� t |t�s�td|p�d dj di t � �� d |d|p�d dj di t � �� d d did d��qi| S )Nr r r r r� r� r� r r� r� r@ r r r� r� rC z.global must be objectz.global� .{data_key}r ) rP rQ r rR rS rT r r_ r` r! r[ )r r r ra rb � data__global�data_key�data_valr r r r] � s$ R 0 R�r] c X C sF) t | t��s�td|p d d | d|pd d dddddgd i d d d d d��dd ddd��dd ddgd��dg d�d g d�d�d ddd dd gd�idgd �d d d d �id gd �gid!d g d"�d#d$�id!gd �gd%�gd&��d'd d(d)d*gd+��d,d-d d.d/d�d dd d0d1gd�idgd2�d d d g d3�d�id gd2�gd4��d5d6d7d8d id9��d:d7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�g dF�dG��dHd7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dIdJgdG��dKd7d8d idLdM��dNd7d dOdPdC�dQdRgdG��dSd dTd>dUd dVdW�idX��dYdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dedZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dfg dg�d]dhid>dUdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�idi��djd7dkdldmd dndodp�dq��drd dsd]d id>dUd7dldmd dndodp�dt�idu��dvd7dwdxgdyg dz�id{�i�d gd>dvgdvd|did}gd~�id�g d��d��dgd�gd��d��d�d5gid�d,d8d iiid��gd;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�dldmd dndodp�d��d�� d8d���z�z�t | t�}|�r�tdvg�| �� }|�r'td|�pd d� tt|��d� | d|�pd d dvgdvd|did}gd~�id�d�d���t| �� �}dv|v �r�|�dv� | dv }t |tt f�}|�r�d>}|D ]0} z#| dk�rjtd|�pWd d� | d|�p`d d� d|did|d���d�}W n t�yy Y �qIw |�s�td|�p�d d� |d|�p�d d� d|did}gd~�d�d���W n t�y� Y n)w td|�p�d d� | d|�p�d d dvgdvd|did}gd~�id�g d��d��d�d���W n t�y� Y n9w t | t�}|�rtdg�| �� }|�rtd|�p�d d� tt|��d� | d|�pd d dgd�gd��d�d���z8t | t�}|�rItd5g�| �� }|�rItd|�p-d d� tt|��d� | d|�p>d d d�d5gid�d���W n t�yT Y n<w t | t�}|�r�t| �� �}d,|v �r�|�d,� | d, } t | t��s�td|�p}d d� | d|�p�d d� d8d id8d���t | t�}|�r�td g�| �� }|�r�td|�p�d d� tt|��d� | d|�p�d d dddddgd i d d d d d��dd ddd��dd ddgd��dg d�d g d�d�d ddd dd gd�idgd �d d d d �id gd �gid!d g d"�d#d$�id!gd �gd%�gd&��d'd d(d)d*gd+��d,d-d d.d/d�d dd d0d1gd�idgd2�d d d g d3�d�id gd2�gd4��d5d6d7d8d id9��d:d7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�g dF�dG��dHd7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dIdJgdG��dKd7d8d idLdM��dNd7d dOdPdC�dQdRgdG��dSd dTd>dUd dVdW�idX��dYdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dedZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dfg dg�d]dhid>dUdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�idi��djd7dkdldmd dndodp�dq��drd dsd]d id>dUd7dldmd dndodp�dt�idu��dvd7dwdxgdyg dz�id{�i�d gd>dvgdvd|did}gd~�id�g d��d��dgd�gd��d��d�d5gid�d,d8d iiid��gd;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�dldmd dndodp�d��d�� d�d���t| �� �}d |v �r�|�d � | d } t | t��s�td|�p�d d� | d|�p�d d� d d d d�d8d���t | t��r�|d | ��s�td|�p�d d� | d|�p�d d� d d d d�d]d���d|v �rB|�d� | d } t | t��std|�pd d� | d|�pd d� d ddd�d8d���t | t��rB|d | ��sBtd|�p-d d� | d|�p6d d� d ddd�d]d���d|v �rr|�d� | d } t | t��srtd|�p\d d� | d|�ped d� d ddgd�d8d���d|v � r&|�d� | d }d�}|d�k �r�z(t |t��s�td|�p�d d� |d|�p�d d� d g d�d�d8d���|d�7 }W n t�y� Y nw |d�k �r͐zt |t��std|�p�d d� |d|�p�d d� d ddd dd gd�idgd �d d d d �id gd �gid!d g d"�d#d$�id!gd �gd%�d8d���d�}|�s�zzt |t�}|�r�tdg�|�� }|�rKtd|�p'd d� tt|��d� |d|�p8d d� dd dd gd�idgd �d�d���t|�� �}d|v �r�|�d� |d }t |t��s�td|�pkd d� |d|�ptd d� d dd gd�d8d���|d�7 }W n t�y� Y nw |�szvt |t�}|�rtd g�|�� }|�r�td|�p�d d� tt|��d� |d|�p�d d� d d d d �id gd �d�d���t|�� �}d |v �r|�d � |d }t |t��std|�p�d d� |d|�p�d d� d d d �d8d���|d�7 }W n t�y Y nw |�sGtd|�p d d� |d|�p'd d� ddd dd gd�idgd �d d d d �id gd �gidd���t |t�}|�r�td!g�|�� }|�r�td|�pad d� tt|��d� |d|�prd d� d!d g d"�d#d$�id!gd �d�d���t|�� �}d!|v �r�|�d!� |d! }t |t��s�td|�p�d d� |d|�p�d d� d g d"�d#d$�d8d���|d�7 }W n t�y� Y nw |d�k� r&td|�p�d d� d�t|� d� |d|�p�d d� g d�d g d�d�d ddd dd gd�idgd �d d d d �id gd �gid!d g d"�d#d$�id!gd �gd%�gd&�d�d���d'|v � r�|�d'� | d' }t |t�� sWtd|� p@d d� |d|� pId d� d d(d)d*gd+�d8d���t |t�� r�|d( |�� s�td|� pjd d� |d|� psd d� d d(d)d*gd+�d]d���d,|v � r�|�d,� | d, } d�}|d�k � r�zOt | t�� s�td|� p�d d� | d|� p�d d� d d.d/d�d8d���t | t�� r�|d/ | �� s�td|� p�d d� | d|� p�d d� d d.d/d�d]d���|d�7 }W n t� y� Y nw |d�k � r�z�t | t�� s td|� pd d� | d|� p d d� d dd d0d1gd�idgd2�d8d���t | t�}|� r�tdg�| �� }|� r^td|� p9d d� tt|��d� | d|� pJd d� d dd d0d1gd�idgd2�d�d���t| �� �}d|v � r�|�d� | d } t | t�� s�td|� p~d d� | d|� p�d d� d d0d1gd�d8d���|d�7 }W n t� y� Y nw |d�k � rXz�t | t�� s�td|� p�d d� | d|� p�d d� d d d g d3�d�id gd2�d8d���t | t�}|� rHtd g�| �� }|� rtd|� p�d d� tt|��d� | d|� p�d d� d d d g d3�d�id gd2�d�d���t| �� �}d |v � rH|�d � | d } t | t�� sHtd|� p2d d� | d|� p;d d� d g d3�d�d8d���|d�7 }W n t� yW Y nw |d�k� r�td|� pcd d� d�t|� d� | d|� ptd d� d-d d.d/d�d dd d0d1gd�idgd2�d d d g d3�d�id gd2�gd4�d�d���d5|v � r|�d5� | d5 } t | tt f�� s�td|� p�d d� | d|� p�d d� d6d7d8d id9�d8d���t | tt f�} | � rt | �} t | �D ]6\}!}"t |"t�� std|� p�d d�j d�i t � �� d� |"d|� pd d�j d�i t � �� d d8d id8d���� q�d:|v � r�|�d:� | d: }#t |#tt f�� s`td|� p6d d� |#d|� p?d d� d7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�g dF�dG�d8d���t |#tt f�}$|$� r�t |#�}%t |#�D ]\}&}'t|'||� p}dd�j d�i t � �� � � qrdH|v � r�|�dH� | dH }(t |(tt f�� s�td|� p�d d� |(d|� p�d d� d7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dIdJgdG�d8d���t |(tt f�})|)� r�t |(�}*t |(�D ]\}+},t|,||� p�dd�j d�i t � �� � � q�dK|v � rv|�dK� | dK }-t |-tt f�� s-td|� pd d� |-d|� p d d� d7d8d idLdM�d8d���t |-tt f�}.|.� rvt |-�}/t |-�D ]6\}0}1t |1t�� sttd|� pOd d�j d�i t � �� d� |1d|� pad d�j d�i t � �� d d8d id8d���� q?dN|v �r2|�dN� | dN }2t |2tt f�� s�td|� p�d d� |2d|� p�d d� d7d dOdPdC�dQdRgdG�d8d���t |2tt f�}3|3�r2t |2�}4t |2�D ]r\}5}6t |6t�� s�td|� p�d d�j d�i t � �� d� |6d|� p�d d�j d�i t � �� d d dOdPdC�d8d���t |6t��r0|dO |6��s0td|�p d d�j d�i t � �� d� |6d|�pd d�j d�i t � �� d d dOdPdC�d]d���� q�dS|v �r&|�dS� | dS }7t |7t��sgtd|�pLd d� |7d|�pUd d� d dTd>dUd dVdW�idX�d8d���t |7t�}8|8�r&t|7�� �}9|7�� D ]�\}:};tdU �|:��r�|:|9v �r�|9�|:� t |;t��s�td|�p�d d�j d�i t � �� d� |;d|�p�d d�j d�i t � �� d d dVdW�d8d���t |;t��r�|dV |;��s�td|�p�d d�j d�i t � �� d� |;d|�p�d d�j d�i t � �� d d dVdW�d]d����qy|9�r&td|�pd d� t|9� d� |7d|�pd d� d dTd>dUd dVdW�idX�d�d���dY|v �r?|�dY� | dY }<t|<||�p;dd� � de|v �rX|�de� | de }=t|=||�pTdd� � df|v �rb|�df� | df }>t |>t�}?|?�rbt|>�� �}@|>�� D ])\}A}BtdU �|A��r�|A|@v �r�|@�|A� t|B||�p�dd�j d�i t � �� � �qx|@�r�td|�p�d d� t|@� d� |>d|�p�d d� g dg�d]dhid>dUdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�idi�d�d���t |>�}C|Cd�k�rbd�}D|>D ]8}Az)t |At��r|dh |A��std|�pd d� |Ad|�pd d� d]dhid]d���W �q� t�y' d>}DY �q�w |D�sbtd|�p1d d� |>d|�p:d d� g dg�d]dhid>dUdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�idi�d�d���dj|v �r�|�dj� | dj }Et |Ett f��s�td|�p~d d� |Ed|�p�d d� d7dkdldmd dndodp�dq�d8d���t |Ett f�}F|F�r�t |E�}Gt |E�D ]\}H}It|I||�p�dd�j d�i t � �� � �q�dr|v �r5|�dr� | dr }Jt |Jt��std|�p�d d� |Jd|�p�d d� d dsd]d id>dUd7dldmd dndodp�dt�idu�d8d���t |Jt�}K|K�r5t|J�� �}L|J�� D ]{\}M}NtdU �|M��r�|M|Lv �r)|L�|M� t |Ntt f��sctd|�p7d d�j d�i t � �� d� |Nd|�pId d�j d�i t � �� d d7dldmd dndodp�dt�d8d���t |Ntt f�}O|O�r�t |N�}Pt |N�D ]\}Q}Rt|R||�p�dd�j d�i t � �� � �qu�q|L�r�td|�p�d d� t|L� d� |Jd|�p�d d� d dsd]d id>dUd7dldmd dndodp�dt�idu�d�d���t |J�}S|Sd�k�r5d�}T|JD ]8}Mz)t |Mt��r�|d |M��s�td|�p�d d� |Md|�p�d d� d]d id]d���W �q� t�y d>}TY �q�w |T�s5td|�pd d� |Jd|�pd d� d dsd]d id>dUd7dldmd dndodp�dt�idu�d�d���dv|v �r�|�dv� | dv }t |tt f��sltd|�pQd d� |d|�pZd d� d7dwdxgdyg dz�id{�d8d���t |tt f�}|�r�t |�}Ut |�D ]7\}V}W|Wdzv�r�td|�p�d d�j d�i t � �� d� |Wd|�p�d d�j d�i t � �� d dyg dz�idyd����q~|�r�td|�p�d d� t|� d� | d|�p�d d dddddgd i d d d d d��dd ddd��dd ddgd��dg d�d g d�d�d ddd dd gd�idgd �d d d d �id gd �gid!d g d"�d#d$�id!gd �gd%�gd&��d'd d(d)d*gd+��d,d-d d.d/d�d dd d0d1gd�idgd2�d d d g d3�d�id gd2�gd4��d5d6d7d8d id9��d:d7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�g dF�dG��dHd7d;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dIdJgdG��dKd7d8d idLdM��dNd7d dOdPdC�dQdRgdG��dSd dTd>dUd dVdW�idX��dYdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dedZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd��dfg dg�d]dhid>dUdZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�idi��djd7dkdldmd dndodp�dq��drd dsd]d id>dUd7dldmd dndodp�dt�idu��dvd7dwdxgdyg dz�id{�i�d gd>dvgdvd|did}gd~�id�g d��d��dgd�gd��d��d�d5gid�d,d8d iiid��gd;d<d=d d>d d?d@gd�d dAdBdC�dD�dE�dZd[d g d\�d]d^id>dUd d_d`gdadbdc�idd�dldmd dndodp�d��d�� d�d���| S )�Nr r r r r) r* r+ r, r r- r r. r/ r r0 r1 r2 r r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rC rD rE rG rI rJ rK rL rM rN rO rP rQ rR rS rT rU rV rW rX r r rY rZ r\ r� r� Fr� r� r� r� rh r� r� r] r^ r_ r` ra rb rc rd re rf rg ri rj rk rl r rm rn ro rq rr r� r� r! r� r� r� r� r� r� r� rt ru rv rw rx rz r{ r| r� r� r� r� r} r~ r r� r� r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r( r' r� r� rC r rG z2.dynamic must be same as const definition: versionr� Tz0.dynamic must contain one of contains definitionr� z' must NOT match a disallowed definitionr� z.license must be stringz.licenser r z .name must be pep508-identifierz.version must be stringz.versionz.version must be pep440z.description must be stringz .descriptionr rJ z.readme must be stringz.readmer z.readme must be objectz.readme must contain z.readme.file must be stringz .readme.filez.readme.text must be stringz .readme.textz-.readme cannot be validated by any definitionz#.readme.content-type must be stringz.readme.content-typez/.readme must be valid exactly by one definitionrN rO rH z .requires-python must be stringz.requires-pythonz+.requires-python must be pep508-versionspecz.license must be SPDXz.license must be objectz.license must contain z .license.file must be stringz .license.filez .license.text must be stringz .license.textz0.license must be valid exactly by one definitionr� r� r� rH z.authors must be arrayz.authorsz.authors[{data__authors_x}]z.maintainers must be arrayz .maintainersz#.maintainers[{data__maintainers_x}]z.keywords must be arrayz .keywordsz .keywords[{data__keywords_x}]z.classifiers must be arrayz .classifiersz#.classifiers[{data__classifiers_x}]z must be trove-classifierz.urls must be objectz.urlsz.urls.{data__urls_key}z must be urlz.urls must not contain r& z.scriptsz .gui-scriptsz%.entry-points.{data__entrypoints_key}z .entry-points must not contain z .entry-pointsz-.entry-points must be python-entrypoint-groupz6.entry-points must be named by propertyName definitionry z.dependencies must be arrayz .dependenciesz%.dependencies[{data__dependencies_x}]z%.optional-dependencies must be objectz.optional-dependenciesz7.optional-dependencies.{data__optionaldependencies_key}rI z[.optional-dependencies.{data__optionaldependencies_key}[{data__optionaldependencies_val_x}]z(.optional-dependencies must not contain z0.optional-dependencies must be pep508-identifierz?.optional-dependencies must be named by propertyName definitionz.dynamic must be arrayz.dynamic[{data__dynamic_x}]z� must be one of ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']rL r )rP rQ r rR rS rU rV rT rW rX rY rZ r! r[ �bvalidate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_authorr r_ r` �mvalidate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group�fvalidate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency)Xr r r ra r rb r� �data__dynamic_is_list�data__dynamic_contains�data__dynamic_key� data__licenser � data__version�data__description� data__readme�data__readme_one_of_count12�data__readme_any_of_count13�data__readme_is_dict�data__readme__missing_keys�data__readme_keys�data__readme__file�data__readme__text�data__readme__contenttype�data__requirespython� data__license_one_of_count14�data__license_is_dict�data__license__missing_keys�data__license_keys�data__license__file�data__license__textr� r� r� r� r� � data__authors�data__authors_is_list�data__authors_len�data__authors_x�data__authors_item�data__maintainers�data__maintainers_is_list�data__maintainers_len�data__maintainers_x�data__maintainers_item�data__keywords�data__keywords_is_list�data__keywords_len�data__keywords_x�data__keywords_item�data__classifiers�data__classifiers_is_list�data__classifiers_len�data__classifiers_x�data__classifiers_item� data__urls�data__urls_is_dict�data__urls_keys�data__urls_key�data__urls_val� data__scripts�data__guiscripts�data__entrypoints�data__entrypoints_is_dict�data__entrypoints_keys�data__entrypoints_key�data__entrypoints_val�data__entrypoints_len� data__entrypoints_property_names�data__dependencies�data__dependencies_is_list�data__dependencies_len�data__dependencies_x�data__dependencies_item�data__optionaldependencies�"data__optionaldependencies_is_dict� data__optionaldependencies_keys� data__optionaldependencies_key� data__optionaldependencies_val�&data__optionaldependencies_val_is_list�"data__optionaldependencies_val_len� data__optionaldependencies_val_x�#data__optionaldependencies_val_item� data__optionaldependencies_len�)data__optionaldependencies_property_names�data__dynamic_len�data__dynamic_x�data__dynamic_itemr r r r\ � s �� � � V 2:�P�� H D�� 2 �� � � 6 6 6 6 8 8 � T 8 P 4 ^ V : � : : 6 6 F V 8 F V 8 � : V� `( `( : V� B Z Z� B X X�N $�z 2� �n B( T d(�` 2� �T B Z��� � � r\ c C s� t | t�s td|p d d | d|pd d dddddd �d d ��t | t�rF|d | �sFtd|p0d d | d|p8d d dddddd �d d ��| S )Nr r rH r| r� r r� r� r� r rC rK r! rz r r r r r� H s 6 6r� c C s� t | t�s/td|p d d | d|pd d dddg d�dd id d d d dgddd�id�dd��t | t�}|�rit| �� �}| �� D ]�\}}td �|�r�||v rU|�|� t |t �s�td|p_d dj d i t � �� d |d|ppd dj d i t � �� d d d dgddd�dd��t |t �r�|d |�s�td|p�d dj d i t � �� d |d|p�d dj d i t � �� d d d dgddd�dd��qA|r�td|p�d d t |� d | d|p�d d dddg d�dd id d d d dgddd�id�dd��t | �}|dk�rid }| D ]8}z)t |t ��r*|d |��s*td|�pd d |d|�p d d dd idd��W �q t�y9 d }Y �qw |�sitd|�pCd d | d|�pLd d dddg d�dd id d d d dgddd�id�d d��| S )!Nr r r rr r� r r� r! r� Fr r r� r� r� r� r� r� r rC r| rH z$ must be python-entrypoint-referencerL rG r& r Tz must be python-entrypoint-namez) must be named by propertyName definitionry r ) rP rQ r rR rS r r_ r` rT rU r! r[ rY ) r r r ra rb r~ r r �data_property_namesr r r r� P s@ T \ \�` 2� �Xr� c C s� t | t�s-td|p d d | d|pd d dddddd d d gd �d d dd�d�d�dd��t | t�}|r�t| �� �}d|v rf|�d� | d }t |t�sftd|pQd d |d|pYd d d d d gd �dd��d|v r�|�d� | d }t |t�s�td|p}d d |d|p�d d d d dd�dd��t |t�r�td �|�s�td|p�d d |d|p�d d d d dd�d d��|r�td|p�d d t|� d | d|p�d d dddddd d d gd �d d dd�d�d�d d��| S ) Nr r r r\ r� r� r Fr r� r� r5 r� r� rh r� r� r rC r- r r r� z.email must be stringz.emailr z.email must be idn-emailr! rL rG r& ) rP rQ r rR rS rT rU r_ �match)r r r ra rb r � data__emailr r r r� o s* P 4 2 2\r� )�VERSION�decimalr �re�fastjsonschema_exceptionsr �compiler_ r r r r r^ r� r� r� r� r� r� r� r] r\ r� r� r� r r r r �<module> s@ �| 6% N: p config/_validate_pyproject/__pycache__/fastjsonschema_exceptions.cpython-310.pyc 0000644 00000004603 15030122015 0024212 0 ustar 00 o �hL � @ sF d dl Z e �d�ZG dd� de�ZG dd� de�ZG dd� de�ZdS ) � Nz [\.\[\]]+c @ � e Zd ZdZdS )�JsonSchemaExceptionz7 Base exception of ``fastjsonschema`` library. N��__name__� __module__� __qualname__�__doc__� r r �r/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.pyr � r c s: e Zd ZdZd � fdd� Zedd� �Zedd� �Z� ZS ) �JsonSchemaValueExceptiona� Exception raised by validation function. Available properties: * ``message`` containing human-readable information what is wrong (e.g. ``data.property[index] must be smaller than or equal to 42``), * invalid ``value`` (e.g. ``60``), * ``name`` of a path in the data structure (e.g. ``data.property[index]``), * ``path`` as an array in the data structure (e.g. ``['data', 'property', 'index']``), * the whole ``definition`` which the ``value`` has to fulfil (e.g. ``{'type': 'number', 'maximum': 42}``), * ``rule`` which the ``value`` is breaking (e.g. ``maximum``) * and ``rule_definition`` (e.g. ``42``). .. versionchanged:: 2.14.0 Added all extra properties. Nc s. t � �|� || _|| _|| _|| _|| _d S �N)�super�__init__�message�value�name� definition�rule)�selfr r r r r �� __class__r r r s z!JsonSchemaValueException.__init__c C s dd� t �| j�D �S )Nc S s g | ]}|d kr|�qS )� r )�.0�itemr r r � <listcomp>' s z1JsonSchemaValueException.path.<locals>.<listcomp>)�SPLIT_RE�splitr �r r r r �path% s z JsonSchemaValueException.pathc C s | j r| jsd S | j�| j �S r )r r �getr r r r �rule_definition) s z(JsonSchemaValueException.rule_definition)NNNN) r r r r r �propertyr r! � __classcell__r r r r r s r c @ r )� JsonSchemaDefinitionExceptionz? Exception raised by generator of validation function. Nr r r r r r$ 0 r r$ )�re�compiler � ValueErrorr r r$ r r r r �<module> s # config/_validate_pyproject/extra_validations.py 0000644 00000005452 15030122015 0016125 0 ustar 00 """The purpose of this module is implement PEP 621 validations that are difficult to express as a JSON Schema (or that are not supported by the current JSON Schema library). """ from inspect import cleandoc from typing import Mapping, TypeVar from .error_reporting import ValidationError T = TypeVar("T", bound=Mapping) class RedefiningStaticFieldAsDynamic(ValidationError): _DESC = """According to PEP 621: Build back-ends MUST raise an error if the metadata specifies a field statically as well as being listed in dynamic. """ __doc__ = _DESC _URL = ( "https://packaging.python.org/en/latest/specifications/" "pyproject-toml/#dynamic" ) class IncludedDependencyGroupMustExist(ValidationError): _DESC = """An included dependency group must exist and must not be cyclic. """ __doc__ = _DESC _URL = "https://peps.python.org/pep-0735/" def validate_project_dynamic(pyproject: T) -> T: project_table = pyproject.get("project", {}) dynamic = project_table.get("dynamic", []) for field in dynamic: if field in project_table: raise RedefiningStaticFieldAsDynamic( message=f"You cannot provide a value for `project.{field}` and " "list it under `project.dynamic` at the same time", value={ field: project_table[field], "...": " # ...", "dynamic": dynamic, }, name=f"data.project.{field}", definition={ "description": cleandoc(RedefiningStaticFieldAsDynamic._DESC), "see": RedefiningStaticFieldAsDynamic._URL, }, rule="PEP 621", ) return pyproject def validate_include_depenency(pyproject: T) -> T: dependency_groups = pyproject.get("dependency-groups", {}) for key, value in dependency_groups.items(): for each in value: if ( isinstance(each, dict) and (include_group := each.get("include-group")) and include_group not in dependency_groups ): raise IncludedDependencyGroupMustExist( message=f"The included dependency group {include_group} doesn't exist", value=each, name=f"data.dependency_groups.{key}", definition={ "description": cleandoc(IncludedDependencyGroupMustExist._DESC), "see": IncludedDependencyGroupMustExist._URL, }, rule="PEP 735", ) # TODO: check for `include-group` cycles (can be conditional to graphlib) return pyproject EXTRA_VALIDATIONS = (validate_project_dynamic, validate_include_depenency) config/_validate_pyproject/error_reporting.py 0000644 00000027045 15030122015 0015631 0 ustar 00 import io import json import logging import os import re import typing from contextlib import contextmanager from textwrap import indent, wrap from typing import Any, Dict, Generator, Iterator, List, Optional, Sequence, Union from .fastjsonschema_exceptions import JsonSchemaValueException if typing.TYPE_CHECKING: import sys if sys.version_info < (3, 11): from typing_extensions import Self else: from typing import Self _logger = logging.getLogger(__name__) _MESSAGE_REPLACEMENTS = { "must be named by propertyName definition": "keys must be named by", "one of contains definition": "at least one item that matches", " same as const definition:": "", "only specified items": "only items matching the definition", } _SKIP_DETAILS = ( "must not be empty", "is always invalid", "must not be there", ) _NEED_DETAILS = {"anyOf", "oneOf", "allOf", "contains", "propertyNames", "not", "items"} _CAMEL_CASE_SPLITTER = re.compile(r"\W+|([A-Z][^A-Z\W]*)") _IDENTIFIER = re.compile(r"^[\w_]+$", re.I) _TOML_JARGON = { "object": "table", "property": "key", "properties": "keys", "property names": "keys", } _FORMATS_HELP = """ For more details about `format` see https://validate-pyproject.readthedocs.io/en/latest/api/validate_pyproject.formats.html """ class ValidationError(JsonSchemaValueException): """Report violations of a given JSON schema. This class extends :exc:`~fastjsonschema.JsonSchemaValueException` by adding the following properties: - ``summary``: an improved version of the ``JsonSchemaValueException`` error message with only the necessary information) - ``details``: more contextual information about the error like the failing schema itself and the value that violates the schema. Depending on the level of the verbosity of the ``logging`` configuration the exception message will be only ``summary`` (default) or a combination of ``summary`` and ``details`` (when the logging level is set to :obj:`logging.DEBUG`). """ summary = "" details = "" _original_message = "" @classmethod def _from_jsonschema(cls, ex: JsonSchemaValueException) -> "Self": formatter = _ErrorFormatting(ex) obj = cls(str(formatter), ex.value, formatter.name, ex.definition, ex.rule) debug_code = os.getenv("JSONSCHEMA_DEBUG_CODE_GENERATION", "false").lower() if debug_code != "false": # pragma: no cover obj.__cause__, obj.__traceback__ = ex.__cause__, ex.__traceback__ obj._original_message = ex.message obj.summary = formatter.summary obj.details = formatter.details return obj @contextmanager def detailed_errors() -> Generator[None, None, None]: try: yield except JsonSchemaValueException as ex: raise ValidationError._from_jsonschema(ex) from None class _ErrorFormatting: def __init__(self, ex: JsonSchemaValueException): self.ex = ex self.name = f"`{self._simplify_name(ex.name)}`" self._original_message: str = self.ex.message.replace(ex.name, self.name) self._summary = "" self._details = "" def __str__(self) -> str: if _logger.getEffectiveLevel() <= logging.DEBUG and self.details: return f"{self.summary}\n\n{self.details}" return self.summary @property def summary(self) -> str: if not self._summary: self._summary = self._expand_summary() return self._summary @property def details(self) -> str: if not self._details: self._details = self._expand_details() return self._details @staticmethod def _simplify_name(name: str) -> str: x = len("data.") return name[x:] if name.startswith("data.") else name def _expand_summary(self) -> str: msg = self._original_message for bad, repl in _MESSAGE_REPLACEMENTS.items(): msg = msg.replace(bad, repl) if any(substring in msg for substring in _SKIP_DETAILS): return msg schema = self.ex.rule_definition if self.ex.rule in _NEED_DETAILS and schema: summary = _SummaryWriter(_TOML_JARGON) return f"{msg}:\n\n{indent(summary(schema), ' ')}" return msg def _expand_details(self) -> str: optional = [] definition = self.ex.definition or {} desc_lines = definition.pop("$$description", []) desc = definition.pop("description", None) or " ".join(desc_lines) if desc: description = "\n".join( wrap( desc, width=80, initial_indent=" ", subsequent_indent=" ", break_long_words=False, ) ) optional.append(f"DESCRIPTION:\n{description}") schema = json.dumps(definition, indent=4) value = json.dumps(self.ex.value, indent=4) defaults = [ f"GIVEN VALUE:\n{indent(value, ' ')}", f"OFFENDING RULE: {self.ex.rule!r}", f"DEFINITION:\n{indent(schema, ' ')}", ] msg = "\n\n".join(optional + defaults) epilog = f"\n{_FORMATS_HELP}" if "format" in msg.lower() else "" return msg + epilog class _SummaryWriter: _IGNORE = frozenset(("description", "default", "title", "examples")) def __init__(self, jargon: Optional[Dict[str, str]] = None): self.jargon: Dict[str, str] = jargon or {} # Clarify confusing terms self._terms = { "anyOf": "at least one of the following", "oneOf": "exactly one of the following", "allOf": "all of the following", "not": "(*NOT* the following)", "prefixItems": f"{self._jargon('items')} (in order)", "items": "items", "contains": "contains at least one of", "propertyNames": ( f"non-predefined acceptable {self._jargon('property names')}" ), "patternProperties": f"{self._jargon('properties')} named via pattern", "const": "predefined value", "enum": "one of", } # Attributes that indicate that the definition is easy and can be done # inline (e.g. string and number) self._guess_inline_defs = [ "enum", "const", "maxLength", "minLength", "pattern", "format", "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum", "multipleOf", ] def _jargon(self, term: Union[str, List[str]]) -> Union[str, List[str]]: if isinstance(term, list): return [self.jargon.get(t, t) for t in term] return self.jargon.get(term, term) def __call__( self, schema: Union[dict, List[dict]], prefix: str = "", *, _path: Sequence[str] = (), ) -> str: if isinstance(schema, list): return self._handle_list(schema, prefix, _path) filtered = self._filter_unecessary(schema, _path) simple = self._handle_simple_dict(filtered, _path) if simple: return f"{prefix}{simple}" child_prefix = self._child_prefix(prefix, " ") item_prefix = self._child_prefix(prefix, "- ") indent = len(prefix) * " " with io.StringIO() as buffer: for i, (key, value) in enumerate(filtered.items()): child_path = [*_path, key] line_prefix = prefix if i == 0 else indent buffer.write(f"{line_prefix}{self._label(child_path)}:") # ^ just the first item should receive the complete prefix if isinstance(value, dict): filtered = self._filter_unecessary(value, child_path) simple = self._handle_simple_dict(filtered, child_path) buffer.write( f" {simple}" if simple else f"\n{self(value, child_prefix, _path=child_path)}" ) elif isinstance(value, list) and ( key != "type" or self._is_property(child_path) ): children = self._handle_list(value, item_prefix, child_path) sep = " " if children.startswith("[") else "\n" buffer.write(f"{sep}{children}") else: buffer.write(f" {self._value(value, child_path)}\n") return buffer.getvalue() def _is_unecessary(self, path: Sequence[str]) -> bool: if self._is_property(path) or not path: # empty path => instruction @ root return False key = path[-1] return any(key.startswith(k) for k in "$_") or key in self._IGNORE def _filter_unecessary( self, schema: Dict[str, Any], path: Sequence[str] ) -> Dict[str, Any]: return { key: value for key, value in schema.items() if not self._is_unecessary([*path, key]) } def _handle_simple_dict(self, value: dict, path: Sequence[str]) -> Optional[str]: inline = any(p in value for p in self._guess_inline_defs) simple = not any(isinstance(v, (list, dict)) for v in value.values()) if inline or simple: return f"{{{', '.join(self._inline_attrs(value, path))}}}\n" return None def _handle_list( self, schemas: list, prefix: str = "", path: Sequence[str] = () ) -> str: if self._is_unecessary(path): return "" repr_ = repr(schemas) if all(not isinstance(e, (dict, list)) for e in schemas) and len(repr_) < 60: return f"{repr_}\n" item_prefix = self._child_prefix(prefix, "- ") return "".join( self(v, item_prefix, _path=[*path, f"[{i}]"]) for i, v in enumerate(schemas) ) def _is_property(self, path: Sequence[str]) -> bool: """Check if the given path can correspond to an arbitrarily named property""" counter = 0 for key in path[-2::-1]: if key not in {"properties", "patternProperties"}: break counter += 1 # If the counter if even, the path correspond to a JSON Schema keyword # otherwise it can be any arbitrary string naming a property return counter % 2 == 1 def _label(self, path: Sequence[str]) -> str: *parents, key = path if not self._is_property(path): norm_key = _separate_terms(key) return self._terms.get(key) or " ".join(self._jargon(norm_key)) if parents[-1] == "patternProperties": return f"(regex {key!r})" return repr(key) # property name def _value(self, value: Any, path: Sequence[str]) -> str: if path[-1] == "type" and not self._is_property(path): type_ = self._jargon(value) return f"[{', '.join(type_)}]" if isinstance(type_, list) else type_ return repr(value) def _inline_attrs(self, schema: dict, path: Sequence[str]) -> Iterator[str]: for key, value in schema.items(): child_path = [*path, key] yield f"{self._label(child_path)}: {self._value(value, child_path)}" def _child_prefix(self, parent_prefix: str, child_prefix: str) -> str: return len(parent_prefix) * " " + child_prefix def _separate_terms(word: str) -> List[str]: """ >>> _separate_terms("FooBar-foo") ['foo', 'bar', 'foo'] """ return [w.lower() for w in _CAMEL_CASE_SPLITTER.split(word) if w] config/_validate_pyproject/formats.py 0000644 00000032374 15030122015 0014063 0 ustar 00 """ The functions in this module are used to validate schemas with the `format JSON Schema keyword <https://json-schema.org/understanding-json-schema/reference/string#format>`_. The correspondence is given by replacing the ``_`` character in the name of the function with a ``-`` to obtain the format name and vice versa. """ import builtins import logging import os import re import string import typing from itertools import chain as _chain if typing.TYPE_CHECKING: from typing_extensions import Literal _logger = logging.getLogger(__name__) # ------------------------------------------------------------------------------------- # PEP 440 VERSION_PATTERN = r""" v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version """ VERSION_REGEX = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.X | re.I) def pep440(version: str) -> bool: """See :ref:`PyPA's version specification <pypa:version-specifiers>` (initially introduced in :pep:`440`). """ return VERSION_REGEX.match(version) is not None # ------------------------------------------------------------------------------------- # PEP 508 PEP508_IDENTIFIER_PATTERN = r"([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])" PEP508_IDENTIFIER_REGEX = re.compile(f"^{PEP508_IDENTIFIER_PATTERN}$", re.I) def pep508_identifier(name: str) -> bool: """See :ref:`PyPA's name specification <pypa:name-format>` (initially introduced in :pep:`508#names`). """ return PEP508_IDENTIFIER_REGEX.match(name) is not None try: try: from packaging import requirements as _req except ImportError: # pragma: no cover # let's try setuptools vendored version from setuptools._vendor.packaging import ( # type: ignore[no-redef] requirements as _req, ) def pep508(value: str) -> bool: """See :ref:`PyPA's dependency specifiers <pypa:dependency-specifiers>` (initially introduced in :pep:`508`). """ try: _req.Requirement(value) return True except _req.InvalidRequirement: return False except ImportError: # pragma: no cover _logger.warning( "Could not find an installation of `packaging`. Requirements, dependencies and " "versions might not be validated. " "To enforce validation, please install `packaging`." ) def pep508(value: str) -> bool: return True def pep508_versionspec(value: str) -> bool: """Expression that can be used to specify/lock versions (including ranges) See ``versionspec`` in :ref:`PyPA's dependency specifiers <pypa:dependency-specifiers>` (initially introduced in :pep:`508`). """ if any(c in value for c in (";", "]", "@")): # In PEP 508: # conditional markers, extras and URL specs are not included in the # versionspec return False # Let's pretend we have a dependency called `requirement` with the given # version spec, then we can reuse the pep508 function for validation: return pep508(f"requirement{value}") # ------------------------------------------------------------------------------------- # PEP 517 def pep517_backend_reference(value: str) -> bool: """See PyPA's specification for defining build-backend references introduced in :pep:`517#source-trees`. This is similar to an entry-point reference (e.g., ``package.module:object``). """ module, _, obj = value.partition(":") identifiers = (i.strip() for i in _chain(module.split("."), obj.split("."))) return all(python_identifier(i) for i in identifiers if i) # ------------------------------------------------------------------------------------- # Classifiers - PEP 301 def _download_classifiers() -> str: import ssl from email.message import Message from urllib.request import urlopen url = "https://pypi.org/pypi?:action=list_classifiers" context = ssl.create_default_context() with urlopen(url, context=context) as response: # noqa: S310 (audit URLs) headers = Message() headers["content_type"] = response.getheader("content-type", "text/plain") return response.read().decode(headers.get_param("charset", "utf-8")) # type: ignore[no-any-return] class _TroveClassifier: """The ``trove_classifiers`` package is the official way of validating classifiers, however this package might not be always available. As a workaround we can still download a list from PyPI. We also don't want to be over strict about it, so simply skipping silently is an option (classifiers will be validated anyway during the upload to PyPI). """ downloaded: typing.Union[None, "Literal[False]", typing.Set[str]] """ None => not cached yet False => unavailable set => cached values """ def __init__(self) -> None: self.downloaded = None self._skip_download = False self.__name__ = "trove_classifier" # Emulate a public function def _disable_download(self) -> None: # This is a private API. Only setuptools has the consent of using it. self._skip_download = True def __call__(self, value: str) -> bool: if self.downloaded is False or self._skip_download is True: return True if os.getenv("NO_NETWORK") or os.getenv("VALIDATE_PYPROJECT_NO_NETWORK"): self.downloaded = False msg = ( "Install ``trove-classifiers`` to ensure proper validation. " "Skipping download of classifiers list from PyPI (NO_NETWORK)." ) _logger.debug(msg) return True if self.downloaded is None: msg = ( "Install ``trove-classifiers`` to ensure proper validation. " "Meanwhile a list of classifiers will be downloaded from PyPI." ) _logger.debug(msg) try: self.downloaded = set(_download_classifiers().splitlines()) except Exception: self.downloaded = False _logger.debug("Problem with download, skipping validation") return True return value in self.downloaded or value.lower().startswith("private ::") try: from trove_classifiers import classifiers as _trove_classifiers def trove_classifier(value: str) -> bool: """See https://pypi.org/classifiers/""" return value in _trove_classifiers or value.lower().startswith("private ::") except ImportError: # pragma: no cover trove_classifier = _TroveClassifier() # ------------------------------------------------------------------------------------- # Stub packages - PEP 561 def pep561_stub_name(value: str) -> bool: """Name of a directory containing type stubs. It must follow the name scheme ``<package>-stubs`` as defined in :pep:`561#stub-only-packages`. """ top, *children = value.split(".") if not top.endswith("-stubs"): return False return python_module_name(".".join([top[: -len("-stubs")], *children])) # ------------------------------------------------------------------------------------- # Non-PEP related def url(value: str) -> bool: """Valid URL (validation uses :obj:`urllib.parse`). For maximum compatibility please make sure to include a ``scheme`` prefix in your URL (e.g. ``http://``). """ from urllib.parse import urlparse try: parts = urlparse(value) if not parts.scheme: _logger.warning( "For maximum compatibility please make sure to include a " "`scheme` prefix in your URL (e.g. 'http://'). " f"Given value: {value}" ) if not (value.startswith("/") or value.startswith("\\") or "@" in value): parts = urlparse(f"http://{value}") return bool(parts.scheme and parts.netloc) except Exception: return False # https://packaging.python.org/specifications/entry-points/ ENTRYPOINT_PATTERN = r"[^\[\s=]([^=]*[^\s=])?" ENTRYPOINT_REGEX = re.compile(f"^{ENTRYPOINT_PATTERN}$", re.I) RECOMMEDED_ENTRYPOINT_PATTERN = r"[\w.-]+" RECOMMEDED_ENTRYPOINT_REGEX = re.compile(f"^{RECOMMEDED_ENTRYPOINT_PATTERN}$", re.I) ENTRYPOINT_GROUP_PATTERN = r"\w+(\.\w+)*" ENTRYPOINT_GROUP_REGEX = re.compile(f"^{ENTRYPOINT_GROUP_PATTERN}$", re.I) def python_identifier(value: str) -> bool: """Can be used as identifier in Python. (Validation uses :obj:`str.isidentifier`). """ return value.isidentifier() def python_qualified_identifier(value: str) -> bool: """ Python "dotted identifier", i.e. a sequence of :obj:`python_identifier` concatenated with ``"."`` (e.g.: ``package.module.submodule``). """ if value.startswith(".") or value.endswith("."): return False return all(python_identifier(m) for m in value.split(".")) def python_module_name(value: str) -> bool: """Module name that can be used in an ``import``-statement in Python. See :obj:`python_qualified_identifier`. """ return python_qualified_identifier(value) def python_module_name_relaxed(value: str) -> bool: """Similar to :obj:`python_module_name`, but relaxed to also accept dash characters (``-``) and cover special cases like ``pip-run``. It is recommended, however, that beginners avoid dash characters, as they require advanced knowledge about Python internals. The following are disallowed: * names starting/ending in dashes, * names ending in ``-stubs`` (potentially collide with :obj:`pep561_stub_name`). """ if value.startswith("-") or value.endswith("-"): return False if value.endswith("-stubs"): return False # Avoid collision with PEP 561 return python_module_name(value.replace("-", "_")) def python_entrypoint_group(value: str) -> bool: """See ``Data model > group`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. """ return ENTRYPOINT_GROUP_REGEX.match(value) is not None def python_entrypoint_name(value: str) -> bool: """See ``Data model > name`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. """ if not ENTRYPOINT_REGEX.match(value): return False if not RECOMMEDED_ENTRYPOINT_REGEX.match(value): msg = f"Entry point `{value}` does not follow recommended pattern: " msg += RECOMMEDED_ENTRYPOINT_PATTERN _logger.warning(msg) return True def python_entrypoint_reference(value: str) -> bool: """Reference to a Python object using in the format:: importable.module:object.attr See ``Data model >object reference`` in the :ref:`PyPA's entry-points specification <pypa:entry-points>`. """ module, _, rest = value.partition(":") if "[" in rest: obj, _, extras_ = rest.partition("[") if extras_.strip()[-1] != "]": return False extras = (x.strip() for x in extras_.strip(string.whitespace + "[]").split(",")) if not all(pep508_identifier(e) for e in extras): return False _logger.warning(f"`{value}` - using extras for entry points is not recommended") else: obj = rest module_parts = module.split(".") identifiers = _chain(module_parts, obj.split(".")) if rest else iter(module_parts) return all(python_identifier(i.strip()) for i in identifiers) def uint8(value: builtins.int) -> bool: r"""Unsigned 8-bit integer (:math:`0 \leq x < 2^8`)""" return 0 <= value < 2**8 def uint16(value: builtins.int) -> bool: r"""Unsigned 16-bit integer (:math:`0 \leq x < 2^{16}`)""" return 0 <= value < 2**16 def uint(value: builtins.int) -> bool: r"""Unsigned 64-bit integer (:math:`0 \leq x < 2^{64}`)""" return 0 <= value < 2**64 def int(value: builtins.int) -> bool: r"""Signed 64-bit integer (:math:`-2^{63} \leq x < 2^{63}`)""" return -(2**63) <= value < 2**63 try: from packaging import licenses as _licenses def SPDX(value: str) -> bool: """See :ref:`PyPA's License-Expression specification <pypa:core-metadata-license-expression>` (added in :pep:`639`). """ try: _licenses.canonicalize_license_expression(value) return True except _licenses.InvalidLicenseExpression: return False except ImportError: # pragma: no cover _logger.warning( "Could not find an up-to-date installation of `packaging`. " "License expressions might not be validated. " "To enforce validation, please install `packaging>=24.2`." ) def SPDX(value: str) -> bool: return True config/_validate_pyproject/fastjsonschema_validations.py 0000644 00001264572 15030122015 0020025 0 ustar 00 # noqa # ruff: noqa # flake8: noqa # pylint: skip-file # mypy: ignore-errors # yapf: disable # pylama:skip=1 # *** PLEASE DO NOT MODIFY DIRECTLY: Automatically generated code *** VERSION = "2.20.0" from decimal import Decimal import re from .fastjsonschema_exceptions import JsonSchemaValueException REGEX_PATTERNS = { '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': re.compile('^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])\\Z'), '^.*$': re.compile('^.*$'), '.+': re.compile('.+'), '^.+$': re.compile('^.+$'), 'idn-email_re_pattern': re.compile('^[^@]+@[^@]+\\.[^@]+\\Z') } NoneType = type(None) def validate(data, custom_formats={}, name_prefix=None): validate_https___packaging_python_org_en_latest_specifications_declaring_build_dependencies(data, custom_formats, (name_prefix or "data") + "") return data def validate_https___packaging_python_org_en_latest_specifications_declaring_build_dependencies(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/declaring-build-dependencies/', 'title': 'Data structure for ``pyproject.toml`` files', '$$description': ['File format containing build-time configurations for the Python ecosystem. ', ':pep:`517` initially defined a build-system independent format for source trees', 'which was complemented by :pep:`518` to provide a way of specifying dependencies ', 'for building Python projects.', 'Please notice the ``project`` table (as initially defined in :pep:`621`) is not included', 'in this schema and should be considered separately.'], 'type': 'object', 'additionalProperties': False, 'properties': {'build-system': {'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, 'tool': {'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.', 'See also `the old Python docs <https://docs.python.org/3.11/install/>_`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '<https://setuptools.pypa.io/en/latest/references/keywords.html>`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, 'dependency-groups': {'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "build-system" in data_keys: data_keys.remove("build-system") data__buildsystem = data["build-system"] if not isinstance(data__buildsystem, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must be object", value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='type') data__buildsystem_is_dict = isinstance(data__buildsystem, dict) if data__buildsystem_is_dict: data__buildsystem__missing_keys = set(['requires']) - data__buildsystem.keys() if data__buildsystem__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must contain " + (str(sorted(data__buildsystem__missing_keys)) + " properties"), value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='required') data__buildsystem_keys = set(data__buildsystem.keys()) if "requires" in data__buildsystem_keys: data__buildsystem_keys.remove("requires") data__buildsystem__requires = data__buildsystem["requires"] if not isinstance(data__buildsystem__requires, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.requires must be array", value=data__buildsystem__requires, name="" + (name_prefix or "data") + ".build-system.requires", definition={'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, rule='type') data__buildsystem__requires_is_list = isinstance(data__buildsystem__requires, (list, tuple)) if data__buildsystem__requires_is_list: data__buildsystem__requires_len = len(data__buildsystem__requires) for data__buildsystem__requires_x, data__buildsystem__requires_item in enumerate(data__buildsystem__requires): if not isinstance(data__buildsystem__requires_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.requires[{data__buildsystem__requires_x}]".format(**locals()) + " must be string", value=data__buildsystem__requires_item, name="" + (name_prefix or "data") + ".build-system.requires[{data__buildsystem__requires_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "build-backend" in data__buildsystem_keys: data__buildsystem_keys.remove("build-backend") data__buildsystem__buildbackend = data__buildsystem["build-backend"] if not isinstance(data__buildsystem__buildbackend, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.build-backend must be string", value=data__buildsystem__buildbackend, name="" + (name_prefix or "data") + ".build-system.build-backend", definition={'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, rule='type') if isinstance(data__buildsystem__buildbackend, str): if not custom_formats["pep517-backend-reference"](data__buildsystem__buildbackend): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.build-backend must be pep517-backend-reference", value=data__buildsystem__buildbackend, name="" + (name_prefix or "data") + ".build-system.build-backend", definition={'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, rule='format') if "backend-path" in data__buildsystem_keys: data__buildsystem_keys.remove("backend-path") data__buildsystem__backendpath = data__buildsystem["backend-path"] if not isinstance(data__buildsystem__backendpath, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.backend-path must be array", value=data__buildsystem__backendpath, name="" + (name_prefix or "data") + ".build-system.backend-path", definition={'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}, rule='type') data__buildsystem__backendpath_is_list = isinstance(data__buildsystem__backendpath, (list, tuple)) if data__buildsystem__backendpath_is_list: data__buildsystem__backendpath_len = len(data__buildsystem__backendpath) for data__buildsystem__backendpath_x, data__buildsystem__backendpath_item in enumerate(data__buildsystem__backendpath): if not isinstance(data__buildsystem__backendpath_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.backend-path[{data__buildsystem__backendpath_x}]".format(**locals()) + " must be string", value=data__buildsystem__backendpath_item, name="" + (name_prefix or "data") + ".build-system.backend-path[{data__buildsystem__backendpath_x}]".format(**locals()) + "", definition={'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}, rule='type') if data__buildsystem_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must not contain "+str(data__buildsystem_keys)+" properties", value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='additionalProperties') if "project" in data_keys: data_keys.remove("project") data__project = data["project"] validate_https___packaging_python_org_en_latest_specifications_pyproject_toml(data__project, custom_formats, (name_prefix or "data") + ".project") if "tool" in data_keys: data_keys.remove("tool") data__tool = data["tool"] if not isinstance(data__tool, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".tool must be object", value=data__tool, name="" + (name_prefix or "data") + ".tool", definition={'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.', 'See also `the old Python docs <https://docs.python.org/3.11/install/>_`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '<https://setuptools.pypa.io/en/latest/references/keywords.html>`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, rule='type') data__tool_is_dict = isinstance(data__tool, dict) if data__tool_is_dict: data__tool_keys = set(data__tool.keys()) if "distutils" in data__tool_keys: data__tool_keys.remove("distutils") data__tool__distutils = data__tool["distutils"] validate_https___setuptools_pypa_io_en_latest_deprecated_distutils_configfile_html(data__tool__distutils, custom_formats, (name_prefix or "data") + ".tool.distutils") if "setuptools" in data__tool_keys: data__tool_keys.remove("setuptools") data__tool__setuptools = data__tool["setuptools"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html(data__tool__setuptools, custom_formats, (name_prefix or "data") + ".tool.setuptools") if "dependency-groups" in data_keys: data_keys.remove("dependency-groups") data__dependencygroups = data["dependency-groups"] if not isinstance(data__dependencygroups, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups must be object", value=data__dependencygroups, name="" + (name_prefix or "data") + ".dependency-groups", definition={'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}, rule='type') data__dependencygroups_is_dict = isinstance(data__dependencygroups, dict) if data__dependencygroups_is_dict: data__dependencygroups_keys = set(data__dependencygroups.keys()) for data__dependencygroups_key, data__dependencygroups_val in data__dependencygroups.items(): if REGEX_PATTERNS['^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'].search(data__dependencygroups_key): if data__dependencygroups_key in data__dependencygroups_keys: data__dependencygroups_keys.remove(data__dependencygroups_key) if not isinstance(data__dependencygroups_val, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}".format(**locals()) + " must be array", value=data__dependencygroups_val, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}, rule='type') data__dependencygroups_val_is_list = isinstance(data__dependencygroups_val, (list, tuple)) if data__dependencygroups_val_is_list: data__dependencygroups_val_len = len(data__dependencygroups_val) for data__dependencygroups_val_x, data__dependencygroups_val_item in enumerate(data__dependencygroups_val): data__dependencygroups_val_item_one_of_count1 = 0 if data__dependencygroups_val_item_one_of_count1 < 2: try: if not isinstance(data__dependencygroups_val_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be string", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, rule='type') if isinstance(data__dependencygroups_val_item, str): if not custom_formats["pep508"](data__dependencygroups_val_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be pep508", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, rule='format') data__dependencygroups_val_item_one_of_count1 += 1 except JsonSchemaValueException: pass if data__dependencygroups_val_item_one_of_count1 < 2: try: if not isinstance(data__dependencygroups_val_item, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be object", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}, rule='type') data__dependencygroups_val_item_is_dict = isinstance(data__dependencygroups_val_item, dict) if data__dependencygroups_val_item_is_dict: data__dependencygroups_val_item_keys = set(data__dependencygroups_val_item.keys()) if "include-group" in data__dependencygroups_val_item_keys: data__dependencygroups_val_item_keys.remove("include-group") data__dependencygroups_val_item__includegroup = data__dependencygroups_val_item["include-group"] if not isinstance(data__dependencygroups_val_item__includegroup, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + " must be string", value=data__dependencygroups_val_item__includegroup, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + "", definition={'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}, rule='type') if isinstance(data__dependencygroups_val_item__includegroup, str): if not REGEX_PATTERNS['^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'].search(data__dependencygroups_val_item__includegroup): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + " must match pattern ^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$", value=data__dependencygroups_val_item__includegroup, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + "", definition={'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}, rule='pattern') if data__dependencygroups_val_item_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must not contain "+str(data__dependencygroups_val_item_keys)+" properties", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}, rule='additionalProperties') data__dependencygroups_val_item_one_of_count1 += 1 except JsonSchemaValueException: pass if data__dependencygroups_val_item_one_of_count1 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be valid exactly by one definition" + (" (" + str(data__dependencygroups_val_item_one_of_count1) + " matches found)"), value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}, rule='oneOf') if data__dependencygroups_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups must not contain "+str(data__dependencygroups_keys)+" properties", value=data__dependencygroups, name="" + (name_prefix or "data") + ".dependency-groups", definition={'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}, rule='additionalProperties') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/declaring-build-dependencies/', 'title': 'Data structure for ``pyproject.toml`` files', '$$description': ['File format containing build-time configurations for the Python ecosystem. ', ':pep:`517` initially defined a build-system independent format for source trees', 'which was complemented by :pep:`518` to provide a way of specifying dependencies ', 'for building Python projects.', 'Please notice the ``project`` table (as initially defined in :pep:`621`) is not included', 'in this schema and should be considered separately.'], 'type': 'object', 'additionalProperties': False, 'properties': {'build-system': {'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, 'tool': {'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.', 'See also `the old Python docs <https://docs.python.org/3.11/install/>_`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '<https://setuptools.pypa.io/en/latest/references/keywords.html>`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, 'dependency-groups': {'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points <https://packaging.python.org/specifications/entry-points/>`_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '<https://setuptools.pypa.io/en/latest/references/keywords.html>`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "platforms" in data_keys: data_keys.remove("platforms") data__platforms = data["platforms"] if not isinstance(data__platforms, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".platforms must be array", value=data__platforms, name="" + (name_prefix or "data") + ".platforms", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__platforms_is_list = isinstance(data__platforms, (list, tuple)) if data__platforms_is_list: data__platforms_len = len(data__platforms) for data__platforms_x, data__platforms_item in enumerate(data__platforms): if not isinstance(data__platforms_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".platforms[{data__platforms_x}]".format(**locals()) + " must be string", value=data__platforms_item, name="" + (name_prefix or "data") + ".platforms[{data__platforms_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "provides" in data_keys: data_keys.remove("provides") data__provides = data["provides"] if not isinstance(data__provides, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides must be array", value=data__provides, name="" + (name_prefix or "data") + ".provides", definition={'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, rule='type') data__provides_is_list = isinstance(data__provides, (list, tuple)) if data__provides_is_list: data__provides_len = len(data__provides) for data__provides_x, data__provides_item in enumerate(data__provides): if not isinstance(data__provides_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + " must be string", value=data__provides_item, name="" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') if isinstance(data__provides_item, str): if not custom_formats["pep508-identifier"](data__provides_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + " must be pep508-identifier", value=data__provides_item, name="" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') if "obsoletes" in data_keys: data_keys.remove("obsoletes") data__obsoletes = data["obsoletes"] if not isinstance(data__obsoletes, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes must be array", value=data__obsoletes, name="" + (name_prefix or "data") + ".obsoletes", definition={'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, rule='type') data__obsoletes_is_list = isinstance(data__obsoletes, (list, tuple)) if data__obsoletes_is_list: data__obsoletes_len = len(data__obsoletes) for data__obsoletes_x, data__obsoletes_item in enumerate(data__obsoletes): if not isinstance(data__obsoletes_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + " must be string", value=data__obsoletes_item, name="" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') if isinstance(data__obsoletes_item, str): if not custom_formats["pep508-identifier"](data__obsoletes_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + " must be pep508-identifier", value=data__obsoletes_item, name="" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') if "zip-safe" in data_keys: data_keys.remove("zip-safe") data__zipsafe = data["zip-safe"] if not isinstance(data__zipsafe, (bool)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".zip-safe must be boolean", value=data__zipsafe, name="" + (name_prefix or "data") + ".zip-safe", definition={'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, rule='type') if "script-files" in data_keys: data_keys.remove("script-files") data__scriptfiles = data["script-files"] if not isinstance(data__scriptfiles, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".script-files must be array", value=data__scriptfiles, name="" + (name_prefix or "data") + ".script-files", definition={'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, rule='type') data__scriptfiles_is_list = isinstance(data__scriptfiles, (list, tuple)) if data__scriptfiles_is_list: data__scriptfiles_len = len(data__scriptfiles) for data__scriptfiles_x, data__scriptfiles_item in enumerate(data__scriptfiles): if not isinstance(data__scriptfiles_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".script-files[{data__scriptfiles_x}]".format(**locals()) + " must be string", value=data__scriptfiles_item, name="" + (name_prefix or "data") + ".script-files[{data__scriptfiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "eager-resources" in data_keys: data_keys.remove("eager-resources") data__eagerresources = data["eager-resources"] if not isinstance(data__eagerresources, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".eager-resources must be array", value=data__eagerresources, name="" + (name_prefix or "data") + ".eager-resources", definition={'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, rule='type') data__eagerresources_is_list = isinstance(data__eagerresources, (list, tuple)) if data__eagerresources_is_list: data__eagerresources_len = len(data__eagerresources) for data__eagerresources_x, data__eagerresources_item in enumerate(data__eagerresources): if not isinstance(data__eagerresources_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".eager-resources[{data__eagerresources_x}]".format(**locals()) + " must be string", value=data__eagerresources_item, name="" + (name_prefix or "data") + ".eager-resources[{data__eagerresources_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "packages" in data_keys: data_keys.remove("packages") data__packages = data["packages"] data__packages_one_of_count2 = 0 if data__packages_one_of_count2 < 2: try: if not isinstance(data__packages, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".packages must be array", value=data__packages, name="" + (name_prefix or "data") + ".packages", definition={'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, rule='type') data__packages_is_list = isinstance(data__packages, (list, tuple)) if data__packages_is_list: data__packages_len = len(data__packages) for data__packages_x, data__packages_item in enumerate(data__packages): validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data__packages_item, custom_formats, (name_prefix or "data") + ".packages[{data__packages_x}]".format(**locals())) data__packages_one_of_count2 += 1 except JsonSchemaValueException: pass if data__packages_one_of_count2 < 2: try: validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_find_directive(data__packages, custom_formats, (name_prefix or "data") + ".packages") data__packages_one_of_count2 += 1 except JsonSchemaValueException: pass if data__packages_one_of_count2 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".packages must be valid exactly by one definition" + (" (" + str(data__packages_one_of_count2) + " matches found)"), value=data__packages, name="" + (name_prefix or "data") + ".packages", definition={'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, rule='oneOf') if "package-dir" in data_keys: data_keys.remove("package-dir") data__packagedir = data["package-dir"] if not isinstance(data__packagedir, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be object", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='type') data__packagedir_is_dict = isinstance(data__packagedir, dict) if data__packagedir_is_dict: data__packagedir_keys = set(data__packagedir.keys()) for data__packagedir_key, data__packagedir_val in data__packagedir.items(): if REGEX_PATTERNS['^.*$'].search(data__packagedir_key): if data__packagedir_key in data__packagedir_keys: data__packagedir_keys.remove(data__packagedir_key) if not isinstance(data__packagedir_val, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir.{data__packagedir_key}".format(**locals()) + " must be string", value=data__packagedir_val, name="" + (name_prefix or "data") + ".package-dir.{data__packagedir_key}".format(**locals()) + "", definition={'type': 'string'}, rule='type') if data__packagedir_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must not contain "+str(data__packagedir_keys)+" properties", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='additionalProperties') data__packagedir_len = len(data__packagedir) if data__packagedir_len != 0: data__packagedir_property_names = True for data__packagedir_key in data__packagedir: try: data__packagedir_key_any_of_count3 = 0 if not data__packagedir_key_any_of_count3: try: if data__packagedir_key != "": raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be same as const definition: ", value=data__packagedir_key, name="" + (name_prefix or "data") + ".package-dir", definition={'const': ''}, rule='const') data__packagedir_key_any_of_count3 += 1 except JsonSchemaValueException: pass if not data__packagedir_key_any_of_count3: try: validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data__packagedir_key, custom_formats, (name_prefix or "data") + ".package-dir") data__packagedir_key_any_of_count3 += 1 except JsonSchemaValueException: pass if not data__packagedir_key_any_of_count3: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir cannot be validated by any definition", value=data__packagedir_key, name="" + (name_prefix or "data") + ".package-dir", definition={'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, rule='anyOf') except JsonSchemaValueException: data__packagedir_property_names = False if not data__packagedir_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be named by propertyName definition", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='propertyNames') if "package-data" in data_keys: data_keys.remove("package-data") data__packagedata = data["package-data"] if not isinstance(data__packagedata, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be object", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') data__packagedata_is_dict = isinstance(data__packagedata, dict) if data__packagedata_is_dict: data__packagedata_keys = set(data__packagedata.keys()) for data__packagedata_key, data__packagedata_val in data__packagedata.items(): if REGEX_PATTERNS['^.*$'].search(data__packagedata_key): if data__packagedata_key in data__packagedata_keys: data__packagedata_keys.remove(data__packagedata_key) if not isinstance(data__packagedata_val, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data.{data__packagedata_key}".format(**locals()) + " must be array", value=data__packagedata_val, name="" + (name_prefix or "data") + ".package-data.{data__packagedata_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__packagedata_val_is_list = isinstance(data__packagedata_val, (list, tuple)) if data__packagedata_val_is_list: data__packagedata_val_len = len(data__packagedata_val) for data__packagedata_val_x, data__packagedata_val_item in enumerate(data__packagedata_val): if not isinstance(data__packagedata_val_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data.{data__packagedata_key}[{data__packagedata_val_x}]".format(**locals()) + " must be string", value=data__packagedata_val_item, name="" + (name_prefix or "data") + ".package-data.{data__packagedata_key}[{data__packagedata_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if data__packagedata_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must not contain "+str(data__packagedata_keys)+" properties", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='additionalProperties') data__packagedata_len = len(data__packagedata) if data__packagedata_len != 0: data__packagedata_property_names = True for data__packagedata_key in data__packagedata: try: data__packagedata_key_any_of_count4 = 0 if not data__packagedata_key_any_of_count4: try: if not isinstance(data__packagedata_key, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be string", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='type') if isinstance(data__packagedata_key, str): if not custom_formats["python-module-name"](data__packagedata_key): raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be python-module-name", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='format') data__packagedata_key_any_of_count4 += 1 except JsonSchemaValueException: pass if not data__packagedata_key_any_of_count4: try: if data__packagedata_key != "*": raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be same as const definition: *", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'const': '*'}, rule='const') data__packagedata_key_any_of_count4 += 1 except JsonSchemaValueException: pass if not data__packagedata_key_any_of_count4: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data cannot be validated by any definition", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, rule='anyOf') except JsonSchemaValueException: data__packagedata_property_names = False if not data__packagedata_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be named by propertyName definition", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='propertyNames') if "include-package-data" in data_keys: data_keys.remove("include-package-data") data__includepackagedata = data["include-package-data"] if not isinstance(data__includepackagedata, (bool)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-package-data must be boolean", value=data__includepackagedata, name="" + (name_prefix or "data") + ".include-package-data", definition={'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, rule='type') if "exclude-package-data" in data_keys: data_keys.remove("exclude-package-data") data__excludepackagedata = data["exclude-package-data"] if not isinstance(data__excludepackagedata, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be object", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') data__excludepackagedata_is_dict = isinstance(data__excludepackagedata, dict) if data__excludepackagedata_is_dict: data__excludepackagedata_keys = set(data__excludepackagedata.keys()) for data__excludepackagedata_key, data__excludepackagedata_val in data__excludepackagedata.items(): if REGEX_PATTERNS['^.*$'].search(data__excludepackagedata_key): if data__excludepackagedata_key in data__excludepackagedata_keys: data__excludepackagedata_keys.remove(data__excludepackagedata_key) if not isinstance(data__excludepackagedata_val, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}".format(**locals()) + " must be array", value=data__excludepackagedata_val, name="" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__excludepackagedata_val_is_list = isinstance(data__excludepackagedata_val, (list, tuple)) if data__excludepackagedata_val_is_list: data__excludepackagedata_val_len = len(data__excludepackagedata_val) for data__excludepackagedata_val_x, data__excludepackagedata_val_item in enumerate(data__excludepackagedata_val): if not isinstance(data__excludepackagedata_val_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}[{data__excludepackagedata_val_x}]".format(**locals()) + " must be string", value=data__excludepackagedata_val_item, name="" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}[{data__excludepackagedata_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if data__excludepackagedata_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must not contain "+str(data__excludepackagedata_keys)+" properties", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='additionalProperties') data__excludepackagedata_len = len(data__excludepackagedata) if data__excludepackagedata_len != 0: data__excludepackagedata_property_names = True for data__excludepackagedata_key in data__excludepackagedata: try: data__excludepackagedata_key_any_of_count5 = 0 if not data__excludepackagedata_key_any_of_count5: try: if not isinstance(data__excludepackagedata_key, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be string", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='type') if isinstance(data__excludepackagedata_key, str): if not custom_formats["python-module-name"](data__excludepackagedata_key): raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be python-module-name", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='format') data__excludepackagedata_key_any_of_count5 += 1 except JsonSchemaValueException: pass if not data__excludepackagedata_key_any_of_count5: try: if data__excludepackagedata_key != "*": raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be same as const definition: *", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'const': '*'}, rule='const') data__excludepackagedata_key_any_of_count5 += 1 except JsonSchemaValueException: pass if not data__excludepackagedata_key_any_of_count5: raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data cannot be validated by any definition", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, rule='anyOf') except JsonSchemaValueException: data__excludepackagedata_property_names = False if not data__excludepackagedata_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be named by propertyName definition", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='propertyNames') if "namespace-packages" in data_keys: data_keys.remove("namespace-packages") data__namespacepackages = data["namespace-packages"] if not isinstance(data__namespacepackages, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages must be array", value=data__namespacepackages, name="" + (name_prefix or "data") + ".namespace-packages", definition={'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, rule='type') data__namespacepackages_is_list = isinstance(data__namespacepackages, (list, tuple)) if data__namespacepackages_is_list: data__namespacepackages_len = len(data__namespacepackages) for data__namespacepackages_x, data__namespacepackages_item in enumerate(data__namespacepackages): if not isinstance(data__namespacepackages_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + " must be string", value=data__namespacepackages_item, name="" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') if isinstance(data__namespacepackages_item, str): if not custom_formats["python-module-name-relaxed"](data__namespacepackages_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + " must be python-module-name-relaxed", value=data__namespacepackages_item, name="" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') if "py-modules" in data_keys: data_keys.remove("py-modules") data__pymodules = data["py-modules"] if not isinstance(data__pymodules, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules must be array", value=data__pymodules, name="" + (name_prefix or "data") + ".py-modules", definition={'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, rule='type') data__pymodules_is_list = isinstance(data__pymodules, (list, tuple)) if data__pymodules_is_list: data__pymodules_len = len(data__pymodules) for data__pymodules_x, data__pymodules_item in enumerate(data__pymodules): if not isinstance(data__pymodules_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + " must be string", value=data__pymodules_item, name="" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') if isinstance(data__pymodules_item, str): if not custom_formats["python-module-name-relaxed"](data__pymodules_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + " must be python-module-name-relaxed", value=data__pymodules_item, name="" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') if "ext-modules" in data_keys: data_keys.remove("ext-modules") data__extmodules = data["ext-modules"] if not isinstance(data__extmodules, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".ext-modules must be array", value=data__extmodules, name="" + (name_prefix or "data") + ".ext-modules", definition={'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, rule='type') data__extmodules_is_list = isinstance(data__extmodules, (list, tuple)) if data__extmodules_is_list: data__extmodules_len = len(data__extmodules) for data__extmodules_x, data__extmodules_item in enumerate(data__extmodules): validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_ext_module(data__extmodules_item, custom_formats, (name_prefix or "data") + ".ext-modules[{data__extmodules_x}]".format(**locals())) if "data-files" in data_keys: data_keys.remove("data-files") data__datafiles = data["data-files"] if not isinstance(data__datafiles, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files must be object", value=data__datafiles, name="" + (name_prefix or "data") + ".data-files", definition={'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') data__datafiles_is_dict = isinstance(data__datafiles, dict) if data__datafiles_is_dict: data__datafiles_keys = set(data__datafiles.keys()) for data__datafiles_key, data__datafiles_val in data__datafiles.items(): if REGEX_PATTERNS['^.*$'].search(data__datafiles_key): if data__datafiles_key in data__datafiles_keys: data__datafiles_keys.remove(data__datafiles_key) if not isinstance(data__datafiles_val, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files.{data__datafiles_key}".format(**locals()) + " must be array", value=data__datafiles_val, name="" + (name_prefix or "data") + ".data-files.{data__datafiles_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__datafiles_val_is_list = isinstance(data__datafiles_val, (list, tuple)) if data__datafiles_val_is_list: data__datafiles_val_len = len(data__datafiles_val) for data__datafiles_val_x, data__datafiles_val_item in enumerate(data__datafiles_val): if not isinstance(data__datafiles_val_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files.{data__datafiles_key}[{data__datafiles_val_x}]".format(**locals()) + " must be string", value=data__datafiles_val_item, name="" + (name_prefix or "data") + ".data-files.{data__datafiles_key}[{data__datafiles_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "cmdclass" in data_keys: data_keys.remove("cmdclass") data__cmdclass = data["cmdclass"] if not isinstance(data__cmdclass, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass must be object", value=data__cmdclass, name="" + (name_prefix or "data") + ".cmdclass", definition={'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, rule='type') data__cmdclass_is_dict = isinstance(data__cmdclass, dict) if data__cmdclass_is_dict: data__cmdclass_keys = set(data__cmdclass.keys()) for data__cmdclass_key, data__cmdclass_val in data__cmdclass.items(): if REGEX_PATTERNS['^.*$'].search(data__cmdclass_key): if data__cmdclass_key in data__cmdclass_keys: data__cmdclass_keys.remove(data__cmdclass_key) if not isinstance(data__cmdclass_val, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + " must be string", value=data__cmdclass_val, name="" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='type') if isinstance(data__cmdclass_val, str): if not custom_formats["python-qualified-identifier"](data__cmdclass_val): raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + " must be python-qualified-identifier", value=data__cmdclass_val, name="" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='format') if "license-files" in data_keys: data_keys.remove("license-files") data__licensefiles = data["license-files"] if not isinstance(data__licensefiles, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files must be array", value=data__licensefiles, name="" + (name_prefix or "data") + ".license-files", definition={'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, rule='type') data__licensefiles_is_list = isinstance(data__licensefiles, (list, tuple)) if data__licensefiles_is_list: data__licensefiles_len = len(data__licensefiles) for data__licensefiles_x, data__licensefiles_item in enumerate(data__licensefiles): if not isinstance(data__licensefiles_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + " must be string", value=data__licensefiles_item, name="" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "dynamic" in data_keys: data_keys.remove("dynamic") data__dynamic = data["dynamic"] if not isinstance(data__dynamic, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be object", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}, rule='type') data__dynamic_is_dict = isinstance(data__dynamic, dict) if data__dynamic_is_dict: data__dynamic_keys = set(data__dynamic.keys()) if "version" in data__dynamic_keys: data__dynamic_keys.remove("version") data__dynamic__version = data__dynamic["version"] data__dynamic__version_one_of_count6 = 0 if data__dynamic__version_one_of_count6 < 2: try: validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_attr_directive(data__dynamic__version, custom_formats, (name_prefix or "data") + ".dynamic.version") data__dynamic__version_one_of_count6 += 1 except JsonSchemaValueException: pass if data__dynamic__version_one_of_count6 < 2: try: validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__version, custom_formats, (name_prefix or "data") + ".dynamic.version") data__dynamic__version_one_of_count6 += 1 except JsonSchemaValueException: pass if data__dynamic__version_one_of_count6 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.version must be valid exactly by one definition" + (" (" + str(data__dynamic__version_one_of_count6) + " matches found)"), value=data__dynamic__version, name="" + (name_prefix or "data") + ".dynamic.version", definition={'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, rule='oneOf') if "classifiers" in data__dynamic_keys: data__dynamic_keys.remove("classifiers") data__dynamic__classifiers = data__dynamic["classifiers"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__classifiers, custom_formats, (name_prefix or "data") + ".dynamic.classifiers") if "description" in data__dynamic_keys: data__dynamic_keys.remove("description") data__dynamic__description = data__dynamic["description"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__description, custom_formats, (name_prefix or "data") + ".dynamic.description") if "entry-points" in data__dynamic_keys: data__dynamic_keys.remove("entry-points") data__dynamic__entrypoints = data__dynamic["entry-points"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__entrypoints, custom_formats, (name_prefix or "data") + ".dynamic.entry-points") if "dependencies" in data__dynamic_keys: data__dynamic_keys.remove("dependencies") data__dynamic__dependencies = data__dynamic["dependencies"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data__dynamic__dependencies, custom_formats, (name_prefix or "data") + ".dynamic.dependencies") if "optional-dependencies" in data__dynamic_keys: data__dynamic_keys.remove("optional-dependencies") data__dynamic__optionaldependencies = data__dynamic["optional-dependencies"] if not isinstance(data__dynamic__optionaldependencies, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be object", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='type') data__dynamic__optionaldependencies_is_dict = isinstance(data__dynamic__optionaldependencies, dict) if data__dynamic__optionaldependencies_is_dict: data__dynamic__optionaldependencies_keys = set(data__dynamic__optionaldependencies.keys()) for data__dynamic__optionaldependencies_key, data__dynamic__optionaldependencies_val in data__dynamic__optionaldependencies.items(): if REGEX_PATTERNS['.+'].search(data__dynamic__optionaldependencies_key): if data__dynamic__optionaldependencies_key in data__dynamic__optionaldependencies_keys: data__dynamic__optionaldependencies_keys.remove(data__dynamic__optionaldependencies_key) validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data__dynamic__optionaldependencies_val, custom_formats, (name_prefix or "data") + ".dynamic.optional-dependencies.{data__dynamic__optionaldependencies_key}".format(**locals())) if data__dynamic__optionaldependencies_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must not contain "+str(data__dynamic__optionaldependencies_keys)+" properties", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='additionalProperties') data__dynamic__optionaldependencies_len = len(data__dynamic__optionaldependencies) if data__dynamic__optionaldependencies_len != 0: data__dynamic__optionaldependencies_property_names = True for data__dynamic__optionaldependencies_key in data__dynamic__optionaldependencies: try: if not isinstance(data__dynamic__optionaldependencies_key, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be string", value=data__dynamic__optionaldependencies_key, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') if isinstance(data__dynamic__optionaldependencies_key, str): if not custom_formats["pep508-identifier"](data__dynamic__optionaldependencies_key): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be pep508-identifier", value=data__dynamic__optionaldependencies_key, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') except JsonSchemaValueException: data__dynamic__optionaldependencies_property_names = False if not data__dynamic__optionaldependencies_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be named by propertyName definition", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='propertyNames') if "readme" in data__dynamic_keys: data__dynamic_keys.remove("readme") data__dynamic__readme = data__dynamic["readme"] if not isinstance(data__dynamic__readme, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must be object", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='type') data__dynamic__readme_any_of_count7 = 0 if not data__dynamic__readme_any_of_count7: try: validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__readme, custom_formats, (name_prefix or "data") + ".dynamic.readme") data__dynamic__readme_any_of_count7 += 1 except JsonSchemaValueException: pass if not data__dynamic__readme_any_of_count7: try: if not isinstance(data__dynamic__readme, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must be object", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}, rule='type') data__dynamic__readme_is_dict = isinstance(data__dynamic__readme, dict) if data__dynamic__readme_is_dict: data__dynamic__readme_keys = set(data__dynamic__readme.keys()) if "content-type" in data__dynamic__readme_keys: data__dynamic__readme_keys.remove("content-type") data__dynamic__readme__contenttype = data__dynamic__readme["content-type"] if not isinstance(data__dynamic__readme__contenttype, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme.content-type must be string", value=data__dynamic__readme__contenttype, name="" + (name_prefix or "data") + ".dynamic.readme.content-type", definition={'type': 'string'}, rule='type') if "file" in data__dynamic__readme_keys: data__dynamic__readme_keys.remove("file") data__dynamic__readme__file = data__dynamic__readme["file"] validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_properties_file(data__dynamic__readme__file, custom_formats, (name_prefix or "data") + ".dynamic.readme.file") if data__dynamic__readme_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must not contain "+str(data__dynamic__readme_keys)+" properties", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}, rule='additionalProperties') data__dynamic__readme_any_of_count7 += 1 except JsonSchemaValueException: pass if not data__dynamic__readme_any_of_count7: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme cannot be validated by any definition", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='anyOf') data__dynamic__readme_is_dict = isinstance(data__dynamic__readme, dict) if data__dynamic__readme_is_dict: data__dynamic__readme__missing_keys = set(['file']) - data__dynamic__readme.keys() if data__dynamic__readme__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must contain " + (str(sorted(data__dynamic__readme__missing_keys)) + " properties"), value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='required') if data__dynamic_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must not contain "+str(data__dynamic_keys)+" properties", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}, rule='additionalProperties') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '<https://setuptools.pypa.io/en/latest/references/keywords.html>`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#setuptools-specific-configuration>`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '<https://setuptools.pypa.io/en/latest/userguide/datafiles.html>`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '<https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html#dynamic-metadata>`_.']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_properties_file(data, custom_formats={}, name_prefix=None): data_one_of_count8 = 0 if data_one_of_count8 < 2: try: if not isinstance(data, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string'}, rule='type') data_one_of_count8 += 1 except JsonSchemaValueException: pass if data_one_of_count8 < 2: try: if not isinstance(data, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be array", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data_is_list = isinstance(data, (list, tuple)) if data_is_list: data_len = len(data) for data_x, data_item in enumerate(data): if not isinstance(data_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + "[{data_x}]".format(**locals()) + " must be string", value=data_item, name="" + (name_prefix or "data") + "[{data_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') data_one_of_count8 += 1 except JsonSchemaValueException: pass if data_one_of_count8 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + " must be valid exactly by one definition" + (" (" + str(data_one_of_count8) + " matches found)"), value=data, name="" + (name_prefix or "data") + "", definition={'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, rule='oneOf') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data, custom_formats={}, name_prefix=None): validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data, custom_formats, (name_prefix or "data") + "") return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['file']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='required') data_keys = set(data.keys()) if "file" in data_keys: data_keys.remove("file") data__file = data["file"] data__file_one_of_count9 = 0 if data__file_one_of_count9 < 2: try: if not isinstance(data__file, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be string", value=data__file, name="" + (name_prefix or "data") + ".file", definition={'type': 'string'}, rule='type') data__file_one_of_count9 += 1 except JsonSchemaValueException: pass if data__file_one_of_count9 < 2: try: if not isinstance(data__file, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be array", value=data__file, name="" + (name_prefix or "data") + ".file", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__file_is_list = isinstance(data__file, (list, tuple)) if data__file_is_list: data__file_len = len(data__file) for data__file_x, data__file_item in enumerate(data__file): if not isinstance(data__file_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".file[{data__file_x}]".format(**locals()) + " must be string", value=data__file_item, name="" + (name_prefix or "data") + ".file[{data__file_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') data__file_one_of_count9 += 1 except JsonSchemaValueException: pass if data__file_one_of_count9 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be valid exactly by one definition" + (" (" + str(data__file_one_of_count9) + " matches found)"), value=data__file, name="" + (name_prefix or "data") + ".file", definition={'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, rule='oneOf') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_attr_directive(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['attr']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='required') data_keys = set(data.keys()) if "attr" in data_keys: data_keys.remove("attr") data__attr = data["attr"] if not isinstance(data__attr, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".attr must be string", value=data__attr, name="" + (name_prefix or "data") + ".attr", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='type') if isinstance(data__attr, str): if not custom_formats["python-qualified-identifier"](data__attr): raise JsonSchemaValueException("" + (name_prefix or "data") + ".attr must be python-qualified-identifier", value=data__attr, name="" + (name_prefix or "data") + ".attr", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='format') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_ext_module(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['name', 'sources']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='required') data_keys = set(data.keys()) if "name" in data_keys: data_keys.remove("name") data__name = data["name"] if not isinstance(data__name, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') if isinstance(data__name, str): if not custom_formats["python-module-name-relaxed"](data__name): raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be python-module-name-relaxed", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') if "sources" in data_keys: data_keys.remove("sources") data__sources = data["sources"] if not isinstance(data__sources, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".sources must be array", value=data__sources, name="" + (name_prefix or "data") + ".sources", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__sources_is_list = isinstance(data__sources, (list, tuple)) if data__sources_is_list: data__sources_len = len(data__sources) for data__sources_x, data__sources_item in enumerate(data__sources): if not isinstance(data__sources_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".sources[{data__sources_x}]".format(**locals()) + " must be string", value=data__sources_item, name="" + (name_prefix or "data") + ".sources[{data__sources_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "include-dirs" in data_keys: data_keys.remove("include-dirs") data__includedirs = data["include-dirs"] if not isinstance(data__includedirs, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-dirs must be array", value=data__includedirs, name="" + (name_prefix or "data") + ".include-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__includedirs_is_list = isinstance(data__includedirs, (list, tuple)) if data__includedirs_is_list: data__includedirs_len = len(data__includedirs) for data__includedirs_x, data__includedirs_item in enumerate(data__includedirs): if not isinstance(data__includedirs_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-dirs[{data__includedirs_x}]".format(**locals()) + " must be string", value=data__includedirs_item, name="" + (name_prefix or "data") + ".include-dirs[{data__includedirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "define-macros" in data_keys: data_keys.remove("define-macros") data__definemacros = data["define-macros"] if not isinstance(data__definemacros, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros must be array", value=data__definemacros, name="" + (name_prefix or "data") + ".define-macros", definition={'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, rule='type') data__definemacros_is_list = isinstance(data__definemacros, (list, tuple)) if data__definemacros_is_list: data__definemacros_len = len(data__definemacros) for data__definemacros_x, data__definemacros_item in enumerate(data__definemacros): if not isinstance(data__definemacros_item, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + " must be array", value=data__definemacros_item, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + "", definition={'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}, rule='type') data__definemacros_item_is_list = isinstance(data__definemacros_item, (list, tuple)) if data__definemacros_item_is_list: data__definemacros_item_len = len(data__definemacros_item) if data__definemacros_item_len > 0: data__definemacros_item__0 = data__definemacros_item[0] if not isinstance(data__definemacros_item__0, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][0]".format(**locals()) + " must be string", value=data__definemacros_item__0, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][0]".format(**locals()) + "", definition={'description': 'macro name', 'type': 'string'}, rule='type') if data__definemacros_item_len > 1: data__definemacros_item__1 = data__definemacros_item[1] data__definemacros_item__1_one_of_count10 = 0 if data__definemacros_item__1_one_of_count10 < 2: try: if not isinstance(data__definemacros_item__1, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be string", value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'type': 'string'}, rule='type') data__definemacros_item__1_one_of_count10 += 1 except JsonSchemaValueException: pass if data__definemacros_item__1_one_of_count10 < 2: try: if not isinstance(data__definemacros_item__1, (NoneType)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be null", value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'type': 'null'}, rule='type') data__definemacros_item__1_one_of_count10 += 1 except JsonSchemaValueException: pass if data__definemacros_item__1_one_of_count10 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be valid exactly by one definition" + (" (" + str(data__definemacros_item__1_one_of_count10) + " matches found)"), value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}, rule='oneOf') if data__definemacros_item_len > 2: raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + " must contain only specified items", value=data__definemacros_item, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + "", definition={'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}, rule='items') if "undef-macros" in data_keys: data_keys.remove("undef-macros") data__undefmacros = data["undef-macros"] if not isinstance(data__undefmacros, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".undef-macros must be array", value=data__undefmacros, name="" + (name_prefix or "data") + ".undef-macros", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__undefmacros_is_list = isinstance(data__undefmacros, (list, tuple)) if data__undefmacros_is_list: data__undefmacros_len = len(data__undefmacros) for data__undefmacros_x, data__undefmacros_item in enumerate(data__undefmacros): if not isinstance(data__undefmacros_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".undef-macros[{data__undefmacros_x}]".format(**locals()) + " must be string", value=data__undefmacros_item, name="" + (name_prefix or "data") + ".undef-macros[{data__undefmacros_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "library-dirs" in data_keys: data_keys.remove("library-dirs") data__librarydirs = data["library-dirs"] if not isinstance(data__librarydirs, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".library-dirs must be array", value=data__librarydirs, name="" + (name_prefix or "data") + ".library-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__librarydirs_is_list = isinstance(data__librarydirs, (list, tuple)) if data__librarydirs_is_list: data__librarydirs_len = len(data__librarydirs) for data__librarydirs_x, data__librarydirs_item in enumerate(data__librarydirs): if not isinstance(data__librarydirs_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".library-dirs[{data__librarydirs_x}]".format(**locals()) + " must be string", value=data__librarydirs_item, name="" + (name_prefix or "data") + ".library-dirs[{data__librarydirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "libraries" in data_keys: data_keys.remove("libraries") data__libraries = data["libraries"] if not isinstance(data__libraries, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".libraries must be array", value=data__libraries, name="" + (name_prefix or "data") + ".libraries", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__libraries_is_list = isinstance(data__libraries, (list, tuple)) if data__libraries_is_list: data__libraries_len = len(data__libraries) for data__libraries_x, data__libraries_item in enumerate(data__libraries): if not isinstance(data__libraries_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".libraries[{data__libraries_x}]".format(**locals()) + " must be string", value=data__libraries_item, name="" + (name_prefix or "data") + ".libraries[{data__libraries_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "runtime-library-dirs" in data_keys: data_keys.remove("runtime-library-dirs") data__runtimelibrarydirs = data["runtime-library-dirs"] if not isinstance(data__runtimelibrarydirs, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".runtime-library-dirs must be array", value=data__runtimelibrarydirs, name="" + (name_prefix or "data") + ".runtime-library-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__runtimelibrarydirs_is_list = isinstance(data__runtimelibrarydirs, (list, tuple)) if data__runtimelibrarydirs_is_list: data__runtimelibrarydirs_len = len(data__runtimelibrarydirs) for data__runtimelibrarydirs_x, data__runtimelibrarydirs_item in enumerate(data__runtimelibrarydirs): if not isinstance(data__runtimelibrarydirs_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".runtime-library-dirs[{data__runtimelibrarydirs_x}]".format(**locals()) + " must be string", value=data__runtimelibrarydirs_item, name="" + (name_prefix or "data") + ".runtime-library-dirs[{data__runtimelibrarydirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "extra-objects" in data_keys: data_keys.remove("extra-objects") data__extraobjects = data["extra-objects"] if not isinstance(data__extraobjects, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-objects must be array", value=data__extraobjects, name="" + (name_prefix or "data") + ".extra-objects", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__extraobjects_is_list = isinstance(data__extraobjects, (list, tuple)) if data__extraobjects_is_list: data__extraobjects_len = len(data__extraobjects) for data__extraobjects_x, data__extraobjects_item in enumerate(data__extraobjects): if not isinstance(data__extraobjects_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-objects[{data__extraobjects_x}]".format(**locals()) + " must be string", value=data__extraobjects_item, name="" + (name_prefix or "data") + ".extra-objects[{data__extraobjects_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "extra-compile-args" in data_keys: data_keys.remove("extra-compile-args") data__extracompileargs = data["extra-compile-args"] if not isinstance(data__extracompileargs, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-compile-args must be array", value=data__extracompileargs, name="" + (name_prefix or "data") + ".extra-compile-args", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__extracompileargs_is_list = isinstance(data__extracompileargs, (list, tuple)) if data__extracompileargs_is_list: data__extracompileargs_len = len(data__extracompileargs) for data__extracompileargs_x, data__extracompileargs_item in enumerate(data__extracompileargs): if not isinstance(data__extracompileargs_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-compile-args[{data__extracompileargs_x}]".format(**locals()) + " must be string", value=data__extracompileargs_item, name="" + (name_prefix or "data") + ".extra-compile-args[{data__extracompileargs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "extra-link-args" in data_keys: data_keys.remove("extra-link-args") data__extralinkargs = data["extra-link-args"] if not isinstance(data__extralinkargs, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-link-args must be array", value=data__extralinkargs, name="" + (name_prefix or "data") + ".extra-link-args", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__extralinkargs_is_list = isinstance(data__extralinkargs, (list, tuple)) if data__extralinkargs_is_list: data__extralinkargs_len = len(data__extralinkargs) for data__extralinkargs_x, data__extralinkargs_item in enumerate(data__extralinkargs): if not isinstance(data__extralinkargs_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-link-args[{data__extralinkargs_x}]".format(**locals()) + " must be string", value=data__extralinkargs_item, name="" + (name_prefix or "data") + ".extra-link-args[{data__extralinkargs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "export-symbols" in data_keys: data_keys.remove("export-symbols") data__exportsymbols = data["export-symbols"] if not isinstance(data__exportsymbols, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".export-symbols must be array", value=data__exportsymbols, name="" + (name_prefix or "data") + ".export-symbols", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__exportsymbols_is_list = isinstance(data__exportsymbols, (list, tuple)) if data__exportsymbols_is_list: data__exportsymbols_len = len(data__exportsymbols) for data__exportsymbols_x, data__exportsymbols_item in enumerate(data__exportsymbols): if not isinstance(data__exportsymbols_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".export-symbols[{data__exportsymbols_x}]".format(**locals()) + " must be string", value=data__exportsymbols_item, name="" + (name_prefix or "data") + ".export-symbols[{data__exportsymbols_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "swig-opts" in data_keys: data_keys.remove("swig-opts") data__swigopts = data["swig-opts"] if not isinstance(data__swigopts, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".swig-opts must be array", value=data__swigopts, name="" + (name_prefix or "data") + ".swig-opts", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__swigopts_is_list = isinstance(data__swigopts, (list, tuple)) if data__swigopts_is_list: data__swigopts_len = len(data__swigopts) for data__swigopts_x, data__swigopts_item in enumerate(data__swigopts): if not isinstance(data__swigopts_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".swig-opts[{data__swigopts_x}]".format(**locals()) + " must be string", value=data__swigopts_item, name="" + (name_prefix or "data") + ".swig-opts[{data__swigopts_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "depends" in data_keys: data_keys.remove("depends") data__depends = data["depends"] if not isinstance(data__depends, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".depends must be array", value=data__depends, name="" + (name_prefix or "data") + ".depends", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') data__depends_is_list = isinstance(data__depends, (list, tuple)) if data__depends_is_list: data__depends_len = len(data__depends) for data__depends_x, data__depends_item in enumerate(data__depends): if not isinstance(data__depends_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".depends[{data__depends_x}]".format(**locals()) + " must be string", value=data__depends_item, name="" + (name_prefix or "data") + ".depends[{data__depends_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "language" in data_keys: data_keys.remove("language") data__language = data["language"] if not isinstance(data__language, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".language must be string", value=data__language, name="" + (name_prefix or "data") + ".language", definition={'type': 'string'}, rule='type') if "optional" in data_keys: data_keys.remove("optional") data__optional = data["optional"] if not isinstance(data__optional, (bool)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional must be boolean", value=data__optional, name="" + (name_prefix or "data") + ".optional", definition={'type': 'boolean'}, rule='type') if "py-limited-api" in data_keys: data_keys.remove("py-limited-api") data__pylimitedapi = data["py-limited-api"] if not isinstance(data__pylimitedapi, (bool)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-limited-api must be boolean", value=data__pylimitedapi, name="" + (name_prefix or "data") + ".py-limited-api", definition={'type': 'boolean'}, rule='type') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_find_directive(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "find" in data_keys: data_keys.remove("find") data__find = data["find"] if not isinstance(data__find, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find must be object", value=data__find, name="" + (name_prefix or "data") + ".find", definition={'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}, rule='type') data__find_is_dict = isinstance(data__find, dict) if data__find_is_dict: data__find_keys = set(data__find.keys()) if "where" in data__find_keys: data__find_keys.remove("where") data__find__where = data__find["where"] if not isinstance(data__find__where, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.where must be array", value=data__find__where, name="" + (name_prefix or "data") + ".find.where", definition={'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, rule='type') data__find__where_is_list = isinstance(data__find__where, (list, tuple)) if data__find__where_is_list: data__find__where_len = len(data__find__where) for data__find__where_x, data__find__where_item in enumerate(data__find__where): if not isinstance(data__find__where_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.where[{data__find__where_x}]".format(**locals()) + " must be string", value=data__find__where_item, name="" + (name_prefix or "data") + ".find.where[{data__find__where_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "exclude" in data__find_keys: data__find_keys.remove("exclude") data__find__exclude = data__find["exclude"] if not isinstance(data__find__exclude, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.exclude must be array", value=data__find__exclude, name="" + (name_prefix or "data") + ".find.exclude", definition={'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, rule='type') data__find__exclude_is_list = isinstance(data__find__exclude, (list, tuple)) if data__find__exclude_is_list: data__find__exclude_len = len(data__find__exclude) for data__find__exclude_x, data__find__exclude_item in enumerate(data__find__exclude): if not isinstance(data__find__exclude_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.exclude[{data__find__exclude_x}]".format(**locals()) + " must be string", value=data__find__exclude_item, name="" + (name_prefix or "data") + ".find.exclude[{data__find__exclude_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "include" in data__find_keys: data__find_keys.remove("include") data__find__include = data__find["include"] if not isinstance(data__find__include, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.include must be array", value=data__find__include, name="" + (name_prefix or "data") + ".find.include", definition={'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, rule='type') data__find__include_is_list = isinstance(data__find__include, (list, tuple)) if data__find__include_is_list: data__find__include_len = len(data__find__include) for data__find__include_x, data__find__include_item in enumerate(data__find__include): if not isinstance(data__find__include_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.include[{data__find__include_x}]".format(**locals()) + " must be string", value=data__find__include_item, name="" + (name_prefix or "data") + ".find.include[{data__find__include_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "namespaces" in data__find_keys: data__find_keys.remove("namespaces") data__find__namespaces = data__find["namespaces"] if not isinstance(data__find__namespaces, (bool)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.namespaces must be boolean", value=data__find__namespaces, name="" + (name_prefix or "data") + ".find.namespaces", definition={'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}, rule='type') if data__find_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".find must not contain "+str(data__find_keys)+" properties", value=data__find, name="" + (name_prefix or "data") + ".find", definition={'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}, rule='additionalProperties') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '<https://setuptools.pypa.io/en/latest/userguide/package_discovery.html>`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}, rule='additionalProperties') return data def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data, custom_formats={}, name_prefix=None): if not isinstance(data, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, rule='type') data_any_of_count11 = 0 if not data_any_of_count11: try: if not isinstance(data, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') if isinstance(data, str): if not custom_formats["python-module-name-relaxed"](data): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be python-module-name-relaxed", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') data_any_of_count11 += 1 except JsonSchemaValueException: pass if not data_any_of_count11: try: if not isinstance(data, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'pep561-stub-name'}, rule='type') if isinstance(data, str): if not custom_formats["pep561-stub-name"](data): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be pep561-stub-name", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'pep561-stub-name'}, rule='format') data_any_of_count11 += 1 except JsonSchemaValueException: pass if not data_any_of_count11: raise JsonSchemaValueException("" + (name_prefix or "data") + " cannot be validated by any definition", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, rule='anyOf') return data def validate_https___setuptools_pypa_io_en_latest_deprecated_distutils_configfile_html(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.', 'See also `the old Python docs <https://docs.python.org/3.11/install/>_`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "global" in data_keys: data_keys.remove("global") data__global = data["global"] if not isinstance(data__global, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".global must be object", value=data__global, name="" + (name_prefix or "data") + ".global", definition={'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}, rule='type') for data_key, data_val in data.items(): if REGEX_PATTERNS['.+'].search(data_key): if data_key in data_keys: data_keys.remove(data_key) if not isinstance(data_val, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be object", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'object'}, rule='type') return data def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='type') try: try: data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['dynamic']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, rule='required') data_keys = set(data.keys()) if "dynamic" in data_keys: data_keys.remove("dynamic") data__dynamic = data["dynamic"] data__dynamic_is_list = isinstance(data__dynamic, (list, tuple)) if data__dynamic_is_list: data__dynamic_contains = False for data__dynamic_key in data__dynamic: try: if data__dynamic_key != "version": raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be same as const definition: version", value=data__dynamic_key, name="" + (name_prefix or "data") + ".dynamic", definition={'const': 'version'}, rule='const') data__dynamic_contains = True break except JsonSchemaValueException: pass if not data__dynamic_contains: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must contain one of contains definition", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}, rule='contains') except JsonSchemaValueException: pass else: raise JsonSchemaValueException("" + (name_prefix or "data") + " must NOT match a disallowed definition", value=data, name="" + (name_prefix or "data") + "", definition={'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, rule='not') except JsonSchemaValueException: pass else: data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['version']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}, rule='required') try: data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['license-files']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['license-files']}, rule='required') except JsonSchemaValueException: pass else: data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "license" in data_keys: data_keys.remove("license") data__license = data["license"] if not isinstance(data__license, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be string", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string'}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data__missing_keys = set(['name']) - data.keys() if data__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='required') data_keys = set(data.keys()) if "name" in data_keys: data_keys.remove("name") data__name = data["name"] if not isinstance(data__name, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, rule='type') if isinstance(data__name, str): if not custom_formats["pep508-identifier"](data__name): raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be pep508-identifier", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, rule='format') if "version" in data_keys: data_keys.remove("version") data__version = data["version"] if not isinstance(data__version, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".version must be string", value=data__version, name="" + (name_prefix or "data") + ".version", definition={'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, rule='type') if isinstance(data__version, str): if not custom_formats["pep440"](data__version): raise JsonSchemaValueException("" + (name_prefix or "data") + ".version must be pep440", value=data__version, name="" + (name_prefix or "data") + ".version", definition={'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, rule='format') if "description" in data_keys: data_keys.remove("description") data__description = data["description"] if not isinstance(data__description, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".description must be string", value=data__description, name="" + (name_prefix or "data") + ".description", definition={'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, rule='type') if "readme" in data_keys: data_keys.remove("readme") data__readme = data["readme"] data__readme_one_of_count12 = 0 if data__readme_one_of_count12 < 2: try: if not isinstance(data__readme, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be string", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, rule='type') data__readme_one_of_count12 += 1 except JsonSchemaValueException: pass if data__readme_one_of_count12 < 2: try: if not isinstance(data__readme, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be object", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}, rule='type') data__readme_any_of_count13 = 0 if not data__readme_any_of_count13: try: data__readme_is_dict = isinstance(data__readme, dict) if data__readme_is_dict: data__readme__missing_keys = set(['file']) - data__readme.keys() if data__readme__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, rule='required') data__readme_keys = set(data__readme.keys()) if "file" in data__readme_keys: data__readme_keys.remove("file") data__readme__file = data__readme["file"] if not isinstance(data__readme__file, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.file must be string", value=data__readme__file, name="" + (name_prefix or "data") + ".readme.file", definition={'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}, rule='type') data__readme_any_of_count13 += 1 except JsonSchemaValueException: pass if not data__readme_any_of_count13: try: data__readme_is_dict = isinstance(data__readme, dict) if data__readme_is_dict: data__readme__missing_keys = set(['text']) - data__readme.keys() if data__readme__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}, rule='required') data__readme_keys = set(data__readme.keys()) if "text" in data__readme_keys: data__readme_keys.remove("text") data__readme__text = data__readme["text"] if not isinstance(data__readme__text, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.text must be string", value=data__readme__text, name="" + (name_prefix or "data") + ".readme.text", definition={'type': 'string', 'description': 'Full text describing the project.'}, rule='type') data__readme_any_of_count13 += 1 except JsonSchemaValueException: pass if not data__readme_any_of_count13: raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme cannot be validated by any definition", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, rule='anyOf') data__readme_is_dict = isinstance(data__readme, dict) if data__readme_is_dict: data__readme__missing_keys = set(['content-type']) - data__readme.keys() if data__readme__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}, rule='required') data__readme_keys = set(data__readme.keys()) if "content-type" in data__readme_keys: data__readme_keys.remove("content-type") data__readme__contenttype = data__readme["content-type"] if not isinstance(data__readme__contenttype, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.content-type must be string", value=data__readme__contenttype, name="" + (name_prefix or "data") + ".readme.content-type", definition={'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}, rule='type') data__readme_one_of_count12 += 1 except JsonSchemaValueException: pass if data__readme_one_of_count12 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be valid exactly by one definition" + (" (" + str(data__readme_one_of_count12) + " matches found)"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, rule='oneOf') if "requires-python" in data_keys: data_keys.remove("requires-python") data__requirespython = data["requires-python"] if not isinstance(data__requirespython, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".requires-python must be string", value=data__requirespython, name="" + (name_prefix or "data") + ".requires-python", definition={'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, rule='type') if isinstance(data__requirespython, str): if not custom_formats["pep508-versionspec"](data__requirespython): raise JsonSchemaValueException("" + (name_prefix or "data") + ".requires-python must be pep508-versionspec", value=data__requirespython, name="" + (name_prefix or "data") + ".requires-python", definition={'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, rule='format') if "license" in data_keys: data_keys.remove("license") data__license = data["license"] data__license_one_of_count14 = 0 if data__license_one_of_count14 < 2: try: if not isinstance(data__license, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be string", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, rule='type') if isinstance(data__license, str): if not custom_formats["SPDX"](data__license): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be SPDX", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, rule='format') data__license_one_of_count14 += 1 except JsonSchemaValueException: pass if data__license_one_of_count14 < 2: try: if not isinstance(data__license, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be object", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, rule='type') data__license_is_dict = isinstance(data__license, dict) if data__license_is_dict: data__license__missing_keys = set(['file']) - data__license.keys() if data__license__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must contain " + (str(sorted(data__license__missing_keys)) + " properties"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, rule='required') data__license_keys = set(data__license.keys()) if "file" in data__license_keys: data__license_keys.remove("file") data__license__file = data__license["file"] if not isinstance(data__license__file, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license.file must be string", value=data__license__file, name="" + (name_prefix or "data") + ".license.file", definition={'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}, rule='type') data__license_one_of_count14 += 1 except JsonSchemaValueException: pass if data__license_one_of_count14 < 2: try: if not isinstance(data__license, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be object", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}, rule='type') data__license_is_dict = isinstance(data__license, dict) if data__license_is_dict: data__license__missing_keys = set(['text']) - data__license.keys() if data__license__missing_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must contain " + (str(sorted(data__license__missing_keys)) + " properties"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}, rule='required') data__license_keys = set(data__license.keys()) if "text" in data__license_keys: data__license_keys.remove("text") data__license__text = data__license["text"] if not isinstance(data__license__text, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license.text must be string", value=data__license__text, name="" + (name_prefix or "data") + ".license.text", definition={'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}, rule='type') data__license_one_of_count14 += 1 except JsonSchemaValueException: pass if data__license_one_of_count14 != 1: raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be valid exactly by one definition" + (" (" + str(data__license_one_of_count14) + " matches found)"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, rule='oneOf') if "license-files" in data_keys: data_keys.remove("license-files") data__licensefiles = data["license-files"] if not isinstance(data__licensefiles, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files must be array", value=data__licensefiles, name="" + (name_prefix or "data") + ".license-files", definition={'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, rule='type') data__licensefiles_is_list = isinstance(data__licensefiles, (list, tuple)) if data__licensefiles_is_list: data__licensefiles_len = len(data__licensefiles) for data__licensefiles_x, data__licensefiles_item in enumerate(data__licensefiles): if not isinstance(data__licensefiles_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + " must be string", value=data__licensefiles_item, name="" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "authors" in data_keys: data_keys.remove("authors") data__authors = data["authors"] if not isinstance(data__authors, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".authors must be array", value=data__authors, name="" + (name_prefix or "data") + ".authors", definition={'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, rule='type') data__authors_is_list = isinstance(data__authors, (list, tuple)) if data__authors_is_list: data__authors_len = len(data__authors) for data__authors_x, data__authors_item in enumerate(data__authors): validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data__authors_item, custom_formats, (name_prefix or "data") + ".authors[{data__authors_x}]".format(**locals())) if "maintainers" in data_keys: data_keys.remove("maintainers") data__maintainers = data["maintainers"] if not isinstance(data__maintainers, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".maintainers must be array", value=data__maintainers, name="" + (name_prefix or "data") + ".maintainers", definition={'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, rule='type') data__maintainers_is_list = isinstance(data__maintainers, (list, tuple)) if data__maintainers_is_list: data__maintainers_len = len(data__maintainers) for data__maintainers_x, data__maintainers_item in enumerate(data__maintainers): validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data__maintainers_item, custom_formats, (name_prefix or "data") + ".maintainers[{data__maintainers_x}]".format(**locals())) if "keywords" in data_keys: data_keys.remove("keywords") data__keywords = data["keywords"] if not isinstance(data__keywords, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".keywords must be array", value=data__keywords, name="" + (name_prefix or "data") + ".keywords", definition={'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, rule='type') data__keywords_is_list = isinstance(data__keywords, (list, tuple)) if data__keywords_is_list: data__keywords_len = len(data__keywords) for data__keywords_x, data__keywords_item in enumerate(data__keywords): if not isinstance(data__keywords_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".keywords[{data__keywords_x}]".format(**locals()) + " must be string", value=data__keywords_item, name="" + (name_prefix or "data") + ".keywords[{data__keywords_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') if "classifiers" in data_keys: data_keys.remove("classifiers") data__classifiers = data["classifiers"] if not isinstance(data__classifiers, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers must be array", value=data__classifiers, name="" + (name_prefix or "data") + ".classifiers", definition={'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, rule='type') data__classifiers_is_list = isinstance(data__classifiers, (list, tuple)) if data__classifiers_is_list: data__classifiers_len = len(data__classifiers) for data__classifiers_x, data__classifiers_item in enumerate(data__classifiers): if not isinstance(data__classifiers_item, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + " must be string", value=data__classifiers_item, name="" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, rule='type') if isinstance(data__classifiers_item, str): if not custom_formats["trove-classifier"](data__classifiers_item): raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + " must be trove-classifier", value=data__classifiers_item, name="" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, rule='format') if "urls" in data_keys: data_keys.remove("urls") data__urls = data["urls"] if not isinstance(data__urls, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls must be object", value=data__urls, name="" + (name_prefix or "data") + ".urls", definition={'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, rule='type') data__urls_is_dict = isinstance(data__urls, dict) if data__urls_is_dict: data__urls_keys = set(data__urls.keys()) for data__urls_key, data__urls_val in data__urls.items(): if REGEX_PATTERNS['^.+$'].search(data__urls_key): if data__urls_key in data__urls_keys: data__urls_keys.remove(data__urls_key) if not isinstance(data__urls_val, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + " must be string", value=data__urls_val, name="" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'url'}, rule='type') if isinstance(data__urls_val, str): if not custom_formats["url"](data__urls_val): raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + " must be url", value=data__urls_val, name="" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'url'}, rule='format') if data__urls_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls must not contain "+str(data__urls_keys)+" properties", value=data__urls, name="" + (name_prefix or "data") + ".urls", definition={'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, rule='additionalProperties') if "scripts" in data_keys: data_keys.remove("scripts") data__scripts = data["scripts"] validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__scripts, custom_formats, (name_prefix or "data") + ".scripts") if "gui-scripts" in data_keys: data_keys.remove("gui-scripts") data__guiscripts = data["gui-scripts"] validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__guiscripts, custom_formats, (name_prefix or "data") + ".gui-scripts") if "entry-points" in data_keys: data_keys.remove("entry-points") data__entrypoints = data["entry-points"] data__entrypoints_is_dict = isinstance(data__entrypoints, dict) if data__entrypoints_is_dict: data__entrypoints_keys = set(data__entrypoints.keys()) for data__entrypoints_key, data__entrypoints_val in data__entrypoints.items(): if REGEX_PATTERNS['^.+$'].search(data__entrypoints_key): if data__entrypoints_key in data__entrypoints_keys: data__entrypoints_keys.remove(data__entrypoints_key) validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__entrypoints_val, custom_formats, (name_prefix or "data") + ".entry-points.{data__entrypoints_key}".format(**locals())) if data__entrypoints_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must not contain "+str(data__entrypoints_keys)+" properties", value=data__entrypoints, name="" + (name_prefix or "data") + ".entry-points", definition={'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, rule='additionalProperties') data__entrypoints_len = len(data__entrypoints) if data__entrypoints_len != 0: data__entrypoints_property_names = True for data__entrypoints_key in data__entrypoints: try: if isinstance(data__entrypoints_key, str): if not custom_formats["python-entrypoint-group"](data__entrypoints_key): raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must be python-entrypoint-group", value=data__entrypoints_key, name="" + (name_prefix or "data") + ".entry-points", definition={'format': 'python-entrypoint-group'}, rule='format') except JsonSchemaValueException: data__entrypoints_property_names = False if not data__entrypoints_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must be named by propertyName definition", value=data__entrypoints, name="" + (name_prefix or "data") + ".entry-points", definition={'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, rule='propertyNames') if "dependencies" in data_keys: data_keys.remove("dependencies") data__dependencies = data["dependencies"] if not isinstance(data__dependencies, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependencies must be array", value=data__dependencies, name="" + (name_prefix or "data") + ".dependencies", definition={'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, rule='type') data__dependencies_is_list = isinstance(data__dependencies, (list, tuple)) if data__dependencies_is_list: data__dependencies_len = len(data__dependencies) for data__dependencies_x, data__dependencies_item in enumerate(data__dependencies): validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data__dependencies_item, custom_formats, (name_prefix or "data") + ".dependencies[{data__dependencies_x}]".format(**locals())) if "optional-dependencies" in data_keys: data_keys.remove("optional-dependencies") data__optionaldependencies = data["optional-dependencies"] if not isinstance(data__optionaldependencies, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be object", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='type') data__optionaldependencies_is_dict = isinstance(data__optionaldependencies, dict) if data__optionaldependencies_is_dict: data__optionaldependencies_keys = set(data__optionaldependencies.keys()) for data__optionaldependencies_key, data__optionaldependencies_val in data__optionaldependencies.items(): if REGEX_PATTERNS['^.+$'].search(data__optionaldependencies_key): if data__optionaldependencies_key in data__optionaldependencies_keys: data__optionaldependencies_keys.remove(data__optionaldependencies_key) if not isinstance(data__optionaldependencies_val, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}".format(**locals()) + " must be array", value=data__optionaldependencies_val, name="" + (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, rule='type') data__optionaldependencies_val_is_list = isinstance(data__optionaldependencies_val, (list, tuple)) if data__optionaldependencies_val_is_list: data__optionaldependencies_val_len = len(data__optionaldependencies_val) for data__optionaldependencies_val_x, data__optionaldependencies_val_item in enumerate(data__optionaldependencies_val): validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data__optionaldependencies_val_item, custom_formats, (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}[{data__optionaldependencies_val_x}]".format(**locals())) if data__optionaldependencies_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must not contain "+str(data__optionaldependencies_keys)+" properties", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='additionalProperties') data__optionaldependencies_len = len(data__optionaldependencies) if data__optionaldependencies_len != 0: data__optionaldependencies_property_names = True for data__optionaldependencies_key in data__optionaldependencies: try: if isinstance(data__optionaldependencies_key, str): if not custom_formats["pep508-identifier"](data__optionaldependencies_key): raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be pep508-identifier", value=data__optionaldependencies_key, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'format': 'pep508-identifier'}, rule='format') except JsonSchemaValueException: data__optionaldependencies_property_names = False if not data__optionaldependencies_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be named by propertyName definition", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='propertyNames') if "dynamic" in data_keys: data_keys.remove("dynamic") data__dynamic = data["dynamic"] if not isinstance(data__dynamic, (list, tuple)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be array", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}, rule='type') data__dynamic_is_list = isinstance(data__dynamic, (list, tuple)) if data__dynamic_is_list: data__dynamic_len = len(data__dynamic) for data__dynamic_x, data__dynamic_item in enumerate(data__dynamic): if data__dynamic_item not in ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']: raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic[{data__dynamic_x}]".format(**locals()) + " must be one of ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']", value=data__dynamic_item, name="" + (name_prefix or "data") + ".dynamic[{data__dynamic_x}]".format(**locals()) + "", definition={'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}, rule='enum') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '<https://packaging.python.org/specifications/core-metadata/#summary>`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '<https://peps.python.org/pep-0621/#readme>`_', "with meaning similar to the one defined in `core metadata's Description", '<https://packaging.python.org/specifications/core-metadata/#description>`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '<https://packaging.python.org/specifications/core-metadata/#requires-python>`_.']}, 'license': {'description': '`Project license <https://peps.python.org/pep-0621/#license>`_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '<https://packaging.python.org/specifications/core-metadata/#license>`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier <https://pypi.org/classifiers/>`_.'}, '$$description': ['`Trove classifiers <https://pypi.org/classifiers/>`_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '<https://packaging.python.org/specifications/entry-points/>`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='additionalProperties') return data def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data, custom_formats={}, name_prefix=None): if not isinstance(data, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}, rule='type') if isinstance(data, str): if not custom_formats["pep508"](data): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be pep508", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}, rule='format') return data def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) for data_key, data_val in data.items(): if REGEX_PATTERNS['^.+$'].search(data_key): if data_key in data_keys: data_keys.remove(data_key) if not isinstance(data_val, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be string", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}, rule='type') if isinstance(data_val, str): if not custom_formats["python-entrypoint-reference"](data_val): raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be python-entrypoint-reference", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}, rule='format') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='additionalProperties') data_len = len(data) if data_len != 0: data_property_names = True for data_key in data: try: if isinstance(data_key, str): if not custom_formats["python-entrypoint-name"](data_key): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be python-entrypoint-name", value=data_key, name="" + (name_prefix or "data") + "", definition={'format': 'python-entrypoint-name'}, rule='format') except JsonSchemaValueException: data_property_names = False if not data_property_names: raise JsonSchemaValueException("" + (name_prefix or "data") + " must be named by propertyName definition", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '<https://packaging.python.org/specifications/entry-points/>`_', 'and `setuptools docs', '<https://setuptools.pypa.io/en/latest/userguide/entry_point.html>`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='propertyNames') return data def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data, custom_formats={}, name_prefix=None): if not isinstance(data, (dict)): raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, rule='type') data_is_dict = isinstance(data, dict) if data_is_dict: data_keys = set(data.keys()) if "name" in data_keys: data_keys.remove("name") data__name = data["name"] if not isinstance(data__name, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, rule='type') if "email" in data_keys: data_keys.remove("email") data__email = data["email"] if not isinstance(data__email, (str)): raise JsonSchemaValueException("" + (name_prefix or "data") + ".email must be string", value=data__email, name="" + (name_prefix or "data") + ".email", definition={'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}, rule='type') if isinstance(data__email, str): if not REGEX_PATTERNS["idn-email_re_pattern"].match(data__email): raise JsonSchemaValueException("" + (name_prefix or "data") + ".email must be idn-email", value=data__email, name="" + (name_prefix or "data") + ".email", definition={'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}, rule='format') if data_keys: raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, rule='additionalProperties') return data config/_validate_pyproject/NOTICE 0000644 00000044461 15030122015 0012742 0 ustar 00 The code contained in this directory was automatically generated using the following command: python -m validate_pyproject.pre_compile --output-dir=setuptools/config/_validate_pyproject --enable-plugins setuptools distutils --very-verbose -t setuptools=setuptools/config/setuptools.schema.json -t distutils=setuptools/config/distutils.schema.json Please avoid changing it manually. You can report issues or suggest changes directly to `validate-pyproject` (or to the relevant plugin repository) - https://github.com/abravalheri/validate-pyproject/issues *** The following files include code from opensource projects (either as direct copies or modified versions): - `fastjsonschema_exceptions.py`: - project: `fastjsonschema` - licensed under BSD-3-Clause (https://github.com/horejsek/python-fastjsonschema) - `extra_validations.py` and `format.py`, `error_reporting.py`: - project: `validate-pyproject` - licensed under MPL-2.0 (https://github.com/abravalheri/validate-pyproject) Additionally the following files are automatically generated by tools provided by the same projects: - `__init__.py` - `fastjsonschema_validations.py` The relevant copyright notes and licenses are included below. *** `fastjsonschema` ================ Copyright (c) 2018, Michal Horejsek All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the {organization} nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. *** `validate-pyproject` ==================== Mozilla Public License, version 2.0 1. Definitions 1.1. "Contributor" means each individual or legal entity that creates, contributes to the creation of, or owns Covered Software. 1.2. "Contributor Version" means the combination of the Contributions of others (if any) used by a Contributor and that particular Contributor's Contribution. 1.3. "Contribution" means Covered Software of a particular Contributor. 1.4. "Covered Software" means Source Code Form to which the initial Contributor has attached the notice in Exhibit A, the Executable Form of such Source Code Form, and Modifications of such Source Code Form, in each case including portions thereof. 1.5. "Incompatible With Secondary Licenses" means a. that the initial Contributor has attached the notice described in Exhibit B to the Covered Software; or b. that the Covered Software was made available under the terms of version 1.1 or earlier of the License, but not also under the terms of a Secondary License. 1.6. "Executable Form" means any form of the work other than Source Code Form. 1.7. "Larger Work" means a work that combines Covered Software with other material, in a separate file or files, that is not Covered Software. 1.8. "License" means this document. 1.9. "Licensable" means having the right to grant, to the maximum extent possible, whether at the time of the initial grant or subsequently, any and all of the rights conveyed by this License. 1.10. "Modifications" means any of the following: a. any file in Source Code Form that results from an addition to, deletion from, or modification of the contents of Covered Software; or b. any new file in Source Code Form that contains any Covered Software. 1.11. "Patent Claims" of a Contributor means any patent claim(s), including without limitation, method, process, and apparatus claims, in any patent Licensable by such Contributor that would be infringed, but for the grant of the License, by the making, using, selling, offering for sale, having made, import, or transfer of either its Contributions or its Contributor Version. 1.12. "Secondary License" means either the GNU General Public License, Version 2.0, the GNU Lesser General Public License, Version 2.1, the GNU Affero General Public License, Version 3.0, or any later versions of those licenses. 1.13. "Source Code Form" means the form of the work preferred for making modifications. 1.14. "You" (or "Your") means an individual or a legal entity exercising rights under this License. For legal entities, "You" includes any entity that controls, is controlled by, or is under common control with You. For purposes of this definition, "control" means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity. 2. License Grants and Conditions 2.1. Grants Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license: a. under intellectual property rights (other than patent or trademark) Licensable by such Contributor to use, reproduce, make available, modify, display, perform, distribute, and otherwise exploit its Contributions, either on an unmodified basis, with Modifications, or as part of a Larger Work; and b. under Patent Claims of such Contributor to make, use, sell, offer for sale, have made, import, and otherwise transfer either its Contributions or its Contributor Version. 2.2. Effective Date The licenses granted in Section 2.1 with respect to any Contribution become effective for each Contribution on the date the Contributor first distributes such Contribution. 2.3. Limitations on Grant Scope The licenses granted in this Section 2 are the only rights granted under this License. No additional rights or licenses will be implied from the distribution or licensing of Covered Software under this License. Notwithstanding Section 2.1(b) above, no patent license is granted by a Contributor: a. for any code that a Contributor has removed from Covered Software; or b. for infringements caused by: (i) Your and any other third party's modifications of Covered Software, or (ii) the combination of its Contributions with other software (except as part of its Contributor Version); or c. under Patent Claims infringed by Covered Software in the absence of its Contributions. This License does not grant any rights in the trademarks, service marks, or logos of any Contributor (except as may be necessary to comply with the notice requirements in Section 3.4). 2.4. Subsequent Licenses No Contributor makes additional grants as a result of Your choice to distribute the Covered Software under a subsequent version of this License (see Section 10.2) or under the terms of a Secondary License (if permitted under the terms of Section 3.3). 2.5. Representation Each Contributor represents that the Contributor believes its Contributions are its original creation(s) or it has sufficient rights to grant the rights to its Contributions conveyed by this License. 2.6. Fair Use This License is not intended to limit any rights You have under applicable copyright doctrines of fair use, fair dealing, or other equivalents. 2.7. Conditions Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in Section 2.1. 3. Responsibilities 3.1. Distribution of Source Form All distribution of Covered Software in Source Code Form, including any Modifications that You create or to which You contribute, must be under the terms of this License. You must inform recipients that the Source Code Form of the Covered Software is governed by the terms of this License, and how they can obtain a copy of this License. You may not attempt to alter or restrict the recipients' rights in the Source Code Form. 3.2. Distribution of Executable Form If You distribute Covered Software in Executable Form then: a. such Covered Software must also be made available in Source Code Form, as described in Section 3.1, and You must inform recipients of the Executable Form how they can obtain a copy of such Source Code Form by reasonable means in a timely manner, at a charge no more than the cost of distribution to the recipient; and b. You may distribute such Executable Form under the terms of this License, or sublicense it under different terms, provided that the license for the Executable Form does not attempt to limit or alter the recipients' rights in the Source Code Form under this License. 3.3. Distribution of a Larger Work You may create and distribute a Larger Work under terms of Your choice, provided that You also comply with the requirements of this License for the Covered Software. If the Larger Work is a combination of Covered Software with a work governed by one or more Secondary Licenses, and the Covered Software is not Incompatible With Secondary Licenses, this License permits You to additionally distribute such Covered Software under the terms of such Secondary License(s), so that the recipient of the Larger Work may, at their option, further distribute the Covered Software under the terms of either this License or such Secondary License(s). 3.4. Notices You may not remove or alter the substance of any license notices (including copyright notices, patent notices, disclaimers of warranty, or limitations of liability) contained within the Source Code Form of the Covered Software, except that You may alter any license notices to the extent required to remedy known factual inaccuracies. 3.5. Application of Additional Terms You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Covered Software. However, You may do so only on Your own behalf, and not on behalf of any Contributor. You must make it absolutely clear that any such warranty, support, indemnity, or liability obligation is offered by You alone, and You hereby agree to indemnify every Contributor for any liability incurred by such Contributor as a result of warranty, support, indemnity or liability terms You offer. You may include additional disclaimers of warranty and limitations of liability specific to any jurisdiction. 4. Inability to Comply Due to Statute or Regulation If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Software due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be placed in a text file included with all distributions of the Covered Software under this License. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it. 5. Termination 5.1. The rights granted under this License will terminate automatically if You fail to comply with any of its terms. However, if You become compliant, then the rights granted under this License from a particular Contributor are reinstated (a) provisionally, unless and until such Contributor explicitly and finally terminates Your grants, and (b) on an ongoing basis, if such Contributor fails to notify You of the non-compliance by some reasonable means prior to 60 days after You have come back into compliance. Moreover, Your grants from a particular Contributor are reinstated on an ongoing basis if such Contributor notifies You of the non-compliance by some reasonable means, this is the first time You have received notice of non-compliance with this License from such Contributor, and You become compliant prior to 30 days after Your receipt of the notice. 5.2. If You initiate litigation against any entity by asserting a patent infringement claim (excluding declaratory judgment actions, counter-claims, and cross-claims) alleging that a Contributor Version directly or indirectly infringes any patent, then the rights granted to You by any and all Contributors for the Covered Software under Section 2.1 of this License shall terminate. 5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user license agreements (excluding distributors and resellers) which have been validly granted by You or Your distributors under this License prior to termination shall survive termination. 6. Disclaimer of Warranty Covered Software is provided under this License on an "as is" basis, without warranty of any kind, either expressed, implied, or statutory, including, without limitation, warranties that the Covered Software is free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the Covered Software is with You. Should any Covered Software prove defective in any respect, You (not any Contributor) assume the cost of any necessary servicing, repair, or correction. This disclaimer of warranty constitutes an essential part of this License. No use of any Covered Software is authorized under this License except under this disclaimer. 7. Limitation of Liability Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall any Contributor, or anyone who distributes Covered Software as permitted above, be liable to You for any direct, indirect, special, incidental, or consequential damages of any character including, without limitation, damages for lost profits, loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if such party shall have been informed of the possibility of such damages. This limitation of liability shall not apply to liability for death or personal injury resulting from such party's negligence to the extent applicable law prohibits such limitation. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so this exclusion and limitation may not apply to You. 8. Litigation Any litigation relating to this License may be brought only in the courts of a jurisdiction where the defendant maintains its principal place of business and such litigation shall be governed by laws of that jurisdiction, without reference to its conflict-of-law provisions. Nothing in this Section shall prevent a party's ability to bring cross-claims or counter-claims. 9. Miscellaneous This License represents the complete agreement concerning the subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not be used to construe this License against a Contributor. 10. Versions of the License 10.1. New Versions Mozilla Foundation is the license steward. Except as provided in Section 10.3, no one other than the license steward has the right to modify or publish new versions of this License. Each version will be given a distinguishing version number. 10.2. Effect of New Versions You may distribute the Covered Software under the terms of the version of the License under which You originally received the Covered Software, or under the terms of any subsequent version published by the license steward. 10.3. Modified Versions If you create software not governed by this License, and you want to create a new license for such software, you may create and use a modified version of this License if you rename the license and remove any references to the name of the license steward (except to note that such modified license differs from this License). 10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses If You choose to distribute Source Code Form that is Incompatible With Secondary Licenses under the terms of this version of the License, the notice described in Exhibit B of this License must be attached. Exhibit A - Source Code Form License Notice This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/. If it is not possible or desirable to put the notice in a particular file, then You may include the notice in a location (such as a LICENSE file in a relevant directory) where a recipient would be likely to look for such a notice. You may add additional accurate notices of copyright ownership. Exhibit B - "Incompatible With Secondary Licenses" Notice This Source Code Form is "Incompatible With Secondary Licenses", as defined by the Mozilla Public License, v. 2.0. config/_validate_pyproject/fastjsonschema_exceptions.py 0000644 00000003114 15030122015 0017647 0 ustar 00 import re SPLIT_RE = re.compile(r'[\.\[\]]+') class JsonSchemaException(ValueError): """ Base exception of ``fastjsonschema`` library. """ class JsonSchemaValueException(JsonSchemaException): """ Exception raised by validation function. Available properties: * ``message`` containing human-readable information what is wrong (e.g. ``data.property[index] must be smaller than or equal to 42``), * invalid ``value`` (e.g. ``60``), * ``name`` of a path in the data structure (e.g. ``data.property[index]``), * ``path`` as an array in the data structure (e.g. ``['data', 'property', 'index']``), * the whole ``definition`` which the ``value`` has to fulfil (e.g. ``{'type': 'number', 'maximum': 42}``), * ``rule`` which the ``value`` is breaking (e.g. ``maximum``) * and ``rule_definition`` (e.g. ``42``). .. versionchanged:: 2.14.0 Added all extra properties. """ def __init__(self, message, value=None, name=None, definition=None, rule=None): super().__init__(message) self.message = message self.value = value self.name = name self.definition = definition self.rule = rule @property def path(self): return [item for item in SPLIT_RE.split(self.name) if item != ''] @property def rule_definition(self): if not self.rule or not self.definition: return None return self.definition.get(self.rule) class JsonSchemaDefinitionException(JsonSchemaException): """ Exception raised by generator of validation function. """ config/_validate_pyproject/__init__.py 0000644 00000002022 15030122015 0014132 0 ustar 00 from functools import reduce from typing import Any, Callable, Dict from . import formats from .error_reporting import detailed_errors, ValidationError from .extra_validations import EXTRA_VALIDATIONS from .fastjsonschema_exceptions import JsonSchemaException, JsonSchemaValueException from .fastjsonschema_validations import validate as _validate __all__ = [ "validate", "FORMAT_FUNCTIONS", "EXTRA_VALIDATIONS", "ValidationError", "JsonSchemaException", "JsonSchemaValueException", ] FORMAT_FUNCTIONS: Dict[str, Callable[[str], bool]] = { fn.__name__.replace("_", "-"): fn for fn in formats.__dict__.values() if callable(fn) and not fn.__name__.startswith("_") } def validate(data: Any) -> bool: """Validate the given ``data`` object using JSON Schema This function raises ``ValidationError`` if ``data`` is invalid. """ with detailed_errors(): _validate(data, custom_formats=FORMAT_FUNCTIONS) reduce(lambda acc, fn: fn(acc), EXTRA_VALIDATIONS, data) return True config/distutils.schema.json 0000644 00000001714 15030122015 0012157 0 ustar 00 { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html", "title": "``tool.distutils`` table", "$$description": [ "**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``", "subtables to configure arguments for ``distutils`` commands.", "Originally, ``distutils`` allowed developers to configure arguments for", "``setup.py`` commands via `distutils configuration files", "<https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html>`_.", "See also `the old Python docs <https://docs.python.org/3.11/install/>_`." ], "type": "object", "properties": { "global": { "type": "object", "description": "Global options applied to all ``distutils`` commands" } }, "patternProperties": { ".+": {"type": "object"} }, "$comment": "TODO: Is there a practical way of making this schema more specific?" } config/expand.py 0000644 00000037251 15030122015 0007637 0 ustar 00 """Utility functions to expand configuration directives or special values (such glob patterns). We can split the process of interpreting configuration files into 2 steps: 1. The parsing the file contents from strings to value objects that can be understand by Python (for example a string with a comma separated list of keywords into an actual Python list of strings). 2. The expansion (or post-processing) of these values according to the semantics ``setuptools`` assign to them (for example a configuration field with the ``file:`` directive should be expanded from a list of file paths to a single string with the contents of those files concatenated) This module focus on the second step, and therefore allow sharing the expansion functions among several configuration file formats. **PRIVATE MODULE**: API reserved for setuptools internal usage only. """ from __future__ import annotations import ast import importlib import os import pathlib import sys from collections.abc import Iterable, Iterator, Mapping from configparser import ConfigParser from glob import iglob from importlib.machinery import ModuleSpec, all_suffixes from itertools import chain from pathlib import Path from types import ModuleType, TracebackType from typing import TYPE_CHECKING, Any, Callable, TypeVar from .. import _static from .._path import StrPath, same_path as _same_path from ..discovery import find_package_path from ..warnings import SetuptoolsWarning from distutils.errors import DistutilsOptionError if TYPE_CHECKING: from typing_extensions import Self from setuptools.dist import Distribution _K = TypeVar("_K") _V_co = TypeVar("_V_co", covariant=True) class StaticModule: """Proxy to a module object that avoids executing arbitrary code.""" def __init__(self, name: str, spec: ModuleSpec) -> None: module = ast.parse(pathlib.Path(spec.origin).read_bytes()) # type: ignore[arg-type] # Let it raise an error on None vars(self).update(locals()) del self.self def _find_assignments(self) -> Iterator[tuple[ast.AST, ast.AST]]: for statement in self.module.body: if isinstance(statement, ast.Assign): yield from ((target, statement.value) for target in statement.targets) elif isinstance(statement, ast.AnnAssign) and statement.value: yield (statement.target, statement.value) def __getattr__(self, attr: str): """Attempt to load an attribute "statically", via :func:`ast.literal_eval`.""" try: return next( ast.literal_eval(value) for target, value in self._find_assignments() if isinstance(target, ast.Name) and target.id == attr ) except Exception as e: raise AttributeError(f"{self.name} has no attribute {attr}") from e def glob_relative( patterns: Iterable[str], root_dir: StrPath | None = None ) -> list[str]: """Expand the list of glob patterns, but preserving relative paths. :param list[str] patterns: List of glob patterns :param str root_dir: Path to which globs should be relative (current directory by default) :rtype: list """ glob_characters = {'*', '?', '[', ']', '{', '}'} expanded_values = [] root_dir = root_dir or os.getcwd() for value in patterns: # Has globby characters? if any(char in value for char in glob_characters): # then expand the glob pattern while keeping paths *relative*: glob_path = os.path.abspath(os.path.join(root_dir, value)) expanded_values.extend( sorted( os.path.relpath(path, root_dir).replace(os.sep, "/") for path in iglob(glob_path, recursive=True) ) ) else: # take the value as-is path = os.path.relpath(value, root_dir).replace(os.sep, "/") expanded_values.append(path) return expanded_values def read_files( filepaths: StrPath | Iterable[StrPath], root_dir: StrPath | None = None ) -> str: """Return the content of the files concatenated using ``\n`` as str This function is sandboxed and won't reach anything outside ``root_dir`` (By default ``root_dir`` is the current directory). """ from more_itertools import always_iterable root_dir = os.path.abspath(root_dir or os.getcwd()) _filepaths = (os.path.join(root_dir, path) for path in always_iterable(filepaths)) return '\n'.join( _read_file(path) for path in _filter_existing_files(_filepaths) if _assert_local(path, root_dir) ) def _filter_existing_files(filepaths: Iterable[StrPath]) -> Iterator[StrPath]: for path in filepaths: if os.path.isfile(path): yield path else: SetuptoolsWarning.emit(f"File {path!r} cannot be found") def _read_file(filepath: bytes | StrPath) -> str: with open(filepath, encoding='utf-8') as f: return f.read() def _assert_local(filepath: StrPath, root_dir: str): if Path(os.path.abspath(root_dir)) not in Path(os.path.abspath(filepath)).parents: msg = f"Cannot access {filepath!r} (or anything outside {root_dir!r})" raise DistutilsOptionError(msg) return True def read_attr( attr_desc: str, package_dir: Mapping[str, str] | None = None, root_dir: StrPath | None = None, ) -> Any: """Reads the value of an attribute from a module. This function will try to read the attributed statically first (via :func:`ast.literal_eval`), and only evaluate the module if it fails. Examples: read_attr("package.attr") read_attr("package.module.attr") :param str attr_desc: Dot-separated string describing how to reach the attribute (see examples above) :param dict[str, str] package_dir: Mapping of package names to their location in disk (represented by paths relative to ``root_dir``). :param str root_dir: Path to directory containing all the packages in ``package_dir`` (current directory by default). :rtype: str """ root_dir = root_dir or os.getcwd() attrs_path = attr_desc.strip().split('.') attr_name = attrs_path.pop() module_name = '.'.join(attrs_path) module_name = module_name or '__init__' path = _find_module(module_name, package_dir, root_dir) spec = _find_spec(module_name, path) try: value = getattr(StaticModule(module_name, spec), attr_name) # XXX: Is marking as static contents coming from modules too optimistic? return _static.attempt_conversion(value) except Exception: # fallback to evaluate module module = _load_spec(spec, module_name) return getattr(module, attr_name) def _find_spec(module_name: str, module_path: StrPath | None) -> ModuleSpec: spec = importlib.util.spec_from_file_location(module_name, module_path) spec = spec or importlib.util.find_spec(module_name) if spec is None: raise ModuleNotFoundError(module_name) return spec def _load_spec(spec: ModuleSpec, module_name: str) -> ModuleType: name = getattr(spec, "__name__", module_name) if name in sys.modules: return sys.modules[name] module = importlib.util.module_from_spec(spec) sys.modules[name] = module # cache (it also ensures `==` works on loaded items) assert spec.loader is not None spec.loader.exec_module(module) return module def _find_module( module_name: str, package_dir: Mapping[str, str] | None, root_dir: StrPath ) -> str | None: """Find the path to the module named ``module_name``, considering the ``package_dir`` in the build configuration and ``root_dir``. >>> tmp = getfixture('tmpdir') >>> _ = tmp.ensure("a/b/c.py") >>> _ = tmp.ensure("a/b/d/__init__.py") >>> r = lambda x: x.replace(str(tmp), "tmp").replace(os.sep, "/") >>> r(_find_module("a.b.c", None, tmp)) 'tmp/a/b/c.py' >>> r(_find_module("f.g.h", {"": "1", "f": "2", "f.g": "3", "f.g.h": "a/b/d"}, tmp)) 'tmp/a/b/d/__init__.py' """ path_start = find_package_path(module_name, package_dir or {}, root_dir) candidates = chain.from_iterable( (f"{path_start}{ext}", os.path.join(path_start, f"__init__{ext}")) for ext in all_suffixes() ) return next((x for x in candidates if os.path.isfile(x)), None) def resolve_class( qualified_class_name: str, package_dir: Mapping[str, str] | None = None, root_dir: StrPath | None = None, ) -> Callable: """Given a qualified class name, return the associated class object""" root_dir = root_dir or os.getcwd() idx = qualified_class_name.rfind('.') class_name = qualified_class_name[idx + 1 :] pkg_name = qualified_class_name[:idx] path = _find_module(pkg_name, package_dir, root_dir) module = _load_spec(_find_spec(pkg_name, path), pkg_name) return getattr(module, class_name) def cmdclass( values: dict[str, str], package_dir: Mapping[str, str] | None = None, root_dir: StrPath | None = None, ) -> dict[str, Callable]: """Given a dictionary mapping command names to strings for qualified class names, apply :func:`resolve_class` to the dict values. """ return {k: resolve_class(v, package_dir, root_dir) for k, v in values.items()} def find_packages( *, namespaces=True, fill_package_dir: dict[str, str] | None = None, root_dir: StrPath | None = None, **kwargs, ) -> list[str]: """Works similarly to :func:`setuptools.find_packages`, but with all arguments given as keyword arguments. Moreover, ``where`` can be given as a list (the results will be simply concatenated). When the additional keyword argument ``namespaces`` is ``True``, it will behave like :func:`setuptools.find_namespace_packages`` (i.e. include implicit namespaces as per :pep:`420`). The ``where`` argument will be considered relative to ``root_dir`` (or the current working directory when ``root_dir`` is not given). If the ``fill_package_dir`` argument is passed, this function will consider it as a similar data structure to the ``package_dir`` configuration parameter add fill-in any missing package location. :rtype: list """ from more_itertools import always_iterable, unique_everseen from setuptools.discovery import construct_package_dir # check "not namespaces" first due to python/mypy#6232 if not namespaces: from setuptools.discovery import PackageFinder else: from setuptools.discovery import PEP420PackageFinder as PackageFinder root_dir = root_dir or os.curdir where = kwargs.pop('where', ['.']) packages: list[str] = [] fill_package_dir = {} if fill_package_dir is None else fill_package_dir search = list(unique_everseen(always_iterable(where))) if len(search) == 1 and all(not _same_path(search[0], x) for x in (".", root_dir)): fill_package_dir.setdefault("", search[0]) for path in search: package_path = _nest_path(root_dir, path) pkgs = PackageFinder.find(package_path, **kwargs) packages.extend(pkgs) if pkgs and not ( fill_package_dir.get("") == path or os.path.samefile(package_path, root_dir) ): fill_package_dir.update(construct_package_dir(pkgs, path)) return packages def _nest_path(parent: StrPath, path: StrPath) -> str: path = parent if path in {".", ""} else os.path.join(parent, path) return os.path.normpath(path) def version(value: Callable | Iterable[str | int] | str) -> str: """When getting the version directly from an attribute, it should be normalised to string. """ _value = value() if callable(value) else value if isinstance(_value, str): return _value if hasattr(_value, '__iter__'): return '.'.join(map(str, _value)) return f'{_value}' def canonic_package_data(package_data: dict) -> dict: if "*" in package_data: package_data[""] = package_data.pop("*") return package_data def canonic_data_files( data_files: list | dict, root_dir: StrPath | None = None ) -> list[tuple[str, list[str]]]: """For compatibility with ``setup.py``, ``data_files`` should be a list of pairs instead of a dict. This function also expands glob patterns. """ if isinstance(data_files, list): return data_files return [ (dest, glob_relative(patterns, root_dir)) for dest, patterns in data_files.items() ] def entry_points( text: str, text_source: str = "entry-points" ) -> dict[str, dict[str, str]]: """Given the contents of entry-points file, process it into a 2-level dictionary (``dict[str, dict[str, str]]``). The first level keys are entry-point groups, the second level keys are entry-point names, and the second level values are references to objects (that correspond to the entry-point value). """ # Using undocumented behaviour, see python/typeshed#12700 parser = ConfigParser(default_section=None, delimiters=("=",)) # type: ignore[call-overload] parser.optionxform = str # case sensitive parser.read_string(text, text_source) groups = {k: dict(v.items()) for k, v in parser.items()} groups.pop(parser.default_section, None) return groups class EnsurePackagesDiscovered: """Some expand functions require all the packages to already be discovered before they run, e.g. :func:`read_attr`, :func:`resolve_class`, :func:`cmdclass`. Therefore in some cases we will need to run autodiscovery during the evaluation of the configuration. However, it is better to postpone calling package discovery as much as possible, because some parameters can influence it (e.g. ``package_dir``), and those might not have been processed yet. """ def __init__(self, distribution: Distribution) -> None: self._dist = distribution self._called = False def __call__(self): """Trigger the automatic package discovery, if it is still necessary.""" if not self._called: self._called = True self._dist.set_defaults(name=False) # Skip name, we can still be parsing def __enter__(self) -> Self: return self def __exit__( self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, ): if self._called: self._dist.set_defaults.analyse_name() # Now we can set a default name def _get_package_dir(self) -> Mapping[str, str]: self() pkg_dir = self._dist.package_dir return {} if pkg_dir is None else pkg_dir @property def package_dir(self) -> Mapping[str, str]: """Proxy to ``package_dir`` that may trigger auto-discovery when used.""" return LazyMappingProxy(self._get_package_dir) class LazyMappingProxy(Mapping[_K, _V_co]): """Mapping proxy that delays resolving the target object, until really needed. >>> def obtain_mapping(): ... print("Running expensive function!") ... return {"key": "value", "other key": "other value"} >>> mapping = LazyMappingProxy(obtain_mapping) >>> mapping["key"] Running expensive function! 'value' >>> mapping["other key"] 'other value' """ def __init__(self, obtain_mapping_value: Callable[[], Mapping[_K, _V_co]]) -> None: self._obtain = obtain_mapping_value self._value: Mapping[_K, _V_co] | None = None def _target(self) -> Mapping[_K, _V_co]: if self._value is None: self._value = self._obtain() return self._value def __getitem__(self, key: _K) -> _V_co: return self._target()[key] def __len__(self) -> int: return len(self._target()) def __iter__(self) -> Iterator[_K]: return iter(self._target()) config/setupcfg.py 0000644 00000063717 15030122015 0010206 0 ustar 00 """ Load setuptools configuration from ``setup.cfg`` files. **API will be made private in the future** To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``configparser``. """ from __future__ import annotations import contextlib import functools import os from collections import defaultdict from collections.abc import Iterable, Iterator from functools import partial, wraps from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, TypeVar, cast from packaging.markers import default_environment as marker_env from packaging.requirements import InvalidRequirement, Requirement from packaging.version import InvalidVersion, Version from .. import _static from .._path import StrPath from ..errors import FileError, OptionError from ..warnings import SetuptoolsDeprecationWarning from . import expand if TYPE_CHECKING: from typing_extensions import TypeAlias from setuptools.dist import Distribution from distutils.dist import DistributionMetadata SingleCommandOptions: TypeAlias = dict[str, tuple[str, Any]] """Dict that associate the name of the options of a particular command to a tuple. The first element of the tuple indicates the origin of the option value (e.g. the name of the configuration file where it was read from), while the second element of the tuple is the option value itself """ AllCommandOptions: TypeAlias = dict[str, SingleCommandOptions] """cmd name => its options""" Target = TypeVar("Target", "Distribution", "DistributionMetadata") def read_configuration( filepath: StrPath, find_others: bool = False, ignore_option_errors: bool = False ) -> dict: """Read given configuration file and returns options from it as a dict. :param str|unicode filepath: Path to configuration file to get options from. :param bool find_others: Whether to search for other configuration files which could be on in various places. :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :rtype: dict """ from setuptools.dist import Distribution dist = Distribution() filenames = dist.find_config_files() if find_others else [] handlers = _apply(dist, filepath, filenames, ignore_option_errors) return configuration_to_dict(handlers) def apply_configuration(dist: Distribution, filepath: StrPath) -> Distribution: """Apply the configuration from a ``setup.cfg`` file into an existing distribution object. """ _apply(dist, filepath) dist._finalize_requires() return dist def _apply( dist: Distribution, filepath: StrPath, other_files: Iterable[StrPath] = (), ignore_option_errors: bool = False, ) -> tuple[ConfigMetadataHandler, ConfigOptionsHandler]: """Read configuration from ``filepath`` and applies to the ``dist`` object.""" from setuptools.dist import _Distribution filepath = os.path.abspath(filepath) if not os.path.isfile(filepath): raise FileError(f'Configuration file {filepath} does not exist.') current_directory = os.getcwd() os.chdir(os.path.dirname(filepath)) filenames = [*other_files, filepath] try: # TODO: Temporary cast until mypy 1.12 is released with upstream fixes from typeshed _Distribution.parse_config_files(dist, filenames=cast(list[str], filenames)) handlers = parse_configuration( dist, dist.command_options, ignore_option_errors=ignore_option_errors ) dist._finalize_license_files() finally: os.chdir(current_directory) return handlers def _get_option(target_obj: Distribution | DistributionMetadata, key: str): """ Given a target object and option key, get that option from the target object, either through a get_{key} method or from an attribute directly. """ getter_name = f'get_{key}' by_attribute = functools.partial(getattr, target_obj, key) getter = getattr(target_obj, getter_name, by_attribute) return getter() def configuration_to_dict( handlers: Iterable[ ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata] ], ) -> dict: """Returns configuration data gathered by given handlers as a dict. :param Iterable[ConfigHandler] handlers: Handlers list, usually from parse_configuration() :rtype: dict """ config_dict: dict = defaultdict(dict) for handler in handlers: for option in handler.set_options: value = _get_option(handler.target_obj, option) config_dict[handler.section_prefix][option] = value return config_dict def parse_configuration( distribution: Distribution, command_options: AllCommandOptions, ignore_option_errors: bool = False, ) -> tuple[ConfigMetadataHandler, ConfigOptionsHandler]: """Performs additional parsing of configuration options for a distribution. Returns a list of used option handlers. :param Distribution distribution: :param dict command_options: :param bool ignore_option_errors: Whether to silently ignore options, values of which could not be resolved (e.g. due to exceptions in directives such as file:, attr:, etc.). If False exceptions are propagated as expected. :rtype: list """ with expand.EnsurePackagesDiscovered(distribution) as ensure_discovered: options = ConfigOptionsHandler( distribution, command_options, ignore_option_errors, ensure_discovered, ) options.parse() if not distribution.package_dir: distribution.package_dir = options.package_dir # Filled by `find_packages` meta = ConfigMetadataHandler( distribution.metadata, command_options, ignore_option_errors, ensure_discovered, distribution.package_dir, distribution.src_root, ) meta.parse() distribution._referenced_files.update( options._referenced_files, meta._referenced_files ) return meta, options def _warn_accidental_env_marker_misconfig(label: str, orig_value: str, parsed: list): """Because users sometimes misinterpret this configuration: [options.extras_require] foo = bar;python_version<"4" It looks like one requirement with an environment marker but because there is no newline, it's parsed as two requirements with a semicolon as separator. Therefore, if: * input string does not contain a newline AND * parsed result contains two requirements AND * parsing of the two parts from the result ("<first>;<second>") leads in a valid Requirement with a valid marker a UserWarning is shown to inform the user about the possible problem. """ if "\n" in orig_value or len(parsed) != 2: return markers = marker_env().keys() try: req = Requirement(parsed[1]) if req.name in markers: _AmbiguousMarker.emit(field=label, req=parsed[1]) except InvalidRequirement as ex: if any(parsed[1].startswith(marker) for marker in markers): msg = _AmbiguousMarker.message(field=label, req=parsed[1]) raise InvalidRequirement(msg) from ex class ConfigHandler(Generic[Target]): """Handles metadata supplied in configuration files.""" section_prefix: str """Prefix for config sections handled by this handler. Must be provided by class heirs. """ aliases: ClassVar[dict[str, str]] = {} """Options aliases. For compatibility with various packages. E.g.: d2to1 and pbr. Note: `-` in keys is replaced with `_` by config parser. """ def __init__( self, target_obj: Target, options: AllCommandOptions, ignore_option_errors, ensure_discovered: expand.EnsurePackagesDiscovered, ) -> None: self.ignore_option_errors = ignore_option_errors self.target_obj: Target = target_obj self.sections = dict(self._section_options(options)) self.set_options: list[str] = [] self.ensure_discovered = ensure_discovered self._referenced_files = set[str]() """After parsing configurations, this property will enumerate all files referenced by the "file:" directive. Private API for setuptools only. """ @classmethod def _section_options( cls, options: AllCommandOptions ) -> Iterator[tuple[str, SingleCommandOptions]]: for full_name, value in options.items(): pre, _sep, name = full_name.partition(cls.section_prefix) if pre: continue yield name.lstrip('.'), value @property def parsers(self): """Metadata item name to parser function mapping.""" raise NotImplementedError( f'{self.__class__.__name__} must provide .parsers property' ) def __setitem__(self, option_name, value) -> None: target_obj = self.target_obj # Translate alias into real name. option_name = self.aliases.get(option_name, option_name) try: current_value = getattr(target_obj, option_name) except AttributeError as e: raise KeyError(option_name) from e if current_value: # Already inhabited. Skipping. return try: parsed = self.parsers.get(option_name, lambda x: x)(value) except (Exception,) * self.ignore_option_errors: return simple_setter = functools.partial(target_obj.__setattr__, option_name) setter = getattr(target_obj, f"set_{option_name}", simple_setter) setter(parsed) self.set_options.append(option_name) @classmethod def _parse_list(cls, value, separator=','): """Represents value as a list. Value is split either by separator (defaults to comma) or by lines. :param value: :param separator: List items separator character. :rtype: list """ if isinstance(value, list): # _get_parser_compound case return value if '\n' in value: value = value.splitlines() else: value = value.split(separator) return [chunk.strip() for chunk in value if chunk.strip()] @classmethod def _parse_dict(cls, value): """Represents value as a dict. :param value: :rtype: dict """ separator = '=' result = {} for line in cls._parse_list(value): key, sep, val = line.partition(separator) if sep != separator: raise OptionError(f"Unable to parse option value to dict: {value}") result[key.strip()] = val.strip() return result @classmethod def _parse_bool(cls, value): """Represents value as boolean. :param value: :rtype: bool """ value = value.lower() return value in ('1', 'true', 'yes') @classmethod def _exclude_files_parser(cls, key): """Returns a parser function to make sure field inputs are not files. Parses a value after getting the key so error messages are more informative. :param key: :rtype: callable """ def parser(value): exclude_directive = 'file:' if value.startswith(exclude_directive): raise ValueError( f'Only strings are accepted for the {key} field, ' 'files are not accepted' ) return _static.Str(value) return parser def _parse_file(self, value, root_dir: StrPath | None): """Represents value as a string, allowing including text from nearest files using `file:` directive. Directive is sandboxed and won't reach anything outside directory with setup.py. Examples: file: README.rst, CHANGELOG.md, src/file.txt :param str value: :rtype: str """ include_directive = 'file:' if not isinstance(value, str): return value if not value.startswith(include_directive): return _static.Str(value) spec = value[len(include_directive) :] filepaths = [path.strip() for path in spec.split(',')] self._referenced_files.update(filepaths) # XXX: Is marking as static contents coming from files too optimistic? return _static.Str(expand.read_files(filepaths, root_dir)) def _parse_attr(self, value, package_dir, root_dir: StrPath): """Represents value as a module attribute. Examples: attr: package.attr attr: package.module.attr :param str value: :rtype: str """ attr_directive = 'attr:' if not value.startswith(attr_directive): return _static.Str(value) attr_desc = value.replace(attr_directive, '') # Make sure package_dir is populated correctly, so `attr:` directives can work package_dir.update(self.ensure_discovered.package_dir) return expand.read_attr(attr_desc, package_dir, root_dir) @classmethod def _get_parser_compound(cls, *parse_methods): """Returns parser function to represents value as a list. Parses a value applying given methods one after another. :param parse_methods: :rtype: callable """ def parse(value): parsed = value for method in parse_methods: parsed = method(parsed) return parsed return parse @classmethod def _parse_section_to_dict_with_key(cls, section_options, values_parser): """Parses section options into a dictionary. Applies a given parser to each option in a section. :param dict section_options: :param callable values_parser: function with 2 args corresponding to key, value :rtype: dict """ value = {} for key, (_, val) in section_options.items(): value[key] = values_parser(key, val) return value @classmethod def _parse_section_to_dict(cls, section_options, values_parser=None): """Parses section options into a dictionary. Optionally applies a given parser to each value. :param dict section_options: :param callable values_parser: function with 1 arg corresponding to option value :rtype: dict """ parser = (lambda _, v: values_parser(v)) if values_parser else (lambda _, v: v) return cls._parse_section_to_dict_with_key(section_options, parser) def parse_section(self, section_options) -> None: """Parses configuration file section. :param dict section_options: """ for name, (_, value) in section_options.items(): with contextlib.suppress(KeyError): # Keep silent for a new option may appear anytime. self[name] = value def parse(self) -> None: """Parses configuration file items from one or more related sections. """ for section_name, section_options in self.sections.items(): method_postfix = '' if section_name: # [section.option] variant method_postfix = f"_{section_name}" section_parser_method: Callable | None = getattr( self, # Dots in section names are translated into dunderscores. f'parse_section{method_postfix}'.replace('.', '__'), None, ) if section_parser_method is None: raise OptionError( "Unsupported distribution option section: " f"[{self.section_prefix}.{section_name}]" ) section_parser_method(section_options) def _deprecated_config_handler(self, func, msg, **kw): """this function will wrap around parameters that are deprecated :param msg: deprecation message :param func: function to be wrapped around """ @wraps(func) def config_handler(*args, **kwargs): kw.setdefault("stacklevel", 2) _DeprecatedConfig.emit("Deprecated config in `setup.cfg`", msg, **kw) return func(*args, **kwargs) return config_handler class ConfigMetadataHandler(ConfigHandler["DistributionMetadata"]): section_prefix = 'metadata' aliases = { 'home_page': 'url', 'summary': 'description', 'classifier': 'classifiers', 'platform': 'platforms', } strict_mode = False """We need to keep it loose, to be partially compatible with `pbr` and `d2to1` packages which also uses `metadata` section. """ def __init__( self, target_obj: DistributionMetadata, options: AllCommandOptions, ignore_option_errors: bool, ensure_discovered: expand.EnsurePackagesDiscovered, package_dir: dict | None = None, root_dir: StrPath | None = os.curdir, ) -> None: super().__init__(target_obj, options, ignore_option_errors, ensure_discovered) self.package_dir = package_dir self.root_dir = root_dir @property def parsers(self): """Metadata item name to parser function mapping.""" parse_list_static = self._get_parser_compound(self._parse_list, _static.List) parse_dict_static = self._get_parser_compound(self._parse_dict, _static.Dict) parse_file = partial(self._parse_file, root_dir=self.root_dir) exclude_files_parser = self._exclude_files_parser return { 'author': _static.Str, 'author_email': _static.Str, 'maintainer': _static.Str, 'maintainer_email': _static.Str, 'platforms': parse_list_static, 'keywords': parse_list_static, 'provides': parse_list_static, 'obsoletes': parse_list_static, 'classifiers': self._get_parser_compound(parse_file, parse_list_static), 'license': exclude_files_parser('license'), 'license_files': parse_list_static, 'description': parse_file, 'long_description': parse_file, 'long_description_content_type': _static.Str, 'version': self._parse_version, # Cannot be marked as dynamic 'url': _static.Str, 'project_urls': parse_dict_static, } def _parse_version(self, value): """Parses `version` option value. :param value: :rtype: str """ version = self._parse_file(value, self.root_dir) if version != value: version = version.strip() # Be strict about versions loaded from file because it's easy to # accidentally include newlines and other unintended content try: Version(version) except InvalidVersion as e: raise OptionError( f'Version loaded from {value} does not ' f'comply with PEP 440: {version}' ) from e return version return expand.version(self._parse_attr(value, self.package_dir, self.root_dir)) class ConfigOptionsHandler(ConfigHandler["Distribution"]): section_prefix = 'options' def __init__( self, target_obj: Distribution, options: AllCommandOptions, ignore_option_errors: bool, ensure_discovered: expand.EnsurePackagesDiscovered, ) -> None: super().__init__(target_obj, options, ignore_option_errors, ensure_discovered) self.root_dir = target_obj.src_root self.package_dir: dict[str, str] = {} # To be filled by `find_packages` @classmethod def _parse_list_semicolon(cls, value): return cls._parse_list(value, separator=';') def _parse_file_in_root(self, value): return self._parse_file(value, root_dir=self.root_dir) def _parse_requirements_list(self, label: str, value: str): # Parse a requirements list, either by reading in a `file:`, or a list. parsed = self._parse_list_semicolon(self._parse_file_in_root(value)) _warn_accidental_env_marker_misconfig(label, value, parsed) # Filter it to only include lines that are not comments. `parse_list` # will have stripped each line and filtered out empties. return _static.List(line for line in parsed if not line.startswith("#")) # ^-- Use `_static.List` to mark a non-`Dynamic` Core Metadata @property def parsers(self): """Metadata item name to parser function mapping.""" parse_list = self._parse_list parse_bool = self._parse_bool parse_cmdclass = self._parse_cmdclass return { 'zip_safe': parse_bool, 'include_package_data': parse_bool, 'package_dir': self._parse_dict, 'scripts': parse_list, 'eager_resources': parse_list, 'dependency_links': parse_list, 'namespace_packages': self._deprecated_config_handler( parse_list, "The namespace_packages parameter is deprecated, " "consider using implicit namespaces instead (PEP 420).", # TODO: define due date, see setuptools.dist:check_nsp. ), 'install_requires': partial( # Core Metadata self._parse_requirements_list, "install_requires" ), 'setup_requires': self._parse_list_semicolon, 'packages': self._parse_packages, 'entry_points': self._parse_file_in_root, 'py_modules': parse_list, 'python_requires': _static.SpecifierSet, # Core Metadata 'cmdclass': parse_cmdclass, } def _parse_cmdclass(self, value): package_dir = self.ensure_discovered.package_dir return expand.cmdclass(self._parse_dict(value), package_dir, self.root_dir) def _parse_packages(self, value): """Parses `packages` option value. :param value: :rtype: list """ find_directives = ['find:', 'find_namespace:'] trimmed_value = value.strip() if trimmed_value not in find_directives: return self._parse_list(value) # Read function arguments from a dedicated section. find_kwargs = self.parse_section_packages__find( self.sections.get('packages.find', {}) ) find_kwargs.update( namespaces=(trimmed_value == find_directives[1]), root_dir=self.root_dir, fill_package_dir=self.package_dir, ) return expand.find_packages(**find_kwargs) def parse_section_packages__find(self, section_options): """Parses `packages.find` configuration file section. To be used in conjunction with _parse_packages(). :param dict section_options: """ section_data = self._parse_section_to_dict(section_options, self._parse_list) valid_keys = ['where', 'include', 'exclude'] find_kwargs = {k: v for k, v in section_data.items() if k in valid_keys and v} where = find_kwargs.get('where') if where is not None: find_kwargs['where'] = where[0] # cast list to single val return find_kwargs def parse_section_entry_points(self, section_options) -> None: """Parses `entry_points` configuration file section. :param dict section_options: """ parsed = self._parse_section_to_dict(section_options, self._parse_list) self['entry_points'] = parsed def _parse_package_data(self, section_options): package_data = self._parse_section_to_dict(section_options, self._parse_list) return expand.canonic_package_data(package_data) def parse_section_package_data(self, section_options) -> None: """Parses `package_data` configuration file section. :param dict section_options: """ self['package_data'] = self._parse_package_data(section_options) def parse_section_exclude_package_data(self, section_options) -> None: """Parses `exclude_package_data` configuration file section. :param dict section_options: """ self['exclude_package_data'] = self._parse_package_data(section_options) def parse_section_extras_require(self, section_options) -> None: # Core Metadata """Parses `extras_require` configuration file section. :param dict section_options: """ parsed = self._parse_section_to_dict_with_key( section_options, lambda k, v: self._parse_requirements_list(f"extras_require[{k}]", v), ) self['extras_require'] = _static.Dict(parsed) # ^-- Use `_static.Dict` to mark a non-`Dynamic` Core Metadata def parse_section_data_files(self, section_options) -> None: """Parses `data_files` configuration file section. :param dict section_options: """ parsed = self._parse_section_to_dict(section_options, self._parse_list) self['data_files'] = expand.canonic_data_files(parsed, self.root_dir) class _AmbiguousMarker(SetuptoolsDeprecationWarning): _SUMMARY = "Ambiguous requirement marker." _DETAILS = """ One of the parsed requirements in `{field}` looks like a valid environment marker: {req!r} Please make sure that the configuration file is correct. You can use dangling lines to avoid this problem. """ _SEE_DOCS = "userguide/declarative_config.html#opt-2" # TODO: should we include due_date here? Initially introduced in 6 Aug 2022. # Does this make sense with latest version of packaging? @classmethod def message(cls, **kw): docs = f"https://setuptools.pypa.io/en/latest/{cls._SEE_DOCS}" return cls._format(cls._SUMMARY, cls._DETAILS, see_url=docs, format_args=kw) class _DeprecatedConfig(SetuptoolsDeprecationWarning): _SEE_DOCS = "userguide/declarative_config.html" config/NOTICE 0000644 00000000755 15030122015 0006711 0 ustar 00 The following files include code from opensource projects (either as direct copies or modified versions): - `setuptools.schema.json`, `distutils.schema.json`: - project: `validate-pyproject` - licensed under MPL-2.0 (https://github.com/abravalheri/validate-pyproject): This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/. config/__init__.py 0000644 00000002733 15030122015 0010114 0 ustar 00 """For backward compatibility, expose main functions from ``setuptools.config.setupcfg`` """ from functools import wraps from typing import Callable, TypeVar, cast from ..warnings import SetuptoolsDeprecationWarning from . import setupcfg Fn = TypeVar("Fn", bound=Callable) __all__ = ('parse_configuration', 'read_configuration') def _deprecation_notice(fn: Fn) -> Fn: @wraps(fn) def _wrapper(*args, **kwargs): SetuptoolsDeprecationWarning.emit( "Deprecated API usage.", f""" As setuptools moves its configuration towards `pyproject.toml`, `{__name__}.{fn.__name__}` became deprecated. For the time being, you can use the `{setupcfg.__name__}` module to access a backward compatible API, but this module is provisional and might be removed in the future. To read project metadata, consider using ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). For simple scenarios, you can also try parsing the file directly with the help of ``configparser``. """, # due_date not defined yet, because the community still heavily relies on it # Warning introduced in 24 Mar 2022 ) return fn(*args, **kwargs) return cast(Fn, _wrapper) read_configuration = _deprecation_notice(setupcfg.read_configuration) parse_configuration = _deprecation_notice(setupcfg.parse_configuration) gui-arm64.exe 0000644 00000033000 15030122015 0006743 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ ���b���1���1���1��1���1��0���1�x1���1��0���1��0���1��0���1�0���1���1���1���0���1��z1���1���0���1Rich���1 PE d� �'hd � " $ @ � `� �8 � p � ` � $ �4 p3 @ 0 .text 4 `.rdata � 0 @ @.data � P . @ �.pdata ` 0 @ @.rsrc � p 2 @ @.reloc $ � 4 @ B �C �1 �1@��c1�� ��_� 1 ��@�1@��c0� � T�C ��_� ��� �{��C � ��{A��_� 0 �" �@� �A T�_�{��� �0 �" �1 �1 �@�1@��G�! � >� � ( � ��_� �{��� � 5( � !@�� 4 � @� �R ?� �R�{���_� �S��� ������ ��{��� �� ����� ��� @� �������� ��@� ?�{��� @��SŨ�_� �S���[��c��{��� �� �i�9�����*i 4 �8�5� � q� T�" �� Q �@�i�9� �i 4I �8�5I K) ! Q���5 �i@�! �� |@�� Q ?� �a ���� �& �i�9���" �� 4 �8�5�" �˟ q- T �@� �3��r � �ɂ_�*�9� �j 4 �8�5 K � QU��5���{���cB��[A��Sè�_� " �R� �S���[��c��k��# ��{��� �� �i�9����i 4 �8�5 � �i@��� ?� � ��@���� � �`�9 �R �R ?� 4 �` �8(�@� ?֠��5 � �t�8� 4h�@��* ?�@ 4 4�rqa T� ����� q T� ra T_ q�� q���~� 4�*� �R��r ��B6� �R���4� 8�� 4�*� �R��h ��B6� �R� 8���( � �( �{(�� 4`�9(�@� ?� 4 �` �8��@� ?֠��5h�9H��5���{���#@��kC��cB��[A��SŨ�_��S���[��c�� ��{��� �� �i�9��i 4 �8�5˨z� � �i@�! �� ?�X�R �R� �� 9� �� q� T� �Rh�9 qqa T� � qa T� q� T�*� �R��$ ��B6� �R� 8 �Rh�8� Q� 8u��5� q� T�*� �R�� ��B6�� y���{���@��cB��[A��SĨ�_�{���S��[��c��k��+ �� �������� �@�� *���* �R�� �� ?� �@� ���Rd �R ��" �R �R�� ?� �@� �R �R�� ?���9��i 4 �8�5�� ���(��� �) T�� �9_� q� T 9 � �H��T 9 �� ���9��j 4* �8�5��R* 9)� �8*i(8��5 �R�� �� *� 1a T ��@�@ �R ?� �� �������@ �R ��� ��* �� �� ��* �� � � � �� T �9? q$Jz$Mz!��T 9 � � �A�B ��� � ?� 4 � ! �(@��W�( @���(1�9�� 9�S �� ���� �@���9��) 4� �R�� �?� qA Tj 9 �9I��5 �Y@��������C ��� ?��C�9h 5��9 qq T �Y@��������C ��� ?���9��i 4 �8�5�� ���*�H � �9?qq� TI��8H �?qq T�� � T 9 ��8_qqa��T �]@� �������C ��� ?� �i@�! �Ҁ �� ?��� �i@�! �Ҁ �� ?��� ��@�� �� � ?֗ � ��@�@ �R@� ?� �a ���!���@ �R| �@��Һ H@� � �i@� ?� ������6# � � q- T # �x Q� �`�@���� Q�� ����5������" �� �� q Ts" �� Q`�@����� Q � ����5 ������ 4 ��@� ?� ��@�@ �R ?� � �����@ �RG �*� ������ O��� �! �R� �=� �� OA �A�A�a � �R�C � � a� �@� ?�� �� ���� � �@� �� �� �R$ �R �� ���� �� ?�@ 5 ��@�@ �R ?� �A ����� �R �3@�( � ! � � @��@� � ?� � @��@��S � ?�@ 5 ��@�@ �R ?� �� ����� �R �@����f����+@��kD��cC��[B��SA��{ƨ�_��S��� ������ ��{��� �� ����� �~��� @����� ���� @� ��@� �� ?� q ��Z�{��� @��SŨ�_� #�{��� �h @��� �~�(ia�(�� ! �L��� �R�{���#�_� #�� ��{��� � �R� �� �� �� �� *� � � �R� � S� 42 � � !�k �� �� �� 5� �� �� 4 � � �} �� �� �� �� �� � SH 4{ �� �� �� 5�{���A��#�_�� �R� � >� #�{��� �� � �R�{���#�_�#�{��� �� �� �� ��{���#�_� #��S��� ��{��� � �R� � SH 4 �R�C 9i � S3 �h*@� q� Th 5( �Rh* � �� � � ! �N �` 4� �RB � � � ��C �H �Rh* � 5 �R�C 9�*� �� �� �h@�� �� � SH 4h@� ��A �R ���� �1 A� ?��?�t �� �h@�� �� � Sh 4`@�8 � �� � � @� � @�����E���� *i � S( 4U 5# � �R �R� ��* � *^ � S 4�C@9H 5 ��*�{¨� @��S¨�#�_�� �RM �� �RK ��* ��* � >� #�{��� �� ������{���#�_�#�{��� �� �� 4�� @�( � � � ?�` TH�_�h �I�ȱ��5�;�(��� �R�{���#�_� �R���#�{��� �) �(�@9 q�(� 9� �� � Sh 5 �R � � S� 5 �R� ���� �R�{���#�_�#��S���{��� �3 �h�A9� *h 5� q� T� �� 4t 5( � � �� �� 5( � A�� �� 4 �R ( �� � �� % � �( �A� % � �( �Rh�9 �R�{���S���#�_֠ �R� � >�#�{��� ��I�R�� �h@y k� Th=@�j�(� ��RH@� k! TH1@y -q� T �H)@y �a �I @y ��+! �� � �@ T @��A*� T @�) �A)� T� ���� ��h � �R %@�h �6 �R �R �R �R�{¨�#�_� #�� ��{��� � S1 �� 4� 5 �� � ��ȿ;�{���A��#�_�#�� ��{��� � ��@9 S) SH 4� 5�*c ��*a � �R�{���A��#�_� #�� ��{��� � �( @�� � �a TY � �� � �R � q`���{���A��#�_�#�{��� ��� ���Z�{���#�_� #��S���{��� � �h@� X � T� � �)@��c � ?��@�� � �%@� ?�� @� |@�(�� � �!@� ?�� @� |@�� �(�� � �-@� ?��@��#@� � �� @�)��C �(� �@�?� X��h ��(� � ��{è�S���#�_� �2��-�+ 3��-�+ �R�_� �R�_� �R�_� � �� �1@� � �_� � ��_� #�{��� �������� @�(� �� @�� ��{���#�_� �@� q���_� � A��_� � !��_� ` >�_��� #�{��� � �9@� �� ?֠ � @y�I�R k! T<@� ��R �(�H@� ka TH1@y -q TH�@� 9 q� TH�@� q�� �R�{���#�_� � !� �5@� � #��S���{��� �� ��@�� h@� k� Th@� q! Ti"@�� (K q) TH ?k� T �R�{���S���#�_�Q � ��@�Q � �� � >� �csm� � @� #��S���{��� � � � � �� �(! �3! � �B Th�@�� ��� �1 A� ?��?����T�{���S���#�_� #��S���{��� � � � � � �(! �3! � �B Th�@�� ��� �1 A� ?��?����T�{���S���#�_� �C �� �@ �R` >�C ��_� �@� q���_� �F@� � �B@� � �J@� � �N@� � ��@� � ��@� � ��@� � ��@� � �z@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � �r@� � �f@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � ��@� � �R@� �#�{����� �( @� @����� �{���#�_�a �#�{���� @� @�� ?k���{���#�_�a � � �; �; �; �; < < .< F< ^@ t@ �@ D@ �@ �@ �@ z< p< �< �< �@ �< �< �> �< �> �= ? > H> R> \> �= �= > �> �> 2> ? �< = *> �= �= |= �> D= ? ,? $? *= = �> :> r= h= ^= �" @ � @ �& @ 8 @ X @ @ failed to create process. failed to get exit code from process. %s %s -script.pyw Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s �P @ 0Q @ @ P @ 2 @ 2 @ 2 @ (2 @ �'hd h 5 ! � .text � .text$mn �& d .text$x 0 .idata$5 2 .00cfg 02 .CRT$XCA 82 .CRT$XCAA @2 .CRT$XCZ H2 .CRT$XIA P2 .CRT$XIAA X2 .CRT$XIAC `2 .CRT$XIZ h2 .CRT$XPA p2 .CRT$XPZ x2 .CRT$XTA �2 .CRT$XTZ �2 p .rdata 5 h .rdata$zzzdbg h7 .rtc$IAA p7 .rtc$IZZ x7 .rtc$TAA �7 .rtc$TZZ �7 8 .xdata �8 � .idata$2 �9 .idata$3 �9 .idata$4 �; F .idata$6 P .data P � .bss ` .pdata p ` .rsrc$01 `p � .rsrc$02 `"����Ђ*�Ђ*��� `"����Ђ*�Ђ*���^0 �� Ɉ�Ȅ������ ���� @ � �� @ @ ���� @ �B�B� / @( @ ������k P] @ �Ђ$���h% � � �& � � �& � @ ���� @ @ �� �� 5 p��h% � \ ' \ @ ���� @ @ ��* @# @ �"�����% @ @ �"����� � �9 b< 0 : �< �0 h: 6? �0 P: V? �0 �: |? 1 H; �? �1 �; �? �1 �: �? �0 �: @ �0 �: "@ 1 �; �; �; �; < < .< F< ^@ t@ �@ D@ �@ �@ �@ z< p< �< �< �@ �< �< �> �< �> �= ? > H> R> \> �= �= > �> �> 2> ? �< = *> �= �= |= �> D= ? ,? $? *= = �> :> r= h= ^= � CreateFileA iGetFinalPathNameByHandleA WaitForSingleObject VGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll = memset __C_specific_handler __current_exception __current_exception_context VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace @ _seh_filter_exe B _set_app_type __setusermatherr _configure_narrow_argv 3 _initialize_narrow_environment ( _get_initial_narrow_environment 6 _initterm 7 _initterm_e U exit # _exit T _set_fmode _cexit _c_exit = _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 4 _initialize_onexit_table < _register_onexit_function _crt_atexit g terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll kQueryPerformanceCounter 2GetCurrentProcessId 6GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �SetUnhandledExceptionFilter �GetModuleHandleW ; memcpy �] �f��2��-�+ ���� �7 �7 P �7 p L8 � X8 � �8 � 5 � �7 p %f� �i0 �0 �7 � �7 = � X �7 ! � 8 % � ` 8 ! � 0 �8 � a � � �8 � `8 p A A� M A ! Q AP! % � x! � B�" = � 0# � � �# �8 `$ e B�$ e B0% � �& @8 ' �8 � 0 � H `p } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 0 $ ��(�8�P�X�X�`�ȣ�裠��� _entry_points.py 0000644 00000004406 15030122015 0010003 0 ustar 00 import functools import itertools import operator from jaraco.functools import pass_none from jaraco.text import yield_lines from more_itertools import consume from ._importlib import metadata from ._itertools import ensure_unique from .errors import OptionError def ensure_valid(ep): """ Exercise one of the dynamic properties to trigger the pattern match. """ try: ep.extras except (AttributeError, AssertionError) as ex: # Why both? See https://github.com/python/importlib_metadata/issues/488 msg = ( f"Problems to parse {ep}.\nPlease ensure entry-point follows the spec: " "https://packaging.python.org/en/latest/specifications/entry-points/" ) raise OptionError(msg) from ex def load_group(value, group): """ Given a value of an entry point or series of entry points, return each as an EntryPoint. """ # normalize to a single sequence of lines lines = yield_lines(value) text = f'[{group}]\n' + '\n'.join(lines) return metadata.EntryPoints._from_text(text) def by_group_and_name(ep): return ep.group, ep.name def validate(eps: metadata.EntryPoints): """ Ensure entry points are unique by group and name and validate each. """ consume(map(ensure_valid, ensure_unique(eps, key=by_group_and_name))) return eps @functools.singledispatch def load(eps): """ Given a Distribution.entry_points, produce EntryPoints. """ groups = itertools.chain.from_iterable( load_group(value, group) for group, value in eps.items() ) return validate(metadata.EntryPoints(groups)) @load.register(str) def _(eps): r""" >>> ep, = load('[console_scripts]\nfoo=bar') >>> ep.group 'console_scripts' >>> ep.name 'foo' >>> ep.value 'bar' """ return validate(metadata.EntryPoints(metadata.EntryPoints._from_text(eps))) load.register(type(None), lambda x: x) @pass_none def render(eps: metadata.EntryPoints): by_group = operator.attrgetter('group') groups = itertools.groupby(sorted(eps, key=by_group), by_group) return '\n'.join(f'[{group}]\n{render_items(items)}\n' for group, items in groups) def render_items(eps): return '\n'.join(f'{ep.name} = {ep.value}' for ep in sorted(eps)) _vendor/tomli-2.0.1.dist-info/RECORD 0000644 00000001747 15030122015 0012552 0 ustar 00 tomli-2.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 tomli-2.0.1.dist-info/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 tomli-2.0.1.dist-info/METADATA,sha256=zPDceKmPwJGLWtZykrHixL7WVXWmJGzZ1jyRT5lCoPI,8875 tomli-2.0.1.dist-info/RECORD,, tomli-2.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 tomli-2.0.1.dist-info/WHEEL,sha256=jPMR_Dzkc4X4icQtmz81lnNY_kAsfog7ry7qoRvYLXw,81 tomli/__init__.py,sha256=JhUwV66DB1g4Hvt1UQCVMdfCu-IgAV8FXmvDU9onxd4,396 tomli/__pycache__/__init__.cpython-312.pyc,, tomli/__pycache__/_parser.cpython-312.pyc,, tomli/__pycache__/_re.cpython-312.pyc,, tomli/__pycache__/_types.cpython-312.pyc,, tomli/_parser.py,sha256=g9-ENaALS-B8dokYpCuzUFalWlog7T-SIYMjLZSWrtM,22633 tomli/_re.py,sha256=dbjg5ChZT23Ka9z9DHOXfdtSpPwUfdgMXnj8NOoly-w,2943 tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 _vendor/tomli-2.0.1.dist-info/METADATA 0000644 00000021253 15030122015 0012746 0 ustar 00 Metadata-Version: 2.1 Name: tomli Version: 2.0.1 Summary: A lil' TOML parser Keywords: toml Author-email: Taneli Hukkinen <hukkin@users.noreply.github.com> Requires-Python: >=3.7 Description-Content-Type: text/markdown Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: MacOS Classifier: Operating System :: Microsoft :: Windows Classifier: Operating System :: POSIX :: Linux Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: Implementation :: CPython Classifier: Programming Language :: Python :: Implementation :: PyPy Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Typing :: Typed Project-URL: Changelog, https://github.com/hukkin/tomli/blob/master/CHANGELOG.md Project-URL: Homepage, https://github.com/hukkin/tomli [](https://github.com/hukkin/tomli/actions?query=workflow%3ATests+branch%3Amaster+event%3Apush) [](https://codecov.io/gh/hukkin/tomli) [](https://pypi.org/project/tomli) # Tomli > A lil' TOML parser **Table of Contents** *generated with [mdformat-toc](https://github.com/hukkin/mdformat-toc)* <!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 --> - [Intro](#intro) - [Installation](#installation) - [Usage](#usage) - [Parse a TOML string](#parse-a-toml-string) - [Parse a TOML file](#parse-a-toml-file) - [Handle invalid TOML](#handle-invalid-toml) - [Construct `decimal.Decimal`s from TOML floats](#construct-decimaldecimals-from-toml-floats) - [FAQ](#faq) - [Why this parser?](#why-this-parser) - [Is comment preserving round-trip parsing supported?](#is-comment-preserving-round-trip-parsing-supported) - [Is there a `dumps`, `write` or `encode` function?](#is-there-a-dumps-write-or-encode-function) - [How do TOML types map into Python types?](#how-do-toml-types-map-into-python-types) - [Performance](#performance) <!-- mdformat-toc end --> ## Intro<a name="intro"></a> Tomli is a Python library for parsing [TOML](https://toml.io). Tomli is fully compatible with [TOML v1.0.0](https://toml.io/en/v1.0.0). ## Installation<a name="installation"></a> ```bash pip install tomli ``` ## Usage<a name="usage"></a> ### Parse a TOML string<a name="parse-a-toml-string"></a> ```python import tomli toml_str = """ gretzky = 99 [kurri] jari = 17 """ toml_dict = tomli.loads(toml_str) assert toml_dict == {"gretzky": 99, "kurri": {"jari": 17}} ``` ### Parse a TOML file<a name="parse-a-toml-file"></a> ```python import tomli with open("path_to_file/conf.toml", "rb") as f: toml_dict = tomli.load(f) ``` The file must be opened in binary mode (with the `"rb"` flag). Binary mode will enforce decoding the file as UTF-8 with universal newlines disabled, both of which are required to correctly parse TOML. ### Handle invalid TOML<a name="handle-invalid-toml"></a> ```python import tomli try: toml_dict = tomli.loads("]] this is invalid TOML [[") except tomli.TOMLDecodeError: print("Yep, definitely not valid.") ``` Note that error messages are considered informational only. They should not be assumed to stay constant across Tomli versions. ### Construct `decimal.Decimal`s from TOML floats<a name="construct-decimaldecimals-from-toml-floats"></a> ```python from decimal import Decimal import tomli toml_dict = tomli.loads("precision-matters = 0.982492", parse_float=Decimal) assert toml_dict["precision-matters"] == Decimal("0.982492") ``` Note that `decimal.Decimal` can be replaced with another callable that converts a TOML float from string to a Python type. The `decimal.Decimal` is, however, a practical choice for use cases where float inaccuracies can not be tolerated. Illegal types are `dict` and `list`, and their subtypes. A `ValueError` will be raised if `parse_float` produces illegal types. ## FAQ<a name="faq"></a> ### Why this parser?<a name="why-this-parser"></a> - it's lil' - pure Python with zero dependencies - the fastest pure Python parser [\*](#performance): 15x as fast as [tomlkit](https://pypi.org/project/tomlkit/), 2.4x as fast as [toml](https://pypi.org/project/toml/) - outputs [basic data types](#how-do-toml-types-map-into-python-types) only - 100% spec compliant: passes all tests in [a test set](https://github.com/toml-lang/compliance/pull/8) soon to be merged to the official [compliance tests for TOML](https://github.com/toml-lang/compliance) repository - thoroughly tested: 100% branch coverage ### Is comment preserving round-trip parsing supported?<a name="is-comment-preserving-round-trip-parsing-supported"></a> No. The `tomli.loads` function returns a plain `dict` that is populated with builtin types and types from the standard library only. Preserving comments requires a custom type to be returned so will not be supported, at least not by the `tomli.loads` and `tomli.load` functions. Look into [TOML Kit](https://github.com/sdispater/tomlkit) if preservation of style is what you need. ### Is there a `dumps`, `write` or `encode` function?<a name="is-there-a-dumps-write-or-encode-function"></a> [Tomli-W](https://github.com/hukkin/tomli-w) is the write-only counterpart of Tomli, providing `dump` and `dumps` functions. The core library does not include write capability, as most TOML use cases are read-only, and Tomli intends to be minimal. ### How do TOML types map into Python types?<a name="how-do-toml-types-map-into-python-types"></a> | TOML type | Python type | Details | | ---------------- | ------------------- | ------------------------------------------------------------ | | Document Root | `dict` | | | Key | `str` | | | String | `str` | | | Integer | `int` | | | Float | `float` | | | Boolean | `bool` | | | Offset Date-Time | `datetime.datetime` | `tzinfo` attribute set to an instance of `datetime.timezone` | | Local Date-Time | `datetime.datetime` | `tzinfo` attribute set to `None` | | Local Date | `datetime.date` | | | Local Time | `datetime.time` | | | Array | `list` | | | Table | `dict` | | | Inline Table | `dict` | | ## Performance<a name="performance"></a> The `benchmark/` folder in this repository contains a performance benchmark for comparing the various Python TOML parsers. The benchmark can be run with `tox -e benchmark-pypi`. Running the benchmark on my personal computer output the following: ```console foo@bar:~/dev/tomli$ tox -e benchmark-pypi benchmark-pypi installed: attrs==19.3.0,click==7.1.2,pytomlpp==1.0.2,qtoml==0.3.0,rtoml==0.7.0,toml==0.10.2,tomli==1.1.0,tomlkit==0.7.2 benchmark-pypi run-test-pre: PYTHONHASHSEED='2658546909' benchmark-pypi run-test: commands[0] | python -c 'import datetime; print(datetime.date.today())' 2021-07-23 benchmark-pypi run-test: commands[1] | python --version Python 3.8.10 benchmark-pypi run-test: commands[2] | python benchmark/run.py Parsing data.toml 5000 times: ------------------------------------------------------ parser | exec time | performance (more is better) -----------+------------+----------------------------- rtoml | 0.901 s | baseline (100%) pytomlpp | 1.08 s | 83.15% tomli | 3.89 s | 23.15% toml | 9.36 s | 9.63% qtoml | 11.5 s | 7.82% tomlkit | 56.8 s | 1.59% ``` The parsers are ordered from fastest to slowest, using the fastest parser as baseline. Tomli performed the best out of all pure Python TOML parsers, losing only to pytomlpp (wraps C++) and rtoml (wraps Rust). _vendor/tomli-2.0.1.dist-info/INSTALLER 0000644 00000000004 15030122015 0013112 0 ustar 00 pip _vendor/tomli-2.0.1.dist-info/WHEEL 0000644 00000000121 15030122015 0012421 0 ustar 00 Wheel-Version: 1.0 Generator: flit 3.6.0 Root-Is-Purelib: true Tag: py3-none-any _vendor/tomli-2.0.1.dist-info/LICENSE 0000644 00000002060 15030122015 0012643 0 ustar 00 MIT License Copyright (c) 2021 Taneli Hukkinen Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/tomli-2.0.1.dist-info/REQUESTED 0000644 00000000000 15030122015 0013112 0 ustar 00 _vendor/wheel-0.45.1.dist-info/LICENSE.txt 0000644 00000002123 15030122015 0013530 0 ustar 00 MIT License Copyright (c) 2012 Daniel Holth <dholth@fastmail.fm> and contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/wheel-0.45.1.dist-info/RECORD 0000644 00000011444 15030122015 0012614 0 ustar 00 ../../bin/wheel,sha256=pBhV19bQIgjS-r541fG3kLU6QtcyKaKdQ2RE9YIzeiU,249 wheel-0.45.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 wheel-0.45.1.dist-info/LICENSE.txt,sha256=MMI2GGeRCPPo6h0qZYx8pBe9_IkcmO8aifpP8MmChlQ,1107 wheel-0.45.1.dist-info/METADATA,sha256=mKz84H7m7jsxJyzeIcTVORiTb0NPMV39KvOIYhGgmjA,2313 wheel-0.45.1.dist-info/RECORD,, wheel-0.45.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 wheel-0.45.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 wheel-0.45.1.dist-info/entry_points.txt,sha256=rTY1BbkPHhkGMm4Q3F0pIzJBzW2kMxoG1oriffvGdA0,104 wheel/__init__.py,sha256=mrxMnvdXACur_LWegbUfh5g5ysWZrd63UJn890wvGNk,59 wheel/__main__.py,sha256=NkMUnuTCGcOkgY0IBLgBCVC_BGGcWORx2K8jYGS12UE,455 wheel/__pycache__/__init__.cpython-311.pyc,, wheel/__pycache__/__main__.cpython-311.pyc,, wheel/__pycache__/_bdist_wheel.cpython-311.pyc,, wheel/__pycache__/_setuptools_logging.cpython-311.pyc,, wheel/__pycache__/bdist_wheel.cpython-311.pyc,, wheel/__pycache__/macosx_libfile.cpython-311.pyc,, wheel/__pycache__/metadata.cpython-311.pyc,, wheel/__pycache__/util.cpython-311.pyc,, wheel/__pycache__/wheelfile.cpython-311.pyc,, wheel/_bdist_wheel.py,sha256=UghCQjSH_pVfcZh6oRjzSw_TQhcf3anSx1OkiLSL82M,21694 wheel/_setuptools_logging.py,sha256=-5KC-lne0ilOUWIDfOkqapUWGMFZhuKYDIavIZiB5kM,781 wheel/bdist_wheel.py,sha256=tpf9WufiSO1RuEMg5oPhIfSG8DMziCZ_4muCKF69Cqo,1107 wheel/cli/__init__.py,sha256=Npq6_jKi03dhIcRnmbuFhwviVJxwO0tYEnEhWMv9cJo,4402 wheel/cli/__pycache__/__init__.cpython-311.pyc,, wheel/cli/__pycache__/convert.cpython-311.pyc,, wheel/cli/__pycache__/pack.cpython-311.pyc,, wheel/cli/__pycache__/tags.cpython-311.pyc,, wheel/cli/__pycache__/unpack.cpython-311.pyc,, wheel/cli/convert.py,sha256=Bi0ntEXb9nTllCxWeTRQ4j-nPs3szWSEKipG_GgnMkQ,12634 wheel/cli/pack.py,sha256=CAFcHdBVulvsHYJlndKVO7KMI9JqBTZz5ii0PKxxCOs,3103 wheel/cli/tags.py,sha256=lHw-LaWrkS5Jy_qWcw-6pSjeNM6yAjDnqKI3E5JTTCU,4760 wheel/cli/unpack.py,sha256=Y_J7ynxPSoFFTT7H0fMgbBlVErwyDGcObgme5MBuz58,1021 wheel/macosx_libfile.py,sha256=k1x7CE3LPtOVGqj6NXQ1nTGYVPaeRrhVzUG_KPq3zDs,16572 wheel/metadata.py,sha256=JC4p7jlQZu2bUTAQ2fevkqLjg_X6gnNyRhLn6OUO1tc,6171 wheel/util.py,sha256=aL7aibHwYUgfc8WlolL5tXdkV4DatbJxZHb1kwHFJAU,423 wheel/vendored/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 wheel/vendored/__pycache__/__init__.cpython-311.pyc,, wheel/vendored/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 wheel/vendored/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 wheel/vendored/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 wheel/vendored/packaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 wheel/vendored/packaging/__pycache__/__init__.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_elffile.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_manylinux.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_musllinux.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_parser.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_structures.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/_tokenizer.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/markers.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/requirements.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/specifiers.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/tags.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/utils.cpython-311.pyc,, wheel/vendored/packaging/__pycache__/version.cpython-311.pyc,, wheel/vendored/packaging/_elffile.py,sha256=hbmK8OD6Z7fY6hwinHEUcD1by7czkGiNYu7ShnFEk2k,3266 wheel/vendored/packaging/_manylinux.py,sha256=P7sdR5_7XBY09LVYYPhHmydMJIIwPXWsh4olk74Uuj4,9588 wheel/vendored/packaging/_musllinux.py,sha256=z1s8To2hQ0vpn_d-O2i5qxGwEK8WmGlLt3d_26V7NeY,2674 wheel/vendored/packaging/_parser.py,sha256=4tT4emSl2qTaU7VTQE1Xa9o1jMPCsBezsYBxyNMUN-s,10347 wheel/vendored/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 wheel/vendored/packaging/_tokenizer.py,sha256=alCtbwXhOFAmFGZ6BQ-wCTSFoRAJ2z-ysIf7__MTJ_k,5292 wheel/vendored/packaging/markers.py,sha256=_TSPI1BhJYO7Bp9AzTmHQxIqHEVXaTjmDh9G-w8qzPA,8232 wheel/vendored/packaging/requirements.py,sha256=dgoBeVprPu2YE6Q8nGfwOPTjATHbRa_ZGLyXhFEln6Q,2933 wheel/vendored/packaging/specifiers.py,sha256=IWSt0SrLSP72heWhAC8UL0eGvas7XIQHjqiViVfmPKE,39778 wheel/vendored/packaging/tags.py,sha256=fedHXiOHkBxNZTXotXv8uXPmMFU9ae-TKBujgYHigcA,18950 wheel/vendored/packaging/utils.py,sha256=XgdmP3yx9-wQEFjO7OvMj9RjEf5JlR5HFFR69v7SQ9E,5268 wheel/vendored/packaging/version.py,sha256=PFJaYZDxBgyxkfYhH3SQw4qfE9ICCWrTmitvq14y3bs,16234 wheel/vendored/vendor.txt,sha256=Z2ENjB1i5prfez8CdM1Sdr3c6Zxv2rRRolMpLmBncAE,16 wheel/wheelfile.py,sha256=USCttNlJwafxt51YYFFKG7jnxz8dfhbyqAZL6jMTA9s,8411 _vendor/wheel-0.45.1.dist-info/METADATA 0000644 00000004411 15030122015 0013012 0 ustar 00 Metadata-Version: 2.3 Name: wheel Version: 0.45.1 Summary: A built-package format for Python Keywords: wheel,packaging Author-email: Daniel Holth <dholth@fastmail.fm> Maintainer-email: Alex Grönholm <alex.gronholm@nextday.fi> Requires-Python: >=3.8 Description-Content-Type: text/x-rst Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: Topic :: System :: Archiving :: Packaging Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Requires-Dist: pytest >= 6.0.0 ; extra == "test" Requires-Dist: setuptools >= 65 ; extra == "test" Project-URL: Changelog, https://wheel.readthedocs.io/en/stable/news.html Project-URL: Documentation, https://wheel.readthedocs.io/ Project-URL: Issue Tracker, https://github.com/pypa/wheel/issues Project-URL: Source, https://github.com/pypa/wheel Provides-Extra: test wheel ===== This is a command line tool for manipulating Python wheel files, as defined in `PEP 427`_. It contains the following functionality: * Convert ``.egg`` archives into ``.whl`` * Unpack wheel archives * Repack wheel archives * Add or remove tags in existing wheel archives .. _PEP 427: https://www.python.org/dev/peps/pep-0427/ Historical note --------------- This project used to contain the implementation of the setuptools_ ``bdist_wheel`` command, but as of setuptools v70.1, it no longer needs ``wheel`` installed for that to work. Thus, you should install this **only** if you intend to use the ``wheel`` command line tool! .. _setuptools: https://pypi.org/project/setuptools/ Documentation ------------- The documentation_ can be found on Read The Docs. .. _documentation: https://wheel.readthedocs.io/ Code of Conduct --------------- Everyone interacting in the wheel project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. .. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md _vendor/wheel-0.45.1.dist-info/INSTALLER 0000644 00000000004 15030122015 0013161 0 ustar 00 pip _vendor/wheel-0.45.1.dist-info/WHEEL 0000644 00000000122 15030122015 0012471 0 ustar 00 Wheel-Version: 1.0 Generator: flit 3.10.1 Root-Is-Purelib: true Tag: py3-none-any _vendor/wheel-0.45.1.dist-info/entry_points.txt 0000644 00000000150 15030122015 0015201 0 ustar 00 [console_scripts] wheel=wheel.cli:main [distutils.commands] bdist_wheel=wheel.bdist_wheel:bdist_wheel _vendor/wheel-0.45.1.dist-info/REQUESTED 0000644 00000000000 15030122015 0013161 0 ustar 00 _vendor/jaraco.text-3.12.1.dist-info/RECORD 0000644 00000002734 15030122015 0013731 0 ustar 00 jaraco.text-3.12.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 jaraco.text-3.12.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 jaraco.text-3.12.1.dist-info/METADATA,sha256=AzWdm6ViMfDOPoQMfLWn2zgBQSGJScyqeN29TcuWXVI,3658 jaraco.text-3.12.1.dist-info/RECORD,, jaraco.text-3.12.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 jaraco.text-3.12.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 jaraco.text-3.12.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 jaraco/text/Lorem ipsum.txt,sha256=N_7c_79zxOufBY9HZ3yzMgOkNv-TkOTTio4BydrSjgs,1335 jaraco/text/__init__.py,sha256=Y2YUqXR_orUoDaY4SkPRe6ZZhb5HUHB_Ah9RCNsVyho,16250 jaraco/text/__pycache__/__init__.cpython-312.pyc,, jaraco/text/__pycache__/layouts.cpython-312.pyc,, jaraco/text/__pycache__/show-newlines.cpython-312.pyc,, jaraco/text/__pycache__/strip-prefix.cpython-312.pyc,, jaraco/text/__pycache__/to-dvorak.cpython-312.pyc,, jaraco/text/__pycache__/to-qwerty.cpython-312.pyc,, jaraco/text/layouts.py,sha256=HTC8aSTLZ7uXipyOXapRMC158juecjK6RVwitfmZ9_w,643 jaraco/text/show-newlines.py,sha256=WGQa65e8lyhb92LUOLqVn6KaCtoeVgVws6WtSRmLk6w,904 jaraco/text/strip-prefix.py,sha256=NfVXV8JVNo6nqcuYASfMV7_y4Eo8zMQqlCOGvAnRIVw,412 jaraco/text/to-dvorak.py,sha256=1SNcbSsvISpXXg-LnybIHHY-RUFOQr36zcHkY1pWFqw,119 jaraco/text/to-qwerty.py,sha256=s4UMQUnPwFn_dB5uZC27BurHOQcYondBfzIpVL5pEzw,119 _vendor/jaraco.text-3.12.1.dist-info/METADATA 0000644 00000007112 15030122015 0014126 0 ustar 00 Metadata-Version: 2.1 Name: jaraco.text Version: 3.12.1 Summary: Module for text manipulation Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Homepage, https://github.com/jaraco/jaraco.text Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: jaraco.functools Requires-Dist: jaraco.context >=4.1 Requires-Dist: autocommand Requires-Dist: inflect Requires-Dist: more-itertools Requires-Dist: importlib-resources ; python_version < "3.9" Provides-Extra: doc Requires-Dist: sphinx >=3.5 ; extra == 'doc' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' Requires-Dist: rst.linker >=1.9 ; extra == 'doc' Requires-Dist: furo ; extra == 'doc' Requires-Dist: sphinx-lint ; extra == 'doc' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' Provides-Extra: test Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' Requires-Dist: pytest-cov ; extra == 'test' Requires-Dist: pytest-mypy ; extra == 'test' Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' Requires-Dist: pathlib2 ; (python_version < "3.10") and extra == 'test' .. image:: https://img.shields.io/pypi/v/jaraco.text.svg :target: https://pypi.org/project/jaraco.text .. image:: https://img.shields.io/pypi/pyversions/jaraco.text.svg .. image:: https://github.com/jaraco/jaraco.text/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/jaraco.text/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/jaracotext/badge/?version=latest :target: https://jaracotext.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/jaraco.text :target: https://tidelift.com/subscription/pkg/pypi-jaraco.text?utm_source=pypi-jaraco.text&utm_medium=readme This package provides handy routines for dealing with text, such as wrapping, substitution, trimming, stripping, prefix and suffix removal, line continuation, indentation, comment processing, identifier processing, values parsing, case insensitive comparison, and more. See the docs (linked in the badge above) for the detailed documentation and examples. Layouts ======= One of the features of this package is the layouts module, which provides a simple example of translating keystrokes from one keyboard layout to another:: echo qwerty | python -m jaraco.text.to-dvorak ',.pyf echo "',.pyf" | python -m jaraco.text.to-qwerty qwerty Newline Reporting ================= Need to know what newlines appear in a file? :: $ python -m jaraco.text.show-newlines README.rst newline is '\n' For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-jaraco.text?utm_source=pypi-jaraco.text&utm_medium=referral&utm_campaign=github>`_. _vendor/jaraco.text-3.12.1.dist-info/INSTALLER 0000644 00000000004 15030122015 0014274 0 ustar 00 pip _vendor/jaraco.text-3.12.1.dist-info/WHEEL 0000644 00000000134 15030122015 0013607 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/jaraco.text-3.12.1.dist-info/LICENSE 0000644 00000001777 15030122015 0014043 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/jaraco.text-3.12.1.dist-info/top_level.txt 0000644 00000000007 15030122015 0015551 0 ustar 00 jaraco _vendor/jaraco.text-3.12.1.dist-info/REQUESTED 0000644 00000000000 15030122015 0014274 0 ustar 00 _vendor/zipp-3.19.2.dist-info/RECORD 0000644 00000002017 15030122015 0012473 0 ustar 00 zipp-3.19.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 zipp-3.19.2.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 zipp-3.19.2.dist-info/METADATA,sha256=UIrk_kMIHGSwsKKChYizqMw0MMZpPRZ2ZiVpQAsN_bE,3575 zipp-3.19.2.dist-info/RECORD,, zipp-3.19.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 zipp-3.19.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 zipp-3.19.2.dist-info/top_level.txt,sha256=iAbdoSHfaGqBfVb2XuR9JqSQHCoOsOtG6y9C_LSpqFw,5 zipp/__init__.py,sha256=QuI1g00G4fRAcGt-HqbV0oWIkmSgedCGGYsHHYzNa8A,13412 zipp/__pycache__/__init__.cpython-312.pyc,, zipp/__pycache__/glob.cpython-312.pyc,, zipp/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 zipp/compat/__pycache__/__init__.cpython-312.pyc,, zipp/compat/__pycache__/py310.cpython-312.pyc,, zipp/compat/py310.py,sha256=eZpkW0zRtunkhEh8jjX3gCGe22emoKCBJw72Zt4RkhA,219 zipp/glob.py,sha256=etWpnfEoRyfUvrUsi6sTiGmErvPwe6HzY6pT8jg_lUI,3082 _vendor/zipp-3.19.2.dist-info/METADATA 0000644 00000006767 15030122015 0012715 0 ustar 00 Metadata-Version: 2.1 Name: zipp Version: 3.19.2 Summary: Backport of pathlib-compatible object wrapper for zip files Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Homepage, https://github.com/jaraco/zipp Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Provides-Extra: doc Requires-Dist: sphinx >=3.5 ; extra == 'doc' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' Requires-Dist: rst.linker >=1.9 ; extra == 'doc' Requires-Dist: furo ; extra == 'doc' Requires-Dist: sphinx-lint ; extra == 'doc' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' Provides-Extra: test Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' Requires-Dist: pytest-cov ; extra == 'test' Requires-Dist: pytest-mypy ; extra == 'test' Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' Requires-Dist: jaraco.itertools ; extra == 'test' Requires-Dist: jaraco.functools ; extra == 'test' Requires-Dist: more-itertools ; extra == 'test' Requires-Dist: big-O ; extra == 'test' Requires-Dist: pytest-ignore-flaky ; extra == 'test' Requires-Dist: jaraco.test ; extra == 'test' Requires-Dist: importlib-resources ; (python_version < "3.9") and extra == 'test' .. image:: https://img.shields.io/pypi/v/zipp.svg :target: https://pypi.org/project/zipp .. image:: https://img.shields.io/pypi/pyversions/zipp.svg .. image:: https://github.com/jaraco/zipp/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/zipp/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. .. image:: https://readthedocs.org/projects/PROJECT_RTD/badge/?version=latest .. :target: https://PROJECT_RTD.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/zipp :target: https://tidelift.com/subscription/pkg/pypi-zipp?utm_source=pypi-zipp&utm_medium=readme A pathlib-compatible Zipfile object wrapper. Official backport of the standard library `Path object <https://docs.python.org/3.8/library/zipfile.html#path-objects>`_. Compatibility ============= New features are introduced in this third-party library and later merged into CPython. The following table indicates which versions of this library were contributed to different versions in the standard library: .. list-table:: :header-rows: 1 * - zipp - stdlib * - 3.18 - 3.13 * - 3.16 - 3.12 * - 3.5 - 3.11 * - 3.2 - 3.10 * - 3.3 ?? - 3.9 * - 1.0 - 3.8 Usage ===== Use ``zipp.Path`` in place of ``zipfile.Path`` on any Python. For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-zipp?utm_source=pypi-zipp&utm_medium=referral&utm_campaign=github>`_. _vendor/zipp-3.19.2.dist-info/INSTALLER 0000644 00000000004 15030122015 0013044 0 ustar 00 pip _vendor/zipp-3.19.2.dist-info/WHEEL 0000644 00000000134 15030122015 0012357 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/zipp-3.19.2.dist-info/LICENSE 0000644 00000001777 15030122015 0012613 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/zipp-3.19.2.dist-info/top_level.txt 0000644 00000000005 15030122015 0014317 0 ustar 00 zipp _vendor/zipp-3.19.2.dist-info/REQUESTED 0000644 00000000000 15030122015 0013044 0 ustar 00 _vendor/importlib_metadata/diagnose.py 0000644 00000000573 15030122015 0014176 0 ustar 00 import sys from . import Distribution def inspect(path): print("Inspecting", path) dists = list(Distribution.discover(path=[path])) if not dists: return print("Found", len(dists), "packages:", end=' ') print(', '.join(dist.name for dist in dists)) def run(): for path in sys.path: inspect(path) if __name__ == '__main__': run() _vendor/importlib_metadata/_adapters.py 0000644 00000004415 15030122015 0014346 0 ustar 00 import re import textwrap import email.message from ._text import FoldedCase class Message(email.message.Message): multiple_use_keys = set( map( FoldedCase, [ 'Classifier', 'Obsoletes-Dist', 'Platform', 'Project-URL', 'Provides-Dist', 'Provides-Extra', 'Requires-Dist', 'Requires-External', 'Supported-Platform', 'Dynamic', ], ) ) """ Keys that may be indicated multiple times per PEP 566. """ def __new__(cls, orig: email.message.Message): res = super().__new__(cls) vars(res).update(vars(orig)) return res def __init__(self, *args, **kwargs): self._headers = self._repair_headers() # suppress spurious error from mypy def __iter__(self): return super().__iter__() def __getitem__(self, item): """ Override parent behavior to typical dict behavior. ``email.message.Message`` will emit None values for missing keys. Typical mappings, including this ``Message``, will raise a key error for missing keys. Ref python/importlib_metadata#371. """ res = super().__getitem__(item) if res is None: raise KeyError(item) return res def _repair_headers(self): def redent(value): "Correct for RFC822 indentation" if not value or '\n' not in value: return value return textwrap.dedent(' ' * 8 + value) headers = [(key, redent(value)) for key, value in vars(self)['_headers']] if self._payload: headers.append(('Description', self.get_payload())) return headers @property def json(self): """ Convert PackageMetadata to a JSON-compatible format per PEP 0566. """ def transform(key): value = self.get_all(key) if key in self.multiple_use_keys else self[key] if key == 'Keywords': value = re.split(r'\s+', value) tk = key.lower().replace('-', '_') return tk, value return dict(map(transform, map(FoldedCase, self))) _vendor/importlib_metadata/__pycache__/_meta.cpython-310.pyc 0000644 00000006443 15030122015 0020033 0 ustar 00 o �h � @ st d dl mZ d dlZd dlmZ d dlmZmZmZmZm Z m Z m Z m Z e d�Z G dd� de�ZG dd � d e�ZdS ) � )� annotationsN)�Protocol)�Any�Dict�Iterator�List�Optional�TypeVar�Union�overload�_Tc @ s� e Zd Zd"dd�Zd#dd �Zd$d d �Zd%dd�Ze d&d'dd��Zed(dd��Ze d&d)dd ��Z ed*d d ��Z e d+d d!��Z dS ),�PackageMetadata�return�intc C � d S �N� ��selfr r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_meta.py�__len__ � zPackageMetadata.__len__�item�str�boolc C r r r )r r r r r � __contains__ r z PackageMetadata.__contains__�keyc C r r r )r r r r r � __getitem__ r zPackageMetadata.__getitem__� Iterator[str]c C r r r r r r r �__iter__ r zPackageMetadata.__iter__N�name�failobj�None� Optional[str]c C r r r �r r r! r r r �get � zPackageMetadata.getr �Union[str, _T]c C r r r r$ r r r r% � �Optional[List[Any]]c C r r r r$ r r r �get_all r& zPackageMetadata.get_all�Union[List[Any], _T]c C � dS )zP Return all values associated with a possibly multi-valued key. Nr r$ r r r r* " r � Dict[str, Union[str, List[str]]]c C r, )z9 A JSON-compatible form of the metadata. Nr r r r r �json( r zPackageMetadata.json)r r )r r r r )r r r r )r r r )r r r! r" r r# )r r r! r r r' )r r r! r" r r) )r r r! r r r+ )r r- ) �__name__� __module__� __qualname__r r r r r r% r* �propertyr. r r r r r s" � � r c @ sR e Zd ZdZddd�Zddd�Zedd d ��Zddd d�Zddd�Z ddd�Z d S )� SimplePathzD A minimal subset of pathlib.Path required by Distribution. �other� Union[str, os.PathLike[str]]r c C r r r �r r4 r r r �joinpath4 � zSimplePath.joinpathc C r r r r6 r r r � __truediv__8 r8 zSimplePath.__truediv__c C r r r r r r r �parent< r( zSimplePath.parentNr c C r r r )r �encodingr r r � read_text? r zSimplePath.read_text�bytesc C r r r r r r r � read_bytesA r zSimplePath.read_bytesr c C r r r r r r r �existsC r zSimplePath.exists)r4 r5 r r3 )r r3 r )r r )r r= )r r ) r/ r0 r1 �__doc__r7 r9 r2 r: r< r> r? r r r r r3 / s r3 )� __future__r �os�typingr r r r r r r r r r r r3 r r r r �<module> s ($ _vendor/importlib_metadata/__pycache__/_collections.cpython-310.pyc 0000644 00000003036 15030122015 0021416 0 ustar 00 o �h� � @ s6 d dl Z G dd� de j�ZG dd� de �dd��ZdS )� Nc s( e Zd ZdZ� fdd�Zdd� Z� ZS )�FreezableDefaultDicta! Often it is desirable to prevent the mutation of a default dict after its initial construction, such as to prevent mutation during iteration. >>> dd = FreezableDefaultDict(list) >>> dd[0].append('1') >>> dd.freeze() >>> dd[1] [] >>> len(dd) 1 c s t | dt� j�|�S )N�_frozen)�getattr�super� __missing__)�self�key�� __class__� �e/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_collections.pyr s z FreezableDefaultDict.__missing__c s � fdd�� _ d S )Nc s � � � S )N)�default_factory)r �r r r �<lambda> s z-FreezableDefaultDict.freeze.<locals>.<lambda>)r r r r r �freeze s zFreezableDefaultDict.freeze)�__name__� __module__� __qualname__�__doc__r r � __classcell__r r r r r s r c @ s e Zd Zedd� �ZdS )�Pairc C s | t tj|�dd��� S )N�=� )�map�str�strip�split)�cls�textr r r �parse s z Pair.parseN)r r r � classmethodr r r r r r s r z name value)� collections� defaultdictr � namedtupler r r r r �<module> s _vendor/importlib_metadata/__pycache__/__init__.cpython-310.pyc 0000644 00000116502 15030122015 0020503 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl Z d dl Z d dlZd dlZd dlZd dlZddlmZ ddlmZmZ ddlmZmZ ddlmZm Z ddl m Z m Z dd l m!Z!m"Z" dd lm#Z#m$Z$ d d l%m&Z& d d l'm(Z( d d l)m*Z* d dlm+Z+ d dl,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4 g d�Z5G dd� de6�Z7G dd� d�Z8G dd� d�Z9G dd� de:�Z;G dd� de j<�Z=G dd � d �Z>G d d � d ej?d �Z@G d d!� d!e*�ZAG d"d#� d#�ZBG d$d%� d%�ZCG d&d'� d'�ZDe G d(d)� d)eeA��ZEG d*d+� d+e@�ZFdOd/d0�ZGdPd2d3�ZHdQd5d6�ZIdRd7d8�ZJejKe"ejLd9�ZM dSd:d;�ZNdTd=d>�ZOdUd@dA�ZPdVdCdD�ZQdEdF� ZRdWdIdJ�ZSdXdKdL�ZTdMdN� ZUdS )Y� )� annotationsN� )�_meta)�py39�py311)�FreezableDefaultDict�Pair)� NullFinder�install)� method_cache� pass_none)�always_iterable�unique_everseen)�PackageMetadata� SimplePath)�suppress)� import_module)�MetaPathFinder)�starmap)�Any�Iterable�List�Mapping�Match�Optional�Set�cast) � Distribution�DistributionFinderr �PackageNotFoundError� distribution� distributions� entry_points�files�metadata�packages_distributions�requires�versionc @ s( e Zd ZdZd dd�Zed dd��ZdS ) r zThe package was not found.�return�strc C s d| j � �S )Nz"No package metadata was found for ��name��self� r. �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/__init__.py�__str__8 � z PackageNotFoundError.__str__c C s | j \}|S �N)�args�r- r+ r. r. r/ r+ ; s zPackageNotFoundError.nameN�r( r) )�__name__� __module__� __qualname__�__doc__r0 �propertyr+ r. r. r. r/ r 5 s r c @ sF e Zd ZdZe�d��� Zedd� �Z e d dd��Z e d d d ��Z dS )� Sectioneda� A simple entry point config parser for performance >>> for item in Sectioned.read(Sectioned._sample): ... print(item) Pair(name='sec1', value='# comments ignored') Pair(name='sec1', value='a = 1') Pair(name='sec1', value='b = 2') Pair(name='sec2', value='a = 2') >>> res = Sectioned.section_pairs(Sectioned._sample) >>> item = next(res) >>> item.name 'sec1' >>> item.value Pair(name='a', value='1') >>> item = next(res) >>> item.value Pair(name='b', value='2') >>> item = next(res) >>> item.name 'sec2' >>> item.value Pair(name='a', value='2') >>> list(res) [] zm [sec1] # comments ignored a = 1 b = 2 [sec2] a = 2 c C s dd� | j || jd�D �S )Nc s s. � | ]}|j d ur|jt�|j�d�V qd S )N)�value)r+ �_replacer �parser< )�.0�sectionr. r. r/ � <genexpr>l s � ��z*Sectioned.section_pairs.<locals>.<genexpr>)�filter_)�read�valid)�cls�textr. r. r/ � section_pairsj s �zSectioned.section_pairsNc c sZ � t |ttj| �� ��}d }|D ]}|�d�o|�d�}|r$|�d�}qt||�V qd S )N�[�]z[])�filter�mapr) �strip� splitlines� startswith�endswithr )rF rB �linesr+ r< � section_matchr. r. r/ rC r s � �zSectioned.read�liner) c C s | o| � d� S )N�#)rN )rR r. r. r/ rD } � zSectioned.validr2 )rR r) ) r6 r7 r8 r9 �textwrap�dedent�lstrip�_sample� classmethodrG � staticmethodrC rD r. r. r. r/ r; A s � � r; c @ s� e Zd ZU dZe�d�Z ded< ded< ded< dZded < d)d d �Z d*dd�Z e d+dd��Z e d+dd��Z e d,dd��Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd-d'd(�ZdS ).� EntryPointa� An entry point as defined by Python packaging conventions. See `the packaging docs on entry points <https://packaging.python.org/specifications/entry-points/>`_ for more information. >>> ep = EntryPoint( ... name=None, group=None, value='package.module:attr [extra1, extra2]') >>> ep.module 'package.module' >>> ep.attr 'attr' >>> ep.extras ['extra1', 'extra2'] zH(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+)\s*)?((?P<extras>\[.*\])\s*)?$r) r+ r< �groupNzOptional[Distribution]�distr( �Nonec C s t | �j|||d� d S )N�r+ r< r\ ��vars�update)r- r+ r< r\ r. r. r/ �__init__� � zEntryPoint.__init__r c C sJ t t| j�| j��}t|�d��}td|�d�pd�d��}t � t ||�S )z�Load the entry point from its definition. If only a module is indicated by the value, return that module. Otherwise, return the named object. �moduleN�attr� �.) r r �pattern�matchr< r r\ rJ �split� functools�reduce�getattr)r- rj re �attrsr. r. r/ �load� s zEntryPoint.loadc C �$ | j �| j�}|d us J �|�d�S )Nre �ri rj r< r\ �r- rj r. r. r/ re � � zEntryPoint.modulec C rq )Nrf rr rs r. r. r/ rf � rt zEntryPoint.attr� List[str]c C s0 | j �| j�}|d us J �t�d|�d�pd�S )Nz\w+�extrasrg )ri rj r< �re�findallr\ rs r. r. r/ rv � s zEntryPoint.extrasc C s t | �j|d� | S )N�r] r` )r- r] r. r. r/ �_for� s zEntryPoint._forc s( � fdd�|D �}t ttj|�� |��S )a$ EntryPoint matches the given parameters. >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]') >>> ep.matches(group='foo') True >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]') True >>> ep.matches(group='foo', name='other') False >>> ep.matches() True >>> ep.matches(extras=['extra1', 'extra2']) True >>> ep.matches(module='bing') True >>> ep.matches(attr='bong') True c 3 s � | ]}t � |�V qd S r2 �rn )r? �paramr, r. r/ rA � � � z%EntryPoint.matches.<locals>.<genexpr>)�allrK �operator�eq�values)r- �paramsro r. r, r/ �matches� s zEntryPoint.matchesc C s | j | j| jfS r2 r_ r, r. r. r/ �_key� � zEntryPoint._keyc C s | � � |� � k S r2 �r� �r- �otherr. r. r/ �__lt__� r� zEntryPoint.__lt__c C s | � � |� � kS r2 r� r� r. r. r/ �__eq__� r� zEntryPoint.__eq__c C s t d��)Nz!EntryPoint objects are immutable.)�AttributeError)r- r+ r< r. r. r/ � __setattr__� � zEntryPoint.__setattr__c C s d| j �d| j�d| j�d�S )NzEntryPoint(name=z, value=z, group=�)r_ r, r. r. r/ �__repr__� s ��zEntryPoint.__repr__�intc C s t | �� �S r2 )�hashr� r, r. r. r/ �__hash__� r1 zEntryPoint.__hash__)r+ r) r< r) r\ r) r( r^ )r( r r5 �r( ru )r( r� )r6 r7 r8 r9 rw �compileri �__annotations__r] rc rp r: re rf rv rz r� r� r� r� r� r� r� r. r. r. r/ r[ � s4 � r[ c @ sd e Zd ZdZdZddd�Zd d � Zdd d �Zeddd��Z eddd��Z e dd� �Z e dd� �ZdS )� EntryPointszC An immutable collection of selectable EntryPoint objects. r. r+ r) r( r[ c C s. z t t| j|d���W S ty t|��w )z; Get the EntryPoint in self matching name. r* )�next�iter�select� StopIteration�KeyErrorr4 r. r. r/ � __getitem__ s �zEntryPoints.__getitem__c C s d| j jt| �f S )zz Repr with classname and tuple constructor to signal that we deviate from regular tuple behavior. z%s(%r))� __class__r6 �tupler, r. r. r/ r� s zEntryPoints.__repr__c s t � fdd�| D ��S )zv Select entry points from self that match the given parameters (typically group and/or name). c 3 s& � | ]}t j|fi � ��r|V qd S r2 )r � ep_matches�r? �ep�r� r. r/ rA s �$ z%EntryPoints.select.<locals>.<genexpr>)r� )r- r� r. r� r/ r� s zEntryPoints.select�Set[str]c C � dd� | D �S )zB Return the set of all names of all entry points. c S � h | ]}|j �qS r. r* r� r. r. r/ � <setcomp>! � z$EntryPoints.names.<locals>.<setcomp>r. r, r. r. r/ �names � zEntryPoints.namesc C r� )zC Return the set of all groups of all entry points. c S r� r. )r\ r� r. r. r/ r� ( r� z%EntryPoints.groups.<locals>.<setcomp>r. r, r. r. r/ �groups# r� zEntryPoints.groupsc s | � fdd�| � |�D ��S )Nc 3 � � | ]}|� � �V qd S r2 )rz r� ry r. r/ rA , r} z-EntryPoints._from_text_for.<locals>.<genexpr>)� _from_text)rE rF r] r. ry r/ �_from_text_for* s zEntryPoints._from_text_forc C s dd� t �| pd�D �S )Nc s s( � | ]}t |jj|jj|jd �V qdS )r_ N)r[ r< r+ )r? �itemr. r. r/ rA 0 s � � �z)EntryPoints._from_text.<locals>.<genexpr>rg )r; rG )rF r. r. r/ r� . s �zEntryPoints._from_textN)r+ r) r( r[ �r( r� )r( r� )r6 r7 r8 r9 � __slots__r� r� r� r: r� r� rY r� rZ r� r. r. r. r/ r� � s r� c @ sJ e Zd ZU dZded< ded< ded< ddd d �Zddd�Zddd�ZdS )� PackagePathz"A reference to a path in a packagezOptional[FileHash]r� r� �sizer r] �utf-8�encodingr) r( c C s | � � j|d�S )N�r� )�locate� read_text)r- r� r. r. r/ r� = r� zPackagePath.read_text�bytesc C � | � � �� S r2 )r� � read_bytesr, r. r. r/ � read_binary@ r1 zPackagePath.read_binaryr c C s | j �| �S )z'Return a path-like object for this path)r] � locate_filer, r. r. r/ r� C � zPackagePath.locateN)r� )r� r) r( r) )r( r� )r( r )r6 r7 r8 r9 r� r� r� r� r. r. r. r/ r� 6 s r� c @ s e Zd Zd dd�Zd dd�Zd S ) �FileHash�specr) r( r^ c C s |� d�\| _}| _d S )N�=)� partition�moder< )r- r� �_r. r. r/ rc I rd zFileHash.__init__c C s d| j � d| j� d�S )Nz<FileHash mode: z value: �>)r� r< r, r. r. r/ r� L s zFileHash.__repr__N)r� r) r( r^ r5 )r6 r7 r8 rc r� r. r. r. r/ r� H s r� c @ s e Zd ZdZejd>dd��Zejd?d d ��Zed@d d��Z edd�dAdd��Z e dBdd��Z e dd� �Z edCdd ��ZedDd d ��Zed d � �ZedDd!d"��ZedEd$d%��ZedFd'd(��Zd)d*� Zd+d,� Zd-d.� ZedGd0d1��Zd2d3� Zd4d5� Zed6d7� �Ze d8d9� �Z ed:d;� �Z d<d=� Z dS )Hr aF An abstract Python distribution package. Custom providers may derive from this class and define the abstract methods to provide a concrete implementation for their environment. Some providers may opt to override the default implementation of some properties to bypass the file-reading mechanism. r( � Optional[str]c C � dS )a� Attempt to load metadata file given by the name. Python distribution metadata is organized by blobs of text typically represented as "files" in the metadata directory (e.g. package-1.0.dist-info). These files include things like: - METADATA: The distribution metadata including fields like Name and Version and Description. - entry_points.txt: A series of entry points as defined in `the entry points spec <https://packaging.python.org/en/latest/specifications/entry-points/#file-format>`_. - RECORD: A record of files according to `this recording spec <https://packaging.python.org/en/latest/specifications/recording-installed-packages/#the-record-file>`_. A package may provide any set of files, including those not listed here or none at all. :param filename: The name of the file in the distribution info. :return: The text if found, otherwise None. Nr. �r- �filenamer. r. r/ r� [ � zDistribution.read_text�path�str | os.PathLike[str]r c C r� )za Given a path to a file in this distribution, return a SimplePath to it. Nr. �r- r� r. r. r/ r� r r� zDistribution.locate_filer+ r) c C s: |st d��z tt| j|d���W S ty t|��w )a� Return the Distribution for the given package name. :param name: The name of the distribution package to search for. :return: The Distribution instance (or subclass thereof) for the named package, if found. :raises PackageNotFoundError: When the named package's distribution metadata cannot be found. :raises ValueError: When an invalid value is supplied for name. z A distribution name is required.r* )� ValueErrorr� r� �discoverr� r )rE r+ r. r. r/ � from_namey s �zDistribution.from_nameN��contextr� �$Optional[DistributionFinder.Context]�Iterable[Distribution]c sB � r|rt d��� ptjdi |��� tj�� fdd�| �� D ��S )a: Return an iterable of Distribution objects for all packages. Pass a ``context`` or pass keyword arguments for constructing a context. :context: A ``DistributionFinder.Context`` object. :return: Iterable of Distribution objects for packages matching the context. z cannot accept context and kwargsc 3 s � | ]}|� �V qd S r2 r. )r? �resolverr� r. r/ rA � s � �z(Distribution.discover.<locals>.<genexpr>Nr. )r� r �Context� itertools�chain� from_iterable�_discover_resolvers)rE r� �kwargsr. r� r/ r� � s �zDistribution.discoverc C s t t�| ��S )z�Return a Distribution for the indicated metadata path. :param path: a string or path-like object :return: a concrete Distribution instance for the path )�PathDistribution�pathlib�Path�r� r. r. r/ �at� s zDistribution.atc C s dd� t jD �} td| �S )z9Search the meta_path for resolvers (MetadataPathFinders).c s s � | ] }t |d d�V qdS )�find_distributionsNr{ )r? �finderr. r. r/ rA � s � �z3Distribution._discover_resolvers.<locals>.<genexpr>N)�sys� meta_pathrJ )�declaredr. r. r/ r� � s � z Distribution._discover_resolvers�_meta.PackageMetadatac C sD ddl m} | �d�p| �d�p| �d�}tt|�}|�t�|��S )av Return the parsed metadata for this Distribution. The returned object will have keys that name the various bits of metadata per the `Core metadata specifications <https://packaging.python.org/en/latest/specifications/core-metadata/#core-metadata>`_. Custom providers may provide the METADATA file or override this property. r )� _adapters�METADATAzPKG-INFOrg )rg r� r� r r) �Message�email�message_from_string)r- r� �opt_textrF r. r. r/ r$ � s �� zDistribution.metadatac C � | j d S )z8Return the 'Name' metadata for the distribution package.�Name�r$ r, r. r. r/ r+ � � zDistribution.namec C s t �| j�S )z(Return a normalized version of the name.)�Prepared� normalizer+ r, r. r. r/ �_normalized_name� s z Distribution._normalized_namec C r� )z;Return the 'Version' metadata for the distribution package.�Versionr� r, r. r. r/ r' � r� zDistribution.versionr� c C s t �| �d�| �S )z� Return EntryPoints for this distribution. Custom providers may provide the ``entry_points.txt`` file or override this property. zentry_points.txt)r� r� r� r, r. r. r/ r" � s zDistribution.entry_points�Optional[List[PackagePath]]c sJ d�fdd� � t � fdd��}t dd� �}||��� p"��� p"��� ��S ) a* Files in this distribution. :return: List of PackagePath for this distribution or None Result is `None` if the metadata file that enumerates files (i.e. RECORD for dist-info, or installed-files.txt or SOURCES.txt for egg-info) is missing. Result may be empty if the metadata exists but is empty. Custom providers are recommended to provide a "RECORD" file (in ``read_text``) or override this property to allow for callers to be able to resolve filenames provided by the package. Nc s6 t | �}|r t|�nd |_|rt|�nd |_� |_|S r2 )r� r� r� r� r� r] )r+ r� �size_str�resultr, r. r/ � make_file� s z%Distribution.files.<locals>.make_filec s dd l }t� |�| ��S )Nr )�csvr �reader)rP r� )r� r. r/ � make_files� s z&Distribution.files.<locals>.make_filesc S s t tdd� | ��S )Nc S r� r2 )r� �existsr� r. r. r/ �<lambda> s z@Distribution.files.<locals>.skip_missing_files.<locals>.<lambda>)�listrJ )� package_pathsr. r. r/ �skip_missing_files s z.Distribution.files.<locals>.skip_missing_files)NN)r �_read_files_distinfo� _read_files_egginfo_installed�_read_files_egginfo_sources)r- r� r� r. )r� r- r/ r# � s ���zDistribution.filesc C s | � d�}|o |�� S )z+ Read the lines of RECORD. �RECORD)r� rM �r- rF r. r. r/ r � z!Distribution._read_files_distinfoc sF � � d�}t� dd��|r�sdS � �fdd�|�� D �}tdj|�S )a� Read installed-files.txt and return lines in a similar CSV-parsable format as RECORD: each file must be placed relative to the site-packages directory and must also be quoted (since file names can contain literal commas). This file is written when the package is installed by pip, but it might not be written for other installation methods. Assume the file is accurate if it exists. zinstalled-files.txt�_pathNc 3 s: � | ]}t ��| �� �j� �d ��� dd��� V qdS )rg T)�walk_upN)r � relative_fix�resolve� relative_tor� �as_posix)r? r+ �r- �subdirr. r/ rA ' s � �� �z=Distribution._read_files_egginfo_installed.<locals>.<genexpr>�"{}")r� rn rM rK �format)r- rF �pathsr. r r/ r s � z*Distribution._read_files_egginfo_installedc C s | � d�}|otdj|�� �S )a� Read SOURCES.txt and return lines in a similar CSV-parsable format as RECORD: each file name must be quoted (since it might contain literal commas). Note that SOURCES.txt is not a reliable source for what files are installed by a package. This file is generated for a source archive, and the files that are present there (e.g. setup.py) may not correctly reflect the files that are present after the package has been installed. z SOURCES.txtr )r� rK r rM r r. r. r/ r / s z(Distribution._read_files_egginfo_sources�Optional[List[str]]c C s | � � p| �� }|o t|�S )z6Generated requirements specified for this Distribution)�_read_dist_info_reqs�_read_egg_info_reqsr� )r- �reqsr. r. r/ r& > s zDistribution.requiresc C s | j �d�S )Nz Requires-Dist)r$ �get_allr, r. r. r/ r D r1 z!Distribution._read_dist_info_reqsc C s | � d�}t| j�|�S )Nz requires.txt)r� r �_deps_from_requires_text)r- �sourcer. r. r/ r G s z Distribution._read_egg_info_reqsc C s | � t�|��S r2 )�%_convert_egg_info_reqs_to_simple_reqsr; rC )rE r r. r. r/ r K rT z%Distribution._deps_from_requires_textc # sL � dd� � � fdd�}dd� }| D ]}||j �}|j | ||j� V qdS )a� Historically, setuptools would solicit and store 'extra' requirements, including those with environment markers, in separate sections. More modern tools expect each dependency to be defined separately, with any relevant extras and environment markers attached directly to that requirement. This method converts the former to the latter. See _test_deps_from_requires_text for an example. c S s | od| � d�S )Nz extra == "�"r. r* r. r. r/ �make_condition[ r� zJDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.make_conditionc sX | pd} | � d�\}}}|r|rd|� d�}ttd |� |�g��}|r*dd�|� S dS )Nrg �:�(r� z; z and )r� r� rJ �join)r@ �extra�sep�markers� conditions�r r. r/ � quoted_marker^ s zIDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.quoted_markerc S s dd| v S )z� PEP 508 requires a space between the url_spec and the quoted_marker. Ref python/importlib_metadata#357. � �@r. )�reqr. r. r/ � url_req_spacef � zIDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.url_req_spaceN)r< r+ )�sectionsr# r' r@ �spacer. r" r/ r O s � �z2Distribution._convert_egg_info_reqs_to_simple_reqsc C s | � d�S )Nzdirect_url.json)� _load_jsonr, r. r. r/ �originr s zDistribution.originc C s t tj�| �|�dd� d�S )Nc S s t jdi | ��S )Nr. )�types�SimpleNamespace)�datar. r. r/ r� y s z)Distribution._load_json.<locals>.<lambda>)� object_hook)r �json�loadsr� r� r. r. r/ r+ v s �zDistribution._load_json)r( r� �r� r� r( r )r+ r) r( r )r� r� r( r� )r� r� r( r )r( r� r5 r� )r( r� )r( r ) r6 r7 r8 r9 �abc�abstractmethodr� r� rY r� r� rZ r� r� r: r$ r+ r� r' r" r# r r r r& r r r r r, r+ r. r. r. r/ r P sR � * " r )� metaclassc @ s4 e Zd ZdZG dd� d�Zeje� fd dd��ZdS ) r z� A MetaPathFinder capable of discovering installed distributions. Custom providers should implement this interface in order to supply metadata. c @ s, e Zd ZdZdZ dd� Zed dd��ZdS ) zDistributionFinder.Contexta� Keyword arguments presented by the caller to ``distributions()`` or ``Distribution.discover()`` to narrow the scope of a search for distributions in all DistributionFinders. Each DistributionFinder may expect any parameters and should attempt to honor the canonical parameters defined below when appropriate. This mechanism gives a custom provider a means to solicit additional details from the caller beyond "name" and "path" when searching distributions. For example, imagine a provider that exposes suites of packages in either a "public" or "private" ``realm``. A caller may wish to query only for distributions in a particular realm and could call ``distributions(realm="private")`` to signal to the custom provider to only include distributions from that realm. Nc K s t | ��|� d S r2 r` )r- r� r. r. r/ rc � � z#DistributionFinder.Context.__init__r( ru c C s t | ��dtj�S )z� The sequence of directory path that a distribution finder should search. Typically refers to Python installed package paths such as "site-packages" directories and defaults to ``sys.path``. r� )ra �getr� r� r, r. r. r/ r� � s z DistributionFinder.Context.pathr� )r6 r7 r8 r9 r+ rc r: r� r. r. r. r/ r� � s r� r( r� c C r� )z� Find distributions. Return an iterable of all Distribution instances capable of loading the metadata for packages matching the ``context``, a DistributionFinder.Context instance. Nr. )r- r� r. r. r/ r� � r� z%DistributionFinder.find_distributionsN�r( r� )r6 r7 r8 r9 r� r4 r5 r� r. r. r. r/ r } s +r c sh e Zd ZdZe�� � fdd��Zdd� Zdd� Zdd � Z d d � Z d d � Z e dd� �Z edd� �Z� ZS )�FastPathaq Micro-optimized class for searching a root for children. Root is a path on the file system that may contain metadata directories either as natural directories or within a zip file. >>> FastPath('').children() ['...'] FastPath objects are cached and recycled for any given root. >>> FastPath('foobar') is FastPath('foobar') True c s t � �| �S r2 )�super�__new__)rE �root�r� r. r/ r< � r� zFastPath.__new__c C s || _ d S r2 )r= )r- r= r. r. r/ rc � � zFastPath.__init__c C s t �| j|�S r2 )r� r� r= )r- �childr. r. r/ �joinpath� s zFastPath.joinpathc C sl t t�� t�| jp d�W d � S 1 sw Y t t�� | �� W d � S 1 s/w Y g S �Nrh )r � Exception�os�listdirr= � zip_childrenr, r. r. r/ �children� s � �zFastPath.childrenc C s2 t �| j�}|j�� }|j| _t�dd� |D ��S )Nc s s" � | ] }|� tjd �d V qdS )r r N)rk � posixpathr )r? r@ r. r. r/ rA � s � z(FastPath.zip_children.<locals>.<genexpr>)�zippr� r= �namelistrA �dict�fromkeys)r- �zip_pathr� r. r. r/ rF � s zFastPath.zip_childrenc C s | � | j��|�S r2 )�lookup�mtime�searchr4 r. r. r/ rP � r7 zFastPath.searchc C sD t t�� t�| j�jW d � S 1 sw Y | j�� d S r2 )r �OSErrorrD �statr= �st_mtimerN � cache_clearr, r. r. r/ rO � s �zFastPath.mtimec C s t | �S r2 )�Lookup)r- rO r. r. r/ rN � s zFastPath.lookup)r6 r7 r8 r9 rl � lru_cacher< rc rA rG rF rP r: rO r rN � __classcell__r. r. r> r/ r: � s r: c @ s$ e Zd ZdZd dd�Zd dd �Zd S ) rU zK A micro-optimized class for searching a (fast) path for metadata. r� r: c C s� t j�|j��� }|�d�}tt�| _tt�| _ |� � D ]J}|�� }|�d�rD|� d�d � d�d }t �|�}| j| �|�|�� q |rf|dkrf|� d�d � d�d }t �|�}| j | �|�|�� q | j�� | j �� dS )z� Calculate all of the children representing metadata. From the children in the path, calculate early all of the children that appear to represent metadata (infos) or legacy metadata (eggs). z.egg�z .dist-infoz .egg-inforh r �-zegg-infoN)rD r� �basenamer= �lowerrO r r� �infos�eggsrG � rpartitionr� r� r� �appendrA �legacy_normalize�freeze) r- r� �base� base_is_eggr@ �lowr+ � normalized�legacy_normalizedr. r. r/ rc � s" � zLookup.__init__�preparedr� c C sP |r| j |j ntj�| j �� �}|r| j|j ntj�| j�� �}t�||�S )zG Yield all infos and eggs matching the Prepared query. )r\ re r� r� r� r� r] rf )r- rg r\ r] r. r. r/ rP s ���� z Lookup.searchN)r� r: )rg r� )r6 r7 r8 r9 rc rP r. r. r. r/ rU � s rU c @ sB e Zd ZdZdZdZd dd�Zedd� �Zed d � �Z d d � Z dS )r� a� A prepared search query for metadata on a possibly-named package. Pre-calculates the normalization to prevent repeated operations. >>> none = Prepared(None) >>> none.normalized >>> none.legacy_normalized >>> bool(none) False >>> sample = Prepared('Sample__Pkg-name.foo') >>> sample.normalized 'sample_pkg_name_foo' >>> sample.legacy_normalized 'sample__pkg_name.foo' >>> bool(sample) True Nr+ r� c C s. || _ |d u r d S | �|�| _| �|�| _d S r2 )r+ r� re r` rf r4 r. r. r/ rc ; s zPrepared.__init__c C s t �dd| ��� �dd�S )zC PEP 503 normalization plus dashes as underscores. z[-_.]+rY r� )rw �subr[ �replacer* r. r. r/ r� B s zPrepared.normalizec C s | � � �dd�S )z| Normalize the package name as found in the convention in older packaging tools versions and specs. rY r� )r[ ri r* r. r. r/ r` I s zPrepared.legacy_normalizec C s t | j�S r2 )�boolr+ r, r. r. r/ �__bool__Q r? zPrepared.__bool__)r+ r� ) r6 r7 r8 r9 re rf rc rZ r� r` rk r. r. r. r/ r� $ s r� c @ s@ e Zd ZdZee�� fd dd��Zedd� �Zed d d ��Z d S )�MetadataPathFinderz�A degenerate finder for distribution packages on the file system. This finder supplies only a find_distributions() method for versions of Python that do not have a PathFinder find_distributions(). r( �Iterable[PathDistribution]c C s | � |j|j�}tt|�S )a Find distributions. Return an iterable of all Distribution instances capable of loading the metadata for packages matching ``context.name`` (or all names if ``None`` indicated) along the paths in the list of directories ``context.path``. )� _search_pathsr+ r� rK r� )rE r� �foundr. r. r/ r� ] s z%MetadataPathFinder.find_distributionsc s( t |�� tj�� fdd�tt|�D ��S )z1Find metadata directories in paths heuristically.c 3 r� r2 )rP )r? r� �rg r. r/ rA p s � �z3MetadataPathFinder._search_paths.<locals>.<genexpr>)r� r� r� r� rK r: )rE r+ r r. rp r/ rn l s �z MetadataPathFinder._search_pathsr^ c C s t j�� d S r2 )r: r< rT )rE r. r. r/ �invalidate_cachest s z$MetadataPathFinder.invalidate_cachesN)r( rm )r( r^ ) r6 r7 r8 r9 rY r r� r� rn rq r. r. r. r/ rl U s � rl c sT e Zd Zddd�Zdd d �Zejje_dd d �Ze� fdd��Z e dd� �Z � Z S )r� r� r r( r^ c C s || _ dS )zfConstruct a distribution. :param path: SimplePath indicating the metadata directory. N)r r� r. r. r/ rc z s zPathDistribution.__init__r� r� r� c C sH t ttttt�� | j�|�jdd�W d � S 1 s w Y d S )Nr� r� ) r �FileNotFoundError�IsADirectoryErrorr� �NotADirectoryError�PermissionErrorr rA r� r� r. r. r/ r� � s � � zPathDistribution.read_textc C s | j j| S r2 )r �parentr� r. r. r/ r� � r1 z PathDistribution.locate_filec s. t j�t| j��}ttj�| �|��pt � j S )zz Performance optimization: where possible, resolve the normalized name from the file system path. ) rD r� rZ r) r r r� r� �_name_from_stemr; r� )r- �stemr> r. r/ r� � s �z!PathDistribution._normalized_namec C s0 t j�| �\}}|dvrdS |�d�\}}}|S )a7 >>> PathDistribution._name_from_stem('foo-3.0.egg-info') 'foo' >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info') 'CherryPy' >>> PathDistribution._name_from_stem('face.egg-info') 'face' >>> PathDistribution._name_from_stem('foo.bar') rX NrY )rD r� �splitextr� )rx r� �extr+ r �restr. r. r/ rw � s z PathDistribution._name_from_stem)r� r r( r^ )r� r� r( r� r3 ) r6 r7 r8 rc r� r r9 r� r: r� rZ rw rW r. r. r> r/ r� y s r� �distribution_namer) r( c C s t �| �S )z�Get the ``Distribution`` instance for the named package. :param distribution_name: The name of the distribution package as a string. :return: A ``Distribution`` instance (or subclass thereof). )r r� �r| r. r. r/ r � � r r� c K s t jdi | ��S )z|Get all ``Distribution`` instances in the current environment. :return: An iterable of ``Distribution`` instances. Nr. )r r� )r� r. r. r/ r! � s r! r� c C s t �| �jS )z�Get the metadata for the named package. :param distribution_name: The name of the distribution package to query. :return: A PackageMetadata containing the parsed metadata. )r r� r$ r} r. r. r/ r$ � r( r$ c C � t | �jS )z�Get the version string for the named package. :param distribution_name: The name of the distribution package to query. :return: The version string for the package as defined in the package's "Version" metadata key. )r r' r} r. r. r/ r' � � r' )�keyc K s0 t j�dd� tt� �D ��}t|�jdi | ��S )a Return EntryPoint objects for all installed packages. Pass selection parameters (group or name) to filter the result to entry points matching those properties (see EntryPoints.select()). :return: EntryPoints for all installed packages. c s s � | ]}|j V qd S r2 )r" )r? r] r. r. r/ rA � s � �z entry_points.<locals>.<genexpr>Nr. )r� r� r� �_uniquer! r� r� )r� �epsr. r. r/ r" � s �r" r� c C r )z�Return a list of files for the named package. :param distribution_name: The name of the distribution package to query. :return: List of files composing the distribution. )r r# r} r. r. r/ r# � r~ r# r c C r )z� Return a list of requirements for the named package. :return: An iterable of requirements, suitable for packaging.requirement.Requirement. )r r& r} r. r. r/ r& � r� r& �Mapping[str, List[str]]c C sH t �t�} t� D ]}t|�pt|�D ] }| | �|jd � qqt| �S )z� Return a mapping of top-level packages to their distributions. >>> import collections.abc >>> pkgs = packages_distributions() >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values()) True r� ) � collections� defaultdictr� r! �_top_level_declared�_top_level_inferredr_ r$ rK )� pkg_to_distr] �pkgr. r. r/ r% � s �r% c C s | � d�pd�� S )Nz top_level.txtrg )r� rk ry r. r. r/ r� r7 r� r+ r� c C s | j ^}}|r |S dS )zB Return the top-most parent as long as there is a parent. N)�parts)r+ �topr{ r. r. r/ �_topmost r r� c C s t | �p t�| �p t| �S )a� Infer a possibly importable module name from a name presumed on sys.path. >>> _get_toplevel_name(PackagePath('foo.py')) 'foo' >>> _get_toplevel_name(PackagePath('foo')) 'foo' >>> _get_toplevel_name(PackagePath('foo.pyc')) 'foo' >>> _get_toplevel_name(PackagePath('foo/__init__.py')) 'foo' >>> _get_toplevel_name(PackagePath('foo.pth')) 'foo.pth' >>> _get_toplevel_name(PackagePath('foo.dist-info')) 'foo.dist-info' )r� �inspect� getmodulenamer) r* r. r. r/ �_get_toplevel_name s �r� c C s& t ttt| j���}dd� }t||�S )Nc S s d| vS rB r. r* r. r. r/ �importable_name8 r� z,_top_level_inferred.<locals>.importable_name)�setrK r� r r# rJ )r] � opt_namesr� r. r. r/ r� 5 s r� )r| r) r( r r9 )r| r) r( r� )r| r) r( r) r� )r| r) r( r� )r| r) r( r )r( r� )r+ r� r( r� )r+ r� r( r) )V� __future__r rD rw r4 r� r1 rI r� r- r� r� r rU rl r� rH r� rg r �compatr r � _collectionsr r �_compatr r � _functoolsr r � _itertoolsr r r r � contextlibr � importlibr � importlib.abcr r �typingr r r r r r r r �__all__�ModuleNotFoundErrorr r; r[ r� r� � PurePosixPathr� r� �ABCMetar r r: rU r� rl r� r r! r$ r' �partial�normalized_namer� r" r# r& r% r� r� r� r� r. r. r. r/ �<module> s~ ( A|8 />631# 7 � _vendor/importlib_metadata/__pycache__/_compat.cpython-310.pyc 0000644 00000003552 15030122015 0020366 0 ustar 00 o �h" � @ sB d dl Z d dlZddgZdd� Zdd� ZG dd� d�Zdd � ZdS ) � N�install� NullFinderc C s t j�| � � t� | S )z� Class decorator for installation on sys.meta_path. Adds the backport DistributionFinder to sys.meta_path and attempts to disable the finder functionality of the stdlib DistributionFinder. )�sys� meta_path�append�disable_stdlib_finder)�cls� r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_compat.pyr s c C s" dd� } t | tj�D ]}|`q dS )z� Give the backport primacy for discovering path-based distributions by monkey-patching the stdlib O_O. See #91 for more background for rationale on this sketchy behavior. c S s t | dd �dko t| d�S )N� __module__�_frozen_importlib_external�find_distributions)�getattr�hasattr)�finderr r r �matches s ���z&disable_stdlib_finder.<locals>.matchesN)�filterr r r )r r r r r r s �r c @ s e Zd ZdZedd� �ZdS )r zi A "Finder" (aka "MetaPathFinder") that never finds any modules, but may find distributions. c O s d S )Nr )�args�kwargsr r r � find_spec- s zNullFinder.find_specN)�__name__r � __qualname__�__doc__� staticmethodr r r r r r ' s c C s t �� dk}| | S )zY Adjust for variable stacklevel on partial under PyPy. Workaround for #327. �PyPy)�platform�python_implementation)�val�is_pypyr r r � pypy_partial2 s r )r r �__all__r r r r r r r r �<module> s _vendor/importlib_metadata/__pycache__/_itertools.cpython-310.pyc 0000644 00000003765 15030122015 0021135 0 ustar 00 o �h � @ s* d dl mZ ddd�Zeeffdd�ZdS )� )� filterfalseNc c sf � t � }|j}|du r t|j| �D ] }||� |V qdS | D ]}||�}||vr0||� |V q dS )zHList unique elements, preserving order. Remember all elements ever seen.N)�set�addr � __contains__)�iterable�key�seen�seen_add�element�k� r �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py�unique_everseen s ����r c C sT | du rt d�S |durt| |�rt | f�S zt | �W S ty) t | f� Y S w )ax If *obj* is iterable, return an iterator over its items:: >>> obj = (1, 2, 3) >>> list(always_iterable(obj)) [1, 2, 3] If *obj* is not iterable, return a one-item iterable containing *obj*:: >>> obj = 1 >>> list(always_iterable(obj)) [1] If *obj* is ``None``, return an empty iterable: >>> obj = None >>> list(always_iterable(None)) [] By default, binary and text strings are not considered iterable:: >>> obj = 'foo' >>> list(always_iterable(obj)) ['foo'] If *base_type* is set, objects for which ``isinstance(obj, base_type)`` returns ``True`` won't be considered iterable. >>> obj = {'a': 1} >>> list(always_iterable(obj)) # Iterate over the dict's keys ['a'] >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit [{'a': 1}] Set *base_type* to ``None`` to avoid any special handling and treat objects Python considers iterable as iterable: >>> obj = 'foo' >>> list(always_iterable(obj, base_type=None)) ['f', 'o', 'o'] Nr )�iter� isinstance� TypeError)�obj� base_typer r r �always_iterable s ) �r )N)� itertoolsr r �str�bytesr r r r r �<module> s _vendor/importlib_metadata/__pycache__/_text.cpython-310.pyc 0000644 00000006021 15030122015 0020061 0 ustar 00 o �hv � @ s( d dl Z ddlmZ G dd� de�ZdS )� N� )� method_cachec sr e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Z� fd d �Z dd� Z e � fdd��Z dd� Z ddd�Z� ZS )� FoldedCasea{ A case insensitive string class; behaves just like str except compares equal when the only variation is case. >>> s = FoldedCase('hello world') >>> s == 'Hello World' True >>> 'Hello World' == s True >>> s != 'Hello World' False >>> s.index('O') 4 >>> s.split('O') ['hell', ' w', 'rld'] >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) ['alpha', 'Beta', 'GAMMA'] Sequence membership is straightforward. >>> "Hello World" in [s] True >>> s in ["Hello World"] True You may test for set inclusion, but candidate and elements must both be folded. >>> FoldedCase("Hello World") in {s} True >>> s in {FoldedCase("Hello World")} True String inclusion works as long as the FoldedCase object is on the right. >>> "hello" in FoldedCase("Hello World") True But not if the FoldedCase object is on the left: >>> FoldedCase('hello') in 'Hello World' False In that case, use in_: >>> FoldedCase('hello').in_('Hello World') True >>> FoldedCase('hello') > FoldedCase('Hello') False c C s | � � |� � k S �N��lower��self�other� r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_text.py�__lt__C � zFoldedCase.__lt__c C s | � � |� � kS r r r r r r �__gt__F r zFoldedCase.__gt__c C s | � � |� � kS r r r r r r �__eq__I r zFoldedCase.__eq__c C s | � � |� � kS r r r r r r �__ne__L r zFoldedCase.__ne__c C s t | �� �S r )�hashr �r r r r �__hash__O s zFoldedCase.__hash__c s t � �� �|�� �S r )�superr � __contains__r �� __class__r r r R s zFoldedCase.__contains__c C s | t |�v S )zDoes self appear in other?)r r r r r �in_U s zFoldedCase.in_c s t � �� S r )r r r r r r r Z s zFoldedCase.lowerc C s | � � �|� � �S r )r �index)r �subr r r r ^ s zFoldedCase.index� r c C s t �t �|�t j�}|�| |�S r )�re�compile�escape�I�split)r �splitter�maxsplit�patternr r r r! a s zFoldedCase.split)r r )�__name__� __module__� __qualname__�__doc__r r r r r r r r r r r! � __classcell__r r r r r s ; r )r � _functoolsr �strr r r r r �<module> s _vendor/importlib_metadata/__pycache__/_adapters.cpython-310.pyc 0000644 00000005474 15030122015 0020713 0 ustar 00 o �h � @ s< d dl Z d dlZd dlZddlmZ G dd� dejj�ZdS )� N� )� FoldedCasec sn e Zd Zeeeg d���Z dejj f� fdd� Z dd� Z � fdd�Z � fd d �Z d d � Zed d� �Z� ZS )�Message) � ClassifierzObsoletes-Dist�Platformz Project-URLz Provides-DistzProvides-Extraz Requires-DistzRequires-ExternalzSupported-Platform�Dynamic�origc s" t � �| �}t|��t|�� |S �N)�super�__new__�vars�update)�clsr �res�� __class__� �b/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_adapters.pyr s zMessage.__new__c O s | � � | _d S r )�_repair_headers�_headers)�self�args�kwargsr r r �__init__# s zMessage.__init__c s t � �� S r )r �__iter__�r r r r r ' s zMessage.__iter__c s t � �|�}|du rt|��|S )a" Override parent behavior to typical dict behavior. ``email.message.Message`` will emit None values for missing keys. Typical mappings, including this ``Message``, will raise a key error for missing keys. Ref python/importlib_metadata#371. N)r � __getitem__�KeyError)r �itemr r r r r * s zMessage.__getitem__c s> dd� � � fdd�t | �d D �}| jr |�d| �� f� |S )Nc S s | rd| vr| S t �d| �S )z Correct for RFC822 indentation� z )�textwrap�dedent)�valuer r r �redent: s z'Message._repair_headers.<locals>.redentc s g | ] \}}|� |�f�qS r r )�.0�keyr" �r# r r � <listcomp>@ s z+Message._repair_headers.<locals>.<listcomp>r � Description)r �_payload�append� get_payload)r �headersr r& r r 9 s zMessage._repair_headersc s � fdd�}t t|tt� ���S )z[ Convert PackageMetadata to a JSON-compatible format per PEP 0566. c sH | � j v r � �| �n� | }| dkrt�d|�}| �� �dd�}||fS )N�Keywordsz\s+�-�_)�multiple_use_keys�get_all�re�split�lower�replace)r% r" �tkr r r � transformL s z Message.json.<locals>.transform)�dict�mapr )r r7 r r r �jsonE s z Message.json)�__name__� __module__� __qualname__�setr9 r r0 �email�messager r r r r r �propertyr: � __classcell__r r r r r s �� r )r2 r � email.messager? �_textr r@ r r r r r �<module> s _vendor/importlib_metadata/__pycache__/_functools.cpython-310.pyc 0000644 00000006124 15030122015 0021115 0 ustar 00 o �hO � @ s& d dl Z d dlZddd�Zdd� ZdS )� Nc s( � pt �� � � �fdd�}dd� |_|S )aV Wrap lru_cache to support storing the cache data in the object instances. Abstracts the common paradigm where the method explicitly saves an underscore-prefixed protected property on first call and returns that subsequently. >>> class MyClass: ... calls = 0 ... ... @method_cache ... def method(self, value): ... self.calls += 1 ... return value >>> a = MyClass() >>> a.method(3) 3 >>> for x in range(75): ... res = a.method(x) >>> a.calls 75 Note that the apparent behavior will be exactly like that of lru_cache except that the cache is stored on each instance, so values in one instance will not flush values from another, and when an instance is deleted, so are the cached values for that instance. >>> b = MyClass() >>> for x in range(35): ... res = b.method(x) >>> b.calls 35 >>> a.method(0) 0 >>> a.calls 75 Note that if method had been decorated with ``functools.lru_cache()``, a.calls would have been 76 (due to the cached value of 0 having been flushed by the 'b' instance). Clear the cache with ``.cache_clear()`` >>> a.method.cache_clear() Same for a method that hasn't yet been called. >>> c = MyClass() >>> c.method.cache_clear() Another cache wrapper may be supplied: >>> cache = functools.lru_cache(maxsize=2) >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) >>> a = MyClass() >>> a.method2() 3 Caution - do not subsequently wrap the method with another decorator, such as ``@property``, which changes the semantics of the function. See also http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ for another implementation and additional justification. c s0 t ��| �}� |�}t| �j|� ||i |��S �N)�types� MethodType�setattr�__name__)�self�args�kwargs� bound_method� cached_method�� cache_wrapper�method� �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/_functools.py�wrapperK s z method_cache.<locals>.wrapperc S s d S r r r r r r �<lambda>S s z method_cache.<locals>.<lambda>)� functools� lru_cache� cache_clear)r r r r r r � method_cache s C r c s t �� �� fdd��}|S )z� Wrap func so it's not called if its first param is None >>> print_text = pass_none(print) >>> print_text('text') text >>> print_text(None) c s" | d ur� | g|�R i |��S d S r r )�paramr r ��funcr r r c s �zpass_none.<locals>.wrapper)r �wraps)r r r r r � pass_noneY s r r )r r r r r r r r �<module> s S _vendor/importlib_metadata/__pycache__/diagnose.cpython-310.pyc 0000644 00000001532 15030122015 0020531 0 ustar 00 o �h{ � @ s: d dl Z ddlmZ dd� Zdd� Zedkre� dS dS ) � N� )� Distributionc C sT t d| � ttj| gd��}|sd S t dt|�ddd� t d�dd � |D ��� d S ) N� Inspecting��path�Foundz packages:� )�endz, c s s � | ]}|j V qd S �N)�name)�.0�dist� r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py� <genexpr> s � zinspect.<locals>.<genexpr>)�print�listr �discover�len�join)r �distsr r r �inspect s r c C s t jD ]} t| � qd S r )�sysr r r r r r �run s �r �__main__)r � r r r �__name__r r r r �<module> s � _vendor/importlib_metadata/_meta.py 0000644 00000003411 15030122015 0013464 0 ustar 00 from __future__ import annotations import os from typing import Protocol from typing import Any, Dict, Iterator, List, Optional, TypeVar, Union, overload _T = TypeVar("_T") class PackageMetadata(Protocol): def __len__(self) -> int: ... # pragma: no cover def __contains__(self, item: str) -> bool: ... # pragma: no cover def __getitem__(self, key: str) -> str: ... # pragma: no cover def __iter__(self) -> Iterator[str]: ... # pragma: no cover @overload def get( self, name: str, failobj: None = None ) -> Optional[str]: ... # pragma: no cover @overload def get(self, name: str, failobj: _T) -> Union[str, _T]: ... # pragma: no cover # overload per python/importlib_metadata#435 @overload def get_all( self, name: str, failobj: None = None ) -> Optional[List[Any]]: ... # pragma: no cover @overload def get_all(self, name: str, failobj: _T) -> Union[List[Any], _T]: """ Return all values associated with a possibly multi-valued key. """ @property def json(self) -> Dict[str, Union[str, List[str]]]: """ A JSON-compatible form of the metadata. """ class SimplePath(Protocol): """ A minimal subset of pathlib.Path required by Distribution. """ def joinpath( self, other: Union[str, os.PathLike[str]] ) -> SimplePath: ... # pragma: no cover def __truediv__( self, other: Union[str, os.PathLike[str]] ) -> SimplePath: ... # pragma: no cover @property def parent(self) -> SimplePath: ... # pragma: no cover def read_text(self, encoding=None) -> str: ... # pragma: no cover def read_bytes(self) -> bytes: ... # pragma: no cover def exists(self) -> bool: ... # pragma: no cover _vendor/importlib_metadata/py.typed 0000644 00000000000 15030122015 0013513 0 ustar 00 _vendor/importlib_metadata/_compat.py 0000644 00000002442 15030122015 0014024 0 ustar 00 import sys import platform __all__ = ['install', 'NullFinder'] def install(cls): """ Class decorator for installation on sys.meta_path. Adds the backport DistributionFinder to sys.meta_path and attempts to disable the finder functionality of the stdlib DistributionFinder. """ sys.meta_path.append(cls()) disable_stdlib_finder() return cls def disable_stdlib_finder(): """ Give the backport primacy for discovering path-based distributions by monkey-patching the stdlib O_O. See #91 for more background for rationale on this sketchy behavior. """ def matches(finder): return getattr( finder, '__module__', None ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions') for finder in filter(matches, sys.meta_path): # pragma: nocover del finder.find_distributions class NullFinder: """ A "Finder" (aka "MetaPathFinder") that never finds any modules, but may find distributions. """ @staticmethod def find_spec(*args, **kwargs): return None def pypy_partial(val): """ Adjust for variable stacklevel on partial under PyPy. Workaround for #327. """ is_pypy = platform.python_implementation() == 'PyPy' return val + is_pypy _vendor/importlib_metadata/_text.py 0000644 00000004166 15030122015 0013532 0 ustar 00 import re from ._functools import method_cache # from jaraco.text 3.5 class FoldedCase(str): """ A case insensitive string class; behaves just like str except compares equal when the only variation is case. >>> s = FoldedCase('hello world') >>> s == 'Hello World' True >>> 'Hello World' == s True >>> s != 'Hello World' False >>> s.index('O') 4 >>> s.split('O') ['hell', ' w', 'rld'] >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) ['alpha', 'Beta', 'GAMMA'] Sequence membership is straightforward. >>> "Hello World" in [s] True >>> s in ["Hello World"] True You may test for set inclusion, but candidate and elements must both be folded. >>> FoldedCase("Hello World") in {s} True >>> s in {FoldedCase("Hello World")} True String inclusion works as long as the FoldedCase object is on the right. >>> "hello" in FoldedCase("Hello World") True But not if the FoldedCase object is on the left: >>> FoldedCase('hello') in 'Hello World' False In that case, use in_: >>> FoldedCase('hello').in_('Hello World') True >>> FoldedCase('hello') > FoldedCase('Hello') False """ def __lt__(self, other): return self.lower() < other.lower() def __gt__(self, other): return self.lower() > other.lower() def __eq__(self, other): return self.lower() == other.lower() def __ne__(self, other): return self.lower() != other.lower() def __hash__(self): return hash(self.lower()) def __contains__(self, other): return super().lower().__contains__(other.lower()) def in_(self, other): "Does self appear in other?" return self in FoldedCase(other) # cache lower since it's likely to be called frequently. @method_cache def lower(self): return super().lower() def index(self, sub): return self.lower().index(sub.lower()) def split(self, splitter=' ', maxsplit=0): pattern = re.compile(re.escape(splitter), re.I) return pattern.split(self, maxsplit) _vendor/importlib_metadata/_collections.py 0000644 00000001347 15030122015 0015062 0 ustar 00 import collections # from jaraco.collections 3.3 class FreezableDefaultDict(collections.defaultdict): """ Often it is desirable to prevent the mutation of a default dict after its initial construction, such as to prevent mutation during iteration. >>> dd = FreezableDefaultDict(list) >>> dd[0].append('1') >>> dd.freeze() >>> dd[1] [] >>> len(dd) 1 """ def __missing__(self, key): return getattr(self, '_frozen', super().__missing__)(key) def freeze(self): self._frozen = lambda key: self.default_factory() class Pair(collections.namedtuple('Pair', 'name value')): @classmethod def parse(cls, text): return cls(*map(str.strip, text.split("=", 1))) _vendor/importlib_metadata/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000305 15030122015 0021757 0 ustar 00 o �h � @ s d S )N� r r r �h/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py�<module> s _vendor/importlib_metadata/compat/__pycache__/py311.cpython-310.pyc 0000644 00000002017 15030122015 0021077 0 ustar 00 o �h` � @ sF d dl Z d dlZd dlZd dlZdd� Zejdk r eZdS dd� ZdS )� Nc s dd�� fdd� }t j|d�S )a Workaround for https://github.com/python/cpython/issues/84538 to add backward compatibility for walk_up=True. An example affected package is dask-labextension, which uses jupyter-packaging to install JupyterLab javascript files outside of site-packages. F)�walk_upc s t �tj�� | ��S �N)�pathlib�Path�os�path�relpath)�rootr �r � �e/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/compat/py311.py� relative_to s zwrap.<locals>.relative_to)r )�types�SimpleNamespace)r r r r r �wrap s r )� � c C s | S r r )�xr r r �<lambda> s r )r r �sysr r � version_info� relative_fixr r r r �<module> s _vendor/importlib_metadata/compat/__pycache__/py39.cpython-310.pyc 0000644 00000002250 15030122015 0021025 0 ustar 00 o �hN � @ sb d Z ddlmZmZmZ erddlmZmZ ne ZZdedee fdd�Z d ede fd d �Z d S ) z) Compatibility layer with Python 3.8/3.9 � )� TYPE_CHECKING�Any�Optional� )� Distribution� EntryPoint�dist�returnc C sD z| j W S ty! ddlm} |�t| dd�p | jd � Y S w )z] Honor name normalization for distributions that don't provide ``_normalized_name``. r )�Prepared�nameN�Name)�_normalized_name�AttributeError� r � normalize�getattr�metadata)r r � r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/importlib_metadata/compat/py39.py�normalized_name s �r �epc K sP z | j di |��W S ty' ddlm} || j| j| j�j di |�� Y S w )zO Workaround for ``EntryPoint`` objects without the ``matches`` method. r )r Nr )�matchesr r r r �value�group)r �paramsr r r r � ep_matches s "�r N) �__doc__�typingr r r r r r �strr �boolr r r r r �<module> s _vendor/importlib_metadata/compat/py39.py 0000644 00000002116 15030122015 0014467 0 ustar 00 """ Compatibility layer with Python 3.8/3.9 """ from typing import TYPE_CHECKING, Any, Optional if TYPE_CHECKING: # pragma: no cover # Prevent circular imports on runtime. from .. import Distribution, EntryPoint else: Distribution = EntryPoint = Any def normalized_name(dist: Distribution) -> Optional[str]: """ Honor name normalization for distributions that don't provide ``_normalized_name``. """ try: return dist._normalized_name except AttributeError: from .. import Prepared # -> delay to prevent circular imports. return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name']) def ep_matches(ep: EntryPoint, **params) -> bool: """ Workaround for ``EntryPoint`` objects without the ``matches`` method. """ try: return ep.matches(**params) except AttributeError: from .. import EntryPoint # -> delay to prevent circular imports. # Reconstruct the EntryPoint object to make sure it is compatible. return EntryPoint(ep.name, ep.value, ep.group).matches(**params) _vendor/importlib_metadata/compat/py311.py 0000644 00000001140 15030122015 0014534 0 ustar 00 import os import pathlib import sys import types def wrap(path): # pragma: no cover """ Workaround for https://github.com/python/cpython/issues/84538 to add backward compatibility for walk_up=True. An example affected package is dask-labextension, which uses jupyter-packaging to install JupyterLab javascript files outside of site-packages. """ def relative_to(root, *, walk_up=False): return pathlib.Path(os.path.relpath(path, root)) return types.SimpleNamespace(relative_to=relative_to) relative_fix = wrap if sys.version_info < (3, 12) else lambda x: x _vendor/importlib_metadata/compat/__init__.py 0000644 00000000000 15030122015 0015410 0 ustar 00 _vendor/importlib_metadata/_functools.py 0000644 00000005517 15030122015 0014563 0 ustar 00 import types import functools # from jaraco.functools 3.3 def method_cache(method, cache_wrapper=None): """ Wrap lru_cache to support storing the cache data in the object instances. Abstracts the common paradigm where the method explicitly saves an underscore-prefixed protected property on first call and returns that subsequently. >>> class MyClass: ... calls = 0 ... ... @method_cache ... def method(self, value): ... self.calls += 1 ... return value >>> a = MyClass() >>> a.method(3) 3 >>> for x in range(75): ... res = a.method(x) >>> a.calls 75 Note that the apparent behavior will be exactly like that of lru_cache except that the cache is stored on each instance, so values in one instance will not flush values from another, and when an instance is deleted, so are the cached values for that instance. >>> b = MyClass() >>> for x in range(35): ... res = b.method(x) >>> b.calls 35 >>> a.method(0) 0 >>> a.calls 75 Note that if method had been decorated with ``functools.lru_cache()``, a.calls would have been 76 (due to the cached value of 0 having been flushed by the 'b' instance). Clear the cache with ``.cache_clear()`` >>> a.method.cache_clear() Same for a method that hasn't yet been called. >>> c = MyClass() >>> c.method.cache_clear() Another cache wrapper may be supplied: >>> cache = functools.lru_cache(maxsize=2) >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) >>> a = MyClass() >>> a.method2() 3 Caution - do not subsequently wrap the method with another decorator, such as ``@property``, which changes the semantics of the function. See also http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ for another implementation and additional justification. """ cache_wrapper = cache_wrapper or functools.lru_cache() def wrapper(self, *args, **kwargs): # it's the first call, replace the method with a cached, bound method bound_method = types.MethodType(method, self) cached_method = cache_wrapper(bound_method) setattr(self, method.__name__, cached_method) return cached_method(*args, **kwargs) # Support cache clear even before cache has been created. wrapper.cache_clear = lambda: None return wrapper # From jaraco.functools 3.3 def pass_none(func): """ Wrap func so it's not called if its first param is None >>> print_text = pass_none(print) >>> print_text('text') text >>> print_text(None) """ @functools.wraps(func) def wrapper(param, *args, **kwargs): if param is not None: return func(param, *args, **kwargs) return wrapper _vendor/importlib_metadata/_itertools.py 0000644 00000004024 15030122015 0014563 0 ustar 00 from itertools import filterfalse def unique_everseen(iterable, key=None): "List unique elements, preserving order. Remember all elements ever seen." # unique_everseen('AAAABBBCCDAABBB') --> A B C D # unique_everseen('ABBCcAD', str.lower) --> A B C D seen = set() seen_add = seen.add if key is None: for element in filterfalse(seen.__contains__, iterable): seen_add(element) yield element else: for element in iterable: k = key(element) if k not in seen: seen_add(k) yield element # copied from more_itertools 8.8 def always_iterable(obj, base_type=(str, bytes)): """If *obj* is iterable, return an iterator over its items:: >>> obj = (1, 2, 3) >>> list(always_iterable(obj)) [1, 2, 3] If *obj* is not iterable, return a one-item iterable containing *obj*:: >>> obj = 1 >>> list(always_iterable(obj)) [1] If *obj* is ``None``, return an empty iterable: >>> obj = None >>> list(always_iterable(None)) [] By default, binary and text strings are not considered iterable:: >>> obj = 'foo' >>> list(always_iterable(obj)) ['foo'] If *base_type* is set, objects for which ``isinstance(obj, base_type)`` returns ``True`` won't be considered iterable. >>> obj = {'a': 1} >>> list(always_iterable(obj)) # Iterate over the dict's keys ['a'] >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit [{'a': 1}] Set *base_type* to ``None`` to avoid any special handling and treat objects Python considers iterable as iterable: >>> obj = 'foo' >>> list(always_iterable(obj, base_type=None)) ['f', 'o', 'o'] """ if obj is None: return iter(()) if (base_type is not None) and isinstance(obj, base_type): return iter((obj,)) try: return iter(obj) except TypeError: return iter((obj,)) _vendor/importlib_metadata/__init__.py 0000644 00000102006 15030122015 0014136 0 ustar 00 from __future__ import annotations import os import re import abc import sys import json import zipp import email import types import inspect import pathlib import operator import textwrap import functools import itertools import posixpath import collections from . import _meta from .compat import py39, py311 from ._collections import FreezableDefaultDict, Pair from ._compat import ( NullFinder, install, ) from ._functools import method_cache, pass_none from ._itertools import always_iterable, unique_everseen from ._meta import PackageMetadata, SimplePath from contextlib import suppress from importlib import import_module from importlib.abc import MetaPathFinder from itertools import starmap from typing import Any, Iterable, List, Mapping, Match, Optional, Set, cast __all__ = [ 'Distribution', 'DistributionFinder', 'PackageMetadata', 'PackageNotFoundError', 'distribution', 'distributions', 'entry_points', 'files', 'metadata', 'packages_distributions', 'requires', 'version', ] class PackageNotFoundError(ModuleNotFoundError): """The package was not found.""" def __str__(self) -> str: return f"No package metadata was found for {self.name}" @property def name(self) -> str: # type: ignore[override] (name,) = self.args return name class Sectioned: """ A simple entry point config parser for performance >>> for item in Sectioned.read(Sectioned._sample): ... print(item) Pair(name='sec1', value='# comments ignored') Pair(name='sec1', value='a = 1') Pair(name='sec1', value='b = 2') Pair(name='sec2', value='a = 2') >>> res = Sectioned.section_pairs(Sectioned._sample) >>> item = next(res) >>> item.name 'sec1' >>> item.value Pair(name='a', value='1') >>> item = next(res) >>> item.value Pair(name='b', value='2') >>> item = next(res) >>> item.name 'sec2' >>> item.value Pair(name='a', value='2') >>> list(res) [] """ _sample = textwrap.dedent( """ [sec1] # comments ignored a = 1 b = 2 [sec2] a = 2 """ ).lstrip() @classmethod def section_pairs(cls, text): return ( section._replace(value=Pair.parse(section.value)) for section in cls.read(text, filter_=cls.valid) if section.name is not None ) @staticmethod def read(text, filter_=None): lines = filter(filter_, map(str.strip, text.splitlines())) name = None for value in lines: section_match = value.startswith('[') and value.endswith(']') if section_match: name = value.strip('[]') continue yield Pair(name, value) @staticmethod def valid(line: str): return line and not line.startswith('#') class EntryPoint: """An entry point as defined by Python packaging conventions. See `the packaging docs on entry points <https://packaging.python.org/specifications/entry-points/>`_ for more information. >>> ep = EntryPoint( ... name=None, group=None, value='package.module:attr [extra1, extra2]') >>> ep.module 'package.module' >>> ep.attr 'attr' >>> ep.extras ['extra1', 'extra2'] """ pattern = re.compile( r'(?P<module>[\w.]+)\s*' r'(:\s*(?P<attr>[\w.]+)\s*)?' r'((?P<extras>\[.*\])\s*)?$' ) """ A regular expression describing the syntax for an entry point, which might look like: - module - package.module - package.module:attribute - package.module:object.attribute - package.module:attr [extra1, extra2] Other combinations are possible as well. The expression is lenient about whitespace around the ':', following the attr, and following any extras. """ name: str value: str group: str dist: Optional[Distribution] = None def __init__(self, name: str, value: str, group: str) -> None: vars(self).update(name=name, value=value, group=group) def load(self) -> Any: """Load the entry point from its definition. If only a module is indicated by the value, return that module. Otherwise, return the named object. """ match = cast(Match, self.pattern.match(self.value)) module = import_module(match.group('module')) attrs = filter(None, (match.group('attr') or '').split('.')) return functools.reduce(getattr, attrs, module) @property def module(self) -> str: match = self.pattern.match(self.value) assert match is not None return match.group('module') @property def attr(self) -> str: match = self.pattern.match(self.value) assert match is not None return match.group('attr') @property def extras(self) -> List[str]: match = self.pattern.match(self.value) assert match is not None return re.findall(r'\w+', match.group('extras') or '') def _for(self, dist): vars(self).update(dist=dist) return self def matches(self, **params): """ EntryPoint matches the given parameters. >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]') >>> ep.matches(group='foo') True >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]') True >>> ep.matches(group='foo', name='other') False >>> ep.matches() True >>> ep.matches(extras=['extra1', 'extra2']) True >>> ep.matches(module='bing') True >>> ep.matches(attr='bong') True """ attrs = (getattr(self, param) for param in params) return all(map(operator.eq, params.values(), attrs)) def _key(self): return self.name, self.value, self.group def __lt__(self, other): return self._key() < other._key() def __eq__(self, other): return self._key() == other._key() def __setattr__(self, name, value): raise AttributeError("EntryPoint objects are immutable.") def __repr__(self): return ( f'EntryPoint(name={self.name!r}, value={self.value!r}, ' f'group={self.group!r})' ) def __hash__(self) -> int: return hash(self._key()) class EntryPoints(tuple): """ An immutable collection of selectable EntryPoint objects. """ __slots__ = () def __getitem__(self, name: str) -> EntryPoint: # type: ignore[override] """ Get the EntryPoint in self matching name. """ try: return next(iter(self.select(name=name))) except StopIteration: raise KeyError(name) def __repr__(self): """ Repr with classname and tuple constructor to signal that we deviate from regular tuple behavior. """ return '%s(%r)' % (self.__class__.__name__, tuple(self)) def select(self, **params) -> EntryPoints: """ Select entry points from self that match the given parameters (typically group and/or name). """ return EntryPoints(ep for ep in self if py39.ep_matches(ep, **params)) @property def names(self) -> Set[str]: """ Return the set of all names of all entry points. """ return {ep.name for ep in self} @property def groups(self) -> Set[str]: """ Return the set of all groups of all entry points. """ return {ep.group for ep in self} @classmethod def _from_text_for(cls, text, dist): return cls(ep._for(dist) for ep in cls._from_text(text)) @staticmethod def _from_text(text): return ( EntryPoint(name=item.value.name, value=item.value.value, group=item.name) for item in Sectioned.section_pairs(text or '') ) class PackagePath(pathlib.PurePosixPath): """A reference to a path in a package""" hash: Optional[FileHash] size: int dist: Distribution def read_text(self, encoding: str = 'utf-8') -> str: # type: ignore[override] return self.locate().read_text(encoding=encoding) def read_binary(self) -> bytes: return self.locate().read_bytes() def locate(self) -> SimplePath: """Return a path-like object for this path""" return self.dist.locate_file(self) class FileHash: def __init__(self, spec: str) -> None: self.mode, _, self.value = spec.partition('=') def __repr__(self) -> str: return f'<FileHash mode: {self.mode} value: {self.value}>' class Distribution(metaclass=abc.ABCMeta): """ An abstract Python distribution package. Custom providers may derive from this class and define the abstract methods to provide a concrete implementation for their environment. Some providers may opt to override the default implementation of some properties to bypass the file-reading mechanism. """ @abc.abstractmethod def read_text(self, filename) -> Optional[str]: """Attempt to load metadata file given by the name. Python distribution metadata is organized by blobs of text typically represented as "files" in the metadata directory (e.g. package-1.0.dist-info). These files include things like: - METADATA: The distribution metadata including fields like Name and Version and Description. - entry_points.txt: A series of entry points as defined in `the entry points spec <https://packaging.python.org/en/latest/specifications/entry-points/#file-format>`_. - RECORD: A record of files according to `this recording spec <https://packaging.python.org/en/latest/specifications/recording-installed-packages/#the-record-file>`_. A package may provide any set of files, including those not listed here or none at all. :param filename: The name of the file in the distribution info. :return: The text if found, otherwise None. """ @abc.abstractmethod def locate_file(self, path: str | os.PathLike[str]) -> SimplePath: """ Given a path to a file in this distribution, return a SimplePath to it. """ @classmethod def from_name(cls, name: str) -> Distribution: """Return the Distribution for the given package name. :param name: The name of the distribution package to search for. :return: The Distribution instance (or subclass thereof) for the named package, if found. :raises PackageNotFoundError: When the named package's distribution metadata cannot be found. :raises ValueError: When an invalid value is supplied for name. """ if not name: raise ValueError("A distribution name is required.") try: return next(iter(cls.discover(name=name))) except StopIteration: raise PackageNotFoundError(name) @classmethod def discover( cls, *, context: Optional[DistributionFinder.Context] = None, **kwargs ) -> Iterable[Distribution]: """Return an iterable of Distribution objects for all packages. Pass a ``context`` or pass keyword arguments for constructing a context. :context: A ``DistributionFinder.Context`` object. :return: Iterable of Distribution objects for packages matching the context. """ if context and kwargs: raise ValueError("cannot accept context and kwargs") context = context or DistributionFinder.Context(**kwargs) return itertools.chain.from_iterable( resolver(context) for resolver in cls._discover_resolvers() ) @staticmethod def at(path: str | os.PathLike[str]) -> Distribution: """Return a Distribution for the indicated metadata path. :param path: a string or path-like object :return: a concrete Distribution instance for the path """ return PathDistribution(pathlib.Path(path)) @staticmethod def _discover_resolvers(): """Search the meta_path for resolvers (MetadataPathFinders).""" declared = ( getattr(finder, 'find_distributions', None) for finder in sys.meta_path ) return filter(None, declared) @property def metadata(self) -> _meta.PackageMetadata: """Return the parsed metadata for this Distribution. The returned object will have keys that name the various bits of metadata per the `Core metadata specifications <https://packaging.python.org/en/latest/specifications/core-metadata/#core-metadata>`_. Custom providers may provide the METADATA file or override this property. """ # deferred for performance (python/cpython#109829) from . import _adapters opt_text = ( self.read_text('METADATA') or self.read_text('PKG-INFO') # This last clause is here to support old egg-info files. Its # effect is to just end up using the PathDistribution's self._path # (which points to the egg-info file) attribute unchanged. or self.read_text('') ) text = cast(str, opt_text) return _adapters.Message(email.message_from_string(text)) @property def name(self) -> str: """Return the 'Name' metadata for the distribution package.""" return self.metadata['Name'] @property def _normalized_name(self): """Return a normalized version of the name.""" return Prepared.normalize(self.name) @property def version(self) -> str: """Return the 'Version' metadata for the distribution package.""" return self.metadata['Version'] @property def entry_points(self) -> EntryPoints: """ Return EntryPoints for this distribution. Custom providers may provide the ``entry_points.txt`` file or override this property. """ return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self) @property def files(self) -> Optional[List[PackagePath]]: """Files in this distribution. :return: List of PackagePath for this distribution or None Result is `None` if the metadata file that enumerates files (i.e. RECORD for dist-info, or installed-files.txt or SOURCES.txt for egg-info) is missing. Result may be empty if the metadata exists but is empty. Custom providers are recommended to provide a "RECORD" file (in ``read_text``) or override this property to allow for callers to be able to resolve filenames provided by the package. """ def make_file(name, hash=None, size_str=None): result = PackagePath(name) result.hash = FileHash(hash) if hash else None result.size = int(size_str) if size_str else None result.dist = self return result @pass_none def make_files(lines): # Delay csv import, since Distribution.files is not as widely used # as other parts of importlib.metadata import csv return starmap(make_file, csv.reader(lines)) @pass_none def skip_missing_files(package_paths): return list(filter(lambda path: path.locate().exists(), package_paths)) return skip_missing_files( make_files( self._read_files_distinfo() or self._read_files_egginfo_installed() or self._read_files_egginfo_sources() ) ) def _read_files_distinfo(self): """ Read the lines of RECORD. """ text = self.read_text('RECORD') return text and text.splitlines() def _read_files_egginfo_installed(self): """ Read installed-files.txt and return lines in a similar CSV-parsable format as RECORD: each file must be placed relative to the site-packages directory and must also be quoted (since file names can contain literal commas). This file is written when the package is installed by pip, but it might not be written for other installation methods. Assume the file is accurate if it exists. """ text = self.read_text('installed-files.txt') # Prepend the .egg-info/ subdir to the lines in this file. # But this subdir is only available from PathDistribution's # self._path. subdir = getattr(self, '_path', None) if not text or not subdir: return paths = ( py311.relative_fix((subdir / name).resolve()) .relative_to(self.locate_file('').resolve(), walk_up=True) .as_posix() for name in text.splitlines() ) return map('"{}"'.format, paths) def _read_files_egginfo_sources(self): """ Read SOURCES.txt and return lines in a similar CSV-parsable format as RECORD: each file name must be quoted (since it might contain literal commas). Note that SOURCES.txt is not a reliable source for what files are installed by a package. This file is generated for a source archive, and the files that are present there (e.g. setup.py) may not correctly reflect the files that are present after the package has been installed. """ text = self.read_text('SOURCES.txt') return text and map('"{}"'.format, text.splitlines()) @property def requires(self) -> Optional[List[str]]: """Generated requirements specified for this Distribution""" reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs() return reqs and list(reqs) def _read_dist_info_reqs(self): return self.metadata.get_all('Requires-Dist') def _read_egg_info_reqs(self): source = self.read_text('requires.txt') return pass_none(self._deps_from_requires_text)(source) @classmethod def _deps_from_requires_text(cls, source): return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source)) @staticmethod def _convert_egg_info_reqs_to_simple_reqs(sections): """ Historically, setuptools would solicit and store 'extra' requirements, including those with environment markers, in separate sections. More modern tools expect each dependency to be defined separately, with any relevant extras and environment markers attached directly to that requirement. This method converts the former to the latter. See _test_deps_from_requires_text for an example. """ def make_condition(name): return name and f'extra == "{name}"' def quoted_marker(section): section = section or '' extra, sep, markers = section.partition(':') if extra and markers: markers = f'({markers})' conditions = list(filter(None, [markers, make_condition(extra)])) return '; ' + ' and '.join(conditions) if conditions else '' def url_req_space(req): """ PEP 508 requires a space between the url_spec and the quoted_marker. Ref python/importlib_metadata#357. """ # '@' is uniquely indicative of a url_req. return ' ' * ('@' in req) for section in sections: space = url_req_space(section.value) yield section.value + space + quoted_marker(section.name) @property def origin(self): return self._load_json('direct_url.json') def _load_json(self, filename): return pass_none(json.loads)( self.read_text(filename), object_hook=lambda data: types.SimpleNamespace(**data), ) class DistributionFinder(MetaPathFinder): """ A MetaPathFinder capable of discovering installed distributions. Custom providers should implement this interface in order to supply metadata. """ class Context: """ Keyword arguments presented by the caller to ``distributions()`` or ``Distribution.discover()`` to narrow the scope of a search for distributions in all DistributionFinders. Each DistributionFinder may expect any parameters and should attempt to honor the canonical parameters defined below when appropriate. This mechanism gives a custom provider a means to solicit additional details from the caller beyond "name" and "path" when searching distributions. For example, imagine a provider that exposes suites of packages in either a "public" or "private" ``realm``. A caller may wish to query only for distributions in a particular realm and could call ``distributions(realm="private")`` to signal to the custom provider to only include distributions from that realm. """ name = None """ Specific name for which a distribution finder should match. A name of ``None`` matches all distributions. """ def __init__(self, **kwargs): vars(self).update(kwargs) @property def path(self) -> List[str]: """ The sequence of directory path that a distribution finder should search. Typically refers to Python installed package paths such as "site-packages" directories and defaults to ``sys.path``. """ return vars(self).get('path', sys.path) @abc.abstractmethod def find_distributions(self, context=Context()) -> Iterable[Distribution]: """ Find distributions. Return an iterable of all Distribution instances capable of loading the metadata for packages matching the ``context``, a DistributionFinder.Context instance. """ class FastPath: """ Micro-optimized class for searching a root for children. Root is a path on the file system that may contain metadata directories either as natural directories or within a zip file. >>> FastPath('').children() ['...'] FastPath objects are cached and recycled for any given root. >>> FastPath('foobar') is FastPath('foobar') True """ @functools.lru_cache() # type: ignore def __new__(cls, root): return super().__new__(cls) def __init__(self, root): self.root = root def joinpath(self, child): return pathlib.Path(self.root, child) def children(self): with suppress(Exception): return os.listdir(self.root or '.') with suppress(Exception): return self.zip_children() return [] def zip_children(self): zip_path = zipp.Path(self.root) names = zip_path.root.namelist() self.joinpath = zip_path.joinpath return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names) def search(self, name): return self.lookup(self.mtime).search(name) @property def mtime(self): with suppress(OSError): return os.stat(self.root).st_mtime self.lookup.cache_clear() @method_cache def lookup(self, mtime): return Lookup(self) class Lookup: """ A micro-optimized class for searching a (fast) path for metadata. """ def __init__(self, path: FastPath): """ Calculate all of the children representing metadata. From the children in the path, calculate early all of the children that appear to represent metadata (infos) or legacy metadata (eggs). """ base = os.path.basename(path.root).lower() base_is_egg = base.endswith(".egg") self.infos = FreezableDefaultDict(list) self.eggs = FreezableDefaultDict(list) for child in path.children(): low = child.lower() if low.endswith((".dist-info", ".egg-info")): # rpartition is faster than splitext and suitable for this purpose. name = low.rpartition(".")[0].partition("-")[0] normalized = Prepared.normalize(name) self.infos[normalized].append(path.joinpath(child)) elif base_is_egg and low == "egg-info": name = base.rpartition(".")[0].partition("-")[0] legacy_normalized = Prepared.legacy_normalize(name) self.eggs[legacy_normalized].append(path.joinpath(child)) self.infos.freeze() self.eggs.freeze() def search(self, prepared: Prepared): """ Yield all infos and eggs matching the Prepared query. """ infos = ( self.infos[prepared.normalized] if prepared else itertools.chain.from_iterable(self.infos.values()) ) eggs = ( self.eggs[prepared.legacy_normalized] if prepared else itertools.chain.from_iterable(self.eggs.values()) ) return itertools.chain(infos, eggs) class Prepared: """ A prepared search query for metadata on a possibly-named package. Pre-calculates the normalization to prevent repeated operations. >>> none = Prepared(None) >>> none.normalized >>> none.legacy_normalized >>> bool(none) False >>> sample = Prepared('Sample__Pkg-name.foo') >>> sample.normalized 'sample_pkg_name_foo' >>> sample.legacy_normalized 'sample__pkg_name.foo' >>> bool(sample) True """ normalized = None legacy_normalized = None def __init__(self, name: Optional[str]): self.name = name if name is None: return self.normalized = self.normalize(name) self.legacy_normalized = self.legacy_normalize(name) @staticmethod def normalize(name): """ PEP 503 normalization plus dashes as underscores. """ return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_') @staticmethod def legacy_normalize(name): """ Normalize the package name as found in the convention in older packaging tools versions and specs. """ return name.lower().replace('-', '_') def __bool__(self): return bool(self.name) @install class MetadataPathFinder(NullFinder, DistributionFinder): """A degenerate finder for distribution packages on the file system. This finder supplies only a find_distributions() method for versions of Python that do not have a PathFinder find_distributions(). """ @classmethod def find_distributions( cls, context=DistributionFinder.Context() ) -> Iterable[PathDistribution]: """ Find distributions. Return an iterable of all Distribution instances capable of loading the metadata for packages matching ``context.name`` (or all names if ``None`` indicated) along the paths in the list of directories ``context.path``. """ found = cls._search_paths(context.name, context.path) return map(PathDistribution, found) @classmethod def _search_paths(cls, name, paths): """Find metadata directories in paths heuristically.""" prepared = Prepared(name) return itertools.chain.from_iterable( path.search(prepared) for path in map(FastPath, paths) ) @classmethod def invalidate_caches(cls) -> None: FastPath.__new__.cache_clear() class PathDistribution(Distribution): def __init__(self, path: SimplePath) -> None: """Construct a distribution. :param path: SimplePath indicating the metadata directory. """ self._path = path def read_text(self, filename: str | os.PathLike[str]) -> Optional[str]: with suppress( FileNotFoundError, IsADirectoryError, KeyError, NotADirectoryError, PermissionError, ): return self._path.joinpath(filename).read_text(encoding='utf-8') return None read_text.__doc__ = Distribution.read_text.__doc__ def locate_file(self, path: str | os.PathLike[str]) -> SimplePath: return self._path.parent / path @property def _normalized_name(self): """ Performance optimization: where possible, resolve the normalized name from the file system path. """ stem = os.path.basename(str(self._path)) return ( pass_none(Prepared.normalize)(self._name_from_stem(stem)) or super()._normalized_name ) @staticmethod def _name_from_stem(stem): """ >>> PathDistribution._name_from_stem('foo-3.0.egg-info') 'foo' >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info') 'CherryPy' >>> PathDistribution._name_from_stem('face.egg-info') 'face' >>> PathDistribution._name_from_stem('foo.bar') """ filename, ext = os.path.splitext(stem) if ext not in ('.dist-info', '.egg-info'): return name, sep, rest = filename.partition('-') return name def distribution(distribution_name: str) -> Distribution: """Get the ``Distribution`` instance for the named package. :param distribution_name: The name of the distribution package as a string. :return: A ``Distribution`` instance (or subclass thereof). """ return Distribution.from_name(distribution_name) def distributions(**kwargs) -> Iterable[Distribution]: """Get all ``Distribution`` instances in the current environment. :return: An iterable of ``Distribution`` instances. """ return Distribution.discover(**kwargs) def metadata(distribution_name: str) -> _meta.PackageMetadata: """Get the metadata for the named package. :param distribution_name: The name of the distribution package to query. :return: A PackageMetadata containing the parsed metadata. """ return Distribution.from_name(distribution_name).metadata def version(distribution_name: str) -> str: """Get the version string for the named package. :param distribution_name: The name of the distribution package to query. :return: The version string for the package as defined in the package's "Version" metadata key. """ return distribution(distribution_name).version _unique = functools.partial( unique_everseen, key=py39.normalized_name, ) """ Wrapper for ``distributions`` to return unique distributions by name. """ def entry_points(**params) -> EntryPoints: """Return EntryPoint objects for all installed packages. Pass selection parameters (group or name) to filter the result to entry points matching those properties (see EntryPoints.select()). :return: EntryPoints for all installed packages. """ eps = itertools.chain.from_iterable( dist.entry_points for dist in _unique(distributions()) ) return EntryPoints(eps).select(**params) def files(distribution_name: str) -> Optional[List[PackagePath]]: """Return a list of files for the named package. :param distribution_name: The name of the distribution package to query. :return: List of files composing the distribution. """ return distribution(distribution_name).files def requires(distribution_name: str) -> Optional[List[str]]: """ Return a list of requirements for the named package. :return: An iterable of requirements, suitable for packaging.requirement.Requirement. """ return distribution(distribution_name).requires def packages_distributions() -> Mapping[str, List[str]]: """ Return a mapping of top-level packages to their distributions. >>> import collections.abc >>> pkgs = packages_distributions() >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values()) True """ pkg_to_dist = collections.defaultdict(list) for dist in distributions(): for pkg in _top_level_declared(dist) or _top_level_inferred(dist): pkg_to_dist[pkg].append(dist.metadata['Name']) return dict(pkg_to_dist) def _top_level_declared(dist): return (dist.read_text('top_level.txt') or '').split() def _topmost(name: PackagePath) -> Optional[str]: """ Return the top-most parent as long as there is a parent. """ top, *rest = name.parts return top if rest else None def _get_toplevel_name(name: PackagePath) -> str: """ Infer a possibly importable module name from a name presumed on sys.path. >>> _get_toplevel_name(PackagePath('foo.py')) 'foo' >>> _get_toplevel_name(PackagePath('foo')) 'foo' >>> _get_toplevel_name(PackagePath('foo.pyc')) 'foo' >>> _get_toplevel_name(PackagePath('foo/__init__.py')) 'foo' >>> _get_toplevel_name(PackagePath('foo.pth')) 'foo.pth' >>> _get_toplevel_name(PackagePath('foo.dist-info')) 'foo.dist-info' """ return _topmost(name) or ( # python/typeshed#10328 inspect.getmodulename(name) # type: ignore or str(name) ) def _top_level_inferred(dist): opt_names = set(map(_get_toplevel_name, always_iterable(dist.files))) def importable_name(name): return '.' not in name return filter(importable_name, opt_names) _vendor/platformdirs/__pycache__/version.cpython-310.pyc 0000644 00000000772 15030122015 0017277 0 ustar 00 o �h� � @ sh U d Z e rddlmZmZ eeeef df ZneZeed< eed< eed< eed< d Z Z d Z Z d S ) F� )�Tuple�Union.�version� __version__�__version_tuple__� version_tuplez4.2.2)� � r N) � TYPE_CHECKING�typingr r �int�str� VERSION_TUPLE�object�__annotations__r r r r � r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/version.py�<module> s _vendor/platformdirs/__pycache__/__init__.cpython-310.pyc 0000644 00000036646 15030122015 0017362 0 ustar 00 o �h�V � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z ddl m Z er6dd l mZ dd lmZ d^d d�Ze� ZeZ d_d`dd�Z d_dad d �Z d_d`d d �Z d_dad d!�Z " dbdcd$d%�Z " dbdcd&d'�Z d_d`d(d)�Z " dbdcd*d+�Zddd,d-�Zddd.d/�Z ddd0d1�Z ddd2d3�Z ddd4d5�Z ddd6d7�Z " dbdcd8d9�Z! " dbdcd:d;�Z" d_ded=d>�Z# d_dfd?d@�Z$ d_dedAdB�Z% d_dfdCdD�Z& " dbdgdEdF�Z' " dbdgdGdH�Z( d_dedIdJ�Z) " dbdgdKdL�Z*dhdMdN�Z+dhdOdP�Z,dhdQdR�Z-dhdSdT�Z.dhdUdV�Z/dhdWdX�Z0 " dbdgdYdZ�Z1 " dbdgd[d\�Z2g d]�Z3dS )iz� Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and usage. � )� annotationsN)� TYPE_CHECKING� )�PlatformDirsABC)� __version__)�__version_tuple__)�Path)�Literal�return�type[PlatformDirsABC]c C s� t jdkr ddlm} nt jdkrddlm} nddlm} t� d�dkrKt� d �d krKt� d �s6t� d �r8| S dd l m } |� d urKddl m } |S | S )N�win32r )�Windows�darwin)�MacOS)�Unix� ANDROID_DATAz/data� ANDROID_ROOTz/system�SHELL�PREFIX)�_android_folder)�Android) �sys�platform�platformdirs.windowsr �platformdirs.macosr �platformdirs.unixr �os�getenv�platformdirs.androidr r )�Resultr r � r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/__init__.py�_set_platform_dir_class s r" F�appname� str | None� appauthor�str | None | Literal[False]�version�roaming�bool� ensure_exists�strc C � t | ||||d�jS )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data directory tied to the user �r# r% r' r( r* )� PlatformDirs� user_data_dirr- r r r! r/ 1 � ��r/ � multipathc C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data directory shared by users �r# r% r' r1 r* )r. � site_data_dirr2 r r r! r3 I r0 r3 c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config directory tied to the user r- )r. �user_config_dirr- r r r! r4 a r0 r4 c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config directory shared by the users r2 )r. �site_config_dirr2 r r r! r5 y r0 r5 T�opinionc C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache directory tied to the user �r# r% r' r6 r* )r. �user_cache_dirr7 r r r! r8 � r0 r8 c C r, �a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache directory tied to the user r7 )r. �site_cache_dirr7 r r r! r: � r0 r: c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: state directory tied to the user r- )r. �user_state_dirr- r r r! r; � r0 r; c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: log directory tied to the user r7 )r. � user_log_dirr7 r r r! r< � r0 r< c C � t � jS )z.:returns: documents directory tied to the user)r. �user_documents_dirr r r r! r> � � r> c C r= )z.:returns: downloads directory tied to the user)r. �user_downloads_dirr r r r! r@ � r? r@ c C r= )z-:returns: pictures directory tied to the user)r. �user_pictures_dirr r r r! rA � r? rA c C r= )z+:returns: videos directory tied to the user)r. �user_videos_dirr r r r! rB r? rB c C r= )z*:returns: music directory tied to the user)r. �user_music_dirr r r r! rC r? rC c C r= )z,:returns: desktop directory tied to the user)r. �user_desktop_dirr r r r! rD r? rD c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime directory tied to the user r7 )r. �user_runtime_dirr7 r r r! rE r0 rE c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime directory shared by users r7 )r. �site_runtime_dirr7 r r r! rF ' r0 rF r c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data path tied to the user r- )r. �user_data_pathr- r r r! rG ? r0 rG c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data path shared by users r2 )r. �site_data_pathr2 r r r! rH W r0 rH c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config path tied to the user r- )r. �user_config_pathr- r r r! rI o r0 rI c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config path shared by the users r2 )r. �site_config_pathr2 r r r! rJ � r0 rJ c C r, r9 )r. �site_cache_pathr7 r r r! rK � r0 rK c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache path tied to the user r7 )r. �user_cache_pathr7 r r r! rL � r0 rL c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: state path tied to the user r- )r. �user_state_pathr- r r r! rM � r0 rM c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: log path tied to the user r7 )r. � user_log_pathr7 r r r! rN � r0 rN c C r= )z+:returns: documents a path tied to the user)r. �user_documents_pathr r r r! rO � r? rO c C r= )z):returns: downloads path tied to the user)r. �user_downloads_pathr r r r! rP r? rP c C r= )z(:returns: pictures path tied to the user)r. �user_pictures_pathr r r r! rQ r? rQ c C r= )z&:returns: videos path tied to the user)r. �user_videos_pathr r r r! rR r? rR c C r= )z%:returns: music path tied to the user)r. �user_music_pathr r r r! rS r? rS c C r= )z':returns: desktop path tied to the user)r. �user_desktop_pathr r r r! rT r? rT c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime path tied to the user r7 )r. �user_runtime_pathr7 r r r! rU r0 rU c C r, )a� :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime path shared by users r7 )r. �site_runtime_pathr7 r r r! rV 5 r0 rV )%�AppDirsr. r r �__version_info__r: rK r5 rJ r3 rH rF rV r8 rL r4 rI r/ rG rD rT r> rO r@ rP r< rN rC rS rA rQ rE rU r; rM rB rR )r r )NNNFF) r# r$ r% r& r' r$ r( r) r* r) r r+ ) r# r$ r% r& r' r$ r1 r) r* r) r r+ )NNNTF) r# r$ r% r& r' r$ r6 r) r* r) r r+ )r r+ ) r# r$ r% r& r' r$ r( r) r* r) r r ) r# r$ r% r& r' r$ r1 r) r* r) r r ) r# r$ r% r& r' r$ r6 r) r* r) r r )r r )4�__doc__� __future__r r r �typingr �apir r' r r rX �pathlibr r r" r. rW r/ r3 r4 r5 r8 r: r; r< r> r@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU rV �__all__r r r r! �<module> s& � � � � � � � � � � � � � � � � � � � � _vendor/platformdirs/__pycache__/macos.cpython-310.pyc 0000644 00000013374 15030122015 0016716 0 ustar 00 o �h� � @ sF d Z ddlmZ ddlZddlZddlmZ G dd� de�ZdgZ dS )zmacOS.� )� annotationsN� )�PlatformDirsABCc @ s� e Zd ZdZed%dd��Zed%dd��Zed%dd ��Zed%d d ��Zed%d d ��Z ed%dd��Z ed%dd��Z ed%dd��Z ed%dd��Z ed%dd��Zed%dd��Zed%dd��Zed%d d ��Zed%d d ��Zed%d d!��Zed%d"d#��Zd$S )&�MacOSa� Platform directories for the macOS operating system. Follows the guidance from `Apple documentation <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. �return�strc C � | � tj�d��S )zb:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``z ~/Library/Application Support�� _append_app_name_and_version�os�path� expanduser��self� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/macos.py� user_data_dir � zMacOS.user_data_dirc C �J t j�d�}|r| �d�gng }|�| �d�� | jr!tj�|�S |d S )aB :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``. If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``. If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version`` � /opt/homebrewz/opt/homebrew/sharez /Library/Application Supportr � �sys�prefix� startswithr �append� multipathr �pathsep�join�r � is_homebrew� path_listr r r � site_data_dir � zMacOS.site_data_dirc C � | j S )zC:return: config directory tied to the user, same as `user_data_dir`�r r r r r �user_config_dir- � zMacOS.user_config_dirc C r# )zF:return: config directory shared by the users, same as `site_data_dir`)r! r r r r �site_config_dir2 r& zMacOS.site_config_dirc C r )zV:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``z~/Library/Cachesr r r r r �user_cache_dir7 r zMacOS.user_cache_dirc C r )a1 :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``. If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version`` r z/opt/homebrew/var/cachez/Library/Cachesr r r r r r �site_cache_dir< r" zMacOS.site_cache_dirc C r# )zB:return: state directory tied to the user, same as `user_data_dir`r$ r r r r �user_state_dirM r& zMacOS.user_state_dirc C r )zR:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``z~/Library/Logsr r r r r � user_log_dirR r zMacOS.user_log_dirc C � t j�d�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``z ~/Documents�r r r r r r r �user_documents_dirW � zMacOS.user_documents_dirc C r, )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``z ~/Downloadsr- r r r r �user_downloads_dir\ r/ zMacOS.user_downloads_dirc C r, )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``z ~/Picturesr- r r r r �user_pictures_dira r/ zMacOS.user_pictures_dirc C r, )z=:return: videos directory tied to the user, e.g. ``~/Movies``z~/Moviesr- r r r r �user_videos_dirf r/ zMacOS.user_videos_dirc C r, )z;:return: music directory tied to the user, e.g. ``~/Music``z~/Musicr- r r r r �user_music_dirk r/ zMacOS.user_music_dirc C r, )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``z ~/Desktopr- r r r r �user_desktop_dirp r/ zMacOS.user_desktop_dirc C r )zg:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``z ~/Library/Caches/TemporaryItemsr r r r r �user_runtime_diru r zMacOS.user_runtime_dirc C r# )zF:return: runtime directory shared by users, same as `user_runtime_dir`)r5 r r r r �site_runtime_dirz r& zMacOS.site_runtime_dirN)r r )�__name__� __module__� __qualname__�__doc__�propertyr r! r% r' r( r) r* r+ r. r0 r1 r2 r3 r4 r5 r6 r r r r r sD r ) r: � __future__r �os.pathr r �apir r �__all__r r r r �<module> s v� _vendor/platformdirs/__pycache__/windows.cpython-310.pyc 0000644 00000021567 15030122015 0017311 0 ustar 00 o �h�' � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z er*ddl m Z G d d � d e �Z ddd�Zd dd�Zddd�Zddd�Zd dd�Zedd�e� �Zd gZdS ) zWindows.� )� annotationsN)� lru_cache)� TYPE_CHECKING� )�PlatformDirsABC)�Callablec @ s e Zd ZdZed+dd��Zdd�d,d d �Zed+d d��Zed+dd��Zed+dd��Z ed+dd��Z ed+dd��Z ed+dd��Z ed+dd��Z ed+dd ��Zed+d d ��Zed+d d ��Zed+d!d"��Zed+d#d$��Zed+d%d&��Zed+d'd(��Zed+d)d*��ZdS )-�Windowsa� `MSDN on where to store app data files <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`, `version <platformdirs.api.PlatformDirsABC.version>`, `roaming <platformdirs.api.PlatformDirsABC.roaming>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. �return�strc C s( | j rdnd}tj�t|��}| �|�S )z� :return: data directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname`` (not roaming) or ``%USERPROFILE%\AppData\Roaming\$appauthor\$appname`` (roaming) � CSIDL_APPDATA�CSIDL_LOCAL_APPDATA)�roaming�os�path�normpath�get_win_folder� _append_parts)�self�constr � r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/windows.py� user_data_dir s zWindows.user_data_dirN�� opinion_valuer r � str | Nonec C s� g }| j r0| jdur| jp| j }|�|� |�| j � |d ur'| jr'|�|� | jr0|�| j� tjj|g|�R � }| �|� |S )NF) �appname� appauthor�append�opinion�versionr r �join� _optionally_create_directory)r r r �params�authorr r r r & s zWindows._append_partsc C s t j�td��}| �|�S )zT:return: data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``�CSIDL_COMMON_APPDATA�r r r r r �r r r r r � site_data_dir5 s zWindows.site_data_dirc C � | j S )zC:return: config directory tied to the user, same as `user_data_dir`�r �r r r r �user_config_dir; � zWindows.user_config_dirc C r( )zF:return: config directory shared by the users, same as `site_data_dir`)r' r* r r r �site_config_dir@ r, zWindows.site_config_dirc C � t j�td��}| j|dd�S )z� :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname\Cache\$version`` r �Cacher r% r& r r r �user_cache_dirE s zWindows.user_cache_dirc C r. )zd:return: cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``r$ r/ r r% r& r r r �site_cache_dirN s zWindows.site_cache_dirc C r( )zB:return: state directory tied to the user, same as `user_data_dir`r) r* r r r �user_state_dirT r, zWindows.user_state_dirc C s( | j }| jrtj�|d�}| �|� |S )zg:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it�Logs)r r r r r r! r& r r r � user_log_dirY s zWindows.user_log_dirc C � t j�td��S )zN:return: documents directory tied to the user e.g. ``%USERPROFILE%\Documents``�CSIDL_PERSONAL�r r r r r* r r r �user_documents_dirb � zWindows.user_documents_dirc C r5 )zN:return: downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``�CSIDL_DOWNLOADSr7 r* r r r �user_downloads_dirg r9 zWindows.user_downloads_dirc C r5 )zL:return: pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``�CSIDL_MYPICTURESr7 r* r r r �user_pictures_dirl r9 zWindows.user_pictures_dirc C r5 )zH:return: videos directory tied to the user e.g. ``%USERPROFILE%\Videos``� CSIDL_MYVIDEOr7 r* r r r �user_videos_dirq r9 zWindows.user_videos_dirc C r5 )zF:return: music directory tied to the user e.g. ``%USERPROFILE%\Music``� CSIDL_MYMUSICr7 r* r r r �user_music_dirv r9 zWindows.user_music_dirc C r5 )zK:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``�CSIDL_DESKTOPDIRECTORYr7 r* r r r �user_desktop_dir{ r9 zWindows.user_desktop_dirc C s$ t j�t j�td�d��}| �|�S )z� :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname`` r �Temp)r r r r r r r& r r r �user_runtime_dir� s zWindows.user_runtime_dirc C r( )zF:return: runtime directory shared by users, same as `user_runtime_dir`)rE r* r r r �site_runtime_dir� r, zWindows.site_runtime_dir)r r )r r r r r r )�__name__� __module__� __qualname__�__doc__�propertyr r r' r+ r- r0 r1 r2 r4 r8 r; r= r? rA rC rE rF r r r r r sF r � csidl_namer r c C sj t | �}|dur |S dddd��| �}|du r d| � �}t|��tj�|�}|du r3d|� �}t|��|S )z&Get folder from environment variables.N�APPDATA�ALLUSERSPROFILE� LOCALAPPDATA)r r$ r �Unknown CSIDL name: z Unset environment variable: )�(get_win_folder_if_csidl_name_not_env_var�get� ValueErrorr �environ)rL �result� env_var_name�msgr r r � get_win_folder_from_env_vars� s" �� rX r c C s� | dkrt j�t j�t jd �d�S | dkr$t j�t j�t jd �d�S | dkr6t j�t j�t jd �d�S | dkrHt j�t j�t jd �d �S | d krZt j�t j�t jd �d �S d S ) zMGet a folder for a CSIDL name that does not exist as an environment variable.r6 � USERPROFILE� Documentsr: � Downloadsr< �Picturesr> �Videosr@ �MusicN)r r r r rT )rL r r r rQ � s rQ c C sr ddddddddd �� | �}|d u rd | � �}t|��tjd kr"t�d d l}|�|jd�}|�||�\}}t |�S )z� Get folder from the registry. This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer for all CSIDL_* names. �AppDatazCommon AppDataz Local AppData�Personalz&{374DE290-123F-4565-9164-39C4925E467B}z My PictureszMy VideozMy Music)r r$ r r6 r: r< r> r@ NrP �win32r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) rR rS �sys�platform�NotImplementedError�winreg�OpenKey�HKEY_CURRENT_USER� QueryValueExr )rL �shell_folder_namerW re �key� directory�_r r r � get_win_folder_from_registry� s( � � rm c C s� ddl }ddddddd d d d � �| �}|du r d | � �}t|��|�d�}t|d�}|j�d|dd|� tdd� |D ��rM|�d�}|j� |j |d�rM|}| dkrYt j � |j d�S |j S )zGet folder with ctypes.r N� �# � � �' � � �( � ) r r$ r r6 r< r> r@ r: rB rP i �windllc s s � | ] }t |�d kV qdS )� N)�ord)�.0�cr r r � <genexpr>� s � z,get_win_folder_via_ctypes.<locals>.<genexpr>r: r[ )�ctypesrR rS �create_unicode_buffer�getattr�shell32�SHGetFolderPathW�any�kernel32�GetShortPathNameW�valuer r r )rL r} � csidl_constrW �bufrw �buf2r r r �get_win_folder_via_ctypes� s4 � � r� �Callable[[str], str]c C sT zdd l } W n ty Y nw t| d�rtS zdd l}W tS ty) t Y S w )Nr rw )r} � ImportError�hasattrr� re rX rm )r} re r r r �_pick_get_win_folder� s � ��r� )�maxsize)rL r r r )rL r r r )r r� )rJ � __future__r r rb � functoolsr �typingr �apir �collections.abcr r rX rQ rm r� r� r �__all__r r r r �<module> s$ '� _vendor/platformdirs/__pycache__/__main__.cpython-310.pyc 0000644 00000002543 15030122015 0017330 0 ustar 00 o �h� � @ sD d Z ddlmZ ddlmZmZ dZd dd�Zed kr e� d S d S ) zMain entry point.� )� annotations)� PlatformDirs� __version__)� user_data_dir�user_config_dir�user_cache_dir�user_state_dir� user_log_dir�user_documents_dir�user_downloads_dir�user_pictures_dir�user_videos_dir�user_music_dir�user_runtime_dir� site_data_dir�site_config_dir�site_cache_dir�site_runtime_dir�return�Nonec C s� d} d}t dt� d�� t d� t| |dd�}tD ]}t |� dt||�� �� qt d � t| |�}tD ]}t |� dt||�� �� q3t d � t| �}tD ]}t |� dt||�� �� qLt d � t| d d �}tD ]}t |� dt||�� �� qgdS )zRun the main entry point.�MyApp� MyCompanyz-- platformdirs z --z%-- app dirs (with optional 'version')z1.0)�versionz: z) -- app dirs (without optional 'version')z+ -- app dirs (without optional 'appauthor')z( -- app dirs (with disabled 'appauthor')F)� appauthorN)�printr r �PROPS�getattr)�app_name� app_author�dirs�prop� r! �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/__main__.py�main s( �r# �__main__N)r r ) �__doc__� __future__r � platformdirsr r r r# �__name__r! r! r! r" �<module> s � _vendor/platformdirs/__pycache__/api.cpython-310.pyc 0000644 00000023276 15030122015 0016367 0 ustar 00 o �h$# � @ sh d Z ddlmZ ddlZddlmZmZ ddlmZ ddl m Z e r*ddl m Z m Z G dd � d e�Z dS ) z Base API.� )� annotationsN)�ABC�abstractmethod)�Path)� TYPE_CHECKING)�Iterator�Literalc @ s� e Zd ZdZ dmdndd�Zdodd�Zdpdd�Zeedqdd���Z eedqd d ���Z eedqd d ���Z eedqd d!���Z eedqd"d#���Z eedqd$d%���Zeedqd&d'���Zeedqd(d)���Zeedqd*d+���Zeedqd,d-���Zeedqd.d/���Zeedqd0d1���Zeedqd2d3���Zeedqd4d5���Zeedqd6d7���Zeedqd8d9���Zedrd;d<��Zedrd=d>��Zedrd?d@��ZedrdAdB��Z edrdCdD��Z edrdEdF��Z edrdGdH��Z edrdIdJ��Z edrdKdL��Z!edrdMdN��Z"edrdOdP��Z#edrdQdR��Z$edrdSdT��Z%edrdUdV��Z&edrdWdX��Z'edrdYdZ��Z(dsd\d]�Z)dsd^d_�Z*dsd`da�Z+dsdbdc�Z,dtdedf�Z-dtdgdh�Z.dtdidj�Z/dtdkdl�Z0dS )u�PlatformDirsABCz-Abstract base class for platform directories.NFT�appname� str | None� appauthor�str | None | Literal[False]�version�roaming�bool� multipath�opinion� ensure_exists�return�Nonec C s6 || _ || _ || _ || _ || _ || _|| _dS )aY Create a new platform directory. :param appname: See `appname`. :param appauthor: See `appauthor`. :param version: See `version`. :param roaming: See `roaming`. :param multipath: See `multipath`. :param opinion: See `opinion`. :param ensure_exists: See `ensure_exists`. N)r r r r r r r )�selfr r r r r r r � r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/api.py�__init__ s zPlatformDirsABC.__init__�base�strc G sZ t |dd � �}| jr|�| j� | jr|�| j� tjj|d g|�R � }| �|� |S )N� r )�listr �appendr �os�path�join� _optionally_create_directory)r r �paramsr r r r � _append_app_name_and_versionP s z,PlatformDirsABC._append_app_name_and_versionr c C s | j rt|�jddd� d S d S )NT)�parents�exist_ok)r r �mkdir�r r r r r r" Z s �z,PlatformDirsABC._optionally_create_directoryc C � dS )z(:return: data directory tied to the userNr �r r r r � user_data_dir^ � z PlatformDirsABC.user_data_dirc C r) )z':return: data directory shared by usersNr r* r r r � site_data_dirc r, z PlatformDirsABC.site_data_dirc C r) )z*:return: config directory tied to the userNr r* r r r �user_config_dirh r, z PlatformDirsABC.user_config_dirc C r) )z-:return: config directory shared by the usersNr r* r r r �site_config_dirm r, z PlatformDirsABC.site_config_dirc C r) )z):return: cache directory tied to the userNr r* r r r �user_cache_dirr r, z PlatformDirsABC.user_cache_dirc C r) )z(:return: cache directory shared by usersNr r* r r r �site_cache_dirw r, z PlatformDirsABC.site_cache_dirc C r) )z):return: state directory tied to the userNr r* r r r �user_state_dir| r, z PlatformDirsABC.user_state_dirc C r) )z':return: log directory tied to the userNr r* r r r � user_log_dir� r, z PlatformDirsABC.user_log_dirc C r) )z-:return: documents directory tied to the userNr r* r r r �user_documents_dir� r, z"PlatformDirsABC.user_documents_dirc C r) )z-:return: downloads directory tied to the userNr r* r r r �user_downloads_dir� r, z"PlatformDirsABC.user_downloads_dirc C r) )z,:return: pictures directory tied to the userNr r* r r r �user_pictures_dir� r, z!PlatformDirsABC.user_pictures_dirc C r) )z*:return: videos directory tied to the userNr r* r r r �user_videos_dir� r, z PlatformDirsABC.user_videos_dirc C r) )z):return: music directory tied to the userNr r* r r r �user_music_dir� r, z PlatformDirsABC.user_music_dirc C r) )z+:return: desktop directory tied to the userNr r* r r r �user_desktop_dir� r, z PlatformDirsABC.user_desktop_dirc C r) )z+:return: runtime directory tied to the userNr r* r r r �user_runtime_dir� r, z PlatformDirsABC.user_runtime_dirc C r) )z*:return: runtime directory shared by usersNr r* r r r �site_runtime_dir� r, z PlatformDirsABC.site_runtime_dirr c C � t | j�S )z#:return: data path tied to the user)r r+ r* r r r �user_data_path� � z PlatformDirsABC.user_data_pathc C r< )z":return: data path shared by users)r r- r* r r r �site_data_path� r> z PlatformDirsABC.site_data_pathc C r< )z%:return: config path tied to the user)r r. r* r r r �user_config_path� r> z PlatformDirsABC.user_config_pathc C r< )z(:return: config path shared by the users)r r/ r* r r r �site_config_path� r> z PlatformDirsABC.site_config_pathc C r< )z$:return: cache path tied to the user)r r0 r* r r r �user_cache_path� r> z PlatformDirsABC.user_cache_pathc C r< )z#:return: cache path shared by users)r r1 r* r r r �site_cache_path� r> z PlatformDirsABC.site_cache_pathc C r< )z$:return: state path tied to the user)r r2 r* r r r �user_state_path� r> z PlatformDirsABC.user_state_pathc C r< )z":return: log path tied to the user)r r3 r* r r r � user_log_path� r> z PlatformDirsABC.user_log_pathc C r< )z*:return: documents a path tied to the user)r r4 r* r r r �user_documents_path� r> z#PlatformDirsABC.user_documents_pathc C r< )z(:return: downloads path tied to the user)r r5 r* r r r �user_downloads_path� r> z#PlatformDirsABC.user_downloads_pathc C r< )z':return: pictures path tied to the user)r r6 r* r r r �user_pictures_path� r> z"PlatformDirsABC.user_pictures_pathc C r< )z%:return: videos path tied to the user)r r7 r* r r r �user_videos_path� r> z PlatformDirsABC.user_videos_pathc C r< )z$:return: music path tied to the user)r r8 r* r r r �user_music_path� r> z PlatformDirsABC.user_music_pathc C r< )z&:return: desktop path tied to the user)r r9 r* r r r �user_desktop_path� r> z!PlatformDirsABC.user_desktop_pathc C r< )z&:return: runtime path tied to the user)r r: r* r r r �user_runtime_path� r> z!PlatformDirsABC.user_runtime_pathc C r< )z%:return: runtime path shared by users)r r; r* r r r �site_runtime_path� r> z!PlatformDirsABC.site_runtime_path� Iterator[str]c c � � | j V | jV dS )z4:yield: all user and site configuration directories.N)r. r/ r* r r r �iter_config_dirs� � � z PlatformDirsABC.iter_config_dirsc c rO )z+:yield: all user and site data directories.N)r+ r- r* r r r �iter_data_dirs rQ z PlatformDirsABC.iter_data_dirsc c rO )z,:yield: all user and site cache directories.N)r0 r1 r* r r r �iter_cache_dirs rQ z PlatformDirsABC.iter_cache_dirsc c rO )z.:yield: all user and site runtime directories.N)r: r; r* r r r �iter_runtime_dirs rQ z!PlatformDirsABC.iter_runtime_dirs�Iterator[Path]c c � � | � � D ]}t|�V qdS )z.:yield: all user and site configuration paths.N)rP r r( r r r �iter_config_paths � � �z!PlatformDirsABC.iter_config_pathsc c rV )z%:yield: all user and site data paths.N)rR r r( r r r �iter_data_paths rX z PlatformDirsABC.iter_data_pathsc c rV )z&:yield: all user and site cache paths.N)rS r r( r r r �iter_cache_paths rX z PlatformDirsABC.iter_cache_pathsc c rV )z(:yield: all user and site runtime paths.N)rT r r( r r r �iter_runtime_paths! rX z"PlatformDirsABC.iter_runtime_paths)NNNFFTF)r r r r r r r r r r r r r r r r )r r r r )r r r r )r r )r r )r rN )r rU )1�__name__� __module__� __qualname__�__doc__r r$ r" �propertyr r+ r- r. r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r= r? r@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rP rR rS rT rW rY rZ r[ r r r r r s� � ? r )r_ � __future__r r �abcr r �pathlibr �typingr r r r r r r r �<module> s _vendor/platformdirs/__pycache__/unix.cpython-310.pyc 0000644 00000024764 15030122015 0016604 0 ustar 00 o �h�) � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z m Z ddl m Z ejd kr5dd d �ZnddlmZ G dd� de �Zddd�Zd dd�ZdgZdS ) zUnix.� )� annotationsN)� ConfigParser)�Path)�Iterator�NoReturn� )�PlatformDirsABC�win32�returnr c C s d} t | ��)Nzshould only be used on Unix)� RuntimeError)�msg� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/unix.py�getuid s r )r c @ sT e Zd ZdZed9dd��Zed:dd��Zed9d d ��Zed9d d ��Zed:d d��Z ed9dd��Z ed9dd��Z ed9dd��Z ed9dd��Z ed9dd��Zed9dd��Zed9dd ��Zed9d d ��Zed9d d ��Zed9d!d"��Zed9d#d$��Zed9d%d&��Zed9d'd(��Zed;d*d+��Zed;d,d-��Zed;d.d/��Zd<d1d2�Zd=d4d5�Zd=d6d7�Z d8S )>�Unixa� On Unix/Linux, we follow the `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec- latest.html>`_. The spec allows overriding directories with environment variables. The examples shown are the default values, alongside the name of the environment variable that overrides them. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `multipath <platformdirs.api.PlatformDirsABC.multipath>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. r �strc C �, t j�dd�}|�� st j�d�}| �|�S )z� :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` � XDG_DATA_HOME� z~/.local/share��os�environ�get�strip�path� expanduser� _append_app_name_and_version��selfr r r r � user_data_dir$ � zUnix.user_data_dir� list[str]c s> t j�dd�}|�� sdt j� d�}� fdd�|�t j�D �S )N� XDG_DATA_DIRSr z/usr/local/sharez /usr/sharec � g | ]}� � |��qS r �r ��.0�p�r r r � <listcomp>4 � z(Unix._site_data_dirs.<locals>.<listcomp>)r r r r �pathsep�splitr r r( r �_site_data_dirs/ s zUnix._site_data_dirsc C � | j }| js |d S tj�|�S )aZ :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` r )r- � multipathr r+ �join�r �dirsr r r � site_data_dir6 � zUnix.site_data_dirc C r )z� :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` �XDG_CONFIG_HOMEr z ~/.configr r r r r �user_config_dirC r zUnix.user_config_dirc s4 t j�dd�}|�� s d}� fdd�|�t j�D �S )N�XDG_CONFIG_DIRSr z/etc/xdgc r# r r$ r% r( r r r) S r* z*Unix._site_config_dirs.<locals>.<listcomp>)r r r r r, r+ r r r( r �_site_config_dirsN s zUnix._site_config_dirsc C r. )a2 :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/etc/xdg/$appname/$version`` r )r8 r/ r r+ r0 r1 r r r �site_config_dirU r4 zUnix.site_config_dirc C r )z� :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` �XDG_CACHE_HOMEr z~/.cacher r r r r �user_cache_dirb r zUnix.user_cache_dirc C s | � d�S )zO:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``z /var/cacher$ r( r r r �site_cache_dirm � zUnix.site_cache_dirc C r )z� :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` �XDG_STATE_HOMEr z~/.local/stater r r r r �user_state_dirr r zUnix.user_state_dirc C s( | j }| jrtj�|d�}| �|� |S )zg:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it�log)r? �opinionr r r0 � _optionally_create_directoryr r r r � user_log_dir} s zUnix.user_log_dirc C � t dd�S )zC:return: documents directory tied to the user, e.g. ``~/Documents``�XDG_DOCUMENTS_DIRz ~/Documents��_get_user_media_dirr( r r r �user_documents_dir� r= zUnix.user_documents_dirc C rD )zC:return: downloads directory tied to the user, e.g. ``~/Downloads``�XDG_DOWNLOAD_DIRz ~/DownloadsrF r( r r r �user_downloads_dir� r= zUnix.user_downloads_dirc C rD )zA:return: pictures directory tied to the user, e.g. ``~/Pictures``�XDG_PICTURES_DIRz ~/PicturesrF r( r r r �user_pictures_dir� r= zUnix.user_pictures_dirc C rD )z=:return: videos directory tied to the user, e.g. ``~/Videos``�XDG_VIDEOS_DIRz~/VideosrF r( r r r �user_videos_dir� r= zUnix.user_videos_dirc C rD )z;:return: music directory tied to the user, e.g. ``~/Music``� XDG_MUSIC_DIRz~/MusicrF r( r r r �user_music_dir� r= zUnix.user_music_dirc C rD )z?:return: desktop directory tied to the user, e.g. ``~/Desktop``�XDG_DESKTOP_DIRz ~/DesktoprF r( r r r �user_desktop_dir� r= zUnix.user_desktop_dirc C s^ t j�dd�}|�� s*tj�d�r$dt� � �}t|�� � s#dt� � �}ndt� � �}| � |�S )az :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``. For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR`` is not set. �XDG_RUNTIME_DIRr ��freebsd�openbsd�netbsdz/var/run/user/z /tmp/runtime-z /run/user/) r r r r �sys�platform� startswithr r �existsr r r r r �user_runtime_dir� s � zUnix.user_runtime_dirc C s6 t j�dd�}|�� stj�d�rd}nd}| �|�S )am :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``. Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will fall back to paths associated to the root user instead of a regular logged-in user if it's not set. If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir` instead. For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set. rS r rT z/var/runz/run)r r r r rX rY rZ r r r r r �site_runtime_dir� s zUnix.site_runtime_dirr c C � | � | j�S )zh:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)� _first_item_as_path_if_multipathr3 r( r r r �site_data_path� � zUnix.site_data_pathc C r^ )zj:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``)r_ r9 r( r r r �site_config_path� ra zUnix.site_config_pathc C r^ )zi:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``)r_ r< r( r r r �site_cache_path� ra zUnix.site_cache_path� directoryc C s | j r |�tj�d }t|�S )Nr )r/ r, r r+ r )r rd r r r r_ � s z%Unix._first_item_as_path_if_multipath� Iterator[str]c c � � | j V | jE dH dS )z4:yield: all user and site configuration directories.N)r6 r8 r( r r r �iter_config_dirs� � �zUnix.iter_config_dirsc c rf )z+:yield: all user and site data directories.N)r r- r( r r r �iter_data_dirs� rh zUnix.iter_data_dirsN)r r )r r! )r r )rd r r r )r re ) �__name__� __module__� __qualname__�__doc__�propertyr r- r3 r6 r8 r9 r; r< r? rC rH rJ rL rN rP rR r\ r] r` rb rc r_ rg ri r r r r r s^ r �env_varr �fallback_tilde_pathc C s6 t | �}|d u rtj�| d��� }|stj�|�}|S )Nr )�_get_user_dirs_folderr r r r r r )ro rp � media_dirr r r rG � s rG �key� str | Nonec C s� t t� j�d }|�� rHt� }|�� �}|�d|�� � �� W d � n1 s(w Y | |d vr5dS |d | �d�}|� dt j � d��S dS )z{ Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. zuser-dirs.dirsz[top] N�top�"z$HOME�~) r r r6 r[ r �open� read_string�readr �replacer r r )rs �user_dirs_config_path�parser�streamr r r r rq � s � rq )r r )ro r rp r r r )rs r r rt )rm � __future__r r rX � configparserr �pathlibr �typingr r �apir rY r r rG rq �__all__r r r r �<module> s" X � _vendor/platformdirs/__pycache__/android.cpython-310.pyc 0000644 00000016347 15030122015 0017237 0 ustar 00 o �h8# � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z m Z ddl m Z G dd � d e �Z edd �dd d��Zedd �ddd��Zedd �ddd��Zedd �ddd��Zedd �ddd��Zedd �ddd��Zd gZdS ) zAndroid.� )� annotationsN)� lru_cache)� TYPE_CHECKING�cast� )�PlatformDirsABCc @ s� e Zd ZdZed%dd��Zed%dd��Zed%dd ��Zed%d d ��Zed%d d ��Z ed%dd��Z ed%dd��Z ed%dd��Z ed%dd��Z ed%dd��Zed%dd��Zed%dd��Zed%d d ��Zed%d d ��Zed%d d!��Zed%d"d#��Zd$S )&�Androida" Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. �return�strc C � | � ttt� �d�S )zd:return: data directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/files/<AppName>``�files�� _append_app_name_and_versionr r �_android_folder��self� r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/platformdirs/android.py� user_data_dir � zAndroid.user_data_dirc C � | j S )z@:return: data directory shared by users, same as `user_data_dir`�r r r r r � site_data_dir � zAndroid.site_data_dirc C r )z� :return: config directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/shared_prefs/<AppName>`` � shared_prefsr r r r r �user_config_dir! s zAndroid.user_config_dirc C r )zH:return: config directory shared by the users, same as `user_config_dir`)r r r r r �site_config_dir) r zAndroid.site_config_dirc C r )ze:return: cache directory tied to the user, e.g.,``/data/user/<userid>/<packagename>/cache/<AppName>``�cacher r r r r �user_cache_dir. r zAndroid.user_cache_dirc C r )zB:return: cache directory shared by users, same as `user_cache_dir`)r r r r r �site_cache_dir3 r zAndroid.site_cache_dirc C r )zB:return: state directory tied to the user, same as `user_data_dir`r r r r r �user_state_dir8 r zAndroid.user_state_dirc C � | j }| jr tj�|d�}|S )z� :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/log`` �log�r �opinion�os�path�join�r r& r r r � user_log_dir= � zAndroid.user_log_dirc C � t � S )zT:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``)�_android_documents_folderr r r r �user_documents_dirH r zAndroid.user_documents_dirc C r+ )zT:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``)�_android_downloads_folderr r r r �user_downloads_dirM r zAndroid.user_downloads_dirc C r+ )zR:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``)�_android_pictures_folderr r r r �user_pictures_dirR r zAndroid.user_pictures_dirc C r+ )zS:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``)�_android_videos_folderr r r r �user_videos_dirW r zAndroid.user_videos_dirc C r+ )zL:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``)�_android_music_folderr r r r �user_music_dir\ r zAndroid.user_music_dirc C s dS )zP:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``z/storage/emulated/0/Desktopr r r r r �user_desktop_dira s zAndroid.user_desktop_dirc C r! )z� :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/tmp`` �tmpr# r( r r r �user_runtime_dirf r* zAndroid.user_runtime_dirc C r )zF:return: runtime directory shared by users, same as `user_runtime_dir`)r8 r r r r �site_runtime_dirq r zAndroid.site_runtime_dirN�r r )�__name__� __module__� __qualname__�__doc__�propertyr r r r r r r r) r- r/ r1 r3 r5 r6 r8 r9 r r r r r sD r )�maxsizer � str | Nonec C s d} t s'zddlm} td|�� �}|�� �� �� } W n ty& d} Y nw | du rKzddl m } |d�}|�� �� �� } W n tyJ d} Y nw | du rjt � d�}t jD ]}|�|�rg|�d�d } nqWd} | du r�t � d�}t jD ]}|�|�r�|�d�d } | S qvd} | S ) zE:return: base folder for the Android OS or None if it cannot be foundNr )� mActivity�android.content.Context�� autoclassz /data/(data|user/\d+)/(.+)/filesz/filesz7/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files)r �androidrB r �getApplicationContext� getFilesDir� getParentFile�getAbsolutePath� Exception�jniusrE �re�compile�sysr& �match�split)�resultrB �contextrE �patternr& r r r r w sF � � � �r r c C �L zddl m} | d�}| d�}|�|j��� }W |S ty% d}Y |S w )z,:return: documents folder for the Android OSr rD rC �android.os.Environmentz /storage/emulated/0/Documents)rL rE �getExternalFilesDir�DIRECTORY_DOCUMENTSrJ rK )rE rS � environment� documents_dirr r r r, � � ��r, c C rU )z,:return: downloads folder for the Android OSr rD rC rV z /storage/emulated/0/Downloads)rL rE rW �DIRECTORY_DOWNLOADSrJ rK )rE rS rY � downloads_dirr r r r. � r[ r. c C rU )z+:return: pictures folder for the Android OSr rD rC rV z /storage/emulated/0/Pictures)rL rE rW �DIRECTORY_PICTURESrJ rK )rE rS rY � pictures_dirr r r r0 � r[ r0 c C rU )z):return: videos folder for the Android OSr rD rC rV z /storage/emulated/0/DCIM/Camera)rL rE rW �DIRECTORY_DCIMrJ rK )rE rS rY � videos_dirr r r r2 � r[ r2 c C rU )z(:return: music folder for the Android OSr rD rC rV z/storage/emulated/0/Music)rL rE rW �DIRECTORY_MUSICrJ rK )rE rS rY � music_dirr r r r4 � r[ r4 )r rA r: )r> � __future__r r% rM rO � functoolsr �typingr r �apir r r r, r. r0 r2 r4 �__all__r r r r �<module> s. i / � _vendor/platformdirs/macos.py 0000644 00000012714 15030122015 0012354 0 ustar 00 """macOS.""" from __future__ import annotations import os.path import sys from .api import PlatformDirsABC class MacOS(PlatformDirsABC): """ Platform directories for the macOS operating system. Follows the guidance from `Apple documentation <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. """ @property def user_data_dir(self) -> str: """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support")) # noqa: PTH111 @property def site_data_dir(self) -> str: """ :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``. If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``. If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version`` """ is_homebrew = sys.prefix.startswith("/opt/homebrew") path_list = [self._append_app_name_and_version("/opt/homebrew/share")] if is_homebrew else [] path_list.append(self._append_app_name_and_version("/Library/Application Support")) if self.multipath: return os.pathsep.join(path_list) return path_list[0] @property def user_config_dir(self) -> str: """:return: config directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def site_config_dir(self) -> str: """:return: config directory shared by the users, same as `site_data_dir`""" return self.site_data_dir @property def user_cache_dir(self) -> str: """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches")) # noqa: PTH111 @property def site_cache_dir(self) -> str: """ :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``. If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version`` """ is_homebrew = sys.prefix.startswith("/opt/homebrew") path_list = [self._append_app_name_and_version("/opt/homebrew/var/cache")] if is_homebrew else [] path_list.append(self._append_app_name_and_version("/Library/Caches")) if self.multipath: return os.pathsep.join(path_list) return path_list[0] @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs")) # noqa: PTH111 @property def user_documents_dir(self) -> str: """:return: documents directory tied to the user, e.g. ``~/Documents``""" return os.path.expanduser("~/Documents") # noqa: PTH111 @property def user_downloads_dir(self) -> str: """:return: downloads directory tied to the user, e.g. ``~/Downloads``""" return os.path.expanduser("~/Downloads") # noqa: PTH111 @property def user_pictures_dir(self) -> str: """:return: pictures directory tied to the user, e.g. ``~/Pictures``""" return os.path.expanduser("~/Pictures") # noqa: PTH111 @property def user_videos_dir(self) -> str: """:return: videos directory tied to the user, e.g. ``~/Movies``""" return os.path.expanduser("~/Movies") # noqa: PTH111 @property def user_music_dir(self) -> str: """:return: music directory tied to the user, e.g. ``~/Music``""" return os.path.expanduser("~/Music") # noqa: PTH111 @property def user_desktop_dir(self) -> str: """:return: desktop directory tied to the user, e.g. ``~/Desktop``""" return os.path.expanduser("~/Desktop") # noqa: PTH111 @property def user_runtime_dir(self) -> str: """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``""" return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems")) # noqa: PTH111 @property def site_runtime_dir(self) -> str: """:return: runtime directory shared by users, same as `user_runtime_dir`""" return self.user_runtime_dir __all__ = [ "MacOS", ] _vendor/platformdirs/py.typed 0000644 00000000000 15030122015 0012360 0 ustar 00 _vendor/platformdirs/version.py 0000644 00000000633 15030122015 0012734 0 ustar 00 # file generated by setuptools_scm # don't change, don't track in version control TYPE_CHECKING = False if TYPE_CHECKING: from typing import Tuple, Union VERSION_TUPLE = Tuple[Union[int, str], ...] else: VERSION_TUPLE = object version: str __version__: str __version_tuple__: VERSION_TUPLE version_tuple: VERSION_TUPLE __version__ = version = '4.2.2' __version_tuple__ = version_tuple = (4, 2, 2) _vendor/platformdirs/__main__.py 0000644 00000002725 15030122015 0012773 0 ustar 00 """Main entry point.""" from __future__ import annotations from platformdirs import PlatformDirs, __version__ PROPS = ( "user_data_dir", "user_config_dir", "user_cache_dir", "user_state_dir", "user_log_dir", "user_documents_dir", "user_downloads_dir", "user_pictures_dir", "user_videos_dir", "user_music_dir", "user_runtime_dir", "site_data_dir", "site_config_dir", "site_cache_dir", "site_runtime_dir", ) def main() -> None: """Run the main entry point.""" app_name = "MyApp" app_author = "MyCompany" print(f"-- platformdirs {__version__} --") # noqa: T201 print("-- app dirs (with optional 'version')") # noqa: T201 dirs = PlatformDirs(app_name, app_author, version="1.0") for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 print("\n-- app dirs (without optional 'version')") # noqa: T201 dirs = PlatformDirs(app_name, app_author) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 print("\n-- app dirs (without optional 'appauthor')") # noqa: T201 dirs = PlatformDirs(app_name) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 print("\n-- app dirs (with disabled 'appauthor')") # noqa: T201 dirs = PlatformDirs(app_name, appauthor=False) for prop in PROPS: print(f"{prop}: {getattr(dirs, prop)}") # noqa: T201 if __name__ == "__main__": main() _vendor/platformdirs/unix.py 0000644 00000024623 15030122015 0012237 0 ustar 00 """Unix.""" from __future__ import annotations import os import sys from configparser import ConfigParser from pathlib import Path from typing import Iterator, NoReturn from .api import PlatformDirsABC if sys.platform == "win32": def getuid() -> NoReturn: msg = "should only be used on Unix" raise RuntimeError(msg) else: from os import getuid class Unix(PlatformDirsABC): # noqa: PLR0904 """ On Unix/Linux, we follow the `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec- latest.html>`_. The spec allows overriding directories with environment variables. The examples shown are the default values, alongside the name of the environment variable that overrides them. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `multipath <platformdirs.api.PlatformDirsABC.multipath>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. """ @property def user_data_dir(self) -> str: """ :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version`` """ path = os.environ.get("XDG_DATA_HOME", "") if not path.strip(): path = os.path.expanduser("~/.local/share") # noqa: PTH111 return self._append_app_name_and_version(path) @property def _site_data_dirs(self) -> list[str]: path = os.environ.get("XDG_DATA_DIRS", "") if not path.strip(): path = f"/usr/local/share{os.pathsep}/usr/share" return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)] @property def site_data_dir(self) -> str: """ :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version`` """ # XDG default for $XDG_DATA_DIRS; only first, if multipath is False dirs = self._site_data_dirs if not self.multipath: return dirs[0] return os.pathsep.join(dirs) @property def user_config_dir(self) -> str: """ :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version`` """ path = os.environ.get("XDG_CONFIG_HOME", "") if not path.strip(): path = os.path.expanduser("~/.config") # noqa: PTH111 return self._append_app_name_and_version(path) @property def _site_config_dirs(self) -> list[str]: path = os.environ.get("XDG_CONFIG_DIRS", "") if not path.strip(): path = "/etc/xdg" return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)] @property def site_config_dir(self) -> str: """ :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by the OS path separator), e.g. ``/etc/xdg/$appname/$version`` """ # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False dirs = self._site_config_dirs if not self.multipath: return dirs[0] return os.pathsep.join(dirs) @property def user_cache_dir(self) -> str: """ :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``~/$XDG_CACHE_HOME/$appname/$version`` """ path = os.environ.get("XDG_CACHE_HOME", "") if not path.strip(): path = os.path.expanduser("~/.cache") # noqa: PTH111 return self._append_app_name_and_version(path) @property def site_cache_dir(self) -> str: """:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``""" return self._append_app_name_and_version("/var/cache") @property def user_state_dir(self) -> str: """ :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version`` """ path = os.environ.get("XDG_STATE_HOME", "") if not path.strip(): path = os.path.expanduser("~/.local/state") # noqa: PTH111 return self._append_app_name_and_version(path) @property def user_log_dir(self) -> str: """:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it""" path = self.user_state_dir if self.opinion: path = os.path.join(path, "log") # noqa: PTH118 self._optionally_create_directory(path) return path @property def user_documents_dir(self) -> str: """:return: documents directory tied to the user, e.g. ``~/Documents``""" return _get_user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents") @property def user_downloads_dir(self) -> str: """:return: downloads directory tied to the user, e.g. ``~/Downloads``""" return _get_user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads") @property def user_pictures_dir(self) -> str: """:return: pictures directory tied to the user, e.g. ``~/Pictures``""" return _get_user_media_dir("XDG_PICTURES_DIR", "~/Pictures") @property def user_videos_dir(self) -> str: """:return: videos directory tied to the user, e.g. ``~/Videos``""" return _get_user_media_dir("XDG_VIDEOS_DIR", "~/Videos") @property def user_music_dir(self) -> str: """:return: music directory tied to the user, e.g. ``~/Music``""" return _get_user_media_dir("XDG_MUSIC_DIR", "~/Music") @property def user_desktop_dir(self) -> str: """:return: desktop directory tied to the user, e.g. ``~/Desktop``""" return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop") @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``. For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR`` is not set. """ path = os.environ.get("XDG_RUNTIME_DIR", "") if not path.strip(): if sys.platform.startswith(("freebsd", "openbsd", "netbsd")): path = f"/var/run/user/{getuid()}" if not Path(path).exists(): path = f"/tmp/runtime-{getuid()}" # noqa: S108 else: path = f"/run/user/{getuid()}" return self._append_app_name_and_version(path) @property def site_runtime_dir(self) -> str: """ :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or \ ``$XDG_RUNTIME_DIR/$appname/$version``. Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will fall back to paths associated to the root user instead of a regular logged-in user if it's not set. If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir` instead. For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set. """ path = os.environ.get("XDG_RUNTIME_DIR", "") if not path.strip(): if sys.platform.startswith(("freebsd", "openbsd", "netbsd")): path = "/var/run" else: path = "/run" return self._append_app_name_and_version(path) @property def site_data_path(self) -> Path: """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``""" return self._first_item_as_path_if_multipath(self.site_data_dir) @property def site_config_path(self) -> Path: """:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``""" return self._first_item_as_path_if_multipath(self.site_config_dir) @property def site_cache_path(self) -> Path: """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``""" return self._first_item_as_path_if_multipath(self.site_cache_dir) def _first_item_as_path_if_multipath(self, directory: str) -> Path: if self.multipath: # If multipath is True, the first path is returned. directory = directory.split(os.pathsep)[0] return Path(directory) def iter_config_dirs(self) -> Iterator[str]: """:yield: all user and site configuration directories.""" yield self.user_config_dir yield from self._site_config_dirs def iter_data_dirs(self) -> Iterator[str]: """:yield: all user and site data directories.""" yield self.user_data_dir yield from self._site_data_dirs def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str: media_dir = _get_user_dirs_folder(env_var) if media_dir is None: media_dir = os.environ.get(env_var, "").strip() if not media_dir: media_dir = os.path.expanduser(fallback_tilde_path) # noqa: PTH111 return media_dir def _get_user_dirs_folder(key: str) -> str | None: """ Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/. """ user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs" if user_dirs_config_path.exists(): parser = ConfigParser() with user_dirs_config_path.open() as stream: # Add fake section header, so ConfigParser doesn't complain parser.read_string(f"[top]\n{stream.read()}") if key not in parser["top"]: return None path = parser["top"][key].strip('"') # Handle relative home paths return path.replace("$HOME", os.path.expanduser("~")) # noqa: PTH111 return None __all__ = [ "Unix", ] _vendor/platformdirs/api.py 0000644 00000021444 15030122015 0012023 0 ustar 00 """Base API.""" from __future__ import annotations import os from abc import ABC, abstractmethod from pathlib import Path from typing import TYPE_CHECKING if TYPE_CHECKING: from typing import Iterator, Literal class PlatformDirsABC(ABC): # noqa: PLR0904 """Abstract base class for platform directories.""" def __init__( # noqa: PLR0913, PLR0917 self, appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 multipath: bool = False, # noqa: FBT001, FBT002 opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> None: """ Create a new platform directory. :param appname: See `appname`. :param appauthor: See `appauthor`. :param version: See `version`. :param roaming: See `roaming`. :param multipath: See `multipath`. :param opinion: See `opinion`. :param ensure_exists: See `ensure_exists`. """ self.appname = appname #: The name of application. self.appauthor = appauthor """ The name of the app author or distributing body for this application. Typically, it is the owning company name. Defaults to `appname`. You may pass ``False`` to disable it. """ self.version = version """ An optional version path element to append to the path. You might want to use this if you want multiple versions of your app to be able to run independently. If used, this would typically be ``<major>.<minor>``. """ self.roaming = roaming """ Whether to use the roaming appdata directory on Windows. That means that for users on a Windows network setup for roaming profiles, this user data will be synced on login (see `here <https://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>`_). """ self.multipath = multipath """ An optional parameter which indicates that the entire list of data dirs should be returned. By default, the first item would only be returned. """ self.opinion = opinion #: A flag to indicating to use opinionated values. self.ensure_exists = ensure_exists """ Optionally create the directory (and any missing parents) upon access if it does not exist. By default, no directories are created. """ def _append_app_name_and_version(self, *base: str) -> str: params = list(base[1:]) if self.appname: params.append(self.appname) if self.version: params.append(self.version) path = os.path.join(base[0], *params) # noqa: PTH118 self._optionally_create_directory(path) return path def _optionally_create_directory(self, path: str) -> None: if self.ensure_exists: Path(path).mkdir(parents=True, exist_ok=True) @property @abstractmethod def user_data_dir(self) -> str: """:return: data directory tied to the user""" @property @abstractmethod def site_data_dir(self) -> str: """:return: data directory shared by users""" @property @abstractmethod def user_config_dir(self) -> str: """:return: config directory tied to the user""" @property @abstractmethod def site_config_dir(self) -> str: """:return: config directory shared by the users""" @property @abstractmethod def user_cache_dir(self) -> str: """:return: cache directory tied to the user""" @property @abstractmethod def site_cache_dir(self) -> str: """:return: cache directory shared by users""" @property @abstractmethod def user_state_dir(self) -> str: """:return: state directory tied to the user""" @property @abstractmethod def user_log_dir(self) -> str: """:return: log directory tied to the user""" @property @abstractmethod def user_documents_dir(self) -> str: """:return: documents directory tied to the user""" @property @abstractmethod def user_downloads_dir(self) -> str: """:return: downloads directory tied to the user""" @property @abstractmethod def user_pictures_dir(self) -> str: """:return: pictures directory tied to the user""" @property @abstractmethod def user_videos_dir(self) -> str: """:return: videos directory tied to the user""" @property @abstractmethod def user_music_dir(self) -> str: """:return: music directory tied to the user""" @property @abstractmethod def user_desktop_dir(self) -> str: """:return: desktop directory tied to the user""" @property @abstractmethod def user_runtime_dir(self) -> str: """:return: runtime directory tied to the user""" @property @abstractmethod def site_runtime_dir(self) -> str: """:return: runtime directory shared by users""" @property def user_data_path(self) -> Path: """:return: data path tied to the user""" return Path(self.user_data_dir) @property def site_data_path(self) -> Path: """:return: data path shared by users""" return Path(self.site_data_dir) @property def user_config_path(self) -> Path: """:return: config path tied to the user""" return Path(self.user_config_dir) @property def site_config_path(self) -> Path: """:return: config path shared by the users""" return Path(self.site_config_dir) @property def user_cache_path(self) -> Path: """:return: cache path tied to the user""" return Path(self.user_cache_dir) @property def site_cache_path(self) -> Path: """:return: cache path shared by users""" return Path(self.site_cache_dir) @property def user_state_path(self) -> Path: """:return: state path tied to the user""" return Path(self.user_state_dir) @property def user_log_path(self) -> Path: """:return: log path tied to the user""" return Path(self.user_log_dir) @property def user_documents_path(self) -> Path: """:return: documents a path tied to the user""" return Path(self.user_documents_dir) @property def user_downloads_path(self) -> Path: """:return: downloads path tied to the user""" return Path(self.user_downloads_dir) @property def user_pictures_path(self) -> Path: """:return: pictures path tied to the user""" return Path(self.user_pictures_dir) @property def user_videos_path(self) -> Path: """:return: videos path tied to the user""" return Path(self.user_videos_dir) @property def user_music_path(self) -> Path: """:return: music path tied to the user""" return Path(self.user_music_dir) @property def user_desktop_path(self) -> Path: """:return: desktop path tied to the user""" return Path(self.user_desktop_dir) @property def user_runtime_path(self) -> Path: """:return: runtime path tied to the user""" return Path(self.user_runtime_dir) @property def site_runtime_path(self) -> Path: """:return: runtime path shared by users""" return Path(self.site_runtime_dir) def iter_config_dirs(self) -> Iterator[str]: """:yield: all user and site configuration directories.""" yield self.user_config_dir yield self.site_config_dir def iter_data_dirs(self) -> Iterator[str]: """:yield: all user and site data directories.""" yield self.user_data_dir yield self.site_data_dir def iter_cache_dirs(self) -> Iterator[str]: """:yield: all user and site cache directories.""" yield self.user_cache_dir yield self.site_cache_dir def iter_runtime_dirs(self) -> Iterator[str]: """:yield: all user and site runtime directories.""" yield self.user_runtime_dir yield self.site_runtime_dir def iter_config_paths(self) -> Iterator[Path]: """:yield: all user and site configuration paths.""" for path in self.iter_config_dirs(): yield Path(path) def iter_data_paths(self) -> Iterator[Path]: """:yield: all user and site data paths.""" for path in self.iter_data_dirs(): yield Path(path) def iter_cache_paths(self) -> Iterator[Path]: """:yield: all user and site cache paths.""" for path in self.iter_cache_dirs(): yield Path(path) def iter_runtime_paths(self) -> Iterator[Path]: """:yield: all user and site runtime paths.""" for path in self.iter_runtime_dirs(): yield Path(path) _vendor/platformdirs/windows.py 0000644 00000023615 15030122015 0012746 0 ustar 00 """Windows.""" from __future__ import annotations import os import sys from functools import lru_cache from typing import TYPE_CHECKING from .api import PlatformDirsABC if TYPE_CHECKING: from collections.abc import Callable class Windows(PlatformDirsABC): """ `MSDN on where to store app data files <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`, `version <platformdirs.api.PlatformDirsABC.version>`, `roaming <platformdirs.api.PlatformDirsABC.roaming>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. """ @property def user_data_dir(self) -> str: """ :return: data directory tied to the user, e.g. ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming) """ const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA" path = os.path.normpath(get_win_folder(const)) return self._append_parts(path) def _append_parts(self, path: str, *, opinion_value: str | None = None) -> str: params = [] if self.appname: if self.appauthor is not False: author = self.appauthor or self.appname params.append(author) params.append(self.appname) if opinion_value is not None and self.opinion: params.append(opinion_value) if self.version: params.append(self.version) path = os.path.join(path, *params) # noqa: PTH118 self._optionally_create_directory(path) return path @property def site_data_dir(self) -> str: """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``""" path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA")) return self._append_parts(path) @property def user_config_dir(self) -> str: """:return: config directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def site_config_dir(self) -> str: """:return: config directory shared by the users, same as `site_data_dir`""" return self.site_data_dir @property def user_cache_dir(self) -> str: """ :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version`` """ path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA")) return self._append_parts(path, opinion_value="Cache") @property def site_cache_dir(self) -> str: """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``""" path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA")) return self._append_parts(path, opinion_value="Cache") @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it""" path = self.user_data_dir if self.opinion: path = os.path.join(path, "Logs") # noqa: PTH118 self._optionally_create_directory(path) return path @property def user_documents_dir(self) -> str: """:return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents``""" return os.path.normpath(get_win_folder("CSIDL_PERSONAL")) @property def user_downloads_dir(self) -> str: """:return: downloads directory tied to the user e.g. ``%USERPROFILE%\\Downloads``""" return os.path.normpath(get_win_folder("CSIDL_DOWNLOADS")) @property def user_pictures_dir(self) -> str: """:return: pictures directory tied to the user e.g. ``%USERPROFILE%\\Pictures``""" return os.path.normpath(get_win_folder("CSIDL_MYPICTURES")) @property def user_videos_dir(self) -> str: """:return: videos directory tied to the user e.g. ``%USERPROFILE%\\Videos``""" return os.path.normpath(get_win_folder("CSIDL_MYVIDEO")) @property def user_music_dir(self) -> str: """:return: music directory tied to the user e.g. ``%USERPROFILE%\\Music``""" return os.path.normpath(get_win_folder("CSIDL_MYMUSIC")) @property def user_desktop_dir(self) -> str: """:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\\Desktop``""" return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY")) @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, e.g. ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname`` """ path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp")) # noqa: PTH118 return self._append_parts(path) @property def site_runtime_dir(self) -> str: """:return: runtime directory shared by users, same as `user_runtime_dir`""" return self.user_runtime_dir def get_win_folder_from_env_vars(csidl_name: str) -> str: """Get folder from environment variables.""" result = get_win_folder_if_csidl_name_not_env_var(csidl_name) if result is not None: return result env_var_name = { "CSIDL_APPDATA": "APPDATA", "CSIDL_COMMON_APPDATA": "ALLUSERSPROFILE", "CSIDL_LOCAL_APPDATA": "LOCALAPPDATA", }.get(csidl_name) if env_var_name is None: msg = f"Unknown CSIDL name: {csidl_name}" raise ValueError(msg) result = os.environ.get(env_var_name) if result is None: msg = f"Unset environment variable: {env_var_name}" raise ValueError(msg) return result def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None: """Get a folder for a CSIDL name that does not exist as an environment variable.""" if csidl_name == "CSIDL_PERSONAL": return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents") # noqa: PTH118 if csidl_name == "CSIDL_DOWNLOADS": return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Downloads") # noqa: PTH118 if csidl_name == "CSIDL_MYPICTURES": return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Pictures") # noqa: PTH118 if csidl_name == "CSIDL_MYVIDEO": return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Videos") # noqa: PTH118 if csidl_name == "CSIDL_MYMUSIC": return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Music") # noqa: PTH118 return None def get_win_folder_from_registry(csidl_name: str) -> str: """ Get folder from the registry. This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer for all CSIDL_* names. """ shell_folder_name = { "CSIDL_APPDATA": "AppData", "CSIDL_COMMON_APPDATA": "Common AppData", "CSIDL_LOCAL_APPDATA": "Local AppData", "CSIDL_PERSONAL": "Personal", "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}", "CSIDL_MYPICTURES": "My Pictures", "CSIDL_MYVIDEO": "My Video", "CSIDL_MYMUSIC": "My Music", }.get(csidl_name) if shell_folder_name is None: msg = f"Unknown CSIDL name: {csidl_name}" raise ValueError(msg) if sys.platform != "win32": # only needed for mypy type checker to know that this code runs only on Windows raise NotImplementedError import winreg # noqa: PLC0415 key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders") directory, _ = winreg.QueryValueEx(key, shell_folder_name) return str(directory) def get_win_folder_via_ctypes(csidl_name: str) -> str: """Get folder with ctypes.""" # There is no 'CSIDL_DOWNLOADS'. # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead. # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid import ctypes # noqa: PLC0415 csidl_const = { "CSIDL_APPDATA": 26, "CSIDL_COMMON_APPDATA": 35, "CSIDL_LOCAL_APPDATA": 28, "CSIDL_PERSONAL": 5, "CSIDL_MYPICTURES": 39, "CSIDL_MYVIDEO": 14, "CSIDL_MYMUSIC": 13, "CSIDL_DOWNLOADS": 40, "CSIDL_DESKTOPDIRECTORY": 16, }.get(csidl_name) if csidl_const is None: msg = f"Unknown CSIDL name: {csidl_name}" raise ValueError(msg) buf = ctypes.create_unicode_buffer(1024) windll = getattr(ctypes, "windll") # noqa: B009 # using getattr to avoid false positive with mypy type checker windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf) # Downgrade to short path name if it has high-bit chars. if any(ord(c) > 255 for c in buf): # noqa: PLR2004 buf2 = ctypes.create_unicode_buffer(1024) if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024): buf = buf2 if csidl_name == "CSIDL_DOWNLOADS": return os.path.join(buf.value, "Downloads") # noqa: PTH118 return buf.value def _pick_get_win_folder() -> Callable[[str], str]: try: import ctypes # noqa: PLC0415 except ImportError: pass else: if hasattr(ctypes, "windll"): return get_win_folder_via_ctypes try: import winreg # noqa: PLC0415, F401 except ImportError: return get_win_folder_from_env_vars else: return get_win_folder_from_registry get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder()) __all__ = [ "Windows", ] _vendor/platformdirs/android.py 0000644 00000021470 15030122015 0012671 0 ustar 00 """Android.""" from __future__ import annotations import os import re import sys from functools import lru_cache from typing import TYPE_CHECKING, cast from .api import PlatformDirsABC class Android(PlatformDirsABC): """ Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. """ @property def user_data_dir(self) -> str: """:return: data directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/files/<AppName>``""" return self._append_app_name_and_version(cast(str, _android_folder()), "files") @property def site_data_dir(self) -> str: """:return: data directory shared by users, same as `user_data_dir`""" return self.user_data_dir @property def user_config_dir(self) -> str: """ :return: config directory tied to the user, e.g. \ ``/data/user/<userid>/<packagename>/shared_prefs/<AppName>`` """ return self._append_app_name_and_version(cast(str, _android_folder()), "shared_prefs") @property def site_config_dir(self) -> str: """:return: config directory shared by the users, same as `user_config_dir`""" return self.user_config_dir @property def user_cache_dir(self) -> str: """:return: cache directory tied to the user, e.g.,``/data/user/<userid>/<packagename>/cache/<AppName>``""" return self._append_app_name_and_version(cast(str, _android_folder()), "cache") @property def site_cache_dir(self) -> str: """:return: cache directory shared by users, same as `user_cache_dir`""" return self.user_cache_dir @property def user_state_dir(self) -> str: """:return: state directory tied to the user, same as `user_data_dir`""" return self.user_data_dir @property def user_log_dir(self) -> str: """ :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/log`` """ path = self.user_cache_dir if self.opinion: path = os.path.join(path, "log") # noqa: PTH118 return path @property def user_documents_dir(self) -> str: """:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``""" return _android_documents_folder() @property def user_downloads_dir(self) -> str: """:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``""" return _android_downloads_folder() @property def user_pictures_dir(self) -> str: """:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``""" return _android_pictures_folder() @property def user_videos_dir(self) -> str: """:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``""" return _android_videos_folder() @property def user_music_dir(self) -> str: """:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``""" return _android_music_folder() @property def user_desktop_dir(self) -> str: """:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``""" return "/storage/emulated/0/Desktop" @property def user_runtime_dir(self) -> str: """ :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/tmp`` """ path = self.user_cache_dir if self.opinion: path = os.path.join(path, "tmp") # noqa: PTH118 return path @property def site_runtime_dir(self) -> str: """:return: runtime directory shared by users, same as `user_runtime_dir`""" return self.user_runtime_dir @lru_cache(maxsize=1) def _android_folder() -> str | None: # noqa: C901, PLR0912 """:return: base folder for the Android OS or None if it cannot be found""" result: str | None = None # type checker isn't happy with our "import android", just don't do this when type checking see # https://stackoverflow.com/a/61394121 if not TYPE_CHECKING: try: # First try to get a path to android app using python4android (if available)... from android import mActivity # noqa: PLC0415 context = cast("android.content.Context", mActivity.getApplicationContext()) # noqa: F821 result = context.getFilesDir().getParentFile().getAbsolutePath() except Exception: # noqa: BLE001 result = None if result is None: try: # ...and fall back to using plain pyjnius, if python4android isn't available or doesn't deliver any useful # result... from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") result = context.getFilesDir().getParentFile().getAbsolutePath() except Exception: # noqa: BLE001 result = None if result is None: # and if that fails, too, find an android folder looking at path on the sys.path # warning: only works for apps installed under /data, not adopted storage etc. pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files") for path in sys.path: if pattern.match(path): result = path.split("/files")[0] break else: result = None if result is None: # one last try: find an android folder looking at path on the sys.path taking adopted storage paths into # account pattern = re.compile(r"/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files") for path in sys.path: if pattern.match(path): result = path.split("/files")[0] break else: result = None return result @lru_cache(maxsize=1) def _android_documents_folder() -> str: """:return: documents folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") environment = autoclass("android.os.Environment") documents_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOCUMENTS).getAbsolutePath() except Exception: # noqa: BLE001 documents_dir = "/storage/emulated/0/Documents" return documents_dir @lru_cache(maxsize=1) def _android_downloads_folder() -> str: """:return: downloads folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") environment = autoclass("android.os.Environment") downloads_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOWNLOADS).getAbsolutePath() except Exception: # noqa: BLE001 downloads_dir = "/storage/emulated/0/Downloads" return downloads_dir @lru_cache(maxsize=1) def _android_pictures_folder() -> str: """:return: pictures folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") environment = autoclass("android.os.Environment") pictures_dir: str = context.getExternalFilesDir(environment.DIRECTORY_PICTURES).getAbsolutePath() except Exception: # noqa: BLE001 pictures_dir = "/storage/emulated/0/Pictures" return pictures_dir @lru_cache(maxsize=1) def _android_videos_folder() -> str: """:return: videos folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") environment = autoclass("android.os.Environment") videos_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DCIM).getAbsolutePath() except Exception: # noqa: BLE001 videos_dir = "/storage/emulated/0/DCIM/Camera" return videos_dir @lru_cache(maxsize=1) def _android_music_folder() -> str: """:return: music folder for the Android OS""" # Get directories with pyjnius try: from jnius import autoclass # noqa: PLC0415 context = autoclass("android.content.Context") environment = autoclass("android.os.Environment") music_dir: str = context.getExternalFilesDir(environment.DIRECTORY_MUSIC).getAbsolutePath() except Exception: # noqa: BLE001 music_dir = "/storage/emulated/0/Music" return music_dir __all__ = [ "Android", ] _vendor/platformdirs/__init__.py 0000644 00000053321 15030122015 0013010 0 ustar 00 """ Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and usage. """ from __future__ import annotations import os import sys from typing import TYPE_CHECKING from .api import PlatformDirsABC from .version import __version__ from .version import __version_tuple__ as __version_info__ if TYPE_CHECKING: from pathlib import Path from typing import Literal def _set_platform_dir_class() -> type[PlatformDirsABC]: if sys.platform == "win32": from platformdirs.windows import Windows as Result # noqa: PLC0415 elif sys.platform == "darwin": from platformdirs.macos import MacOS as Result # noqa: PLC0415 else: from platformdirs.unix import Unix as Result # noqa: PLC0415 if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system": if os.getenv("SHELL") or os.getenv("PREFIX"): return Result from platformdirs.android import _android_folder # noqa: PLC0415 if _android_folder() is not None: from platformdirs.android import Android # noqa: PLC0415 return Android # return to avoid redefinition of a result return Result PlatformDirs = _set_platform_dir_class() #: Currently active platform AppDirs = PlatformDirs #: Backwards compatibility with appdirs def user_data_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_data_dir def site_data_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data directory shared by users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, multipath=multipath, ensure_exists=ensure_exists, ).site_data_dir def user_config_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_config_dir def site_config_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config directory shared by the users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, multipath=multipath, ensure_exists=ensure_exists, ).site_config_dir def user_cache_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_cache_dir def site_cache_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).site_cache_dir def user_state_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: state directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_state_dir def user_log_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: log directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_log_dir def user_documents_dir() -> str: """:returns: documents directory tied to the user""" return PlatformDirs().user_documents_dir def user_downloads_dir() -> str: """:returns: downloads directory tied to the user""" return PlatformDirs().user_downloads_dir def user_pictures_dir() -> str: """:returns: pictures directory tied to the user""" return PlatformDirs().user_pictures_dir def user_videos_dir() -> str: """:returns: videos directory tied to the user""" return PlatformDirs().user_videos_dir def user_music_dir() -> str: """:returns: music directory tied to the user""" return PlatformDirs().user_music_dir def user_desktop_dir() -> str: """:returns: desktop directory tied to the user""" return PlatformDirs().user_desktop_dir def user_runtime_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_runtime_dir def site_runtime_dir( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> str: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime directory shared by users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).site_runtime_dir def user_data_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_data_path def site_data_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: data path shared by users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, multipath=multipath, ensure_exists=ensure_exists, ).site_data_path def user_config_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_config_path def site_config_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, multipath: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: config path shared by the users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, multipath=multipath, ensure_exists=ensure_exists, ).site_config_path def site_cache_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache directory tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).site_cache_path def user_cache_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: cache path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_cache_path def user_state_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, roaming: bool = False, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: state path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, roaming=roaming, ensure_exists=ensure_exists, ).user_state_path def user_log_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: log path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_log_path def user_documents_path() -> Path: """:returns: documents a path tied to the user""" return PlatformDirs().user_documents_path def user_downloads_path() -> Path: """:returns: downloads path tied to the user""" return PlatformDirs().user_downloads_path def user_pictures_path() -> Path: """:returns: pictures path tied to the user""" return PlatformDirs().user_pictures_path def user_videos_path() -> Path: """:returns: videos path tied to the user""" return PlatformDirs().user_videos_path def user_music_path() -> Path: """:returns: music path tied to the user""" return PlatformDirs().user_music_path def user_desktop_path() -> Path: """:returns: desktop path tied to the user""" return PlatformDirs().user_desktop_path def user_runtime_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime path tied to the user """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).user_runtime_path def site_runtime_path( appname: str | None = None, appauthor: str | None | Literal[False] = None, version: str | None = None, opinion: bool = True, # noqa: FBT001, FBT002 ensure_exists: bool = False, # noqa: FBT001, FBT002 ) -> Path: """ :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`. :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`. :param version: See `version <platformdirs.api.PlatformDirsABC.version>`. :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`. :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`. :returns: runtime path shared by users """ return PlatformDirs( appname=appname, appauthor=appauthor, version=version, opinion=opinion, ensure_exists=ensure_exists, ).site_runtime_path __all__ = [ "AppDirs", "PlatformDirs", "PlatformDirsABC", "__version__", "__version_info__", "site_cache_dir", "site_cache_path", "site_config_dir", "site_config_path", "site_data_dir", "site_data_path", "site_runtime_dir", "site_runtime_path", "user_cache_dir", "user_cache_path", "user_config_dir", "user_config_path", "user_data_dir", "user_data_path", "user_desktop_dir", "user_desktop_path", "user_documents_dir", "user_documents_path", "user_downloads_dir", "user_downloads_path", "user_log_dir", "user_log_path", "user_music_dir", "user_music_path", "user_pictures_dir", "user_pictures_path", "user_runtime_dir", "user_runtime_path", "user_state_dir", "user_state_path", "user_videos_dir", "user_videos_path", ] _vendor/jaraco.functools-4.0.1.dist-info/RECORD 0000644 00000001513 15030122015 0014671 0 ustar 00 jaraco.functools-4.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 jaraco.functools-4.0.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 jaraco.functools-4.0.1.dist-info/METADATA,sha256=i4aUaQDX-jjdEQK5wevhegyx8JyLfin2HyvaSk3FHso,2891 jaraco.functools-4.0.1.dist-info/RECORD,, jaraco.functools-4.0.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 jaraco.functools-4.0.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 jaraco/functools/__init__.py,sha256=hEAJaS2uSZRuF_JY4CxCHIYh79ZpxaPp9OiHyr9EJ1w,16642 jaraco/functools/__init__.pyi,sha256=gk3dsgHzo5F_U74HzAvpNivFAPCkPJ1b2-yCd62dfnw,3878 jaraco/functools/__pycache__/__init__.cpython-312.pyc,, jaraco/functools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 _vendor/jaraco.functools-4.0.1.dist-info/METADATA 0000644 00000005513 15030122015 0015077 0 ustar 00 Metadata-Version: 2.1 Name: jaraco.functools Version: 4.0.1 Summary: Functools like those found in stdlib Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Homepage, https://github.com/jaraco/jaraco.functools Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: more-itertools Provides-Extra: docs Requires-Dist: sphinx >=3.5 ; extra == 'docs' Requires-Dist: sphinx <7.2.5 ; extra == 'docs' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' Requires-Dist: rst.linker >=1.9 ; extra == 'docs' Requires-Dist: furo ; extra == 'docs' Requires-Dist: sphinx-lint ; extra == 'docs' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'docs' Provides-Extra: testing Requires-Dist: pytest >=6 ; extra == 'testing' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' Requires-Dist: pytest-cov ; extra == 'testing' Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'testing' Requires-Dist: jaraco.classes ; extra == 'testing' Requires-Dist: pytest-mypy ; (platform_python_implementation != "PyPy") and extra == 'testing' .. image:: https://img.shields.io/pypi/v/jaraco.functools.svg :target: https://pypi.org/project/jaraco.functools .. image:: https://img.shields.io/pypi/pyversions/jaraco.functools.svg .. image:: https://github.com/jaraco/jaraco.functools/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/jaraco.functools/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/jaracofunctools/badge/?version=latest :target: https://jaracofunctools.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/jaraco.functools :target: https://tidelift.com/subscription/pkg/pypi-jaraco.functools?utm_source=pypi-jaraco.functools&utm_medium=readme Additional functools in the spirit of stdlib's functools. For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-jaraco.functools?utm_source=pypi-jaraco.functools&utm_medium=referral&utm_campaign=github>`_. _vendor/jaraco.functools-4.0.1.dist-info/INSTALLER 0000644 00000000004 15030122015 0015242 0 ustar 00 pip _vendor/jaraco.functools-4.0.1.dist-info/WHEEL 0000644 00000000134 15030122015 0014555 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/jaraco.functools-4.0.1.dist-info/LICENSE 0000644 00000001777 15030122015 0015011 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/jaraco.functools-4.0.1.dist-info/top_level.txt 0000644 00000000007 15030122015 0016517 0 ustar 00 jaraco _vendor/inflect/__pycache__/__init__.cpython-310.pyc 0000644 00000220524 15030122015 0016266 0 ustar 00 o �ht� � @ s U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZ ddlmZ ddlm Z dd l m Z G d d � d e �Z G d d � d e �Z!G dd� de �Z"G dd� de �Z#G dd� de �Z$G dd� de �Z%G dd� de �Z&�d�dd �Z'�d��d�d!d"�Z(�d�d%d&�Z) '�d��d�d-d.�Z*d/d0d1d2d3d4d5d6d7�Z+i d8d9�d:d;�d<d=�d>d?�d@dA�dBdC�dDdE�dFdG�dHdI�dJdK�dLdM�dNdO�dPdQ�dRdS�dTdU�dVdW�dXdY�i dZd[�d\d]�d^d_�d`da�dbdc�ddde�dfdg�dhdi�djdk�dldm�dndo�dpdq�drds�dtdu�dvdw�dxdy��Z,e,�-e+� dzd{d|d}d~�Z.dd�iZ/d�d�� e,�0� D �Z1e2e1�D ] Z3d�e3v �rVe3�4d��\Z5Z6e1e3 e1e5< e1e6< e1e3= �q;d�d�� e.�0� D �Z7d�d�� e/�0� D �Z8e2e8�D ] Z3d�e3v �r�e3�4d��\Z5Z6e8e3 e8e5< e8e6< e8e3= �qnd�Z9e)e9�Z:d�Z;e)e;�Z<g d��Z=d�gZ>e(d�e=d�d�� e>D � �Z?e=e> Z@e*e@d�d�d�d��\ZAZBZCd�ZDe*eDd�d�\ZEZFZGZHd�ZIe*eId�d�\ZJZKZLZMd�ZNe*eNd�d�\ZOZPZQZRd�ZSe*eSd�d��\ZTZUZVZWd�ZXe*eXd�d��\ZYZZZ[Z\d�Z]e*e]d�d��\Z^Z_Z`Zad�Zbe*ebd�d��\ZcZdZeZfd�Zge*egd�d��\ZhZiZjZkd�Zle)el�Zmd�Zne*end�d��\ZoZpZqZrd�Zse*esd�d��\ZtZuZvZwg d��Zxe)ex�Zye)d�d�� exD ��Zze(d�ex�Z{h d��Z|d�d�� e|D �Z}g d��ex Z~e)e~�Ze)d�d�� e~D ��Z�d�Z�e*e�dd�\Z�Z�Z�Z�d�Z�e*e�d�d��\Z�Z�Z�Z�d�Z�e*e�d�d��\Z�Z�Z�Z�d�Z�e*e�d�d��\Z�Z�Z�Z�d�Z�e*e�d�d��\Z�Z�Z�Z�d�Z�e*e�d�d�\Z�Z�Z�Z�d�Z�e*e�d�d�\Z�Z�Z�Z�d��4� Z�d��4� Z�e*e�ddd�d��\Z�Z�Z�e*e�ddd�d��\Z�Z�Z�d�Z�e*e�d�d�d�d��\Z�Z�Z�g d��Z�d�d�gZ�e�d�d�� e�D � Z�d�Z�g d��e� Z�g d��Z�g d��e� Z�e)e��Z�g d��e= Z�d�d�ge> Z�e)e��Z�d�d�� e�D �Z�d�d�� e�D �Z�e)e��Z�d�gZ�e'd���e�d�d�� e�D � e� ��Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�e'd���e�ge� e2e+� g d֢ ��Z�d�e'dfd�e'dڃfd�e'd܃ffZ�d�dބ e�D �Z�d#e�d�< d�d���eӡ� d�Z�d�Z�d�4� Z�e�g d� Z�e)eZ�e'd���eء�Z�d�eڛ d�Z�h d�Z�i d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d��d�d��d�d��d�d��d�d�i�Z�d�d�d�� eݠ0� D �iZސd eԐd< �de�d� d�< d�d�d�d�dd�dd�dd�dd�d� Z�e'd���eߡ�Z�e)e߃Z�dd�� eߠ0� D �eސd< �dD ]*\Z�Z�Z�Z�z e�e�e� e� e�< W �q> e�yh i e�e� e�< e�e�e� e� e�< Y �q>w e'd���eސd ��Z�e)eސd �Z�d��d�d �Z�d �d �d �d �d �d �d �d �d �d� Z�i �d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d�d��d �d��d �d ��d �d ��d �d ��d �d �d �d!�d!�d"�d"�d#�d#�d$�d$�d%�d%�d&�d&�d'��Z�e��d(e'd���e��� �d)�ej�Z�d*Z�e��d+ej�Z�d,Z�d-Z�d.Z�d/Z�d0Z��d1�d1�d2�d3�d4�Z�e��d(e'd���e���� �d5�ej�Z��d6�d7�d8�d8�d8�d8�d9�Z�e��d(e'd���e���� �d5�ej�Z�e��d:ej��Z�e��d;ej�Z�e��d<ej�Z�e��d=ej�Z�e��d>ej�Z�e��d?ej��Z �d@�dA�dB�dC�d@�d@�d@�d@�d@�d@�d@�d@�d@�dD� �Z�e�e��� ��Z�e�dE�dF�dG�dH�dI�dJ�dK�dL�dM��Ze��d�d����e�� �dN���Zg �dO��Zg �dP��Z g �dQ��Z g �dR��Z �ed�d�d�d'd�d��dS��Z �dTd�� �e D ��Z �dUd�� �e D ��Zd'd�d�dV��Ze��dW��Ze��dXej��Ze��dY��Ze��dZe՛ �d5�ej��Ze��dZeۛ �d5�ej��Ze��d[��Ze��d(eћ �d5���Ze��d\��Ze��d]ej��Ze��d^��Ze��d_ej��Ze��d`ej��Ze��daej��Z e��dbej��Z e��dcej��Z e��ddej��Z e��deej��Z e��dfej��Z!e��dgej��Z"e��dhej��Z#e��diej��Z$e��djej��Z%e��dk��Z&e��dlej��Z'e��dm��Z(e��dn��Z)e��do��Z*e��dp��Z+e��dq��Z,e��dr��Z-e��ds��Z.e��dt��Z/e��du��Z0e��dv��Z1e��dw��Z2e��dx��dyfe��dz��d{fe��d|��d}fe��d~��dfe��d���d�fe��d���d�fe��d���d�fe��d���d}fe��d���d}fe��d���d�fe��d���d�ff �Z3e��d���Z4G �d��d�� �d��e5��Z6e �Z7e �Z8�e8�r�e �e5�d�f �Z9n G �d��d�� �d��e:��Z;G �d��d�� �d��e;�d���Z9G �d��d�� �d���Z<dS (� a� inflect: english language inflection - correctly generate plurals, ordinals, indefinite articles - convert numbers to words Copyright (C) 2010 Paul Dyson Based upon the Perl module `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_. methods: classical inflect plural plural_noun plural_verb plural_adj singular_noun no num a an compare compare_nouns compare_verbs compare_adjs present_participle ordinal number_to_words join defnoun defverb defadj defa defan INFLECTIONS: classical inflect plural plural_noun plural_verb plural_adj singular_noun compare no num a an present_participle PLURALS: classical inflect plural plural_noun plural_verb plural_adj singular_noun no num compare compare_nouns compare_verbs compare_adjs COMPARISONS: classical compare compare_nouns compare_verbs compare_adjs ARTICLES: classical inflect num a an NUMERICAL: ordinal number_to_words USER_DEFINED: defnoun defverb defadj defa defan Exceptions: UnknownClassicalModeError BadNumValueError BadChunkingOptionError NumOutOfRangeError BadUserDefinedPatternError BadRcFileError BadGenderError � )� annotationsN)�Number) � TYPE_CHECKING�Any�Callable�Dict�Iterable�List�Literal�Match�Optional�Sequence�Tuple�Union�cast)�windowed_complete)� typechecked� )� Annotatedc @ � e Zd ZdS )�UnknownClassicalModeErrorN��__name__� __module__� __qualname__� r r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/inflect/__init__.pyr V � r c @ r )�BadNumValueErrorNr r r r r r Z r r c @ r )�BadChunkingOptionErrorNr r r r r r ^ r r c @ r )�NumOutOfRangeErrorNr r r r r r b r r c @ r )�BadUserDefinedPatternErrorNr r r r r r! f r r! c @ r )�BadRcFileErrorNr r r r r r" j r r" c @ r )�BadGenderErrorNr r r r r r# n r r# �s�str�returnc C s d| � d�S )Nz(?:�)r �r$ r r r �encloser s r) �cutpoint� Optional[int]�words�Optional[Iterable[str]]c s t d�� fdd�|p g D ���S )a� Join stem of each word in words into a string for regex. Each word is truncated at cutpoint. Cutpoint is usually negative indicating the number of letters to remove from the end of each word. >>> joinstem(-2, ["ephemeris", "iris", ".*itis"]) '(?:ephemer|ir|.*it)' >>> joinstem(None, ["ephemeris"]) '(?:ephemeris)' >>> joinstem(5, None) '(?:)' �|c 3 s � | ] }|d � � V qd S �Nr ��.0�w�r* r r � <genexpr>� s � zjoinstem.<locals>.<genexpr>)r) �join)r* r, r r3 r �joinstemv s r6 � Iterable[str]�Dict[int, set]c C s* t �t�}| D ] }|t|� �|� q|S )a From a list of words, return a dict of sets sorted by word length. >>> words = ['ant', 'cat', 'dog', 'pig', 'frog', 'goat', 'horse', 'elephant'] >>> ret = bysize(words) >>> sorted(ret[3]) ['ant', 'cat', 'dog', 'pig'] >>> ret[5] {'horse'} )� collections� defaultdict�set�len�add)r, �resr2 r r r �bysize� s r? T�lst�plending� siendingsize� dojoinstem�boolc sV �dur� �� �fdd�| D �}t | �}t |�}|r&t�| �}||||fS |||fS )am given a list of singular words: lst an ending to append to make the plural: plending the number of characters to remove from the singular before appending plending: siendingsize a flag whether to create a joinstem: dojoinstem return: a list of pluralised words: si_list (called si because this is what you need to look for to make the singular) the pluralised words as a dict of sets sorted by word length: si_bysize the singular words as a dict of sets sorted by word length: pl_bysize if dojoinstem is True: a regular expression that matches any of the stems: stem Nc s g | ] }|d �� � �qS r/ r r0 �rA rB r r � <listcomp>� s z$make_pl_si_lists.<locals>.<listcomp>)r? r6 )r@ rA rB rC �si_list� pl_bysize� si_bysize�stemr rE r �make_pl_si_lists� s rK zcorpuses|corporaz opuses|opera�genera�mythoiz penises|penes�testeszatlases|atlantes�yeses)�corpus�opus�genus�mythos�penis�testis�atlas�yes�child�children�chilizchilis|chilies�brotherzbrothers|brethren�infinityzinfinities|infinity�loaf�loaves�lorez lores|lore�hoofz hoofs|hooves�beefz beefs|beeves�thiefzthiefs|thieves�money�monies�mongoose� mongooses�ox�oxen�cowz cows|kine�graffito�graffiti�octopuszoctopuses|octopodes�geniez genies|genii�ganglionzganglions|ganglia�trilby�trilbys�turfz turfs|turves�numen�numina�atman�atmas�occiputzocciputs|occipita� sabretooth� sabretooths� sabertooth� sabertooths�lowlife�lowlifes�flatfoot� flatfoots� tenderfoot� tenderfoots�romany�romanies�jerry�jerries�mary�maries�talouse�talouses�rom�roma�carmen�carmina�Romanies�Jerrys�Marys�Roma)�Romany�Jerry�Mary�Romz prima donnazprima donnas|prime donnec C � i | ]\}}||�qS r r �r1 �k�vr r r � <dictcomp>� � r� r. c C r� r r r� r r r r� r� c C r� r r r� r r r r� r� )�quartz�topaz)�snooze)� ephemeris�iris�clitoris� chrysalis� epididymis�itis���c C � g | ]}d |� ��qS �z.*r r0 r r r rF ) r� rF �ides� F)rC )�anathema�bema� carcinoma�charisma�diploma�dogma�drama�edema�enema�enigma�lemma�lymphoma�magma�melisma�miasma�oedema�sarcoma�schema�soma�stigma�stoma�trauma�gumma�pragma�ata)�alumna�alga�vertebra�persona�vita�e)�amoeba�antenna�formula� hyperbola�medusa�nebula�parabola�abscissa�hydra�nova�lacuna�aurora�umbra�flora�fauna)�stamen�foramen�lumen�ina) � bacterium�agendum� desideratum�erratum�stratum�datum�ovum�extremum� candelabrum�a) �maximum�minimum�momentum�optimum�quantum�cranium� curriculum�dictum�phylum�aquarium� compendium�emporium�encomium� gymnasium� honorarium� interregnum�lustrum� memorandum� millennium�rostrum�spectrum�speculum�stadium� trapezium� ultimatum�medium�vacuum�velum� consortium� arboretum) �alumnus�alveolus�bacillus�bronchus�locus�nucleus�stimulus�meniscus� sarcophagus�i)�focus�radius�genius�incubus�succubus�nimbus�fungus� nucleolus�stylus�torus� umbilicus�uterus� hippopotamus�cactus)�status� apparatus� prospectus�sinus�hiatus�impetus�plexus) � criterion� perihelion�aphelion� phenomenon� prolegomenon�noumenon�organon� asyndeton� hyperbaton)�oxymoron)�solo�soprano�basso�alto� contralto�tempo�piano�virtuosoc C s g | ] }|d d� � d��qS )N���r r r0 r r r rF 9 s r4 > �ISO�NCO�NGO�ado�oto�NATOc C s h | ]}|� d ��qS r( r r0 r r r � <setcomp>@ r� r; )�� aficionado�aggro�albino�allegro�ammo� Antananarivo� archipelago� armadillo�auto�avocado�Bamako� Barquisimeto�bimbo�bingo�Biro�bolero�Bolzano�bongo�Boto�burro�Cairo�canto� cappuccino�casino�cello�Chicago�Chimango�cilantro�cochito�coco�Colombo�Colorado�commando� concertino�contango�credo� crescendo�cyano�demo�ditto�Draco�dynamo�embryo� Esperanto�espresso�euro�falsetto�Faro�fiasco�Filipino�flamenco�furioso� generalissimo�Gestapo�ghetto�gigolo�gizmo� Greensboro�gringo� Guaiabero�guano�gumbo�gyro�hairdo�hippo�Idaho�impetigo�inferno�info� intermezzo� intertrigo�Iquico�jumbo�junto�Kakapo�kilo� Kinkimavo�Kokako�Kosovo�Lesotho�libero�libido�libretto�lido�Lilo�limbo�limo�lineno�lingo�lino�livedo�loco�logo�lumbago�macho�macro�mafioso�magneto� magnifico�Majuro�Malabo� manifesto�Maputo� Maracaibo�medico�memo�metro�Mexico�micro�Milano�Monaco�mono� Montenegro�Morocco�Muqdisho�myo�neutrino�Ningbo�octavo�oregano�Orinoco�Orlando�Oslo�panto� Paramaribo�Pardusco�pedalo�photo�pimento�pinto�pleco�Pluto�pogo�polo�ponchoz Porto-Novo�Porto�pro�psycho�pueblo�quarto�Quito�repo�rhino�risotto�rococo�rondo� Sacramento�saddo�sago�salvo�Santiago�Sapporo�Sarajevo� scherzando�scherzo�silo�sirocco�sombrero�staccato�sterno�stucco�stylo�sumo�Taiko�techno�terrazzo�testudo�timpano�tiro�tobacco�Togo�Tokyo�torero�Torino�Toronto�torso�tremolo�typo�tyro�ufo�UNESCO�vaquero� vermicello�verso�vibrato� violoncello�Virgo�weirdo�WHO�WTO� Yamoussoukrozyo-yo�zero�Ziboc C � g | ]}|� d ��qS r( r r0 r r r rF r� )�czech�eunuch�stomach)�codex�murex�silex�ices)�radix�helix)�vortex�vertex�cortex�latex�pontifex�apex�index�simplex)�appendix)�afrit�afreet�efreet)�goy�seraph�cherub�imzq ataman caiman cayman ceriman desman dolman farman harman hetman human leman ottoman shaman talisman z� Alabaman Bahaman Burman German Hiroshiman Liman Nakayaman Norman Oklahoman Panaman Roman Selman Sonaman Tacoman Yakiman Yokohaman Yuman )� booklouse� grapelouse�louse� woodlouse�lice� )#�breeches�britches�pajamas�pyjamas�clippers�gallows�hijinks� headquarters�pliers�scissorsrN �herpes�pincers�shears� proceedings�trousers�cantus�coitus�nexus� contretemps�corps�debris�siemens�mumps�diabetes� jackanapes�series�species� subspecies�rabies�chassis�innings�news�mews�haggis�ois�measlesc C r� r� r r0 r r r rF � s �) � wildebeest�swine�eland�bison�buffalo�cattle�elk� rhinoceros�zucchini�caribou�dace�grousez guinea fowlz guinea-fowl�haddock�hake�halibut�herring�mackerel�pickerel�pike�roe�seed�shad�snipe�teal�turbotz water fowlz water-fowl)�tuna�salmonrQ �trout�breamzsea-basszsea bass�carp�cod�flounder�whiting�mooserk �djinn�samuri� offspring�pence�quid�hertz)� Portuguese�Amoyese�Borghese�Congoese�Faroese� Foochowese�Genevese�Genoese� Gilbertese� Hottentotese� Kiplingese�Kongoese�Lucchese�Maltese� Nankingese�Niasese� Pekingese� Piedmontese� Pistoiese� Sarawakese�Shavese� Vermontese� Wenchowese�Yengeese) �butter�cash� furniture� information�fish�deer�sheep�nese�rese�lese�mese�pox�craft) � acropolis�aegis�alias�asbestos�bathos�bias� bronchitis�bursitis�caddis�cannabis�canvas�chaos�cosmos�dais� digitalis� epidermis�ethos�eyas�gas�glottis�hubris�ibis�lens�mantis�marquis� metropolis�pathos�pelvis�polisrH � sassafras�trellis�ss�usc C r� ��esr r0 r r r rF O r� c C r� r� r r0 r r r rF P r� z [A-Z].*esc C r� r� r r0 r r r rF X r� )�Bolshois�Hanois)� Betelgeuses�Duses�Meuses� Syracuses� Toulouses) �abuses� applauses�blouses�carouses�causes� chartreuses�clauses�contuses�douses�excuses�fuses�grouses� hypotenuses� masseuses� menopauses�misuses�muses�overuses�pauses�peruses�profuses�recluses�reuses�ruses�souses�spouses�suffuses� transfuses�uses)��Addies�Aggies�Allies�Amies�Angies�Annies� Annmaries�Archies�Arties�Aussies�Barbies�Barries�Basies�Bennies�Bernies�Berties�Bessies�Betties�Billies�Blondies�Bobbies�Bonnies�Bowies�Brandies�Bries�Brownies�Callies� Carnegies�Carries�Cassies�Charlies�Cheries� Christies�Connies�Curies�Dannies�Debbies�Dixies�Dollies�Donnies� Drambuies�Eddies�Effies�Ellies�Elsies�Eries�Ernies�Essies�Eugenies�Fannies�Flossies�Frankies�Freddies� Gillespies�Goldies�Gracies�Guthries�Hallies�Hatties�Hetties�Hollies�Jackies�Jamies�Janies�Jannies�Jeanies�Jeannies�Jennies�Jessies�Jimmies�Jodies�Johnies�Johnnies�Josies�Julies� Kalgoorlies�Kathies�Katies�Kellies�Kewpies�Kristies�Laramies�Lassies�Lauries�Leslies�Lessies�Lillies�Lizzies�Lonnies�Lories�Lorries�Lotties�Louies� Mackenzies�Maggies�Maisies�Mamies�Marcies�Margies�Maries� Marjories�Matties� McKenzies�Melanies�Mickies�Millies�Minnies�Mollies�Mounties�Nannies�Natalies�Nellies�Netties�Ollies�Ozzies�Pearlies� Pottawatomies�Reggies�Richies�Rickies�Robbies�Ronnies�Rosalies� Rosemaries�Rosies�Roxies�Rushdies�Ruthies�Sadies�Sallies�Sammies�Scotties� Selassies�Sherries�Sophies�Stacies� Stefanies� Stephanies�Stevies�Susies�Sylvies�Tammies�Terries�Tessies�Tommies�Tracies�Trekkies�Valaries�Valeries� Valkyries�Vickies�Virgies�Willies�Winnies�Wylies�Yorkies)G�aeries�baggies�belies�biggies�birdies�bogies�bonnies�boogies�bookies� bourgeoisies�brownies�budgies�caddies�calories� camaraderies� cockamamies�collies�cookies�coolies�cooties�coteries�crappies�curies�cutesies�dogies�eyries�floozies�footsies�freebies�genies�goalies�groupies�hies� jalousies�junkies�kiddies�laddies�lassies�lies� lingeries�magpies� menageries�mommies�movies�neckties�newbies�nighties�oldies� organdies�overlies�pies�pinkies�pixies�potpies�prairies�quickies�reveries�rookies� rotisseries�softies�sortiesr7 �stymies�sweeties�ties� underlies�unties�veggies�vies�yuppies�zombies)�Chloes�Crusoes�Defoes�Faeroes�Ivanhoes�Joes�McEnroes�Moes�Monroes�Noes�Poes�Roscoes�Tahoes� Tippecanoes�Zoes)�aloes�backhoes�canoes�does�floes�foes�hoes� mistletoes�oboes�pekoes�roes�sloes�throes�tiptoes�toes�woes)�quartzes�topazes)�buzzes�fizzes�frizzes�razzes)� Andromaches�Apaches�Blanches� Comanches� Nietzsches�Porsches�Roches)�aches� avalanches� backaches� bellyaches�caches�cloches�creches�douches�earaches�fiches� headaches� heartaches� microfiches�niches� pastiches�psyches�quiches� stomachaches� toothaches�tranches)�annexes�axes�deluxes�pickaxes)�Hesses�Jesses� Larousses�Matisses)�bouillabaisses� crevasses� demitasses�impasses�mousses�posses)�Clives� Palmolives) � interweaves�weaves�olives�bivalves� dissolves�resolves�salves�twelves�valves)z (.*[csx])isz(.*)cepsz[A-Z].*s�generalz1(?!major|lieutenant|brigadier|adjutant|.*star)\S+�martial�court�force�poundc c s( � | ]\}}t |d |� d� �V qdS )z (?=(?:-|\s+)r' N)r) )r1 �key�valr r r r4 � s � �r4 �pl_sb_postfix_adj�(z)(.*))A� amanuenses� amniocenteses�analyses� antitheses� apotheoses�arterioscleroses�atherosclerosesr� � catalyses� catharses�chasses� cirrhoses�cocces�crises� diagnoses�dialyses�diereses� electrolyses�emphases�exegeses�geneses� halitoses� hydrolyses�hypnoses� hypotheses� hystereses� metamorphoses� metastases� misdiagnoses�mitoses� mononucleoses�narcoses�necroses�nemeses�neuroses�oases�osmoses� osteoporoses� paralyses� parentheses�parthenogeneses� periphrases�photosyntheses� probosces� prognoses� prophylaxes� prostheses�preces� psoriases�psychoanalyses� psychokineses� psychoses� scleroses� scolioses�sepses� silicoses� symbioses�synopses� syntheses�taxes� telekineses�theses� thromboses� tuberculoses� urinalysesz� about above across after among around at athwart before behind below beneath beside besides between betwixt beyond but by during except for from in into near of off on onto out over since till to under until unto upon with)�de�du�daz(.*?)((?:-|\s+)(?:z)(?:-|\s+))a(?:-|\s+)(.*)> �neuter�feminine� masculine�gender-neutral�feminine or masculine�masculine or feminine�we�myself� ourselves�you�yourself� yourselves�she�they�herself� themselves�he�himself�it�itself�themself�mine�ours�yours�hers�theirs�his�its�nomc C r� r r r� r r r r� g r� z0Dict[str, Dict[str, Union[str, Dict[str, str]]]]�si_pron�I�them) �merc re rf �herrj �himrm rn ro r{ rp c C r� r r r� r r r r� r� �acc) )rx ri r\ rn )rx ri r] rh )rx ri r^ rl )rx ri r_ ri )rx ri r` z she or he)rx ri ra z he or she)rx rk r\ ro )rx rk r] rj )rx rk r^ rm )rx rk r_ rp )rx rk r` �herself or himself)rx rk ra �himself or herself)rx ru r\ rw )rx ru r] rt )rx ru r^ rv )rx ru r_ ru )rx ru r` z hers or his)rx ru ra z his or hers)r r{ r\ rn )r r{ r] r} )r r{ r^ r~ )r r{ r_ r{ )r r{ r` z her or him)r r{ ra z him or her)r rk r\ ro )r rk r] rj )r rk r^ rm )r rk r_ rp )r rk r` r� )r rk ra r� c C sJ zt | | }W n ty � w z|| W S ty$ tt|� Y S w r/ )ry �KeyError� TypeErrorr r% )�thecase�word�gender�singr r r � get_si_pron� s � �r� �are�were�have�do) �amr� �is�wasr� r� �hasr� r� �act�acts�blame�blames�can�must�fly�flies�copy�copies�drink�drinks�fight�fights�fire�fires�like�look�make�reach�run�sink�sleep�view)�likesr� �looksr� �makesr� �reachesr� �runsr� �sinksr� �sleepsr� �viewsz^(z )((\s.*)?)$)�did�had�ate�made�put�spent�fought�sank�gave�sought�shall�could�ought�shouldz0^((?:thought|saw|bent|will|might|cut))((\s.*)?)$)r� r� r� r� r� r� )r� r� )�shoes)�0�nor� �nil)�1r� �an�one�each�every�this�that�some�these�those)r� r� r� r� z)$�our�your�their)�myr� rw r} rv r� z~ ^(?! FJO | [HLMNS]Y. | RY[EO] | SQU | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU]) [FHLMNRSX][A-Z] z)^(y(b[lor]|cl[ea]|fere|gg|p[ios]|rou|tt))z ^((?:unabomber|unanimous|US))z0^((?:euler|hour(?!i)|heir|honest|hono[ur]|mpeg))z^([aefhilmnorsx]-?th)z^([bcdgjkpqtuvwyz]-?th)�th�st�nd�rd) r r r� � � r � � � � � � � �tieth�first�second�third�fifth�eighth�ninth�twelfth)�tyr� �two�three�five�eight�nine�twelvez)\Z) � r� r� r� �fourr� �six�sevenr� r� ) �ten�elevenr� �thirteen�fourteen�fifteen�sixteen� seventeen�eighteen�nineteen) r� r� �twenty�thirty�forty�fifty�sixty�seventy�eighty�ninety) � z thousandz millionz billionz trillionz quadrillionz quintillionz sextillionz septillionz octillionz nonillionz decillion)�allr� �herd�names�persons�ancientc C � i | ]}|d �qS �Tr �r1 r� r r r r� � � c C r )Fr r r r r r� � r )�True�False�Nonez\$(\d+)z((\w+)\([^)]*\)*)z\A(\s*)(.+?)(\s*)\Zz^(?:z (?P<denominator>.+)( (per|a) .+)z\sz ^(.*[^s])s$z ^(.*)'s?$z \A(\s*)(?:an?\s+)?(.+?)(\s*)\Zz^[aefhilmnorsx]$z^[bcdgjkpqtuvwyz]$z^[aefhilmnorsx][.-]z ^[a-z][.-]z ^[^aeiouy]z^e[uw]z^onc?e\bz ^onetime\bz^uni([^nmd]|mo)z^u[bcfghjkqrst][aeiou]z^ukrz ^U[NK][AIEO]?z^[aeiou]z(\d)z(\d)(\d)z (\d)(\d)(\d)z(\d)(\d)(\d)(?=\D*\Z)z(\d)(\d)(?=\D*\Z)z (\d)(?=\D*\Z)z(\d)(\d{3}(?:,|\Z))z\Dz\s+,z , (\S+)\s+\Zz\s+zie$�yzue$�uz ([auy])e$z\g<1>zski$�skiz[^b]i$r� z ^(are|were)$�bez^(had)$�havz^(hoe)$z([^e])e$zer$�erz ([^aeiou][aeiouy]([bdgmnprst]))$z \g<1>\g<2>z\dc @ s8 e Zd ZU ded< ded< ded< ded< d d d �Zd S ) �Wordsr% �loweredz List[str]�split_r� �lastr& r c C s0 | � � | _| �� | _| jd | _| jd | _d S )Nr r4 )�lowerr �splitr r� r )�self�origr r r �__init__� s zWords.__init__N�r& r )r r r �__annotations__r r r r r r � s r � String with at least 1 characterc @ s e Zd Zddd�ZdS ) � _WordMeta�instancer r& rD c C s t |t�o t|�dkS �Nr )� isinstancer% r< )r r" r r r �__instancecheck__� � z_WordMeta.__instancecheck__N)r" r r& rD )r r r r% r r r r r! � s r! c @ s e Zd ZdZdS )�Wordr N)r r r �__doc__r r r r r' � s r' )� metaclassc @ s� e Zd Zd�dd�Zedd� �Zejdd� �Zed�d d ��Zed�dd��Z ed�dd��Z ed�dd��Z ed�dd ��Z d�d d �Z d�d d �Zed�d&d'��Zd�d(d)�Z *d�d�d/d0�Zd�d2d3�Zd4d5� Zd�d:d;�Zed�d=d>��Zd�d@dA�Zd�dCdD�Zed�d�dFdG��Ze *d�d�dHdI��Ze *d�d�dJdK��Ze *d�d�dLdM��Zed�dQdR��Z ed�dSdT��Z ed�dUdV��Z ed�dWdX��Z e * *d�d�d[d\��Z d�d]d^�Z!d�ddde�Z"d�dfdg�Z#d�dhdi�Z$d�d�dldm�Z% *d�d�dndo�Z&e'dpdq� �Z(d�dtdu�Z)e*dvdw� �Z+ *d�d�dxdy�Z, *d�d�dzd{�Z- *d�d�d|d}�Z. * *d�d�d~d�Z/ed�d�d�d���Z0e0Z1e2d�fe3d�fe4d�fe5d�fe6d�fe7d�fe8d�fe9d�fe:d�fe;d�fe<d�fe=d�fe>d�fe?d�fe@d�feAd�feBd�feCd�feDd�ffZEd�d�d��ZFed�d�d�d���ZGed�d�d���ZHed�d�d���ZId�d�d�d��ZJd�d�d�d��ZKd�d�d�d��ZLd�d�d��ZMd�d�d��ZNd�d�d��ZOd�d�d��ZPd�d�d��ZQd�d�d��ZRd�d�d��ZSd�d�d��ZTd�d�d��ZUe*d�d�� �ZVe'd�d�� �ZWe*d�d�� �ZXe*d�d�� �ZYe � � � � � � � *d�d�d�dƄ�ZZe*d�dȄ �Z[e * � * � �d�d�d�d҄�Z\d*S )��enginer& r c C sD t �� | _d | _d| _g | _g | _g | _g | _g | _ d| _ d | _ d S )Nr r\ ) � def_classicalr� �classical_dict�persistent_count� mill_count�pl_sb_user_defined�pl_v_user_defined�pl_adj_user_defined�si_sb_user_defined�A_a_user_defined� thegender�_engine__number_args�r r r r r � s zengine.__init__c C s t tttf | j�S r/ )r r r% r5 r6 r r r � _number_args s zengine._number_argsc C s || _ d S r/ )r5 )r r r r r r7 s �singular�Optional[Word]�plural�intc C s8 | � |� | �|� | j�||f� | j�||f� dS )z= Set the noun plural of singular to plural. r )�checkpat�checkpatpluralr/ �extendr2 �r r8 r: r r r �defnoun s zengine.defnoun�s1�p1�s2�p2�s3�p3c C sX | � |� | � |� | � |� | �|� | �|� | �|� | j�||||||f� dS )z� Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively. Where 1, 2 and 3 represent the 1st, 2nd and 3rd person forms of the verb. r )r< r= r0 r> )r rA rB rC rD rE rF r r r �defverb s zengine.defverbc C s( | � |� | �|� | j�||f� dS )zB Set the adjective plural of singular to plural. r )r< r= r1 r> r? r r r �defadj7 s z engine.defadj�patternc C � | � |� | j�|df� dS )zS Define the indefinite article as 'a' for words matching pattern. r� r �r< r3 r> �r rI r r r �defaB � z engine.defac C rJ )zT Define the indefinite article as 'an' for words matching pattern. r� r rK rL r r r �defanL rN z engine.defanc C sD |du rdS z t �|d� W dS t jy! } zt|�|�d}~ww )z5 check for errors in a regex pattern Nr� )�re�match�errorr! )r rI �errr r r r< V s ��zengine.checkpatc C s dS )z= check for errors in a regex replace pattern Nr rL r r r r= a s zengine.checkpatpluralr� r' �wordlist�Sequence[Optional[Word]]� Optional[str]c C s| t t|�d dd�D ]1}t�d|| � d�|tj�}|r;||d d u r' d S t�dtt||d ��}|� |� S q d S )Nr� r� �^�$r z\\1) �ranger< rP �search� IGNORECASE� DOLLAR_DIGITS�subr r' �expand)r r� rT r �mo�plr r r �ud_matchg s ��zengine.ud_matchc K sd |s t �� | _dS d|v r |d rt �� | _nt�� | _|�� D ]\}}|tv r.|| j|< q t�dS )a� turn classical mode on and off for various categories turn on all classical modes: classical() classical(all=True) turn on or off specific claassical modes: e.g. classical(herd=True) classical(names=False) By default all classical modes are off except names. unknown value in args or key in kwargs raises exception: UnknownClasicalModeError Nr )� all_classicalr� r, � no_classical�itemsr+ r )r �kwargsr� r� r r r � classicalt s �zengine.classicalN�countr+ �showr% c C sX |dur'zt |�| _W n ty } zt|�d}~ww |du s!|r%t|�S dS d| _dS )z� Set the number to be used in other method calls. Returns count. Set show to False to return '' instead. Nr� )r; r- � ValueErrorr r% )r rg rh rS r r r �num� s �� �z engine.numr� c C s |t v r || _dS t�)a� set the gender for the singular of plural pronouns can be one of: 'neuter' ('they' -> 'it') 'feminine' ('they' -> 'she') 'masculine' ('they' -> 'he') 'gender-neutral' ('they' -> 'they') 'feminine or masculine' ('they' -> 'she or he') 'masculine or feminine' ('they' -> 'he or she') N)�singular_pronoun_gendersr4 r# )r r� r r r r� � s z engine.genderc s� t |tj�r |jS t |tj�r|jS t |tj�r"� fdd�|jD �S t |tj�r4t � fdd�|jD ��S t |tj �r=|j S t d|j � d���)z5 Return the value of the ast object. c � g | ]}� � |��qS r ��_get_value_from_ast�r1 r� r6 r r rF � r� z.engine._get_value_from_ast.<locals>.<listcomp>c rl r rm ro r6 r r rF � r� zname 'z' is not defined)r$ �ast�Num�n�Strr$ r �eltsr �tuple� NameConstant�value� NameError�id)r �objr r6 r rn � s zengine._get_value_from_astr_ r � methods_dict�Dict[str, Callable]c sl |� � \}}||vr |S t�|�}� fdd�|jd jjD �}� fdd�|jd jjD �}|| |i |��S )zD Return the string to be substituted for the match. c rl r rm )r1 r� r6 r r rF � s ��z0engine._string_to_substitute.<locals>.<listcomp>r c s i | ] }|j � �|j��qS r )�argrn rw )r1 �kwr6 r r r� � s ��z0engine._string_to_substitute.<locals>.<dictcomp>)�groupsrp �parse�bodyrw �args�keywords)r r_ r{ � matched_text�f_name�a_tree� args_list� kwargs_listr r6 r �_string_to_substitute� s � �z engine._string_to_substitute�textc s\ �j }�j�j�j�j�j�j�j�j�j�j �j �j d� � t � � �fdd�|�}|�_ |S )a) Perform inflections in a string. e.g. inflect('The plural of cat is plural(cat)') returns 'The plural of cat is cats' can use plural, plural_noun, plural_verb, plural_adj, singular_noun, a, an, no, ordinal, number_to_words, and prespart ) r: � plural_adj� plural_noun� plural_verb� singular_nounr� r� r� �ordinal�number_to_words�present_participlerj c s �� | � �S r/ )r� )r_ �r{ r r r �<lambda> s z engine.inflect.<locals>.<lambda>)r- r: r� r� r� r� r� r� r� r� r� rj � FUNCTION_CALLr] )r r� �save_persistent_count�outputr r� r �inflect� s& ��zengine.inflectr c C s t |�}d|v rL|�d�}t|d �d��t|d �d��kr-|�d�| jd �d�}n$|�d�}t|�D ]\}}d|v rJ|�d�| jd ||< q6n|�d�}t|�d��D ]%\}}|dkraqX|�� |kro|| �� ||< ||�� kr}|| �� ||< qXd�|�S )Nr. r r r r rz )r% r r< r, � enumerate� capitalize�upperr5 )r r � inflected� word_options�resultr r� r r r � postprocess s* $ �� � zengine.postprocess�Tuple[str, str, str]c C s. t �|�}|r|�d�|�d�|�d�fS dS )Nr r� r� )r� r� r� )�PARTITION_WORDrZ �group)r r� r_ r r r �partition_word9 s zengine.partition_word� Optional[Union[str, int, Any]]c C sT | � |�\}}}|s |S | �|| �||�p | �||�p | �||��}|� |� |� �S )z� Return the plural of text. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. )r� r� �_pl_special_adjective�_pl_special_verb�_plnoun�r r� rg �prer� �postr: r r r r: @ s � �z engine.pluralc C s< | � |�\}}}|s |S | �|| �||��}|� |� |� �S )a Return the plural of text, where text is a noun. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. )r� r� r� r� r r r r� X s zengine.plural_nounc C sH | � |�\}}}|s |S | �|| �||�p| �||��}|� |� |� �S )a Return the plural of text, where text is a verb. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. )r� r� r� �_pl_general_verbr� r r r r� m s �zengine.plural_verbc C s@ | � |�\}}}|s |S | �|| �||�p|�}|� |� |� �S )a Return the plural of text, where text is an adjective. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. )r� r� r� r� r r r r� � s zengine.plural_adj�word1�word2�Union[str, bool]c s6 � j � j� jf}� ��fdd�|D �}ttd|�d�S )a� compare word1 and word2 for equality regardless of plurality return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise >>> compare = engine().compare >>> compare("egg", "eggs") 's:p' >>> compare('egg', 'egg') 'eq' Words should not be empty. >>> compare('egg', '') Traceback (most recent call last): ... typeguard.TypeCheckError:...is not an instance of inflect.Word c 3 s � | ] }� � ��|�V qd S r/ )�_plequal)r1 �norm�r r� r� r r r4 � s � z!engine.compare.<locals>.<genexpr>NF)r� r� r� �next�filter)r r� r� �norms�resultsr r� r �compare� s zengine.comparec C � | � ||| j�S )az compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as nouns return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise )r� r� r� r r r � compare_nouns� � zengine.compare_nounsc C r� )az compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as verbs return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise )r� r� r� r r r � compare_verbs� r� zengine.compare_verbsc C r� )a compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as adjectives return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise )r� r� r� r r r � compare_adjs� r� zengine.compare_adjs� Optional[Union[int, str, Any]]�Union[str, Literal[False]]c C sP | � |�\}}}|s |S | j|||d�}|dur&| �||�}|� |� |� �S dS )a� Return the singular of text, where text is a plural noun. If count supplied, then return the singular if count is one of: 1, a, an, one, each, every, this, that or if count is None otherwise return text unchanged. Whitespace at the start and end is preserved. >>> p = engine() >>> p.singular_noun('horses') 'horse' >>> p.singular_noun('knights') 'knight' Returns False when a singular noun is passed. >>> p.singular_noun('horse') False >>> p.singular_noun('knight') False >>> p.singular_noun('soldier') False �rg r� F)r� �_sinounr� ) r r� rg r� r� r� r� r� r: r r r r� � s ! zengine.singular_nounc C s� | j �� }t�� | _ ||krdS |||�krdS ||�|kr dS t�� | _ |||�kr-dS ||�|kr5dS |�� | _ || jksD|| jkrT| �||�rLdS | �||�rTdS || jks^|| jkrf| �||�rfdS dS )N�eqzp:szs:pzp:pF) r, r� rb rc r: r� �_pl_check_plurals_Nr� �_pl_check_plurals_adj)r r� r� r` �classvalr r r r� s. zengine._plequal�pair�stems�end1�end2rD c C s4 d|� d|� d|� d|� d|� d� }t t�||��S )Nr z)(z\|\1r. r' )rD rP rZ )r r� r� r� r� rI r r r �_pl_reg_plurals+ s $zengine._pl_reg_pluralsc s� t ddftddftddftddftd d ftd d ftd d ftdd ftddft ddft dd ft ddfddddf}t t ||f�}d�dd� |D ��� � t�� v pd� t�� v pd� t�� v pdt� �fdd�|D ��S )N�asr� r� r� r$ r� �ensr� �umsr� r� r �ons�os�exesr �ixesr )z.*eaur$ �x)z.*ieur$ r� )z.*tri�xes�ces)z .{2,}[yia]nr� �gesr. c s s � | ]}|j V qd S r/ )r )r1 r� r r r r4 D s � z-engine._pl_check_plurals_N.<locals>.<genexpr>c 3 s& � | ]\}}}�� � |||�V qd S r/ )r� )r1 r� r� r� �r� r r r r4 J s � � �)� pl_sb_C_a_ata�pl_sb_C_is_ides� pl_sb_C_a_ae�pl_sb_C_en_ina� pl_sb_C_um_a� pl_sb_C_us_i� pl_sb_C_on_a�pl_sb_C_o_i_stems�pl_sb_C_ex_ices�pl_sb_C_ix_ices� pl_sb_C_i� pl_sb_C_im�mapr r5 �pl_sb_irregular_s�values�pl_sb_irregular�pl_sb_irregular_caps�any)r r� r� � stem_endingsr, r r� r r� / s8 � � ���zengine._pl_check_plurals_Nc C sh |� d�r|d |�d�� nd}|� d�r |d |�d�� nd}t|�o3t|�o3| �||�p3| �||�S )N)z's�'r� r� )�endswith�rfindrD r� )r r� r� �word1a�word2ar r r r� P s � �z engine._pl_check_plurals_adj�Optional[Union[str, int]]�Union[str, int]c C s^ |d u r | j d ur | j }|d ur+t|�tv s#| jd r't|��� tv r'd}|S d}|S d}|S )Nr� r r� r� )r- r% � pl_count_oner, r � pl_count_zero)r rg r r r � get_count] s ��� �� �zengine.get_countc C s* | � |�}|dkr |S | �|| j�}|d ur|S |dkr |S t|�}|j�� tv r;t|j�dkr9| j |dd�p8|S |S |t v rA|S t � � D ]\}}|j | d � |v rW| S qE| jd rf|j�� tv rf|S t�|�}|r�|�d�dkr�| �|�d�d�� |�d�� �S d|j v s�d|j v r�t�|�}|r�|�d�dkr�|�d�dkr�| �|�d�d�� |�d�� | �|�d��� �S t|j�dkr�| j |dd�}|d ur�|S t�|j �}|r�t|�d ��}| �|d |� �� ||d � � �S t|j�dk�r|jd d k�rd �| �|j�g|jdd � �S t�t�� | �|j t j | jdd�d �W d � S 1 �s/w Y t � � D ]O\}}|j | d � |v �r�t � � D ]:\} } |j d | � | v �r�|j � � |j d | � |j | d � gk�r�|j d | � t!|j | d � S �qK�q8zt"|j W S t#�y� Y nw zt!|j W S t#�y� Y nw |jt$v �r�t|j�} |d | � � t$|j � �S |j�� } | t%v �r�t| �} |d | � � t%| � �S |j � d �} d �| d d � ��� t&v �rtd �| d d � ��} |d | � � t&d �| d d � ��� � �S |j dd � dk�r&|d d� � d�S |j dd � dk�rD| jd �r;|� d�S |d d� � d�S |j dd � dk�r�t'� � D ]\}}|j | d � |v �rh|� d� S �qRt(� � D ]\}}|| d � |v �r�|� d� S �qn|d d� � d�S |j dd � dk�r�|d d� � d �S |j dd � d k�r�t)�*t|��}|�r�|j |v �r�|d d� � d �S |� d�S |j dd � d k�r�|d d� � d �S |j dd � d!k�r�|d d� � d"�S |j dd � d#k�r|d d� � d$�S |j dd � d%k�r|d d� � d&�S |j d'k�r d(S |j dd � d)k�r)|S |j dd � d*k�r<|d d � � d+�S |j dd � d,v �rO|d d � � d-�S d.t+d dfd/t,d d0fd/t-d d0fd1t.d d+fdt/d d2fd3t0d d+fd+t1d d4ffD ]0\}}}}|j d |k�r�|� � D ] \}}|j | d � |v �r�|d |� | S �q��qt| jd5 �r�|j dd � d6k�r�|d d� � d7�S |j dd � d8v �r�|� d/�S |j dd � d9v �r�t|�d:k�r�|d d� � d;�S d3t2d d<fd/t3d d0fd/t4d d0fd1t5d d+fdt6d d2fdt7d dfd+t8d d4fd+t9d d=fdt:dd>fd?t;dd2fd3t<d d+ff D ]0\}}}}|j d |k�rO|� � D ] \}}|j | d � |v �rM|d |� | S �q2�q t=d d2ft>d d@ffD ]'\}}}|� � D ] \}}|j | d � |v �r|d |� | S �qd�q[| t?v �r�|� d-�S t@� � D ]\}}|j | d � |v �r�|� d-� S �q�|j d d � d-k�r�|dA |dA �A� k�r�|� d-�S |j d dBk�r�tB� � D ]\}}|j | d � |v �r�|� d-� S �q�|j d d� dBk�r�|� dC�S |j d d � dDk�r tC� � D ]\}}|j | d � |v �r|� d� S �q|j d d � dEv �s.|j d d/k�r3|� d-�S |j dd � dFv �rF|d d� � dG�S |j dd � dHk�rc|j dd� dIk�rc|d d� � dG�S |j dd � dJv �rv|d d � � dG�S |j dd � dKk�r�|d d� � dG�S |j d dLk�r�|j d d� dMv �s�t|�dk�r�|� d�S | jdN �r�|j d dLk�r�|dA |dA �A� k�r�|� d�S |d d� � d�S | tDv �r�|� d�S tE� � D ]\}}|j | d � |v �r�|� d� S �q�|j d d � dOv �r|� d�S |j d d?k�r|� d-�S |� d�S )PNr r� r� r� �rg r z a z-a-� denominatorr� �degreer �-����quyr4 �ies����personr r$ ����ople�man�men����mouse�micer r �goose�geese�tooth�teeth�foot�feet�taco�tacos�die�dice�ceps�zoonr� )�cis�sis�xisr� �hr� r �mr rr r� r �trixr� )�eau�ieu)�ynx�inx�anxr� r� r� �ta�des�or r �z�zes�ze)�ch�sh�zzr� )�elf�alf�olf�ves�eaf�d)�nife�life�wife�arfr �aeiour )�ao�eo�io�oo�uo)Fr� ra r/ r r r �pl_sb_uninflected_completer< r �_handle_long_compounds�pl_sb_uninflected_caps�pl_sb_uninflected_bysizerd r r, �pl_sb_uninflected_herd�PL_SB_POSTFIX_ADJ_STEMS_RErZ r� r� �PL_SB_PREP_DUAL_COMPOUND_RE� DENOMINATORr5 r� � contextlib�suppressri � _handle_prepositional_phrase� functools�partial�pl_pron_acc_keys_bysize�pl_prep_bysizer � pl_pron_acc� pl_pron_nomr� r� r� �pl_sb_irregular_compound�pl_sb_U_man_mans_bysize� pl_sb_U_man_mans_caps_bysize�pl_sb_U_louse_lice_bysize�get�pl_sb_U_ch_chs_bysize�pl_sb_U_ex_ices_bysize�pl_sb_U_ix_ices_bysize�pl_sb_U_um_a_bysize�pl_sb_U_us_i_bysize�pl_sb_U_on_a_bysize�pl_sb_U_a_ae_bysize�pl_sb_C_en_ina_bysize�pl_sb_C_ex_ices_bysize�pl_sb_C_ix_ices_bysize�pl_sb_C_um_a_bysize�pl_sb_C_us_i_bysize�pl_sb_C_us_us_bysize�pl_sb_C_a_ae_bysize�pl_sb_C_a_ata_bysize�pl_sb_C_is_ides_bysize�pl_sb_C_o_i_bysize�pl_sb_C_on_a_bysize�pl_sb_C_i_bysize�pl_sb_C_im_bysize�pl_sb_singular_s_complete�pl_sb_singular_s_bysizer� �pl_sb_z_zes_bysize�pl_sb_ze_zes_bysize�pl_sb_U_o_os_complete�pl_sb_U_o_os_bysize)r r� rg rw r� r� r_ � handled_wordsr �pk�pv�llen� lowered_last� dash_split�lastletr& �numendr� r r r r� r s� � ��� " " �"� �,� � � ��� �� � �� " � ����� �* � �$ (" & � zengine._plnounc C s� |� |�}t|�dk rtd��| �|t�}|||d �p"||d }d�|d|d � |�||| dg�g �d�||d d� � S )a� Given a word or phrase possibly separated by sep, parse out the prepositional phrase and apply the transform to the word preceding the prepositional phrase. Raise ValueError if the pivot is not found or if at least two separators are not found. >>> engine._handle_prepositional_phrase("man-of-war", str.upper, '-') 'MAN-of-war' >>> engine._handle_prepositional_phrase("man of war", str.upper, ' ') 'MAN of war' r� z2Cannot handle words with fewer than two separatorsr r Nr� )r r< ri � _find_pivot�pl_prep_list_dar5 )�cls�phrase� transform�sep�parts�pivot� transformedr r r r; � s $��z#engine._handle_prepositional_phraser �Union[str, None]c s: � dkr| j n| j�� �fdd�t|jd�D �}t|d�S )aS Handles the plural and singular for compound `Words` that have three or more words, based on the given count. >>> engine()._handle_long_compounds(Words("pair of scissors"), 2) 'pairs of scissors' >>> engine()._handle_long_compounds(Words("men beyond hills"), 1) 'man beyond hills' r c 3 s@ � | ]\}\}}}|t v rd �t�|�|� �|g|��V qdS �r N)rj r5 � itertools�chain)r1 �leader�cand�prep�trailer�rg � inflectionr r r4 � s � � ���z0engine._handle_long_compounds.<locals>.<genexpr>r� N)r� r� r r r� )r r� rg � solutionsr rz r r2 � s � z engine._handle_long_compoundsc sF � �fdd�t dt��d �D �}zt|�W S ty" td�d �w )Nc 3 s � | ] }�| � v r|V qd S r/ r )r1 r �� candidatesr, r r r4 � s � �z%engine._find_pivot.<locals>.<genexpr>r zNo pivot found)rY r< r� � StopIterationri )r, r~ �pivotsr r} r ri � s � �zengine._find_pivotc C s | j d rt|��� tv rdS | �|�}|dkr|S | �|| j�}|d ur'|S zt|�}W n ty7 Y dS w |j t v rMt |j � |t |j �d � � �S |j t v rT|S |j � d�rx|j d d� t v rxt |j d d� � d|t |j �d � � �S |j � d�r�|S t�|�}|r�dS t�|�r�dS |jdkr�dS |jdd � d v s�|jdd � d kr�|d d � S |jdd � d kr�t |�d kr�|jd d� d S |j�� tv s�|jdd � tv s�|jdd � tv r�|d d� S |j� d�r�t |�d kr�|jd d � S t�|�}|�r|�d�S dS )Nr� Fr zn'tr� �quizzes�quizr� )�ches�shes�zzes�ssesr� r� r� r� r r� r4 �oes)r, r% r r� r� ra r0 r � IndexErrorr� �plverb_irregular_presr< �plverb_irregular_non_presr� �PLVERB_SPECIAL_S_RErZ � WHITESPACEr r � pl_v_oes_oe�pl_v_oes_oe_endings_size4�pl_v_oes_oe_endings_size5� ENDS_WITH_Sr� )r r� rg rw r, r_ r r r r� � s\ � �� zengine._pl_special_verbc C sZ | � |�}|dkr |S t�|�}|r"t|�d��� � |�d�� �S t�|�}|r+|S |S )Nr r� )r� �plverb_ambiguous_pres_keysrZ �plverb_ambiguous_presr� r �plverb_ambiguous_non_pres)r r� rg r_ r r r r� ! s zengine._pl_general_verbc C s� | � |�}|dkr |S | �|| j�}|d ur|S t�|�}|r(t|�d��� S t�|�}|r8t |�d��� S t �|�}|rX| � |�d��}|d dkrOdnd}|� d|� �S dS )Nr r4 r$ r� r� F) r� ra r1 �pl_adj_special_keysrZ �pl_adj_specialr� r �pl_adj_poss_keys� pl_adj_poss�ENDS_WITH_APOSTROPHE_Sr� )r r� rg rw r_ r` � trailing_sr r r r� 9 s$ z engine._pl_special_adjectivec C s� | � |�}|dkr |S z|d u r| j}n|tvrt�W n ttfy, } zt|�d }~ww | �|| j�}|d ur:|S |dkr@|S |tv rJ|d d� S t |�}|j � � t v rgt |j�dkre| j|dd�pd|S |S |tv rm|S t�� D ]\}}|j| d � |v r�| S qq| jd r�|j � � tv r�|S |j � � tv r�| jd r�|S d S t�|�} | r�| �d�dkr�| j| �d�d|d �� | �d�� �S t� t �� | � |jt j | jd|d �d �W d � S 1 s�w Y t� t �� | � |jt j | jd|d �d �W d � S 1 �sw Y t!�� D ]Q\}}|j| d � |v �r_t"�� D ]<\} } |jd | � | v �r]|j�#� |jd | � |j| d � gk�r]|jd | � t$d|j| d � |� S �q"�qzt$d|j|�W S t%�ys Y nw zt$d|j|�W S t%�y� Y nw |j t&v �r�t |j �} |d | � � t&|j � �S |j � � t'v �r�t |j � � �} |d | � � t'|j � � � �S |j�#d �} d �(| dd � �� � t)v �r�t d �(| dd � ��} d�*|d | � t)d �(| dd � �� � �S |jdd � dk�r|d d� d S |jdd � dk�r|d d� S |jdd � dk�r(|d d� d S |jdd � d k�rkt+�� D ]\}}|j| d � |v �rM|d d� S �q6t,�� D ]\}}|| d � |v �ri|d d� S �qS|jdd � d k�r}|d d� d S |jdd � d k�r�|d d� d S |jdd � d!k�r�t-�.t |��}|�r�|j|v �r�|d d� d" S |jdd � d#k�r�|d d� d$ S |jdd � d%k�r�|d d� d& S |jdd � d'k�r�|d d� d( S |jd)k�r�d*S |jdd � d+k�r�|S |jdd � d,k�r |d d� d- S d.t/ddfd.t0dd/fd.t1dd0fd1t2dd2fd3t3dd4fd1t4dd-fd5t5ddffD ]0\}}}}|jd |k�ra|�� D ] \}}|j| d � |v �r_|d |� | S �qD�q2| jd �r|jdd � d6k�r{|d d� d7 S |jdd � d8v �r�|d d� S |jdd � d9v �r�t |�d:k�r�|d d� d7 S d1t6dd;fd.t7dd/fd.t8dd0fd1t9dd2fd3t:dd4fd.t;d dfd5t<ddfd1t=ddfd.t>dd.fd3t?dd<fd1t@dd-fd=tAddfd3tBddff D ]0\}}}}|jd |k�r|�� D ] \}}|j| d � |v �r|d |� | S �q��q�|jdd � d>k�s/|tCv �s/|j � � tDv �r5|d d� S |tEv �sB|j � � tFv �rH|d d� S |jdd � d?k�s_|tGv �s_|j � � tHv �re|d d� S |tIv �sr|j � � tJv �rx|d d� S |j � � tKv �r�|d d� S tL�� D ]\}}|j| d � |v �r�|d d� S �q�|jdd � d@k�r�|dA |dA �M� k�r�|d d� S |j � � tNv �r�|d d� S |j � � tOv �r�|d d� S |jdd � dBk�r�|d d� S |tPv �s�|j � � tQv �r�|d d� S |jdd � dCv �r |d d� S |j � � tRv �r|d d� S |jdd � dDk�r+|d d� S |tSv �s8|j � � tTv �r>|d d� S |jdd � dEk�r�|jdd� dFv �rZ|d d� dG S |jdd� dHk�ru|dd� dIk�ru|d d� dG S |jdd� dJv �r�|d d� dK S |jdd� dLk�r�|d d� dG S |jdd � dMk�r�t |j�dk�r�|jd dNv �r�|d d� S | jdO �r�|jdd � dMk�r�|dA |dA �M� k�r�|d d� S |jdd � dPk�r�|d d� d S |jdd � dQk�r1|j � � tUv �r|d d� S tV�� D ]\}}|j| d � |v �r |d d� S �q|jdd � dRv �r1|d d� S |jdd � dSk�rA|d d� S |tWv �rN|d d� dT S |jd d.k�r\|d d� S d S )UNr� r� r4 r� r r� r r F)r� r� r r� r rx r� z{}{}r� �quiesr� r i����r r� �peopler� �rson�mansr� r� r r� r r r r r r r r r r r �zoa�onr$ �ex�ixr� �umr r� r� �tricesr� )�eaux�ieux)�ynges�inges�angesr� �enr r �housesr� �esesr r� )r� r� r� r$ )�el�al�ol�f�ear& )�ni�li�wi�fe�ar�ysr+ r r� r� )�aos�eos�ios�oos�uosr� r� )Xr� r4 rk r# r� r� ra r2 �si_sb_ois_oi_caser r r r1 r< r r2 r3 r4 rd r r, r5 � pl_sb_C_us_usr6 rZ r� r� r9 r: ri r; r< r= �si_pron_acc_keys_bysizer? r r� r� �si_sb_irregular_caps�si_sb_irregularr5 �si_sb_irregular_compound�format�si_sb_U_man_mans_bysize� si_sb_U_man_mans_caps_bysize�si_sb_U_louse_lice_bysizerF �si_sb_U_ch_chs_bysize�si_sb_U_ex_ices_bysize�si_sb_U_ix_ices_bysize�si_sb_U_um_a_bysize�si_sb_U_us_i_bysize�si_sb_U_on_a_bysize�si_sb_U_a_ae_bysize�si_sb_C_en_ina_bysize�si_sb_C_ex_ices_bysize�si_sb_C_ix_ices_bysize�si_sb_C_um_a_bysize�si_sb_C_us_i_bysizerS �si_sb_C_a_ae_bysize�si_sb_C_a_ata_bysize�si_sb_C_is_ides_bysize�si_sb_C_o_i_bysize�si_sb_C_on_a_bysize�si_sb_C_im_bysize�si_sb_C_i_bysize�si_sb_uses_use_case�si_sb_uses_use�si_sb_ies_ie_case� si_sb_ies_ie�si_sb_oes_oe_case� si_sb_oes_oe�si_sb_sses_sse_case�si_sb_sses_sse�si_sb_singular_s_complete�si_sb_singular_s_bysizer� � si_sb_z_zes� si_sb_zzes_zz�si_sb_ches_che_case�si_sb_ches_che� si_sb_xes_xe�si_sb_ves_ve_case� si_sb_ves_ve�si_sb_U_o_os_complete�si_sb_U_o_os_bysize� si_sb_es_is)r r� rg r� rS rw r, r� r� r_ rb rc rd rf rg r& � unass_numendr� � class_numendr r r r� ^ s� ��� � $ � � �"� ����� � � �� � �� " ��� �* & * � zengine._sinounr c C sT t �|�}|r(|�d�}|s|S |�d�}|�d�}| �||�}|� |� |� �S dS )a Return the appropriate indefinite article followed by text. The indefinite article is either 'a' or 'an'. If count is not one, then return count followed by text instead of 'a' or 'an'. Whitespace at the start and end is preserved. r� r r� r� )�INDEFINITE_ARTICLE_TESTrZ r� �_indef_article)r r� rg r_ r� r� r� r� r r r r� � s zengine.ar� r� �Union[int, str, Any]c sl | � |�}|dkr|� d� � �S | �� | j�}|d ur"|� d� � �S � fdd�| jD �}d� � �}t||�S )Nr r c 3 s, � | ]\}}|� � �r|� d � � �V qdS rs )rZ )r1 �regexen�article�r� r r r4 � s � � �z(engine._indef_article.<locals>.<genexpr>za )r� ra r3 �_indef_article_casesr� )r r� rg �mycountrw �matches�fallbackr r� r r� � s � zengine._indef_article�Optional[Union[int, str]]c C s� |du r | j dur | j }|du rd}t�|�}|r)|�d�}|�d�}|�d�}nd}d}d}t|��� tv r9d}|� |� d| �||�� |� �S ) a� If count is 0, no, zero or nil, return 'no' followed by the plural of text. If count is one of: 1, a, an, one, each, every, this, that return count followed by text. Otherwise return count follow by the plural of text. In the return value count is always followed by a space. Whitespace at the start and end is preserved. Nr r r� r� r� r� r )r- r� rZ r� r% r r� r: )r r� rg r_ r� r� r� r r r r� � s z engine.noc C sJ | � |d�}|}tD ]\}}|�||�\}}|r |� d� S q |� d�S )zi Return the present participle for word. word is the 3rd person singular verb. r� �ing)r� � PRESENT_PARTICIPLE_REPLACEMENTS�subn)r r� �plv�ansr� �replrj r r r r� s � zengine.present_participlerj �Union[Number, Word]c C s� t �t|��r_t|ttf�rt|�|krt|�}n(dt|�v r=z tt|�d �}W n ty< tt|�dd� �}Y nw t|�}zt|d }W n tyX t|d }Y nw |� |� �S | � |�S )z� Return the ordinal of num. >>> ordinal = engine().ordinal >>> ordinal(1) '1st' >>> ordinal('one') 'first' �.r4 N�d � ) �DIGITrQ r% r$ �floatr; ri �nthr� �_sub_ord)r rj rr r� r r r r� / s" � � zengine.ordinalr �indc C s |t t�d kr t�t| S r# )r< �millr )r r r r r �millfnP s z engine.millfn�units�mindexc C s t | � | �|�� �S r/ )�unitr )r r r r r r �unitfnU r& z engine.unitfnc C s\ |dkr$t | }|r|rd}nd}t| }| �|�}|� |� |� |� �S t| � t| � �S )Nr r� r� )r� r r �teenr )r �tensr r � tens_part�hyphen� unit_part� mill_partr r r �tenfnX s z engine.tenfn�hundredsr c C st |r&|s|rd| j d � d�nd}t| � d|� | �||�� | �|�� d�S |s*|r8| �||�� | �|�� d�S dS )Nr �andwordr� z hundred�, )r7 r r r )r r r r r r r r r �hundfnd s ��� z engine.hundfnc C sL t |�d��}|dkrd| jd � d�S |r t| � d�S d| jd � d�S )Nr r r� r r� )r; r� r7 r �r r_ r r r r � group1subp s zengine.group1subc C s2 t |�d��}|rt| � d�S d| jd � d�S )Nr r r r� )r; r� r r7 r r r r � group1bsuby s zengine.group1bsubc C sp t |�d��}t |�d��}|r| �||�� d�S |r)d| jd � dt| � d�S d| jd � d| jd � d�S )Nr r� r r r� )r; r� r r7 r )r r_ r r r r r � group2sub� s zengine.group2subc C s� t |�d��}t |�d��}t |�d��}|dkr"d| jd � �}n|r+tt| �}nd| jd � �}|r<| �||�}n |rLd| jd � dt| � �}nd| jd � d| jd � �}|� d|� d�S )Nr r� r� r r� r� r )r; r� r7 r% r r )r r_ r r r �hunword�tenwordr r r � group3sub� s zengine.group3subc C sB | � t|�d��t|�d��t|�d��| j�}| jd7 _|S )Nr r� r� )r r; r� r. )r r_ �retr r r �hundsub� s (�zengine.hundsubc C s* | � t|�d��t|�d��| j�� d�S )Nr r� r )r r; r� r. �r r_ r r r �tensub� s *z engine.tensubc C s | � t|�d��| j�� d�S )Nr r )r r; r� r. r# r r r �unitsub� s zengine.unitsubr� c C s |dkr t �| j|�}|S |dkr"t�| j|�}t �| j|d�}|S |dkr?t�| j|�}t�| j|d�}t �| j|d�}|S t|�dkrL| j d }|S t|�dkrY| j d }|S |� � � d�}d| _ t � |�}|ryt �| j|d�}t � |�}|sjt�| j|d�}t�| j|d�}|S )Nr r� r� r r� r� r� )� DIGIT_GROUPr] r � TWO_DIGITSr r � THREE_DIGITSr r; r7 �lstripr. �THREE_DIGITS_WORDrZ r" �TWO_DIGITS_WORDr$ �ONE_DIGIT_WORDr% )r rj r� r_ r r r �enword� s8 �� � � � �z engine.enwordc C s t �dd� | �}|d|| k S )Nc S s t | �d� S r# )r� r� )rQ r r r r� � s z!engine._sub_ord.<locals>.<lambda>r� )� ordinal_suffr] )r �newr r r r � s zengine._sub_ordc C s2 |r|dkrdnd}|� d|�}n|g}| �|�S )Nr r4 r r )r �_remove_last_blank)rk rj �decimalr� � max_split�chunksr r r � _chunk_num� s zengine._chunk_numc C s( | d dk}|r| dd� n| }||fS )z� Remove the last item from chunks if it's a blank string. Return the resultant chunks and whether the last item was removed. r4 r� Nr )r3 �removedr� r r r r0 � s zengine._remove_last_blankc C s ddd�� | �� d d�S )N�plus�minus)�+r� r r� )rF r) )rj r r r � _get_sign� s zengine._get_signF�,�andr� r� �point�wantlist�comma�Union[Falsish, str]r r1 � threshold�Union[str, List[str]]c s� � ||d��_ t|�}| durLt|�| krL|�dd�} |r0t�d| d �\| d< } | dkr.n|s z | d � d| d � �W S tyK t| d � Y S w �dk sT�dkrVt���|�} |t v ra|}|dd� t v } | rq|dd� }�� ||��\}}|d d k}| �� ���fd d �}t |||d� �||d�< g }�dkr�|d �|� d ��}| r�|r��� |d �|d < |dd� D ]}|� |� |�|�|� d ��� q�|r�|� |� |r�| gt| � | S | r�| � d �nd }�r�d�|�n d ���|||��}|| S )a� Return a number in words. group = 1, 2 or 3 to group numbers before turning into words comma: define comma andword: word for 'and'. Can be set to ''. e.g. "one hundred and one" vs "one hundred one" zero: word for '0' one: word for '1' decimal: word for decimal point threshold: numbers above threshold not turned into words parameters not remembered from last call. Departure from Perl version. )r r� r� Nr r z\1,\2r r� r� r� c s� t �d| �} | dkr d} �dkr�s��| d�} n��| ��} | dd � dkr-| d d� } t�d| �} �dkrC�rCt�d� � d �| �} t�d| �} | �� } �rQd �| S ) Nr� r� r r r� r r: r z \1)� NON_DIGITr] r- �WHITESPACES_COMMA� COMMA_WORD� WHITESPACES�strip)�chunk�r r� r� r r r � _handle_chunk s z-engine.number_to_words.<locals>._handle_chunkr r4 r )r7 r% r r �FOUR_DIGIT_COMMAr� r� r r9 �nth_suffr4 r� r �appendr> rD r5 �_render)r rj r= r� r> r r� r� r1 r@ �spnumrr �sign�myordr3 � finalpoint� loopstartrI � numchunksrG �signout�valoutr rH r r� � sZ � � ��zengine.number_to_wordsc c sX � | � d�}|V |d u p|�|� }| D ]}||kr d}n|r#|V d|� �V qd S )Nr Fr )�popr� )r3 r1 r> � first_itemr� �ncr r r rM U s � �zengine._renderTr, �Optional[Sequence[Word]]rn � sep_spaced� final_sep�conj� conj_spacedc C s� |sdS t |�dkr|d S |r |dkrd}nd|� d�}t |�dkr/|d � |� |d � �S |du r?dd�|�v r=d}nd}|du rE|}|� |� �}|rQ|d7 }|�|dd � �� |� |d � �S ) a� Join words into a list. e.g. join(['ant', 'bee', 'fly']) returns 'ant, bee, and fly' options: conj: replacement for 'and' sep: separator. default ',', unless ',' is in the list then ';' final_sep: final separator. default ',', unless ',' is in the list then ';' conj_spaced: boolean. Should conj have spaces around it r� r r r r� Nr: �;r4 )r< r5 )r r, rn rZ r[ r\ r] r r r r5 a s( "z engine.joinr )r8 r9 r: r9 r& r; )rA r9 rB r9 rC r9 rD r9 rE r9 rF r9 r& r; )rI r9 r& r; )rI r9 r& r )r� r' rT rU r& rV )NN)rg r+ rh r+ r& r% )r� r% r& r )r_ r r{ r| r& r% )r� r' r& r% )r r% r& r% )r� r% r& r� r/ )r� r' rg r� r& r% )r� r' r� r' r& r� )r� r' rg r� r� rV r& r� )r� r% r� r% r& r� ) r� r% r� r% r� r% r� r% r& rD )r� r% r� r% r& rD )rg r� r& r� )r� r% rg r� r& r% )r� r rg r; r& rr )r� r% rg r� r& r� )r� r% rg r� r� rV r& r� )r )r� r' rg r� r& r% )r� r% rg r� r& r% )r� r' rg r� r& r% )r� r' r& r% )rj r r& r% )r )r r; r& r% )r r; r r; r& r% �r& r% ) r r; r r; r r; r r; r& r% )r_ r r& r% )rj r% r� r; r& r% )Fr r: r; r� r� r< N)rj r r= rD r� r; r> r? r r% r� r% r� r% r1 r? r@ r+ r& rA )NTNr; T)r, rY rn rV rZ rD r[ rV r\ r% r] rD r& r% )]r r r r �propertyr7 �setterr r@ rG rH rM rO r< r= ra rf rj r� rn r� r� r� r� r: r� r� r� r� r� r� r� r� r� r� r� r� r� r� � classmethodr; r2 � staticmethodri r� r� r� r� r� r� � A_ordinal_a� A_ordinal_an� A_explicit_an� SPECIAL_AN� SPECIAL_A�A_abbrev�SPECIAL_ABBREV_AN�SPECIAL_ABBREV_A� CONSONANTS�ARTICLE_SPECIAL_EU�ARTICLE_SPECIAL_ONCE�ARTICLE_SPECIAL_ONETIME�ARTICLE_SPECIAL_UNIT�ARTICLE_SPECIAL_UBA�ARTICLE_SPECIAL_UKR� A_explicit_a�SPECIAL_CAPITALS�VOWELS�A_y_consr� r� r� r� r� r r r r r r r r r" r$ r% r- r r4 r0 r9 r� rM r5 r r r r r* � s& # � ' ��� � ) ! � # �S � �( � I� % �r �r* )r$ r% r& r% )r N)r* r+ r, r- r& r% )r, r7 r& r8 r )r@ r7 rA r% rB r+ rC rD r_ (= r( � __future__r rp r9 r9 r< rt rP �numbersr �typingr r r r r r r r r r r r r �more_itertoolsr � typeguardr � compat.py38r � Exceptionr r r r r! r" r# r) r6 r? rK r� r� �updater� rB rd r� �listr� r �k1�k2r� r� �pl_sb_z_zes_listr] �pl_sb_ze_zes_listr^ �pl_sb_C_is_ides_complete�pl_sb_C_is_ides_endingsr� �pl_sb_C_is_ides_list�si_sb_C_is_ides_listr� rV �pl_sb_C_a_ata_list�si_sb_C_a_ata_listr� rU r� �pl_sb_U_a_ae_list�si_sb_U_a_ae_listr� rM � pl_sb_U_a_ae�pl_sb_C_a_ae_list�si_sb_C_a_ae_listr� rT r� �pl_sb_C_en_ina_list�si_sb_C_en_ina_listr� rN r� �pl_sb_U_um_a_list�si_sb_U_um_a_listr� rJ � pl_sb_U_um_a�pl_sb_C_um_a_list�si_sb_C_um_a_listr� rQ r� �pl_sb_U_us_i_list�si_sb_U_us_i_listr� rK � pl_sb_U_us_i�pl_sb_C_us_i_list�si_sb_C_us_i_listr� rR r� r� rS �pl_sb_U_on_a_list�si_sb_U_on_a_listr� rL � pl_sb_U_on_a�pl_sb_C_on_a_list�si_sb_C_on_a_listr� rX r� � pl_sb_C_o_irW r� r� r_ r� �pl_sb_U_o_os_endingsr` r� �pl_sb_U_ch_chs_list�si_sb_U_ch_chs_listr� rG �pl_sb_U_ch_chs�pl_sb_U_ex_ices_list�si_sb_U_ex_ices_listr� rH �pl_sb_U_ex_ices�pl_sb_U_ix_ices_list�si_sb_U_ix_ices_listr� rI �pl_sb_U_ix_ices�pl_sb_C_ex_ices_list�si_sb_C_ex_ices_listr� rO r� �pl_sb_C_ix_ices_list�si_sb_C_ix_ices_listr� rP r� �pl_sb_C_i_list�si_sb_C_i_listr� rY r� �pl_sb_C_im_list�si_sb_C_im_listr� rZ r� �pl_sb_U_man_mans_list�pl_sb_U_man_mans_caps_list�si_sb_U_man_mans_listr� rC �si_sb_U_man_mans_caps_listr� rD �pl_sb_U_louse_lice_list�si_sb_U_louse_lice_listr� rE � pl_sb_uninflected_s_complete�pl_sb_uninflected_s_endings�pl_sb_uninflected_sr5 r1 r3 �pl_sb_uninflected_endingsr4 r[ �pl_sb_singular_s_endingsr\ r� �si_sb_singular_s_endingsr� �pl_sb_singular_s_esr5 �pl_sb_singular_sr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �plverb_special_s�_pl_sb_postfix_adj_defnr r �pl_sb_postfix_adj_stemsr� � pl_prep_listrj r? �pl_prep�pl_sb_prep_dual_compoundrk rA ry r@ �pl_pron_acc_keysr> �_thecase�_plur�_gend�_singr� �si_pron_acc_keysr� r� r� r� �compiler[ r� r� r� r� r� r� r� r� r� r� r� r� �VERBOSEri rv rs rf re rd r r; r� rK �dictr� r. r r r� r r+ rb rc �string_to_constantr\ r� r� r6 r7 r8 r� r� r� r� r� rg rh rj rk rl rm rn ro rp rq rr rt ru r& r' r( r* r+ r, rJ rB rC rD rE r� r r% r �Falsish�_STATIC_TYPE_CHECKINGr' �typer! r* r r r r �<module> s� 6 < �'� �������� � � � � ��������������� � � � � �!� $� � �� ��� � � � � � &� � � � � E �� G � � � � � � ��� ���-��!� �!� $ ���� K ����� ��E� ������� � � � � ��������� �� �������� � � � � ����� �# �� ��$ � � � � ��� �� _vendor/inflect/py.typed 0000644 00000000000 15030122015 0011276 0 ustar 00 _vendor/inflect/compat/py38.py 0000644 00000000240 15030122015 0012245 0 ustar 00 import sys if sys.version_info > (3, 9): from typing import Annotated else: # pragma: no cover from typing_extensions import Annotated # noqa: F401 _vendor/inflect/compat/__pycache__/py38.cpython-310.pyc 0000644 00000000470 15030122015 0016611 0 ustar 00 o �h� � @ s2 d dl Z e jdkrd dlmZ dS d dlmZ dS )� N)� � )� Annotated)�sys� version_info�typingr �typing_extensions� r r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/inflect/compat/py38.py�<module> s _vendor/inflect/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000272 15030122015 0017545 0 ustar 00 o �h � @ s d S )N� r r r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/inflect/compat/__init__.py�<module> s _vendor/inflect/compat/__init__.py 0000644 00000000000 15030122015 0013173 0 ustar 00 _vendor/inflect/__init__.py 0000644 00000312564 15030122015 0011735 0 ustar 00 """ inflect: english language inflection - correctly generate plurals, ordinals, indefinite articles - convert numbers to words Copyright (C) 2010 Paul Dyson Based upon the Perl module `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_. methods: classical inflect plural plural_noun plural_verb plural_adj singular_noun no num a an compare compare_nouns compare_verbs compare_adjs present_participle ordinal number_to_words join defnoun defverb defadj defa defan INFLECTIONS: classical inflect plural plural_noun plural_verb plural_adj singular_noun compare no num a an present_participle PLURALS: classical inflect plural plural_noun plural_verb plural_adj singular_noun no num compare compare_nouns compare_verbs compare_adjs COMPARISONS: classical compare compare_nouns compare_verbs compare_adjs ARTICLES: classical inflect num a an NUMERICAL: ordinal number_to_words USER_DEFINED: defnoun defverb defadj defa defan Exceptions: UnknownClassicalModeError BadNumValueError BadChunkingOptionError NumOutOfRangeError BadUserDefinedPatternError BadRcFileError BadGenderError """ from __future__ import annotations import ast import collections import contextlib import functools import itertools import re from numbers import Number from typing import ( TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Literal, Match, Optional, Sequence, Tuple, Union, cast, ) from more_itertools import windowed_complete from typeguard import typechecked from .compat.py38 import Annotated class UnknownClassicalModeError(Exception): pass class BadNumValueError(Exception): pass class BadChunkingOptionError(Exception): pass class NumOutOfRangeError(Exception): pass class BadUserDefinedPatternError(Exception): pass class BadRcFileError(Exception): pass class BadGenderError(Exception): pass def enclose(s: str) -> str: return f"(?:{s})" def joinstem(cutpoint: Optional[int] = 0, words: Optional[Iterable[str]] = None) -> str: """ Join stem of each word in words into a string for regex. Each word is truncated at cutpoint. Cutpoint is usually negative indicating the number of letters to remove from the end of each word. >>> joinstem(-2, ["ephemeris", "iris", ".*itis"]) '(?:ephemer|ir|.*it)' >>> joinstem(None, ["ephemeris"]) '(?:ephemeris)' >>> joinstem(5, None) '(?:)' """ return enclose("|".join(w[:cutpoint] for w in words or [])) def bysize(words: Iterable[str]) -> Dict[int, set]: """ From a list of words, return a dict of sets sorted by word length. >>> words = ['ant', 'cat', 'dog', 'pig', 'frog', 'goat', 'horse', 'elephant'] >>> ret = bysize(words) >>> sorted(ret[3]) ['ant', 'cat', 'dog', 'pig'] >>> ret[5] {'horse'} """ res: Dict[int, set] = collections.defaultdict(set) for w in words: res[len(w)].add(w) return res def make_pl_si_lists( lst: Iterable[str], plending: str, siendingsize: Optional[int], dojoinstem: bool = True, ): """ given a list of singular words: lst an ending to append to make the plural: plending the number of characters to remove from the singular before appending plending: siendingsize a flag whether to create a joinstem: dojoinstem return: a list of pluralised words: si_list (called si because this is what you need to look for to make the singular) the pluralised words as a dict of sets sorted by word length: si_bysize the singular words as a dict of sets sorted by word length: pl_bysize if dojoinstem is True: a regular expression that matches any of the stems: stem """ if siendingsize is not None: siendingsize = -siendingsize si_list = [w[:siendingsize] + plending for w in lst] pl_bysize = bysize(lst) si_bysize = bysize(si_list) if dojoinstem: stem = joinstem(siendingsize, lst) return si_list, si_bysize, pl_bysize, stem else: return si_list, si_bysize, pl_bysize # 1. PLURALS pl_sb_irregular_s = { "corpus": "corpuses|corpora", "opus": "opuses|opera", "genus": "genera", "mythos": "mythoi", "penis": "penises|penes", "testis": "testes", "atlas": "atlases|atlantes", "yes": "yeses", } pl_sb_irregular = { "child": "children", "chili": "chilis|chilies", "brother": "brothers|brethren", "infinity": "infinities|infinity", "loaf": "loaves", "lore": "lores|lore", "hoof": "hoofs|hooves", "beef": "beefs|beeves", "thief": "thiefs|thieves", "money": "monies", "mongoose": "mongooses", "ox": "oxen", "cow": "cows|kine", "graffito": "graffiti", "octopus": "octopuses|octopodes", "genie": "genies|genii", "ganglion": "ganglions|ganglia", "trilby": "trilbys", "turf": "turfs|turves", "numen": "numina", "atman": "atmas", "occiput": "occiputs|occipita", "sabretooth": "sabretooths", "sabertooth": "sabertooths", "lowlife": "lowlifes", "flatfoot": "flatfoots", "tenderfoot": "tenderfoots", "romany": "romanies", "jerry": "jerries", "mary": "maries", "talouse": "talouses", "rom": "roma", "carmen": "carmina", } pl_sb_irregular.update(pl_sb_irregular_s) # pl_sb_irregular_keys = enclose('|'.join(pl_sb_irregular.keys())) pl_sb_irregular_caps = { "Romany": "Romanies", "Jerry": "Jerrys", "Mary": "Marys", "Rom": "Roma", } pl_sb_irregular_compound = {"prima donna": "prima donnas|prime donne"} si_sb_irregular = {v: k for (k, v) in pl_sb_irregular.items()} for k in list(si_sb_irregular): if "|" in k: k1, k2 = k.split("|") si_sb_irregular[k1] = si_sb_irregular[k2] = si_sb_irregular[k] del si_sb_irregular[k] si_sb_irregular_caps = {v: k for (k, v) in pl_sb_irregular_caps.items()} si_sb_irregular_compound = {v: k for (k, v) in pl_sb_irregular_compound.items()} for k in list(si_sb_irregular_compound): if "|" in k: k1, k2 = k.split("|") si_sb_irregular_compound[k1] = si_sb_irregular_compound[k2] = ( si_sb_irregular_compound[k] ) del si_sb_irregular_compound[k] # si_sb_irregular_keys = enclose('|'.join(si_sb_irregular.keys())) # Z's that don't double pl_sb_z_zes_list = ("quartz", "topaz") pl_sb_z_zes_bysize = bysize(pl_sb_z_zes_list) pl_sb_ze_zes_list = ("snooze",) pl_sb_ze_zes_bysize = bysize(pl_sb_ze_zes_list) # CLASSICAL "..is" -> "..ides" pl_sb_C_is_ides_complete = [ # GENERAL WORDS... "ephemeris", "iris", "clitoris", "chrysalis", "epididymis", ] pl_sb_C_is_ides_endings = [ # INFLAMATIONS... "itis" ] pl_sb_C_is_ides = joinstem( -2, pl_sb_C_is_ides_complete + [f".*{w}" for w in pl_sb_C_is_ides_endings] ) pl_sb_C_is_ides_list = pl_sb_C_is_ides_complete + pl_sb_C_is_ides_endings ( si_sb_C_is_ides_list, si_sb_C_is_ides_bysize, pl_sb_C_is_ides_bysize, ) = make_pl_si_lists(pl_sb_C_is_ides_list, "ides", 2, dojoinstem=False) # CLASSICAL "..a" -> "..ata" pl_sb_C_a_ata_list = ( "anathema", "bema", "carcinoma", "charisma", "diploma", "dogma", "drama", "edema", "enema", "enigma", "lemma", "lymphoma", "magma", "melisma", "miasma", "oedema", "sarcoma", "schema", "soma", "stigma", "stoma", "trauma", "gumma", "pragma", ) ( si_sb_C_a_ata_list, si_sb_C_a_ata_bysize, pl_sb_C_a_ata_bysize, pl_sb_C_a_ata, ) = make_pl_si_lists(pl_sb_C_a_ata_list, "ata", 1) # UNCONDITIONAL "..a" -> "..ae" pl_sb_U_a_ae_list = ( "alumna", "alga", "vertebra", "persona", "vita", ) ( si_sb_U_a_ae_list, si_sb_U_a_ae_bysize, pl_sb_U_a_ae_bysize, pl_sb_U_a_ae, ) = make_pl_si_lists(pl_sb_U_a_ae_list, "e", None) # CLASSICAL "..a" -> "..ae" pl_sb_C_a_ae_list = ( "amoeba", "antenna", "formula", "hyperbola", "medusa", "nebula", "parabola", "abscissa", "hydra", "nova", "lacuna", "aurora", "umbra", "flora", "fauna", ) ( si_sb_C_a_ae_list, si_sb_C_a_ae_bysize, pl_sb_C_a_ae_bysize, pl_sb_C_a_ae, ) = make_pl_si_lists(pl_sb_C_a_ae_list, "e", None) # CLASSICAL "..en" -> "..ina" pl_sb_C_en_ina_list = ("stamen", "foramen", "lumen") ( si_sb_C_en_ina_list, si_sb_C_en_ina_bysize, pl_sb_C_en_ina_bysize, pl_sb_C_en_ina, ) = make_pl_si_lists(pl_sb_C_en_ina_list, "ina", 2) # UNCONDITIONAL "..um" -> "..a" pl_sb_U_um_a_list = ( "bacterium", "agendum", "desideratum", "erratum", "stratum", "datum", "ovum", "extremum", "candelabrum", ) ( si_sb_U_um_a_list, si_sb_U_um_a_bysize, pl_sb_U_um_a_bysize, pl_sb_U_um_a, ) = make_pl_si_lists(pl_sb_U_um_a_list, "a", 2) # CLASSICAL "..um" -> "..a" pl_sb_C_um_a_list = ( "maximum", "minimum", "momentum", "optimum", "quantum", "cranium", "curriculum", "dictum", "phylum", "aquarium", "compendium", "emporium", "encomium", "gymnasium", "honorarium", "interregnum", "lustrum", "memorandum", "millennium", "rostrum", "spectrum", "speculum", "stadium", "trapezium", "ultimatum", "medium", "vacuum", "velum", "consortium", "arboretum", ) ( si_sb_C_um_a_list, si_sb_C_um_a_bysize, pl_sb_C_um_a_bysize, pl_sb_C_um_a, ) = make_pl_si_lists(pl_sb_C_um_a_list, "a", 2) # UNCONDITIONAL "..us" -> "i" pl_sb_U_us_i_list = ( "alumnus", "alveolus", "bacillus", "bronchus", "locus", "nucleus", "stimulus", "meniscus", "sarcophagus", ) ( si_sb_U_us_i_list, si_sb_U_us_i_bysize, pl_sb_U_us_i_bysize, pl_sb_U_us_i, ) = make_pl_si_lists(pl_sb_U_us_i_list, "i", 2) # CLASSICAL "..us" -> "..i" pl_sb_C_us_i_list = ( "focus", "radius", "genius", "incubus", "succubus", "nimbus", "fungus", "nucleolus", "stylus", "torus", "umbilicus", "uterus", "hippopotamus", "cactus", ) ( si_sb_C_us_i_list, si_sb_C_us_i_bysize, pl_sb_C_us_i_bysize, pl_sb_C_us_i, ) = make_pl_si_lists(pl_sb_C_us_i_list, "i", 2) # CLASSICAL "..us" -> "..us" (ASSIMILATED 4TH DECLENSION LATIN NOUNS) pl_sb_C_us_us = ( "status", "apparatus", "prospectus", "sinus", "hiatus", "impetus", "plexus", ) pl_sb_C_us_us_bysize = bysize(pl_sb_C_us_us) # UNCONDITIONAL "..on" -> "a" pl_sb_U_on_a_list = ( "criterion", "perihelion", "aphelion", "phenomenon", "prolegomenon", "noumenon", "organon", "asyndeton", "hyperbaton", ) ( si_sb_U_on_a_list, si_sb_U_on_a_bysize, pl_sb_U_on_a_bysize, pl_sb_U_on_a, ) = make_pl_si_lists(pl_sb_U_on_a_list, "a", 2) # CLASSICAL "..on" -> "..a" pl_sb_C_on_a_list = ("oxymoron",) ( si_sb_C_on_a_list, si_sb_C_on_a_bysize, pl_sb_C_on_a_bysize, pl_sb_C_on_a, ) = make_pl_si_lists(pl_sb_C_on_a_list, "a", 2) # CLASSICAL "..o" -> "..i" (BUT NORMALLY -> "..os") pl_sb_C_o_i = [ "solo", "soprano", "basso", "alto", "contralto", "tempo", "piano", "virtuoso", ] # list not tuple so can concat for pl_sb_U_o_os pl_sb_C_o_i_bysize = bysize(pl_sb_C_o_i) si_sb_C_o_i_bysize = bysize([f"{w[:-1]}i" for w in pl_sb_C_o_i]) pl_sb_C_o_i_stems = joinstem(-1, pl_sb_C_o_i) # ALWAYS "..o" -> "..os" pl_sb_U_o_os_complete = {"ado", "ISO", "NATO", "NCO", "NGO", "oto"} si_sb_U_o_os_complete = {f"{w}s" for w in pl_sb_U_o_os_complete} pl_sb_U_o_os_endings = [ "aficionado", "aggro", "albino", "allegro", "ammo", "Antananarivo", "archipelago", "armadillo", "auto", "avocado", "Bamako", "Barquisimeto", "bimbo", "bingo", "Biro", "bolero", "Bolzano", "bongo", "Boto", "burro", "Cairo", "canto", "cappuccino", "casino", "cello", "Chicago", "Chimango", "cilantro", "cochito", "coco", "Colombo", "Colorado", "commando", "concertino", "contango", "credo", "crescendo", "cyano", "demo", "ditto", "Draco", "dynamo", "embryo", "Esperanto", "espresso", "euro", "falsetto", "Faro", "fiasco", "Filipino", "flamenco", "furioso", "generalissimo", "Gestapo", "ghetto", "gigolo", "gizmo", "Greensboro", "gringo", "Guaiabero", "guano", "gumbo", "gyro", "hairdo", "hippo", "Idaho", "impetigo", "inferno", "info", "intermezzo", "intertrigo", "Iquico", "jumbo", "junto", "Kakapo", "kilo", "Kinkimavo", "Kokako", "Kosovo", "Lesotho", "libero", "libido", "libretto", "lido", "Lilo", "limbo", "limo", "lineno", "lingo", "lino", "livedo", "loco", "logo", "lumbago", "macho", "macro", "mafioso", "magneto", "magnifico", "Majuro", "Malabo", "manifesto", "Maputo", "Maracaibo", "medico", "memo", "metro", "Mexico", "micro", "Milano", "Monaco", "mono", "Montenegro", "Morocco", "Muqdisho", "myo", "neutrino", "Ningbo", "octavo", "oregano", "Orinoco", "Orlando", "Oslo", "panto", "Paramaribo", "Pardusco", "pedalo", "photo", "pimento", "pinto", "pleco", "Pluto", "pogo", "polo", "poncho", "Porto-Novo", "Porto", "pro", "psycho", "pueblo", "quarto", "Quito", "repo", "rhino", "risotto", "rococo", "rondo", "Sacramento", "saddo", "sago", "salvo", "Santiago", "Sapporo", "Sarajevo", "scherzando", "scherzo", "silo", "sirocco", "sombrero", "staccato", "sterno", "stucco", "stylo", "sumo", "Taiko", "techno", "terrazzo", "testudo", "timpano", "tiro", "tobacco", "Togo", "Tokyo", "torero", "Torino", "Toronto", "torso", "tremolo", "typo", "tyro", "ufo", "UNESCO", "vaquero", "vermicello", "verso", "vibrato", "violoncello", "Virgo", "weirdo", "WHO", "WTO", "Yamoussoukro", "yo-yo", "zero", "Zibo", ] + pl_sb_C_o_i pl_sb_U_o_os_bysize = bysize(pl_sb_U_o_os_endings) si_sb_U_o_os_bysize = bysize([f"{w}s" for w in pl_sb_U_o_os_endings]) # UNCONDITIONAL "..ch" -> "..chs" pl_sb_U_ch_chs_list = ("czech", "eunuch", "stomach") ( si_sb_U_ch_chs_list, si_sb_U_ch_chs_bysize, pl_sb_U_ch_chs_bysize, pl_sb_U_ch_chs, ) = make_pl_si_lists(pl_sb_U_ch_chs_list, "s", None) # UNCONDITIONAL "..[ei]x" -> "..ices" pl_sb_U_ex_ices_list = ("codex", "murex", "silex") ( si_sb_U_ex_ices_list, si_sb_U_ex_ices_bysize, pl_sb_U_ex_ices_bysize, pl_sb_U_ex_ices, ) = make_pl_si_lists(pl_sb_U_ex_ices_list, "ices", 2) pl_sb_U_ix_ices_list = ("radix", "helix") ( si_sb_U_ix_ices_list, si_sb_U_ix_ices_bysize, pl_sb_U_ix_ices_bysize, pl_sb_U_ix_ices, ) = make_pl_si_lists(pl_sb_U_ix_ices_list, "ices", 2) # CLASSICAL "..[ei]x" -> "..ices" pl_sb_C_ex_ices_list = ( "vortex", "vertex", "cortex", "latex", "pontifex", "apex", "index", "simplex", ) ( si_sb_C_ex_ices_list, si_sb_C_ex_ices_bysize, pl_sb_C_ex_ices_bysize, pl_sb_C_ex_ices, ) = make_pl_si_lists(pl_sb_C_ex_ices_list, "ices", 2) pl_sb_C_ix_ices_list = ("appendix",) ( si_sb_C_ix_ices_list, si_sb_C_ix_ices_bysize, pl_sb_C_ix_ices_bysize, pl_sb_C_ix_ices, ) = make_pl_si_lists(pl_sb_C_ix_ices_list, "ices", 2) # ARABIC: ".." -> "..i" pl_sb_C_i_list = ("afrit", "afreet", "efreet") (si_sb_C_i_list, si_sb_C_i_bysize, pl_sb_C_i_bysize, pl_sb_C_i) = make_pl_si_lists( pl_sb_C_i_list, "i", None ) # HEBREW: ".." -> "..im" pl_sb_C_im_list = ("goy", "seraph", "cherub") (si_sb_C_im_list, si_sb_C_im_bysize, pl_sb_C_im_bysize, pl_sb_C_im) = make_pl_si_lists( pl_sb_C_im_list, "im", None ) # UNCONDITIONAL "..man" -> "..mans" pl_sb_U_man_mans_list = """ ataman caiman cayman ceriman desman dolman farman harman hetman human leman ottoman shaman talisman """.split() pl_sb_U_man_mans_caps_list = """ Alabaman Bahaman Burman German Hiroshiman Liman Nakayaman Norman Oklahoman Panaman Roman Selman Sonaman Tacoman Yakiman Yokohaman Yuman """.split() ( si_sb_U_man_mans_list, si_sb_U_man_mans_bysize, pl_sb_U_man_mans_bysize, ) = make_pl_si_lists(pl_sb_U_man_mans_list, "s", None, dojoinstem=False) ( si_sb_U_man_mans_caps_list, si_sb_U_man_mans_caps_bysize, pl_sb_U_man_mans_caps_bysize, ) = make_pl_si_lists(pl_sb_U_man_mans_caps_list, "s", None, dojoinstem=False) # UNCONDITIONAL "..louse" -> "..lice" pl_sb_U_louse_lice_list = ("booklouse", "grapelouse", "louse", "woodlouse") ( si_sb_U_louse_lice_list, si_sb_U_louse_lice_bysize, pl_sb_U_louse_lice_bysize, ) = make_pl_si_lists(pl_sb_U_louse_lice_list, "lice", 5, dojoinstem=False) pl_sb_uninflected_s_complete = [ # PAIRS OR GROUPS SUBSUMED TO A SINGULAR... "breeches", "britches", "pajamas", "pyjamas", "clippers", "gallows", "hijinks", "headquarters", "pliers", "scissors", "testes", "herpes", "pincers", "shears", "proceedings", "trousers", # UNASSIMILATED LATIN 4th DECLENSION "cantus", "coitus", "nexus", # RECENT IMPORTS... "contretemps", "corps", "debris", "siemens", # DISEASES "mumps", # MISCELLANEOUS OTHERS... "diabetes", "jackanapes", "series", "species", "subspecies", "rabies", "chassis", "innings", "news", "mews", "haggis", ] pl_sb_uninflected_s_endings = [ # RECENT IMPORTS... "ois", # DISEASES "measles", ] pl_sb_uninflected_s = pl_sb_uninflected_s_complete + [ f".*{w}" for w in pl_sb_uninflected_s_endings ] pl_sb_uninflected_herd = ( # DON'T INFLECT IN CLASSICAL MODE, OTHERWISE NORMAL INFLECTION "wildebeest", "swine", "eland", "bison", "buffalo", "cattle", "elk", "rhinoceros", "zucchini", "caribou", "dace", "grouse", "guinea fowl", "guinea-fowl", "haddock", "hake", "halibut", "herring", "mackerel", "pickerel", "pike", "roe", "seed", "shad", "snipe", "teal", "turbot", "water fowl", "water-fowl", ) pl_sb_uninflected_complete = [ # SOME FISH AND HERD ANIMALS "tuna", "salmon", "mackerel", "trout", "bream", "sea-bass", "sea bass", "carp", "cod", "flounder", "whiting", "moose", # OTHER ODDITIES "graffiti", "djinn", "samuri", "offspring", "pence", "quid", "hertz", ] + pl_sb_uninflected_s_complete # SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE) pl_sb_uninflected_caps = [ # ALL NATIONALS ENDING IN -ese "Portuguese", "Amoyese", "Borghese", "Congoese", "Faroese", "Foochowese", "Genevese", "Genoese", "Gilbertese", "Hottentotese", "Kiplingese", "Kongoese", "Lucchese", "Maltese", "Nankingese", "Niasese", "Pekingese", "Piedmontese", "Pistoiese", "Sarawakese", "Shavese", "Vermontese", "Wenchowese", "Yengeese", ] pl_sb_uninflected_endings = [ # UNCOUNTABLE NOUNS "butter", "cash", "furniture", "information", # SOME FISH AND HERD ANIMALS "fish", "deer", "sheep", # ALL NATIONALS ENDING IN -ese "nese", "rese", "lese", "mese", # DISEASES "pox", # OTHER ODDITIES "craft", ] + pl_sb_uninflected_s_endings # SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE) pl_sb_uninflected_bysize = bysize(pl_sb_uninflected_endings) # SINGULAR WORDS ENDING IN ...s (ALL INFLECT WITH ...es) pl_sb_singular_s_complete = [ "acropolis", "aegis", "alias", "asbestos", "bathos", "bias", "bronchitis", "bursitis", "caddis", "cannabis", "canvas", "chaos", "cosmos", "dais", "digitalis", "epidermis", "ethos", "eyas", "gas", "glottis", "hubris", "ibis", "lens", "mantis", "marquis", "metropolis", "pathos", "pelvis", "polis", "rhinoceros", "sassafras", "trellis", ] + pl_sb_C_is_ides_complete pl_sb_singular_s_endings = ["ss", "us"] + pl_sb_C_is_ides_endings pl_sb_singular_s_bysize = bysize(pl_sb_singular_s_endings) si_sb_singular_s_complete = [f"{w}es" for w in pl_sb_singular_s_complete] si_sb_singular_s_endings = [f"{w}es" for w in pl_sb_singular_s_endings] si_sb_singular_s_bysize = bysize(si_sb_singular_s_endings) pl_sb_singular_s_es = ["[A-Z].*es"] pl_sb_singular_s = enclose( "|".join( pl_sb_singular_s_complete + [f".*{w}" for w in pl_sb_singular_s_endings] + pl_sb_singular_s_es ) ) # PLURALS ENDING IN uses -> use si_sb_ois_oi_case = ("Bolshois", "Hanois") si_sb_uses_use_case = ("Betelgeuses", "Duses", "Meuses", "Syracuses", "Toulouses") si_sb_uses_use = ( "abuses", "applauses", "blouses", "carouses", "causes", "chartreuses", "clauses", "contuses", "douses", "excuses", "fuses", "grouses", "hypotenuses", "masseuses", "menopauses", "misuses", "muses", "overuses", "pauses", "peruses", "profuses", "recluses", "reuses", "ruses", "souses", "spouses", "suffuses", "transfuses", "uses", ) si_sb_ies_ie_case = ( "Addies", "Aggies", "Allies", "Amies", "Angies", "Annies", "Annmaries", "Archies", "Arties", "Aussies", "Barbies", "Barries", "Basies", "Bennies", "Bernies", "Berties", "Bessies", "Betties", "Billies", "Blondies", "Bobbies", "Bonnies", "Bowies", "Brandies", "Bries", "Brownies", "Callies", "Carnegies", "Carries", "Cassies", "Charlies", "Cheries", "Christies", "Connies", "Curies", "Dannies", "Debbies", "Dixies", "Dollies", "Donnies", "Drambuies", "Eddies", "Effies", "Ellies", "Elsies", "Eries", "Ernies", "Essies", "Eugenies", "Fannies", "Flossies", "Frankies", "Freddies", "Gillespies", "Goldies", "Gracies", "Guthries", "Hallies", "Hatties", "Hetties", "Hollies", "Jackies", "Jamies", "Janies", "Jannies", "Jeanies", "Jeannies", "Jennies", "Jessies", "Jimmies", "Jodies", "Johnies", "Johnnies", "Josies", "Julies", "Kalgoorlies", "Kathies", "Katies", "Kellies", "Kewpies", "Kristies", "Laramies", "Lassies", "Lauries", "Leslies", "Lessies", "Lillies", "Lizzies", "Lonnies", "Lories", "Lorries", "Lotties", "Louies", "Mackenzies", "Maggies", "Maisies", "Mamies", "Marcies", "Margies", "Maries", "Marjories", "Matties", "McKenzies", "Melanies", "Mickies", "Millies", "Minnies", "Mollies", "Mounties", "Nannies", "Natalies", "Nellies", "Netties", "Ollies", "Ozzies", "Pearlies", "Pottawatomies", "Reggies", "Richies", "Rickies", "Robbies", "Ronnies", "Rosalies", "Rosemaries", "Rosies", "Roxies", "Rushdies", "Ruthies", "Sadies", "Sallies", "Sammies", "Scotties", "Selassies", "Sherries", "Sophies", "Stacies", "Stefanies", "Stephanies", "Stevies", "Susies", "Sylvies", "Tammies", "Terries", "Tessies", "Tommies", "Tracies", "Trekkies", "Valaries", "Valeries", "Valkyries", "Vickies", "Virgies", "Willies", "Winnies", "Wylies", "Yorkies", ) si_sb_ies_ie = ( "aeries", "baggies", "belies", "biggies", "birdies", "bogies", "bonnies", "boogies", "bookies", "bourgeoisies", "brownies", "budgies", "caddies", "calories", "camaraderies", "cockamamies", "collies", "cookies", "coolies", "cooties", "coteries", "crappies", "curies", "cutesies", "dogies", "eyries", "floozies", "footsies", "freebies", "genies", "goalies", "groupies", "hies", "jalousies", "junkies", "kiddies", "laddies", "lassies", "lies", "lingeries", "magpies", "menageries", "mommies", "movies", "neckties", "newbies", "nighties", "oldies", "organdies", "overlies", "pies", "pinkies", "pixies", "potpies", "prairies", "quickies", "reveries", "rookies", "rotisseries", "softies", "sorties", "species", "stymies", "sweeties", "ties", "underlies", "unties", "veggies", "vies", "yuppies", "zombies", ) si_sb_oes_oe_case = ( "Chloes", "Crusoes", "Defoes", "Faeroes", "Ivanhoes", "Joes", "McEnroes", "Moes", "Monroes", "Noes", "Poes", "Roscoes", "Tahoes", "Tippecanoes", "Zoes", ) si_sb_oes_oe = ( "aloes", "backhoes", "canoes", "does", "floes", "foes", "hoes", "mistletoes", "oboes", "pekoes", "roes", "sloes", "throes", "tiptoes", "toes", "woes", ) si_sb_z_zes = ("quartzes", "topazes") si_sb_zzes_zz = ("buzzes", "fizzes", "frizzes", "razzes") si_sb_ches_che_case = ( "Andromaches", "Apaches", "Blanches", "Comanches", "Nietzsches", "Porsches", "Roches", ) si_sb_ches_che = ( "aches", "avalanches", "backaches", "bellyaches", "caches", "cloches", "creches", "douches", "earaches", "fiches", "headaches", "heartaches", "microfiches", "niches", "pastiches", "psyches", "quiches", "stomachaches", "toothaches", "tranches", ) si_sb_xes_xe = ("annexes", "axes", "deluxes", "pickaxes") si_sb_sses_sse_case = ("Hesses", "Jesses", "Larousses", "Matisses") si_sb_sses_sse = ( "bouillabaisses", "crevasses", "demitasses", "impasses", "mousses", "posses", ) si_sb_ves_ve_case = ( # *[nwl]ives -> [nwl]live "Clives", "Palmolives", ) si_sb_ves_ve = ( # *[^d]eaves -> eave "interweaves", "weaves", # *[nwl]ives -> [nwl]live "olives", # *[eoa]lves -> [eoa]lve "bivalves", "dissolves", "resolves", "salves", "twelves", "valves", ) plverb_special_s = enclose( "|".join( [pl_sb_singular_s] + pl_sb_uninflected_s + list(pl_sb_irregular_s) + ["(.*[csx])is", "(.*)ceps", "[A-Z].*s"] ) ) _pl_sb_postfix_adj_defn = ( ("general", enclose(r"(?!major|lieutenant|brigadier|adjutant|.*star)\S+")), ("martial", enclose("court")), ("force", enclose("pound")), ) pl_sb_postfix_adj: Iterable[str] = ( enclose(val + f"(?=(?:-|\\s+){key})") for key, val in _pl_sb_postfix_adj_defn ) pl_sb_postfix_adj_stems = f"({'|'.join(pl_sb_postfix_adj)})(.*)" # PLURAL WORDS ENDING IS es GO TO SINGULAR is si_sb_es_is = ( "amanuenses", "amniocenteses", "analyses", "antitheses", "apotheoses", "arterioscleroses", "atheroscleroses", "axes", # 'bases', # bases -> basis "catalyses", "catharses", "chasses", "cirrhoses", "cocces", "crises", "diagnoses", "dialyses", "diereses", "electrolyses", "emphases", "exegeses", "geneses", "halitoses", "hydrolyses", "hypnoses", "hypotheses", "hystereses", "metamorphoses", "metastases", "misdiagnoses", "mitoses", "mononucleoses", "narcoses", "necroses", "nemeses", "neuroses", "oases", "osmoses", "osteoporoses", "paralyses", "parentheses", "parthenogeneses", "periphrases", "photosyntheses", "probosces", "prognoses", "prophylaxes", "prostheses", "preces", "psoriases", "psychoanalyses", "psychokineses", "psychoses", "scleroses", "scolioses", "sepses", "silicoses", "symbioses", "synopses", "syntheses", "taxes", "telekineses", "theses", "thromboses", "tuberculoses", "urinalyses", ) pl_prep_list = """ about above across after among around at athwart before behind below beneath beside besides between betwixt beyond but by during except for from in into near of off on onto out over since till to under until unto upon with""".split() pl_prep_list_da = pl_prep_list + ["de", "du", "da"] pl_prep_bysize = bysize(pl_prep_list_da) pl_prep = enclose("|".join(pl_prep_list_da)) pl_sb_prep_dual_compound = rf"(.*?)((?:-|\s+)(?:{pl_prep})(?:-|\s+))a(?:-|\s+)(.*)" singular_pronoun_genders = { "neuter", "feminine", "masculine", "gender-neutral", "feminine or masculine", "masculine or feminine", } pl_pron_nom = { # NOMINATIVE REFLEXIVE "i": "we", "myself": "ourselves", "you": "you", "yourself": "yourselves", "she": "they", "herself": "themselves", "he": "they", "himself": "themselves", "it": "they", "itself": "themselves", "they": "they", "themself": "themselves", # POSSESSIVE "mine": "ours", "yours": "yours", "hers": "theirs", "his": "theirs", "its": "theirs", "theirs": "theirs", } si_pron: Dict[str, Dict[str, Union[str, Dict[str, str]]]] = { "nom": {v: k for (k, v) in pl_pron_nom.items()} } si_pron["nom"]["we"] = "I" pl_pron_acc = { # ACCUSATIVE REFLEXIVE "me": "us", "myself": "ourselves", "you": "you", "yourself": "yourselves", "her": "them", "herself": "themselves", "him": "them", "himself": "themselves", "it": "them", "itself": "themselves", "them": "them", "themself": "themselves", } pl_pron_acc_keys = enclose("|".join(pl_pron_acc)) pl_pron_acc_keys_bysize = bysize(pl_pron_acc) si_pron["acc"] = {v: k for (k, v) in pl_pron_acc.items()} for _thecase, _plur, _gend, _sing in ( ("nom", "they", "neuter", "it"), ("nom", "they", "feminine", "she"), ("nom", "they", "masculine", "he"), ("nom", "they", "gender-neutral", "they"), ("nom", "they", "feminine or masculine", "she or he"), ("nom", "they", "masculine or feminine", "he or she"), ("nom", "themselves", "neuter", "itself"), ("nom", "themselves", "feminine", "herself"), ("nom", "themselves", "masculine", "himself"), ("nom", "themselves", "gender-neutral", "themself"), ("nom", "themselves", "feminine or masculine", "herself or himself"), ("nom", "themselves", "masculine or feminine", "himself or herself"), ("nom", "theirs", "neuter", "its"), ("nom", "theirs", "feminine", "hers"), ("nom", "theirs", "masculine", "his"), ("nom", "theirs", "gender-neutral", "theirs"), ("nom", "theirs", "feminine or masculine", "hers or his"), ("nom", "theirs", "masculine or feminine", "his or hers"), ("acc", "them", "neuter", "it"), ("acc", "them", "feminine", "her"), ("acc", "them", "masculine", "him"), ("acc", "them", "gender-neutral", "them"), ("acc", "them", "feminine or masculine", "her or him"), ("acc", "them", "masculine or feminine", "him or her"), ("acc", "themselves", "neuter", "itself"), ("acc", "themselves", "feminine", "herself"), ("acc", "themselves", "masculine", "himself"), ("acc", "themselves", "gender-neutral", "themself"), ("acc", "themselves", "feminine or masculine", "herself or himself"), ("acc", "themselves", "masculine or feminine", "himself or herself"), ): try: si_pron[_thecase][_plur][_gend] = _sing # type: ignore except TypeError: si_pron[_thecase][_plur] = {} si_pron[_thecase][_plur][_gend] = _sing # type: ignore si_pron_acc_keys = enclose("|".join(si_pron["acc"])) si_pron_acc_keys_bysize = bysize(si_pron["acc"]) def get_si_pron(thecase, word, gender) -> str: try: sing = si_pron[thecase][word] except KeyError: raise # not a pronoun try: return sing[gender] # has several types due to gender except TypeError: return cast(str, sing) # answer independent of gender # These dictionaries group verbs by first, second and third person # conjugations. plverb_irregular_pres = { "am": "are", "are": "are", "is": "are", "was": "were", "were": "were", "have": "have", "has": "have", "do": "do", "does": "do", } plverb_ambiguous_pres = { "act": "act", "acts": "act", "blame": "blame", "blames": "blame", "can": "can", "must": "must", "fly": "fly", "flies": "fly", "copy": "copy", "copies": "copy", "drink": "drink", "drinks": "drink", "fight": "fight", "fights": "fight", "fire": "fire", "fires": "fire", "like": "like", "likes": "like", "look": "look", "looks": "look", "make": "make", "makes": "make", "reach": "reach", "reaches": "reach", "run": "run", "runs": "run", "sink": "sink", "sinks": "sink", "sleep": "sleep", "sleeps": "sleep", "view": "view", "views": "view", } plverb_ambiguous_pres_keys = re.compile( rf"^({enclose('|'.join(plverb_ambiguous_pres))})((\s.*)?)$", re.IGNORECASE ) plverb_irregular_non_pres = ( "did", "had", "ate", "made", "put", "spent", "fought", "sank", "gave", "sought", "shall", "could", "ought", "should", ) plverb_ambiguous_non_pres = re.compile( r"^((?:thought|saw|bent|will|might|cut))((\s.*)?)$", re.IGNORECASE ) # "..oes" -> "..oe" (the rest are "..oes" -> "o") pl_v_oes_oe = ("canoes", "floes", "oboes", "roes", "throes", "woes") pl_v_oes_oe_endings_size4 = ("hoes", "toes") pl_v_oes_oe_endings_size5 = ("shoes",) pl_count_zero = ("0", "no", "zero", "nil") pl_count_one = ("1", "a", "an", "one", "each", "every", "this", "that") pl_adj_special = {"a": "some", "an": "some", "this": "these", "that": "those"} pl_adj_special_keys = re.compile( rf"^({enclose('|'.join(pl_adj_special))})$", re.IGNORECASE ) pl_adj_poss = { "my": "our", "your": "your", "its": "their", "her": "their", "his": "their", "their": "their", } pl_adj_poss_keys = re.compile(rf"^({enclose('|'.join(pl_adj_poss))})$", re.IGNORECASE) # 2. INDEFINITE ARTICLES # THIS PATTERN MATCHES STRINGS OF CAPITALS STARTING WITH A "VOWEL-SOUND" # CONSONANT FOLLOWED BY ANOTHER CONSONANT, AND WHICH ARE NOT LIKELY # TO BE REAL WORDS (OH, ALL RIGHT THEN, IT'S JUST MAGIC!) A_abbrev = re.compile( r""" ^(?! FJO | [HLMNS]Y. | RY[EO] | SQU | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU]) [FHLMNRSX][A-Z] """, re.VERBOSE, ) # THIS PATTERN CODES THE BEGINNINGS OF ALL ENGLISH WORDS BEGINING WITH A # 'y' FOLLOWED BY A CONSONANT. ANY OTHER Y-CONSONANT PREFIX THEREFORE # IMPLIES AN ABBREVIATION. A_y_cons = re.compile(r"^(y(b[lor]|cl[ea]|fere|gg|p[ios]|rou|tt))", re.IGNORECASE) # EXCEPTIONS TO EXCEPTIONS A_explicit_a = re.compile(r"^((?:unabomber|unanimous|US))", re.IGNORECASE) A_explicit_an = re.compile( r"^((?:euler|hour(?!i)|heir|honest|hono[ur]|mpeg))", re.IGNORECASE ) A_ordinal_an = re.compile(r"^([aefhilmnorsx]-?th)", re.IGNORECASE) A_ordinal_a = re.compile(r"^([bcdgjkpqtuvwyz]-?th)", re.IGNORECASE) # NUMERICAL INFLECTIONS nth = { 0: "th", 1: "st", 2: "nd", 3: "rd", 4: "th", 5: "th", 6: "th", 7: "th", 8: "th", 9: "th", 11: "th", 12: "th", 13: "th", } nth_suff = set(nth.values()) ordinal = dict( ty="tieth", one="first", two="second", three="third", five="fifth", eight="eighth", nine="ninth", twelve="twelfth", ) ordinal_suff = re.compile(rf"({'|'.join(ordinal)})\Z") # NUMBERS unit = ["", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine"] teen = [ "ten", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen", ] ten = [ "", "", "twenty", "thirty", "forty", "fifty", "sixty", "seventy", "eighty", "ninety", ] mill = [ " ", " thousand", " million", " billion", " trillion", " quadrillion", " quintillion", " sextillion", " septillion", " octillion", " nonillion", " decillion", ] # SUPPORT CLASSICAL PLURALIZATIONS def_classical = dict( all=False, zero=False, herd=False, names=True, persons=False, ancient=False ) all_classical = {k: True for k in def_classical} no_classical = {k: False for k in def_classical} # Maps strings to built-in constant types string_to_constant = {"True": True, "False": False, "None": None} # Pre-compiled regular expression objects DOLLAR_DIGITS = re.compile(r"\$(\d+)") FUNCTION_CALL = re.compile(r"((\w+)\([^)]*\)*)", re.IGNORECASE) PARTITION_WORD = re.compile(r"\A(\s*)(.+?)(\s*)\Z") PL_SB_POSTFIX_ADJ_STEMS_RE = re.compile( rf"^(?:{pl_sb_postfix_adj_stems})$", re.IGNORECASE ) PL_SB_PREP_DUAL_COMPOUND_RE = re.compile( rf"^(?:{pl_sb_prep_dual_compound})$", re.IGNORECASE ) DENOMINATOR = re.compile(r"(?P<denominator>.+)( (per|a) .+)") PLVERB_SPECIAL_S_RE = re.compile(rf"^({plverb_special_s})$") WHITESPACE = re.compile(r"\s") ENDS_WITH_S = re.compile(r"^(.*[^s])s$", re.IGNORECASE) ENDS_WITH_APOSTROPHE_S = re.compile(r"^(.*)'s?$") INDEFINITE_ARTICLE_TEST = re.compile(r"\A(\s*)(?:an?\s+)?(.+?)(\s*)\Z", re.IGNORECASE) SPECIAL_AN = re.compile(r"^[aefhilmnorsx]$", re.IGNORECASE) SPECIAL_A = re.compile(r"^[bcdgjkpqtuvwyz]$", re.IGNORECASE) SPECIAL_ABBREV_AN = re.compile(r"^[aefhilmnorsx][.-]", re.IGNORECASE) SPECIAL_ABBREV_A = re.compile(r"^[a-z][.-]", re.IGNORECASE) CONSONANTS = re.compile(r"^[^aeiouy]", re.IGNORECASE) ARTICLE_SPECIAL_EU = re.compile(r"^e[uw]", re.IGNORECASE) ARTICLE_SPECIAL_ONCE = re.compile(r"^onc?e\b", re.IGNORECASE) ARTICLE_SPECIAL_ONETIME = re.compile(r"^onetime\b", re.IGNORECASE) ARTICLE_SPECIAL_UNIT = re.compile(r"^uni([^nmd]|mo)", re.IGNORECASE) ARTICLE_SPECIAL_UBA = re.compile(r"^u[bcfghjkqrst][aeiou]", re.IGNORECASE) ARTICLE_SPECIAL_UKR = re.compile(r"^ukr", re.IGNORECASE) SPECIAL_CAPITALS = re.compile(r"^U[NK][AIEO]?") VOWELS = re.compile(r"^[aeiou]", re.IGNORECASE) DIGIT_GROUP = re.compile(r"(\d)") TWO_DIGITS = re.compile(r"(\d)(\d)") THREE_DIGITS = re.compile(r"(\d)(\d)(\d)") THREE_DIGITS_WORD = re.compile(r"(\d)(\d)(\d)(?=\D*\Z)") TWO_DIGITS_WORD = re.compile(r"(\d)(\d)(?=\D*\Z)") ONE_DIGIT_WORD = re.compile(r"(\d)(?=\D*\Z)") FOUR_DIGIT_COMMA = re.compile(r"(\d)(\d{3}(?:,|\Z))") NON_DIGIT = re.compile(r"\D") WHITESPACES_COMMA = re.compile(r"\s+,") COMMA_WORD = re.compile(r", (\S+)\s+\Z") WHITESPACES = re.compile(r"\s+") PRESENT_PARTICIPLE_REPLACEMENTS = ( (re.compile(r"ie$"), r"y"), ( re.compile(r"ue$"), r"u", ), # TODO: isn't ue$ -> u encompassed in the following rule? (re.compile(r"([auy])e$"), r"\g<1>"), (re.compile(r"ski$"), r"ski"), (re.compile(r"[^b]i$"), r""), (re.compile(r"^(are|were)$"), r"be"), (re.compile(r"^(had)$"), r"hav"), (re.compile(r"^(hoe)$"), r"\g<1>"), (re.compile(r"([^e])e$"), r"\g<1>"), (re.compile(r"er$"), r"er"), (re.compile(r"([^aeiou][aeiouy]([bdgmnprst]))$"), r"\g<1>\g<2>"), ) DIGIT = re.compile(r"\d") class Words(str): lowered: str split_: List[str] first: str last: str def __init__(self, orig) -> None: self.lowered = self.lower() self.split_ = self.split() self.first = self.split_[0] self.last = self.split_[-1] Falsish = Any # ideally, falsish would only validate on bool(value) is False _STATIC_TYPE_CHECKING = TYPE_CHECKING # ^-- Workaround for typeguard AST manipulation: # https://github.com/agronholm/typeguard/issues/353#issuecomment-1556306554 if _STATIC_TYPE_CHECKING: # pragma: no cover Word = Annotated[str, "String with at least 1 character"] else: class _WordMeta(type): # Too dynamic to be supported by mypy... def __instancecheck__(self, instance: Any) -> bool: return isinstance(instance, str) and len(instance) >= 1 class Word(metaclass=_WordMeta): # type: ignore[no-redef] """String with at least 1 character""" class engine: def __init__(self) -> None: self.classical_dict = def_classical.copy() self.persistent_count: Optional[int] = None self.mill_count = 0 self.pl_sb_user_defined: List[Optional[Word]] = [] self.pl_v_user_defined: List[Optional[Word]] = [] self.pl_adj_user_defined: List[Optional[Word]] = [] self.si_sb_user_defined: List[Optional[Word]] = [] self.A_a_user_defined: List[Optional[Word]] = [] self.thegender = "neuter" self.__number_args: Optional[Dict[str, str]] = None @property def _number_args(self): return cast(Dict[str, str], self.__number_args) @_number_args.setter def _number_args(self, val): self.__number_args = val @typechecked def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int: """ Set the noun plural of singular to plural. """ self.checkpat(singular) self.checkpatplural(plural) self.pl_sb_user_defined.extend((singular, plural)) self.si_sb_user_defined.extend((plural, singular)) return 1 @typechecked def defverb( self, s1: Optional[Word], p1: Optional[Word], s2: Optional[Word], p2: Optional[Word], s3: Optional[Word], p3: Optional[Word], ) -> int: """ Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively. Where 1, 2 and 3 represent the 1st, 2nd and 3rd person forms of the verb. """ self.checkpat(s1) self.checkpat(s2) self.checkpat(s3) self.checkpatplural(p1) self.checkpatplural(p2) self.checkpatplural(p3) self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3)) return 1 @typechecked def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int: """ Set the adjective plural of singular to plural. """ self.checkpat(singular) self.checkpatplural(plural) self.pl_adj_user_defined.extend((singular, plural)) return 1 @typechecked def defa(self, pattern: Optional[Word]) -> int: """ Define the indefinite article as 'a' for words matching pattern. """ self.checkpat(pattern) self.A_a_user_defined.extend((pattern, "a")) return 1 @typechecked def defan(self, pattern: Optional[Word]) -> int: """ Define the indefinite article as 'an' for words matching pattern. """ self.checkpat(pattern) self.A_a_user_defined.extend((pattern, "an")) return 1 def checkpat(self, pattern: Optional[Word]) -> None: """ check for errors in a regex pattern """ if pattern is None: return try: re.match(pattern, "") except re.error as err: raise BadUserDefinedPatternError(pattern) from err def checkpatplural(self, pattern: Optional[Word]) -> None: """ check for errors in a regex replace pattern """ return @typechecked def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]: for i in range(len(wordlist) - 2, -2, -2): # backwards through even elements mo = re.search(rf"^{wordlist[i]}$", word, re.IGNORECASE) if mo: if wordlist[i + 1] is None: return None pl = DOLLAR_DIGITS.sub( r"\\1", cast(Word, wordlist[i + 1]) ) # change $n to \n for expand return mo.expand(pl) return None def classical(self, **kwargs) -> None: """ turn classical mode on and off for various categories turn on all classical modes: classical() classical(all=True) turn on or off specific claassical modes: e.g. classical(herd=True) classical(names=False) By default all classical modes are off except names. unknown value in args or key in kwargs raises exception: UnknownClasicalModeError """ if not kwargs: self.classical_dict = all_classical.copy() return if "all" in kwargs: if kwargs["all"]: self.classical_dict = all_classical.copy() else: self.classical_dict = no_classical.copy() for k, v in kwargs.items(): if k in def_classical: self.classical_dict[k] = v else: raise UnknownClassicalModeError def num( self, count: Optional[int] = None, show: Optional[int] = None ) -> str: # (;$count,$show) """ Set the number to be used in other method calls. Returns count. Set show to False to return '' instead. """ if count is not None: try: self.persistent_count = int(count) except ValueError as err: raise BadNumValueError from err if (show is None) or show: return str(count) else: self.persistent_count = None return "" def gender(self, gender: str) -> None: """ set the gender for the singular of plural pronouns can be one of: 'neuter' ('they' -> 'it') 'feminine' ('they' -> 'she') 'masculine' ('they' -> 'he') 'gender-neutral' ('they' -> 'they') 'feminine or masculine' ('they' -> 'she or he') 'masculine or feminine' ('they' -> 'he or she') """ if gender in singular_pronoun_genders: self.thegender = gender else: raise BadGenderError def _get_value_from_ast(self, obj): """ Return the value of the ast object. """ if isinstance(obj, ast.Num): return obj.n elif isinstance(obj, ast.Str): return obj.s elif isinstance(obj, ast.List): return [self._get_value_from_ast(e) for e in obj.elts] elif isinstance(obj, ast.Tuple): return tuple([self._get_value_from_ast(e) for e in obj.elts]) # None, True and False are NameConstants in Py3.4 and above. elif isinstance(obj, ast.NameConstant): return obj.value # Probably passed a variable name. # Or passed a single word without wrapping it in quotes as an argument # ex: p.inflect("I plural(see)") instead of p.inflect("I plural('see')") raise NameError(f"name '{obj.id}' is not defined") def _string_to_substitute( self, mo: Match, methods_dict: Dict[str, Callable] ) -> str: """ Return the string to be substituted for the match. """ matched_text, f_name = mo.groups() # matched_text is the complete match string. e.g. plural_noun(cat) # f_name is the function name. e.g. plural_noun # Return matched_text if function name is not in methods_dict if f_name not in methods_dict: return matched_text # Parse the matched text a_tree = ast.parse(matched_text) # get the args and kwargs from ast objects args_list = [ self._get_value_from_ast(a) for a in a_tree.body[0].value.args # type: ignore[attr-defined] ] kwargs_list = { kw.arg: self._get_value_from_ast(kw.value) for kw in a_tree.body[0].value.keywords # type: ignore[attr-defined] } # Call the corresponding function return methods_dict[f_name](*args_list, **kwargs_list) # 0. PERFORM GENERAL INFLECTIONS IN A STRING @typechecked def inflect(self, text: Word) -> str: """ Perform inflections in a string. e.g. inflect('The plural of cat is plural(cat)') returns 'The plural of cat is cats' can use plural, plural_noun, plural_verb, plural_adj, singular_noun, a, an, no, ordinal, number_to_words, and prespart """ save_persistent_count = self.persistent_count # Dictionary of allowed methods methods_dict: Dict[str, Callable] = { "plural": self.plural, "plural_adj": self.plural_adj, "plural_noun": self.plural_noun, "plural_verb": self.plural_verb, "singular_noun": self.singular_noun, "a": self.a, "an": self.a, "no": self.no, "ordinal": self.ordinal, "number_to_words": self.number_to_words, "present_participle": self.present_participle, "num": self.num, } # Regular expression to find Python's function call syntax output = FUNCTION_CALL.sub( lambda mo: self._string_to_substitute(mo, methods_dict), text ) self.persistent_count = save_persistent_count return output # ## PLURAL SUBROUTINES def postprocess(self, orig: str, inflected) -> str: inflected = str(inflected) if "|" in inflected: word_options = inflected.split("|") # When two parts of a noun need to be pluralized if len(word_options[0].split(" ")) == len(word_options[1].split(" ")): result = inflected.split("|")[self.classical_dict["all"]].split(" ") # When only the last part of the noun needs to be pluralized else: result = inflected.split(" ") for index, word in enumerate(result): if "|" in word: result[index] = word.split("|")[self.classical_dict["all"]] else: result = inflected.split(" ") # Try to fix word wise capitalization for index, word in enumerate(orig.split(" ")): if word == "I": # Is this the only word for exceptions like this # Where the original is fully capitalized # without 'meaning' capitalization? # Also this fails to handle a capitalizaion in context continue if word.capitalize() == word: result[index] = result[index].capitalize() if word == word.upper(): result[index] = result[index].upper() return " ".join(result) def partition_word(self, text: str) -> Tuple[str, str, str]: mo = PARTITION_WORD.search(text) if mo: return mo.group(1), mo.group(2), mo.group(3) else: return "", "", "" @typechecked def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str: """ Return the plural of text. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. """ pre, word, post = self.partition_word(text) if not word: return text plural = self.postprocess( word, self._pl_special_adjective(word, count) or self._pl_special_verb(word, count) or self._plnoun(word, count), ) return f"{pre}{plural}{post}" @typechecked def plural_noun( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: """ Return the plural of text, where text is a noun. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. """ pre, word, post = self.partition_word(text) if not word: return text plural = self.postprocess(word, self._plnoun(word, count)) return f"{pre}{plural}{post}" @typechecked def plural_verb( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: """ Return the plural of text, where text is a verb. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. """ pre, word, post = self.partition_word(text) if not word: return text plural = self.postprocess( word, self._pl_special_verb(word, count) or self._pl_general_verb(word, count), ) return f"{pre}{plural}{post}" @typechecked def plural_adj( self, text: Word, count: Optional[Union[str, int, Any]] = None ) -> str: """ Return the plural of text, where text is an adjective. If count supplied, then return text if count is one of: 1, a, an, one, each, every, this, that otherwise return the plural. Whitespace at the start and end is preserved. """ pre, word, post = self.partition_word(text) if not word: return text plural = self.postprocess(word, self._pl_special_adjective(word, count) or word) return f"{pre}{plural}{post}" @typechecked def compare(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise >>> compare = engine().compare >>> compare("egg", "eggs") 's:p' >>> compare('egg', 'egg') 'eq' Words should not be empty. >>> compare('egg', '') Traceback (most recent call last): ... typeguard.TypeCheckError:...is not an instance of inflect.Word """ norms = self.plural_noun, self.plural_verb, self.plural_adj results = (self._plequal(word1, word2, norm) for norm in norms) return next(filter(None, results), False) @typechecked def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as nouns return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise """ return self._plequal(word1, word2, self.plural_noun) @typechecked def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as verbs return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise """ return self._plequal(word1, word2, self.plural_verb) @typechecked def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]: """ compare word1 and word2 for equality regardless of plurality word1 and word2 are to be treated as adjectives return values: eq - the strings are equal p:s - word1 is the plural of word2 s:p - word2 is the plural of word1 p:p - word1 and word2 are two different plural forms of the one word False - otherwise """ return self._plequal(word1, word2, self.plural_adj) @typechecked def singular_noun( self, text: Word, count: Optional[Union[int, str, Any]] = None, gender: Optional[str] = None, ) -> Union[str, Literal[False]]: """ Return the singular of text, where text is a plural noun. If count supplied, then return the singular if count is one of: 1, a, an, one, each, every, this, that or if count is None otherwise return text unchanged. Whitespace at the start and end is preserved. >>> p = engine() >>> p.singular_noun('horses') 'horse' >>> p.singular_noun('knights') 'knight' Returns False when a singular noun is passed. >>> p.singular_noun('horse') False >>> p.singular_noun('knight') False >>> p.singular_noun('soldier') False """ pre, word, post = self.partition_word(text) if not word: return text sing = self._sinoun(word, count=count, gender=gender) if sing is not False: plural = self.postprocess(word, sing) return f"{pre}{plural}{post}" return False def _plequal(self, word1: str, word2: str, pl) -> Union[str, bool]: # noqa: C901 classval = self.classical_dict.copy() self.classical_dict = all_classical.copy() if word1 == word2: return "eq" if word1 == pl(word2): return "p:s" if pl(word1) == word2: return "s:p" self.classical_dict = no_classical.copy() if word1 == pl(word2): return "p:s" if pl(word1) == word2: return "s:p" self.classical_dict = classval.copy() if pl == self.plural or pl == self.plural_noun: if self._pl_check_plurals_N(word1, word2): return "p:p" if self._pl_check_plurals_N(word2, word1): return "p:p" if pl == self.plural or pl == self.plural_adj: if self._pl_check_plurals_adj(word1, word2): return "p:p" return False def _pl_reg_plurals(self, pair: str, stems: str, end1: str, end2: str) -> bool: pattern = rf"({stems})({end1}\|\1{end2}|{end2}\|\1{end1})" return bool(re.search(pattern, pair)) def _pl_check_plurals_N(self, word1: str, word2: str) -> bool: stem_endings = ( (pl_sb_C_a_ata, "as", "ata"), (pl_sb_C_is_ides, "is", "ides"), (pl_sb_C_a_ae, "s", "e"), (pl_sb_C_en_ina, "ens", "ina"), (pl_sb_C_um_a, "ums", "a"), (pl_sb_C_us_i, "uses", "i"), (pl_sb_C_on_a, "ons", "a"), (pl_sb_C_o_i_stems, "os", "i"), (pl_sb_C_ex_ices, "exes", "ices"), (pl_sb_C_ix_ices, "ixes", "ices"), (pl_sb_C_i, "s", "i"), (pl_sb_C_im, "s", "im"), (".*eau", "s", "x"), (".*ieu", "s", "x"), (".*tri", "xes", "ces"), (".{2,}[yia]n", "xes", "ges"), ) words = map(Words, (word1, word2)) pair = "|".join(word.last for word in words) return ( pair in pl_sb_irregular_s.values() or pair in pl_sb_irregular.values() or pair in pl_sb_irregular_caps.values() or any( self._pl_reg_plurals(pair, stems, end1, end2) for stems, end1, end2 in stem_endings ) ) def _pl_check_plurals_adj(self, word1: str, word2: str) -> bool: word1a = word1[: word1.rfind("'")] if word1.endswith(("'s", "'")) else "" word2a = word2[: word2.rfind("'")] if word2.endswith(("'s", "'")) else "" return ( bool(word1a) and bool(word2a) and ( self._pl_check_plurals_N(word1a, word2a) or self._pl_check_plurals_N(word2a, word1a) ) ) def get_count(self, count: Optional[Union[str, int]] = None) -> Union[str, int]: if count is None and self.persistent_count is not None: count = self.persistent_count if count is not None: count = ( 1 if ( (str(count) in pl_count_one) or ( self.classical_dict["zero"] and str(count).lower() in pl_count_zero ) ) else 2 ) else: count = "" return count # @profile def _plnoun( # noqa: C901 self, word: str, count: Optional[Union[str, int]] = None ) -> str: count = self.get_count(count) # DEFAULT TO PLURAL if count == 1: return word # HANDLE USER-DEFINED NOUNS value = self.ud_match(word, self.pl_sb_user_defined) if value is not None: return value # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS if word == "": return word word = Words(word) if word.last.lower() in pl_sb_uninflected_complete: if len(word.split_) >= 3: return self._handle_long_compounds(word, count=2) or word return word if word in pl_sb_uninflected_caps: return word for k, v in pl_sb_uninflected_bysize.items(): if word.lowered[-k:] in v: return word if self.classical_dict["herd"] and word.last.lower() in pl_sb_uninflected_herd: return word # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.) mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word) if mo and mo.group(2) != "": return f"{self._plnoun(mo.group(1), 2)}{mo.group(2)}" if " a " in word.lowered or "-a-" in word.lowered: mo = PL_SB_PREP_DUAL_COMPOUND_RE.search(word) if mo and mo.group(2) != "" and mo.group(3) != "": return ( f"{self._plnoun(mo.group(1), 2)}" f"{mo.group(2)}" f"{self._plnoun(mo.group(3))}" ) if len(word.split_) >= 3: handled_words = self._handle_long_compounds(word, count=2) if handled_words is not None: return handled_words # only pluralize denominators in units mo = DENOMINATOR.search(word.lowered) if mo: index = len(mo.group("denominator")) return f"{self._plnoun(word[:index])}{word[index:]}" # handle units given in degrees (only accept if # there is no more than one word following) # degree Celsius => degrees Celsius but degree # fahrenheit hour => degree fahrenheit hours if len(word.split_) >= 2 and word.split_[-2] == "degree": return " ".join([self._plnoun(word.first)] + word.split_[1:]) with contextlib.suppress(ValueError): return self._handle_prepositional_phrase( word.lowered, functools.partial(self._plnoun, count=2), '-', ) # HANDLE PRONOUNS for k, v in pl_pron_acc_keys_bysize.items(): if word.lowered[-k:] in v: # ends with accusative pronoun for pk, pv in pl_prep_bysize.items(): if word.lowered[:pk] in pv: # starts with a prep if word.lowered.split() == [ word.lowered[:pk], word.lowered[-k:], ]: # only whitespace in between return word.lowered[:-k] + pl_pron_acc[word.lowered[-k:]] try: return pl_pron_nom[word.lowered] except KeyError: pass try: return pl_pron_acc[word.lowered] except KeyError: pass # HANDLE ISOLATED IRREGULAR PLURALS if word.last in pl_sb_irregular_caps: llen = len(word.last) return f"{word[:-llen]}{pl_sb_irregular_caps[word.last]}" lowered_last = word.last.lower() if lowered_last in pl_sb_irregular: llen = len(lowered_last) return f"{word[:-llen]}{pl_sb_irregular[lowered_last]}" dash_split = word.lowered.split('-') if (" ".join(dash_split[-2:])).lower() in pl_sb_irregular_compound: llen = len( " ".join(dash_split[-2:]) ) # TODO: what if 2 spaces between these words? return ( f"{word[:-llen]}" f"{pl_sb_irregular_compound[(' '.join(dash_split[-2:])).lower()]}" ) if word.lowered[-3:] == "quy": return f"{word[:-1]}ies" if word.lowered[-6:] == "person": if self.classical_dict["persons"]: return f"{word}s" else: return f"{word[:-4]}ople" # HANDLE FAMILIES OF IRREGULAR PLURALS if word.lowered[-3:] == "man": for k, v in pl_sb_U_man_mans_bysize.items(): if word.lowered[-k:] in v: return f"{word}s" for k, v in pl_sb_U_man_mans_caps_bysize.items(): if word[-k:] in v: return f"{word}s" return f"{word[:-3]}men" if word.lowered[-5:] == "mouse": return f"{word[:-5]}mice" if word.lowered[-5:] == "louse": v = pl_sb_U_louse_lice_bysize.get(len(word)) if v and word.lowered in v: return f"{word[:-5]}lice" return f"{word}s" if word.lowered[-5:] == "goose": return f"{word[:-5]}geese" if word.lowered[-5:] == "tooth": return f"{word[:-5]}teeth" if word.lowered[-4:] == "foot": return f"{word[:-4]}feet" if word.lowered[-4:] == "taco": return f"{word[:-5]}tacos" if word.lowered == "die": return "dice" # HANDLE UNASSIMILATED IMPORTS if word.lowered[-4:] == "ceps": return word if word.lowered[-4:] == "zoon": return f"{word[:-2]}a" if word.lowered[-3:] in ("cis", "sis", "xis"): return f"{word[:-2]}es" for lastlet, d, numend, post in ( ("h", pl_sb_U_ch_chs_bysize, None, "s"), ("x", pl_sb_U_ex_ices_bysize, -2, "ices"), ("x", pl_sb_U_ix_ices_bysize, -2, "ices"), ("m", pl_sb_U_um_a_bysize, -2, "a"), ("s", pl_sb_U_us_i_bysize, -2, "i"), ("n", pl_sb_U_on_a_bysize, -2, "a"), ("a", pl_sb_U_a_ae_bysize, None, "e"), ): if word.lowered[-1] == lastlet: # this test to add speed for k, v in d.items(): if word.lowered[-k:] in v: return word[:numend] + post # HANDLE INCOMPLETELY ASSIMILATED IMPORTS if self.classical_dict["ancient"]: if word.lowered[-4:] == "trix": return f"{word[:-1]}ces" if word.lowered[-3:] in ("eau", "ieu"): return f"{word}x" if word.lowered[-3:] in ("ynx", "inx", "anx") and len(word) > 4: return f"{word[:-1]}ges" for lastlet, d, numend, post in ( ("n", pl_sb_C_en_ina_bysize, -2, "ina"), ("x", pl_sb_C_ex_ices_bysize, -2, "ices"), ("x", pl_sb_C_ix_ices_bysize, -2, "ices"), ("m", pl_sb_C_um_a_bysize, -2, "a"), ("s", pl_sb_C_us_i_bysize, -2, "i"), ("s", pl_sb_C_us_us_bysize, None, ""), ("a", pl_sb_C_a_ae_bysize, None, "e"), ("a", pl_sb_C_a_ata_bysize, None, "ta"), ("s", pl_sb_C_is_ides_bysize, -1, "des"), ("o", pl_sb_C_o_i_bysize, -1, "i"), ("n", pl_sb_C_on_a_bysize, -2, "a"), ): if word.lowered[-1] == lastlet: # this test to add speed for k, v in d.items(): if word.lowered[-k:] in v: return word[:numend] + post for d, numend, post in ( (pl_sb_C_i_bysize, None, "i"), (pl_sb_C_im_bysize, None, "im"), ): for k, v in d.items(): if word.lowered[-k:] in v: return word[:numend] + post # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS if lowered_last in pl_sb_singular_s_complete: return f"{word}es" for k, v in pl_sb_singular_s_bysize.items(): if word.lowered[-k:] in v: return f"{word}es" if word.lowered[-2:] == "es" and word[0] == word[0].upper(): return f"{word}es" if word.lowered[-1] == "z": for k, v in pl_sb_z_zes_bysize.items(): if word.lowered[-k:] in v: return f"{word}es" if word.lowered[-2:-1] != "z": return f"{word}zes" if word.lowered[-2:] == "ze": for k, v in pl_sb_ze_zes_bysize.items(): if word.lowered[-k:] in v: return f"{word}s" if word.lowered[-2:] in ("ch", "sh", "zz", "ss") or word.lowered[-1] == "x": return f"{word}es" # HANDLE ...f -> ...ves if word.lowered[-3:] in ("elf", "alf", "olf"): return f"{word[:-1]}ves" if word.lowered[-3:] == "eaf" and word.lowered[-4:-3] != "d": return f"{word[:-1]}ves" if word.lowered[-4:] in ("nife", "life", "wife"): return f"{word[:-2]}ves" if word.lowered[-3:] == "arf": return f"{word[:-1]}ves" # HANDLE ...y if word.lowered[-1] == "y": if word.lowered[-2:-1] in "aeiou" or len(word) == 1: return f"{word}s" if self.classical_dict["names"]: if word.lowered[-1] == "y" and word[0] == word[0].upper(): return f"{word}s" return f"{word[:-1]}ies" # HANDLE ...o if lowered_last in pl_sb_U_o_os_complete: return f"{word}s" for k, v in pl_sb_U_o_os_bysize.items(): if word.lowered[-k:] in v: return f"{word}s" if word.lowered[-2:] in ("ao", "eo", "io", "oo", "uo"): return f"{word}s" if word.lowered[-1] == "o": return f"{word}es" # OTHERWISE JUST ADD ...s return f"{word}s" @classmethod def _handle_prepositional_phrase(cls, phrase, transform, sep): """ Given a word or phrase possibly separated by sep, parse out the prepositional phrase and apply the transform to the word preceding the prepositional phrase. Raise ValueError if the pivot is not found or if at least two separators are not found. >>> engine._handle_prepositional_phrase("man-of-war", str.upper, '-') 'MAN-of-war' >>> engine._handle_prepositional_phrase("man of war", str.upper, ' ') 'MAN of war' """ parts = phrase.split(sep) if len(parts) < 3: raise ValueError("Cannot handle words with fewer than two separators") pivot = cls._find_pivot(parts, pl_prep_list_da) transformed = transform(parts[pivot - 1]) or parts[pivot - 1] return " ".join( parts[: pivot - 1] + [sep.join([transformed, parts[pivot], ''])] ) + " ".join(parts[(pivot + 1) :]) def _handle_long_compounds(self, word: Words, count: int) -> Union[str, None]: """ Handles the plural and singular for compound `Words` that have three or more words, based on the given count. >>> engine()._handle_long_compounds(Words("pair of scissors"), 2) 'pairs of scissors' >>> engine()._handle_long_compounds(Words("men beyond hills"), 1) 'man beyond hills' """ inflection = self._sinoun if count == 1 else self._plnoun solutions = ( # type: ignore " ".join( itertools.chain( leader, [inflection(cand, count), prep], # type: ignore trailer, ) ) for leader, (cand, prep), trailer in windowed_complete(word.split_, 2) if prep in pl_prep_list_da # type: ignore ) return next(solutions, None) @staticmethod def _find_pivot(words, candidates): pivots = ( index for index in range(1, len(words) - 1) if words[index] in candidates ) try: return next(pivots) except StopIteration: raise ValueError("No pivot found") from None def _pl_special_verb( # noqa: C901 self, word: str, count: Optional[Union[str, int]] = None ) -> Union[str, bool]: if self.classical_dict["zero"] and str(count).lower() in pl_count_zero: return False count = self.get_count(count) if count == 1: return word # HANDLE USER-DEFINED VERBS value = self.ud_match(word, self.pl_v_user_defined) if value is not None: return value # HANDLE IRREGULAR PRESENT TENSE (SIMPLE AND COMPOUND) try: words = Words(word) except IndexError: return False # word is '' if words.first in plverb_irregular_pres: return f"{plverb_irregular_pres[words.first]}{words[len(words.first) :]}" # HANDLE IRREGULAR FUTURE, PRETERITE AND PERFECT TENSES if words.first in plverb_irregular_non_pres: return word # HANDLE PRESENT NEGATIONS (SIMPLE AND COMPOUND) if words.first.endswith("n't") and words.first[:-3] in plverb_irregular_pres: return ( f"{plverb_irregular_pres[words.first[:-3]]}n't" f"{words[len(words.first) :]}" ) if words.first.endswith("n't"): return word # HANDLE SPECIAL CASES mo = PLVERB_SPECIAL_S_RE.search(word) if mo: return False if WHITESPACE.search(word): return False if words.lowered == "quizzes": return "quiz" # HANDLE STANDARD 3RD PERSON (CHOP THE ...(e)s OFF SINGLE WORDS) if ( words.lowered[-4:] in ("ches", "shes", "zzes", "sses") or words.lowered[-3:] == "xes" ): return words[:-2] if words.lowered[-3:] == "ies" and len(words) > 3: return words.lowered[:-3] + "y" if ( words.last.lower() in pl_v_oes_oe or words.lowered[-4:] in pl_v_oes_oe_endings_size4 or words.lowered[-5:] in pl_v_oes_oe_endings_size5 ): return words[:-1] if words.lowered.endswith("oes") and len(words) > 3: return words.lowered[:-2] mo = ENDS_WITH_S.search(words) if mo: return mo.group(1) # OTHERWISE, A REGULAR VERB (HANDLE ELSEWHERE) return False def _pl_general_verb( self, word: str, count: Optional[Union[str, int]] = None ) -> str: count = self.get_count(count) if count == 1: return word # HANDLE AMBIGUOUS PRESENT TENSES (SIMPLE AND COMPOUND) mo = plverb_ambiguous_pres_keys.search(word) if mo: return f"{plverb_ambiguous_pres[mo.group(1).lower()]}{mo.group(2)}" # HANDLE AMBIGUOUS PRETERITE AND PERFECT TENSES mo = plverb_ambiguous_non_pres.search(word) if mo: return word # OTHERWISE, 1st OR 2ND PERSON IS UNINFLECTED return word def _pl_special_adjective( self, word: str, count: Optional[Union[str, int]] = None ) -> Union[str, bool]: count = self.get_count(count) if count == 1: return word # HANDLE USER-DEFINED ADJECTIVES value = self.ud_match(word, self.pl_adj_user_defined) if value is not None: return value # HANDLE KNOWN CASES mo = pl_adj_special_keys.search(word) if mo: return pl_adj_special[mo.group(1).lower()] # HANDLE POSSESSIVES mo = pl_adj_poss_keys.search(word) if mo: return pl_adj_poss[mo.group(1).lower()] mo = ENDS_WITH_APOSTROPHE_S.search(word) if mo: pl = self.plural_noun(mo.group(1)) trailing_s = "" if pl[-1] == "s" else "s" return f"{pl}'{trailing_s}" # OTHERWISE, NO IDEA return False # @profile def _sinoun( # noqa: C901 self, word: str, count: Optional[Union[str, int]] = None, gender: Optional[str] = None, ) -> Union[str, bool]: count = self.get_count(count) # DEFAULT TO PLURAL if count == 2: return word # SET THE GENDER try: if gender is None: gender = self.thegender elif gender not in singular_pronoun_genders: raise BadGenderError except (TypeError, IndexError) as err: raise BadGenderError from err # HANDLE USER-DEFINED NOUNS value = self.ud_match(word, self.si_sb_user_defined) if value is not None: return value # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS if word == "": return word if word in si_sb_ois_oi_case: return word[:-1] words = Words(word) if words.last.lower() in pl_sb_uninflected_complete: if len(words.split_) >= 3: return self._handle_long_compounds(words, count=1) or word return word if word in pl_sb_uninflected_caps: return word for k, v in pl_sb_uninflected_bysize.items(): if words.lowered[-k:] in v: return word if self.classical_dict["herd"] and words.last.lower() in pl_sb_uninflected_herd: return word if words.last.lower() in pl_sb_C_us_us: return word if self.classical_dict["ancient"] else False # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.) mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word) if mo and mo.group(2) != "": return f"{self._sinoun(mo.group(1), 1, gender=gender)}{mo.group(2)}" with contextlib.suppress(ValueError): return self._handle_prepositional_phrase( words.lowered, functools.partial(self._sinoun, count=1, gender=gender), ' ', ) with contextlib.suppress(ValueError): return self._handle_prepositional_phrase( words.lowered, functools.partial(self._sinoun, count=1, gender=gender), '-', ) # HANDLE PRONOUNS for k, v in si_pron_acc_keys_bysize.items(): if words.lowered[-k:] in v: # ends with accusative pronoun for pk, pv in pl_prep_bysize.items(): if words.lowered[:pk] in pv: # starts with a prep if words.lowered.split() == [ words.lowered[:pk], words.lowered[-k:], ]: # only whitespace in between return words.lowered[:-k] + get_si_pron( "acc", words.lowered[-k:], gender ) try: return get_si_pron("nom", words.lowered, gender) except KeyError: pass try: return get_si_pron("acc", words.lowered, gender) except KeyError: pass # HANDLE ISOLATED IRREGULAR PLURALS if words.last in si_sb_irregular_caps: llen = len(words.last) return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}" if words.last.lower() in si_sb_irregular: llen = len(words.last.lower()) return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}" dash_split = words.lowered.split("-") if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound: llen = len( " ".join(dash_split[-2:]) ) # TODO: what if 2 spaces between these words? return "{}{}".format( word[:-llen], si_sb_irregular_compound[(" ".join(dash_split[-2:])).lower()], ) if words.lowered[-5:] == "quies": return word[:-3] + "y" if words.lowered[-7:] == "persons": return word[:-1] if words.lowered[-6:] == "people": return word[:-4] + "rson" # HANDLE FAMILIES OF IRREGULAR PLURALS if words.lowered[-4:] == "mans": for k, v in si_sb_U_man_mans_bysize.items(): if words.lowered[-k:] in v: return word[:-1] for k, v in si_sb_U_man_mans_caps_bysize.items(): if word[-k:] in v: return word[:-1] if words.lowered[-3:] == "men": return word[:-3] + "man" if words.lowered[-4:] == "mice": return word[:-4] + "mouse" if words.lowered[-4:] == "lice": v = si_sb_U_louse_lice_bysize.get(len(word)) if v and words.lowered in v: return word[:-4] + "louse" if words.lowered[-5:] == "geese": return word[:-5] + "goose" if words.lowered[-5:] == "teeth": return word[:-5] + "tooth" if words.lowered[-4:] == "feet": return word[:-4] + "foot" if words.lowered == "dice": return "die" # HANDLE UNASSIMILATED IMPORTS if words.lowered[-4:] == "ceps": return word if words.lowered[-3:] == "zoa": return word[:-1] + "on" for lastlet, d, unass_numend, post in ( ("s", si_sb_U_ch_chs_bysize, -1, ""), ("s", si_sb_U_ex_ices_bysize, -4, "ex"), ("s", si_sb_U_ix_ices_bysize, -4, "ix"), ("a", si_sb_U_um_a_bysize, -1, "um"), ("i", si_sb_U_us_i_bysize, -1, "us"), ("a", si_sb_U_on_a_bysize, -1, "on"), ("e", si_sb_U_a_ae_bysize, -1, ""), ): if words.lowered[-1] == lastlet: # this test to add speed for k, v in d.items(): if words.lowered[-k:] in v: return word[:unass_numend] + post # HANDLE INCOMPLETELY ASSIMILATED IMPORTS if self.classical_dict["ancient"]: if words.lowered[-6:] == "trices": return word[:-3] + "x" if words.lowered[-4:] in ("eaux", "ieux"): return word[:-1] if words.lowered[-5:] in ("ynges", "inges", "anges") and len(word) > 6: return word[:-3] + "x" for lastlet, d, class_numend, post in ( ("a", si_sb_C_en_ina_bysize, -3, "en"), ("s", si_sb_C_ex_ices_bysize, -4, "ex"), ("s", si_sb_C_ix_ices_bysize, -4, "ix"), ("a", si_sb_C_um_a_bysize, -1, "um"), ("i", si_sb_C_us_i_bysize, -1, "us"), ("s", pl_sb_C_us_us_bysize, None, ""), ("e", si_sb_C_a_ae_bysize, -1, ""), ("a", si_sb_C_a_ata_bysize, -2, ""), ("s", si_sb_C_is_ides_bysize, -3, "s"), ("i", si_sb_C_o_i_bysize, -1, "o"), ("a", si_sb_C_on_a_bysize, -1, "on"), ("m", si_sb_C_im_bysize, -2, ""), ("i", si_sb_C_i_bysize, -1, ""), ): if words.lowered[-1] == lastlet: # this test to add speed for k, v in d.items(): if words.lowered[-k:] in v: return word[:class_numend] + post # HANDLE PLURLS ENDING IN uses -> use if ( words.lowered[-6:] == "houses" or word in si_sb_uses_use_case or words.last.lower() in si_sb_uses_use ): return word[:-1] # HANDLE PLURLS ENDING IN ies -> ie if word in si_sb_ies_ie_case or words.last.lower() in si_sb_ies_ie: return word[:-1] # HANDLE PLURLS ENDING IN oes -> oe if ( words.lowered[-5:] == "shoes" or word in si_sb_oes_oe_case or words.last.lower() in si_sb_oes_oe ): return word[:-1] # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS if word in si_sb_sses_sse_case or words.last.lower() in si_sb_sses_sse: return word[:-1] if words.last.lower() in si_sb_singular_s_complete: return word[:-2] for k, v in si_sb_singular_s_bysize.items(): if words.lowered[-k:] in v: return word[:-2] if words.lowered[-4:] == "eses" and word[0] == word[0].upper(): return word[:-2] if words.last.lower() in si_sb_z_zes: return word[:-2] if words.last.lower() in si_sb_zzes_zz: return word[:-2] if words.lowered[-4:] == "zzes": return word[:-3] if word in si_sb_ches_che_case or words.last.lower() in si_sb_ches_che: return word[:-1] if words.lowered[-4:] in ("ches", "shes"): return word[:-2] if words.last.lower() in si_sb_xes_xe: return word[:-1] if words.lowered[-3:] == "xes": return word[:-2] # HANDLE ...f -> ...ves if word in si_sb_ves_ve_case or words.last.lower() in si_sb_ves_ve: return word[:-1] if words.lowered[-3:] == "ves": if words.lowered[-5:-3] in ("el", "al", "ol"): return word[:-3] + "f" if words.lowered[-5:-3] == "ea" and word[-6:-5] != "d": return word[:-3] + "f" if words.lowered[-5:-3] in ("ni", "li", "wi"): return word[:-3] + "fe" if words.lowered[-5:-3] == "ar": return word[:-3] + "f" # HANDLE ...y if words.lowered[-2:] == "ys": if len(words.lowered) > 2 and words.lowered[-3] in "aeiou": return word[:-1] if self.classical_dict["names"]: if words.lowered[-2:] == "ys" and word[0] == word[0].upper(): return word[:-1] if words.lowered[-3:] == "ies": return word[:-3] + "y" # HANDLE ...o if words.lowered[-2:] == "os": if words.last.lower() in si_sb_U_o_os_complete: return word[:-1] for k, v in si_sb_U_o_os_bysize.items(): if words.lowered[-k:] in v: return word[:-1] if words.lowered[-3:] in ("aos", "eos", "ios", "oos", "uos"): return word[:-1] if words.lowered[-3:] == "oes": return word[:-2] # UNASSIMILATED IMPORTS FINAL RULE if word in si_sb_es_is: return word[:-2] + "is" # OTHERWISE JUST REMOVE ...s if words.lowered[-1] == "s": return word[:-1] # COULD NOT FIND SINGULAR return False # ADJECTIVES @typechecked def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str: """ Return the appropriate indefinite article followed by text. The indefinite article is either 'a' or 'an'. If count is not one, then return count followed by text instead of 'a' or 'an'. Whitespace at the start and end is preserved. """ mo = INDEFINITE_ARTICLE_TEST.search(text) if mo: word = mo.group(2) if not word: return text pre = mo.group(1) post = mo.group(3) result = self._indef_article(word, count) return f"{pre}{result}{post}" return "" an = a _indef_article_cases = ( # HANDLE ORDINAL FORMS (A_ordinal_a, "a"), (A_ordinal_an, "an"), # HANDLE SPECIAL CASES (A_explicit_an, "an"), (SPECIAL_AN, "an"), (SPECIAL_A, "a"), # HANDLE ABBREVIATIONS (A_abbrev, "an"), (SPECIAL_ABBREV_AN, "an"), (SPECIAL_ABBREV_A, "a"), # HANDLE CONSONANTS (CONSONANTS, "a"), # HANDLE SPECIAL VOWEL-FORMS (ARTICLE_SPECIAL_EU, "a"), (ARTICLE_SPECIAL_ONCE, "a"), (ARTICLE_SPECIAL_ONETIME, "a"), (ARTICLE_SPECIAL_UNIT, "a"), (ARTICLE_SPECIAL_UBA, "a"), (ARTICLE_SPECIAL_UKR, "a"), (A_explicit_a, "a"), # HANDLE SPECIAL CAPITALS (SPECIAL_CAPITALS, "a"), # HANDLE VOWELS (VOWELS, "an"), # HANDLE y... # (BEFORE CERTAIN CONSONANTS IMPLIES (UNNATURALIZED) "i.." SOUND) (A_y_cons, "an"), ) def _indef_article(self, word: str, count: Union[int, str, Any]) -> str: mycount = self.get_count(count) if mycount != 1: return f"{count} {word}" # HANDLE USER-DEFINED VARIANTS value = self.ud_match(word, self.A_a_user_defined) if value is not None: return f"{value} {word}" matches = ( f'{article} {word}' for regexen, article in self._indef_article_cases if regexen.search(word) ) # OTHERWISE, GUESS "a" fallback = f'a {word}' return next(matches, fallback) # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)" @typechecked def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str: """ If count is 0, no, zero or nil, return 'no' followed by the plural of text. If count is one of: 1, a, an, one, each, every, this, that return count followed by text. Otherwise return count follow by the plural of text. In the return value count is always followed by a space. Whitespace at the start and end is preserved. """ if count is None and self.persistent_count is not None: count = self.persistent_count if count is None: count = 0 mo = PARTITION_WORD.search(text) if mo: pre = mo.group(1) word = mo.group(2) post = mo.group(3) else: pre = "" word = "" post = "" if str(count).lower() in pl_count_zero: count = 'no' return f"{pre}{count} {self.plural(word, count)}{post}" # PARTICIPLES @typechecked def present_participle(self, word: Word) -> str: """ Return the present participle for word. word is the 3rd person singular verb. """ plv = self.plural_verb(word, 2) ans = plv for regexen, repl in PRESENT_PARTICIPLE_REPLACEMENTS: ans, num = regexen.subn(repl, plv) if num: return f"{ans}ing" return f"{ans}ing" # NUMERICAL INFLECTIONS @typechecked def ordinal(self, num: Union[Number, Word]) -> str: """ Return the ordinal of num. >>> ordinal = engine().ordinal >>> ordinal(1) '1st' >>> ordinal('one') 'first' """ if DIGIT.match(str(num)): if isinstance(num, (float, int)) and int(num) == num: n = int(num) else: if "." in str(num): try: # numbers after decimal, # so only need last one for ordinal n = int(str(num)[-1]) except ValueError: # ends with '.', so need to use whole string n = int(str(num)[:-1]) else: n = int(num) # type: ignore try: post = nth[n % 100] except KeyError: post = nth[n % 10] return f"{num}{post}" else: return self._sub_ord(num) def millfn(self, ind: int = 0) -> str: if ind > len(mill) - 1: raise NumOutOfRangeError return mill[ind] def unitfn(self, units: int, mindex: int = 0) -> str: return f"{unit[units]}{self.millfn(mindex)}" def tenfn(self, tens, units, mindex=0) -> str: if tens != 1: tens_part = ten[tens] if tens and units: hyphen = "-" else: hyphen = "" unit_part = unit[units] mill_part = self.millfn(mindex) return f"{tens_part}{hyphen}{unit_part}{mill_part}" return f"{teen[units]}{mill[mindex]}" def hundfn(self, hundreds: int, tens: int, units: int, mindex: int) -> str: if hundreds: andword = f" {self._number_args['andword']} " if tens or units else "" # use unit not unitfn as simpler return ( f"{unit[hundreds]} hundred{andword}" f"{self.tenfn(tens, units)}{self.millfn(mindex)}, " ) if tens or units: return f"{self.tenfn(tens, units)}{self.millfn(mindex)}, " return "" def group1sub(self, mo: Match) -> str: units = int(mo.group(1)) if units == 1: return f" {self._number_args['one']}, " elif units: return f"{unit[units]}, " else: return f" {self._number_args['zero']}, " def group1bsub(self, mo: Match) -> str: units = int(mo.group(1)) if units: return f"{unit[units]}, " else: return f" {self._number_args['zero']}, " def group2sub(self, mo: Match) -> str: tens = int(mo.group(1)) units = int(mo.group(2)) if tens: return f"{self.tenfn(tens, units)}, " if units: return f" {self._number_args['zero']} {unit[units]}, " return f" {self._number_args['zero']} {self._number_args['zero']}, " def group3sub(self, mo: Match) -> str: hundreds = int(mo.group(1)) tens = int(mo.group(2)) units = int(mo.group(3)) if hundreds == 1: hunword = f" {self._number_args['one']}" elif hundreds: hunword = str(unit[hundreds]) else: hunword = f" {self._number_args['zero']}" if tens: tenword = self.tenfn(tens, units) elif units: tenword = f" {self._number_args['zero']} {unit[units]}" else: tenword = f" {self._number_args['zero']} {self._number_args['zero']}" return f"{hunword} {tenword}, " def hundsub(self, mo: Match) -> str: ret = self.hundfn( int(mo.group(1)), int(mo.group(2)), int(mo.group(3)), self.mill_count ) self.mill_count += 1 return ret def tensub(self, mo: Match) -> str: return f"{self.tenfn(int(mo.group(1)), int(mo.group(2)), self.mill_count)}, " def unitsub(self, mo: Match) -> str: return f"{self.unitfn(int(mo.group(1)), self.mill_count)}, " def enword(self, num: str, group: int) -> str: # import pdb # pdb.set_trace() if group == 1: num = DIGIT_GROUP.sub(self.group1sub, num) elif group == 2: num = TWO_DIGITS.sub(self.group2sub, num) num = DIGIT_GROUP.sub(self.group1bsub, num, 1) elif group == 3: num = THREE_DIGITS.sub(self.group3sub, num) num = TWO_DIGITS.sub(self.group2sub, num, 1) num = DIGIT_GROUP.sub(self.group1sub, num, 1) elif int(num) == 0: num = self._number_args["zero"] elif int(num) == 1: num = self._number_args["one"] else: num = num.lstrip().lstrip("0") self.mill_count = 0 # surely there's a better way to do the next bit mo = THREE_DIGITS_WORD.search(num) while mo: num = THREE_DIGITS_WORD.sub(self.hundsub, num, 1) mo = THREE_DIGITS_WORD.search(num) num = TWO_DIGITS_WORD.sub(self.tensub, num, 1) num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1) return num @staticmethod def _sub_ord(val): new = ordinal_suff.sub(lambda match: ordinal[match.group(1)], val) return new + "th" * (new == val) @classmethod def _chunk_num(cls, num, decimal, group): if decimal: max_split = -1 if group != 0 else 1 chunks = num.split(".", max_split) else: chunks = [num] return cls._remove_last_blank(chunks) @staticmethod def _remove_last_blank(chunks): """ Remove the last item from chunks if it's a blank string. Return the resultant chunks and whether the last item was removed. """ removed = chunks[-1] == "" result = chunks[:-1] if removed else chunks return result, removed @staticmethod def _get_sign(num): return {'+': 'plus', '-': 'minus'}.get(num.lstrip()[0], '') @typechecked def number_to_words( # noqa: C901 self, num: Union[Number, Word], wantlist: bool = False, group: int = 0, comma: Union[Falsish, str] = ",", andword: str = "and", zero: str = "zero", one: str = "one", decimal: Union[Falsish, str] = "point", threshold: Optional[int] = None, ) -> Union[str, List[str]]: """ Return a number in words. group = 1, 2 or 3 to group numbers before turning into words comma: define comma andword: word for 'and'. Can be set to ''. e.g. "one hundred and one" vs "one hundred one" zero: word for '0' one: word for '1' decimal: word for decimal point threshold: numbers above threshold not turned into words parameters not remembered from last call. Departure from Perl version. """ self._number_args = {"andword": andword, "zero": zero, "one": one} num = str(num) # Handle "stylistic" conversions (up to a given threshold)... if threshold is not None and float(num) > threshold: spnum = num.split(".", 1) while comma: (spnum[0], n) = FOUR_DIGIT_COMMA.subn(r"\1,\2", spnum[0]) if n == 0: break try: return f"{spnum[0]}.{spnum[1]}" except IndexError: return str(spnum[0]) if group < 0 or group > 3: raise BadChunkingOptionError sign = self._get_sign(num) if num in nth_suff: num = zero myord = num[-2:] in nth_suff if myord: num = num[:-2] chunks, finalpoint = self._chunk_num(num, decimal, group) loopstart = chunks[0] == "" first: bool | None = not loopstart def _handle_chunk(chunk): nonlocal first # remove all non numeric \D chunk = NON_DIGIT.sub("", chunk) if chunk == "": chunk = "0" if group == 0 and not first: chunk = self.enword(chunk, 1) else: chunk = self.enword(chunk, group) if chunk[-2:] == ", ": chunk = chunk[:-2] chunk = WHITESPACES_COMMA.sub(",", chunk) if group == 0 and first: chunk = COMMA_WORD.sub(f" {andword} \\1", chunk) chunk = WHITESPACES.sub(" ", chunk) # chunk = re.sub(r"(\A\s|\s\Z)", self.blankfn, chunk) chunk = chunk.strip() if first: first = None return chunk chunks[loopstart:] = map(_handle_chunk, chunks[loopstart:]) numchunks = [] if first != 0: numchunks = chunks[0].split(f"{comma} ") if myord and numchunks: numchunks[-1] = self._sub_ord(numchunks[-1]) for chunk in chunks[1:]: numchunks.append(decimal) numchunks.extend(chunk.split(f"{comma} ")) if finalpoint: numchunks.append(decimal) if wantlist: return [sign] * bool(sign) + numchunks signout = f"{sign} " if sign else "" valout = ( ', '.join(numchunks) if group else ''.join(self._render(numchunks, decimal, comma)) ) return signout + valout @staticmethod def _render(chunks, decimal, comma): first_item = chunks.pop(0) yield first_item first = decimal is None or not first_item.endswith(decimal) for nc in chunks: if nc == decimal: first = False elif first: yield comma yield f" {nc}" @typechecked def join( self, words: Optional[Sequence[Word]], sep: Optional[str] = None, sep_spaced: bool = True, final_sep: Optional[str] = None, conj: str = "and", conj_spaced: bool = True, ) -> str: """ Join words into a list. e.g. join(['ant', 'bee', 'fly']) returns 'ant, bee, and fly' options: conj: replacement for 'and' sep: separator. default ',', unless ',' is in the list then ';' final_sep: final separator. default ',', unless ',' is in the list then ';' conj_spaced: boolean. Should conj have spaces around it """ if not words: return "" if len(words) == 1: return words[0] if conj_spaced: if conj == "": conj = " " else: conj = f" {conj} " if len(words) == 2: return f"{words[0]}{conj}{words[1]}" if sep is None: if "," in "".join(words): sep = ";" else: sep = "," if final_sep is None: final_sep = sep final_sep = f"{final_sep}{conj}" if sep_spaced: sep += " " return f"{sep.join(words[0:-1])}{final_sep}{words[-1]}" _vendor/__pycache__/typing_extensions.cpython-310.pyc 0000644 00000303753 15030122015 0016702 0 ustar 00 o �h3 � @ s. d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZ d dl Z d dl Z g d�Z dZ eZejdkZG dd� d�Ze� ZejdkrMdd � Znejd krWd d � Znd d � Ze jZe �d �Ze �d�Ze �d�Ze jddd�Ze jddd�Zejdkr�d dl m Z nG dd� de�Z G dd� de d�Z e j Z G dd � d e j dd �Z e j!Z!ejdkr�e j"Z"nd d � Z"d d!� Z#ejd"kr�e j$Z$n"d#d$� Z%d%d&� Z&G d'd(� d(e j'dd �Z(G d)d*� d*e dd �Z)e)d+d,�Z$e j*Z*e+e d-�r�e j,Z,e j-Z-e j.Z.ne�/e�0ej/e1��Z2d.d/� Z,d0d-� Z-d1d2� Z.e j3Z3e j4Z4e j5Z5e j6Z6e j7Z7e j8Z8e j9Z9e j:Z:e j;Z;e j<Z<e j=Z=e j>Z>ejdk�rDd d3l m?Z?m@Z@mAZAmBZB nHd4d5� ZCeDe d6e j'�ZEG d7d6� d6eEdd �ZFed�ZGeFej jBd8eGeGfd9�ZBeFej j@d:eGfd9�Z@eFejHd:d;e jIeJ fd<�ZAeFejKd:d=e jIeJ fd<�Z?g d>�d?d@gdAgdB�ZLeMe jN�h dC�B ZOdDdE� ZP�d dFdG�ZQejdHk�r�e jRZRn*�d dIdJ�ZSdKdL� ZTdMdN� ZUG dOdP� dPee jR��ZVeWdQdR� �ZXG dSdT� dTe jYeVd�ZRejdHk�r�e jZZZndUdV� ZZeZZ[ejdWk�r e j\Z\e j]Z]e j^Z^e j_Z_e j`Z`e jaZae jbZbnJeZG dXdY� dYeR��Z\eZG dZd[� d[eR��Z]eZG d\d]� d]eR��Z^eZG d^d_� d_eR��Z_eZG d`da� daeR��Z`eZG dbdc� dceRe ��ZaeZG ddde� deeRe ��Zbdfdg� ZcdhZded�rge jeZee jfZfe jgZgn@die�he ji�jjv Zkdjdk� ZlG dldm� dme�Zfe�mefdndoi �Znecdpdq� �efddhdr�dsdn��Zee+e dm��r�e jfeffZoneffZodtdu� Zge+e dv��r�e jpZpndwdv� Zpe+e dx��r�e jqZqn dydz� Zr�d!d{d|�Zqe+e d}��r�e jsZse jtZtnG d~d� de j'dd �ZtG d�d}� d}�Zsejdd:� dk�r�e juZue jvZvn4zd d�l mwZw W n ex�y e j'ZwY nw zd d�l myZz W n ex�y$ e j'ZzY nw d�d�� Zud�d�� Zve+e d���r7e j{Z{nejdd:� d k�rHe d�d�� �Z{ne d�d�d,�Z{e+e d���rXe j|Z|nG d�d�� d�e�Z}G d�d�� d�e}d�Z~e~� Z|[~[}d�d�� Zd�d�� Z�G d�d�� d��Z�G d�d�� d�e�Z�e�r�d d�l mZ n G d�d�� d�e�d�Ze+e d���r�e j�Z�e j�Z�nG d�d�� d��Z�G d�d�� d�e��Z�G d�d�� d�e��Z�e�r�d d�l m�Z� ne+e d���r�G d�d�� d�e�d�Z�n G d�d�� d�e�e��Z�e+e d���s�G d�d�� d�e��Z�e j�d�d�� �Z�e+e d���re j�Z�e j�Z�n!ejdd:� d k�re d�d�� �Z�nG d�d�� d�e dd �Z�e�d�d�d,�Z�e+e d���r,e j�Z�n!ejdd:� d k�r=e d�d�� �Z�nG d�d�� d�e dd �Z�e�d�d�d,�Z�e+e d���rWe j�Z�n!ejdd:� d k�rhe d�d�� �Z�nG d�d�� d�e dd �Z�e�d�d�d,�Z�G d�d�� d�e j�dd �Z e+e d���r�e j�Z�ne d�d�� �Z�e+e d���r�e j�Z�ne d�d�� �Z�e+e d���r�e j�Z�ne d�d�� �Z�e+e d���r�e j�Z�e j�Z�n-ejdd:� d k�r�e d�d�� �Z�e d�d �Z�nG d�dĄ d�e dd �Z�e�d�d�d,�Z�e�d�d�d,�Z�e+e dx��r�e j�Z�n!ejdd:� d k�re d�dx� �Z�nG d�dɄ d�e dd �Z�e�dxd�d,�Z�d�Z�ejdWk�r(e j�Z�d�d̈́ Z�nIejdd:� d k�rRG d�dτ d�e dd �Z�G d�dф d�e j'dd �Z�e�d�dӄ �Z�d�d̈́ Z�n G d�dф d�e j'dd �Z�G d�dׄ d�e dd �Z�e�d�e�d,�Z�d�d̈́ Z�e�r{d d�l m�Z� n e+e dڃ�r�d�d܄ Z�G d�dڄ d�e�d�Z�nG d�dڄ d�e��Z�e+e d߃�r�e j�Z�n d�ed�efd�d߄Z�e+e d��r�e j�Z�nd�Z�e+e d��r�e j�Z�n d�e�d�e�fd�d�Z�ejdWk�r�e j�Z�n5ddhdhdhdod�d�eJd�eJd�eJd�eJd�e j�e j�e j3e j e j�d�e j f f d�f d�e j d�e j�egef fd�d�Z�e+e d��re j�Z�ne jd�e j�d�e j f d�Z�d�e�d�e�fd�d�Z�e+e d���r2e j�Z�n e �d��Z�G d�d�� d��Z�e+e dڃ�sKefd�d��Z�nd�d�� Z�e�sUe�e _�d�eJfd�d��Z�e�eDe d�d�hZ�d�eJfd�d��Z�e+e �d ��r~�d"�d�d �Z�e�e _�n �d�d� Z�e�s�e�e _�ejdHk�r�e j�Z�n8�d#�d�d�Z�e j�Z�eMh �d��Z�G �d�d� �de�Z�e�me��d doi �Z��d �d � Z�ece��ef�d �d ��Z�e+ej dA��r�ej j�Z�nG �d dA� dAe j��Z�e���e�� e���e�� e���e�� e+e �d��r�e j�Z�n�d�d� Z�ejdk�r e j�Z�n G �d�d� �d�Z�e+e �d��r!e j�Z�n�d�d� Z�G �d�d� �d�Z�e+e �d��r?e j�Z�e j�Z�n�ded�eJf�d�d�ZŐded�e j�e� f�d�d�Z�e+e �d��ree j�Z�n G �d �d� �d�Z�eDe �d d�Z�e�du �r�zd dl�Z�W n ex�y� Y nw eDeːd d�Z�e�du�r�eẽZ�e�du�r�e�Z�e �ΐd � e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e jYZYe j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e jIZIe j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�e j�Z�dS ($ � N)m�Any�ClassVar� Concatenate�Final� LiteralString� ParamSpec� ParamSpecArgs�ParamSpecKwargs�Self�Type�TypeVar� TypeVarTuple�Unpack� Awaitable� AsyncIterator� AsyncIterable� Coroutine�AsyncGenerator�AsyncContextManager�Buffer�ChainMap�ContextManager�Counter�Deque� DefaultDict� NamedTuple� OrderedDict� TypedDict� SupportsAbs� SupportsBytes�SupportsComplex� SupportsFloat� SupportsIndex� SupportsInt� SupportsRound� Annotated� assert_never� assert_type�clear_overloads�dataclass_transform� deprecated�Doc� get_overloads�final�get_args� get_origin�get_original_bases�get_protocol_members�get_type_hints�IntVar� is_protocol� is_typeddict�Literal�NewType�overload�override�Protocol� reveal_type�runtime�runtime_checkable�Text� TypeAlias� TypeAliasType� TypeGuard�TypeIs� TYPE_CHECKING�Never�NoReturn�ReadOnly�Required� NotRequired� AbstractSet�AnyStr�BinaryIO�Callable� Collection� Container�Dict� ForwardRef� FrozenSet� Generator�Generic�Hashable�IO� ItemsView�Iterable�Iterator�KeysView�List�Mapping� MappingView�Match�MutableMapping�MutableSequence� MutableSet� NoDefault�Optional�Pattern� Reversible�Sequence�Set�Sized�TextIO�Tuple�Union� ValuesView�cast� no_type_check�no_type_check_decoratorT)� � r �betac @ � e Zd Zdd� ZdS )� _Sentinelc C � dS )Nz <sentinel>� ��selfru ru �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typing_extensions.py�__repr__� � z_Sentinel.__repr__N��__name__� __module__� __qualname__ry ru ru ru rx rs � � rs �ro � c C s t | tjtjtjf�S �N)� isinstance�typing� _GenericAlias�_types� GenericAlias� UnionType��tru ru rx � _should_collect_from_parameters� s �r� �ro � c C s t | tjtjf�S r� )r� r� r� r� r� r� ru ru rx r� � � c C s t | tj�o | j S r� )r� r� r� �_specialr� ru ru rx r� � � �T�KT�VT�T_co)� covariant�T_contra)� contravariant)ro � )r c s( e Zd Z� fdd�Z� fdd�Z� ZS )�_AnyMetac s | t u rtd��t� �|�S )Nz6typing_extensions.Any cannot be used with isinstance())r � TypeError�super�__instancecheck__�rw �obj�� __class__ru rx r� � s z_AnyMeta.__instancecheck__c s | t u rdS t� �� S )Nztyping_extensions.Any)r r� ry rv r� ru rx ry � s z_AnyMeta.__repr__)r| r} r~ r� ry � __classcell__ru ru r� rx r� � s r� c s e Zd ZdZ� fdd�Z� ZS )r aq Special type indicating an unconstrained type. - Any is compatible with every type. - Any assumed to have all methods. - All values assumed to be instances of Any. Note that all the above statements are true from the point of view of static type checkers. At runtime, Any should not be used with instance checks. c s* | t u rtd��t� j| g|�R i |��S )NzAny cannot be instantiated)r r� r� �__new__��cls�args�kwargsr� ru rx r� � s z Any.__new__)r| r} r~ �__doc__r� r� ru ru r� rx r � s r )� metaclassc @ rr )�_ExtensionsSpecialFormc C s d| j S �Nztyping_extensions.��_namerv ru ru rx ry � � z _ExtensionsSpecialForm.__repr__Nr{ ru ru ru rx r� � r r� )�_rootc C �& zd| _ W | S ttfy Y | S w )a� This decorator can be used to indicate to type checkers that the decorated method cannot be overridden, and decorated class cannot be subclassed. For example: class Base: @final def done(self) -> None: ... class Sub(Base): def done(self) -> None: # Error reported by type checker ... @final class Leaf: ... class Other(Leaf): # Error reported by type checker ... There is no runtime checking of these properties. The decorator sets the ``__final__`` attribute to ``True`` on the decorated object to allow runtime introspection. T)� __final__�AttributeErrorr� )�fru ru rx r- � s ��r- c C � t �| �S r� )r� r )�nameru ru rx r3 � r� r3 )ro r� � c C s8 g }| D ]}t |t�r|�|j� q|�|� qt|�S )zJAn internal helper for Literal creation: flatten Literals among parameters)r� �_LiteralGenericAlias�extend�__args__�append�tuple)� parameters�params�pru ru rx �_flatten_literal_params s r� c c s � | D ] }|t |�fV qd S r� )�type)r� r� ru ru rx �_value_and_type_iter s ��r� c @ s e Zd Zdd� Zdd� ZdS )r� c C s2 t |t�stS tt| j��}tt|j��}||kS r� )r� r� �NotImplemented�setr� r� )rw �other�these_args_deduped�other_args_dedupedru ru rx �__eq__ s z_LiteralGenericAlias.__eq__c C s t tt| j���S r� )�hash� frozensetr� r� rv ru ru rx �__hash__ r� z _LiteralGenericAlias.__hash__N)r| r} r~ r� r� ru ru ru rx r� s r� c @ s" e Zd Zdefdd�Zdd� ZdS )� _LiteralForm�docc C s d| _ | | _| _d S )Nr6 )r� �_docr� )rw r� ru ru rx �__init__! s z_LiteralForm.__init__c C s� t |t�s|f}t|�}tt|��}zt|�}W n ty! Y n*w t|�t|�k rKg }|D ]}||v r@|�|d � |� |� q.|rGJ |��t|�}t | |�S )Nr ) r� r� r� �listr� r� r� �lenr� �remover� )rw r� �val_type_pairs� deduped_pairs�new_parameters�pairru ru rx � __getitem__% s& � � z_LiteralForm.__getitem__N)r| r} r~ �strr� r� ru ru ru rx r� s r� a� A type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: var: Literal[4] = 4 The type checker understands that 'var' is literally equal to the value 4 and no other value. Literal[...] cannot be subclassed. There is no runtime checking verifying that the parameter is actually a value instead of a type.)r� r, c C s@ t | d| �}z| t|j |j |jj< W tS ty Y tS w )a� Decorator for overloaded functions/methods. In a stub file, place two or more stub definitions for the same function in a row, each decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... In a non-stub file (i.e. a regular .py file), do the same but follow it with an implementation. The implementation should *not* be decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... def utf8(value): # implementation goes here The overloads for a function can be retrieved at runtime using the get_overloads() function. �__func__)�getattr�_overload_registryr} r~ �__code__�co_firstlinenor� �_overload_dummy)�funcr� ru ru rx r8 Z s �� ��r8 c C sD t | d| �}|jtvr g S t|j }|j|vrg S t||j �� �S )z6Return all defined overloads for *func* as a sequence.r� )r� r} r� r~ r� �values)r� r� �mod_dictru ru rx r, � s c C s t �� dS )z$Clear all overloads in the registry.N)r� �clearru ru ru rx r( � � r( )r r r rR c C s | � d�o | �d�S )N�__)� startswith�endswith)�attrru ru rx � _is_dunder� r� r� �_SpecialGenericAliasc s< e Zd Zdddd�� fdd� Zdd� Zejd d � �Z� ZS ) r� TNru )�instr� �defaultsc sL t tju r|| _|| _t� j||d||d� n t� j||||d� || _d S )NT)�specialr� r� )r� r� )�_special_generic_alias_baser� r� � __origin__�_nparamsr� r� � _defaults)rw �origin�nparamsr� r� r� r� ru rx r� � s z _SpecialGenericAlias.__init__c C sP h d�}t tju r|�d� t|�s||v r t�| ||� d S t| j||� d S )N> �_instr� r� r� r� ) r� r� r� �addr� �object� __setattr__�setattrr� )rw r� �val� allowed_attrsru ru rx r� � s z _SpecialGenericAlias.__setattr__c s� t |t�s|f}d� t� fdd�|D ��}| jr<t|�| jk r<t|�t| j� | jkr<g |�| jt|�| j d � �R }t|�}|| jkrz| jrTd| jt| j� � �}nt| j�}| jsct| � d���td|| jkrldnd� d | � d |� d |� ���| �|�S ) Nz*Parameters to generic types must be types.c 3 � � | ] }t �|� �V qd S r� �r� � _type_check��.0r� ��msgru rx � <genexpr>� � � z3_SpecialGenericAlias.__getitem__.<locals>.<genexpr>� at least � is not a generic class�Too �many�few� arguments for � ; actual � , expected )r� r� r� r� r� r� r� � copy_with)rw r� � actual_len�expectedru r� rx r� � s4 �" ���� z _SpecialGenericAlias.__getitem__) r| r} r~ r� r� r� � _tp_cacher� r� ru ru r� rx r� � s ro )r� � r )r� r� r ) rL r rW rX r rT rg rN rM rd r �AbstractContextManager�AbstractAsyncContextManagerr )zcollections.abc� contextlib�typing_extensions> r� �__match_args__�__protocol_attrs__� __non_callable_proto_members__c C sh t � }| jd d� D ]'}|jdv rq t|di �}g |j�|�R D ]}|�d�s0|tvr0|�|� q q |S )N���> rS r: �__annotations__�_abc_)r� �__mro__r| r� �__dict__r� �_EXCLUDED_ATTRSr� )r� �attrs�base� annotationsr� ru ru rx �_get_protocol_attrs s ��r c C s0 z t �| �j�dd�W S ttfy Y d S w )Nr| �__main__)�sys� _getframe� f_globals�getr� � ValueError��depthru ru rx �_caller s �r' �ro rp c C s t | �dv S )z�Allow instance and class checks for special stdlib modules. The abc and functools modules indiscriminately call isinstance() and issubclass() on the whole MRO of a user class, which may contain protocols. > N�abc� functools)r' r% ru ru rx � _allow_reckless_class_checks s r+ c O s t | �jr td��d S )Nz Protocols cannot be instantiated)r� � _is_protocolr� �rw r� r� ru ru rx �_no_init% s �r. c C s t | t�s td��dS )a� Raise TypeError if `arg` is not an instance of `type` in `issubclass(arg, <protocol>)`. In most cases, this is verified by type.__subclasscheck__. Checking it again unnecessarily would slow down issubclass() checks, so, we don't perform this check unless we absolutely have to. For various error paths, however, we want to ensure that *this* error message is shown to the user where relevant, rather than a typing.py-specific error message. z"issubclass() arg 1 must be a classN)r� r� r� ��argru ru rx � _type_check_issubclass_arg_1) s �r1 c @ sB e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd efd d �Z dS )� _ProtocolMetac K s� |dkr t |�dk r n-ttjht|�@ r8|D ]!}|ttjttjhv s7|jt�|j g �v s7t |�s7t d|����qt j j| |||fi |��S )Nr: r z5Protocols can only inherit from other protocols, got )r� r: r� r� r� rS r| �_PROTO_ALLOWLISTr# r} r4 r� r) �ABCMetar� )�mclsr� �bases� namespacer� r ru ru rx r� C s ����z_ProtocolMeta.__new__c O s8 t jj| g|�R i |�� t| dd�rt| �| _d S d S )Nr, F)r) r4 r� r� r r r� ru ru rx r� S s �z_ProtocolMeta.__init__c C s� | t u r t�| |�S t| dd�rCt� sCt| dd�s!t|� td��| jrC| j� d�t u rCt|� t | j�}tdt |�dd� � d ���t j�| |�S ) Nr, F�_is_runtime_protocol�LInstance and class checks can only be used with @runtime_checkable protocols�__subclasshook__zRProtocols with non-method members don't support issubclass(). Non-method members: r� r �.)r: r� �__subclasscheck__r� r+ r1 r� r r r# � _proto_hook�sortedr� r) r4 )r� r� �non_method_attrsru ru rx r< X s, �� �� ��z _ProtocolMeta.__subclasscheck__c C s� | t u r t�| |�S t| dd�stj�| |�S t| dd�s$t� s$td��tj�| |�r-dS | jD ]"}zt � ||�}W n t yE Y dS w |d u rR|| j vrR dS q0dS )Nr, Fr8 r9 T) r: r� r� r� r) r4 r+ r� r �inspect�getattr_staticr� r )r� �instancer� r� ru ru rx r� r s. �� ���z _ProtocolMeta.__instancecheck__c C s( t j�| |�du r dS | tu o|tju S )NT)r) r4 r� r: r� �r� r� ru ru rx r� � s z_ProtocolMeta.__eq__�returnc C r� r� )r� r� �r� ru ru rx r� � r� z_ProtocolMeta.__hash__N) r| r} r~ r� r� r< r� r� �intr� ru ru ru rx r2 < s r2 c C s� | j �dd�s tS | jD ]7}|jD ]-}||j v r'|j | d u r%t S n t|di �}t|tjj �r>||v r>t |�r> nqt S q dS )Nr, Fr T) r r# r� r r r� r� � collectionsr) r[ r4 )r� r� r� r r ru ru rx r= � s& ����r= c s0 e Zd ZejjZdZdZdZ� fdd�Z � Z S )r: ru TFc sj t � j|i |�� | j�dd�stdd� | jD ��| _d| jvr#t| _| jr1| j t j u r3t | _ d S d S d S )Nr, Fc s s � | ]}|t u V qd S r� )r: �r� �bru ru rx r� � � � z-Protocol.__init_subclass__.<locals>.<genexpr>r: ) r� �__init_subclass__r r# �any� __bases__r, r= r: r� r: r. r� r� ru rx rK � s �zProtocol.__init_subclass__) r| r} r~ r� r: r� � __slots__r, r8 rK r� ru ru r� rx r: � s r: c C s� t | tj�r t| dd�std| ����d| _t| t�s tj dkrRt � | _ | j D ]*}z t t| |d��}W n tyH } z td|�d��|�d}~ww |sQ| j �|� q'| S ) aj Mark a protocol class as a runtime protocol. Such protocol can be used with isinstance() and issubclass(). Raise TypeError if applied to a non-protocol class. This allows a simple-minded structural check very similar to one trick ponies in collections.abc such as Iterable. For example:: @runtime_checkable class Closable(Protocol): def close(self): ... assert isinstance(open('/some/file'), Closable) Warning: this will check only the presence of the required methods, not their type signatures! r, Fz@@runtime_checkable can be only applied to protocol classes, got T)ro � r Nz,Failed to determine whether protocol member z is a method member)� issubclassr� rS r� r� r8 r� r2 r � version_infor� r r �callable� Exceptionr� )r� r� � is_callable�eru ru rx r= � s, � ���� �r= �ro rO c @ �( e Zd ZdZdZejdefdd��ZdS )r# z(An ABC with one abstract method __int__.ru rD c C � d S r� ru rv ru ru rx �__int__ � zSupportsInt.__int__N) r| r} r~ r� rN r) �abstractmethodrF rY ru ru ru rx r# � r# c @ rW )r! z*An ABC with one abstract method __float__.ru rD c C rX r� ru rv ru ru rx � __float__" rZ zSupportsFloat.__float__N) r| r} r~ r� rN r) r[ �floatr] ru ru ru rx r! r\ r! c @ rW )r z,An ABC with one abstract method __complex__.ru rD c C rX r� ru rv ru ru rx � __complex__+ rZ zSupportsComplex.__complex__N) r| r} r~ r� rN r) r[ �complexr_ ru ru ru rx r & r\ r c @ rW )r z*An ABC with one abstract method __bytes__.ru rD c C rX r� ru rv ru ru rx � __bytes__4 rZ zSupportsBytes.__bytes__N) r| r} r~ r� rN r) r[ �bytesra ru ru ru rx r / r\ r c @ s$ e Zd ZdZejdefdd��ZdS )r" ru rD c C rX r� ru rv ru ru rx � __index__< rZ zSupportsIndex.__index__N)r| r} r~ rN r) r[ rF rc ru ru ru rx r" 8 s r" c @ rW )r z_ An ABC with one abstract method __abs__ that is covariant in its return type. ru rD c C rX r� ru rv ru ru rx �__abs__G rZ zSupportsAbs.__abs__N) r| r} r~ r� rN r) r[ r� rd ru ru ru rx r @ s r c @ s. e Zd ZdZdZejd dedefdd��Z dS ) r$ za An ABC with one abstract method __round__ that is covariant in its return type. ru r �ndigitsrD c C rX r� ru )rw re ru ru rx � __round__R rZ zSupportsRound.__round__N)r ) r| r} r~ r� rN r) r[ rF r� rf ru ru ru rx r$ K s r$ c s � fdd�}|S )Nc sN t jjdkr"t jdk r"t| �t� �d�}t| jd|�}t�|� | �S � | _ | S )N�pypyr� )�__call__�__mro_entries__ru ) r �implementationr� rQ � staticmethodr� r| r* �update_wrapperri )r� �cls_dictr� �� mro_entriesru rx �innerX s �z#_ensure_subclassable.<locals>.innerru )ro rp ru rn rx �_ensure_subclassableW s rq F�modulec c s� � t | �}|tu rt| �}|r|d } n+d S |tu r$tV t| �\} n |tu r1tV t| �\} n|tu r>tV t| �\} nd S q)NTr )r/ r% r. rG rH rF )�annotation_type�annotation_origin�annotation_argsru ru rx �_get_typeddict_qualifiers~ s& � �rv c @ s, e Zd Zddd�dd�ZeZdd� ZeZdS ) �_TypedDictMetaTF��total�closedc s� |D ]}t |�tur|tjurtd��qtdd� |D ��r"tjf}nd}t �tdg |�t�R |��|�_�j dkr<|�_ t �d�sD|�_ i }d|v rO|d } n d|v rZ|d d �} ni } d � t rm� �fd d �| � � D �} n � fd d �| � � D �} t� } t� } t� } t� } d}|D ]>}|j}|�|�di �� | �|�dd�� | �|�dd�� | �|�dd�� | �|�dd�� |�dd�}|dur�|}q�|r�|du r�t}|r�d| v r�| �d�}tt|��}t|v r�td��t|v r�td��|}|�| � | � � D ]H\}}tt|��}t|v �r| �|� nt|v �r| �|� n|�r$| �|� n| �|� t|v �r9| �|� | �|� q�| �|� | �|� q�|�_t| ��_ t| ��_ t| ��_ t| ��_ t �d��sd|�_ |�_!|�_"�S )aI Create new typed dict class object. This method is called when TypedDict is subclassed, or when TypedDict is instantiated. This way TypedDict supports all three syntax forms described in its docstring. Subclasses and instances of TypedDict return actual dictionaries. zHcannot inherit from both a TypedDict type and a non-TypedDict base classc s s � | ] }t |tj�V qd S r� )rP r� rS rH ru ru rx r� � r z)_TypedDictMeta.__new__.<locals>.<genexpr>ru r: �__orig_bases__r � __annotate__r� z?TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a typec s$ i | ]\}}|t j|� �jd ��qS )�rr )r� r� r} �r� �n�tp�r� �tp_dictru rx � <dictcomp>� s ��z*_TypedDictMeta.__new__.<locals>.<dictcomp>c s i | ] \}}|t �|� ��qS ru r� r~ r� ru rx r� � s ��N�__required_keys__�__optional_keys__�__readonly_keys__�__mutable_keys__�__extra_items__z5Special key __extra_items__ does not support Requiredz8Special key __extra_items__ does not support NotRequired� __total__)#r� rw r� rS r� rL r� �dictr| r~ �hasattrr{ � _TAKES_MODULE�itemsr� r �updater# rD �poprv rG rH r� rF �discardr r� r� r� r� r� r� � __closed__r� )r� r� r6 �nsry rz r � generic_baser �own_annotations� required_keys� optional_keys� readonly_keys� mutable_keys�extra_items_type� base_dict�base_extra_items_typers � qualifiers�annotation_keyru r� rx r� � s� � � � � �� z_TypedDictMeta.__new__c C � t d��)Nz4TypedDict does not support instance and class checks�r� rC ru ru rx r< � z _TypedDictMeta.__subclasscheck__N)r| r} r~ r� r� rh r< r� ru ru ru rx rw � s prw r ru c C s t fS r� )� _TypedDict�r6 ru ru rx �<lambda> s r� rx c K s� |t u s|du r<|t u rd}nd}d| � d| �d�}|� d�| d }tj|td d � |d ur9|d ur9||d < d }|}n|rBtd��|rUtjdkrMtd��tjdtd d � dt|�i}t� } | durf| |d< t | d|||d�} t f| _ | S )aq A simple typed namespace. At runtime it is equivalent to a plain dict. TypedDict creates a dictionary type such that a type checker will expect all instances to have a certain set of keys, where each key is associated with a value of a consistent type. This expectation is not checked at runtime. Usage:: class Point2D(TypedDict): x: int y: int label: str a: Point2D = {'x': 1, 'y': 2, 'label': 'good'} # OK b: Point2D = {'z': 3, 'label': 'bad'} # Fails type check assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first') The type info can be accessed via the Point2D.__annotations__ dict, and the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets. TypedDict supports an additional equivalent form:: Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str}) By default, all keys must be present in a TypedDict. It is possible to override this by specifying totality:: class Point2D(TypedDict, total=False): x: int y: int This means that a Point2D TypedDict can have any of the keys omitted. A type checker is only expected to support a literal False or True as the value of the total argument. True is the default, and makes all items defined in the class body be required. The Required and NotRequired special forms can also be used to mark individual keys as being required or not required:: class Point2D(TypedDict): x: int # the "x" key must always be present (Required is the default) y: NotRequired[int] # the "y" key can be omitted See PEP 655 for more details on Required and NotRequired. N�2Failing to pass a value for the 'fields' parameter�(Passing `None` as the 'fields' parameter�`z = TypedDict(z, {})`z� is deprecated and will be disallowed in Python 3.15. To create a TypedDict class with 0 fields using the functional syntax, pass an empty dictionary, e.g. r; r �� stacklevelFTrz z@TypedDict takes either a dict or keyword arguments, but not bothr( z$TypedDict takes no keyword argumentsz�The kwargs-based syntax for TypedDict definitions is deprecated in Python 3.11, will be removed in Python 3.13, and may not be understood by third-party type checkers.r r} ru rx ) �_marker�warnings�warn�DeprecationWarningr� r rQ r� r' rw r r{ ) �typename�fieldsry rz r� �deprecated_thing�example�deprecation_msgr� rr �tdru ru rx r s@ 0�� � c C s" t td�r | tju r dS t| t�S )a Check if an annotation is a TypedDict class For example:: class Film(TypedDict): title: str year: int is_typeddict(Film) # => True is_typeddict(Union[list, str]) # => False r F)r� r� r r� �_TYPEDDICT_TYPES�r� ru ru rx r5 l s r5 r' c C � | S )a� Assert (to the type checker) that the value is of the given type. When the type checker encounters a call to assert_type(), it emits an error if the value is not of the specified type:: def greet(name: str) -> None: assert_type(name, str) # ok assert_type(name, int) # type checker error At runtime this returns the first argument unchanged and otherwise does nothing. ru )r� �typru ru rx r' � s rF c C s t | t�r t| j�S t| d�r | jtttfv r t| jd �S t | t j �r:t dd� | jD ��}|| jkr5| S | � |�S tt d�r]t | t j�r]t dd� | jD ��}|| jkrV| S t �| j|�S tt d�r�t | t j�r�t dd� | jD ��}|| jkry| S t�tj|�S | S ) z=Strips Annotated, Required and NotRequired from a given type.r� r c s � � | ]}t |�V qd S r� �� _strip_extras�r� �aru ru rx r� � rJ z _strip_extras.<locals>.<genexpr>r� c s r� r� r� r� ru ru rx r� � rJ r� c s r� r� r� r� ru ru rx r� � rJ )r� �_AnnotatedAliasr� r� r� rG rH rF r� r� r� r� r r� r� r� r* �reduce�operator�or_)r� � stripped_argsru ru rx r� � s( r� c C sH t td�rtj| ||dd�}ntj| ||d�}|r|S dd� |�� D �S )a� Return type hints for an object. This is often the same as obj.__annotations__, but it handles forward references encoded as string literals, adds Optional[t] if a default value equal to None is set and recursively replaces all 'Annotated[T, ...]', 'Required[T]' or 'NotRequired[T]' with 'T' (unless 'include_extras=True'). The argument may be a module, class, method, or function. The annotations are returned as a dictionary. For classes, annotations include also inherited members. TypeError is raised if the argument is not of a type that can contain annotations, and an empty dictionary is returned if no annotations are present. BEWARE -- the behavior of globalns and localns is counterintuitive (unless you are familiar with how eval() and exec() work). The search order is locals first, then globals. - If no dict arguments are passed, an attempt is made to use the globals from obj (or the respective module's globals for classes), and these are also used as the locals. If the object does not appear to have globals, an empty dictionary is used. - If one dict argument is passed, it is used for both globals and locals. - If two dict arguments are passed, they specify globals and locals, respectively. r% T)�globalns�localns�include_extras)r� r� c S s i | ] \}}|t |��qS ru r� )r� �kr� ru ru rx r� � s z"get_type_hints.<locals>.<dictcomp>)r� r� r2 r� )r� r� r� r� �hintru ru rx r2 � s �r2 r% c sH e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd d � Zd d � Z � Z S )r� aK Runtime representation of an annotated type. At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't' with extra annotations. The alias behaves like a normal typing alias, instantiating is the same as instantiating the underlying type, binding it to types is also the same. c s2 t |t�r |j| }|j}t� �||� || _d S r� )r� r� � __metadata__r� r� r� )rw r� �metadatar� ru rx r� � s z_AnnotatedAlias.__init__c C s$ t |�dksJ �|d }t|| j�S )Nr� r )r� r� r� )rw r� �new_typeru ru rx r � s z_AnnotatedAlias.copy_withc C s, dt �| j�� dd�dd� | jD ��� d�S )Nz typing_extensions.Annotated[�, c s r� r� )�reprr� ru ru rx r� � rJ z+_AnnotatedAlias.__repr__.<locals>.<genexpr>�])r� � _type_reprr� �joinr� rv ru ru rx ry � s �z_AnnotatedAlias.__repr__c C s t jt| jg| j�R ffS r� )r� �getitemr% r� r� rv ru ru rx � __reduce__� s �z_AnnotatedAlias.__reduce__c C s* t |t�stS | j|jkrdS | j|jkS )NF)r� r� r� r� r� �rw r� ru ru rx r� � s z_AnnotatedAlias.__eq__c C � t | j| jf�S r� )r� r� r� rv ru ru rx r� � z_AnnotatedAlias.__hash__) r| r} r~ r� r� r ry r� r� r� r� ru ru r� rx r� � s r� c @ s2 e Zd ZdZdZdd� Zejdd� �Zdd� Z d S ) r% a� Add context specific metadata to a type. Example: Annotated[int, runtime_check.Unsigned] indicates to the hypothetical runtime_check module that this type is an unsigned int. Every other consumer of this type can ignore this metadata and treat this type as int. The first argument to Annotated must be a valid type (and will be in the __origin__ field), the remaining arguments are kept as a tuple in the __extra__ field. Details: - It's an error to call `Annotated` with less than two arguments. - Nested Annotated are flattened:: Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3] - Instantiating an annotated type is equivalent to instantiating the underlying type:: Annotated[C, Ann1](5) == C(5) - Annotated can be used as a generic type alias:: Optimized = Annotated[T, runtime.Optimize()] Optimized[int] == Annotated[int, runtime.Optimize()] OptimizedList = Annotated[List[T], runtime.Optimize()] OptimizedList[int] == Annotated[List[int], runtime.Optimize()] ru c O r� )Nz&Type Annotated cannot be instantiated.r� r� ru ru rx r� * � zAnnotated.__new__c C sn t |t�r t|�dk rtd��ttf}t|d �|v r |d }n d}t�|d |�}t|dd � �}t ||�S )Nr zUAnnotated[...] should be used with at least two arguments (a type and an annotation).r z$Annotated[t, ...]: t must be a type.r� ) r� r� r� r� r r r/ r� r� r� )r� r� �allowed_special_formsr� r� r� ru ru rx �__class_getitem__- s zAnnotated.__class_getitem__c O s t d| j� d���)N�Cannot subclass z .Annotated)r� r} r� ru ru rx rK < s �zAnnotated.__init_subclass__N) r| r} r~ r� rN r� r� r r� rK ru ru ru rx r% s )�_BaseGenericAlias)r� c C s> t | t�rtS t | tjttttf�r| j S | tj u r tj S dS )a6 Get the unsubscripted version of a type. This supports generic types, Callable, Tuple, Union, Literal, Final, ClassVar and Annotated. Return None for unsupported types. Examples:: get_origin(Literal[42]) is Literal get_origin(int) is None get_origin(ClassVar[int]) is ClassVar get_origin(Generic) is Generic get_origin(Generic[T]) is Generic get_origin(Union[T, int]) is Union get_origin(List[Tuple[T, T]][int]) == list get_origin(P.args) is P N) r� r� r% r� r� �_typing_GenericAliasr� r r r� rS r� ru ru rx r/ T s � r/ c C s| t | t�r | jg| j�R S t | tjtf�r<t| dd�r dS | j}t | �t j j u r:|d t ur:t|dd� �|d f}|S dS )a� Get type arguments with all substitutions performed. For unions, basic simplifications used by Union constructor are performed. Examples:: get_args(Dict[str, int]) == (str, int) get_args(int) == () get_args(Union[int, Union[T, int], str][int]) == (int, str) get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int]) get_args(Callable[[], T][int]) == ([], int) r� Fru r Nr )r� r� r� r� r� r� r� r� r� r/ rG r) rL �Ellipsisr� )r� �resru ru rx r. l s r. r? c C � t | � d���)a& Special marker indicating that an assignment should be recognized as a proper type alias definition by type checkers. For example:: Predicate: TypeAlias = Callable[..., bool] It's invalid when used anywhere except as in the example above. � is not subscriptabler� �rw r� ru ru rx r? � s a% Special marker indicating that an assignment should be recognized as a proper type alias definition by type checkers. For example:: Predicate: TypeAlias = Callable[..., bool] It's invalid when used anywhere except as in the example above.ra c @ rr )�NoDefaultTypeMetac C s t d|�d| j����)Nz cannot set z attribute of immutable type �r� r| )r� r� �valueru ru rx r� � s �z NoDefaultTypeMeta.__setattr__N)r| r} r~ r� ru ru ru rx r� � r r� c @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S ) � NoDefaultTypez$The type of the NoDefault singleton.ru c C s t � �d�p t�| �S �Nra )�globalsr# r� r� rE ru ru rx r� � s zNoDefaultType.__new__c C rt )Nztyping_extensions.NoDefaultru rv ru ru rx ry � rz zNoDefaultType.__repr__c C rt r� ru rv ru ru rx r� � rz zNoDefaultType.__reduce__N)r| r} r~ r� rN r� ry r� ru ru ru rx r� � s r� c s � fdd�| _ � | _d S )Nc s � t uS r� )ra ru ��defaultru rx r� � s z _set_default.<locals>.<lambda>)� has_default� __default__)� type_paramr� ru r� rx � _set_default� s r� c C s t dd�}|dkr|| _d S d S )Nro r% r )r' r} )� typevarlike�def_modru ru rx � _set_module� s �r� c @ s e Zd ZdZdZeZdS )� _DefaultMixinz Mixin for TypeVarLike defaults.ru N)r| r} r~ r� rN r� r� ru ru ru rx r� � s r� c @ s e Zd Zdedefdd�ZdS )�_TypeVarLikeMeta�_TypeVarLikeMeta__instancerD c C s t || j�S r� )r� �_backported_typevarlike)r� r� ru ru rx r� � � z"_TypeVarLikeMeta.__instancecheck__N)r| r} r~ r �boolr� ru ru ru rx r� � s r� )r c @ s6 e Zd ZdZejZdddedd�dd�Zd dd �Z dS ) r zType variable.NF)�boundr� r� r� �infer_variancec s� t td�rtj|g|�R ||||d��� ntj|g|�R |||d��� |r-|s)|r-td��|� _t� |� t� � � fdd�}|� _� S )Nr@ �r� r� r� r� �r� r� r� z1Variance cannot be specified with infer_variance.c s, � � � r| j�� �t|�kr|� jf7 }|S r� )r� �__parameters__�indexr� r� )�aliasr� ��typevarru rx �_tvar_prepare_subst� s � z,TypeVar.__new__.<locals>._tvar_prepare_subst)r� r� r r$ �__infer_variance__r� r� �__typing_prepare_subst__) r� r� r� r� r� r� r� � constraintsr� ru r� rx r� � s �� zTypeVar.__new__rD c C � t dt� d���)N�type 'z(.TypeVar' is not an acceptable base typer� rE ru ru rx rK r� zTypeVar.__init_subclass__�rD N) r| r} r~ r� r� r r� ra r� rK ru ru ru rx r � s � r r c @ s$ e Zd ZdZdZdd� Zdd� ZdS )� _Immutablez3Mixin to indicate that object should not be copied.ru c C r� r� ru rv ru ru rx �__copy__ rz z_Immutable.__copy__c C r� r� ru )rw �memoru ru rx � __deepcopy__ rz z_Immutable.__deepcopy__N)r| r} r~ r� rN r r ru ru ru rx r s r c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) r aQ The args for a ParamSpec object. Given a ParamSpec object P, P.args is an instance of ParamSpecArgs. ParamSpecArgs objects have a reference back to their ParamSpec: P.args.__origin__ is P This type is meant for runtime introspection and has no special meaning to static type checkers. c C � || _ d S r� �r� �rw r� ru ru rx r� ! r� zParamSpecArgs.__init__c C � | j j� d�S )Nz.args�r� r| rv ru ru rx ry $ � zParamSpecArgs.__repr__c C � t |t�stS | j|jkS r� )r� r r� r� r� ru ru rx r� ' � zParamSpecArgs.__eq__N�r| r} r~ r� r� ry r� ru ru ru rx r � c @ r ) r a[ The kwargs for a ParamSpec object. Given a ParamSpec object P, P.kwargs is an instance of ParamSpecKwargs. ParamSpecKwargs objects have a reference back to their ParamSpec: P.kwargs.__origin__ is P This type is meant for runtime introspection and has no special meaning to static type checkers. c C r r� r r ru ru rx r� 8 r� zParamSpecKwargs.__init__c C r )Nz.kwargsr rv ru ru rx ry ; r zParamSpecKwargs.__repr__c C r r� )r� r r� r� r� ru ru rx r� > r zParamSpecKwargs.__eq__Nr ru ru ru rx r , r r )r r c @ s6 e Zd ZdZejZdddded�dd�Zd dd �Z dS ) r zParameter specification.NF�r� r� r� r� r� c s` t td�rtj|||||d�� n tj||||d�� |� _t� |� t� � � fdd�}|� _� S )Nr@ r� r� c s� | j }|�� �}|t|�kr� �� rg |�� j�}|t|�kr&td| � ���t|�dkr>t�|d �s>|dks9J �|f}|S t|| t �r\g |d |� �t || ��||d d � �R }|S )N�Too few arguments for r� r ) r� r� r� r� r� r� r� �_is_param_exprr� r� r� )r� r� r� �i�� paramspecru rx �_paramspec_prepare_substb s �.z3ParamSpec.__new__.<locals>._paramspec_prepare_subst)r� r� r r� r� r� r� )r� r� r� r� r� r� r� r ru r rx r� P s �� zParamSpec.__new__rD c C r )Nr z*.ParamSpec' is not an acceptable base typer� rE ru ru rx rK u r� zParamSpec.__init_subclass__r ) r| r} r~ r� r� r r� ra r� rK ru ru ru rx r K s �%c @ sl e Zd ZdZejZedd� �Zedd� �Z dddde d�d d �Z d d � Z d d� Z dd� Zdd� Zdd� ZdS )r a' Parameter specification variable. Usage:: P = ParamSpec('P') Parameter specification variables exist primarily for the benefit of static type checkers. They are used to forward the parameter types of one callable to another callable, a pattern commonly found in higher order functions and decorators. They are only valid when used in ``Concatenate``, or s the first argument to ``Callable``. In Python 3.10 and higher, they are also supported in user-defined Generics at runtime. See class Generic for more information on generic types. An example for annotating a decorator:: T = TypeVar('T') P = ParamSpec('P') def add_logging(f: Callable[P, T]) -> Callable[P, T]: '''A type-safe decorator to add logging to a function.''' def inner(*args: P.args, **kwargs: P.kwargs) -> T: logging.info(f'{f.__name__} was called') return f(*args, **kwargs) return inner @add_logging def add_two(x: float, y: float) -> float: '''Add two numbers together.''' return x + y Parameter specification variables defined with covariant=True or contravariant=True can be used to declare covariant or contravariant generic types. These keyword arguments are valid, but their actual semantics are yet to be decided. See PEP 612 for details. Parameter specification variables can be introspected. e.g.: P.__name__ == 'T' P.__bound__ == None P.__covariant__ == False P.__contravariant__ == False Note that only parameter specification variables defined in global scope can be pickled. c C � t | �S r� )r rv ru ru rx r� � r� zParamSpec.argsc C r r� )r rv ru ru rx r� � r� zParamSpec.kwargsNFr c C st t �| | g� || _t|�| _t|�| _t|�| _|r#t�|d�| _ nd | _ t �| |� t � }|dkr8|| _ d S d S )NzBound must be a type.r ) r� r� r| r� � __covariant__�__contravariant__r� r� r� � __bound__r� r' r} )rw r� r� r� r� r� r� r� ru ru rx r� � s �zParamSpec.__init__c C s2 | j rd}n| jr d}n| jrd}nd}|| j S )N� �+�-�~)r� r r r| )rw �prefixru ru rx ry � s zParamSpec.__repr__c C r� r� �r� r� rv ru ru rx r� � r� zParamSpec.__hash__c C � | |u S r� ru r� ru ru rx r� � r� zParamSpec.__eq__c C � | j S r� �r| rv ru ru rx r� � � zParamSpec.__reduce__c O rX r� ru r- ru ru rx rh � rz zParamSpec.__call__)r| r} r~ r� r� r r� �propertyr� r� ra r� ry r� r� r� rh ru ru ru rx r | s / � r c sJ e Zd ZejZdZ� fdd�Zdd� Zdd� Z dd � Z e d d � �Z � Z S ) �_ConcatenateGenericAliasFc s t � �|� || _|| _d S r� )r� r� r� r� )rw r� r� r� ru rx r� � s z!_ConcatenateGenericAlias.__init__c s2 t j� � | j�� dd�� fdd�| jD ��� d�S )N�[r� c 3 s � | ]}� |�V qd S r� ru )r� r0 �r� ru rx r� � rJ z4_ConcatenateGenericAlias.__repr__.<locals>.<genexpr>r� )r� r� r� r� r� rv ru r* rx ry � s �z!_ConcatenateGenericAlias.__repr__c C r� r� )r� r� r� rv ru ru rx r� � r� z!_ConcatenateGenericAlias.__hash__c O rX r� ru r- ru ru rx rh � rz z!_ConcatenateGenericAlias.__call__c C s t dd� | jD ��S )Nc s s$ � | ] }t |tjtf�r|V qd S r� )r� r� r r )r� r� ru ru rx r� � s � � �z:_ConcatenateGenericAlias.__parameters__.<locals>.<genexpr>)r� r� rv ru ru rx r� � s �z'_ConcatenateGenericAlias.__parameters__)r| r} r~ r� r� r� r� r� ry r� rh r' r� r� ru ru r� rx r( � s r( c sZ |dkrt d��t|t�s|f}t|d t�st d��d� t� fdd�|D ��}t| |�S )Nru z&Cannot take a Concatenate of no types.r zAThe last parameter to Concatenate should be a ParamSpec variable.z/Concatenate[arg, ...]: each arg must be a type.c 3 r� r� r� r� r� ru rx r� r z'_concatenate_getitem.<locals>.<genexpr>)r� r� r� r r( r� ru r� rx �_concatenate_getitem s r+ c C � t | |�S )�& Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. �r+ r� ru ru rx r s c @ rr )�_ConcatenateFormc C r, r� r. r� ru ru rx r� ) r� z _ConcatenateForm.__getitem__N�r| r} r~ r� ru ru ru rx r/ ( r r/ r- rA c C � t �|| � d��}t �| |f�S )� Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). � accepts only a single type.�r� r� r� �rw r� �itemru ru rx rA > s ,c @ rr )�_TypeGuardFormc C �" t �|| j� d��}t �| |f�S �Nz accepts only a single type�r� r� r� r� r5 ru ru rx r� o � �z_TypeGuardForm.__getitem__Nr0 ru ru ru rx r7 n r r7 r2 rB c C r1 )�z Special typing form used to annotate the return type of a user-defined type narrower function. ``TypeIs`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeIs[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeIs`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the intersection of the type inside ``TypeGuard`` and the argument's previously known type. For example:: def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]: return hasattr(val, '__await__') def f(val: Union[int, Awaitable[int]]) -> int: if is_awaitable(val): assert_type(val, Awaitable[int]) else: assert_type(val, int) ``TypeIs`` also works with type variables. For more information, see PEP 742 (Narrowing types with TypeIs). r3 r4 r5 ru ru rx rB � s &c @ rr )� _TypeIsFormc C r8 r9 r: r5 ru ru rx r� � r; z_TypeIsForm.__getitem__Nr0 ru ru ru rx r= � r r= r< c @ sn e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z ejdd� �ZdS )� _SpecialForm)r� r� �_getitemc C s || _ |j| _|j| _d S r� )r? r| r� r� �rw r� ru ru rx r� s z_SpecialForm.__init__c C s |dv r| j S t|��)N> r| r~ )r� r� )rw r6 ru ru rx � __getattr__ s z_SpecialForm.__getattr__c C � t d| ����)Nr� r� )rw r6 ru ru rx ri r z _SpecialForm.__mro_entries__c C s d| j � �S r� r� rv ru ru rx ry r� z_SpecialForm.__repr__c C r$ r� r� rv ru ru rx r� r& z_SpecialForm.__reduce__c O rB )NzCannot instantiate r� �rw r� �kwdsru ru rx rh r z_SpecialForm.__call__c C � t j| |f S r� �r� rj r� ru ru rx �__or__ r z_SpecialForm.__or__c C � t j|| f S r� rF r� ru ru rx �__ror__ r z_SpecialForm.__ror__c C r� )Nz! cannot be used with isinstance()r� r� ru ru rx r� r z _SpecialForm.__instancecheck__c C r� )Nz! cannot be used with issubclass()r� )rw r� ru ru rx r< " r z _SpecialForm.__subclasscheck__c C s | � | |�S r� )r? r� ru ru rx r� % r� z_SpecialForm.__getitem__N)r| r} r~ rN r� rA ri ry r� rh rG rI r� r< r� r r� ru ru ru rx r> � s r> r c C r� )aD Represents an arbitrary literal string. Example:: from typing_extensions import LiteralString def query(sql: LiteralString) -> ...: ... query("SELECT * FROM table") # ok query(f"SELECT * FROM {input()}") # not ok See PEP 675 for details. r� r� �rw r� ru ru rx r - s r c C r� )z�Used to spell the type of "self" in classes. Example:: from typing import Self class ReturnsSelf: def parse(self, data: bytes) -> Self: ... return self r� r� rJ ru ru rx r D s rD c C r� )a� The bottom type, a type that has no members. This can be used to define a function that should never be called, or a function that never returns:: from typing_extensions import Never def never_call_me(arg: Never) -> None: pass def int_or_str(arg: int | str) -> None: never_call_me(arg) # type checker error match arg: case int(): print("It's an int") case str(): print("It's a str") case _: never_call_me(arg) # ok, arg is of type Never r� r� rJ ru ru rx rD Y s rG c C r8 )�� A special typing construct to mark a key of a total=False TypedDict as required. For example: class Movie(TypedDict, total=False): title: Required[str] year: int m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) There is no runtime checking that a required key is actually provided when instantiating a related TypedDict. r3 r: r5 ru ru rx rG x s c C r8 )�` A special typing construct to mark a key of a TypedDict as potentially missing. For example: class Movie(TypedDict): title: str year: NotRequired[int] m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) r3 r: r5 ru ru rx rH � s rH c @ rr )� _RequiredFormc C r8 �Nr3 r: r5 ru ru rx r� � r; z_RequiredForm.__getitem__Nr0 ru ru ru rx rM � r rM rK rL c C r8 )a� A special typing construct to mark an item of a TypedDict as read-only. For example: class Movie(TypedDict): title: ReadOnly[str] year: int def mutate_movie(m: Movie) -> None: m["year"] = 1992 # allowed m["title"] = "The Matrix" # typechecker error There is no runtime checking for this property. r3 r: r5 ru ru rx rF � s c @ rr )� _ReadOnlyFormc C r8 rN r: r5 ru ru rx r� � r; z_ReadOnlyForm.__getitem__Nr0 ru ru ru rx rO � r rO a� A special typing construct to mark a key of a TypedDict as read-only. For example: class Movie(TypedDict): title: ReadOnly[str] year: int def mutate_movie(m: Movie) -> None: m["year"] = 1992 # allowed m["title"] = "The Matrix" # typechecker error There is no runtime checking for this propery. a� Type unpack operator. The type unpack operator takes the child types from some container type, such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For example: # For some generic class `Foo`: Foo[Unpack[tuple[int, str]]] # Equivalent to Foo[int, str] Ts = TypeVarTuple('Ts') # Specifies that `Bar` is generic in an arbitrary number of types. # (Think of `Ts` as a tuple of an arbitrary number of individual # `TypeVar`s, which the `Unpack` is 'pulling out' directly into the # `Generic[]`.) class Bar(Generic[Unpack[Ts]]): ... Bar[int] # Valid Bar[int, str] # Also valid From Python 3.11, this can also be done using the `*` operator: Foo[*tuple[int, str]] class Bar(Generic[*Ts]): ... The operator can also be used along with a `TypedDict` to annotate `**kwargs` in a function signature. For instance: class Movie(TypedDict): name: str year: int # This function expects two keyword arguments - *name* of type `str` and # *year* of type `int`. def foo(**kwargs: Unpack[Movie]): ... Note that there is only some runtime checking of this operator. Not everything the runtime allows may be accepted by static type checkers. For more information, see PEP 646 and PEP 692. c C s t | �tu S r� )r/ r �r� ru ru rx � _is_unpack! r� rQ c s e Zd Z� fdd�Z� ZS )�_UnpackSpecialFormc s t � �|� t| _d S r� )r� r� � _UNPACK_DOCr� r@ r� ru rx r� & s z_UnpackSpecialForm.__init__)r| r} r~ r� r� ru ru r� rx rR % s rR c @ s e Zd ZejZedd� �ZdS )� _UnpackAliasc C sV | j tu sJ �t| j�dksJ �| j\}t|tjtjf�r)|j t ur&t d��|jS d S )Nr� z*Unpack[...] must be used with a tuple type) r� r r� r� r� r� r� r� r� r� r� )rw r0 ru ru rx � __typing_unpacked_tuple_args__- s z+_UnpackAlias.__typing_unpacked_tuple_args__N)r| r} r~ r� r r� r' rU ru ru ru rx rT * s rT c C � t �|| j� d��}t| |f�S rN �r� r� r� rT r5 ru ru rx r 8 s r c C � t | t�S r� �r� rT rP ru ru rx rQ = r� c @ s e Zd ZejZdS )rT N)r| r} r~ r� r r� ru ru ru rx rT A s c @ rr )� _UnpackFormc C rV rN rW r5 ru ru rx r� E s � z_UnpackForm.__getitem__Nr0 ru ru ru rx rZ D r rZ c C rX r� rY rP ru ru rx rQ L r� )r r c G sL g }| D ] }t |dd �}|d ur |r|d du s |�|� q|�|� q|S )NrU r .)r� r� r� )r� �newargsr0 �subargsru ru rx � _unpack_argsU s r] c @ s, e Zd ZdZejZed�dd�Zdd� Z dS )r zType variable tuple.r� c s2 t �|�� t� |� t� � � fdd�}|� _� S )Nc s� | j }|�� �}||d d � D ]}t|t�r td| � ���qt|�}t|�}|}|| d }d } d } t|�D ]+\} } t| t�sbt| dd �} | rbt| �dkrb| d du rb| d ur\td��| } | d } q7| d urvt || �}t ||| d �}n|| |kr�td | � d |� d |d � ���||| kr�� � � r�t � j �}n|||| � }g |d |� �| g|| �|�| g|| | | d �||| d � �R S ) Nr� z(More than one TypeVarTuple parameter in rU r r .z6More than one unpacked arbitrary-length tuple argumentr r r z, expected at least ) r� r� r� r r� r� � enumerater� r� �minr� r] r� )r� r� r� �typevartuple_index�param�alen�plen�left�right�var_tuple_index�fillargr� r0 r\ � replacement��tvtru rx �_typevartuple_prepare_substj s` �� �� �� � ����z9TypeVarTuple.__new__.<locals>._typevartuple_prepare_subst)r� r r� r� r� )r� r� r� rk ru ri rx r� e s -zTypeVarTuple.__new__c O r� )N�&Cannot subclass special typing classesr� rC ru ru rx rK � r� � TypeVarTuple.__init_subclass__N) r| r} r~ r� r� r r� ra r� rK ru ru ru rx r ` s 5c @ sT e Zd ZdZejZdd� Zed�dd�Z dd� Z d d � Z d d � Z d d� Z dd� ZdS )r a� Type variable tuple. Usage:: Ts = TypeVarTuple('Ts') In the same way that a normal type variable is a stand-in for a single type such as ``int``, a type variable *tuple* is a stand-in for a *tuple* type such as ``Tuple[int, str]``. Type variable tuples can be used in ``Generic`` declarations. Consider the following example:: class Array(Generic[*Ts]): ... The ``Ts`` type variable tuple here behaves like ``tuple[T1, T2]``, where ``T1`` and ``T2`` are type variables. To use these type variables as type parameters of ``Array``, we must *unpack* the type variable tuple using the star operator: ``*Ts``. The signature of ``Array`` then behaves as if we had simply written ``class Array(Generic[T1, T2]): ...``. In contrast to ``Generic[T1, T2]``, however, ``Generic[*Shape]`` allows us to parameterise the class with an *arbitrary* number of type parameters. Type variable tuples can be used anywhere a normal ``TypeVar`` can. This includes class definitions, as shown above, as well as function signatures and variable annotations:: class Array(Generic[*Ts]): def __init__(self, shape: Tuple[*Ts]): self._shape: Tuple[*Ts] = shape def get_shape(self) -> Tuple[*Ts]: return self._shape shape = (Height(480), Width(640)) x: Array[Height, Width] = Array(shape) y = abs(x) # Inferred type is Array[Height, Width] z = x + x # ... is Array[Height, Width] x.get_shape() # ... is tuple[Height, Width] c c s � | j V d S r� )� __unpacked__rv ru ru rx �__iter__� s � zTypeVarTuple.__iter__r� c C s4 || _ t�| |� t� }|dkr|| _t| | _d S )Nr )r| r� r� r' r} r rn )rw r� r� r� ru ru rx r� � s zTypeVarTuple.__init__c C r$ r� r% rv ru ru rx ry � r& zTypeVarTuple.__repr__c C r� r� r" rv ru ru rx r� � r� zTypeVarTuple.__hash__c C r# r� ru r� ru ru rx r� � r� zTypeVarTuple.__eq__c C r$ r� r% rv ru ru rx r� � r& zTypeVarTuple.__reduce__c O s d|vrt d��d S )Nr� rl r� rC ru ru rx rK � s �rm N)r| r} r~ r� r� r r� ro ra r� ry r� r� r� rK ru ru ru rx r � s , r; r� rD c C s t dt| �j��tjd� | S )a� Reveal the inferred type of a variable. When a static type checker encounters a call to ``reveal_type()``, it will emit the inferred type of the argument:: x: int = 1 reveal_type(x) Running a static type checker (e.g., ``mypy``) on this example will produce output similar to 'Revealed type is "builtins.int"'. At runtime, the function prints the runtime type of the argument and returns it unchanged. zRuntime type is )�file)�printr� r| r �stderrrP ru ru rx r; � s � _ASSERT_NEVER_REPR_MAX_LENGTH�d r& r0 c C s2 t | �}t|�tkr|dt� d }td|� ���)a1 Assert to the type checker that a line of code is unreachable. Example:: def int_or_str(arg: int | str) -> None: match arg: case int(): print("It's an int") case str(): print("It's a str") case _: assert_never(arg) If a type checker finds that a call to assert_never() is reachable, it will emit an error. At runtime, this throws an exception when called. Nz...z*Expected code to be unreachable, but got: )r� r� rs �AssertionError)r0 r� ru ru rx r& s )� eq_default� order_default�kw_only_default�frozen_default�field_specifiersrv rw rx ry rz .r� c s � �����fdd�}|S )a� Decorator that marks a function, class, or metaclass as providing dataclass-like behavior. Example: from typing_extensions import dataclass_transform _T = TypeVar("_T") # Used on a decorator function @dataclass_transform() def create_model(cls: type[_T]) -> type[_T]: ... return cls @create_model class CustomerModel: id: int name: str # Used on a base class @dataclass_transform() class ModelBase: ... class CustomerModel(ModelBase): id: int name: str # Used on a metaclass @dataclass_transform() class ModelMeta(type): ... class ModelBase(metaclass=ModelMeta): ... class CustomerModel(ModelBase): id: int name: str Each of the ``CustomerModel`` classes defined in this example will now behave similarly to a dataclass created with the ``@dataclasses.dataclass`` decorator. For example, the type checker will synthesize an ``__init__`` method. The arguments to this decorator can be used to customize this behavior: - ``eq_default`` indicates whether the ``eq`` parameter is assumed to be True or False if it is omitted by the caller. - ``order_default`` indicates whether the ``order`` parameter is assumed to be True or False if it is omitted by the caller. - ``kw_only_default`` indicates whether the ``kw_only`` parameter is assumed to be True or False if it is omitted by the caller. - ``frozen_default`` indicates whether the ``frozen`` parameter is assumed to be True or False if it is omitted by the caller. - ``field_specifiers`` specifies a static list of supported classes or functions that describe fields, similar to ``dataclasses.field()``. At runtime, this decorator records its arguments in the ``__dataclass_transform__`` attribute on the decorated object. See PEP 681 for details. c s � �����d�| _ | S )N)rv rw rx ry rz r� )�__dataclass_transform__)� cls_or_fn�rv rz ry rx r� rw ru rx � decorators s �z&dataclass_transform.<locals>.decoratorru )rv rw rx ry rz r� r~ ru r} rx r) * s I r) r9 �_F)r� c C r� )aH Indicate that a method is intended to override a method in a base class. Usage: class Base: def method(self) -> None: pass class Child(Base): @override def method(self) -> None: super().method() When this decorator is applied to a method, the type checker will validate that it overrides a method with the same name on a base class. This helps prevent bugs that may occur when a base class is changed without an equivalent change to a child class. There is no runtime checking of these properties. The decorator sets the ``__override__`` attribute to ``True`` on the decorated object to allow runtime introspection. See PEP 698 for details. T)� __override__r� r� r/ ru ru rx r9 � s ��r* �_Tc @ sP e Zd ZdZedd�dedejeje de ddfd d �Z d e de fd d �Z dS )r* a Indicate that a class, function or overload is deprecated. When this decorator is applied to an object, the type checker will generate a diagnostic on usage of the deprecated object. Usage: @deprecated("Use B instead") class A: pass @deprecated("Use g instead") def f(): pass @overload @deprecated("int support is deprecated") def g(x: int) -> int: ... @overload def g(x: str) -> int: ... The warning specified by *category* will be emitted at runtime on use of deprecated objects. For functions, that happens on calls; for classes, on instantiation and on creation of subclasses. If the *category* is ``None``, no warning is emitted at runtime. The *stacklevel* determines where the warning is emitted. If it is ``1`` (the default), the warning is emitted at the direct caller of the deprecated object; if it is higher, it is emitted further up the stack. Static type checker behavior is not affected by the *category* and *stacklevel* arguments. The deprecation message passed to the decorator is saved in the ``__deprecated__`` attribute on the decorated object. If applied to an overload, the decorator must be after the ``@overload`` decorator for the attribute to exist on the overload as returned by ``get_overloads()``. See PEP 702 for details. r� ��categoryr� �messager� r� rD Nc C s4 t |t�stdt|�j����|| _|| _|| _d S )Nz2Expected an object of type str for 'message', not )r� r� r� r� r| r� r� r� )rw r� r� r� ru ru rx r� � s �� zdeprecated.__init__r0 c s0 | j �| j�| j��d u r�� _� S t� t�rsdd l}ddlm} � j �|� ��� ����fdd��}t |�� _ � j �t�|�rW�j �|� ������fdd��}t|�� _ n|� ������fdd��}|� _ � � _|_�|_� S t� �r�dd l}|� � �� ���fdd ��}� � _|_|S td � ����) Nr )� MethodTypec sh | � u rt j���d d� �tjur �| g|�R i |��S | jtju r0|s(|r0t| j� d����| �S )Nr� r� z() takes no arguments)r� r� r� r� r� r� r| r� )r0 r� r� � original_newr� ru rx r� � s z$deprecated.__call__.<locals>.__new__c �" t j�� �d d� �| i |��S �Nr� r� �r� r� �r� r� �r� r� �original_init_subclassr� ru rx rK � z.deprecated.__call__.<locals>.__init_subclass__c r� r� r� r� r� ru rx rK r� c s" t j���d d� � | i |��S r� r� r� )r0 r� r� r� ru rx �wrapper" r� z$deprecated.__call__.<locals>.wrapperzY@deprecated decorator with non-None category must be applied to a class or callable, not )r� r� r� �__deprecated__r� r� r* �typesr� r� �wrapsrk rK r� � classmethodrR r� )rw r0 r* r� r� rK r� ru )r0 r� r� r� r� r� rx rh � sH ��zdeprecated.__call__)r| r} r~ r� r� r� r� rb r �WarningrF r� r� rh ru ru ru rx r* � s .���� �c C s& |s t | � d���|tu r!t| d�r| js t | � d���t| j�}t|�}||kr�|}t| d�rodd� | jD �}tdd� |D ��}|dkrM||| krMdS ||k rot|| d t�tur]dS td d� |D ��}||8 }d |� �}tj d krvd nd}t d||kr�dnd� d|� d| � d|� d|� � ��dS )��Check correct count for parameters of a generic cls (internal helper). This gives a nice error message in case of count mismatch. r r� c S � g | ]}t |�s|�qS ru �rQ r� ru ru rx � <listcomp>G � �"_check_generic.<locals>.<listcomp>c s s � | ]}t |t�V qd S r� )r� r r� ru ru rx r� H s � �!_check_generic.<locals>.<genexpr>r Nr� c s � � | ] }t |d t�tuV qdS �r� N�r� ra r� ru ru rx r� W � � � �r r� � argumentsr� r r r � z for r r ) r� r� r� r� r� �sumr� ra r rQ )r� r� �elenrb � expect_val� num_tv_tuples�num_default_tv�thingsru ru rx �_check_generic8 sB �� ����r� c C s� |s t | � d���t|�}||krX|}t| d�rBdd� | jD �}||k rBt|| dt�tur0dS tdd� |D ��}||8 }d |� �}t d ||krJd nd � d | � d|� d|� ���dS )r� r r� c S r� ru r� r� ru ru rx r� o r� r� r� Nc s r� r� r� r� ru ru rx r� | r� r� r r r r r r r )r� r� r� r� r� ra r� )r� r� r� rb r� r� ru ru rx r� d s2 �� ����c C sd zt �d�} W n ttfy Y dS w | j�d�dkr dS | j�d�}|tju p1|t u p1|tj u S )Nr Fr| r� r� ) r r! r� r$ r" r# �f_localsr� rS r: )�framer� ru ru rx �"_has_generic_or_protocol_as_origin� s � r� c C s< t | �turdS t| �}t|�o t|�dko t|d �tv S )NFr� r )r/ r r. r� r� r� �_TYPEVARTUPLE_TYPES)�xr� ru ru rx �_is_unpacked_typevartuple� s ��r� �_collect_type_varsc s� |du rt j}g � t� }d}d}| D ]G}t|�rd}n-t||�rH|� vrH|rCt|dt�tu}|r9|r6td��d}n |rCtd|�d���� �|� t |�rY� � � fdd �|j D �� qt � �S ) z�Collect all type variable contained in types in order of first appearance (lexicographic order). For example:: _collect_type_vars((T, List[S, T])) == (T, S) NFTr� �2Type parameter with a default follows TypeVarTuple�Type parameter �8 without a default follows type parameter with a defaultc s g | ]}|� vr|�qS ru ru )r� r� ��tvarsru rx r� � r� z&_collect_type_vars.<locals>.<listcomp>) r� r r� r� r� r� ra r� r� r� r� r� r� )r� � typevar_types�enforce_default_ordering�default_encountered�type_var_tuple_encounteredr� r� ru r� rx r� � s. �c C s� g }t � }d}d}| D ]l}t|t�rq t|t�r/|D ]}t|g�D ] }||vr,|�|� q!qq t|d�r_||vr^|rYt|dt�tu}|rJ|rJt d��|rOd}n |rYt d|�d���|�|� q t |�red}t|dd �D ] }||vrv|�|� qkq t|�S ) z�Collect all type variables and parameter specifications in args in order of first appearance (lexicographic order). For example:: assert _collect_parameters((T, Callable[P, T])) == (T, P) F�__typing_subst__r� r� Tr� r� r� ru ) r� r� r� r� �_collect_parametersr� r� r� ra r� r� ) r� r� r� r� r� r� r� � collectedr� ru ru rx r� � sH ��� � � ��r� c C sP dd� |D �}dd� |D �}t j| |||d�}| |_|j_tjdk r&||_|S )Nc S s g | ]\}}|�qS ru ru �r� r r� ru ru rx r� � z!_make_nmtuple.<locals>.<listcomp>c S s& i | ]\}}|t �|d |� d���qS )zfield z annotation must be a typer� r� ru ru rx r� s �z!_make_nmtuple.<locals>.<dictcomp>�r� rr r� )rG � namedtupler r� r rQ � _field_types)r� r� rr r� r� r �nm_tplru ru rx � _make_nmtuple s �� r� > r| r} r c @ rr )�_NamedTupleMetac s t |v sJ �|D ]}|t ur|tjurtd��qtdd� |D ��}d� v r*� d }n d� v r5� d d�}ni }g }|D ]&}|� v rG|�|� q;|ratd|� dt|�dkrVd nd � d d �|�� ���q;t||� � � fd d�|D �� d d�}||_ tj|v r�t td�r�t tj �|_n tjjj} t | �|_� � � D ]c\} } | tv r�td| ��| tvr�| |jvr�t|| � | � zt| �j} W n ty� Y q�w z| | || � W q� ty� } z dt| �j�d| �d|��}tjdkr�| �|� � t |�| �d } ~ ww q�tj|v �r|� � |S )Nz3can only inherit from a NamedTuple type and Genericc s s � | ] }|t u r tn|V qd S r� )� _NamedTupler� )r� r ru ru rx r� / s � z*_NamedTupleMeta.__new__.<locals>.<genexpr>r r| r� z Non-default namedtuple field z cannot follow default field�sr r� r� c s g | ]}� | �qS ru ru )r� r �r� ru rx r� B r� z+_NamedTupleMeta.__new__.<locals>.<listcomp>r} r� �_generic_class_getitemz&Cannot overwrite NamedTuple attribute z Error calling __set_name__ on z instance z in rV ) r� r� rS r� r� r� r� r� r� r� rM r� r� r� r� r� � _prohibited_namedtuple_fieldsr� �_special_namedtuple_fields�_fieldsr� r� � __set_name__� BaseExceptionr| r rQ �add_note� RuntimeErrorrK )r� r� r6 r� r r� � default_names� field_namer� � class_getitem�keyr� �set_namerU r� ru r� rx r� ) s� �� ���� ���� ��� z_NamedTupleMeta.__new__N)r| r} r~ r� ru ru ru rx r� ( r r� r c C s t | v sJ �tfS r� )r r� r� ru ru rx �_namedtuple_mro_entriesp s r� c K s� |t u r |r d}d}n4d}d| � d| �d�}d| d }n"|d u r9|r'td ��d }d| � d| �d�}d| d }n|r?td ��|t u sG|d u rXtj|j|d d�tdd� |�� }t| |t� d�}t f|_ |S )ao Typed version of namedtuple. Usage:: class Employee(NamedTuple): name: str id: int This is equivalent to:: Employee = collections.namedtuple('Employee', ['name', 'id']) The resulting class has an extra __annotations__ attribute, giving a dict that maps field names to types. (The field names are also in the _fields attribute, which is part of the namedtuple API.) An alternative equivalent functional syntax is also accepted:: Employee = NamedTuple('Employee', [('name', str), ('id', int)]) z3Creating NamedTuple classes using keyword argumentszq{name} is deprecated and will be disallowed in Python {remove}. Use the class-based or functional syntax instead.r� r� z = NamedTuple(z, [])`z�{name} is deprecated and will be disallowed in Python {remove}. To create a NamedTuple class with 0 fields using the functional syntax, pass an empty list, e.g. r; Nz\Cannot pass `None` as the 'fields' parameter and also specify fields using keyword argumentsr� zIEither list of fields or keywords can be provided to NamedTuple, not bothz3.15)r� r� r r� r} ) r� r� r� r� �formatr� r� r� r' r r{ )r� r� r� r� r� r� �ntru ru rx r t sH ������ �c @ s e Zd ZdZdS )r a� Base class for classes that implement the buffer protocol. The buffer protocol allows Python objects to expose a low-level memory buffer interface. Before Python 3.12, it is not possible to implement the buffer protocol in pure Python code, or even to check whether a class implements the buffer protocol. In Python 3.12 and higher, the ``__buffer__`` method allows access to the buffer protocol from Python code, and the ``collections.abc.Buffer`` ABC allows checking whether a class implements the buffer protocol. To indicate support for the buffer protocol in earlier versions, inherit from this ABC, either in a stub file or at runtime, or use ABC registration. This ABC provides no methods, because there is no Python-accessible methods shared by pre-3.12 buffer classes. It is useful primarily for static checks. N)r| r} r~ r� ru ru ru rx r � s r0 c C s8 z | j �d| j�W S ty tdt| �j���d�w )a Return the class's "original" bases prior to modification by `__mro_entries__`. Examples:: from typing import TypeVar, Generic from typing_extensions import NamedTuple, TypedDict T = TypeVar("T") class Foo(Generic[T]): ... class Bar(Foo[int], float): ... class Baz(list[str]): ... Eggs = NamedTuple("Eggs", [("a", int), ("b", str)]) Spam = TypedDict("Spam", {"a": int, "b": str}) assert get_original_bases(Bar) == (Foo[int], float) assert get_original_bases(Baz) == (list[str],) assert get_original_bases(Eggs) == (NamedTuple,) assert get_original_bases(Spam) == (TypedDict,) assert get_original_bases(int) == (object,) r{ z"Expected an instance of type, not N)r r# rM r� r� r� r| rE ru ru rx r0 � s ���c @ sV e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Ze j d kr)d d� Z dd� Z dS dS )r7 aL NewType creates simple unique types with almost zero runtime overhead. NewType(name, tp) is considered a subtype of tp by static type checkers. At runtime, NewType(name, tp) returns a dummy callable that simply returns its argument. Usage:: UserId = NewType('UserId', int) def name_by_id(user_id: UserId) -> str: ... UserId('user') # Fails type check name_by_id(42) # Fails type check name_by_id(UserId(42)) # OK num = UserId(5) + 1 # type: int c C s |S r� ru r� ru ru rx rh rz zNewType.__call__c C sD || _ d|v r|�d�d }|| _|| _t� }|dkr || _d S d S )Nr; r r )r~ � rpartitionr| � __supertype__r' r} )rw r� r� r� ru ru rx r� s �zNewType.__init__c s | j � G � fdd�d�}|fS )Nc s e Zd Z� fdd�ZdS )z&NewType.__mro_entries__.<locals>.Dummyc s" | j }td|� d|�d� � d���)NzGCannot subclass an instance of NewType. Perhaps you were looking for: `z = NewType(r� z)`)r| r� )r� � subcls_name�� supercls_nameru rx rK s ����z8NewType.__mro_entries__.<locals>.Dummy.__init_subclass__N)r| r} r~ rK ru r� ru rx �Dummy s r� r% )rw r6 r� ru r� rx ri s zNewType.__mro_entries__c C s | j � d| j� �S )Nr; )r} r~ rv ru ru rx ry % r� zNewType.__repr__c C r$ r� )r~ rv ru ru rx r� ( r& zNewType.__reduce__r� c C rE r� rF r� ru ru rx rG / r zNewType.__or__c C rH r� rF r� ru ru rx rI 2 r zNewType.__ror__N) r| r} r~ r� rh r� ri ry r� r rQ rG rI ru ru ru rx r7 � s �r7 r@ c C s | du pt | ttjtjtf�S )z:Corresponds to is_unionable() in unionobject.c in CPython.N)r� r� r� r� r� r@ rP ru ru rx � _is_unionable9 s �r� c s� e Zd ZdZdd�defdd�Zdededd f� fd d � Zdedefd d �Z dedefdd�Z defdd�Z dd� Z dd� Z dd� Zdd� ZejdkrWdd � Zd d � Z� ZS � ZS ) r@ a� Create named, parameterized type aliases. This provides a backport of the new `type` statement in Python 3.12: type ListOrSet[T] = list[T] | set[T] is equivalent to: T = TypeVar("T") ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,)) The name ListOrSet can then be used as an alias for the type it refers to. The type_params argument should contain all the type parameters used in the value of the type alias. If the alias is not generic, this argument is omitted. Static type checkers should only support type aliases declared using TypeAliasType that follow these rules: - The first argument (the name) must be a string literal. - The TypeAliasType instance must be immediately assigned to a variable of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid, as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)'). ru )� type_paramsr� c C st t |t�s td��|| _|| _g }|D ]}t |t�r |�|� q|�|� qt|�| _ t � }|dkr5|| _ || _ d S )Nz#TypeAliasType name must be a stringr ) r� r� r� � __value__�__type_params__r r� r� r� r� r' r} r| )rw r� r� r� r� r� r� ru ru rx r� ^ s zTypeAliasType.__init__r� rD Nc s& t | d�r | �|� t� �||� d S )Nr| )r� �_raise_attribute_errorr� r� )rw r� r� r� ru rx r� q s zTypeAliasType.__setattr__c C s | � |� d S r� )r� �rw r� ru ru rx � __delattr__v r zTypeAliasType.__delattr__c C s8 |dkrt d��|dv rt d|� d���t d|� d���)Nr| zreadonly attribute> r� r} r� r� z attribute 'z3' of 'typing.TypeAliasType' objects is not writablez0'typing.TypeAliasType' object has no attribute '�')r� r� ru ru rx r� y s � �z$TypeAliasType._raise_attribute_errorc C r$ r� r% rv ru ru rx ry � r& zTypeAliasType.__repr__c s2 t |t�s|f}� fdd�|D �}t�� t|��S )Nc s" g | ] }t �|d � j� d���qS )z Subscripting z requires a type.)r� r� r| )r� r6 rv ru rx r� � s ���z-TypeAliasType.__getitem__.<locals>.<listcomp>)r� r� r� r� r� ru rv rx r� � s �zTypeAliasType.__getitem__c C r$ r� r% rv ru ru rx r� � r& zTypeAliasType.__reduce__c O r� )NzEtype 'typing_extensions.TypeAliasType' is not an acceptable base typer� r� ru ru rx rK � s �z TypeAliasType.__init_subclass__c C r� )NzType alias is not callabler� rv ru ru rx rh � r� zTypeAliasType.__call__r� c C s t |�stS tj| |f S r� �r� r� r� rj )rw re ru ru rx rG � s zTypeAliasType.__or__c C s t |�stS tj|| f S r� r� )rw rd ru ru rx rI � s zTypeAliasType.__ror__)r| r} r~ r� r� r� r� r� rD r� r� ry r� r� rK rh r rQ rG rI r� ru ru r� rx r@ B s �r4 r� c C s( t | t�ot| dd�o| tuo| tjuS )aZ Return True if the given type is a Protocol. Example:: >>> from typing_extensions import Protocol, is_protocol >>> class P(Protocol): ... def a(self) -> str: ... ... b: int >>> is_protocol(P) True >>> is_protocol(int) False r, F)r� r� r� r: r� r� ru ru rx r4 � s ���c C s6 t | �s t| �d���t| d�rt| j�S tt| ��S )a� Return the set of members defined in a Protocol. Example:: >>> from typing_extensions import Protocol, get_protocol_members >>> class P(Protocol): ... def a(self) -> str: ... ... b: int >>> get_protocol_members(P) frozenset({'a', 'b'}) Raise a TypeError for arguments that are not Protocols. z is not a Protocolr )r4 r� r� r� r r r� ru ru rx r1 � s r1 r+ c @ sP e Zd ZdZdeddfdd�Zdefdd�Zdefd d �Zd e de fd d �Z dS )r+ af Define the documentation of a type annotation using ``Annotated``, to be used in class attributes, function and method parameters, return values, and variables. The value should be a positional-only string literal to allow static tools like editors and documentation generators to use it. This complements docstrings. The string value passed is available in the attribute ``documentation``. Example:: >>> from typing_extensions import Annotated, Doc >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ... � documentationrD Nc C r r� �r� )rw r� ru ru rx r� � r� z Doc.__init__c C s d| j �d�S )NzDoc(�)r� rv ru ru rx ry � r z Doc.__repr__c C s t | j�S r� )r� r� rv ru ru rx r� � r� z Doc.__hash__r� c C r r� )r� r+ r� r� r� ru ru rx r� � r z Doc.__eq__) r| r} r~ r� r� r� ry rF r� r� r� r� ru ru ru rx r+ � s � CapsuleType�CAPI)r )ro )NNFr� )ru )�r) rG �collections.abcr r* r@ r� r r� r� r� r� �__all__�PEP_560r� � GenericMetarQ �_PEP_696_IMPLEMENTEDrs r� r� rE r r� r� r� r� r� r r� r r> r� r r- r3 r6 r� r� r� r� r� r� r� r8 r, r( � defaultdict�partialr� r� r r r r r r r r r r r> rC r r r rR r� r� r� r� � _NoneTyper rb r� r r3 r� �EXCLUDED_ATTRIBUTESr r r' r: r+ r. r1 r2 r� r= rS r= r< r# r! r r r" r r$ rq �_PEP_728_IMPLEMENTEDr rw r5 � signaturer� r� r� rv r� r� r� r' r2 r� r% r� r/ r. r� � ImportErrorr� r� r? ra r� r� r� r� r� r� r r r r r� r( r r+ r r/ rA r7 rB r= �_Finalr r rD rG rH rM rF rO rS r rQ rR rT rZ r r] r; rs r& r) ri rj rL r9 r r* r� r� r� r� r� r� r� r r� � _prohibitedr� r� r� r� r� r �ABC�register� memoryview� bytearrayrb r0 r7 r@ r� r4 r1 rQ r� r+ � _CapsuleType�_socket�_CAPIr� r� rI rJ rK rM rN rO rP rT rU rV rW rX rY rZ r[ r\ r] r^ r_ r` rc rd re rf rg rh rk rl rm rn ru ru ru rx �<module> s� | �( �2� � � � � d 5 y X ,'= � � � ' 1 f! � /� . )�) + �� � * > N ����� ��� � � V $ ," & 8 F B < n � _vendor/typing_extensions-4.12.2.dist-info/RECORD 0000644 00000001073 15030122015 0015275 0 ustar 00 __pycache__/typing_extensions.cpython-312.pyc,, typing_extensions-4.12.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 typing_extensions-4.12.2.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936 typing_extensions-4.12.2.dist-info/METADATA,sha256=BeUQIa8cnYbrjWx-N8TOznM9UGW5Gm2DicVpDtRA8W0,3018 typing_extensions-4.12.2.dist-info/RECORD,, typing_extensions-4.12.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81 typing_extensions.py,sha256=gwekpyG9DVG3lxWKX4ni8u7nk3We5slG98mA9F3DJQw,134451 _vendor/typing_extensions-4.12.2.dist-info/METADATA 0000644 00000005712 15030122015 0015503 0 ustar 00 Metadata-Version: 2.1 Name: typing_extensions Version: 4.12.2 Summary: Backported and Experimental Type Hints for Python 3.8+ Keywords: annotations,backport,checker,checking,function,hinting,hints,type,typechecking,typehinting,typehints,typing Author-email: "Guido van Rossum, Jukka Lehtosalo, Łukasz Langa, Michael Lee" <levkivskyi@gmail.com> Requires-Python: >=3.8 Description-Content-Type: text/markdown Classifier: Development Status :: 5 - Production/Stable Classifier: Environment :: Console Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: Python Software Foundation License Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Topic :: Software Development Project-URL: Bug Tracker, https://github.com/python/typing_extensions/issues Project-URL: Changes, https://github.com/python/typing_extensions/blob/main/CHANGELOG.md Project-URL: Documentation, https://typing-extensions.readthedocs.io/ Project-URL: Home, https://github.com/python/typing_extensions Project-URL: Q & A, https://github.com/python/typing/discussions Project-URL: Repository, https://github.com/python/typing_extensions # Typing Extensions [](https://gitter.im/python/typing) [Documentation](https://typing-extensions.readthedocs.io/en/latest/#) – [PyPI](https://pypi.org/project/typing-extensions/) ## Overview The `typing_extensions` module serves two related purposes: - Enable use of new type system features on older Python versions. For example, `typing.TypeGuard` is new in Python 3.10, but `typing_extensions` allows users on previous Python versions to use it too. - Enable experimentation with new type system PEPs before they are accepted and added to the `typing` module. `typing_extensions` is treated specially by static type checkers such as mypy and pyright. Objects defined in `typing_extensions` are treated the same way as equivalent forms in `typing`. `typing_extensions` uses [Semantic Versioning](https://semver.org/). The major version will be incremented only for backwards-incompatible changes. Therefore, it's safe to depend on `typing_extensions` like this: `typing_extensions >=x.y, <(x+1)`, where `x.y` is the first version that includes all features you need. ## Included items See [the documentation](https://typing-extensions.readthedocs.io/en/latest/#) for a complete listing of module contents. ## Contributing See [CONTRIBUTING.md](https://github.com/python/typing_extensions/blob/main/CONTRIBUTING.md) for how to contribute to `typing_extensions`. _vendor/typing_extensions-4.12.2.dist-info/INSTALLER 0000644 00000000004 15030122015 0015645 0 ustar 00 pip _vendor/typing_extensions-4.12.2.dist-info/WHEEL 0000644 00000000121 15030122015 0015154 0 ustar 00 Wheel-Version: 1.0 Generator: flit 3.9.0 Root-Is-Purelib: true Tag: py3-none-any _vendor/typing_extensions-4.12.2.dist-info/LICENSE 0000644 00000033160 15030122015 0015403 0 ustar 00 A. HISTORY OF THE SOFTWARE ========================== Python was created in the early 1990s by Guido van Rossum at Stichting Mathematisch Centrum (CWI, see https://www.cwi.nl) in the Netherlands as a successor of a language called ABC. Guido remains Python's principal author, although it includes many contributions from others. In 1995, Guido continued his work on Python at the Corporation for National Research Initiatives (CNRI, see https://www.cnri.reston.va.us) in Reston, Virginia where he released several versions of the software. In May 2000, Guido and the Python core development team moved to BeOpen.com to form the BeOpen PythonLabs team. In October of the same year, the PythonLabs team moved to Digital Creations, which became Zope Corporation. In 2001, the Python Software Foundation (PSF, see https://www.python.org/psf/) was formed, a non-profit organization created specifically to own Python-related Intellectual Property. Zope Corporation was a sponsoring member of the PSF. All Python releases are Open Source (see https://opensource.org for the Open Source Definition). Historically, most, but not all, Python releases have also been GPL-compatible; the table below summarizes the various releases. Release Derived Year Owner GPL- from compatible? (1) 0.9.0 thru 1.2 1991-1995 CWI yes 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes 1.6 1.5.2 2000 CNRI no 2.0 1.6 2000 BeOpen.com no 1.6.1 1.6 2001 CNRI yes (2) 2.1 2.0+1.6.1 2001 PSF no 2.0.1 2.0+1.6.1 2001 PSF yes 2.1.1 2.1+2.0.1 2001 PSF yes 2.1.2 2.1.1 2002 PSF yes 2.1.3 2.1.2 2002 PSF yes 2.2 and above 2.1.1 2001-now PSF yes Footnotes: (1) GPL-compatible doesn't mean that we're distributing Python under the GPL. All Python licenses, unlike the GPL, let you distribute a modified version without making your changes open source. The GPL-compatible licenses make it possible to combine Python with other software that is released under the GPL; the others don't. (2) According to Richard Stallman, 1.6.1 is not GPL-compatible, because its license has a choice of law clause. According to CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 is "not incompatible" with the GPL. Thanks to the many outside volunteers who have worked under Guido's direction to make these releases possible. B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON =============================================================== Python software and documentation are licensed under the Python Software Foundation License Version 2. Starting with Python 3.8.6, examples, recipes, and other code in the documentation are dual licensed under the PSF License Version 2 and the Zero-Clause BSD license. Some software incorporated into Python is under different licenses. The licenses are listed with code falling under that license. PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 -------------------------------------------- 1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and the Individual or Organization ("Licensee") accessing and otherwise using this software ("Python") in source or binary form and its associated documentation. 2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative works, distribute, and otherwise use Python alone or in any derivative version, provided, however, that PSF's License Agreement and PSF's notice of copyright, i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Python Software Foundation; All Rights Reserved" are retained in Python alone or in any derivative version prepared by Licensee. 3. In the event Licensee prepares a derivative work that is based on or incorporates Python or any part thereof, and wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in any such work a brief summary of the changes made to Python. 4. PSF is making Python available to Licensee on an "AS IS" basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 6. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint venture between PSF and Licensee. This License Agreement does not grant permission to use PSF trademarks or trade name in a trademark sense to endorse or promote products or services of Licensee, or any third party. 8. By copying, installing or otherwise using Python, Licensee agrees to be bound by the terms and conditions of this License Agreement. BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 ------------------------------------------- BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the Individual or Organization ("Licensee") accessing and otherwise using this software in source or binary form and its associated documentation ("the Software"). 2. Subject to the terms and conditions of this BeOpen Python License Agreement, BeOpen hereby grants Licensee a non-exclusive, royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative works, distribute, and otherwise use the Software alone or in any derivative version, provided, however, that the BeOpen Python License is retained in the Software, alone or in any derivative version prepared by Licensee. 3. BeOpen is making the Software available to Licensee on an "AS IS" basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 5. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 6. This License Agreement shall be governed by and interpreted in all respects by the law of the State of California, excluding conflict of law provisions. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint venture between BeOpen and Licensee. This License Agreement does not grant permission to use BeOpen trademarks or trade names in a trademark sense to endorse or promote products or services of Licensee, or any third party. As an exception, the "BeOpen Python" logos available at http://www.pythonlabs.com/logos.html may be used according to the permissions granted on that web page. 7. By copying, installing or otherwise using the software, Licensee agrees to be bound by the terms and conditions of this License Agreement. CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 --------------------------------------- 1. This LICENSE AGREEMENT is between the Corporation for National Research Initiatives, having an office at 1895 Preston White Drive, Reston, VA 20191 ("CNRI"), and the Individual or Organization ("Licensee") accessing and otherwise using Python 1.6.1 software in source or binary form and its associated documentation. 2. Subject to the terms and conditions of this License Agreement, CNRI hereby grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare derivative works, distribute, and otherwise use Python 1.6.1 alone or in any derivative version, provided, however, that CNRI's License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) 1995-2001 Corporation for National Research Initiatives; All Rights Reserved" are retained in Python 1.6.1 alone or in any derivative version prepared by Licensee. Alternately, in lieu of CNRI's License Agreement, Licensee may substitute the following text (omitting the quotes): "Python 1.6.1 is made available subject to the terms and conditions in CNRI's License Agreement. This Agreement together with Python 1.6.1 may be located on the internet using the following unique, persistent identifier (known as a handle): 1895.22/1013. This Agreement may also be obtained from a proxy server on the internet using the following URL: http://hdl.handle.net/1895.22/1013". 3. In the event Licensee prepares a derivative work that is based on or incorporates Python 1.6.1 or any part thereof, and wants to make the derivative work available to others as provided herein, then Licensee hereby agrees to include in any such work a brief summary of the changes made to Python 1.6.1. 4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 6. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 7. This License Agreement shall be governed by the federal intellectual property law of the United States, including without limitation the federal copyright law, and, to the extent such U.S. federal law does not apply, by the law of the Commonwealth of Virginia, excluding Virginia's conflict of law provisions. Notwithstanding the foregoing, with regard to derivative works based on Python 1.6.1 that incorporate non-separable material that was previously distributed under the GNU General Public License (GPL), the law of the Commonwealth of Virginia shall govern this License Agreement only as to issues arising under or with respect to Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or joint venture between CNRI and Licensee. This License Agreement does not grant permission to use CNRI trademarks or trade name in a trademark sense to endorse or promote products or services of Licensee, or any third party. 8. By clicking on the "ACCEPT" button where indicated, or by copying, installing or otherwise using Python 1.6.1, Licensee agrees to be bound by the terms and conditions of this License Agreement. ACCEPT CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 -------------------------------------------------- Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, The Netherlands. All rights reserved. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Stichting Mathematisch Centrum or CWI not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ZERO-CLAUSE BSD LICENSE FOR CODE IN THE PYTHON DOCUMENTATION ---------------------------------------------------------------------- Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. _vendor/typeguard/_pytest_plugin.py 0000644 00000010500 15030122015 0013604 0 ustar 00 from __future__ import annotations import sys import warnings from typing import TYPE_CHECKING, Any, Literal from typeguard._config import CollectionCheckStrategy, ForwardRefPolicy, global_config from typeguard._exceptions import InstrumentationWarning from typeguard._importhook import install_import_hook from typeguard._utils import qualified_name, resolve_reference if TYPE_CHECKING: from pytest import Config, Parser def pytest_addoption(parser: Parser) -> None: def add_ini_option( opt_type: ( Literal["string", "paths", "pathlist", "args", "linelist", "bool"] | None ), ) -> None: parser.addini( group.options[-1].names()[0][2:], group.options[-1].attrs()["help"], opt_type, ) group = parser.getgroup("typeguard") group.addoption( "--typeguard-packages", action="store", help="comma separated name list of packages and modules to instrument for " "type checking, or :all: to instrument all modules loaded after typeguard", ) add_ini_option("linelist") group.addoption( "--typeguard-debug-instrumentation", action="store_true", help="print all instrumented code to stderr", ) add_ini_option("bool") group.addoption( "--typeguard-typecheck-fail-callback", action="store", help=( "a module:varname (e.g. typeguard:warn_on_error) reference to a function " "that is called (with the exception, and memo object as arguments) to " "handle a TypeCheckError" ), ) add_ini_option("string") group.addoption( "--typeguard-forward-ref-policy", action="store", choices=list(ForwardRefPolicy.__members__), help=( "determines how to deal with unresolveable forward references in type " "annotations" ), ) add_ini_option("string") group.addoption( "--typeguard-collection-check-strategy", action="store", choices=list(CollectionCheckStrategy.__members__), help="determines how thoroughly to check collections (list, dict, etc)", ) add_ini_option("string") def pytest_configure(config: Config) -> None: def getoption(name: str) -> Any: return config.getoption(name.replace("-", "_")) or config.getini(name) packages: list[str] | None = [] if packages_option := config.getoption("typeguard_packages"): packages = [pkg.strip() for pkg in packages_option.split(",")] elif packages_ini := config.getini("typeguard-packages"): packages = packages_ini if packages: if packages == [":all:"]: packages = None else: already_imported_packages = sorted( package for package in packages if package in sys.modules ) if already_imported_packages: warnings.warn( f"typeguard cannot check these packages because they are already " f"imported: {', '.join(already_imported_packages)}", InstrumentationWarning, stacklevel=1, ) install_import_hook(packages=packages) debug_option = getoption("typeguard-debug-instrumentation") if debug_option: global_config.debug_instrumentation = True fail_callback_option = getoption("typeguard-typecheck-fail-callback") if fail_callback_option: callback = resolve_reference(fail_callback_option) if not callable(callback): raise TypeError( f"{fail_callback_option} ({qualified_name(callback.__class__)}) is not " f"a callable" ) global_config.typecheck_fail_callback = callback forward_ref_policy_option = getoption("typeguard-forward-ref-policy") if forward_ref_policy_option: forward_ref_policy = ForwardRefPolicy.__members__[forward_ref_policy_option] global_config.forward_ref_policy = forward_ref_policy collection_check_strategy_option = getoption("typeguard-collection-check-strategy") if collection_check_strategy_option: collection_check_strategy = CollectionCheckStrategy.__members__[ collection_check_strategy_option ] global_config.collection_check_strategy = collection_check_strategy _vendor/typeguard/_config.py 0000644 00000005436 15030122015 0012157 0 ustar 00 from __future__ import annotations from collections.abc import Iterable from dataclasses import dataclass from enum import Enum, auto from typing import TYPE_CHECKING, TypeVar if TYPE_CHECKING: from ._functions import TypeCheckFailCallback T = TypeVar("T") class ForwardRefPolicy(Enum): """ Defines how unresolved forward references are handled. Members: * ``ERROR``: propagate the :exc:`NameError` when the forward reference lookup fails * ``WARN``: emit a :class:`~.TypeHintWarning` if the forward reference lookup fails * ``IGNORE``: silently skip checks for unresolveable forward references """ ERROR = auto() WARN = auto() IGNORE = auto() class CollectionCheckStrategy(Enum): """ Specifies how thoroughly the contents of collections are type checked. This has an effect on the following built-in checkers: * ``AbstractSet`` * ``Dict`` * ``List`` * ``Mapping`` * ``Set`` * ``Tuple[<type>, ...]`` (arbitrarily sized tuples) Members: * ``FIRST_ITEM``: check only the first item * ``ALL_ITEMS``: check all items """ FIRST_ITEM = auto() ALL_ITEMS = auto() def iterate_samples(self, collection: Iterable[T]) -> Iterable[T]: if self is CollectionCheckStrategy.FIRST_ITEM: try: return [next(iter(collection))] except StopIteration: return () else: return collection @dataclass class TypeCheckConfiguration: """ You can change Typeguard's behavior with these settings. .. attribute:: typecheck_fail_callback :type: Callable[[TypeCheckError, TypeCheckMemo], Any] Callable that is called when type checking fails. Default: ``None`` (the :exc:`~.TypeCheckError` is raised directly) .. attribute:: forward_ref_policy :type: ForwardRefPolicy Specifies what to do when a forward reference fails to resolve. Default: ``WARN`` .. attribute:: collection_check_strategy :type: CollectionCheckStrategy Specifies how thoroughly the contents of collections (list, dict, etc.) are type checked. Default: ``FIRST_ITEM`` .. attribute:: debug_instrumentation :type: bool If set to ``True``, the code of modules or functions instrumented by typeguard is printed to ``sys.stderr`` after the instrumentation is done Requires Python 3.9 or newer. Default: ``False`` """ forward_ref_policy: ForwardRefPolicy = ForwardRefPolicy.WARN typecheck_fail_callback: TypeCheckFailCallback | None = None collection_check_strategy: CollectionCheckStrategy = ( CollectionCheckStrategy.FIRST_ITEM ) debug_instrumentation: bool = False global_config = TypeCheckConfiguration() _vendor/typeguard/__pycache__/_transformer.cpython-310.pyc 0000644 00000066754 15030122015 0017625 0 ustar 00 o �h�� � @ s d dl mZ d dlZd dlZd dlZd dlZd dlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9 d dl:m;Z; d dl<m=Z=m>Z> d dl?m@Z@ d dlAmBZB d dlCmDZDmEZE d d lmFZFmGZGmHZHmIZI d ZJd ZKd ZLd ZMdZNede/de$de!dedede"de*de de,dedededi ZOeDG d d � d ��ZPG d d � d e(�ZQG d d!� d!e(�ZRG d"d#� d#e'�ZSG d$d%� d%e'�ZTdS )&� )� annotationsN)4�AST�Add� AnnAssign�Assign�AsyncFunctionDef� Attribute� AugAssign�BinOp�BitAnd�BitOr�BitXor�Call�ClassDef�Constant�Dict�Div�Expr� Expression�FloorDiv� FunctionDef�If�Import� ImportFrom�Index�List�Load�LShift�MatMult�Mod�Module�Mult�Name� NamedExpr�NodeTransformer� NodeVisitor�Pass�Pow�Return�RShift�Starred�Store�Sub� Subscript�Tuple�Yield� YieldFrom�alias� copy_location�expr�fix_missing_locations�keyword�walk)� defaultdict)� Generator�Sequence)�contextmanager)�deepcopy)� dataclass�field)�Any�ClassVar�cast�overload) ztyping.Generatorzcollections.abc.Generatorztyping.Iteratorzcollections.abc.Iteratorztyping.Iterablezcollections.abc.Iterableztyping.AsyncIteratorz collections.abc.AsyncIteratorztyping.AsyncIterablez collections.abc.AsyncIterableztyping.AsyncGeneratorz collections.abc.AsyncGenerator)z typing.Anyztyping_extensions.Any)ztyping.Literalztyping_extensions.Literal)ztyping.Annotatedztyping_extensions.Annotated)ztyping.no_type_checkztypeguard.typeguard_ignore�iadd�isub�imul�imatmul�itruediv� ifloordiv�imod�ipow�ilshift�irshift�iand�ixor�iorc @ s� e Zd ZU ded< ded< ded< edd�Zd ed < d Zd ed < d Zd ed< d Zd ed< dZ ded< ede d�Z ded< ede d�Z ded< ede d�Zded< eddd� d�Zded< eddd �Zded < eddd �Zded < edd d �Zd ed < edd!d �Zded"< ede d�Zd#ed$< ede d�Zd%ed&< edd'd �Zd(ed)< dEd,d-�ZdFd0d1�ZdGd4d5�ZdHd7d8�ZdId:d;�ZdJd=d>�Z dKd@dA�Z dLdCdD�Z d S )M� TransformMemoz9Module | ClassDef | FunctionDef | AsyncFunctionDef | None�nodezTransformMemo | None�parentztuple[str, ...]�pathF)�initr � joined_pathN� expr | None�return_annotation�yield_annotation�send_annotation�bool�is_async)rS �default_factoryzset[str]� local_nameszdict[str, str]�imported_names� ignored_namesc C s t t�S �N)r7 �dict� ra ra �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_transformer.py�<lambda>� s zTransformMemo.<lambda>z!defaultdict[str, dict[str, Name]]� load_names)rS �default�has_yield_expressions�has_return_expressionsz Name | None� memo_var_nameT�should_instrumentzdict[str, expr]�variable_annotationszdict[str, Any]�configuration_overridesr �int�code_inject_index�return�Nonec C s� g }| }t |jtttf�r3|�d|jj� |jsn|j}t |jttf�r*|�dd� t |jtttf�s td� |��| _ | jrlt | jj �D ])\}}t |t �rS|jdkrSqDt |t�rft |jt�rft |jjt�rfqD|| _ d S d S d S )Nr z<locals>�.� __future__)� isinstancerP r r r �insert�namerQ r �joinrT � enumerate�bodyr �moduler �value�strrm )�self�elements�memo�index�childra ra rb � __post_init__� s4 � � � ��zTransformMemo.__post_init__rt rz c C sB | }|d ur||j v r| }|d7 }n|j}|d us| j �|� |S )N�_)r\ rQ �add)r{ rt r} ra ra rb �get_unused_name� s � z TransformMemo.get_unused_name� expression�expr | Expr | Nonec C sv t |t�r|jn|}t |t�rt |jt�r|jj}n t |t�r#|j}ndS | }|d ur9||jv r2dS |j}|d us+dS )NFT)rr r ry r r" �idr^ rQ )r{ r� �top_expressionrt r} ra ra rb �is_ignored_name� s � � �z TransformMemo.is_ignored_namer" c C s | j s tdt� d�| _ | j S )Nr} �r� �ctx)rh r" r �r{ ra ra rb � get_memo_name� s zTransformMemo.get_memo_namerx c C s� || j v r|| j | v r| j | | S |� d|� �}|| jv r-| j| |kr-t|t� d�S | �|�}t|t� d� }| j | |< || j|< |S )Nrp r� )rd r] r" r r� )r{ rx rt �qualified_namer1 rP ra ra rb � get_import� s zTransformMemo.get_import�'Module | FunctionDef | AsyncFunctionDefc C sP | j sdS | j �� D ]\}}dd� t|�� �D �}|j�| jt||d�� q dS )z'Insert imports needed by injected code.Nc S s* g | ]\}}t |||jkr|jnd ��qS r_ )r1 r� )�.0� orig_name�new_namera ra rb � <listcomp>� s ��z0TransformMemo.insert_imports.<locals>.<listcomp>r )rd �items�sortedrw rs rm r )r{ rP � modulename�names�aliasesra ra rb �insert_imports� s ��z TransformMemo.insert_importsr� c G s� |d u rdS g }t |t�r|jn|}t |t�r|j}nt |t�r#|j}t |t�r7|�d|j� |j}t |t�s(t |t �s>dS |j | j v rK| j |j }nt t |j �rWd|j }n|j }|�d|� d�|�}||v rkdS | jrx| jj|g|�R � S dS )NFr z builtins.rp T)rr r ry r- r �funcr rs �attrr" r� r] �hasattr�builtinsru rQ � name_matches)r{ r� r� rR r� � translatedrT ra ra rb r� � s6 � � zTransformMemo.name_matches� list[keyword]c C sD | j rt| j jt�r| j j�� }ni }|�| j� dd� |�� D �S )Nc S � g | ] \}}t ||��qS ra �r5 �r� �keyry ra ra rb r� � z5TransformMemo.get_config_keywords.<locals>.<listcomp>)rQ rr rP r rk �copy�updater� )r{ � overridesra ra rb �get_config_keywords s z!TransformMemo.get_config_keywords�rn ro )rt rz rn rz )r� r� rn rY )rn r" �rx rz rt rz rn r" )rP r� rn ro )r� r� r� rz rn rY )rn r� ) �__name__� __module__� __qualname__�__annotations__r= rT rV rW rX rZ �setr\ r` r] r^ rd rf rg rh ri rj rk rm r� r� r� r� r� r� r� r� ra ra ra rb rO s s< � %rO c @ sR e Zd Zddd�Zddd�Zd d d �Zd d d�Zd dd�Zd dd�Zd dd�Z dS )!� NameCollectorrn ro c C s t � | _d S r_ )r� r� r� ra ra rb �__init__ s zNameCollector.__init__rP r c C �$ |j D ] }| j �|jp |j� qd S r_ �r� r� �asnamert �r{ rP rt ra ra rb � visit_Import � �zNameCollector.visit_Importr c C r� r_ r� r� ra ra rb �visit_ImportFrom# r� z NameCollector.visit_ImportFromr c C s( |j D ]}t|t�r| j�|j� qd S r_ )�targetsrr r" r� r� r� )r{ rP �targetra ra rb � visit_Assign' s ��zNameCollector.visit_Assignr# r> c C s$ t |jt�r| j�|jj� d S d S r_ )rr r� r" r� r� r� �r{ rP ra ra rb �visit_NamedExpr, s �z NameCollector.visit_NamedExprr c C � d S r_ ra r� ra ra rb �visit_FunctionDef0 � z NameCollector.visit_FunctionDefr c C r� r_ ra r� ra ra rb �visit_ClassDef3 r� z NameCollector.visit_ClassDefNr� )rP r rn ro )rP r rn ro )rP r rn ro �rP r# rn r> )rP r rn ro )rP r rn ro ) r� r� r� r� r� r� r� r� r� r� ra ra ra rb r� s r� c @ s\ e Zd ZU dZdZded< dZded< dd d �Zdd d�Zddd�Z d dd�Z d dd�Z dS ) �GeneratorDetectorz3Detects if a function node is a generator function.FrY �contains_yields�in_root_functionrP r/ rn r> c C � d| _ d S �NT�r� r� ra ra rb � visit_Yield= � z GeneratorDetector.visit_Yieldr0 c C r� r� r� r� ra ra rb �visit_YieldFrom@ r� z!GeneratorDetector.visit_YieldFromr c C r� r_ ra r� ra ra rb r� C r� z GeneratorDetector.visit_ClassDef� FunctionDef | AsyncFunctionDefc C s$ | j sd| _ | �|� d| _ d S d S )NTF)r� � generic_visitr� ra ra rb r� F s �z#GeneratorDetector.visit_FunctionDefr c C s | � |� d S r_ �r� r� ra ra rb �visit_AsyncFunctionDefL s z(GeneratorDetector.visit_AsyncFunctionDefN)rP r/ rn r> )rP r0 rn r> )rP r rn r> )rP r� rn r> )rP r rn r> ) r� r� r� �__doc__r� r� r� r� r� r� r� r� ra ra ra rb r� 7 s r� c s~ e Zd ZU dddddd�Zded< d%d d �Zd&� fdd� Zd'dd�Zd(dd�Zd)dd�Z d*d d �Z d+d d!�Z d,d#d$�Z � Z S )-�AnnotationTransformer)�typingr )r� r )r� r. )r� �Set)r� � FrozenSet)z builtins.dictz builtins.listzbuiltins.tuplez builtins.setzbuiltins.frozensetz$ClassVar[dict[str, tuple[str, str]]]�type_substitutions� transformer�TypeguardTransformerc C s || _ |j| _d| _d S )Nr )r� �_memo�_level)r{ r� ra ra rb r� Y s z AnnotationTransformer.__init__rP r rn r> c s� t |t�r| jj|gt�R � r|S | jd7 _t� �|�}| jd8 _t |t�r1t |d�s1d S | jdkrGt |t�rG| jj|gt �R � rGd S |S )N� rw r ) rr r3 r� r� � literal_namesr� �super�visitr r� � anytype_names)r{ rP �new_node�� __class__ra rb r� ^ s ��zAnnotationTransformer.visitr c C s� | � |� t|jt�rUt|d�rt|d�sd S | jj|jgt�R � r%|jS | jj|j gt�R � r3|j S t j dk rU| j � dd�}t|tt|j|j gt� d�t� d�t� d�S |S ) N�left�right)� � r� �Union)�eltsr� �r� )ry �slicer� )r� rr �opr r� r� r� r� r� r� �sys� version_infor� � _get_importr- r r. r )r{ rP � union_namera ra rb � visit_BinOpt s$ ��z!AnnotationTransformer.visit_BinOpr c C s | j �|�rd S |S r_ )r� r� r� ra ra rb �visit_Attribute� s z%AnnotationTransformer.visit_Attributer- c s| � j �|j�r d S |jr�t|jt�r|jj}n|j}t|t�r�� j j|jgt�R � rAt t j t � � |jd �g|jdd � �}nt t j t � fdd�|jD ��}� j �|jd�rft� fdd�|D ��rfd S tdd� |D ��rr|jS t|�D ]\}}|d u r�� j�d d �||< qv||_|S � �|� � j �|jd �r�t|d �s�d S tjd kr�t|d �s�|jS tjd k r�t|jd�s�|jS |S )Nr r� c s g | ]}� � |��qS ra )r� �r� �itemr� ra rb r� � s z9AnnotationTransformer.visit_Subscript.<locals>.<listcomp>z typing.Unionc 3 s6 � | ]}|d u pt |t�o� jj|gt�R � V qd S r_ )rr r3 r� r� r� r� r� ra rb � <genexpr>� s � � �z8AnnotationTransformer.visit_Subscript.<locals>.<genexpr>c s s � | ]}|d u V qd S r_ ra r� ra ra rb r� � s � r� r> ztyping.Optionalr� �r� � ry )r� r� ry r� rr r r. r� �annotated_namesr@ r� r r3 r� r� �any�allrv r� r� r� r� r� r� )r{ rP � slice_valuer� r~ r� ra r� rb �visit_Subscript� sP �� �� ���z%AnnotationTransformer.visit_Subscriptr" c C sZ | j �|�rd S tjdk r+| j�� D ]\}}| j �||�r*| jj|� }t ||� S q|S )Nr� ) r� r� r� r� r� r� r� r� r� r2 )r{ rP �typename� substituter� ra ra rb � visit_Name� s �z AnnotationTransformer.visit_Namer c C s |S r_ ra r� ra ra rb � visit_Call� s z AnnotationTransformer.visit_Callr c C s> t |jt�r tj|jdd�}| �|�}|rt|j|�S d S |S )N�eval)�mode)rr ry rz �ast�parser� r2 rw )r{ rP r� r� ra ra rb �visit_Constant� s z$AnnotationTransformer.visit_Constant)r� r� )rP r rn r> )rP r rn r> )rP r rn r> )rP r- rn r> )rP r" rn r> )rP r rn r> )rP r rn r> )r� r� r� r� r� r� r� r� r� r� r� r� r � __classcell__ra ra r� rb r� P s � A r� c s� e Zd Z dLdMdd �ZdN� fd d � ZedOdd��ZdPdd�ZedQdd��Z edRd d��Z dSd d�Z dTd d �Z dUd"d#�Z dVd%d&�Z dWd(d)�Z dXd,d-�ZdYd0d1�ZdZd3d4�Zd[d6d7�Zd\d:d;�Zd]d>d?�Zd^dAdB�Zd_dDdE�Zd`dGdH�ZdadJdK�Z� ZS )br� N� target_path�Sequence[str] | None� target_lineno� int | Nonern ro c C s> |rt |�nd | _td d d� | _| _t� | _d | _|| _d S �Nra ) �tuple� _target_pathrO r� � _module_memor� �names_used_in_annotations� target_noder )r{ r r ra ra rb r� � s z TypeguardTransformer.__init__rP r c sR t t|dd ��}t|�}t� �|�}t|�|u r'|r't|d�r'|js't� g|_|S )Nrw )rY �getattr�typer� r� r� rw r& )r{ rP � has_non_empty_body_initially� initial_typer� ra rb r� � s ��� z"TypeguardTransformer.generic_visit�)ClassDef | FunctionDef | AsyncFunctionDef�Generator[None, Any, None]c c s@ � t || j| jj|jf �}| j}|| _t|ttf�r�| jd u p%|j| jk|_|jr�t � }|� |� t |j �}|j r�|j|gt�R � r�t|t�r�|j}t|t�rS|j}t|t�r\|j}n|g}t|�dkrm| �|d �|_t|�dkr{| �|d �|_t|�dkr�| �|d �|_n| �|�|_t|t�r�d|_d V || _d S )Nr r� � T) rO r� rR rt rr r r r ri r� r� r; �returnsr� r� �generator_namesr- r� r ry r. r� �len�_convert_annotationrW rX rV rZ )r{ rP �new_memo�old_memo�detectorrV �annotation_slicer� ra ra rb � _use_memo sX �� �� � � � ��� z TypeguardTransformer._use_memorx rz rt r" c C s | j r| jn| j}|�||�S r_ )r r� r r� )r{ rx rt r} ra ra rb r� M s z TypeguardTransformer._get_import� annotationc C r� r_ ra �r{ r ra ra rb r Q r� z(TypeguardTransformer._convert_annotationr3 c C r� r_ ra r! ra ra rb r T r� rU c C sX |d u rd S t tt| ��|��}t|t�r*t�||�}dd� t|�D �}| j� |� |S )Nc S s h | ] }t |t�r|j�qS ra )rr r" r� )r� rP ra ra rb � <setcomp>b � z;TypeguardTransformer._convert_annotation.<locals>.<setcomp>) r@ r3 r� r� rr r r2 r6 r r� )r{ r �new_annotationr� ra ra rb r W s c C s | j j�|j� |S r_ )r� r\ r� r� r� ra ra rb r� g s z TypeguardTransformer.visit_Namer c C s6 t |d d� | _| _| �|� | j�|� t|� |S r )rO r r� r� r� r4 r� ra ra rb � visit_Modulek s z!TypeguardTransformer.visit_Moduler c C s< |j D ]}| jj�|jp|j� |j| jj|jp|j< q|S r_ )r� r� r\ r� r� rt r] r� ra ra rb r� s s z!TypeguardTransformer.visit_Importr c C sN |j D ]!}|jdkr$|jp|j}| jj�|� |j� d|j� �| jj|< q|S )N�*rp )r� rt r� r� r\ r� rx r] )r{ rP rt r1 ra ra rb r� z s �z%TypeguardTransformer.visit_ImportFromr �ClassDef | Nonec C s� | j j�|j� | jd ur| j js|j| jd krd S | �|��9 |j�� D ]$}| j � |d�rJ|j� |� t |t �rJ|j rJ| j j�dd� |j D �� q&| �|� |W d � S 1 s\w Y d S )Nr �typeguard.typecheckedc S � i | ] }|j r|j |j�qS ra ��argry �r� �kwra ra rb � <dictcomp>� r# z7TypeguardTransformer.visit_ClassDef.<locals>.<dictcomp>)r� r\ r� rt r rR r �decorator_listr� r� �removerr r �keywordsrk r� r� )r{ rP � decoratorra ra rb r� � s$ � �� $�z#TypeguardTransformer.visit_ClassDefr� �%FunctionDef | AsyncFunctionDef | Nonec C sZ | j j�|j� | jdur| j js|j| jd krdS | jdu r4|jD ]}| j j|gt�R � r3| S q#| � |���h i }| jdu sJ| j j| jk�r�|jrT|jd j }n|j }|j� � D ]1}| j �|d�rn W d � dS | j �|d�r�|j� |� t |t�r�|jr�dd� |jD �| j _q\| j|kr�| jdu s�J �|| _|jr�|jd j | _n|j | _|jj|jj |jj }|D ] }| j j�|j� q�|jjr�| j j�|jjj� |jjr�| j j�|jjj� |D ]}| �t|j ��}|r�|||j< q�|jj�r>| �|jjj �}|�r>t j dk�rt dt � d �} n| �!d d �} t"|t#t$�gt � d �} t j dk �r1t%| t � d �} t&| | t � d �||jjj< |jj�r�| �|jjj �}|�r�t j dk�r\t d t � d �} n| �!d d �} t"t dt � d �|gt � d �} t j dk �r}t%| t � d �} t&| | t � d �||jjj< |�r�| j j'�(|� | �)|� |�r�t*dd� |�+� D �dd� |�,� D �d�} | �!dd�} | j j-| | j �.� g} |j/�0| j j1t2t| | g ��� | j j3�r-| j j4�r�| j j5�s-t |j/d t6��s-t | j j3t#��r�| j j3j7du�r-| �!dd�} t6t| | j j-t#d�| j j3| j �.� gg ��}t |j/d t8��r't9||j/d � |j/d= |j/�:|� | j j;�r�i }| j j<�r�t | j j<j=t>��r�|jD ]-}t |t ��rU|j?dk�rU nLt |t ��rq|j?dk�rqt |jjd jt � d�|d< n0�qE|jj�r�|jdk�r�t |jjd jt � d�|d< nt@t |jjd jt � d�d t � d �|d< |jg}| j j<}|�r�t |j=tAtBf��r�|dd�= nt |j=t>��s�n|�0d|j=j� |j<}|�s�| j �C� }|�r�t| �!d d �| �!d d �g|�|d!< | j �Dd"�| j j;_?t | j j;j?tE� d�}tt d#t � d�g g �}tt d$t � d�g g �}t| �!d%d&�||gd'd� |�,� D ��}|j/�0| j j1tF|g|�� | j �G|� t |tA��r}|j�r}| j j<du�r}t | j j<j=t>��r}|jdk�r}t |jjd jt � d �}t | j j<j=jtE� d �}|j/�0| j j1tF|g|�� t |j/d t8��r�|j/d= W d � |S W d � |S W d � |S 1 �s�w Y |S )(z� Injects type checks for function arguments, and for a return of None if the function is annotated to return something else than Any or None, and the body ends without an explicit "return". Nr ztyping.overloadr( c S r) ra r* r, ra ra rb r. � s ��z:TypeguardTransformer.visit_FunctionDef.<locals>.<dictcomp>r� r r� r� r. r` r rz c S s g | ]}t |��qS ra )r )r� r� ra ra rb r� s z:TypeguardTransformer.visit_FunctionDef.<locals>.<listcomp>c S s, g | ]\}}t t|t� d �|gt� d ��qS )r� )r. r" r )r� r� r ra ra rb r� s ����keys�values�typeguard._functions�check_argument_types����check_return_type� staticmethod� classmethodr� � self_type�__new__r� � dataclasses�replaceztypeguard._config� global_config�configr} �globals�locals� typeguard� TypeCheckMemoc S r� ra r� r� ra ra rb r� � r� )Hr� r\ r� rt r rR r/ r� �ignore_decoratorsr �linenor� r0 rr r r1 rk r r �args� kwonlyargs� posonlyargsr^ r+ �vararg�kwargr r; r r� r� r" r r� r. r �Ellipsisr r- rj r� r� r r5 r� rT r� rw rs rm r rV rZ rf r( ry r& r2 �appendrh rQ rP r r� r r r r� r� r+ r r� )r{ rP r2 �arg_annotations� first_lineno�all_argsr+ r � annotation_� container�subscript_slice�annotations_dict� func_namerI � return_node� memo_kwargsr� r} �config_keywords�memo_store_name� globals_call� locals_call� memo_expr�first_args_expr�cls_namera ra rb r� � s� � �� �� � �� � �� � ��������� ����� � � �� � � � � � � ��� � � � y� � � y� � � y �� yz&TypeguardTransformer.visit_FunctionDefr c C s | � |�S r_ r� r� ra ra rb r� � s z+TypeguardTransformer.visit_AsyncFunctionDefr( c C s| | � |� | jjr<| jjr<| j�| jj�s<| �dd�}|}|jp#td�}tt || jj || jj| j� � gg ��}t ||� |S )z2This injects type checks into "return" statements.r7 r: N) r� r� rV ri r� r� ry r r( r rT r� r2 )r{ rP rW �old_node�retvalra ra rb � visit_Return� s. ��� ��� z!TypeguardTransformer.visit_Returnr/ � Yield | Callc C s� d| j _| �|� | j jr8| j jr8| j �| j j�s8| �dd�}|jp%td�}t || j j || j j| j � � gg �|_| j j rh| j jrh| j �| j j �sh| �dd�}|}t || j j || j j | j � � gg �}t ||� |S |S )z� This injects type checks into "yield" expressions, checking both the yielded value and the value sent back to the generator, when appropriate. Tr7 �check_yield_typeN�check_send_type)r� rf r� rW ri r� r� ry r r rT r� rX r2 )r{ rP rW �yieldvalra � call_nodera ra rb r� � sN ��� �� ��� �� z TypeguardTransformer.visit_Yieldr r> c C s� | � |� t| jjttf�rN|jrNt|jt�rN| jj � |jj � | � t |j��}|rN|| jj|jj < |jrN| �dd�}t||jt|jj �|| j�� gg �|_|S )zx This injects a type check into a local variable annotation-assignment within a function body. r7 �check_variable_assignment)r� rr r� rP r r r r� r" r^ r� r� r r; rj ry r� r r r� �r{ rP r rW ra ra rb �visit_AnnAssign s2 �� �� �� z$TypeguardTransformer.visit_AnnAssignr c C s� | � |� t| jjttf�r�g }d}|jD ]X}t|t�r |g}n t|t�r)|j }nqi }|D ]9}d}t|t �r<|j }d}t|t�rg| jj � |j� ||j } | jj�|j�} | ra| |t| �< d}q.d|t| �< q.|�|� q|r�|D ]} | �� D ]\} } | du r�| �dd�| | < qxqrt|�dkr�t|d �dkr�| �d d �}tt|d ��}t||j ||d | | j�� gg �|_ |S |r�| �d d �}td d� |D �t� d�}t||j || j�� gg �|_ |S )z� This injects a type check into a local variable assignment within a function body. The variable must have been annotated earlier in the function body. F� r& TNr� r> r� r r7 ri � check_multi_variable_assignmentc S s$ g | ]}t t|�t|�� �d ��qS )r4 )r �listr6 )r� r� ra ra rb r� g s ��z5TypeguardTransformer.visit_Assign.<locals>.<listcomp>r� ) r� rr r� rP r r r� r" r. r� r* ry r^ r� r� rj �getr rO r� r� r �next�iterr r� r r )r{ rP r� �check_requiredr� r� � annotations_�exp�prefixrt r r� r� r� rW �target_varname� targets_argra ra rb r� $ s� � �� � �������z!TypeguardTransformer.visit_Assignr# c C s� | � |� t| jjttf�rEt|jt�rE| jj� |jj � | jj � |jj �}|du r,|S | � dd�}t||jt|jj �|| j�� gg �|_|S )zEThis injects a type check into an assignment expression (a := foo()).Nr7 ri )r� rr r� rP r r r� r" r^ r� r� rj ro r� r ry r r� rj ra ra rb r� u s* �� �� z$TypeguardTransformer.visit_NamedExprr c C s� | � |� t| jjttf�rjt|jt�rj| jj� |jj �}|du r#|S zt |j j }W n ty6 | Y S w | �d|�}t|t|jj t� d�|jgg �}t| �dd�|t|jj �|| j�� gg �}t|jg|d�S |S )z^ This injects a type check into an augmented assignment expression (a += 1). N�operatorr� r7 ri )r� ry )r� rr r� rP r r r� r" rj ro r� �aug_assign_functionsr� r� �KeyErrorr� r r ry r r� r )r{ rP r �operator_func_name� operator_func� operator_call� check_callra ra rb �visit_AugAssign� s6 � � � �� z$TypeguardTransformer.visit_AugAssignr c C sV | � |� | j| ju r)t|jt�r)| j�|jd�r)t� }|�|� | jj � |j � |S )z� This blocks names from being collected from a module-level "if typing.TYPE_CHECKING:" block, so that they won't be type checked. ztyping.TYPE_CHECKING) r� r� r rr �testr" r� r� r� r^ r� r� )r{ rP � collectorra ra rb �visit_If� s �� z TypeguardTransformer.visit_If)NN)r r r r rn ro )rP r rn r )rP r rn r r� )r ro rn ro )r r3 rn r3 )r rU rn rU )rP r" rn r" )rP r rn r )rP r rn r )rP r rn r )rP r rn r' )rP r� rn r3 )rP r rn r3 )rP r( rn r( )rP r/ rn rd )rP r rn r> )rP r rn r> r� )rP r rn r> )rP r rn r> )r� r� r� r� r� r: r r� rA r r� r% r� r� r� r� r� rc r� rk r� r� r r� r ra ra r� rb r� � s8 � = 1 " Q (r� )Urq r r r� r� r� r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r2 r3 r4 r5 r6 � collectionsr7 �collections.abcr8 r9 � contextlibr: r� r; r? r< r= r> r? r@ rA r r� r� r� rG ry rO r� r� r� r� ra ra ra rb �<module> sN � 6 � ( $ _vendor/typeguard/__pycache__/_config.cpython-310.pyc 0000644 00000006555 15030122015 0016521 0 ustar 00 o �h � @ s� d dl mZ d dlmZ d dlmZ d dlmZmZ d dl m Z m Z e r*ddl m Z e d�ZG d d � d e�ZG d d � d e�ZeG d d� d��Ze� ZdS )� )� annotations)�Iterable)� dataclass)�Enum�auto)� TYPE_CHECKING�TypeVar� )�TypeCheckFailCallback�Tc @ s" e Zd ZdZe� Ze� Ze� ZdS )�ForwardRefPolicyaK Defines how unresolved forward references are handled. Members: * ``ERROR``: propagate the :exc:`NameError` when the forward reference lookup fails * ``WARN``: emit a :class:`~.TypeHintWarning` if the forward reference lookup fails * ``IGNORE``: silently skip checks for unresolveable forward references N)�__name__� __module__� __qualname__�__doc__r �ERROR�WARN�IGNORE� r r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_config.pyr s r c @ s& e Zd ZdZe� Ze� Zddd�ZdS ) �CollectionCheckStrategya} Specifies how thoroughly the contents of collections are type checked. This has an effect on the following built-in checkers: * ``AbstractSet`` * ``Dict`` * ``List`` * ``Mapping`` * ``Set`` * ``Tuple[<type>, ...]`` (arbitrarily sized tuples) Members: * ``FIRST_ITEM``: check only the first item * ``ALL_ITEMS``: check all items � collection� Iterable[T]�returnc C s4 | t ju rztt|��gW S ty Y dS w |S )Nr )r � FIRST_ITEM�next�iter� StopIteration)�selfr r r r �iterate_samples4 s �z'CollectionCheckStrategy.iterate_samplesN)r r r r )r r r r r r � ALL_ITEMSr r r r r r s r c @ sF e Zd ZU dZejZded< dZded< e j Z ded< d Z d ed < dS ) �TypeCheckConfigurationa� You can change Typeguard's behavior with these settings. .. attribute:: typecheck_fail_callback :type: Callable[[TypeCheckError, TypeCheckMemo], Any] Callable that is called when type checking fails. Default: ``None`` (the :exc:`~.TypeCheckError` is raised directly) .. attribute:: forward_ref_policy :type: ForwardRefPolicy Specifies what to do when a forward reference fails to resolve. Default: ``WARN`` .. attribute:: collection_check_strategy :type: CollectionCheckStrategy Specifies how thoroughly the contents of collections (list, dict, etc.) are type checked. Default: ``FIRST_ITEM`` .. attribute:: debug_instrumentation :type: bool If set to ``True``, the code of modules or functions instrumented by typeguard is printed to ``sys.stderr`` after the instrumentation is done Requires Python 3.9 or newer. Default: ``False`` r �forward_ref_policyNz TypeCheckFailCallback | None�typecheck_fail_callbackr �collection_check_strategyF�bool�debug_instrumentation) r r r r r r r" �__annotations__r# r r r$ r& r r r r r! > s $ �r! N)� __future__r �collections.abcr � dataclassesr �enumr r �typingr r � _functionsr r r r r! � global_configr r r r �<module> s - _vendor/typeguard/__pycache__/_checkers.cpython-310.pyc 0000644 00000046545 15030122015 0017046 0 ustar 00 o �h�z � @ s U d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl m Z d dlm Z m Z m Z d dlmZmZmZmZ d dlmZ d dlmZmZmZmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z' d dl(m)Z) d d l*m+Z+ zd dl,Z,W n e-y� dZ,Y nw d d l,m.Z. d d l/m0Z0 d d l1m2Z2m3Z3 d dl4m5Z5 d dl6m7Z7m8Z8m9Z9m:Z: ej;dkr�d dlm<Z<m=Z=m>Z>m?Z?m@Z@ eZAnd dl,m<Z<m=Z=m>Z>m?Z?m@Z@ d dl,mZA ej;dkr�d dlBmCZC d dlmDZD n d dlEmCZC d dl,mDZD eeee$edf e5gef ZFdeGd< eee$edf e$edf ge eF f ZHdeGd< g ZIdeGd< eJe �eJe e �fZKd eGd < ej;d k�r@eKejLf7 ZKe+� ZMd eGd < eN� ZOh d!�ZPdnd+d,�ZQdnd-d.�ZRdnd/d0�ZSdnd1d2�ZTdnd3d4�ZUdnd5d6�ZVdnd7d8�ZWdnd9d:�ZXdnd;d<�ZYdnd=d>�ZZdnd?d@�Z[dndAdB�Z\dCdD�dodHdI�Z]e,du �r�dpdLdM�Z^ndpdNdM�Z^dndOdP�Z_dndQdR�Z`dndSdT�ZadndUdV�ZbdndWdX�ZcdndYdZ�Zddnd[d\�Zednd]d^�Zfdnd_d`�Zgdndadb�Zhdndcdd�Zidqdfdg�Zji ekef�eeV�eed�eeQ�ejljeQ�emec�eneR�eeR�eoec�epeV�eed�eqeT�e eT�ejre_�e eR�e eR�deb�ejlj eRejlj eRe!eUejlj!eUejlj"eVeseVe"eVe#edeteWe$eWeJeZe%eZe'eXi �Zuej;dk�rJeYeuejv< eaeuejw< ej;dk�r[eu�xejye`ejzegi� e,du�rte_eue,jr< e`eue,jy< egeue,jz< eaeue,jw< drdjdk�Z{eI�|e{� dsdldm�Z}dS )t� )� annotationsN)�Enum)� Parameter�isclass� isfunction)�BufferedIOBase�IOBase� RawIOBase� TextIOBase)�indent)�IO� AbstractSet�Any�BinaryIO�Callable�Dict� ForwardRef�List�Mapping�MutableMapping�NewType�Optional�Sequence�Set�TextIO�Tuple�Type�TypeVar�Union)�Mock)�WeakKeyDictionary)� is_typeddict� )�ForwardRefPolicy)�TypeCheckError�TypeHintWarning)� TypeCheckMemo)�evaluate_forwardref�get_stacklevel� get_type_name�qualified_name)� � )� Annotated� NotRequired� TypeAlias�get_args� get_origin)r )r+ � )� entry_points)� ParamSpec.r/ �TypeCheckerCallable�TypeCheckLookupCallbackz list[TypeCheckLookupCallback]�checker_lookup_functionsztuple[type, ...]�generic_alias_types)r+ � zDWeakKeyDictionary[type[Any], dict[type[Any], TypeCheckError | None]]�protocol_check_cache>2 �__eq__�__ge__�__gt__�__le__�__lt__�__ne__�__or__�__add__�__and__�__cmp__�__div__�__ior__�__mod__�__mul__�__pow__�__ror__�__sub__�__xor__�__iadd__�__iand__�__idiv__�__imod__�__imul__�__ipow__�__isub__�__ixor__�__radd__�__rand__�__rdiv__�__rmod__�__rmul__�__rpow__�__rsub__�__rxor__� __divmod__� __lshift__� __matmul__� __rshift__� __ilshift__� __imatmul__� __irshift__� __rlshift__� __rmatmul__� __rrshift__� __truediv__� __floordiv__� __itruediv__� __rtruediv__� __ifloordiv__� __rfloordiv__�valuer � origin_type�args�tuple[Any, ...]�memor& �return�Nonec C sL t | �std��|r�zt�| �}W n ttfy Y d S w |d }t|t�r�tdd� |D ��s�dd� |j � � D �}|rFtdd� |�� ���d }}d } |j � � D ]"} | j t jt jfv rk|d 7 }| jt ju rj|d 7 }qQ| j t jkrsd } qQ|t|�kr�td t|�� d |� d���| s�|t|�k r�tdt|�� d |� d���d S d S d S d S d S )Nzis not callabler c s s � | ] }t |�tu V qd S �N)�typer4 )�.0�item� rx �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_checkers.py� <genexpr>� s � �z!check_callable.<locals>.<genexpr>c S s* g | ]}|j tjkr|jtjkr|j�qS rx )�kindr � KEYWORD_ONLY�default�empty�name)rv �paramrx rx ry � <listcomp>� s �z"check_callable.<locals>.<listcomp>z9has mandatory keyword-only arguments in its declaration: �, Fr" TzIhas too many mandatory positional arguments in its declaration; expected z but z* mandatory positional argument(s) declaredz3has too few arguments in its declaration; expected z argument(s) declared)�callabler$ �inspect� signature� TypeError� ValueError� isinstance�list�any� parameters�values�joinr{ r �POSITIONAL_ONLY�POSITIONAL_OR_KEYWORDr} r~ �VAR_POSITIONAL�len) rm rn ro rq r� �argument_types�unfulfilled_kwonlyargs�num_positional_args�num_mandatory_pos_args� has_varargsr� rx rx ry �check_callable� sl ������ � � �������#r� c C s" |t u s|tu rt| t�std��|tu s|tjju r't| tjj�s&td��n t| tjj�s2td��|r�|\}}|tus@|tur�|j j � | � � �}|D ]C\}}zt |||� W n tyl } z | �d|��� � d } ~ ww zt |||� W qK ty� } z | �d|��� � d } ~ ww d S d S d S )N� is not a dictzis not a mutable mappingzis not a mappingzkey � value of key )r �dictr� r$ r � collections�abcr r �config�collection_check_strategy�iterate_samples�items�check_type_internal�append_path_element) rm rn ro rq �key_type� value_type�samples�k�v�excrx rx ry � check_mapping� sB �� �����r� c C sv t | t�s td��t|j�}t|d�rt|j�}n |jr t|�nt� }t| �}|| }|rBd� dd� t |t d�D ��}td|� ���i } |j� � D ]#\} } t | t �rht| |�} t| �tu rh|�| � t| �d } | | | < qI|| } | r�d� d d� t | t d�D ��}td |� ���| � � D ],\} } | �| t�}|tur�zt|| |� W q� ty� } z |�d | ��� � d }~ww q�d S ) Nr� �__required_keys__r� c s � � | ] }d |� d �V qdS ��"Nrx �rv �keyrx rx ry rz � � z#check_typed_dict.<locals>.<genexpr>)r� z has unexpected extra key(s): r c s r� r� rx r� rx rx ry rz r� z is missing required key(s): r� )r� r� r$ � frozenset�__annotations__�hasattr�setr� � __total__r� �sorted�reprr� r r' r1 r. �discardr0 �get�_missingr� r� )rm rn ro rq � declared_keys� required_keys� existing_keys� extra_keys�keys_formatted� type_hintsr� � annotation� missing_keys�argtype�argvaluer� rx rx ry �check_typed_dict� sF ����r� c C s� t | t�s td��|r?|tfkrA|jj�| �}t|�D ]'\}}z t||d |� W q ty> } z |� d|� �� � d }~ww d S d S d S )Nz is not a listr �item ) r� r� r$ r r� r� r� � enumerater� r� �rm rn ro rq r� �ir� r� rx rx ry � check_list' s ���r� c C s� t | tjj�s td��|rA|tfkrC|jj�| �}t |�D ]'\}}z t ||d |� W q ty@ } z |� d|� �� � d }~ww d S d S d S )Nzis not a sequencer r� ) r� r� r� r r$ r r� r� r� r� r� r� r� rx rx ry �check_sequence: s ���r� c C s� |t u rt| t �s td��n t| t�std��|rJ|tfkrL|jj�| �}|D ]&}z t||d |� W q' tyI } z |� d|� d�� � d }~ww d S d S d S )Nzis not a frozensetz is not a setr �[�]) r� r� r$ r r r� r� r� r� r� )rm rn ro rq r� r� r� rx rx ry � check_setM s$ � ���r� c C s� t |dd � }rAt| |�stdt|�� ���|�� D ]$\}}z tt | |�||� W q ty> } z |�d|��� � d }~ww d S t| t�sJtd��|r]|d tu }|d |rXdnd � } nd S |r�| d } |j j � | �} t | �D ]!\} } zt| | |� W qp ty� } z |�d| � �� � d }~ww d S | dkr�| d kr�td ��d S t | �t | �kr�td t | �� d t | �� d ���t t| | ��D ]#\} \} } zt| | |� W q� ty� } z |�d| � �� � d }~ww d S )Nr� z is not a named tuple of type z attribute zis not a tuple���r r� �rx rx zis not an empty tuplez'has wrong number of elements (expected z, got z instead))�getattrr� r$ r* r� r� r� �tuple�Ellipsisr� r� r� r� r� �zip)rm rn ro rq � field_typesr � field_typer� � use_ellipsis� tuple_params� element_typer� r� �elementrx rx ry � check_tuplec sf ��� ���� �����r� c C s� i }z;|D ]&}z t | ||� W W ~d S ty+ } z ||t|�< W Y d }~qd }~ww td�dd� |�� D ��d�}W ~n~w td|� ���)N� c s �" � | ] \}}|� d |� �V qdS ��: Nrx �rv r� �errorrx rx ry rz � � � z check_union.<locals>.<genexpr>� �(did not match any element in the union: �r� r$ r) r r� r� �rm rn ro rq �errors�type_r� �formatted_errorsrx rx ry � check_union� s ����r� c C s~ i }|D ]$}z t | ||� W d S ty( } z ||t|�< W Y d }~qd }~ww td�dd� |�� D ��d�}td|� ���)Nr� c s r� r� rx r� rx rx ry rz � r� z"check_uniontype.<locals>.<genexpr>r� r� r� r� rx rx ry �check_uniontype� s ���r� c C sR t | �s t| t�s td��|sd S t|d t�r t|d |�}n|d }|tu r*d S t|dd�r9t| |d|� d S t|t �rIt | |d|dd� d S t |�t u r�i }t |�D ]-}|tu r^ d S z t| t|f|� W d S ty� } z ||t|�< W Y d }~qUd }~ww td�d d � |�� D ��d �}td |� ���t| |�s�td t|�� ���d S )Nzis not a classr � _is_protocolFrx T��subclass_checkr� c s r� r� rx r� rx rx ry rz � r� z check_class.<locals>.<genexpr>r� r� zis not a subclass of )r r� r8 r$ r r' r r� �check_protocolr � check_typevarr1 r r0 � check_classru r) r r� r� � issubclassr* ) rm rn ro rq �expected_classr� �argr� r� rx rx ry r� � sD ���� �r� c C s t | |j|� d S rt )r� � __supertype__�rm rn ro rq rx rx ry � check_newtype� s r� c C � t | |�stdt|�� ���d S �N�is not an instance of �r� r$ r* r� rx rx ry �check_instance� � �r� Fr� r r� �boolc C s� |j d ur|r t|j n|j }t| ||� d S |jrN|jD ] }|r%t| n|}z t| ||� W d S ty: Y q w d�dd� |jD ��}td|� d���d S )Nr� c s � � | ]}t |�V qd S rt )r) )rv � constraintrx rx ry rz s � �z check_typevar.<locals>.<genexpr>z'does not match any of the constraints (�))� __bound__r r� �__constraints__r$ r� )rm rn ro rq r� r� r �formatted_constraintsrx rx ry r� s( � �� � ��r� �typ�objectc C s | t ju S rt )�typing�Literal�r rx rx ry �_is_literal_type) s r c C s | t ju p | tju S rt )r r �typing_extensionsr rx rx ry r . s c sz d � fdd� � t � |��}z|�| �}W n ty Y n w t|| �t| �u r*d S d�dd� |D ��}td |� d ��d �) N� literal_argsrp rr c sh g }| D ]+}t t|��r|�� |j�� q|d u s#t|ttttt f�r)|� |� qt d|� ���t |�S )NzIllegal literal value: ) r r1 �extend�__args__r� �int�str�bytesr� r �appendr� r� )r �retvalr� ��get_literal_argsrx ry r 8 s �z'check_literal.<locals>.get_literal_argsr� c s r� rt )r� )rv r� rx rx ry rz O s � z check_literal.<locals>.<genexpr>zis not any of (r )r rp rr rp )r� �indexr� ru r� r$ )rm rn ro rq � final_argsr �formatted_argsrx r ry � check_literal2 s �r c C � t | t|� d S rt )r� r r� rx rx ry �check_literal_stringS � r c C r rt )r� r� r� rx rx ry �check_typeguard\ r r c C s | d urt d��d S )Nz is not None)r$ r� rx rx ry � check_nonee s �r c C sF |t u rt| t ttf�std��|tu r t| ttf�s!td��d S d S )Nz is neither complex, float or intzis neither float or int)�complexr� �floatr r$ r� rx rx ry � check_numbero s �r! c C sz |t u s |tu r|tfkrt| t�std��d S |tu s%|tu r2|tfkr2t| tt f�s0td��d S t| t �s;td��d S )Nz is not a text based I/O objectzis not a binary I/O objectzis not an I/O object) r r r r� r r$ r r r r r r� rx rx ry �check_io{ s �� �r" c C sJ t | �r| nt| �}|tv r t| }||v r || }r |�d S tttj��ddhB }i }i } t|�D ]7} | |v r:q3t|| �} t| �rft � | �} dd� | j � � D �pSt } | jtjur]| jnt}| |f|| < q3| | | < q3t�|��� D ]\} }|| | < qrt�|�}t�|i �}z�|�� D ]d\} }zt|| �}W n$ ty� | |v r�td|j� d| �d��d �td|j� d| ���d �w t|�s�td|j� d| �d ���z t|t||� W q� ty� } ztd|j� d| �d |� ��d �d }~ww | D ]} | |v�r t|| ��s td|j� d | ����q�W n t�y } z|||< � d }~ww d ||< d S ) Nr� � __non_callable_proto_members__c S s. g | ]}|j tjur|jtjur|jnt�qS rx )r{ r r| r� r~ r )rv �prx rx ry r� � s �z"check_protocol.<locals>.<listcomp>zis not compatible with the z protocol because its z attribute is not a methodz) protocol because it has no method named z attribute is not a callablez method z, protocol because it has no attribute named )r ru r: r� �dirr �Protocolr� r� r� r� r� r� r� �return_annotationr r~ r �get_type_hintsr� � setdefault�AttributeErrorr$ � __qualname__r� r r� )rm rn ro rq �subject� result_mapr� � ignored_attrs�expected_methods� expected_noncallable_members�attrname�memberr� �argtypesr' r� �subject_annotations� callable_args�methodrx rx ry r� � s� � �� �� ��� ���� �� ������ ������ r� c C s t | tttf�s td��d S )Nzis not bytes-like)r� � bytearrayr � memoryviewr$ r� rx rx ry �check_byteslike� s �r9 c C sf |j d u r td��t| �r t| |j �s tdt|j �� d���d S t| |j �s1tdt|j �� d���d S )Nz7cannot be checked against Self outside of a method callz%is not an instance of the self type (r )� self_typer$ r r� r* r� r� rx rx ry � check_self� s ��� ��r; c C s d S rt rx r� rx rx ry �check_paramspec s r< c C r� r� r� r� rx rx ry �check_instanceof r� r= r� c C s� t |t�r3zt||�}W n& ty2 |jjtju r� |jjtju r/t j d|j ��t t � d� Y dS w |tu s@|tu s@t | t�rBdS t| �sOtt| �jv rOdS t|�}|tu rft|�^}}t|�}t|�}nd}|durt|�}|ttfv r~|tur~|s~d}n|}d}tD ]}||||�}|r�|| |||� dS q�t|�r�t | |�s�tdt|�� ���dS t|�t u r�t j d|�d�t t � d� dS dS ) a� Check that the given object is compatible with the given type annotation. This function should only be used by type checker callables. Applications should use :func:`~.check_type` instead. :param value: the value to check :param annotation: the type annotation to check against :param memo: a memo object containing configuration and information necessary for looking up forward references z!Cannot resolve forward reference �� stacklevelNrx r� r� z Skipping type check against zN; this looks like a string-form forward reference imported from another module) r� r r' � NameErrorr� �forward_ref_policyr# �ERROR�WARN�warnings�warn�__forward_arg__r% r( r �SubclassableAnyr r ru � __bases__r1 r- r0 r� r r7 r$ r* r ) rm r� rq rn �extras_�extrasro � lookup_func�checkerrx rx ry r� s` �� � � � ��r� rJ �TypeCheckerCallable | Nonec C s� t �| �}|d ur |S t| �rtS t| �r t| t�r tS t| dd�r$t S t | t �r+t S t | t �r2tS | jtu r9tS t| �rUt| dd �dkrUt| dd��d�rUt| d�rUtS d S ) Nr� F� __module__r r+ � zNewType.r� )�origin_type_checkersr� r! r� r r� r r� r� r� r� r4 r< r r� � __class__r r� r � startswithr� )rn ro rJ rL rx rx ry �builtin_checker_lookup� s6 � ���rS c C s� t dd�D ]F} z| �� }W n% ty2 } ztjd| j�dt|�� d|� �dd� W Y d}~qd}~ww t|�sEtjd| � d |��dd� qt� d |� qdS ) a� Load all type checker lookup functions from entry points. All entry points from the ``typeguard.checker_lookup`` group are loaded, and the returned lookup functions are added to :data:`typeguard.checker_lookup_functions`. .. note:: This function is called implicitly on import, unless the ``TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD`` environment variable is present. ztypeguard.checker_lookup)�groupzFailed to load plugin r� � r> NzPlugin z! returned a non-callable object: r ) r3 �load� ExceptionrD rE r r* r� r7 �insert)�ep�pluginr� rx rx ry � load_plugins� s$ � ����r[ ) rm r rn r ro rp rq r& rr rs ) rm r rn r ro rp rq r& r� r� rr rs )r r rr r� )rm r r� r rq r& rr rs )rn r ro rp rJ rp rr rM )rr rs )~� __future__r �collections.abcr� r� �sys�typesr rD �enumr r r r �ior r r r �textwrapr r r r r r r r r r r r r r r r r r r r � unittest.mockr �weakrefr r � ImportErrorr! �_configr# � _exceptionsr$ r% �_memor& �_utilsr' r( r) r* � version_infor- r. r/ r0 r1 rG �importlib.metadatar3 r4 �importlib_metadatar5 r� r6 r7 ru r8 � GenericAliasr: r r� �BINARY_MAGIC_METHODSr� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r! r" r� r9 r; r< r= r� r r� r r� r r� r� r r� r� rP � UnionType� TypeGuard�update� LiteralString�SelfrS r r[ rx rx rx ry �<module> s T � � � � 6 ; # / : - � ! b N�������� � � � � ������ � # _vendor/typeguard/__pycache__/__init__.cpython-310.pyc 0000644 00000003347 15030122015 0016650 0 ustar 00 o �h � @ s� U d dl Z d dlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd l m Z dd l m Z dd l m Z dd l mZ dd l mZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddl m Z ddl m Z ddl!m"Z" e#e$� �%� �D ]Z&e'e&dd ��(e)� d ��r�e)e&_*q�e e+d < d e,d efd!d"�Z-d#e j.vr�e� dS dS )$� N)�Any� )�TypeCheckerCallable)�TypeCheckLookupCallback)�check_type_internal)�checker_lookup_functions)� load_plugins)�CollectionCheckStrategy)�ForwardRefPolicy)�TypeCheckConfiguration)� typechecked)�typeguard_ignore)�InstrumentationWarning)�TypeCheckError)�TypeCheckWarning)�TypeHintWarning)�TypeCheckFailCallback)� check_type)� warn_on_error)�ImportHookManager)�TypeguardFinder)�install_import_hook)� TypeCheckMemo)�suppress_type_checks)�Unset� __module__� �.�config�name�returnc C s, | dkr ddl m} |S tdt�d| ����)Nr r )� global_configzmodule z has no attribute )�_configr! �AttributeError�__name__)r r! � r% �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/__init__.py� __getattr__% s r' �!TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD)/�os�typingr � _checkersr r r r r r" r r r � _decoratorsr r � _exceptionsr r r r � _functionsr r r � _importhookr r r �_memor � _suppressionr �_utilsr �list�locals�values�value�getattr� startswithr$ r �__annotations__�strr' �environr% r% r% r& �<module> sD � � _vendor/typeguard/__pycache__/_union_transformer.cpython-310.pyc 0000644 00000003561 15030122015 0021020 0 ustar 00 o �hJ � @ s� d Z ddlmZ ddlmZmZmZmZmZm Z m Z m Z m Z ddlm Z ddlmZ ddlmZmZmZmZmZm Z mZ eee eeed�ZG dd � d e �Zddd�ZdS )zx Transforms lazily evaluated PEP 604 unions into typing.Unions, for compatibility with Python versions older than 3.10. � )� annotations) �BinOp�BitOr�Index�Load�Name�NodeTransformer� Subscript�fix_missing_locations�parse)�Tuple)�CodeType)�Any�Dict� FrozenSet�List�Setr �Union)�dict�list�tuple�set� frozensetr c @ s" e Zd Zd d dd�Zdd d �ZdS )�UnionTransformerN� union_name� Name | Nonec C s |pt dt� d�| _d S )Nr )�id�ctx)r r r )�selfr � r �b/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_union_transformer.py�__init__" s zUnionTransformer.__init__�noder �returnr c C sH | � |� t|jt�r"t| jtt|j|j gt � d�t � d�t � d�S |S )N)�eltsr )r )�value�slicer ) � generic_visit� isinstance�opr r r r �ASTTuple�left�rightr )r r" r r r � visit_BinOp% s ��z UnionTransformer.visit_BinOp)N)r r )r" r r# r )�__name__� __module__� __qualname__r! r- r r r r r ! s r �hint�strr# r c C s0 t | dd�}t� �|� t|� t|dddd�S )Nz<string>�evalr )�flags)r r �visitr �compile)r1 �parsedr r r �compile_type_hint3 s r8 N)r1 r2 r# r )�__doc__� __future__r �astr r r r r r r r r r r* �typesr �typingr r r r r r �type_substitutionsr r8 r r r r �<module> s , $� _vendor/typeguard/__pycache__/_suppression.cpython-310.pyc 0000644 00000005212 15030122015 0017633 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlmZmZ d dlmZ d dlm Z d dl m Z d dl m Z mZmZ ejdkr:d d l mZ nd d lmZ ed �Zed �Zd ae � Zeddd��Zeddd��Z dddd�ZdS )� )� annotationsN)�Callable� Generator)�contextmanager)�update_wrapper)�Lock)�ContextManager�TypeVar�overload)� � )� ParamSpec�P�T�func�Callable[P, T]�returnc C � d S �N� �r r r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_suppression.py�suppress_type_checks � r �ContextManager[None]c C r r r r r r r r r �Callable[P, T] | None�%Callable[P, T] | ContextManager[None]c s8 d � fdd� }dd d �}� d u rt |�� S t|� � |S )a� Temporarily suppress all type checking. This function has two operating modes, based on how it's used: #. as a context manager (``with suppress_type_checks(): ...``) #. as a decorator (``@suppress_type_checks``) When used as a context manager, :func:`check_type` and any automatically instrumented functions skip the actual type checking. These context managers can be nested. When used as a decorator, all type checking is suppressed while the function is running. Type checking will resume once no more context managers are active and no decorated functions are running. Both operating modes are thread-safe. �args�P.args�kwargs�P.kwargsr r c s� t � td7 aW d � n1 sw Y � d us J �z � | i |��W t � td8 aW d � S 1 s5w Y S t � td8 aW d � w 1 sLw Y w �N� ��type_checks_suppress_lock�type_checks_suppressed)r r r r r �wrapper7 s � $� �z%suppress_type_checks.<locals>.wrapper�Generator[None, None, None]c s s� � t � td7 aW d � n1 sw Y z d V W t � td8 aW d � d S 1 s.w Y d S t � td8 aW d � w 1 sFw Y w r! r# r r r r �cmD s � � (� �z suppress_type_checks.<locals>.cmN)r r r r r r )r r' )r r )r r& r( r r r r s )r r r r )r r r )r r r r )� __future__r �sys�collections.abcr r � contextlibr � functoolsr � threadingr �typingr r r � version_infor �typing_extensionsr r r% r$ r r r r r �<module> s( � _vendor/typeguard/__pycache__/_decorators.cpython-310.pyc 0000644 00000015746 15030122015 0017423 0 ustar 00 o �hI# � @ s� d dl mZ d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z m Z d dl m Z m Z mZ d dlmZmZmZmZmZmZmZ d dlmZ d d lmZmZm Z d d l m Z d d l m Z d d l!m"Z" d dl#m$Z$m%Z%m&Z&m'Z'm(Z( er�d dl)m*Z* ed�Z+d;dd�Z,nd dlm-Z, ededef d�Z.d<d d �Z/d=d%d&�Z0d>d(d)�Z1ee(e(e(e(d*�d?d4d5��Z2ed@d7d5��Z2 dAe(e(e(e(d*�dBd:d5�Z2dS )C� )� annotationsN)�Sequence)�partial)�isclass� isfunction)�CodeType� FrameType� FunctionType)� TYPE_CHECKING�Any�Callable� ForwardRef�TypeVar�cast�overload)�warn� )�CollectionCheckStrategy�ForwardRefPolicy� global_config)�InstrumentationWarning)�TypeCheckFailCallback)�TypeguardTransformer)�Unset� function_name�get_stacklevel� is_method_of�unset)�_Cell�_F�f�returnc C s | S )z5This decorator is a noop during static type-checking.� )r r" r" �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_decorators.py�typeguard_ignore s r$ )� no_type_check�T_CallableOrType.)�bound�value�objectr c s � fdd�j d S )Nc s � S �Nr" r" �r( r" r# �<lambda># s zmake_cell.<locals>.<lambda>r )� __closure__r+ r" r+ r# � make_cell" s r. �new_coder � target_path� Sequence[str]� firstlineno�int�CodeType | Nonec C sj |d }| j D ]+}t|t�r2|j|kr2|j|kr | S t|�dkr2t||dd � |�}|r2| S qd S )Nr r )� co_consts� isinstancer �co_name�co_firstlineno�len�find_target_function)r/ r0 r2 � target_name�const� target_coder" r" r# r: & s ��r: �FunctionType | strc C s t | dd �sdS t | dd �sdS | jjdkrdS t| d�r dS d d � | j�d �D �}t�tj | j �}t � |�}t || jj�}|�|� |jrM|jd u rOd S t|| jjd dd�}t|||j�}|sddS tjr�tjdkr�td| j� d�tjd� tt �|j�tjd� tdtjd� | j}|j| jjkr�t t t� � �}t t |j �}t t |j �j } g } |jD ]*} | |j!v r�| �"| �p�t#| �} | �$t%| �� q�| js�J �| �$| j| jj�&| � � q�t'| �}t(|| j)| j*|d�} | j | _ | j*| _*| j| _| j+| _+| j,| _,| j-| _-| j.| _.| S )N�__code__zno code associated� __module__z __module__ attribute is not setz<stdin>z-cannot instrument functions defined in a REPL� __wrapped__zh@typechecked only supports instrumenting functions wrapped with @classmethod, @staticmethod or @propertyc S s g | ]}|d kr|�qS )z<locals>r" )�.0�itemr" r" r# � <listcomp>F s z instrument.<locals>.<listcomp>�.z-instrumentor did not find the target function�execT)� dont_inheritz*cannot find the target function in the AST)� � zSource code of zH() after instrumentation: ----------------------------------------------)�filez.----------------------------------------------)�closure)/�getattrr? � co_filename�hasattr� __qualname__�split�inspect� getsource�sys�modulesr@ �ast�parser r8 �visit� target_node� target_lineno�compiler: r �debug_instrumentation� version_info�print�stderr�unparser- � co_freevarsr r � currentframe�f_back�f_locals�names_used_in_annotations�getr �appendr. �index�tupler � __globals__�__name__�__annotations__�__doc__� __defaults__�__kwdefaults__)r r0 � module_source� module_ast� instrumentor� module_coder/ rK �frame� frame_locals�cells�keyr( � new_functionr" r" r# � instrument9 sl � � �� rx ��forward_ref_policy�typecheck_fail_callback�collection_check_strategyr[ rz �ForwardRefPolicy | Unsetr{ � TypeCheckFailCallback | Unsetr| � CollectionCheckStrategy | Unsetr[ � bool | Unset�.Callable[[T_CallableOrType], T_CallableOrType]c C � d S r* r" ry r" r" r# � typechecked� s r� �targetc C r� r* r" )r� r" r" r# r� � s �T_CallableOrType | Noner c C sz | du r t t||||d�S t| �r�| j�� D ]p\}}t|| �r/t|�}t|�r.t| ||� qt |t t f�rQt|j | �rPt|j �}t|�rP|� |�}t| ||� qt |t�r�t|jd�} dD ] } t|| � } | | < t| | �rzt| �}t|�rz|| | < q^t| ||j di | ��� q| S d} t | t t f�r�| j } | j } t| �}t |t�r�t|� dt| �� �tt� d� | S | du r�|S | |�S ) a Instrument the target function to perform run-time type checking. This decorator recompiles the target function, injecting code to type check arguments, return values, yield values (excluding ``yield from``) and assignments to annotated local variables. This can also be used as a class decorator. This will instrument all type annotated methods, including :func:`@classmethod <classmethod>`, :func:`@staticmethod <staticmethod>`, and :class:`@property <property>` decorated methods in the class. .. note:: When Python is run in optimized mode (``-O`` or ``-OO``, this decorator is a no-op). This is a feature meant for selectively introducing type checking into a code base where the checks aren't meant to be run in production. :param target: the function or class to enable type checking for :param forward_ref_policy: override for :attr:`.TypeCheckConfiguration.forward_ref_policy` :param typecheck_fail_callback: override for :attr:`.TypeCheckConfiguration.typecheck_fail_callback` :param collection_check_strategy: override for :attr:`.TypeCheckConfiguration.collection_check_strategy` :param debug_instrumentation: override for :attr:`.TypeCheckConfiguration.debug_instrumentation` Nry F)�doc)�fset�fget�fdelz -- not typechecking )� stacklevelr" )r r� r �__dict__�itemsr rx r �setattrr6 � classmethod� staticmethod�__func__� __class__�property�dictrl rL �strr r r r ) r� rz r{ r| r[ rv �attr�retval�wrapper�kwargs�name� property_func� wrapper_classr" r" r# r� � sf #� � � ��� �)r r r! r )r( r) r! r )r/ r r0 r1 r2 r3 r! r4 )r r& r! r> ) rz r} r{ r~ r| r r[ r� r! r� )r� r& r! r& r* ) r� r� rz r} r{ r~ r| r r[ r� r! r )3� __future__r rU rQ rS �collections.abcr � functoolsr r r �typesr r r �typingr r r r r r r �warningsr �_configr r r � _exceptionsr � _functionsr � _transformerr �_utilsr r r r r �typeshed.stdlib.typesr r r$ r% r& r. r: rx r� r" r" r" r# �<module> sN $ H� �� _vendor/typeguard/__pycache__/_utils.cpython-310.pyc 0000644 00000012102 15030122015 0016375 0 ustar 00 o �h� � @ sz U d dl mZ d dlZd dlZd dlmZ d dlmZ d dlmZm Z m Z d dl m Z m Z mZmZmZmZmZ d dlmZ e rEdd lmZ ejd krXd d l mZmZ d9dd�Zn/ejdkrkd d l mZmZ d9dd�Zn d d lmZmZ ejdkr|e � fndZ de d< d9dd�Ze� Z de d < d:d d �Z d!d"�d;d&d'�Z!d<d*d+�Z"d=d-d.�Z#d>d2d3�Z$d?d5d6�Z%eG d7d8� d8��Z&e&� Z'dS )@� )� annotationsN)� import_module)� currentframe)�CodeType� FrameType� FunctionType)� TYPE_CHECKING�Any�Callable� ForwardRef�Union�cast�final)�WeakValueDictionary� )� TypeCheckMemo)� � )�get_args� get_origin� forwardrefr �memor �returnr c C s | j |j|jdt� d�S )N� )� type_params�recursive_guard�� _evaluate�globals�locals� frozenset�r r r r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_utils.py�evaluate_forwardref s �r# �r � c C s | j |j|jt� d�S )N)r r r! r r r" r# s ��r � r ztuple[frozenset[Any], ...]�evaluate_extra_argsc C s� ddl m}m} | js|| j�| _z | j|j|jgt �R � W S t yO t j dk rN|j� � }|�dt� t j dk r?|�|� | j||jpF|gt �R � Y S � w )Nr )�compile_type_hint�type_substitutionsr$ r r& )�_union_transformerr) r* �__forward_evaluated__�__forward_arg__�__forward_code__r r r r( � NameError�sys� version_info�copy� setdefaultr �update)r r r) r* � new_globalsr r r" r# % s$ � ��z+WeakValueDictionary[CodeType, FunctionType]�_functions_map�type_�strc C s� dD ]}t | |d �}t|t�r|} n qt| �}t |dd �}|d u r)| jj�d�}t|t�r1|}ndS t| �}|rZ|dkrHd�dd� |D ��}n d�d d� |D ��}|d |� d �7 }t | d d �}|rl|d vrl|d | }|S )N)�__name__�_namer- r: �_z (unknown)�Literalz, c s � � | ]}t |�V qd S �N)�repr��.0�argr r r" � <genexpr>T � � z get_type_name.<locals>.<genexpr>c s r= r> )� get_type_namer@ r r r" rC V rD �[�]� __module__)N�typing�typing_extensions�builtins�.) �getattr� isinstancer8 r � __class__r9 �stripr �join)r7 �attrname� candidate�name�origin�args�formatted_args�moduler r r" rE ? s. � rE F)�add_class_prefix�objrY �boolc C sb | du rdS t �| �r|rdnd}| }nd}t| �}|j}|j}|dv r&|n|� d|� �}|| S )z� Return the qualified name (e.g. package.module.Type) for the given object. Builtins and types from the :mod:`typing` package get special treatment by having the module name stripped from the generated name. N�Nonezclass � )rI rK rL )�inspect�isclass�typerH � __qualname__)rZ rY �prefixr7 rX �qualnamerT r r r" �qualified_namea s rd �func�Callable[..., Any]c C s4 t | dd�}|dvr|d nd}|t | dt| �� S )z� Return the qualified name of the given function. Builtins and types from the :mod:`typing` package get special treatment by having the module name stripped from the generated name. rH r] )rK r] rL ra )rM r? )re rX rc r r r" � function_namex s rg � referencec C sT | � d�d d d� \}}|r|st| �d���t|�}|�d�D ]}t||�}q |S )N�:� z" is not a module:varname referencerL )� partition� ValueErrorr �splitrM )rh � modulename�varnamerZ �attrr r r" �resolve_reference� s rq �object�clsr` c C s( t �| �o| j|jko| j�|jd �S )NrL )r^ � isfunctionrH ra � startswith)rZ rs r r r" � is_method_of� s ��rv �intc C sT d} t tt� �j}|r(|j�dd��d�r(| d7 } |j}|r(|j�dd��d�s| S )Nr r9 r] z typeguard.)r r r �f_back� f_globals�getru )�level�framer r r" �get_stacklevel� s �r} c @ s e Zd ZdZddd�ZdS )�Unsetr r r8 c C s dS )Nz<unset>r )�selfr r r" �__repr__� s zUnset.__repr__N)r r8 )r9 rH ra � __slots__r� r r r r" r~ � s r~ )r r r r r r )r7 r r r8 )rZ r rY r[ r r8 )re rf r r8 )rh r8 r r )rZ rr rs r` r r[ )r rw )(� __future__r r^ r0 � importlibr r �typesr r r rI r r r r r r r �weakrefr �_memor r1 r r r# rJ r r( �__annotations__r6 rE rd rg rq rv r} r~ �unsetr r r r" �<module> s< $ � " _vendor/typeguard/__pycache__/_memo.cpython-310.pyc 0000644 00000003135 15030122015 0016200 0 ustar 00 o �h � @ s: d dl mZ d dlmZ d dlmZmZ G dd� d�ZdS )� )� annotations)�Any)�TypeCheckConfiguration� global_configc @ s& e Zd ZdZdZded�dd d �ZdS )� TypeCheckMemoa� Contains information necessary for type checkers to do their work. .. attribute:: globals :type: dict[str, Any] Dictionary of global variables to use for resolving forward references. .. attribute:: locals :type: dict[str, Any] Dictionary of local variables to use for resolving forward references. .. attribute:: self_type :type: type | None When running type checks within an instance method or class method, this is the class object that the first argument (usually named ``self`` or ``cls``) refers to. .. attribute:: config :type: TypeCheckConfiguration Contains the configuration for a particular set of type checking operations. ��globals�locals� self_type�configN)r r r �dict[str, Any]r r � type | Noner r c C s || _ || _|| _|| _d S )Nr )�selfr r r r � r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_memo.py�__init__% s zTypeCheckMemo.__init__)r r r r r r r r )�__name__� __module__� __qualname__�__doc__� __slots__r r r r r r r s �r N)� __future__r �typingr �typeguard._configr r r r r r r �<module> s _vendor/typeguard/__pycache__/_functions.cpython-310.pyc 0000644 00000017027 15030122015 0017260 0 ustar 00 o �h�( � @ s� U d dl mZ d dlZd dlZd dlmZmZmZmZm Z m Z ddl m Z ddl mZmZ ddlmZmZmZ ddlmZmZ dd lmZ dd lmZmZ ej d kr]d d lm Z m Z m Z n d d l m Z m Z m Z ed �Z!eeegef Z"de#d< e dddd�dAd d ��Z$e dddd�dBd d ��Z$e� j%e� j&e� j'd�dBd!d �Z$dCd)d*�Z(dDd-d.�Z)dEd0d1�Z*dFd3d4�Z+dGd6d7�Z,dHd:d;�Z-dId?d@�Z.dS )J� )� annotationsN)�Any�Callable�NoReturn�TypeVar�Union�overload� )� _suppression)�BINARY_MAGIC_METHODS�check_type_internal)�CollectionCheckStrategy�ForwardRefPolicy�TypeCheckConfiguration)�TypeCheckError�TypeCheckWarning)� TypeCheckMemo)�get_stacklevel�qualified_name)� � )�Literal�Never� TypeAlias�Tr �TypeCheckFailCallback.��forward_ref_policy�typecheck_fail_callback�collection_check_strategy�value�object� expected_type�type[T]r r r � TypeCheckFailCallback | Noner r �returnc C � d S �N� �r r" r r r r( r( �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_functions.py� check_type � r+ r c C r& r' r( r) r( r( r* r+ & r, c C s� t |�tu r t| }t|||d�}tjs|tu r| S t�d�}t |j |j |d�}z t | ||� W | S t yX } z|�t| dd�� |jrL|�||� n� W Y d}~| S d}~ww )a� Ensure that ``value`` matches ``expected_type``. The types from the :mod:`typing` module do not support :func:`isinstance` or :func:`issubclass` so a number of type specific checks are required. This function knows which checker to call for which type. This function wraps :func:`~.check_type_internal` in the following ways: * Respects type checking suppression (:func:`~.suppress_type_checks`) * Forms a :class:`~.TypeCheckMemo` from the current stack frame * Calls the configured type check fail callback if the check fails Note that this function is independent of the globally shared configuration in :data:`typeguard.config`. This means that usage within libraries is safe from being affected configuration changes made by other libraries or by the integrating application. Instead, configuration options have the same default values as their corresponding fields in :class:`TypeCheckConfiguration`. :param value: value to be checked against ``expected_type`` :param expected_type: a class or generic type instance, or a tuple of such things :param forward_ref_policy: see :attr:`TypeCheckConfiguration.forward_ref_policy` :param typecheck_fail_callback: see :attr`TypeCheckConfiguration.typecheck_fail_callback` :param collection_check_strategy: see :attr:`TypeCheckConfiguration.collection_check_strategy` :return: ``value``, unmodified :raises TypeCheckError: if there is a type mismatch r r )�configT��add_class_prefixN)�type�tupler r r �type_checks_suppressedr �sys� _getframer � f_globals�f_localsr r �append_path_elementr r ) r r" r r r r- �frame�memo�excr( r( r* r+ 1 s. *� � ���� func_name�str� arguments�dict[str, tuple[Any, Any]]r9 r � Literal[True]c C s� t jrdS |�� D ]\\}\}}|tu s|tu r,t| � d��}|jjr*|j�||� n|�zt|||� W q tye } z%t |dd�}|� d|� d|� d�� |jjrZ|j�||� n� W Y d }~q d }~ww dS )NTz-() was declared never to be called but it wasr. z argument "z" (�)) r r2 �itemsr r r r- r r r r7 )r; r= r9 �argnamer � annotationr: �qualnamer( r( r* �check_argument_typesu s, � ���rE �retvalrC c C s� t jr|S |tu s |tu r"t| � d��}|jjr |j�||� n|�z t|||� W |S tyv } z?|tu rO|t u rO| � dd�d } | t v rO|W Y d }~S t |dd�}|� d|� d�� |jjrj|j�||� n� W Y d }~|S d }~ww ) Nz*() was declared never to return but it did�.r ���Tr. zthe return value (r@ )r r2 r r r r- r r �NotImplemented�bool�rsplitr r r7 )r; rF rC r9 r: rD r( r( r* �check_return_type� s0 � ���rL �sendvalc C � t jr|S |tu s |tu r"t| � d��}|jjr |j�||� n|�z t|||� W |S tyZ } z#t|dd�}|� d|� d�� |jjrN|j�||� n� W Y d }~|S d }~ww )Nz6() was declared never to be sent a value to but it wasTr. z the value sent to generator (r@ � r r2 r r r r- r r r r7 )r; rM rC r9 r: rD r( r( r* �check_send_type� s, � � ���rP �yieldvalc C rN )Nz)() was declared never to yield but it didTr. zthe yielded value (r@ rO )r; rQ rC r9 r: rD r( r( r* �check_yield_type� s( � ���rR �varnamec C s� t jr| S z t| ||� W | S ty@ } z&t| dd�}|�d|� d|� d�� |jjr4|j�||� n� W Y d }~| S d }~ww )NTr. �value assigned to � (r@ )r r2 r r r r7 r- r )r rS rC r9 r: rD r( r( r* �check_variable_assignment� s � ���rV �targets�list[dict[str, Any]]c C s2 t dd� |D ��dkr| g}nt| �}tjs�|D ]t}d}t|�� �D ]i\}\}}|�d�rJ|dd � }t|�d | } t|�| } ||| � } | }n|| } |d7 }zt| ||� W q" t y� } z%t | dd�} | � d|� d | � d �� |j j r�|j � | |� n� W Y d } ~ q"d } ~ ww qt|�dkr�|d S |S ) Nc s s � | ]}t |�V qd S r' )�len)�.0�targetr( r( r* � <genexpr> s � z2check_multi_variable_assignment.<locals>.<genexpr>r r �*Tr. rT rU r@ )�max�listr r2 � enumeraterA � startswithrY r r r r7 r- r )r rW r9 �iterated_values�expected_types� value_index� ann_indexrS r" � keys_left�next_value_index�objr: rD r( r( r* � check_multi_variable_assignment s< � ����ri r: r �Nonec C s t jtt| ��t� d� dS )z� Emit a warning on a type mismatch. This is intended to be used as an error handler in :attr:`TypeCheckConfiguration.typecheck_fail_callback`. )� stacklevelN)�warnings�warnr r< r )r: r9 r( r( r* � warn_on_error, s rn ) r r! r" r# r r r r$ r r r% r ) r r! r" r r r r r$ r r r% r )r; r< r= r> r9 r r% r? ) r; r< rF r rC r r9 r r% r ) r; r< rM r rC r r9 r r% r ) r; r< rQ r rC r r9 r r% r ) r r! rS r< rC r r9 r r% r )r r rW rX r9 r r% r )r: r r9 r r% rj )/� __future__r r3 rl �typingr r r r r r � r � _checkersr r �_configr r r � _exceptionsr r �_memor �_utilsr r � version_infor r r �typing_extensionsr r �__annotations__r+ r r r rE rL rP rR rV ri rn r( r( r( r* �<module> sH � �� D $ % _vendor/typeguard/__pycache__/_pytest_plugin.cpython-310.pyc 0000644 00000007753 15030122015 0020163 0 ustar 00 o �h@ � @ s� d dl mZ d dlZd dlZd dlmZmZmZ d dlm Z m Z m Z d dl m Z d dlmZ d dlmZmZ er@d dlmZmZ dd d�Zddd�ZdS )� )� annotationsN)� TYPE_CHECKING�Any�Literal)�CollectionCheckStrategy�ForwardRefPolicy� global_config)�InstrumentationWarning)�install_import_hook)�qualified_name�resolve_reference)�Config�Parser�parserr �return�Nonec s� d� �fdd� }�� d�� � jdd d d � |d � � jd ddd � |d� � jdd dd � |d� � jdd ttj�dd� |d� � jdd ttj�dd� |d� d S )N�opt_type�ILiteral['string', 'paths', 'pathlist', 'args', 'linelist', 'bool'] | Noner r c s6 �� � jd �� d dd � � jd �� d | � d S )N���r � �help)�addini�options�names�attrs)r ��groupr � �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py�add_ini_option s �z(pytest_addoption.<locals>.add_ini_option� typeguardz--typeguard-packages�storez�comma separated name list of packages and modules to instrument for type checking, or :all: to instrument all modules loaded after typeguard)�actionr �linelistz!--typeguard-debug-instrumentation� store_truez%print all instrumented code to stderr�boolz#--typeguard-typecheck-fail-callbackz�a module:varname (e.g. typeguard:warn_on_error) reference to a function that is called (with the exception, and memo object as arguments) to handle a TypeCheckError�stringz --typeguard-forward-ref-policyzPdetermines how to deal with unresolveable forward references in type annotations)r" �choicesr z%--typeguard-collection-check-strategyz@determines how thoroughly to check collections (list, dict, etc))r r r r )�getgroup� addoption�listr � __members__r )r r r r r �pytest_addoption sD ��� � � r, �configr c s& d� fdd� }g }� � d� }rdd � |�d �D �}n � �d � }r$|}|rL|d gkr.d }ntd d� |D ��}|rGtjdd�|�� �tdd� t|d� |d�}|rUdt _ |d�}|rst |�}t |�spt |� dt|j�� d���|t _|d�} | r�tj| } | t _|d�} | r�tj| } | t _d S d S ) N�name�strr r c s � � | �dd��p � �| �S )N�-�_)� getoption�replace�getini)r. �r- r r r2 L s z#pytest_configure.<locals>.getoption�typeguard_packagesc S s g | ]}|� � �qS r )�strip)�.0�pkgr r r � <listcomp>Q s z$pytest_configure.<locals>.<listcomp>�,ztypeguard-packagesz:all:c s s � | ] }|t jv r|V qd S )N)�sys�modules)r8 �packager r r � <genexpr>Y s � �z#pytest_configure.<locals>.<genexpr>zItypeguard cannot check these packages because they are already imported: z, � )� stacklevel)�packagesz typeguard-debug-instrumentationTz!typeguard-typecheck-fail-callbackz (z) is not a callablez typeguard-forward-ref-policyz#typeguard-collection-check-strategy)r. r/ r r )r2 �splitr4 �sorted�warnings�warn�joinr r r �debug_instrumentationr �callable� TypeErrorr � __class__�typecheck_fail_callbackr r+ �forward_ref_policyr �collection_check_strategy) r- r2 rB �packages_option� packages_ini�already_imported_packages� debug_option�fail_callback_option�callback�forward_ref_policy_optionrM � collection_check_strategy_optionrN r r5 r �pytest_configureK sV ��� � � �rW )r r r r )r- r r r )� __future__r r< rE �typingr r r �typeguard._configr r r �typeguard._exceptionsr �typeguard._importhookr �typeguard._utilsr r �pytestr r r, rW r r r r �<module> s ; _vendor/typeguard/__pycache__/_importhook.cpython-310.pyc 0000644 00000015535 15030122015 0017445 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlZd dlZd dlmZmZ d dlm Z d dl m Z m Z d dl mZmZ d dlmZ d dlmZ d d lmZmZmZ d d lmZmZ d d lmZ d d l m Z d dl m Z ej dkrld dlm!Z! nd dl"m!Z! ej dkr~d dlm#Z# nd dl"m#Z# ej dkr�d dl$m%Z%m&Z& nd dl'm%Z%m&Z& zdd�(e&d��)d�dd� � Z*W n e%y� dZ*Y nw e#d�Z+ed�Z,d7d"d#�Z-d8d9d(d)�Z.G d*d+� d+e �Z/G d,d-� d-e �Z0G d.d/� d/�Z1 d8e0d0�d:d5d6�Z2dS );� )� annotationsN)�Callable�Iterable)�MetaPathFinder)� ModuleSpec�SourceFileLoader)�cache_from_source� decode_source)�isclass)�PathLike)�CodeType� ModuleType� TracebackType)�Sequence�TypeVar)�patch� )� global_config)�TypeguardTransformer)� � )�Buffer)r � )� ParamSpec)r � )�PackageNotFoundError�version� typeguard� �.r �P�T�f�Callable[P, T]�args�P.args�kwargs�P.kwargs�returnc O s | |i |��S �N� )r" r$ r& r* r* �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_importhook.py�_call_with_frames_removed, s r, �path�str�debug_override� bool | Nonec C s t | |td�S )N)� optimization)r � OPTIMIZATION)r- r/ r* r* r+ �optimized_cache_from_source2 s r3 c s0 e Zd Ze dddd ��Zd� fd d� Z� ZS )�TypeguardLoader�<string>�data�<Buffer | str | ast.Module | ast.Expression | ast.Interactiver- � Buffer | str | PathLike[str]r( r c C s� t | tjtjtjf�r| }nt | t�r| }nt| �}ttj||d�}t � � |�}t� |� t j rQtjdkrQtd|�d�tjd� tt�|�tjd� tdtjd� tt||dddd �S ) N�exec)r � zSource code of zF after instrumentation: ----------------------------------------------)�filez.----------------------------------------------r T)� dont_inherit)� isinstance�ast�Module� Expression� Interactiver. r r, �parser �visit�fix_missing_locationsr �debug_instrumentation�sys� version_info�print�stderr�unparse�compile)r6 r- �tree�sourcer* r* r+ �source_to_code7 s. � � �z TypeguardLoader.source_to_code�moduler �Nonec s< t dt�� t� �|� W d � d S 1 sw Y d S )Nz/importlib._bootstrap_external.cache_from_source)r r3 �super� exec_module)�selfrO �� __class__r* r+ rR [ s �"�zTypeguardLoader.exec_module)r5 )r6 r7 r- r8 r( r )rO r r( rP )�__name__� __module__� __qualname__� staticmethodrN rR � __classcell__r* r* rT r+ r4 6 s �#r4 c @ s2 e Zd ZdZddd�Z dddd�Zddd�ZdS )�TypeguardFindera Wraps another path finder and instruments the module with :func:`@typechecked <typeguard.typechecked>` if :meth:`should_instrument` returns ``True``. Should not be used directly, but rather via :func:`~.install_import_hook`. .. versionadded:: 2.6 �packages�list[str] | None�original_pathfinderr c C s || _ || _d S r) )r\ �_original_pathfinder)rS r\ r^ r* r* r+ �__init__p s zTypeguardFinder.__init__N�fullnamer. r- �Sequence[str] | None�target�types.ModuleType | Noner( �ModuleSpec | Nonec C sJ | � |�r#| j�|||�}|d ur#t|jt�r#t|jj|jj�|_|S d S r) ) �should_instrumentr_ � find_specr= �loaderr r4 �namer- )rS ra r- rc �specr* r* r+ rg t s zTypeguardFinder.find_spec� module_name�boolc C s: | j du rdS | j D ]}||ks|�|d �r dS q dS )z� Determine whether the module with the given name should be instrumented. :param module_name: full name of the module that is about to be imported (e.g. ``xyz.abc``) NTr F)r\ � startswith)rS rk �packager* r* r+ rf � s �z!TypeguardFinder.should_instrument)r\ r] r^ r r) )ra r. r- rb rc rd r( re )rk r. r( rl )rV rW rX �__doc__r` rg rf r* r* r* r+ r[ e s �r[ c @ s8 e Zd ZdZddd�Zddd �Zddd�Zddd�ZdS )�ImportHookManagerzK A handle that can be used to uninstall the Typeguard import hook. �hookr c C s || _ d S r) )rq )rS rq r* r* r+ r` � s zImportHookManager.__init__r( rP c C s d S r) r* �rS r* r* r+ � __enter__� s zImportHookManager.__enter__�exc_type�type[BaseException]�exc_val� BaseException�exc_tbr c C s | � � d S r) )� uninstall)rS rt rv rx r* r* r+ �__exit__� s zImportHookManager.__exit__c C s* z t j�| j� W dS ty Y dS w )zUninstall the import hook.N)rF � meta_path�removerq � ValueErrorrr r* r* r+ ry � s �zImportHookManager.uninstallN)rq r )r( rP )rt ru rv rw rx r r( rP )rV rW rX ro r` rs rz ry r* r* r* r+ rp � s rp )�clsr\ �Iterable[str] | Noner~ �type[TypeguardFinder]c C s| | du rd}n t | t�r| g}nt| �}tjD ]}t|�r)|jdkr)t|d�r) nqtd��|||�}tj� d|� t |�S )a� Install an import hook that instruments functions for automatic type checking. This only affects modules loaded **after** this hook has been installed. :param packages: an iterable of package names to instrument, or ``None`` to instrument all packages :param cls: a custom meta path finder class :return: a context manager that uninstalls the hook on exit (or when you call ``.uninstall()``) .. versionadded:: 2.6 N� PathFinderrg z)Cannot find a PathFinder in sys.meta_pathr ) r= r. �listrF r{ r rV �hasattr� RuntimeError�insertrp )r\ r~ �target_packages�finderrq r* r* r+ �install_import_hook� s" � �� r� )r" r# r$ r% r& r' r( r! r) )r- r. r/ r0 r( r. )r\ r r~ r� r( rp )3� __future__r r> rF �types�collections.abcr r � importlib.abcr �importlib.machineryr r �importlib.utilr r �inspectr �osr r r r �typingr r � unittest.mockr �_configr � _transformerr rG r �typing_extensionsr �importlib.metadatar r �importlib_metadata�join�splitr2 r r! r, r3 r4 r[ rp r� r* r* r* r+ �<module> sP $ � // �� _vendor/typeguard/__pycache__/_exceptions.cpython-310.pyc 0000644 00000004160 15030122015 0017423 0 ustar 00 o �ha � @ s\ d dl mZ d dlmZ G dd� de�ZG dd� de�ZG dd� de�ZG d d � d e�Z d S ) � )�deque)�Dequec @ s e Zd ZdZdS )�TypeHintWarningzp A warning that is emitted when a type hint in string form could not be resolved to an actual type. N)�__name__� __module__� __qualname__�__doc__� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/typeguard/_exceptions.pyr s r c �& e Zd ZdZdef� fdd� Z� ZS )�TypeCheckWarningzFEmitted by typeguard's type checkers when a type mismatch is detected.�messagec � t � �|� d S �N��super�__init__��selfr �� __class__r r r � zTypeCheckWarning.__init__�r r r r �strr � __classcell__r r r r r � r c r )�InstrumentationWarningzMEmitted when there's a problem with instrumenting a function for type checks.r c r r r r r r r r r z InstrumentationWarning.__init__r r r r r r r r c sF e Zd ZdZdef� fdd� Zdeddfdd �Zdefd d �Z� ZS ) �TypeCheckErrorzO Raised by typeguard's type checkers when a type mismatch is detected. r c s t � �|� t� | _d S r )r r r �_pathr r r r r s zTypeCheckError.__init__�element�returnNc C s | j �|� d S r )r �append)r r r r r �append_path_element# r z"TypeCheckError.append_path_elementc C s2 | j rd�| j �d t| jd � S t| jd �S )Nz of � r )r �joinr �args)r r r r �__str__& s zTypeCheckError.__str__) r r r r r r r" r& r r r r r r s r N) � collectionsr �typingr � UserWarningr r r � Exceptionr r r r r �<module> s _vendor/typeguard/_union_transformer.py 0000644 00000002512 15030122015 0014454 0 ustar 00 """ Transforms lazily evaluated PEP 604 unions into typing.Unions, for compatibility with Python versions older than 3.10. """ from __future__ import annotations from ast import ( BinOp, BitOr, Index, Load, Name, NodeTransformer, Subscript, fix_missing_locations, parse, ) from ast import Tuple as ASTTuple from types import CodeType from typing import Any, Dict, FrozenSet, List, Set, Tuple, Union type_substitutions = { "dict": Dict, "list": List, "tuple": Tuple, "set": Set, "frozenset": FrozenSet, "Union": Union, } class UnionTransformer(NodeTransformer): def __init__(self, union_name: Name | None = None): self.union_name = union_name or Name(id="Union", ctx=Load()) def visit_BinOp(self, node: BinOp) -> Any: self.generic_visit(node) if isinstance(node.op, BitOr): return Subscript( value=self.union_name, slice=Index( ASTTuple(elts=[node.left, node.right], ctx=Load()), ctx=Load() ), ctx=Load(), ) return node def compile_type_hint(hint: str) -> CodeType: parsed = parse(hint, "<string>", "eval") UnionTransformer().visit(parsed) fix_missing_locations(parsed) return compile(parsed, "<string>", "eval", flags=0) _vendor/typeguard/_checkers.py 0000644 00000075200 15030122015 0012475 0 ustar 00 from __future__ import annotations import collections.abc import inspect import sys import types import typing import warnings from enum import Enum from inspect import Parameter, isclass, isfunction from io import BufferedIOBase, IOBase, RawIOBase, TextIOBase from textwrap import indent from typing import ( IO, AbstractSet, Any, BinaryIO, Callable, Dict, ForwardRef, List, Mapping, MutableMapping, NewType, Optional, Sequence, Set, TextIO, Tuple, Type, TypeVar, Union, ) from unittest.mock import Mock from weakref import WeakKeyDictionary try: import typing_extensions except ImportError: typing_extensions = None # type: ignore[assignment] # Must use this because typing.is_typeddict does not recognize # TypedDict from typing_extensions, and as of version 4.12.0 # typing_extensions.TypedDict is different from typing.TypedDict # on all versions. from typing_extensions import is_typeddict from ._config import ForwardRefPolicy from ._exceptions import TypeCheckError, TypeHintWarning from ._memo import TypeCheckMemo from ._utils import evaluate_forwardref, get_stacklevel, get_type_name, qualified_name if sys.version_info >= (3, 11): from typing import ( Annotated, NotRequired, TypeAlias, get_args, get_origin, ) SubclassableAny = Any else: from typing_extensions import ( Annotated, NotRequired, TypeAlias, get_args, get_origin, ) from typing_extensions import Any as SubclassableAny if sys.version_info >= (3, 10): from importlib.metadata import entry_points from typing import ParamSpec else: from importlib_metadata import entry_points from typing_extensions import ParamSpec TypeCheckerCallable: TypeAlias = Callable[ [Any, Any, Tuple[Any, ...], TypeCheckMemo], Any ] TypeCheckLookupCallback: TypeAlias = Callable[ [Any, Tuple[Any, ...], Tuple[Any, ...]], Optional[TypeCheckerCallable] ] checker_lookup_functions: list[TypeCheckLookupCallback] = [] generic_alias_types: tuple[type, ...] = (type(List), type(List[Any])) if sys.version_info >= (3, 9): generic_alias_types += (types.GenericAlias,) protocol_check_cache: WeakKeyDictionary[ type[Any], dict[type[Any], TypeCheckError | None] ] = WeakKeyDictionary() # Sentinel _missing = object() # Lifted from mypy.sharedparse BINARY_MAGIC_METHODS = { "__add__", "__and__", "__cmp__", "__divmod__", "__div__", "__eq__", "__floordiv__", "__ge__", "__gt__", "__iadd__", "__iand__", "__idiv__", "__ifloordiv__", "__ilshift__", "__imatmul__", "__imod__", "__imul__", "__ior__", "__ipow__", "__irshift__", "__isub__", "__itruediv__", "__ixor__", "__le__", "__lshift__", "__lt__", "__matmul__", "__mod__", "__mul__", "__ne__", "__or__", "__pow__", "__radd__", "__rand__", "__rdiv__", "__rfloordiv__", "__rlshift__", "__rmatmul__", "__rmod__", "__rmul__", "__ror__", "__rpow__", "__rrshift__", "__rshift__", "__rsub__", "__rtruediv__", "__rxor__", "__sub__", "__truediv__", "__xor__", } def check_callable( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not callable(value): raise TypeCheckError("is not callable") if args: try: signature = inspect.signature(value) except (TypeError, ValueError): return argument_types = args[0] if isinstance(argument_types, list) and not any( type(item) is ParamSpec for item in argument_types ): # The callable must not have keyword-only arguments without defaults unfulfilled_kwonlyargs = [ param.name for param in signature.parameters.values() if param.kind == Parameter.KEYWORD_ONLY and param.default == Parameter.empty ] if unfulfilled_kwonlyargs: raise TypeCheckError( f"has mandatory keyword-only arguments in its declaration: " f'{", ".join(unfulfilled_kwonlyargs)}' ) num_positional_args = num_mandatory_pos_args = 0 has_varargs = False for param in signature.parameters.values(): if param.kind in ( Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD, ): num_positional_args += 1 if param.default is Parameter.empty: num_mandatory_pos_args += 1 elif param.kind == Parameter.VAR_POSITIONAL: has_varargs = True if num_mandatory_pos_args > len(argument_types): raise TypeCheckError( f"has too many mandatory positional arguments in its declaration; " f"expected {len(argument_types)} but {num_mandatory_pos_args} " f"mandatory positional argument(s) declared" ) elif not has_varargs and num_positional_args < len(argument_types): raise TypeCheckError( f"has too few arguments in its declaration; expected " f"{len(argument_types)} but {num_positional_args} argument(s) " f"declared" ) def check_mapping( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if origin_type is Dict or origin_type is dict: if not isinstance(value, dict): raise TypeCheckError("is not a dict") if origin_type is MutableMapping or origin_type is collections.abc.MutableMapping: if not isinstance(value, collections.abc.MutableMapping): raise TypeCheckError("is not a mutable mapping") elif not isinstance(value, collections.abc.Mapping): raise TypeCheckError("is not a mapping") if args: key_type, value_type = args if key_type is not Any or value_type is not Any: samples = memo.config.collection_check_strategy.iterate_samples( value.items() ) for k, v in samples: try: check_type_internal(k, key_type, memo) except TypeCheckError as exc: exc.append_path_element(f"key {k!r}") raise try: check_type_internal(v, value_type, memo) except TypeCheckError as exc: exc.append_path_element(f"value of key {k!r}") raise def check_typed_dict( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, dict): raise TypeCheckError("is not a dict") declared_keys = frozenset(origin_type.__annotations__) if hasattr(origin_type, "__required_keys__"): required_keys = set(origin_type.__required_keys__) else: # py3.8 and lower required_keys = set(declared_keys) if origin_type.__total__ else set() existing_keys = set(value) extra_keys = existing_keys - declared_keys if extra_keys: keys_formatted = ", ".join(f'"{key}"' for key in sorted(extra_keys, key=repr)) raise TypeCheckError(f"has unexpected extra key(s): {keys_formatted}") # Detect NotRequired fields which are hidden by get_type_hints() type_hints: dict[str, type] = {} for key, annotation in origin_type.__annotations__.items(): if isinstance(annotation, ForwardRef): annotation = evaluate_forwardref(annotation, memo) if get_origin(annotation) is NotRequired: required_keys.discard(key) annotation = get_args(annotation)[0] type_hints[key] = annotation missing_keys = required_keys - existing_keys if missing_keys: keys_formatted = ", ".join(f'"{key}"' for key in sorted(missing_keys, key=repr)) raise TypeCheckError(f"is missing required key(s): {keys_formatted}") for key, argtype in type_hints.items(): argvalue = value.get(key, _missing) if argvalue is not _missing: try: check_type_internal(argvalue, argtype, memo) except TypeCheckError as exc: exc.append_path_element(f"value of key {key!r}") raise def check_list( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, list): raise TypeCheckError("is not a list") if args and args != (Any,): samples = memo.config.collection_check_strategy.iterate_samples(value) for i, v in enumerate(samples): try: check_type_internal(v, args[0], memo) except TypeCheckError as exc: exc.append_path_element(f"item {i}") raise def check_sequence( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, collections.abc.Sequence): raise TypeCheckError("is not a sequence") if args and args != (Any,): samples = memo.config.collection_check_strategy.iterate_samples(value) for i, v in enumerate(samples): try: check_type_internal(v, args[0], memo) except TypeCheckError as exc: exc.append_path_element(f"item {i}") raise def check_set( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if origin_type is frozenset: if not isinstance(value, frozenset): raise TypeCheckError("is not a frozenset") elif not isinstance(value, AbstractSet): raise TypeCheckError("is not a set") if args and args != (Any,): samples = memo.config.collection_check_strategy.iterate_samples(value) for v in samples: try: check_type_internal(v, args[0], memo) except TypeCheckError as exc: exc.append_path_element(f"[{v}]") raise def check_tuple( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: # Specialized check for NamedTuples if field_types := getattr(origin_type, "__annotations__", None): if not isinstance(value, origin_type): raise TypeCheckError( f"is not a named tuple of type {qualified_name(origin_type)}" ) for name, field_type in field_types.items(): try: check_type_internal(getattr(value, name), field_type, memo) except TypeCheckError as exc: exc.append_path_element(f"attribute {name!r}") raise return elif not isinstance(value, tuple): raise TypeCheckError("is not a tuple") if args: use_ellipsis = args[-1] is Ellipsis tuple_params = args[: -1 if use_ellipsis else None] else: # Unparametrized Tuple or plain tuple return if use_ellipsis: element_type = tuple_params[0] samples = memo.config.collection_check_strategy.iterate_samples(value) for i, element in enumerate(samples): try: check_type_internal(element, element_type, memo) except TypeCheckError as exc: exc.append_path_element(f"item {i}") raise elif tuple_params == ((),): if value != (): raise TypeCheckError("is not an empty tuple") else: if len(value) != len(tuple_params): raise TypeCheckError( f"has wrong number of elements (expected {len(tuple_params)}, got " f"{len(value)} instead)" ) for i, (element, element_type) in enumerate(zip(value, tuple_params)): try: check_type_internal(element, element_type, memo) except TypeCheckError as exc: exc.append_path_element(f"item {i}") raise def check_union( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: errors: dict[str, TypeCheckError] = {} try: for type_ in args: try: check_type_internal(value, type_, memo) return except TypeCheckError as exc: errors[get_type_name(type_)] = exc formatted_errors = indent( "\n".join(f"{key}: {error}" for key, error in errors.items()), " " ) finally: del errors # avoid creating ref cycle raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}") def check_uniontype( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: errors: dict[str, TypeCheckError] = {} for type_ in args: try: check_type_internal(value, type_, memo) return except TypeCheckError as exc: errors[get_type_name(type_)] = exc formatted_errors = indent( "\n".join(f"{key}: {error}" for key, error in errors.items()), " " ) raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}") def check_class( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isclass(value) and not isinstance(value, generic_alias_types): raise TypeCheckError("is not a class") if not args: return if isinstance(args[0], ForwardRef): expected_class = evaluate_forwardref(args[0], memo) else: expected_class = args[0] if expected_class is Any: return elif getattr(expected_class, "_is_protocol", False): check_protocol(value, expected_class, (), memo) elif isinstance(expected_class, TypeVar): check_typevar(value, expected_class, (), memo, subclass_check=True) elif get_origin(expected_class) is Union: errors: dict[str, TypeCheckError] = {} for arg in get_args(expected_class): if arg is Any: return try: check_class(value, type, (arg,), memo) return except TypeCheckError as exc: errors[get_type_name(arg)] = exc else: formatted_errors = indent( "\n".join(f"{key}: {error}" for key, error in errors.items()), " " ) raise TypeCheckError( f"did not match any element in the union:\n{formatted_errors}" ) elif not issubclass(value, expected_class): # type: ignore[arg-type] raise TypeCheckError(f"is not a subclass of {qualified_name(expected_class)}") def check_newtype( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: check_type_internal(value, origin_type.__supertype__, memo) def check_instance( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, origin_type): raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}") def check_typevar( value: Any, origin_type: TypeVar, args: tuple[Any, ...], memo: TypeCheckMemo, *, subclass_check: bool = False, ) -> None: if origin_type.__bound__ is not None: annotation = ( Type[origin_type.__bound__] if subclass_check else origin_type.__bound__ ) check_type_internal(value, annotation, memo) elif origin_type.__constraints__: for constraint in origin_type.__constraints__: annotation = Type[constraint] if subclass_check else constraint try: check_type_internal(value, annotation, memo) except TypeCheckError: pass else: break else: formatted_constraints = ", ".join( get_type_name(constraint) for constraint in origin_type.__constraints__ ) raise TypeCheckError( f"does not match any of the constraints " f"({formatted_constraints})" ) if typing_extensions is None: def _is_literal_type(typ: object) -> bool: return typ is typing.Literal else: def _is_literal_type(typ: object) -> bool: return typ is typing.Literal or typ is typing_extensions.Literal def check_literal( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: def get_literal_args(literal_args: tuple[Any, ...]) -> tuple[Any, ...]: retval: list[Any] = [] for arg in literal_args: if _is_literal_type(get_origin(arg)): retval.extend(get_literal_args(arg.__args__)) elif arg is None or isinstance(arg, (int, str, bytes, bool, Enum)): retval.append(arg) else: raise TypeError( f"Illegal literal value: {arg}" ) # TypeError here is deliberate return tuple(retval) final_args = tuple(get_literal_args(args)) try: index = final_args.index(value) except ValueError: pass else: if type(final_args[index]) is type(value): return formatted_args = ", ".join(repr(arg) for arg in final_args) raise TypeCheckError(f"is not any of ({formatted_args})") from None def check_literal_string( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: check_type_internal(value, str, memo) def check_typeguard( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: check_type_internal(value, bool, memo) def check_none( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if value is not None: raise TypeCheckError("is not None") def check_number( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if origin_type is complex and not isinstance(value, (complex, float, int)): raise TypeCheckError("is neither complex, float or int") elif origin_type is float and not isinstance(value, (float, int)): raise TypeCheckError("is neither float or int") def check_io( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if origin_type is TextIO or (origin_type is IO and args == (str,)): if not isinstance(value, TextIOBase): raise TypeCheckError("is not a text based I/O object") elif origin_type is BinaryIO or (origin_type is IO and args == (bytes,)): if not isinstance(value, (RawIOBase, BufferedIOBase)): raise TypeCheckError("is not a binary I/O object") elif not isinstance(value, IOBase): raise TypeCheckError("is not an I/O object") def check_protocol( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: subject: type[Any] = value if isclass(value) else type(value) if subject in protocol_check_cache: result_map = protocol_check_cache[subject] if origin_type in result_map: if exc := result_map[origin_type]: raise exc else: return # Collect a set of methods and non-method attributes present in the protocol ignored_attrs = set(dir(typing.Protocol)) | { "__annotations__", "__non_callable_proto_members__", } expected_methods: dict[str, tuple[Any, Any]] = {} expected_noncallable_members: dict[str, Any] = {} for attrname in dir(origin_type): # Skip attributes present in typing.Protocol if attrname in ignored_attrs: continue member = getattr(origin_type, attrname) if callable(member): signature = inspect.signature(member) argtypes = [ (p.annotation if p.annotation is not Parameter.empty else Any) for p in signature.parameters.values() if p.kind is not Parameter.KEYWORD_ONLY ] or Ellipsis return_annotation = ( signature.return_annotation if signature.return_annotation is not Parameter.empty else Any ) expected_methods[attrname] = argtypes, return_annotation else: expected_noncallable_members[attrname] = member for attrname, annotation in typing.get_type_hints(origin_type).items(): expected_noncallable_members[attrname] = annotation subject_annotations = typing.get_type_hints(subject) # Check that all required methods are present and their signatures are compatible result_map = protocol_check_cache.setdefault(subject, {}) try: for attrname, callable_args in expected_methods.items(): try: method = getattr(subject, attrname) except AttributeError: if attrname in subject_annotations: raise TypeCheckError( f"is not compatible with the {origin_type.__qualname__} protocol " f"because its {attrname!r} attribute is not a method" ) from None else: raise TypeCheckError( f"is not compatible with the {origin_type.__qualname__} protocol " f"because it has no method named {attrname!r}" ) from None if not callable(method): raise TypeCheckError( f"is not compatible with the {origin_type.__qualname__} protocol " f"because its {attrname!r} attribute is not a callable" ) # TODO: raise exception on added keyword-only arguments without defaults try: check_callable(method, Callable, callable_args, memo) except TypeCheckError as exc: raise TypeCheckError( f"is not compatible with the {origin_type.__qualname__} protocol " f"because its {attrname!r} method {exc}" ) from None # Check that all required non-callable members are present for attrname in expected_noncallable_members: # TODO: implement assignability checks for non-callable members if attrname not in subject_annotations and not hasattr(subject, attrname): raise TypeCheckError( f"is not compatible with the {origin_type.__qualname__} protocol " f"because it has no attribute named {attrname!r}" ) except TypeCheckError as exc: result_map[origin_type] = exc raise else: result_map[origin_type] = None def check_byteslike( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, (bytearray, bytes, memoryview)): raise TypeCheckError("is not bytes-like") def check_self( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if memo.self_type is None: raise TypeCheckError("cannot be checked against Self outside of a method call") if isclass(value): if not issubclass(value, memo.self_type): raise TypeCheckError( f"is not an instance of the self type " f"({qualified_name(memo.self_type)})" ) elif not isinstance(value, memo.self_type): raise TypeCheckError( f"is not an instance of the self type ({qualified_name(memo.self_type)})" ) def check_paramspec( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: pass # No-op for now def check_instanceof( value: Any, origin_type: Any, args: tuple[Any, ...], memo: TypeCheckMemo, ) -> None: if not isinstance(value, origin_type): raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}") def check_type_internal( value: Any, annotation: Any, memo: TypeCheckMemo, ) -> None: """ Check that the given object is compatible with the given type annotation. This function should only be used by type checker callables. Applications should use :func:`~.check_type` instead. :param value: the value to check :param annotation: the type annotation to check against :param memo: a memo object containing configuration and information necessary for looking up forward references """ if isinstance(annotation, ForwardRef): try: annotation = evaluate_forwardref(annotation, memo) except NameError: if memo.config.forward_ref_policy is ForwardRefPolicy.ERROR: raise elif memo.config.forward_ref_policy is ForwardRefPolicy.WARN: warnings.warn( f"Cannot resolve forward reference {annotation.__forward_arg__!r}", TypeHintWarning, stacklevel=get_stacklevel(), ) return if annotation is Any or annotation is SubclassableAny or isinstance(value, Mock): return # Skip type checks if value is an instance of a class that inherits from Any if not isclass(value) and SubclassableAny in type(value).__bases__: return extras: tuple[Any, ...] origin_type = get_origin(annotation) if origin_type is Annotated: annotation, *extras_ = get_args(annotation) extras = tuple(extras_) origin_type = get_origin(annotation) else: extras = () if origin_type is not None: args = get_args(annotation) # Compatibility hack to distinguish between unparametrized and empty tuple # (tuple[()]), necessary due to https://github.com/python/cpython/issues/91137 if origin_type in (tuple, Tuple) and annotation is not Tuple and not args: args = ((),) else: origin_type = annotation args = () for lookup_func in checker_lookup_functions: checker = lookup_func(origin_type, args, extras) if checker: checker(value, origin_type, args, memo) return if isclass(origin_type): if not isinstance(value, origin_type): raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}") elif type(origin_type) is str: # noqa: E721 warnings.warn( f"Skipping type check against {origin_type!r}; this looks like a " f"string-form forward reference imported from another module", TypeHintWarning, stacklevel=get_stacklevel(), ) # Equality checks are applied to these origin_type_checkers = { bytes: check_byteslike, AbstractSet: check_set, BinaryIO: check_io, Callable: check_callable, collections.abc.Callable: check_callable, complex: check_number, dict: check_mapping, Dict: check_mapping, float: check_number, frozenset: check_set, IO: check_io, list: check_list, List: check_list, typing.Literal: check_literal, Mapping: check_mapping, MutableMapping: check_mapping, None: check_none, collections.abc.Mapping: check_mapping, collections.abc.MutableMapping: check_mapping, Sequence: check_sequence, collections.abc.Sequence: check_sequence, collections.abc.Set: check_set, set: check_set, Set: check_set, TextIO: check_io, tuple: check_tuple, Tuple: check_tuple, type: check_class, Type: check_class, Union: check_union, } if sys.version_info >= (3, 10): origin_type_checkers[types.UnionType] = check_uniontype origin_type_checkers[typing.TypeGuard] = check_typeguard if sys.version_info >= (3, 11): origin_type_checkers.update( {typing.LiteralString: check_literal_string, typing.Self: check_self} ) if typing_extensions is not None: # On some Python versions, these may simply be re-exports from typing, # but exactly which Python versions is subject to change, # so it's best to err on the safe side # and update the dictionary on all Python versions # if typing_extensions is installed origin_type_checkers[typing_extensions.Literal] = check_literal origin_type_checkers[typing_extensions.LiteralString] = check_literal_string origin_type_checkers[typing_extensions.Self] = check_self origin_type_checkers[typing_extensions.TypeGuard] = check_typeguard def builtin_checker_lookup( origin_type: Any, args: tuple[Any, ...], extras: tuple[Any, ...] ) -> TypeCheckerCallable | None: checker = origin_type_checkers.get(origin_type) if checker is not None: return checker elif is_typeddict(origin_type): return check_typed_dict elif isclass(origin_type) and issubclass( origin_type, Tuple, # type: ignore[arg-type] ): # NamedTuple return check_tuple elif getattr(origin_type, "_is_protocol", False): return check_protocol elif isinstance(origin_type, ParamSpec): return check_paramspec elif isinstance(origin_type, TypeVar): return check_typevar elif origin_type.__class__ is NewType: # typing.NewType on Python 3.10+ return check_newtype elif ( isfunction(origin_type) and getattr(origin_type, "__module__", None) == "typing" and getattr(origin_type, "__qualname__", "").startswith("NewType.") and hasattr(origin_type, "__supertype__") ): # typing.NewType on Python 3.9 and below return check_newtype return None checker_lookup_functions.append(builtin_checker_lookup) def load_plugins() -> None: """ Load all type checker lookup functions from entry points. All entry points from the ``typeguard.checker_lookup`` group are loaded, and the returned lookup functions are added to :data:`typeguard.checker_lookup_functions`. .. note:: This function is called implicitly on import, unless the ``TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD`` environment variable is present. """ for ep in entry_points(group="typeguard.checker_lookup"): try: plugin = ep.load() except Exception as exc: warnings.warn( f"Failed to load plugin {ep.name!r}: " f"{qualified_name(exc)}: {exc}", stacklevel=2, ) continue if not callable(plugin): warnings.warn( f"Plugin {ep} returned a non-callable object: {plugin!r}", stacklevel=2 ) continue checker_lookup_functions.insert(0, plugin) _vendor/typeguard/_utils.py 0000644 00000012226 15030122015 0012045 0 ustar 00 from __future__ import annotations import inspect import sys from importlib import import_module from inspect import currentframe from types import CodeType, FrameType, FunctionType from typing import TYPE_CHECKING, Any, Callable, ForwardRef, Union, cast, final from weakref import WeakValueDictionary if TYPE_CHECKING: from ._memo import TypeCheckMemo if sys.version_info >= (3, 13): from typing import get_args, get_origin def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any: return forwardref._evaluate( memo.globals, memo.locals, type_params=(), recursive_guard=frozenset() ) elif sys.version_info >= (3, 10): from typing import get_args, get_origin def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any: return forwardref._evaluate( memo.globals, memo.locals, recursive_guard=frozenset() ) else: from typing_extensions import get_args, get_origin evaluate_extra_args: tuple[frozenset[Any], ...] = ( (frozenset(),) if sys.version_info >= (3, 9) else () ) def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any: from ._union_transformer import compile_type_hint, type_substitutions if not forwardref.__forward_evaluated__: forwardref.__forward_code__ = compile_type_hint(forwardref.__forward_arg__) try: return forwardref._evaluate(memo.globals, memo.locals, *evaluate_extra_args) except NameError: if sys.version_info < (3, 10): # Try again, with the type substitutions (list -> List etc.) in place new_globals = memo.globals.copy() new_globals.setdefault("Union", Union) if sys.version_info < (3, 9): new_globals.update(type_substitutions) return forwardref._evaluate( new_globals, memo.locals or new_globals, *evaluate_extra_args ) raise _functions_map: WeakValueDictionary[CodeType, FunctionType] = WeakValueDictionary() def get_type_name(type_: Any) -> str: name: str for attrname in "__name__", "_name", "__forward_arg__": candidate = getattr(type_, attrname, None) if isinstance(candidate, str): name = candidate break else: origin = get_origin(type_) candidate = getattr(origin, "_name", None) if candidate is None: candidate = type_.__class__.__name__.strip("_") if isinstance(candidate, str): name = candidate else: return "(unknown)" args = get_args(type_) if args: if name == "Literal": formatted_args = ", ".join(repr(arg) for arg in args) else: formatted_args = ", ".join(get_type_name(arg) for arg in args) name += f"[{formatted_args}]" module = getattr(type_, "__module__", None) if module and module not in (None, "typing", "typing_extensions", "builtins"): name = module + "." + name return name def qualified_name(obj: Any, *, add_class_prefix: bool = False) -> str: """ Return the qualified name (e.g. package.module.Type) for the given object. Builtins and types from the :mod:`typing` package get special treatment by having the module name stripped from the generated name. """ if obj is None: return "None" elif inspect.isclass(obj): prefix = "class " if add_class_prefix else "" type_ = obj else: prefix = "" type_ = type(obj) module = type_.__module__ qualname = type_.__qualname__ name = qualname if module in ("typing", "builtins") else f"{module}.{qualname}" return prefix + name def function_name(func: Callable[..., Any]) -> str: """ Return the qualified name of the given function. Builtins and types from the :mod:`typing` package get special treatment by having the module name stripped from the generated name. """ # For partial functions and objects with __call__ defined, __qualname__ does not # exist module = getattr(func, "__module__", "") qualname = (module + ".") if module not in ("builtins", "") else "" return qualname + getattr(func, "__qualname__", repr(func)) def resolve_reference(reference: str) -> Any: modulename, varname = reference.partition(":")[::2] if not modulename or not varname: raise ValueError(f"{reference!r} is not a module:varname reference") obj = import_module(modulename) for attr in varname.split("."): obj = getattr(obj, attr) return obj def is_method_of(obj: object, cls: type) -> bool: return ( inspect.isfunction(obj) and obj.__module__ == cls.__module__ and obj.__qualname__.startswith(cls.__qualname__ + ".") ) def get_stacklevel() -> int: level = 1 frame = cast(FrameType, currentframe()).f_back while frame and frame.f_globals.get("__name__", "").startswith("typeguard."): level += 1 frame = frame.f_back return level @final class Unset: __slots__ = () def __repr__(self) -> str: return "<unset>" unset = Unset() _vendor/typeguard/py.typed 0000644 00000000000 15030122015 0011656 0 ustar 00 _vendor/typeguard/_exceptions.py 0000644 00000002141 15030122015 0013061 0 ustar 00 from collections import deque from typing import Deque class TypeHintWarning(UserWarning): """ A warning that is emitted when a type hint in string form could not be resolved to an actual type. """ class TypeCheckWarning(UserWarning): """Emitted by typeguard's type checkers when a type mismatch is detected.""" def __init__(self, message: str): super().__init__(message) class InstrumentationWarning(UserWarning): """Emitted when there's a problem with instrumenting a function for type checks.""" def __init__(self, message: str): super().__init__(message) class TypeCheckError(Exception): """ Raised by typeguard's type checkers when a type mismatch is detected. """ def __init__(self, message: str): super().__init__(message) self._path: Deque[str] = deque() def append_path_element(self, element: str) -> None: self._path.append(element) def __str__(self) -> str: if self._path: return " of ".join(self._path) + " " + str(self.args[0]) else: return str(self.args[0]) _vendor/typeguard/_functions.py 0000644 00000024231 15030122015 0012714 0 ustar 00 from __future__ import annotations import sys import warnings from typing import Any, Callable, NoReturn, TypeVar, Union, overload from . import _suppression from ._checkers import BINARY_MAGIC_METHODS, check_type_internal from ._config import ( CollectionCheckStrategy, ForwardRefPolicy, TypeCheckConfiguration, ) from ._exceptions import TypeCheckError, TypeCheckWarning from ._memo import TypeCheckMemo from ._utils import get_stacklevel, qualified_name if sys.version_info >= (3, 11): from typing import Literal, Never, TypeAlias else: from typing_extensions import Literal, Never, TypeAlias T = TypeVar("T") TypeCheckFailCallback: TypeAlias = Callable[[TypeCheckError, TypeCheckMemo], Any] @overload def check_type( value: object, expected_type: type[T], *, forward_ref_policy: ForwardRefPolicy = ..., typecheck_fail_callback: TypeCheckFailCallback | None = ..., collection_check_strategy: CollectionCheckStrategy = ..., ) -> T: ... @overload def check_type( value: object, expected_type: Any, *, forward_ref_policy: ForwardRefPolicy = ..., typecheck_fail_callback: TypeCheckFailCallback | None = ..., collection_check_strategy: CollectionCheckStrategy = ..., ) -> Any: ... def check_type( value: object, expected_type: Any, *, forward_ref_policy: ForwardRefPolicy = TypeCheckConfiguration().forward_ref_policy, typecheck_fail_callback: TypeCheckFailCallback | None = ( TypeCheckConfiguration().typecheck_fail_callback ), collection_check_strategy: CollectionCheckStrategy = ( TypeCheckConfiguration().collection_check_strategy ), ) -> Any: """ Ensure that ``value`` matches ``expected_type``. The types from the :mod:`typing` module do not support :func:`isinstance` or :func:`issubclass` so a number of type specific checks are required. This function knows which checker to call for which type. This function wraps :func:`~.check_type_internal` in the following ways: * Respects type checking suppression (:func:`~.suppress_type_checks`) * Forms a :class:`~.TypeCheckMemo` from the current stack frame * Calls the configured type check fail callback if the check fails Note that this function is independent of the globally shared configuration in :data:`typeguard.config`. This means that usage within libraries is safe from being affected configuration changes made by other libraries or by the integrating application. Instead, configuration options have the same default values as their corresponding fields in :class:`TypeCheckConfiguration`. :param value: value to be checked against ``expected_type`` :param expected_type: a class or generic type instance, or a tuple of such things :param forward_ref_policy: see :attr:`TypeCheckConfiguration.forward_ref_policy` :param typecheck_fail_callback: see :attr`TypeCheckConfiguration.typecheck_fail_callback` :param collection_check_strategy: see :attr:`TypeCheckConfiguration.collection_check_strategy` :return: ``value``, unmodified :raises TypeCheckError: if there is a type mismatch """ if type(expected_type) is tuple: expected_type = Union[expected_type] config = TypeCheckConfiguration( forward_ref_policy=forward_ref_policy, typecheck_fail_callback=typecheck_fail_callback, collection_check_strategy=collection_check_strategy, ) if _suppression.type_checks_suppressed or expected_type is Any: return value frame = sys._getframe(1) memo = TypeCheckMemo(frame.f_globals, frame.f_locals, config=config) try: check_type_internal(value, expected_type, memo) except TypeCheckError as exc: exc.append_path_element(qualified_name(value, add_class_prefix=True)) if config.typecheck_fail_callback: config.typecheck_fail_callback(exc, memo) else: raise return value def check_argument_types( func_name: str, arguments: dict[str, tuple[Any, Any]], memo: TypeCheckMemo, ) -> Literal[True]: if _suppression.type_checks_suppressed: return True for argname, (value, annotation) in arguments.items(): if annotation is NoReturn or annotation is Never: exc = TypeCheckError( f"{func_name}() was declared never to be called but it was" ) if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise exc try: check_type_internal(value, annotation, memo) except TypeCheckError as exc: qualname = qualified_name(value, add_class_prefix=True) exc.append_path_element(f'argument "{argname}" ({qualname})') if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return True def check_return_type( func_name: str, retval: T, annotation: Any, memo: TypeCheckMemo, ) -> T: if _suppression.type_checks_suppressed: return retval if annotation is NoReturn or annotation is Never: exc = TypeCheckError(f"{func_name}() was declared never to return but it did") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise exc try: check_type_internal(retval, annotation, memo) except TypeCheckError as exc: # Allow NotImplemented if this is a binary magic method (__eq__() et al) if retval is NotImplemented and annotation is bool: # This does (and cannot) not check if it's actually a method func_name = func_name.rsplit(".", 1)[-1] if func_name in BINARY_MAGIC_METHODS: return retval qualname = qualified_name(retval, add_class_prefix=True) exc.append_path_element(f"the return value ({qualname})") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return retval def check_send_type( func_name: str, sendval: T, annotation: Any, memo: TypeCheckMemo, ) -> T: if _suppression.type_checks_suppressed: return sendval if annotation is NoReturn or annotation is Never: exc = TypeCheckError( f"{func_name}() was declared never to be sent a value to but it was" ) if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise exc try: check_type_internal(sendval, annotation, memo) except TypeCheckError as exc: qualname = qualified_name(sendval, add_class_prefix=True) exc.append_path_element(f"the value sent to generator ({qualname})") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return sendval def check_yield_type( func_name: str, yieldval: T, annotation: Any, memo: TypeCheckMemo, ) -> T: if _suppression.type_checks_suppressed: return yieldval if annotation is NoReturn or annotation is Never: exc = TypeCheckError(f"{func_name}() was declared never to yield but it did") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise exc try: check_type_internal(yieldval, annotation, memo) except TypeCheckError as exc: qualname = qualified_name(yieldval, add_class_prefix=True) exc.append_path_element(f"the yielded value ({qualname})") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return yieldval def check_variable_assignment( value: object, varname: str, annotation: Any, memo: TypeCheckMemo ) -> Any: if _suppression.type_checks_suppressed: return value try: check_type_internal(value, annotation, memo) except TypeCheckError as exc: qualname = qualified_name(value, add_class_prefix=True) exc.append_path_element(f"value assigned to {varname} ({qualname})") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return value def check_multi_variable_assignment( value: Any, targets: list[dict[str, Any]], memo: TypeCheckMemo ) -> Any: if max(len(target) for target in targets) == 1: iterated_values = [value] else: iterated_values = list(value) if not _suppression.type_checks_suppressed: for expected_types in targets: value_index = 0 for ann_index, (varname, expected_type) in enumerate( expected_types.items() ): if varname.startswith("*"): varname = varname[1:] keys_left = len(expected_types) - 1 - ann_index next_value_index = len(iterated_values) - keys_left obj: object = iterated_values[value_index:next_value_index] value_index = next_value_index else: obj = iterated_values[value_index] value_index += 1 try: check_type_internal(obj, expected_type, memo) except TypeCheckError as exc: qualname = qualified_name(obj, add_class_prefix=True) exc.append_path_element(f"value assigned to {varname} ({qualname})") if memo.config.typecheck_fail_callback: memo.config.typecheck_fail_callback(exc, memo) else: raise return iterated_values[0] if len(iterated_values) == 1 else iterated_values def warn_on_error(exc: TypeCheckError, memo: TypeCheckMemo) -> None: """ Emit a warning on a type mismatch. This is intended to be used as an error handler in :attr:`TypeCheckConfiguration.typecheck_fail_callback`. """ warnings.warn(TypeCheckWarning(str(exc)), stacklevel=get_stacklevel()) _vendor/typeguard/_importhook.py 0000644 00000014365 15030122015 0013106 0 ustar 00 from __future__ import annotations import ast import sys import types from collections.abc import Callable, Iterable from importlib.abc import MetaPathFinder from importlib.machinery import ModuleSpec, SourceFileLoader from importlib.util import cache_from_source, decode_source from inspect import isclass from os import PathLike from types import CodeType, ModuleType, TracebackType from typing import Sequence, TypeVar from unittest.mock import patch from ._config import global_config from ._transformer import TypeguardTransformer if sys.version_info >= (3, 12): from collections.abc import Buffer else: from typing_extensions import Buffer if sys.version_info >= (3, 11): from typing import ParamSpec else: from typing_extensions import ParamSpec if sys.version_info >= (3, 10): from importlib.metadata import PackageNotFoundError, version else: from importlib_metadata import PackageNotFoundError, version try: OPTIMIZATION = "typeguard" + "".join(version("typeguard").split(".")[:3]) except PackageNotFoundError: OPTIMIZATION = "typeguard" P = ParamSpec("P") T = TypeVar("T") # The name of this function is magical def _call_with_frames_removed( f: Callable[P, T], *args: P.args, **kwargs: P.kwargs ) -> T: return f(*args, **kwargs) def optimized_cache_from_source(path: str, debug_override: bool | None = None) -> str: return cache_from_source(path, debug_override, optimization=OPTIMIZATION) class TypeguardLoader(SourceFileLoader): @staticmethod def source_to_code( data: Buffer | str | ast.Module | ast.Expression | ast.Interactive, path: Buffer | str | PathLike[str] = "<string>", ) -> CodeType: if isinstance(data, (ast.Module, ast.Expression, ast.Interactive)): tree = data else: if isinstance(data, str): source = data else: source = decode_source(data) tree = _call_with_frames_removed( ast.parse, source, path, "exec", ) tree = TypeguardTransformer().visit(tree) ast.fix_missing_locations(tree) if global_config.debug_instrumentation and sys.version_info >= (3, 9): print( f"Source code of {path!r} after instrumentation:\n" "----------------------------------------------", file=sys.stderr, ) print(ast.unparse(tree), file=sys.stderr) print("----------------------------------------------", file=sys.stderr) return _call_with_frames_removed( compile, tree, path, "exec", 0, dont_inherit=True ) def exec_module(self, module: ModuleType) -> None: # Use a custom optimization marker – the import lock should make this monkey # patch safe with patch( "importlib._bootstrap_external.cache_from_source", optimized_cache_from_source, ): super().exec_module(module) class TypeguardFinder(MetaPathFinder): """ Wraps another path finder and instruments the module with :func:`@typechecked <typeguard.typechecked>` if :meth:`should_instrument` returns ``True``. Should not be used directly, but rather via :func:`~.install_import_hook`. .. versionadded:: 2.6 """ def __init__(self, packages: list[str] | None, original_pathfinder: MetaPathFinder): self.packages = packages self._original_pathfinder = original_pathfinder def find_spec( self, fullname: str, path: Sequence[str] | None, target: types.ModuleType | None = None, ) -> ModuleSpec | None: if self.should_instrument(fullname): spec = self._original_pathfinder.find_spec(fullname, path, target) if spec is not None and isinstance(spec.loader, SourceFileLoader): spec.loader = TypeguardLoader(spec.loader.name, spec.loader.path) return spec return None def should_instrument(self, module_name: str) -> bool: """ Determine whether the module with the given name should be instrumented. :param module_name: full name of the module that is about to be imported (e.g. ``xyz.abc``) """ if self.packages is None: return True for package in self.packages: if module_name == package or module_name.startswith(package + "."): return True return False class ImportHookManager: """ A handle that can be used to uninstall the Typeguard import hook. """ def __init__(self, hook: MetaPathFinder): self.hook = hook def __enter__(self) -> None: pass def __exit__( self, exc_type: type[BaseException], exc_val: BaseException, exc_tb: TracebackType, ) -> None: self.uninstall() def uninstall(self) -> None: """Uninstall the import hook.""" try: sys.meta_path.remove(self.hook) except ValueError: pass # already removed def install_import_hook( packages: Iterable[str] | None = None, *, cls: type[TypeguardFinder] = TypeguardFinder, ) -> ImportHookManager: """ Install an import hook that instruments functions for automatic type checking. This only affects modules loaded **after** this hook has been installed. :param packages: an iterable of package names to instrument, or ``None`` to instrument all packages :param cls: a custom meta path finder class :return: a context manager that uninstalls the hook on exit (or when you call ``.uninstall()``) .. versionadded:: 2.6 """ if packages is None: target_packages: list[str] | None = None elif isinstance(packages, str): target_packages = [packages] else: target_packages = list(packages) for finder in sys.meta_path: if ( isclass(finder) and finder.__name__ == "PathFinder" and hasattr(finder, "find_spec") ): break else: raise RuntimeError("Cannot find a PathFinder in sys.meta_path") hook = cls(target_packages, finder) sys.meta_path.insert(0, hook) return ImportHookManager(hook) _vendor/typeguard/_decorators.py 0000644 00000021511 15030122015 0013047 0 ustar 00 from __future__ import annotations import ast import inspect import sys from collections.abc import Sequence from functools import partial from inspect import isclass, isfunction from types import CodeType, FrameType, FunctionType from typing import TYPE_CHECKING, Any, Callable, ForwardRef, TypeVar, cast, overload from warnings import warn from ._config import CollectionCheckStrategy, ForwardRefPolicy, global_config from ._exceptions import InstrumentationWarning from ._functions import TypeCheckFailCallback from ._transformer import TypeguardTransformer from ._utils import Unset, function_name, get_stacklevel, is_method_of, unset if TYPE_CHECKING: from typeshed.stdlib.types import _Cell _F = TypeVar("_F") def typeguard_ignore(f: _F) -> _F: """This decorator is a noop during static type-checking.""" return f else: from typing import no_type_check as typeguard_ignore # noqa: F401 T_CallableOrType = TypeVar("T_CallableOrType", bound=Callable[..., Any]) def make_cell(value: object) -> _Cell: return (lambda: value).__closure__[0] # type: ignore[index] def find_target_function( new_code: CodeType, target_path: Sequence[str], firstlineno: int ) -> CodeType | None: target_name = target_path[0] for const in new_code.co_consts: if isinstance(const, CodeType): if const.co_name == target_name: if const.co_firstlineno == firstlineno: return const elif len(target_path) > 1: target_code = find_target_function( const, target_path[1:], firstlineno ) if target_code: return target_code return None def instrument(f: T_CallableOrType) -> FunctionType | str: if not getattr(f, "__code__", None): return "no code associated" elif not getattr(f, "__module__", None): return "__module__ attribute is not set" elif f.__code__.co_filename == "<stdin>": return "cannot instrument functions defined in a REPL" elif hasattr(f, "__wrapped__"): return ( "@typechecked only supports instrumenting functions wrapped with " "@classmethod, @staticmethod or @property" ) target_path = [item for item in f.__qualname__.split(".") if item != "<locals>"] module_source = inspect.getsource(sys.modules[f.__module__]) module_ast = ast.parse(module_source) instrumentor = TypeguardTransformer(target_path, f.__code__.co_firstlineno) instrumentor.visit(module_ast) if not instrumentor.target_node or instrumentor.target_lineno is None: return "instrumentor did not find the target function" module_code = compile(module_ast, f.__code__.co_filename, "exec", dont_inherit=True) new_code = find_target_function( module_code, target_path, instrumentor.target_lineno ) if not new_code: return "cannot find the target function in the AST" if global_config.debug_instrumentation and sys.version_info >= (3, 9): # Find the matching AST node, then unparse it to source and print to stdout print( f"Source code of {f.__qualname__}() after instrumentation:" "\n----------------------------------------------", file=sys.stderr, ) print(ast.unparse(instrumentor.target_node), file=sys.stderr) print( "----------------------------------------------", file=sys.stderr, ) closure = f.__closure__ if new_code.co_freevars != f.__code__.co_freevars: # Create a new closure and find values for the new free variables frame = cast(FrameType, inspect.currentframe()) frame = cast(FrameType, frame.f_back) frame_locals = cast(FrameType, frame.f_back).f_locals cells: list[_Cell] = [] for key in new_code.co_freevars: if key in instrumentor.names_used_in_annotations: # Find the value and make a new cell from it value = frame_locals.get(key) or ForwardRef(key) cells.append(make_cell(value)) else: # Reuse the cell from the existing closure assert f.__closure__ cells.append(f.__closure__[f.__code__.co_freevars.index(key)]) closure = tuple(cells) new_function = FunctionType(new_code, f.__globals__, f.__name__, closure=closure) new_function.__module__ = f.__module__ new_function.__name__ = f.__name__ new_function.__qualname__ = f.__qualname__ new_function.__annotations__ = f.__annotations__ new_function.__doc__ = f.__doc__ new_function.__defaults__ = f.__defaults__ new_function.__kwdefaults__ = f.__kwdefaults__ return new_function @overload def typechecked( *, forward_ref_policy: ForwardRefPolicy | Unset = unset, typecheck_fail_callback: TypeCheckFailCallback | Unset = unset, collection_check_strategy: CollectionCheckStrategy | Unset = unset, debug_instrumentation: bool | Unset = unset, ) -> Callable[[T_CallableOrType], T_CallableOrType]: ... @overload def typechecked(target: T_CallableOrType) -> T_CallableOrType: ... def typechecked( target: T_CallableOrType | None = None, *, forward_ref_policy: ForwardRefPolicy | Unset = unset, typecheck_fail_callback: TypeCheckFailCallback | Unset = unset, collection_check_strategy: CollectionCheckStrategy | Unset = unset, debug_instrumentation: bool | Unset = unset, ) -> Any: """ Instrument the target function to perform run-time type checking. This decorator recompiles the target function, injecting code to type check arguments, return values, yield values (excluding ``yield from``) and assignments to annotated local variables. This can also be used as a class decorator. This will instrument all type annotated methods, including :func:`@classmethod <classmethod>`, :func:`@staticmethod <staticmethod>`, and :class:`@property <property>` decorated methods in the class. .. note:: When Python is run in optimized mode (``-O`` or ``-OO``, this decorator is a no-op). This is a feature meant for selectively introducing type checking into a code base where the checks aren't meant to be run in production. :param target: the function or class to enable type checking for :param forward_ref_policy: override for :attr:`.TypeCheckConfiguration.forward_ref_policy` :param typecheck_fail_callback: override for :attr:`.TypeCheckConfiguration.typecheck_fail_callback` :param collection_check_strategy: override for :attr:`.TypeCheckConfiguration.collection_check_strategy` :param debug_instrumentation: override for :attr:`.TypeCheckConfiguration.debug_instrumentation` """ if target is None: return partial( typechecked, forward_ref_policy=forward_ref_policy, typecheck_fail_callback=typecheck_fail_callback, collection_check_strategy=collection_check_strategy, debug_instrumentation=debug_instrumentation, ) if not __debug__: return target if isclass(target): for key, attr in target.__dict__.items(): if is_method_of(attr, target): retval = instrument(attr) if isfunction(retval): setattr(target, key, retval) elif isinstance(attr, (classmethod, staticmethod)): if is_method_of(attr.__func__, target): retval = instrument(attr.__func__) if isfunction(retval): wrapper = attr.__class__(retval) setattr(target, key, wrapper) elif isinstance(attr, property): kwargs: dict[str, Any] = dict(doc=attr.__doc__) for name in ("fset", "fget", "fdel"): property_func = kwargs[name] = getattr(attr, name) if is_method_of(property_func, target): retval = instrument(property_func) if isfunction(retval): kwargs[name] = retval setattr(target, key, attr.__class__(**kwargs)) return target # Find either the first Python wrapper or the actual function wrapper_class: ( type[classmethod[Any, Any, Any]] | type[staticmethod[Any, Any]] | None ) = None if isinstance(target, (classmethod, staticmethod)): wrapper_class = target.__class__ target = target.__func__ retval = instrument(target) if isinstance(retval, str): warn( f"{retval} -- not typechecking {function_name(target)}", InstrumentationWarning, stacklevel=get_stacklevel(), ) return target if wrapper_class is None: return retval else: return wrapper_class(retval) _vendor/typeguard/_suppression.py 0000644 00000004332 15030122015 0013276 0 ustar 00 from __future__ import annotations import sys from collections.abc import Callable, Generator from contextlib import contextmanager from functools import update_wrapper from threading import Lock from typing import ContextManager, TypeVar, overload if sys.version_info >= (3, 10): from typing import ParamSpec else: from typing_extensions import ParamSpec P = ParamSpec("P") T = TypeVar("T") type_checks_suppressed = 0 type_checks_suppress_lock = Lock() @overload def suppress_type_checks(func: Callable[P, T]) -> Callable[P, T]: ... @overload def suppress_type_checks() -> ContextManager[None]: ... def suppress_type_checks( func: Callable[P, T] | None = None, ) -> Callable[P, T] | ContextManager[None]: """ Temporarily suppress all type checking. This function has two operating modes, based on how it's used: #. as a context manager (``with suppress_type_checks(): ...``) #. as a decorator (``@suppress_type_checks``) When used as a context manager, :func:`check_type` and any automatically instrumented functions skip the actual type checking. These context managers can be nested. When used as a decorator, all type checking is suppressed while the function is running. Type checking will resume once no more context managers are active and no decorated functions are running. Both operating modes are thread-safe. """ def wrapper(*args: P.args, **kwargs: P.kwargs) -> T: global type_checks_suppressed with type_checks_suppress_lock: type_checks_suppressed += 1 assert func is not None try: return func(*args, **kwargs) finally: with type_checks_suppress_lock: type_checks_suppressed -= 1 def cm() -> Generator[None, None, None]: global type_checks_suppressed with type_checks_suppress_lock: type_checks_suppressed += 1 try: yield finally: with type_checks_suppress_lock: type_checks_suppressed -= 1 if func is None: # Context manager mode return contextmanager(cm)() else: # Decorator mode update_wrapper(wrapper, func) return wrapper _vendor/typeguard/_memo.py 0000644 00000002427 15030122015 0011644 0 ustar 00 from __future__ import annotations from typing import Any from typeguard._config import TypeCheckConfiguration, global_config class TypeCheckMemo: """ Contains information necessary for type checkers to do their work. .. attribute:: globals :type: dict[str, Any] Dictionary of global variables to use for resolving forward references. .. attribute:: locals :type: dict[str, Any] Dictionary of local variables to use for resolving forward references. .. attribute:: self_type :type: type | None When running type checks within an instance method or class method, this is the class object that the first argument (usually named ``self`` or ``cls``) refers to. .. attribute:: config :type: TypeCheckConfiguration Contains the configuration for a particular set of type checking operations. """ __slots__ = "globals", "locals", "self_type", "config" def __init__( self, globals: dict[str, Any], locals: dict[str, Any], *, self_type: type | None = None, config: TypeCheckConfiguration = global_config, ): self.globals = globals self.locals = locals self.self_type = self_type self.config = config _vendor/typeguard/__init__.py 0000644 00000004027 15030122015 0012305 0 ustar 00 import os from typing import Any from ._checkers import TypeCheckerCallable as TypeCheckerCallable from ._checkers import TypeCheckLookupCallback as TypeCheckLookupCallback from ._checkers import check_type_internal as check_type_internal from ._checkers import checker_lookup_functions as checker_lookup_functions from ._checkers import load_plugins as load_plugins from ._config import CollectionCheckStrategy as CollectionCheckStrategy from ._config import ForwardRefPolicy as ForwardRefPolicy from ._config import TypeCheckConfiguration as TypeCheckConfiguration from ._decorators import typechecked as typechecked from ._decorators import typeguard_ignore as typeguard_ignore from ._exceptions import InstrumentationWarning as InstrumentationWarning from ._exceptions import TypeCheckError as TypeCheckError from ._exceptions import TypeCheckWarning as TypeCheckWarning from ._exceptions import TypeHintWarning as TypeHintWarning from ._functions import TypeCheckFailCallback as TypeCheckFailCallback from ._functions import check_type as check_type from ._functions import warn_on_error as warn_on_error from ._importhook import ImportHookManager as ImportHookManager from ._importhook import TypeguardFinder as TypeguardFinder from ._importhook import install_import_hook as install_import_hook from ._memo import TypeCheckMemo as TypeCheckMemo from ._suppression import suppress_type_checks as suppress_type_checks from ._utils import Unset as Unset # Re-export imports so they look like they live directly in this package for value in list(locals().values()): if getattr(value, "__module__", "").startswith(f"{__name__}."): value.__module__ = __name__ config: TypeCheckConfiguration def __getattr__(name: str) -> Any: if name == "config": from ._config import global_config return global_config raise AttributeError(f"module {__name__!r} has no attribute {name!r}") # Automatically load checker lookup functions unless explicitly disabled if "TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD" not in os.environ: load_plugins() _vendor/typeguard/_transformer.py 0000644 00000127611 15030122015 0013254 0 ustar 00 from __future__ import annotations import ast import builtins import sys import typing from ast import ( AST, Add, AnnAssign, Assign, AsyncFunctionDef, Attribute, AugAssign, BinOp, BitAnd, BitOr, BitXor, Call, ClassDef, Constant, Dict, Div, Expr, Expression, FloorDiv, FunctionDef, If, Import, ImportFrom, Index, List, Load, LShift, MatMult, Mod, Module, Mult, Name, NamedExpr, NodeTransformer, NodeVisitor, Pass, Pow, Return, RShift, Starred, Store, Sub, Subscript, Tuple, Yield, YieldFrom, alias, copy_location, expr, fix_missing_locations, keyword, walk, ) from collections import defaultdict from collections.abc import Generator, Sequence from contextlib import contextmanager from copy import deepcopy from dataclasses import dataclass, field from typing import Any, ClassVar, cast, overload generator_names = ( "typing.Generator", "collections.abc.Generator", "typing.Iterator", "collections.abc.Iterator", "typing.Iterable", "collections.abc.Iterable", "typing.AsyncIterator", "collections.abc.AsyncIterator", "typing.AsyncIterable", "collections.abc.AsyncIterable", "typing.AsyncGenerator", "collections.abc.AsyncGenerator", ) anytype_names = ( "typing.Any", "typing_extensions.Any", ) literal_names = ( "typing.Literal", "typing_extensions.Literal", ) annotated_names = ( "typing.Annotated", "typing_extensions.Annotated", ) ignore_decorators = ( "typing.no_type_check", "typeguard.typeguard_ignore", ) aug_assign_functions = { Add: "iadd", Sub: "isub", Mult: "imul", MatMult: "imatmul", Div: "itruediv", FloorDiv: "ifloordiv", Mod: "imod", Pow: "ipow", LShift: "ilshift", RShift: "irshift", BitAnd: "iand", BitXor: "ixor", BitOr: "ior", } @dataclass class TransformMemo: node: Module | ClassDef | FunctionDef | AsyncFunctionDef | None parent: TransformMemo | None path: tuple[str, ...] joined_path: Constant = field(init=False) return_annotation: expr | None = None yield_annotation: expr | None = None send_annotation: expr | None = None is_async: bool = False local_names: set[str] = field(init=False, default_factory=set) imported_names: dict[str, str] = field(init=False, default_factory=dict) ignored_names: set[str] = field(init=False, default_factory=set) load_names: defaultdict[str, dict[str, Name]] = field( init=False, default_factory=lambda: defaultdict(dict) ) has_yield_expressions: bool = field(init=False, default=False) has_return_expressions: bool = field(init=False, default=False) memo_var_name: Name | None = field(init=False, default=None) should_instrument: bool = field(init=False, default=True) variable_annotations: dict[str, expr] = field(init=False, default_factory=dict) configuration_overrides: dict[str, Any] = field(init=False, default_factory=dict) code_inject_index: int = field(init=False, default=0) def __post_init__(self) -> None: elements: list[str] = [] memo = self while isinstance(memo.node, (ClassDef, FunctionDef, AsyncFunctionDef)): elements.insert(0, memo.node.name) if not memo.parent: break memo = memo.parent if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)): elements.insert(0, "<locals>") self.joined_path = Constant(".".join(elements)) # Figure out where to insert instrumentation code if self.node: for index, child in enumerate(self.node.body): if isinstance(child, ImportFrom) and child.module == "__future__": # (module only) __future__ imports must come first continue elif ( isinstance(child, Expr) and isinstance(child.value, Constant) and isinstance(child.value.value, str) ): continue # docstring self.code_inject_index = index break def get_unused_name(self, name: str) -> str: memo: TransformMemo | None = self while memo is not None: if name in memo.local_names: memo = self name += "_" else: memo = memo.parent self.local_names.add(name) return name def is_ignored_name(self, expression: expr | Expr | None) -> bool: top_expression = ( expression.value if isinstance(expression, Expr) else expression ) if isinstance(top_expression, Attribute) and isinstance( top_expression.value, Name ): name = top_expression.value.id elif isinstance(top_expression, Name): name = top_expression.id else: return False memo: TransformMemo | None = self while memo is not None: if name in memo.ignored_names: return True memo = memo.parent return False def get_memo_name(self) -> Name: if not self.memo_var_name: self.memo_var_name = Name(id="memo", ctx=Load()) return self.memo_var_name def get_import(self, module: str, name: str) -> Name: if module in self.load_names and name in self.load_names[module]: return self.load_names[module][name] qualified_name = f"{module}.{name}" if name in self.imported_names and self.imported_names[name] == qualified_name: return Name(id=name, ctx=Load()) alias = self.get_unused_name(name) node = self.load_names[module][name] = Name(id=alias, ctx=Load()) self.imported_names[name] = qualified_name return node def insert_imports(self, node: Module | FunctionDef | AsyncFunctionDef) -> None: """Insert imports needed by injected code.""" if not self.load_names: return # Insert imports after any "from __future__ ..." imports and any docstring for modulename, names in self.load_names.items(): aliases = [ alias(orig_name, new_name.id if orig_name != new_name.id else None) for orig_name, new_name in sorted(names.items()) ] node.body.insert(self.code_inject_index, ImportFrom(modulename, aliases, 0)) def name_matches(self, expression: expr | Expr | None, *names: str) -> bool: if expression is None: return False path: list[str] = [] top_expression = ( expression.value if isinstance(expression, Expr) else expression ) if isinstance(top_expression, Subscript): top_expression = top_expression.value elif isinstance(top_expression, Call): top_expression = top_expression.func while isinstance(top_expression, Attribute): path.insert(0, top_expression.attr) top_expression = top_expression.value if not isinstance(top_expression, Name): return False if top_expression.id in self.imported_names: translated = self.imported_names[top_expression.id] elif hasattr(builtins, top_expression.id): translated = "builtins." + top_expression.id else: translated = top_expression.id path.insert(0, translated) joined_path = ".".join(path) if joined_path in names: return True elif self.parent: return self.parent.name_matches(expression, *names) else: return False def get_config_keywords(self) -> list[keyword]: if self.parent and isinstance(self.parent.node, ClassDef): overrides = self.parent.configuration_overrides.copy() else: overrides = {} overrides.update(self.configuration_overrides) return [keyword(key, value) for key, value in overrides.items()] class NameCollector(NodeVisitor): def __init__(self) -> None: self.names: set[str] = set() def visit_Import(self, node: Import) -> None: for name in node.names: self.names.add(name.asname or name.name) def visit_ImportFrom(self, node: ImportFrom) -> None: for name in node.names: self.names.add(name.asname or name.name) def visit_Assign(self, node: Assign) -> None: for target in node.targets: if isinstance(target, Name): self.names.add(target.id) def visit_NamedExpr(self, node: NamedExpr) -> Any: if isinstance(node.target, Name): self.names.add(node.target.id) def visit_FunctionDef(self, node: FunctionDef) -> None: pass def visit_ClassDef(self, node: ClassDef) -> None: pass class GeneratorDetector(NodeVisitor): """Detects if a function node is a generator function.""" contains_yields: bool = False in_root_function: bool = False def visit_Yield(self, node: Yield) -> Any: self.contains_yields = True def visit_YieldFrom(self, node: YieldFrom) -> Any: self.contains_yields = True def visit_ClassDef(self, node: ClassDef) -> Any: pass def visit_FunctionDef(self, node: FunctionDef | AsyncFunctionDef) -> Any: if not self.in_root_function: self.in_root_function = True self.generic_visit(node) self.in_root_function = False def visit_AsyncFunctionDef(self, node: AsyncFunctionDef) -> Any: self.visit_FunctionDef(node) class AnnotationTransformer(NodeTransformer): type_substitutions: ClassVar[dict[str, tuple[str, str]]] = { "builtins.dict": ("typing", "Dict"), "builtins.list": ("typing", "List"), "builtins.tuple": ("typing", "Tuple"), "builtins.set": ("typing", "Set"), "builtins.frozenset": ("typing", "FrozenSet"), } def __init__(self, transformer: TypeguardTransformer): self.transformer = transformer self._memo = transformer._memo self._level = 0 def visit(self, node: AST) -> Any: # Don't process Literals if isinstance(node, expr) and self._memo.name_matches(node, *literal_names): return node self._level += 1 new_node = super().visit(node) self._level -= 1 if isinstance(new_node, Expression) and not hasattr(new_node, "body"): return None # Return None if this new node matches a variation of typing.Any if ( self._level == 0 and isinstance(new_node, expr) and self._memo.name_matches(new_node, *anytype_names) ): return None return new_node def visit_BinOp(self, node: BinOp) -> Any: self.generic_visit(node) if isinstance(node.op, BitOr): # If either branch of the BinOp has been transformed to `None`, it means # that a type in the union was ignored, so the entire annotation should e # ignored if not hasattr(node, "left") or not hasattr(node, "right"): return None # Return Any if either side is Any if self._memo.name_matches(node.left, *anytype_names): return node.left elif self._memo.name_matches(node.right, *anytype_names): return node.right if sys.version_info < (3, 10): union_name = self.transformer._get_import("typing", "Union") return Subscript( value=union_name, slice=Index( Tuple(elts=[node.left, node.right], ctx=Load()), ctx=Load() ), ctx=Load(), ) return node def visit_Attribute(self, node: Attribute) -> Any: if self._memo.is_ignored_name(node): return None return node def visit_Subscript(self, node: Subscript) -> Any: if self._memo.is_ignored_name(node.value): return None # The subscript of typing(_extensions).Literal can be any arbitrary string, so # don't try to evaluate it as code if node.slice: if isinstance(node.slice, Index): # Python 3.8 slice_value = node.slice.value # type: ignore[attr-defined] else: slice_value = node.slice if isinstance(slice_value, Tuple): if self._memo.name_matches(node.value, *annotated_names): # Only treat the first argument to typing.Annotated as a potential # forward reference items = cast( typing.List[expr], [self.visit(slice_value.elts[0])] + slice_value.elts[1:], ) else: items = cast( typing.List[expr], [self.visit(item) for item in slice_value.elts], ) # If this is a Union and any of the items is Any, erase the entire # annotation if self._memo.name_matches(node.value, "typing.Union") and any( item is None or ( isinstance(item, expr) and self._memo.name_matches(item, *anytype_names) ) for item in items ): return None # If all items in the subscript were Any, erase the subscript entirely if all(item is None for item in items): return node.value for index, item in enumerate(items): if item is None: items[index] = self.transformer._get_import("typing", "Any") slice_value.elts = items else: self.generic_visit(node) # If the transformer erased the slice entirely, just return the node # value without the subscript (unless it's Optional, in which case erase # the node entirely if self._memo.name_matches( node.value, "typing.Optional" ) and not hasattr(node, "slice"): return None if sys.version_info >= (3, 9) and not hasattr(node, "slice"): return node.value elif sys.version_info < (3, 9) and not hasattr(node.slice, "value"): return node.value return node def visit_Name(self, node: Name) -> Any: if self._memo.is_ignored_name(node): return None if sys.version_info < (3, 9): for typename, substitute in self.type_substitutions.items(): if self._memo.name_matches(node, typename): new_node = self.transformer._get_import(*substitute) return copy_location(new_node, node) return node def visit_Call(self, node: Call) -> Any: # Don't recurse into calls return node def visit_Constant(self, node: Constant) -> Any: if isinstance(node.value, str): expression = ast.parse(node.value, mode="eval") new_node = self.visit(expression) if new_node: return copy_location(new_node.body, node) else: return None return node class TypeguardTransformer(NodeTransformer): def __init__( self, target_path: Sequence[str] | None = None, target_lineno: int | None = None ) -> None: self._target_path = tuple(target_path) if target_path else None self._memo = self._module_memo = TransformMemo(None, None, ()) self.names_used_in_annotations: set[str] = set() self.target_node: FunctionDef | AsyncFunctionDef | None = None self.target_lineno = target_lineno def generic_visit(self, node: AST) -> AST: has_non_empty_body_initially = bool(getattr(node, "body", None)) initial_type = type(node) node = super().generic_visit(node) if ( type(node) is initial_type and has_non_empty_body_initially and hasattr(node, "body") and not node.body ): # If we have still the same node type after transformation # but we've optimised it's body away, we add a `pass` statement. node.body = [Pass()] return node @contextmanager def _use_memo( self, node: ClassDef | FunctionDef | AsyncFunctionDef ) -> Generator[None, Any, None]: new_memo = TransformMemo(node, self._memo, self._memo.path + (node.name,)) old_memo = self._memo self._memo = new_memo if isinstance(node, (FunctionDef, AsyncFunctionDef)): new_memo.should_instrument = ( self._target_path is None or new_memo.path == self._target_path ) if new_memo.should_instrument: # Check if the function is a generator function detector = GeneratorDetector() detector.visit(node) # Extract yield, send and return types where possible from a subscripted # annotation like Generator[int, str, bool] return_annotation = deepcopy(node.returns) if detector.contains_yields and new_memo.name_matches( return_annotation, *generator_names ): if isinstance(return_annotation, Subscript): annotation_slice = return_annotation.slice # Python < 3.9 if isinstance(annotation_slice, Index): annotation_slice = ( annotation_slice.value # type: ignore[attr-defined] ) if isinstance(annotation_slice, Tuple): items = annotation_slice.elts else: items = [annotation_slice] if len(items) > 0: new_memo.yield_annotation = self._convert_annotation( items[0] ) if len(items) > 1: new_memo.send_annotation = self._convert_annotation( items[1] ) if len(items) > 2: new_memo.return_annotation = self._convert_annotation( items[2] ) else: new_memo.return_annotation = self._convert_annotation( return_annotation ) if isinstance(node, AsyncFunctionDef): new_memo.is_async = True yield self._memo = old_memo def _get_import(self, module: str, name: str) -> Name: memo = self._memo if self._target_path else self._module_memo return memo.get_import(module, name) @overload def _convert_annotation(self, annotation: None) -> None: ... @overload def _convert_annotation(self, annotation: expr) -> expr: ... def _convert_annotation(self, annotation: expr | None) -> expr | None: if annotation is None: return None # Convert PEP 604 unions (x | y) and generic built-in collections where # necessary, and undo forward references new_annotation = cast(expr, AnnotationTransformer(self).visit(annotation)) if isinstance(new_annotation, expr): new_annotation = ast.copy_location(new_annotation, annotation) # Store names used in the annotation names = {node.id for node in walk(new_annotation) if isinstance(node, Name)} self.names_used_in_annotations.update(names) return new_annotation def visit_Name(self, node: Name) -> Name: self._memo.local_names.add(node.id) return node def visit_Module(self, node: Module) -> Module: self._module_memo = self._memo = TransformMemo(node, None, ()) self.generic_visit(node) self._module_memo.insert_imports(node) fix_missing_locations(node) return node def visit_Import(self, node: Import) -> Import: for name in node.names: self._memo.local_names.add(name.asname or name.name) self._memo.imported_names[name.asname or name.name] = name.name return node def visit_ImportFrom(self, node: ImportFrom) -> ImportFrom: for name in node.names: if name.name != "*": alias = name.asname or name.name self._memo.local_names.add(alias) self._memo.imported_names[alias] = f"{node.module}.{name.name}" return node def visit_ClassDef(self, node: ClassDef) -> ClassDef | None: self._memo.local_names.add(node.name) # Eliminate top level classes not belonging to the target path if ( self._target_path is not None and not self._memo.path and node.name != self._target_path[0] ): return None with self._use_memo(node): for decorator in node.decorator_list.copy(): if self._memo.name_matches(decorator, "typeguard.typechecked"): # Remove the decorator to prevent duplicate instrumentation node.decorator_list.remove(decorator) # Store any configuration overrides if isinstance(decorator, Call) and decorator.keywords: self._memo.configuration_overrides.update( {kw.arg: kw.value for kw in decorator.keywords if kw.arg} ) self.generic_visit(node) return node def visit_FunctionDef( self, node: FunctionDef | AsyncFunctionDef ) -> FunctionDef | AsyncFunctionDef | None: """ Injects type checks for function arguments, and for a return of None if the function is annotated to return something else than Any or None, and the body ends without an explicit "return". """ self._memo.local_names.add(node.name) # Eliminate top level functions not belonging to the target path if ( self._target_path is not None and not self._memo.path and node.name != self._target_path[0] ): return None # Skip instrumentation if we're instrumenting the whole module and the function # contains either @no_type_check or @typeguard_ignore if self._target_path is None: for decorator in node.decorator_list: if self._memo.name_matches(decorator, *ignore_decorators): return node with self._use_memo(node): arg_annotations: dict[str, Any] = {} if self._target_path is None or self._memo.path == self._target_path: # Find line number we're supposed to match against if node.decorator_list: first_lineno = node.decorator_list[0].lineno else: first_lineno = node.lineno for decorator in node.decorator_list.copy(): if self._memo.name_matches(decorator, "typing.overload"): # Remove overloads entirely return None elif self._memo.name_matches(decorator, "typeguard.typechecked"): # Remove the decorator to prevent duplicate instrumentation node.decorator_list.remove(decorator) # Store any configuration overrides if isinstance(decorator, Call) and decorator.keywords: self._memo.configuration_overrides = { kw.arg: kw.value for kw in decorator.keywords if kw.arg } if self.target_lineno == first_lineno: assert self.target_node is None self.target_node = node if node.decorator_list: self.target_lineno = node.decorator_list[0].lineno else: self.target_lineno = node.lineno all_args = node.args.args + node.args.kwonlyargs + node.args.posonlyargs # Ensure that any type shadowed by the positional or keyword-only # argument names are ignored in this function for arg in all_args: self._memo.ignored_names.add(arg.arg) # Ensure that any type shadowed by the variable positional argument name # (e.g. "args" in *args) is ignored this function if node.args.vararg: self._memo.ignored_names.add(node.args.vararg.arg) # Ensure that any type shadowed by the variable keywrod argument name # (e.g. "kwargs" in *kwargs) is ignored this function if node.args.kwarg: self._memo.ignored_names.add(node.args.kwarg.arg) for arg in all_args: annotation = self._convert_annotation(deepcopy(arg.annotation)) if annotation: arg_annotations[arg.arg] = annotation if node.args.vararg: annotation_ = self._convert_annotation(node.args.vararg.annotation) if annotation_: if sys.version_info >= (3, 9): container = Name("tuple", ctx=Load()) else: container = self._get_import("typing", "Tuple") subscript_slice: Tuple | Index = Tuple( [ annotation_, Constant(Ellipsis), ], ctx=Load(), ) if sys.version_info < (3, 9): subscript_slice = Index(subscript_slice, ctx=Load()) arg_annotations[node.args.vararg.arg] = Subscript( container, subscript_slice, ctx=Load() ) if node.args.kwarg: annotation_ = self._convert_annotation(node.args.kwarg.annotation) if annotation_: if sys.version_info >= (3, 9): container = Name("dict", ctx=Load()) else: container = self._get_import("typing", "Dict") subscript_slice = Tuple( [ Name("str", ctx=Load()), annotation_, ], ctx=Load(), ) if sys.version_info < (3, 9): subscript_slice = Index(subscript_slice, ctx=Load()) arg_annotations[node.args.kwarg.arg] = Subscript( container, subscript_slice, ctx=Load() ) if arg_annotations: self._memo.variable_annotations.update(arg_annotations) self.generic_visit(node) if arg_annotations: annotations_dict = Dict( keys=[Constant(key) for key in arg_annotations.keys()], values=[ Tuple([Name(key, ctx=Load()), annotation], ctx=Load()) for key, annotation in arg_annotations.items() ], ) func_name = self._get_import( "typeguard._functions", "check_argument_types" ) args = [ self._memo.joined_path, annotations_dict, self._memo.get_memo_name(), ] node.body.insert( self._memo.code_inject_index, Expr(Call(func_name, args, [])) ) # Add a checked "return None" to the end if there's no explicit return # Skip if the return annotation is None or Any if ( self._memo.return_annotation and (not self._memo.is_async or not self._memo.has_yield_expressions) and not isinstance(node.body[-1], Return) and ( not isinstance(self._memo.return_annotation, Constant) or self._memo.return_annotation.value is not None ) ): func_name = self._get_import( "typeguard._functions", "check_return_type" ) return_node = Return( Call( func_name, [ self._memo.joined_path, Constant(None), self._memo.return_annotation, self._memo.get_memo_name(), ], [], ) ) # Replace a placeholder "pass" at the end if isinstance(node.body[-1], Pass): copy_location(return_node, node.body[-1]) del node.body[-1] node.body.append(return_node) # Insert code to create the call memo, if it was ever needed for this # function if self._memo.memo_var_name: memo_kwargs: dict[str, Any] = {} if self._memo.parent and isinstance(self._memo.parent.node, ClassDef): for decorator in node.decorator_list: if ( isinstance(decorator, Name) and decorator.id == "staticmethod" ): break elif ( isinstance(decorator, Name) and decorator.id == "classmethod" ): memo_kwargs["self_type"] = Name( id=node.args.args[0].arg, ctx=Load() ) break else: if node.args.args: if node.name == "__new__": memo_kwargs["self_type"] = Name( id=node.args.args[0].arg, ctx=Load() ) else: memo_kwargs["self_type"] = Attribute( Name(id=node.args.args[0].arg, ctx=Load()), "__class__", ctx=Load(), ) # Construct the function reference # Nested functions get special treatment: the function name is added # to free variables (and the closure of the resulting function) names: list[str] = [node.name] memo = self._memo.parent while memo: if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)): # This is a nested function. Use the function name as-is. del names[:-1] break elif not isinstance(memo.node, ClassDef): break names.insert(0, memo.node.name) memo = memo.parent config_keywords = self._memo.get_config_keywords() if config_keywords: memo_kwargs["config"] = Call( self._get_import("dataclasses", "replace"), [self._get_import("typeguard._config", "global_config")], config_keywords, ) self._memo.memo_var_name.id = self._memo.get_unused_name("memo") memo_store_name = Name(id=self._memo.memo_var_name.id, ctx=Store()) globals_call = Call(Name(id="globals", ctx=Load()), [], []) locals_call = Call(Name(id="locals", ctx=Load()), [], []) memo_expr = Call( self._get_import("typeguard", "TypeCheckMemo"), [globals_call, locals_call], [keyword(key, value) for key, value in memo_kwargs.items()], ) node.body.insert( self._memo.code_inject_index, Assign([memo_store_name], memo_expr), ) self._memo.insert_imports(node) # Special case the __new__() method to create a local alias from the # class name to the first argument (usually "cls") if ( isinstance(node, FunctionDef) and node.args and self._memo.parent is not None and isinstance(self._memo.parent.node, ClassDef) and node.name == "__new__" ): first_args_expr = Name(node.args.args[0].arg, ctx=Load()) cls_name = Name(self._memo.parent.node.name, ctx=Store()) node.body.insert( self._memo.code_inject_index, Assign([cls_name], first_args_expr), ) # Rmove any placeholder "pass" at the end if isinstance(node.body[-1], Pass): del node.body[-1] return node def visit_AsyncFunctionDef( self, node: AsyncFunctionDef ) -> FunctionDef | AsyncFunctionDef | None: return self.visit_FunctionDef(node) def visit_Return(self, node: Return) -> Return: """This injects type checks into "return" statements.""" self.generic_visit(node) if ( self._memo.return_annotation and self._memo.should_instrument and not self._memo.is_ignored_name(self._memo.return_annotation) ): func_name = self._get_import("typeguard._functions", "check_return_type") old_node = node retval = old_node.value or Constant(None) node = Return( Call( func_name, [ self._memo.joined_path, retval, self._memo.return_annotation, self._memo.get_memo_name(), ], [], ) ) copy_location(node, old_node) return node def visit_Yield(self, node: Yield) -> Yield | Call: """ This injects type checks into "yield" expressions, checking both the yielded value and the value sent back to the generator, when appropriate. """ self._memo.has_yield_expressions = True self.generic_visit(node) if ( self._memo.yield_annotation and self._memo.should_instrument and not self._memo.is_ignored_name(self._memo.yield_annotation) ): func_name = self._get_import("typeguard._functions", "check_yield_type") yieldval = node.value or Constant(None) node.value = Call( func_name, [ self._memo.joined_path, yieldval, self._memo.yield_annotation, self._memo.get_memo_name(), ], [], ) if ( self._memo.send_annotation and self._memo.should_instrument and not self._memo.is_ignored_name(self._memo.send_annotation) ): func_name = self._get_import("typeguard._functions", "check_send_type") old_node = node call_node = Call( func_name, [ self._memo.joined_path, old_node, self._memo.send_annotation, self._memo.get_memo_name(), ], [], ) copy_location(call_node, old_node) return call_node return node def visit_AnnAssign(self, node: AnnAssign) -> Any: """ This injects a type check into a local variable annotation-assignment within a function body. """ self.generic_visit(node) if ( isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and node.annotation and isinstance(node.target, Name) ): self._memo.ignored_names.add(node.target.id) annotation = self._convert_annotation(deepcopy(node.annotation)) if annotation: self._memo.variable_annotations[node.target.id] = annotation if node.value: func_name = self._get_import( "typeguard._functions", "check_variable_assignment" ) node.value = Call( func_name, [ node.value, Constant(node.target.id), annotation, self._memo.get_memo_name(), ], [], ) return node def visit_Assign(self, node: Assign) -> Any: """ This injects a type check into a local variable assignment within a function body. The variable must have been annotated earlier in the function body. """ self.generic_visit(node) # Only instrument function-local assignments if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)): targets: list[dict[Constant, expr | None]] = [] check_required = False for target in node.targets: elts: Sequence[expr] if isinstance(target, Name): elts = [target] elif isinstance(target, Tuple): elts = target.elts else: continue annotations_: dict[Constant, expr | None] = {} for exp in elts: prefix = "" if isinstance(exp, Starred): exp = exp.value prefix = "*" if isinstance(exp, Name): self._memo.ignored_names.add(exp.id) name = prefix + exp.id annotation = self._memo.variable_annotations.get(exp.id) if annotation: annotations_[Constant(name)] = annotation check_required = True else: annotations_[Constant(name)] = None targets.append(annotations_) if check_required: # Replace missing annotations with typing.Any for item in targets: for key, expression in item.items(): if expression is None: item[key] = self._get_import("typing", "Any") if len(targets) == 1 and len(targets[0]) == 1: func_name = self._get_import( "typeguard._functions", "check_variable_assignment" ) target_varname = next(iter(targets[0])) node.value = Call( func_name, [ node.value, target_varname, targets[0][target_varname], self._memo.get_memo_name(), ], [], ) elif targets: func_name = self._get_import( "typeguard._functions", "check_multi_variable_assignment" ) targets_arg = List( [ Dict(keys=list(target), values=list(target.values())) for target in targets ], ctx=Load(), ) node.value = Call( func_name, [node.value, targets_arg, self._memo.get_memo_name()], [], ) return node def visit_NamedExpr(self, node: NamedExpr) -> Any: """This injects a type check into an assignment expression (a := foo()).""" self.generic_visit(node) # Only instrument function-local assignments if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance( node.target, Name ): self._memo.ignored_names.add(node.target.id) # Bail out if no matching annotation is found annotation = self._memo.variable_annotations.get(node.target.id) if annotation is None: return node func_name = self._get_import( "typeguard._functions", "check_variable_assignment" ) node.value = Call( func_name, [ node.value, Constant(node.target.id), annotation, self._memo.get_memo_name(), ], [], ) return node def visit_AugAssign(self, node: AugAssign) -> Any: """ This injects a type check into an augmented assignment expression (a += 1). """ self.generic_visit(node) # Only instrument function-local assignments if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance( node.target, Name ): # Bail out if no matching annotation is found annotation = self._memo.variable_annotations.get(node.target.id) if annotation is None: return node # Bail out if the operator is not found (newer Python version?) try: operator_func_name = aug_assign_functions[node.op.__class__] except KeyError: return node operator_func = self._get_import("operator", operator_func_name) operator_call = Call( operator_func, [Name(node.target.id, ctx=Load()), node.value], [] ) check_call = Call( self._get_import("typeguard._functions", "check_variable_assignment"), [ operator_call, Constant(node.target.id), annotation, self._memo.get_memo_name(), ], [], ) return Assign(targets=[node.target], value=check_call) return node def visit_If(self, node: If) -> Any: """ This blocks names from being collected from a module-level "if typing.TYPE_CHECKING:" block, so that they won't be type checked. """ self.generic_visit(node) if ( self._memo is self._module_memo and isinstance(node.test, Name) and self._memo.name_matches(node.test, "typing.TYPE_CHECKING") ): collector = NameCollector() collector.visit(node) self._memo.ignored_names.update(collector.names) return node _vendor/backports.tarfile-1.2.0.dist-info/RECORD 0000644 00000002520 15030122015 0015031 0 ustar 00 backports.tarfile-1.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 backports.tarfile-1.2.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 backports.tarfile-1.2.0.dist-info/METADATA,sha256=ghXFTq132dxaEIolxr3HK1mZqm9iyUmaRANZQSr6WlE,2020 backports.tarfile-1.2.0.dist-info/RECORD,, backports.tarfile-1.2.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 backports.tarfile-1.2.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 backports.tarfile-1.2.0.dist-info/top_level.txt,sha256=cGjaLMOoBR1FK0ApojtzWVmViTtJ7JGIK_HwXiEsvtU,10 backports/__init__.py,sha256=iOEMwnlORWezdO8-2vxBIPSR37D7JGjluZ8f55vzxls,81 backports/__pycache__/__init__.cpython-312.pyc,, backports/tarfile/__init__.py,sha256=Pwf2qUIfB0SolJPCKcx3vz3UEu_aids4g4sAfxy94qg,108491 backports/tarfile/__main__.py,sha256=Yw2oGT1afrz2eBskzdPYL8ReB_3liApmhFkN2EbDmc4,59 backports/tarfile/__pycache__/__init__.cpython-312.pyc,, backports/tarfile/__pycache__/__main__.cpython-312.pyc,, backports/tarfile/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc,, backports/tarfile/compat/__pycache__/py38.cpython-312.pyc,, backports/tarfile/compat/py38.py,sha256=iYkyt_gvWjLzGUTJD9TuTfMMjOk-ersXZmRlvQYN2qE,568 _vendor/backports.tarfile-1.2.0.dist-info/METADATA 0000644 00000003744 15030122015 0015244 0 ustar 00 Metadata-Version: 2.1 Name: backports.tarfile Version: 1.2.0 Summary: Backport of CPython tarfile module Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Homepage, https://github.com/jaraco/backports.tarfile Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Provides-Extra: docs Requires-Dist: sphinx >=3.5 ; extra == 'docs' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' Requires-Dist: rst.linker >=1.9 ; extra == 'docs' Requires-Dist: furo ; extra == 'docs' Requires-Dist: sphinx-lint ; extra == 'docs' Provides-Extra: testing Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'testing' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' Requires-Dist: pytest-cov ; extra == 'testing' Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' Requires-Dist: jaraco.test ; extra == 'testing' Requires-Dist: pytest !=8.0.* ; extra == 'testing' .. image:: https://img.shields.io/pypi/v/backports.tarfile.svg :target: https://pypi.org/project/backports.tarfile .. image:: https://img.shields.io/pypi/pyversions/backports.tarfile.svg .. image:: https://github.com/jaraco/backports.tarfile/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/backports.tarfile/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. .. image:: https://readthedocs.org/projects/backportstarfile/badge/?version=latest .. :target: https://backportstarfile.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton _vendor/backports.tarfile-1.2.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0015403 0 ustar 00 pip _vendor/backports.tarfile-1.2.0.dist-info/WHEEL 0000644 00000000134 15030122015 0014716 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/backports.tarfile-1.2.0.dist-info/LICENSE 0000644 00000001777 15030122015 0015152 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/backports.tarfile-1.2.0.dist-info/top_level.txt 0000644 00000000012 15030122015 0016654 0 ustar 00 backports _vendor/backports.tarfile-1.2.0.dist-info/REQUESTED 0000644 00000000000 15030122015 0015403 0 ustar 00 _vendor/zipp/glob.py 0000644 00000006012 15030122015 0010443 0 ustar 00 import os import re _default_seps = os.sep + str(os.altsep) * bool(os.altsep) class Translator: """ >>> Translator('xyz') Traceback (most recent call last): ... AssertionError: Invalid separators >>> Translator('') Traceback (most recent call last): ... AssertionError: Invalid separators """ seps: str def __init__(self, seps: str = _default_seps): assert seps and set(seps) <= set(_default_seps), "Invalid separators" self.seps = seps def translate(self, pattern): """ Given a glob pattern, produce a regex that matches it. """ return self.extend(self.translate_core(pattern)) def extend(self, pattern): r""" Extend regex for pattern-wide concerns. Apply '(?s:)' to create a non-matching group that matches newlines (valid on Unix). Append '\Z' to imply fullmatch even when match is used. """ return rf'(?s:{pattern})\Z' def translate_core(self, pattern): r""" Given a glob pattern, produce a regex that matches it. >>> t = Translator() >>> t.translate_core('*.txt').replace('\\\\', '') '[^/]*\\.txt' >>> t.translate_core('a?txt') 'a[^/]txt' >>> t.translate_core('**/*').replace('\\\\', '') '.*/[^/][^/]*' """ self.restrict_rglob(pattern) return ''.join(map(self.replace, separate(self.star_not_empty(pattern)))) def replace(self, match): """ Perform the replacements for a match from :func:`separate`. """ return match.group('set') or ( re.escape(match.group(0)) .replace('\\*\\*', r'.*') .replace('\\*', rf'[^{re.escape(self.seps)}]*') .replace('\\?', r'[^/]') ) def restrict_rglob(self, pattern): """ Raise ValueError if ** appears in anything but a full path segment. >>> Translator().translate('**foo') Traceback (most recent call last): ... ValueError: ** must appear alone in a path segment """ seps_pattern = rf'[{re.escape(self.seps)}]+' segments = re.split(seps_pattern, pattern) if any('**' in segment and segment != '**' for segment in segments): raise ValueError("** must appear alone in a path segment") def star_not_empty(self, pattern): """ Ensure that * will not match an empty segment. """ def handle_segment(match): segment = match.group(0) return '?*' if segment == '*' else segment not_seps_pattern = rf'[^{re.escape(self.seps)}]+' return re.sub(not_seps_pattern, handle_segment, pattern) def separate(pattern): """ Separate out character sets to avoid translating their contents. >>> [m.group(0) for m in separate('*.txt')] ['*.txt'] >>> [m.group(0) for m in separate('a[?]txt')] ['a', '[?]', 'txt'] """ return re.finditer(r'([^\[]+)|(?P<set>[\[].*?[\]])|([\[][^\]]*$)', pattern) _vendor/zipp/__pycache__/__init__.cpython-310.pyc 0000644 00000037502 15030122015 0015626 0 ustar 00 o �hd4 � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZddl m Z ddl m Z dgZ dd� Zdd � ZejZ d d � ZG d d � d �ZG dd� d�ZG dd� deeej�ZG dd� de�Zddd�ZG dd� d�ZdS )� N� )� text_encoding)� Translator�Pathc C s t �t| �dd�S )a2 Given a path with elements separated by posixpath.sep, generate all parents of that path. >>> list(_parents('b/d')) ['b'] >>> list(_parents('/b/d/')) ['/b'] >>> list(_parents('b/d/f/')) ['b/d', 'b'] >>> list(_parents('b')) [] >>> list(_parents('')) [] r N)� itertools�islice� _ancestry)�path� r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/zipp/__init__.py�_parents s r c c sN � | � tj�} | r!| tjkr%| V t�| �\} }| r#| tjksdS dS dS dS )aR Given a path with elements separated by posixpath.sep, generate all elements of that path >>> list(_ancestry('b/d')) ['b/d', 'b'] >>> list(_ancestry('/b/d/')) ['/b/d', '/b'] >>> list(_ancestry('b/d/f/')) ['b/d/f', 'b/d', 'b'] >>> list(_ancestry('b')) ['b'] >>> list(_ancestry('')) [] N)�rstrip� posixpath�sep�split)r �tailr r r r % s � �r c C s t �t|�j| �S )zZ Return items in minuend not in subtrahend, retaining order with O(1) lookup. )r � filterfalse�set� __contains__)�minuend� subtrahendr r r � _difference? s r c s4 e Zd ZdZ� fdd�Zdd� Z� fdd�Z� ZS )�InitializedStatez? Mix-in to save the initialization state for pickling. c s" || _ || _t� j|i |�� d S �N)�_InitializedState__args�_InitializedState__kwargs�super�__init__)�self�args�kwargs�� __class__r r r L s zInitializedState.__init__c C s | j | jfS r )r r �r r r r � __getstate__Q � z InitializedState.__getstate__c s |\}}t � j|i |�� d S r )r r )r �stater r r! r r � __setstate__T s z InitializedState.__setstate__)�__name__� __module__� __qualname__�__doc__r r$ r' � __classcell__r r r! r r G s r c s, e Zd ZdZ� fdd�Zedd� �Z� ZS )�SanitizedNamesz7 ZipFile mix-in to ensure names are sanitized. c s t t| jt� �� ��S r )�list�map� _sanitizer �namelistr# r! r r r1 ^ s zSanitizedNames.namelistc C s` dd� }t jdd| t jd�}|�dd�}|�d�}d�t||��}|s'td��|d| �d� S ) aa Ensure a relative path with posix separators and no dot names. Modeled after https://github.com/python/cpython/blob/bcc1be39cb1d04ad9fc0bd1b9193d3972835a57c/Lib/zipfile/__init__.py#L1799-L1813 but provides consistent cross-platform behavior. >>> san = SanitizedNames._sanitize >>> san('/foo/bar') 'foo/bar' >>> san('//foo.txt') 'foo.txt' >>> san('foo/.././bar.txt') 'foo/bar.txt' >>> san('foo../.bar.txt') 'foo../.bar.txt' >>> san('\\foo\\bar.txt') 'foo/bar.txt' >>> san('D:\\foo.txt') 'D/foo.txt' >>> san('\\\\server\\share\\file.txt') 'server/share/file.txt' >>> san('\\\\?\\GLOBALROOT\\Volume3') '?/GLOBALROOT/Volume3' >>> san('\\\\.\\PhysicalDrive1\\root') 'PhysicalDrive1/root' Retain any trailing slash. >>> san('abc/') 'abc/' Raises a ValueError if the result is empty. >>> san('../..') Traceback (most recent call last): ... ValueError: Empty filename c S s | o| dvS )N> �..�.r )�partr r r �allowed� r% z)SanitizedNames._sanitize.<locals>.allowedz ^([A-Z]):z\1)�flags�\�/zEmpty filename) �re�sub� IGNORECASE�replacer �join�filter� ValueError�endswith)�namer5 �bare�clean�parts�joinedr r r r0 a s ( zSanitizedNames._sanitize)r( r) r* r+ r1 � staticmethodr0 r, r r r! r r- Y s r- c sn e Zd ZdZedd� �Z� fdd�Zdd� Zdd � Z� fd d �Z e d d � �Z e de j de j fdd��Z� ZS )� CompleteDirsa8 A ZipFile subclass that ensures that implied directories are always included in the namelist. >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt'])) ['foo/', 'foo/bar/'] >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt', 'foo/bar/'])) ['foo/'] c C s. t j�tt| ��}dd� |D �}tt|| ��S )Nc s s � | ]}|t j V qd S r )r r )�.0�pr r r � <genexpr>� s � z-CompleteDirs._implied_dirs.<locals>.<genexpr>)r �chain� from_iterabler/ r �_deduper )�names�parents�as_dirsr r r � _implied_dirs� s zCompleteDirs._implied_dirsc s t � �� }|t| �|�� S r )r r1 r. rQ )r rN r! r r r1 � s zCompleteDirs.namelistc C s t | �� �S r )r r1 r# r r r � _name_set� r% zCompleteDirs._name_setc C s, | � � }|d }||vo||v }|r|S |S )zx If the name represents a directory, return that name as a directory (with the trailing slash). r8 )rR )r rA rN �dirname� dir_matchr r r � resolve_dir� s zCompleteDirs.resolve_dirc sF zt � �|�W S ty" |�d�r|| �� vr� tj|d� Y S w )z6 Supplement getinfo for implied dirs. r8 ��filename)r �getinfo�KeyErrorr@ rR �zipfile�ZipInfo)r rA r! r r rX � s �zCompleteDirs.getinfoc C s: t |t�r|S t |tj�s| |�S d|jvrt} | |_|S )zl Given a source (filename or zipfile), return an appropriate CompleteDirs subclass. �r)� isinstancerG rZ �ZipFile�moder" )�cls�sourcer r r �make� s zCompleteDirs.make�zf�returnc C s$ | � |�� �D ]}|�|d� q|S )z� Given a writable zip file zf, inject directory entries for any directories implied by the presence of children. � )rQ r1 �writestr)r` rc rA r r r �inject� s zCompleteDirs.inject)r( r) r* r+ rF rQ r1 rR rU rX � classmethodrb rZ r^ rg r, r r r! r rG � s rG c s, e Zd ZdZ� fdd�Z� fdd�Z� ZS )� FastLookupzV ZipFile subclass to ensure implicit dirs exist and are resolved rapidly. c �B t �t�� | jW d � S 1 sw Y t� �� | _| jS r )� contextlib�suppress�AttributeError�_FastLookup__namesr r1 r# r! r r r1 � � � zFastLookup.namelistc rj r )rk rl rm �_FastLookup__lookupr rR r# r! r r rR � ro zFastLookup._name_set)r( r) r* r+ r1 rR r, r r r! r ri � s ri c O s$ t jjdk}d| }t| |�||fS )N�pypy� )�sys�implementationrA r )�encodingr r �is_pypy� stack_levelr r r �_extract_text_encoding� s rx c @ s e Zd ZdZdZd=dd�Zdd� Zdd � Zd>d d �d d�Zdd� Z e dd� �Z e dd� �Z e dd� �Z e dd� �Ze dd� �Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� Zd3d4� Z d5d6� Z d7d8� Z d9d:� Z e Z e d;d<� �Z!d S )?r u' A :class:`importlib.resources.abc.Traversable` interface for zip files. Implements many of the features users enjoy from :class:`pathlib.Path`. Consider a zip file with this structure:: . ├── a.txt └── b ├── c.txt └── d └── e.txt >>> data = io.BytesIO() >>> zf = zipfile.ZipFile(data, 'w') >>> zf.writestr('a.txt', 'content of a') >>> zf.writestr('b/c.txt', 'content of c') >>> zf.writestr('b/d/e.txt', 'content of e') >>> zf.filename = 'mem/abcde.zip' Path accepts the zipfile object itself or a filename >>> path = Path(zf) From there, several path operations are available. Directory iteration (including the zip file itself): >>> a, b = path.iterdir() >>> a Path('mem/abcde.zip', 'a.txt') >>> b Path('mem/abcde.zip', 'b/') name property: >>> b.name 'b' join with divide operator: >>> c = b / 'c.txt' >>> c Path('mem/abcde.zip', 'b/c.txt') >>> c.name 'c.txt' Read text: >>> c.read_text(encoding='utf-8') 'content of c' existence: >>> c.exists() True >>> (b / 'missing.txt').exists() False Coercion to string: >>> import os >>> str(c).replace(os.sep, posixpath.sep) 'mem/abcde.zip/b/c.txt' At the root, ``name``, ``filename``, and ``parent`` resolve to the zipfile. >>> str(path) 'mem/abcde.zip/' >>> path.name 'abcde.zip' >>> path.filename == pathlib.Path('mem/abcde.zip') True >>> str(path.parent) 'mem' If the zipfile has no filename, such attributes are not valid and accessing them will raise an Exception. >>> zf.filename = None >>> path.name Traceback (most recent call last): ... TypeError: ... >>> path.filename Traceback (most recent call last): ... TypeError: ... >>> path.parent Traceback (most recent call last): ... TypeError: ... # workaround python/cpython#106763 >>> pass z>{self.__class__.__name__}({self.root.filename!r}, {self.at!r})� c C s t �|�| _|| _dS )aX Construct a Path from a ZipFile or filename. Note: When the source is an existing ZipFile object, its type (__class__) will be mutated to a specialized type. If the caller wishes to retain the original type, the caller should either create a separate ZipFile object or pass a filename. N)ri rb �root�at)r rz r{ r r r r e s z Path.__init__c C s( | j |j urtS | j| jf|j|jfkS )zU >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo' False )r" �NotImplementedrz r{ )r �otherr r r �__eq__r s z Path.__eq__c C s t | j| jf�S r )�hashrz r{ r# r r r �__hash__{ � z Path.__hash__r\ N��pwdc O s� | � � rt| ��|d }| �� s|dkrt| ��| jj| j||d�}d|v r0|s*|r.td��|S t|i |��\}}}t j ||g|�R i |��S )z� Open this entry as text or binary following the semantics of ``pathlib.Path.open()`` by passing arguments through to io.TextIOWrapper(). r r\ r� �bz*encoding args invalid for binary operation) �is_dir�IsADirectoryError�exists�FileNotFoundErrorrz �openr{ r? rx �io� TextIOWrapper)r r_ r� r r �zip_mode�streamru r r r r� ~ s z Path.openc C s t �| jp| jj�S r )�pathlib� PurePosixPathr{ rz rW r# r r r �_base� � z Path._basec C � | � � jS r )r� rA r# r r r rA � � z Path.namec C r� r )r� �suffixr# r r r r� � r� z Path.suffixc C r� r )r� �suffixesr# r r r r� � r� z Path.suffixesc C r� r )r� �stemr# r r r r� � r� z Path.stemc C s t �| jj��| j�S r )r� r rz rW �joinpathr{ r# r r r rW � s z Path.filenamec O sZ t |i |��\}}}| jd|g|�R i |��� }|�� W d � S 1 s&w Y d S )Nr\ )rx r� �read)r r r ru �strmr r r � read_text� s $�zPath.read_textc C s6 | � d�� }|�� W d � S 1 sw Y d S )N�rb)r� r� )r r� r r r � read_bytes� s $�zPath.read_bytesc C s t �|j�d��| j�d�kS �Nr8 )r rS r{ r )r r r r r � _is_child� s zPath._is_childc C s | � | j|�S r )r" rz )r r{ r r r �_next� � z Path._nextc C s | j p | j �d�S r� )r{ r@ r# r r r r� � r� z Path.is_dirc C s | � � o| �� S r )r� r� r# r r r �is_file� � z Path.is_filec C s | j | j�� v S r )r{ rz rR r# r r r r� � r� z Path.existsc C s. | � � std��t| j| j�� �}t| j|�S )NzCan't listdir a file)r� r? r/ r� rz r1 r> r� )r �subsr r r �iterdir� s z Path.iterdirc C s t �| j��|�S r )r� r� r{ �match)r � path_patternr r r r� � r� z Path.matchc C s" | j �| j�}|jd? }t�|�S )z8 Return whether this path is a symlink. � )rz rX r{ � external_attr�stat�S_ISLNK)r �infor_ r r r � is_symlink� s zPath.is_symlinkc C sb |s t d|����t�| j�}tdd�}t�||�|� �j}dd� | jj D �}t | j t ||��S )NzUnacceptable pattern: r8 )�sepsc s s � | ]}|j V qd S r rV )rH �datar r r rJ � s � z Path.glob.<locals>.<genexpr>) r? r9 �escaper{ r �compile� translate� fullmatchrz �filelistr/ r� r> )r �pattern�prefix�tr�matchesrN r r r �glob� s z Path.globc C s | � d|� ��S )Nz**/)r� )r r� r r r �rglob� r� z Path.rglobc G s t �t| �t|j|� ��S r )r �relpath�strr� )r r} �extrar r r � relative_to� s zPath.relative_toc C s t �| jj| j�S r )r r= rz rW r{ r# r r r �__str__� r� z Path.__str__c C s | j j| d�S )Nr# )� _Path__repr�formatr# r r r �__repr__� r� z Path.__repr__c G s& t j| jg|�R � }| �| j�|��S r )r r= r{ r� rz rU )r r} �nextr r r r� � s z Path.joinpathc C s6 | j s| jjS t�| j �d��}|r|d7 }| �|�S r� )r{ rW �parentr rS r r� )r � parent_atr r r r� � s z Path.parent)ry )r\ )"r( r) r* r+ r� r r~ r� r� r� �propertyrA r� r� r� rW r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� � __truediv__r� r r r r r � sJ f r )r� r rZ r rk r� r9 r� rs � compat.py310r r� r �__all__r r �dict�fromkeysrM r r r- r^ rG ri rx r r r r r �<module> s. >K _vendor/zipp/__pycache__/glob.cpython-310.pyc 0000644 00000007564 15030122015 0015017 0 ustar 00 o �h � @ sD d dl Z d dlZe jee j�ee j� ZG dd� d�Zdd� ZdS )� Nc @ s\ e Zd ZU dZeed< efdefdd�Zdd� Zdd� Z d d � Z d d � Z d d� Z dd� Z dS )� Translatorz� >>> Translator('xyz') Traceback (most recent call last): ... AssertionError: Invalid separators >>> Translator('') Traceback (most recent call last): ... AssertionError: Invalid separators �sepsc C s& |r t |�t t�ksJ d��|| _d S )NzInvalid separators)�set� _default_sepsr )�selfr � r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/zipp/glob.py�__init__ s zTranslator.__init__c C s | � | �|��S )zH Given a glob pattern, produce a regex that matches it. )�extend�translate_core�r �patternr r r � translate s zTranslator.translatec C s d|� d�S )z� Extend regex for pattern-wide concerns. Apply '(?s:)' to create a non-matching group that matches newlines (valid on Unix). Append '\Z' to imply fullmatch even when match is used. z(?s:z)\Zr r r r r r ! � zTranslator.extendc C s& | � |� d�t| jt| �|����S )a? Given a glob pattern, produce a regex that matches it. >>> t = Translator() >>> t.translate_core('*.txt').replace('\\\\', '') '[^/]*\\.txt' >>> t.translate_core('a?txt') 'a[^/]txt' >>> t.translate_core('**/*').replace('\\\\', '') '.*/[^/][^/]*' � )�restrict_rglob�join�map�replace�separate�star_not_emptyr r r r r , s zTranslator.translate_corec C sB |� d�p t�|� d���dd��ddt�| j�� d���dd �S ) zM Perform the replacements for a match from :func:`separate`. r r z\*\*z.*z\*�[^z]*z\?z[^/])�group�re�escaper r )r �matchr r r r ; s �zTranslator.replacec C s> dt �| j�� d�}t �||�}tdd� |D ��r td��dS )z� Raise ValueError if ** appears in anything but a full path segment. >>> Translator().translate('**foo') Traceback (most recent call last): ... ValueError: ** must appear alone in a path segment �[�]+c s s � | ] }d |v o |d kV qdS )z**Nr )�.0�segmentr r r � <genexpr>Q s � z,Translator.restrict_rglob.<locals>.<genexpr>z&** must appear alone in a path segmentN)r r r �split�any� ValueError)r r � seps_pattern�segmentsr r r r F s �zTranslator.restrict_rglobc C s* dd� }dt �| j�� d�}t �|||�S )z@ Ensure that * will not match an empty segment. c S s | � d�}|dkr dS |S )Nr �*z?*)r )r r r r r �handle_segmentY s z1Translator.star_not_empty.<locals>.handle_segmentr r )r r r �sub)r r r' �not_seps_patternr r r r T s zTranslator.star_not_emptyN)�__name__� __module__� __qualname__�__doc__�str�__annotations__r r r r r r r r r r r r r s r c C s t �d| �S )z� Separate out character sets to avoid translating their contents. >>> [m.group(0) for m in separate('*.txt')] ['*.txt'] >>> [m.group(0) for m in separate('a[?]txt')] ['a', '[?]', 'txt'] z+([^\[]+)|(?P<set>[\[].*?[\]])|([\[][^\]]*$))r �finditer)r r r r r a r r ) �osr �sepr. �altsep�boolr r r r r r r �<module> s Y _vendor/zipp/compat/py310.py 0000644 00000000333 15030122015 0011657 0 ustar 00 import sys import io def _text_encoding(encoding, stacklevel=2, /): # pragma: no cover return encoding text_encoding = ( io.text_encoding if sys.version_info > (3, 10) else _text_encoding # type: ignore ) _vendor/zipp/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000267 15030122015 0017107 0 ustar 00 o �h � @ s d S )N� r r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/zipp/compat/__init__.py�<module> s _vendor/zipp/compat/__pycache__/py310.cpython-310.pyc 0000644 00000000650 15030122015 0016220 0 ustar 00 o �h� � @ s6 d dl Z d dlZddd�Ze jdkrejZdS eZdS )� N� c C s | S )N� )�encoding� stacklevelr r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/zipp/compat/py310.py�_text_encoding s r )� � )r )�sys�ior � version_info� text_encodingr r r r �<module> s �� _vendor/zipp/compat/__init__.py 0000644 00000000000 15030122015 0012531 0 ustar 00 _vendor/zipp/__init__.py 0000644 00000032144 15030122015 0011264 0 ustar 00 import io import posixpath import zipfile import itertools import contextlib import pathlib import re import stat import sys from .compat.py310 import text_encoding from .glob import Translator __all__ = ['Path'] def _parents(path): """ Given a path with elements separated by posixpath.sep, generate all parents of that path. >>> list(_parents('b/d')) ['b'] >>> list(_parents('/b/d/')) ['/b'] >>> list(_parents('b/d/f/')) ['b/d', 'b'] >>> list(_parents('b')) [] >>> list(_parents('')) [] """ return itertools.islice(_ancestry(path), 1, None) def _ancestry(path): """ Given a path with elements separated by posixpath.sep, generate all elements of that path >>> list(_ancestry('b/d')) ['b/d', 'b'] >>> list(_ancestry('/b/d/')) ['/b/d', '/b'] >>> list(_ancestry('b/d/f/')) ['b/d/f', 'b/d', 'b'] >>> list(_ancestry('b')) ['b'] >>> list(_ancestry('')) [] """ path = path.rstrip(posixpath.sep) while path and path != posixpath.sep: yield path path, tail = posixpath.split(path) _dedupe = dict.fromkeys """Deduplicate an iterable in original order""" def _difference(minuend, subtrahend): """ Return items in minuend not in subtrahend, retaining order with O(1) lookup. """ return itertools.filterfalse(set(subtrahend).__contains__, minuend) class InitializedState: """ Mix-in to save the initialization state for pickling. """ def __init__(self, *args, **kwargs): self.__args = args self.__kwargs = kwargs super().__init__(*args, **kwargs) def __getstate__(self): return self.__args, self.__kwargs def __setstate__(self, state): args, kwargs = state super().__init__(*args, **kwargs) class SanitizedNames: """ ZipFile mix-in to ensure names are sanitized. """ def namelist(self): return list(map(self._sanitize, super().namelist())) @staticmethod def _sanitize(name): r""" Ensure a relative path with posix separators and no dot names. Modeled after https://github.com/python/cpython/blob/bcc1be39cb1d04ad9fc0bd1b9193d3972835a57c/Lib/zipfile/__init__.py#L1799-L1813 but provides consistent cross-platform behavior. >>> san = SanitizedNames._sanitize >>> san('/foo/bar') 'foo/bar' >>> san('//foo.txt') 'foo.txt' >>> san('foo/.././bar.txt') 'foo/bar.txt' >>> san('foo../.bar.txt') 'foo../.bar.txt' >>> san('\\foo\\bar.txt') 'foo/bar.txt' >>> san('D:\\foo.txt') 'D/foo.txt' >>> san('\\\\server\\share\\file.txt') 'server/share/file.txt' >>> san('\\\\?\\GLOBALROOT\\Volume3') '?/GLOBALROOT/Volume3' >>> san('\\\\.\\PhysicalDrive1\\root') 'PhysicalDrive1/root' Retain any trailing slash. >>> san('abc/') 'abc/' Raises a ValueError if the result is empty. >>> san('../..') Traceback (most recent call last): ... ValueError: Empty filename """ def allowed(part): return part and part not in {'..', '.'} # Remove the drive letter. # Don't use ntpath.splitdrive, because that also strips UNC paths bare = re.sub('^([A-Z]):', r'\1', name, flags=re.IGNORECASE) clean = bare.replace('\\', '/') parts = clean.split('/') joined = '/'.join(filter(allowed, parts)) if not joined: raise ValueError("Empty filename") return joined + '/' * name.endswith('/') class CompleteDirs(InitializedState, SanitizedNames, zipfile.ZipFile): """ A ZipFile subclass that ensures that implied directories are always included in the namelist. >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt'])) ['foo/', 'foo/bar/'] >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt', 'foo/bar/'])) ['foo/'] """ @staticmethod def _implied_dirs(names): parents = itertools.chain.from_iterable(map(_parents, names)) as_dirs = (p + posixpath.sep for p in parents) return _dedupe(_difference(as_dirs, names)) def namelist(self): names = super().namelist() return names + list(self._implied_dirs(names)) def _name_set(self): return set(self.namelist()) def resolve_dir(self, name): """ If the name represents a directory, return that name as a directory (with the trailing slash). """ names = self._name_set() dirname = name + '/' dir_match = name not in names and dirname in names return dirname if dir_match else name def getinfo(self, name): """ Supplement getinfo for implied dirs. """ try: return super().getinfo(name) except KeyError: if not name.endswith('/') or name not in self._name_set(): raise return zipfile.ZipInfo(filename=name) @classmethod def make(cls, source): """ Given a source (filename or zipfile), return an appropriate CompleteDirs subclass. """ if isinstance(source, CompleteDirs): return source if not isinstance(source, zipfile.ZipFile): return cls(source) # Only allow for FastLookup when supplied zipfile is read-only if 'r' not in source.mode: cls = CompleteDirs source.__class__ = cls return source @classmethod def inject(cls, zf: zipfile.ZipFile) -> zipfile.ZipFile: """ Given a writable zip file zf, inject directory entries for any directories implied by the presence of children. """ for name in cls._implied_dirs(zf.namelist()): zf.writestr(name, b"") return zf class FastLookup(CompleteDirs): """ ZipFile subclass to ensure implicit dirs exist and are resolved rapidly. """ def namelist(self): with contextlib.suppress(AttributeError): return self.__names self.__names = super().namelist() return self.__names def _name_set(self): with contextlib.suppress(AttributeError): return self.__lookup self.__lookup = super()._name_set() return self.__lookup def _extract_text_encoding(encoding=None, *args, **kwargs): # compute stack level so that the caller of the caller sees any warning. is_pypy = sys.implementation.name == 'pypy' stack_level = 3 + is_pypy return text_encoding(encoding, stack_level), args, kwargs class Path: """ A :class:`importlib.resources.abc.Traversable` interface for zip files. Implements many of the features users enjoy from :class:`pathlib.Path`. Consider a zip file with this structure:: . ├── a.txt └── b ├── c.txt └── d └── e.txt >>> data = io.BytesIO() >>> zf = zipfile.ZipFile(data, 'w') >>> zf.writestr('a.txt', 'content of a') >>> zf.writestr('b/c.txt', 'content of c') >>> zf.writestr('b/d/e.txt', 'content of e') >>> zf.filename = 'mem/abcde.zip' Path accepts the zipfile object itself or a filename >>> path = Path(zf) From there, several path operations are available. Directory iteration (including the zip file itself): >>> a, b = path.iterdir() >>> a Path('mem/abcde.zip', 'a.txt') >>> b Path('mem/abcde.zip', 'b/') name property: >>> b.name 'b' join with divide operator: >>> c = b / 'c.txt' >>> c Path('mem/abcde.zip', 'b/c.txt') >>> c.name 'c.txt' Read text: >>> c.read_text(encoding='utf-8') 'content of c' existence: >>> c.exists() True >>> (b / 'missing.txt').exists() False Coercion to string: >>> import os >>> str(c).replace(os.sep, posixpath.sep) 'mem/abcde.zip/b/c.txt' At the root, ``name``, ``filename``, and ``parent`` resolve to the zipfile. >>> str(path) 'mem/abcde.zip/' >>> path.name 'abcde.zip' >>> path.filename == pathlib.Path('mem/abcde.zip') True >>> str(path.parent) 'mem' If the zipfile has no filename, such attributes are not valid and accessing them will raise an Exception. >>> zf.filename = None >>> path.name Traceback (most recent call last): ... TypeError: ... >>> path.filename Traceback (most recent call last): ... TypeError: ... >>> path.parent Traceback (most recent call last): ... TypeError: ... # workaround python/cpython#106763 >>> pass """ __repr = "{self.__class__.__name__}({self.root.filename!r}, {self.at!r})" def __init__(self, root, at=""): """ Construct a Path from a ZipFile or filename. Note: When the source is an existing ZipFile object, its type (__class__) will be mutated to a specialized type. If the caller wishes to retain the original type, the caller should either create a separate ZipFile object or pass a filename. """ self.root = FastLookup.make(root) self.at = at def __eq__(self, other): """ >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo' False """ if self.__class__ is not other.__class__: return NotImplemented return (self.root, self.at) == (other.root, other.at) def __hash__(self): return hash((self.root, self.at)) def open(self, mode='r', *args, pwd=None, **kwargs): """ Open this entry as text or binary following the semantics of ``pathlib.Path.open()`` by passing arguments through to io.TextIOWrapper(). """ if self.is_dir(): raise IsADirectoryError(self) zip_mode = mode[0] if not self.exists() and zip_mode == 'r': raise FileNotFoundError(self) stream = self.root.open(self.at, zip_mode, pwd=pwd) if 'b' in mode: if args or kwargs: raise ValueError("encoding args invalid for binary operation") return stream # Text mode: encoding, args, kwargs = _extract_text_encoding(*args, **kwargs) return io.TextIOWrapper(stream, encoding, *args, **kwargs) def _base(self): return pathlib.PurePosixPath(self.at or self.root.filename) @property def name(self): return self._base().name @property def suffix(self): return self._base().suffix @property def suffixes(self): return self._base().suffixes @property def stem(self): return self._base().stem @property def filename(self): return pathlib.Path(self.root.filename).joinpath(self.at) def read_text(self, *args, **kwargs): encoding, args, kwargs = _extract_text_encoding(*args, **kwargs) with self.open('r', encoding, *args, **kwargs) as strm: return strm.read() def read_bytes(self): with self.open('rb') as strm: return strm.read() def _is_child(self, path): return posixpath.dirname(path.at.rstrip("/")) == self.at.rstrip("/") def _next(self, at): return self.__class__(self.root, at) def is_dir(self): return not self.at or self.at.endswith("/") def is_file(self): return self.exists() and not self.is_dir() def exists(self): return self.at in self.root._name_set() def iterdir(self): if not self.is_dir(): raise ValueError("Can't listdir a file") subs = map(self._next, self.root.namelist()) return filter(self._is_child, subs) def match(self, path_pattern): return pathlib.PurePosixPath(self.at).match(path_pattern) def is_symlink(self): """ Return whether this path is a symlink. """ info = self.root.getinfo(self.at) mode = info.external_attr >> 16 return stat.S_ISLNK(mode) def glob(self, pattern): if not pattern: raise ValueError(f"Unacceptable pattern: {pattern!r}") prefix = re.escape(self.at) tr = Translator(seps='/') matches = re.compile(prefix + tr.translate(pattern)).fullmatch names = (data.filename for data in self.root.filelist) return map(self._next, filter(matches, names)) def rglob(self, pattern): return self.glob(f'**/{pattern}') def relative_to(self, other, *extra): return posixpath.relpath(str(self), str(other.joinpath(*extra))) def __str__(self): return posixpath.join(self.root.filename, self.at) def __repr__(self): return self.__repr.format(self=self) def joinpath(self, *other): next = posixpath.join(self.at, *other) return self._next(self.root.resolve_dir(next)) __truediv__ = joinpath @property def parent(self): if not self.at: return self.filename.parent parent_at = posixpath.dirname(self.at.rstrip('/')) if parent_at: parent_at += '/' return self._next(parent_at) _vendor/tomli/_re.py 0000644 00000005577 15030122015 0010446 0 ustar 00 # SPDX-License-Identifier: MIT # SPDX-FileCopyrightText: 2021 Taneli Hukkinen # Licensed to PSF under a Contributor Agreement. from __future__ import annotations from datetime import date, datetime, time, timedelta, timezone, tzinfo from functools import lru_cache import re from typing import Any from ._types import ParseFloat # E.g. # - 00:32:00.999999 # - 00:32:00 _TIME_RE_STR = r"([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?" RE_NUMBER = re.compile( r""" 0 (?: x[0-9A-Fa-f](?:_?[0-9A-Fa-f])* # hex | b[01](?:_?[01])* # bin | o[0-7](?:_?[0-7])* # oct ) | [+-]?(?:0|[1-9](?:_?[0-9])*) # dec, integer part (?P<floatpart> (?:\.[0-9](?:_?[0-9])*)? # optional fractional part (?:[eE][+-]?[0-9](?:_?[0-9])*)? # optional exponent part ) """, flags=re.VERBOSE, ) RE_LOCALTIME = re.compile(_TIME_RE_STR) RE_DATETIME = re.compile( rf""" ([0-9]{{4}})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01]) # date, e.g. 1988-10-27 (?: [Tt ] {_TIME_RE_STR} (?:([Zz])|([+-])([01][0-9]|2[0-3]):([0-5][0-9]))? # optional time offset )? """, flags=re.VERBOSE, ) def match_to_datetime(match: re.Match) -> datetime | date: """Convert a `RE_DATETIME` match to `datetime.datetime` or `datetime.date`. Raises ValueError if the match does not correspond to a valid date or datetime. """ ( year_str, month_str, day_str, hour_str, minute_str, sec_str, micros_str, zulu_time, offset_sign_str, offset_hour_str, offset_minute_str, ) = match.groups() year, month, day = int(year_str), int(month_str), int(day_str) if hour_str is None: return date(year, month, day) hour, minute, sec = int(hour_str), int(minute_str), int(sec_str) micros = int(micros_str.ljust(6, "0")) if micros_str else 0 if offset_sign_str: tz: tzinfo | None = cached_tz( offset_hour_str, offset_minute_str, offset_sign_str ) elif zulu_time: tz = timezone.utc else: # local date-time tz = None return datetime(year, month, day, hour, minute, sec, micros, tzinfo=tz) @lru_cache(maxsize=None) def cached_tz(hour_str: str, minute_str: str, sign_str: str) -> timezone: sign = 1 if sign_str == "+" else -1 return timezone( timedelta( hours=sign * int(hour_str), minutes=sign * int(minute_str), ) ) def match_to_localtime(match: re.Match) -> time: hour_str, minute_str, sec_str, micros_str = match.groups() micros = int(micros_str.ljust(6, "0")) if micros_str else 0 return time(int(hour_str), int(minute_str), int(sec_str), micros) def match_to_number(match: re.Match, parse_float: ParseFloat) -> Any: if match.group("floatpart"): return parse_float(match.group()) return int(match.group(), 0) _vendor/tomli/_parser.py 0000644 00000054151 15030122015 0011324 0 ustar 00 # SPDX-License-Identifier: MIT # SPDX-FileCopyrightText: 2021 Taneli Hukkinen # Licensed to PSF under a Contributor Agreement. from __future__ import annotations from collections.abc import Iterable import string from types import MappingProxyType from typing import Any, BinaryIO, NamedTuple from ._re import ( RE_DATETIME, RE_LOCALTIME, RE_NUMBER, match_to_datetime, match_to_localtime, match_to_number, ) from ._types import Key, ParseFloat, Pos ASCII_CTRL = frozenset(chr(i) for i in range(32)) | frozenset(chr(127)) # Neither of these sets include quotation mark or backslash. They are # currently handled as separate cases in the parser functions. ILLEGAL_BASIC_STR_CHARS = ASCII_CTRL - frozenset("\t") ILLEGAL_MULTILINE_BASIC_STR_CHARS = ASCII_CTRL - frozenset("\t\n") ILLEGAL_LITERAL_STR_CHARS = ILLEGAL_BASIC_STR_CHARS ILLEGAL_MULTILINE_LITERAL_STR_CHARS = ILLEGAL_MULTILINE_BASIC_STR_CHARS ILLEGAL_COMMENT_CHARS = ILLEGAL_BASIC_STR_CHARS TOML_WS = frozenset(" \t") TOML_WS_AND_NEWLINE = TOML_WS | frozenset("\n") BARE_KEY_CHARS = frozenset(string.ascii_letters + string.digits + "-_") KEY_INITIAL_CHARS = BARE_KEY_CHARS | frozenset("\"'") HEXDIGIT_CHARS = frozenset(string.hexdigits) BASIC_STR_ESCAPE_REPLACEMENTS = MappingProxyType( { "\\b": "\u0008", # backspace "\\t": "\u0009", # tab "\\n": "\u000A", # linefeed "\\f": "\u000C", # form feed "\\r": "\u000D", # carriage return '\\"': "\u0022", # quote "\\\\": "\u005C", # backslash } ) class TOMLDecodeError(ValueError): """An error raised if a document is not valid TOML.""" def load(__fp: BinaryIO, *, parse_float: ParseFloat = float) -> dict[str, Any]: """Parse TOML from a binary file object.""" b = __fp.read() try: s = b.decode() except AttributeError: raise TypeError( "File must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`" ) from None return loads(s, parse_float=parse_float) def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]: # noqa: C901 """Parse TOML from a string.""" # The spec allows converting "\r\n" to "\n", even in string # literals. Let's do so to simplify parsing. src = __s.replace("\r\n", "\n") pos = 0 out = Output(NestedDict(), Flags()) header: Key = () parse_float = make_safe_parse_float(parse_float) # Parse one statement at a time # (typically means one line in TOML source) while True: # 1. Skip line leading whitespace pos = skip_chars(src, pos, TOML_WS) # 2. Parse rules. Expect one of the following: # - end of file # - end of line # - comment # - key/value pair # - append dict to list (and move to its namespace) # - create dict (and move to its namespace) # Skip trailing whitespace when applicable. try: char = src[pos] except IndexError: break if char == "\n": pos += 1 continue if char in KEY_INITIAL_CHARS: pos = key_value_rule(src, pos, out, header, parse_float) pos = skip_chars(src, pos, TOML_WS) elif char == "[": try: second_char: str | None = src[pos + 1] except IndexError: second_char = None out.flags.finalize_pending() if second_char == "[": pos, header = create_list_rule(src, pos, out) else: pos, header = create_dict_rule(src, pos, out) pos = skip_chars(src, pos, TOML_WS) elif char != "#": raise suffixed_err(src, pos, "Invalid statement") # 3. Skip comment pos = skip_comment(src, pos) # 4. Expect end of line or end of file try: char = src[pos] except IndexError: break if char != "\n": raise suffixed_err( src, pos, "Expected newline or end of document after a statement" ) pos += 1 return out.data.dict class Flags: """Flags that map to parsed keys/namespaces.""" # Marks an immutable namespace (inline array or inline table). FROZEN = 0 # Marks a nest that has been explicitly created and can no longer # be opened using the "[table]" syntax. EXPLICIT_NEST = 1 def __init__(self) -> None: self._flags: dict[str, dict] = {} self._pending_flags: set[tuple[Key, int]] = set() def add_pending(self, key: Key, flag: int) -> None: self._pending_flags.add((key, flag)) def finalize_pending(self) -> None: for key, flag in self._pending_flags: self.set(key, flag, recursive=False) self._pending_flags.clear() def unset_all(self, key: Key) -> None: cont = self._flags for k in key[:-1]: if k not in cont: return cont = cont[k]["nested"] cont.pop(key[-1], None) def set(self, key: Key, flag: int, *, recursive: bool) -> None: # noqa: A003 cont = self._flags key_parent, key_stem = key[:-1], key[-1] for k in key_parent: if k not in cont: cont[k] = {"flags": set(), "recursive_flags": set(), "nested": {}} cont = cont[k]["nested"] if key_stem not in cont: cont[key_stem] = {"flags": set(), "recursive_flags": set(), "nested": {}} cont[key_stem]["recursive_flags" if recursive else "flags"].add(flag) def is_(self, key: Key, flag: int) -> bool: if not key: return False # document root has no flags cont = self._flags for k in key[:-1]: if k not in cont: return False inner_cont = cont[k] if flag in inner_cont["recursive_flags"]: return True cont = inner_cont["nested"] key_stem = key[-1] if key_stem in cont: cont = cont[key_stem] return flag in cont["flags"] or flag in cont["recursive_flags"] return False class NestedDict: def __init__(self) -> None: # The parsed content of the TOML document self.dict: dict[str, Any] = {} def get_or_create_nest( self, key: Key, *, access_lists: bool = True, ) -> dict: cont: Any = self.dict for k in key: if k not in cont: cont[k] = {} cont = cont[k] if access_lists and isinstance(cont, list): cont = cont[-1] if not isinstance(cont, dict): raise KeyError("There is no nest behind this key") return cont def append_nest_to_list(self, key: Key) -> None: cont = self.get_or_create_nest(key[:-1]) last_key = key[-1] if last_key in cont: list_ = cont[last_key] if not isinstance(list_, list): raise KeyError("An object other than list found behind this key") list_.append({}) else: cont[last_key] = [{}] class Output(NamedTuple): data: NestedDict flags: Flags def skip_chars(src: str, pos: Pos, chars: Iterable[str]) -> Pos: try: while src[pos] in chars: pos += 1 except IndexError: pass return pos def skip_until( src: str, pos: Pos, expect: str, *, error_on: frozenset[str], error_on_eof: bool, ) -> Pos: try: new_pos = src.index(expect, pos) except ValueError: new_pos = len(src) if error_on_eof: raise suffixed_err(src, new_pos, f"Expected {expect!r}") from None if not error_on.isdisjoint(src[pos:new_pos]): while src[pos] not in error_on: pos += 1 raise suffixed_err(src, pos, f"Found invalid character {src[pos]!r}") return new_pos def skip_comment(src: str, pos: Pos) -> Pos: try: char: str | None = src[pos] except IndexError: char = None if char == "#": return skip_until( src, pos + 1, "\n", error_on=ILLEGAL_COMMENT_CHARS, error_on_eof=False ) return pos def skip_comments_and_array_ws(src: str, pos: Pos) -> Pos: while True: pos_before_skip = pos pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE) pos = skip_comment(src, pos) if pos == pos_before_skip: return pos def create_dict_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]: pos += 1 # Skip "[" pos = skip_chars(src, pos, TOML_WS) pos, key = parse_key(src, pos) if out.flags.is_(key, Flags.EXPLICIT_NEST) or out.flags.is_(key, Flags.FROZEN): raise suffixed_err(src, pos, f"Cannot declare {key} twice") out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False) try: out.data.get_or_create_nest(key) except KeyError: raise suffixed_err(src, pos, "Cannot overwrite a value") from None if not src.startswith("]", pos): raise suffixed_err(src, pos, "Expected ']' at the end of a table declaration") return pos + 1, key def create_list_rule(src: str, pos: Pos, out: Output) -> tuple[Pos, Key]: pos += 2 # Skip "[[" pos = skip_chars(src, pos, TOML_WS) pos, key = parse_key(src, pos) if out.flags.is_(key, Flags.FROZEN): raise suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}") # Free the namespace now that it points to another empty list item... out.flags.unset_all(key) # ...but this key precisely is still prohibited from table declaration out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False) try: out.data.append_nest_to_list(key) except KeyError: raise suffixed_err(src, pos, "Cannot overwrite a value") from None if not src.startswith("]]", pos): raise suffixed_err(src, pos, "Expected ']]' at the end of an array declaration") return pos + 2, key def key_value_rule( src: str, pos: Pos, out: Output, header: Key, parse_float: ParseFloat ) -> Pos: pos, key, value = parse_key_value_pair(src, pos, parse_float) key_parent, key_stem = key[:-1], key[-1] abs_key_parent = header + key_parent relative_path_cont_keys = (header + key[:i] for i in range(1, len(key))) for cont_key in relative_path_cont_keys: # Check that dotted key syntax does not redefine an existing table if out.flags.is_(cont_key, Flags.EXPLICIT_NEST): raise suffixed_err(src, pos, f"Cannot redefine namespace {cont_key}") # Containers in the relative path can't be opened with the table syntax or # dotted key/value syntax in following table sections. out.flags.add_pending(cont_key, Flags.EXPLICIT_NEST) if out.flags.is_(abs_key_parent, Flags.FROZEN): raise suffixed_err( src, pos, f"Cannot mutate immutable namespace {abs_key_parent}" ) try: nest = out.data.get_or_create_nest(abs_key_parent) except KeyError: raise suffixed_err(src, pos, "Cannot overwrite a value") from None if key_stem in nest: raise suffixed_err(src, pos, "Cannot overwrite a value") # Mark inline table and array namespaces recursively immutable if isinstance(value, (dict, list)): out.flags.set(header + key, Flags.FROZEN, recursive=True) nest[key_stem] = value return pos def parse_key_value_pair( src: str, pos: Pos, parse_float: ParseFloat ) -> tuple[Pos, Key, Any]: pos, key = parse_key(src, pos) try: char: str | None = src[pos] except IndexError: char = None if char != "=": raise suffixed_err(src, pos, "Expected '=' after a key in a key/value pair") pos += 1 pos = skip_chars(src, pos, TOML_WS) pos, value = parse_value(src, pos, parse_float) return pos, key, value def parse_key(src: str, pos: Pos) -> tuple[Pos, Key]: pos, key_part = parse_key_part(src, pos) key: Key = (key_part,) pos = skip_chars(src, pos, TOML_WS) while True: try: char: str | None = src[pos] except IndexError: char = None if char != ".": return pos, key pos += 1 pos = skip_chars(src, pos, TOML_WS) pos, key_part = parse_key_part(src, pos) key += (key_part,) pos = skip_chars(src, pos, TOML_WS) def parse_key_part(src: str, pos: Pos) -> tuple[Pos, str]: try: char: str | None = src[pos] except IndexError: char = None if char in BARE_KEY_CHARS: start_pos = pos pos = skip_chars(src, pos, BARE_KEY_CHARS) return pos, src[start_pos:pos] if char == "'": return parse_literal_str(src, pos) if char == '"': return parse_one_line_basic_str(src, pos) raise suffixed_err(src, pos, "Invalid initial character for a key part") def parse_one_line_basic_str(src: str, pos: Pos) -> tuple[Pos, str]: pos += 1 return parse_basic_str(src, pos, multiline=False) def parse_array(src: str, pos: Pos, parse_float: ParseFloat) -> tuple[Pos, list]: pos += 1 array: list = [] pos = skip_comments_and_array_ws(src, pos) if src.startswith("]", pos): return pos + 1, array while True: pos, val = parse_value(src, pos, parse_float) array.append(val) pos = skip_comments_and_array_ws(src, pos) c = src[pos : pos + 1] if c == "]": return pos + 1, array if c != ",": raise suffixed_err(src, pos, "Unclosed array") pos += 1 pos = skip_comments_and_array_ws(src, pos) if src.startswith("]", pos): return pos + 1, array def parse_inline_table(src: str, pos: Pos, parse_float: ParseFloat) -> tuple[Pos, dict]: pos += 1 nested_dict = NestedDict() flags = Flags() pos = skip_chars(src, pos, TOML_WS) if src.startswith("}", pos): return pos + 1, nested_dict.dict while True: pos, key, value = parse_key_value_pair(src, pos, parse_float) key_parent, key_stem = key[:-1], key[-1] if flags.is_(key, Flags.FROZEN): raise suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}") try: nest = nested_dict.get_or_create_nest(key_parent, access_lists=False) except KeyError: raise suffixed_err(src, pos, "Cannot overwrite a value") from None if key_stem in nest: raise suffixed_err(src, pos, f"Duplicate inline table key {key_stem!r}") nest[key_stem] = value pos = skip_chars(src, pos, TOML_WS) c = src[pos : pos + 1] if c == "}": return pos + 1, nested_dict.dict if c != ",": raise suffixed_err(src, pos, "Unclosed inline table") if isinstance(value, (dict, list)): flags.set(key, Flags.FROZEN, recursive=True) pos += 1 pos = skip_chars(src, pos, TOML_WS) def parse_basic_str_escape( src: str, pos: Pos, *, multiline: bool = False ) -> tuple[Pos, str]: escape_id = src[pos : pos + 2] pos += 2 if multiline and escape_id in {"\\ ", "\\\t", "\\\n"}: # Skip whitespace until next non-whitespace character or end of # the doc. Error if non-whitespace is found before newline. if escape_id != "\\\n": pos = skip_chars(src, pos, TOML_WS) try: char = src[pos] except IndexError: return pos, "" if char != "\n": raise suffixed_err(src, pos, "Unescaped '\\' in a string") pos += 1 pos = skip_chars(src, pos, TOML_WS_AND_NEWLINE) return pos, "" if escape_id == "\\u": return parse_hex_char(src, pos, 4) if escape_id == "\\U": return parse_hex_char(src, pos, 8) try: return pos, BASIC_STR_ESCAPE_REPLACEMENTS[escape_id] except KeyError: raise suffixed_err(src, pos, "Unescaped '\\' in a string") from None def parse_basic_str_escape_multiline(src: str, pos: Pos) -> tuple[Pos, str]: return parse_basic_str_escape(src, pos, multiline=True) def parse_hex_char(src: str, pos: Pos, hex_len: int) -> tuple[Pos, str]: hex_str = src[pos : pos + hex_len] if len(hex_str) != hex_len or not HEXDIGIT_CHARS.issuperset(hex_str): raise suffixed_err(src, pos, "Invalid hex value") pos += hex_len hex_int = int(hex_str, 16) if not is_unicode_scalar_value(hex_int): raise suffixed_err(src, pos, "Escaped character is not a Unicode scalar value") return pos, chr(hex_int) def parse_literal_str(src: str, pos: Pos) -> tuple[Pos, str]: pos += 1 # Skip starting apostrophe start_pos = pos pos = skip_until( src, pos, "'", error_on=ILLEGAL_LITERAL_STR_CHARS, error_on_eof=True ) return pos + 1, src[start_pos:pos] # Skip ending apostrophe def parse_multiline_str(src: str, pos: Pos, *, literal: bool) -> tuple[Pos, str]: pos += 3 if src.startswith("\n", pos): pos += 1 if literal: delim = "'" end_pos = skip_until( src, pos, "'''", error_on=ILLEGAL_MULTILINE_LITERAL_STR_CHARS, error_on_eof=True, ) result = src[pos:end_pos] pos = end_pos + 3 else: delim = '"' pos, result = parse_basic_str(src, pos, multiline=True) # Add at maximum two extra apostrophes/quotes if the end sequence # is 4 or 5 chars long instead of just 3. if not src.startswith(delim, pos): return pos, result pos += 1 if not src.startswith(delim, pos): return pos, result + delim pos += 1 return pos, result + (delim * 2) def parse_basic_str(src: str, pos: Pos, *, multiline: bool) -> tuple[Pos, str]: if multiline: error_on = ILLEGAL_MULTILINE_BASIC_STR_CHARS parse_escapes = parse_basic_str_escape_multiline else: error_on = ILLEGAL_BASIC_STR_CHARS parse_escapes = parse_basic_str_escape result = "" start_pos = pos while True: try: char = src[pos] except IndexError: raise suffixed_err(src, pos, "Unterminated string") from None if char == '"': if not multiline: return pos + 1, result + src[start_pos:pos] if src.startswith('"""', pos): return pos + 3, result + src[start_pos:pos] pos += 1 continue if char == "\\": result += src[start_pos:pos] pos, parsed_escape = parse_escapes(src, pos) result += parsed_escape start_pos = pos continue if char in error_on: raise suffixed_err(src, pos, f"Illegal character {char!r}") pos += 1 def parse_value( # noqa: C901 src: str, pos: Pos, parse_float: ParseFloat ) -> tuple[Pos, Any]: try: char: str | None = src[pos] except IndexError: char = None # IMPORTANT: order conditions based on speed of checking and likelihood # Basic strings if char == '"': if src.startswith('"""', pos): return parse_multiline_str(src, pos, literal=False) return parse_one_line_basic_str(src, pos) # Literal strings if char == "'": if src.startswith("'''", pos): return parse_multiline_str(src, pos, literal=True) return parse_literal_str(src, pos) # Booleans if char == "t": if src.startswith("true", pos): return pos + 4, True if char == "f": if src.startswith("false", pos): return pos + 5, False # Arrays if char == "[": return parse_array(src, pos, parse_float) # Inline tables if char == "{": return parse_inline_table(src, pos, parse_float) # Dates and times datetime_match = RE_DATETIME.match(src, pos) if datetime_match: try: datetime_obj = match_to_datetime(datetime_match) except ValueError as e: raise suffixed_err(src, pos, "Invalid date or datetime") from e return datetime_match.end(), datetime_obj localtime_match = RE_LOCALTIME.match(src, pos) if localtime_match: return localtime_match.end(), match_to_localtime(localtime_match) # Integers and "normal" floats. # The regex will greedily match any type starting with a decimal # char, so needs to be located after handling of dates and times. number_match = RE_NUMBER.match(src, pos) if number_match: return number_match.end(), match_to_number(number_match, parse_float) # Special floats first_three = src[pos : pos + 3] if first_three in {"inf", "nan"}: return pos + 3, parse_float(first_three) first_four = src[pos : pos + 4] if first_four in {"-inf", "+inf", "-nan", "+nan"}: return pos + 4, parse_float(first_four) raise suffixed_err(src, pos, "Invalid value") def suffixed_err(src: str, pos: Pos, msg: str) -> TOMLDecodeError: """Return a `TOMLDecodeError` where error message is suffixed with coordinates in source.""" def coord_repr(src: str, pos: Pos) -> str: if pos >= len(src): return "end of document" line = src.count("\n", 0, pos) + 1 if line == 1: column = pos + 1 else: column = pos - src.rindex("\n", 0, pos) return f"line {line}, column {column}" return TOMLDecodeError(f"{msg} (at {coord_repr(src, pos)})") def is_unicode_scalar_value(codepoint: int) -> bool: return (0 <= codepoint <= 55295) or (57344 <= codepoint <= 1114111) def make_safe_parse_float(parse_float: ParseFloat) -> ParseFloat: """A decorator to make `parse_float` safe. `parse_float` must not return dicts or lists, because these types would be mixed with parsed TOML tables and arrays, thus confusing the parser. The returned decorated callable raises `ValueError` instead of returning illegal types. """ # The default `float` callable never returns illegal types. Optimize it. if parse_float is float: # type: ignore[comparison-overlap] return float def safe_parse_float(float_str: str) -> Any: float_value = parse_float(float_str) if isinstance(float_value, (dict, list)): raise ValueError("parse_float must not return dicts or lists") return float_value return safe_parse_float _vendor/tomli/__pycache__/_parser.cpython-310.pyc 0000644 00000041241 15030122015 0015657 0 ustar 00 o �hiX � @ s\ d dl mZ d dlmZ d dlZd dlmZ d dlmZm Z m Z ddl m Z m Z mZmZmZmZ ddlmZmZmZ ed d � ed �D ��eed ��B Zeed � Zeed� ZeZ eZ eZ ed�Z e ed�B Z eej!ej" d �Z#e#ed�B Z$eej%�Z&edd dddddd��Z'G dd� de(�Z)e*d�dwd"d#�Z+e*d�dxd&d'�Z,G d(d)� d)�Z-G d*d+� d+�Z.G d,d-� d-e �Z/dyd3d4�Z0dzd:d;�Z1d{d<d=�Z2d{d>d?�Z3d|dBdC�Z4d|dDdE�Z5d}dHdI�Z6d~dKdL�Z7ddMdN�Z8d�dPdQ�Z9d�dRdS�Z:d�dUdV�Z;d�dXdY�Z<dZd[�d�d]d^�Z=d�d_d`�Z>d�dcdd�Z?d�dedf�Z@d�dhdi�ZAd�djdk�ZBd�dmdn�ZCd�dpdq�ZDd�dsdt�ZEd�dudv�ZFdS )�� )� annotations)�IterableN)�MappingProxyType)�Any�BinaryIO� NamedTuple� )� RE_DATETIME� RE_LOCALTIME� RE_NUMBER�match_to_datetime�match_to_localtime�match_to_number)�Key� ParseFloat�Posc c s � | ]}t |�V qd S �N)�chr��.0�i� r �S/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/tomli/_parser.py� <genexpr> s � r � � � z z � z-_z"'�� � �"�\)z\bz\tz\nz\fz\rz\"z\\c @ s e Zd ZdZdS )�TOMLDecodeErrorz0An error raised if a document is not valid TOML.N)�__name__� __module__� __qualname__�__doc__r r r r r# 5 s r# �� parse_float�__fpr r) r �return�dict[str, Any]c C s: | � � }z|�� }W n ty td�d�w t||d�S )z%Parse TOML from a binary file object.zEFile must be opened in binary mode, e.g. use `open('foo.toml', 'rb')`Nr( )�read�decode�AttributeError� TypeError�loads)r* r) �b�sr r r �load9 s ��� r4 �__s�strc C sj | � dd�}d}tt� t� �}d}t|�} t||t�}z|| }W n ty. Y |jjS w |dkr8|d7 }q|tv rKt |||||�}t||t�}nC|dkr�z||d }W n tyb d}Y nw |j � � |dkrut |||�\}}nt |||�\}}t||t�}n |d kr�t||d ��t||�}z|| }W n ty� Y |jjS w |dkr�t||d ��|d7 }q) zParse TOML from a string.z r r r Tr �[N�#zInvalid statementz5Expected newline or end of document after a statement)�replace�Output� NestedDict�Flags�make_safe_parse_float� skip_chars�TOML_WS� IndexError�KEY_INITIAL_CHARS�key_value_rule�flags�finalize_pending�create_list_rule�create_dict_rule� suffixed_err� skip_comment�data�dict)r5 r) �src�pos�out�header�char� second_charr r r r1 E sZ #� � ���r1 c @ sT e Zd ZdZdZdZddd�Zdd d �Zddd�Zddd�Z d dd�Z d dd�Z dS ) r< z)Flags that map to parsed keys/namespaces.r r r+ �Nonec C s i | _ t� | _d S r )�_flags�set�_pending_flags��selfr r r �__init__� s zFlags.__init__�keyr �flag�intc C s | j �||f� d S r )rT �add�rV rX rY r r r � add_pending� s zFlags.add_pendingc C s. | j D ] \}}| j||dd� q| j �� d S )NF�� recursive)rT rS �clearr\ r r r rD � s zFlags.finalize_pendingc C sF | j }|d d� D ]}||vr d S || d }q |�|d d � d S )N����nested)rR �pop)rV rX �cont�kr r r � unset_all� s zFlags.unset_allr_ �boolc C s� | j }|d d� |d }}|D ]}||vr t� t� i d�||< || d }q||vr5t� t� i d�||< || |r<dnd �|� d S )Nra )rC �recursive_flagsrb rb rh rC )rR rS r[ )rV rX rY r_ rd � key_parent�key_stemre r r r rS � s z Flags.setc C s� |sdS | j }|d d� D ]}||vr dS || }||d v r# dS |d }q |d }||v r@|| }||d v p?||d v S dS )NFra rh Trb rC )rR )rV rX rY rd re � inner_contrj r r r �is_� s z Flags.is_N�r+ rQ )rX r rY rZ r+ rQ �rX r r+ rQ )rX r rY rZ r_ rg r+ rQ )rX r rY rZ r+ rg ) r$ r% r& r' �FROZEN� EXPLICIT_NESTrW r] rD rf rS rl r r r r r< � s r< c @ s0 e Zd Zddd�Zdd�dd d �Zddd�ZdS )r; r+ rQ c C s i | _ d S r )rJ rU r r r rW � s zNestedDict.__init__T�� access_listsrX r rr rg rJ c C sT | j }|D ]"}||vri ||< || }|r t|t�r |d }t|t �s'td��q|S )Nra z There is no nest behind this key)rJ � isinstance�list�KeyError)rV rX rr rd re r r r �get_or_create_nest� s �z NestedDict.get_or_create_nestc C sX | � |d d� �}|d }||v r%|| }t|t�s td��|�i � d S i g||< d S )Nra z/An object other than list found behind this key)rv rs rt ru �append)rV rX rd �last_key�list_r r r �append_nest_to_list� s z NestedDict.append_nest_to_listNrm )rX r rr rg r+ rJ rn )r$ r% r& rW rv rz r r r r r; � s �r; c @ s e Zd ZU ded< ded< dS )r: r; rI r< rC N)r$ r% r& �__annotations__r r r r r: � s r: rK rL r �chars� Iterable[str]c C sB z| | |v r|d7 }| | |v sW |S W |S t y Y |S w )Nr )r@ )rK rL r| r r r r> � s �� ��r> �expect�error_on�frozenset[str]� error_on_eofrg c C s� z| � ||�}W n ty! t| �}|r t| |d|���d �Y nw |�| ||� �sF| | |vr;|d7 }| | |vs1t| |d| | ����|S )Nz Expected r zFound invalid character )�index� ValueError�lenrG � isdisjoint)rK rL r~ r r� �new_posr r r � skip_until� s �� �r� c C sF z| | }W n t y d }Y nw |dkr!t| |d dtdd�S |S )Nr8 r r F�r r� )r@ r� �ILLEGAL_COMMENT_CHARS)rK rL rO r r r rH s ��rH c C s* |}t | |t�}t| |�}||kr|S qr )r> �TOML_WS_AND_NEWLINErH )rK rL �pos_before_skipr r r �skip_comments_and_array_ws s �r� rM �tuple[Pos, Key]c C s� |d7 }t | |t�}t| |�\}}|j�|tj�s!|j�|tj�r+t| |d|� d���|jj |tjdd� z|j � |� W n t yK t| |d�d �w | � d|�sXt| |d��|d |fS ) Nr zCannot declare z twiceFr^ �Cannot overwrite a value�]z.Expected ']' at the end of a table declaration)r> r? � parse_keyrC rl r< rp ro rG rS rI rv ru � startswith�rK rL rM rX r r r rF s � rF c C s� |d7 }t | |t�}t| |�\}}|j�|tj�r"t| |d|� ���|j�|� |jj |tj dd� z|j � |� W n t yH t| |d�d �w | �d|�sUt| |d��|d |fS )N� �"Cannot mutate immutable namespace Fr^ r� z]]z0Expected ']]' at the end of an array declaration)r> r? r� rC rl r< ro rG rf rS rp rI rz ru r� r� r r r rE . s � rE rN r c s t | ||�\}�}�d d� �d }}� | }� �fdd�tdt���D �} | D ]} |j�| tj�r<t| |d| � ���|j�| tj� q)|j�|tj �rVt| |d|� ���z|j � |�} W n t yl t| |d�d �w || v rwt| |d��t |ttf�r�|jj� � tj dd � || |< |S ) Nra c 3 s � | ] }� �d |� V qd S r r r �rN rX r r r J s � z!key_value_rule.<locals>.<genexpr>r zCannot redefine namespace r� r� Tr^ )�parse_key_value_pair�ranger� rC rl r< rp rG r] ro rI rv ru rs rJ rt rS ) rK rL rM rN r) �valueri rj �abs_key_parent�relative_path_cont_keys�cont_key�nestr r� r rB C s. � � rB �tuple[Pos, Key, Any]c C st t | |�\}}z| | }W n ty d }Y nw |dkr#t| |d��|d7 }t| |t�}t| ||�\}}|||fS )N�=z,Expected '=' after a key in a key/value pairr )r� r@ rG r> r? � parse_value)rK rL r) rX rO r� r r r r� e s � r� c C s� t | |�\}}|f}t| |t�} z| | }W n ty" d }Y nw |dkr+||fS |d7 }t| |t�}t | |�\}}||f7 }t| |t�}q)NT�.r )�parse_key_partr> r? r@ )rK rL �key_partrX rO r r r r� u s" � �r� �tuple[Pos, str]c C s| z| | }W n t y d }Y nw |tv r&|}t| |t�}|| ||� fS |dkr/t| |�S |dkr8t| |�S t| |d��)N�'r! z(Invalid initial character for a key part)r@ �BARE_KEY_CHARSr> �parse_literal_str�parse_one_line_basic_strrG )rK rL rO � start_posr r r r� � s � r� c C s |d7 }t | |dd�S )Nr F�� multiline)�parse_basic_str�rK rL r r r r� � s r� �tuple[Pos, list]c C s� |d7 }g }t | |�}| �d|�r|d |fS t| ||�\}}|�|� t | |�}| ||d � }|dkr<|d |fS |dkrFt| |d��|d7 }t | |�}| �d|�r[|d |fS q)Nr r� T�,zUnclosed array)r� r� r� rw rG )rK rL r) �array�val�cr r r � parse_array� s& �r� �tuple[Pos, dict]c C sR |d7 }t � }t� }t| |t�}| �d|�r |d |jfS t| ||�\}}}|d d� |d }}|�|tj�rBt | |d|� ���z |j |dd�} W n t yY t | |d�d �w || v rgt | |d |����|| |< t| |t�}| ||d � } | dkr�|d |jfS | d kr�t | |d ��t |tt f�r�|j|tjdd � |d7 }t| |t�}q ) Nr �}Tra r� Frq r� zDuplicate inline table key r� zUnclosed inline tabler^ )r; r< r> r? r� rJ r� rl ro rG rv ru rs rt rS ) rK rL r) � nested_dictrC rX r� ri rj r� r� r r r �parse_inline_table� s< � �r� Fr� r� c C s� | ||d � }|d7 }|rH|dv rH|dkr>t | |t�}z| | }W n ty/ |df Y S w |dkr:t| |d��|d7 }t | |t�}|dfS |dkrRt| |d �S |d kr\t| |d �S z|t| fW S tyq t| |d�d �w ) Nr� > �\ �\ �\ r� � r zUnescaped '\' in a stringr z\u� z\U� )r> r? r@ rG r� �parse_hex_char� BASIC_STR_ESCAPE_REPLACEMENTSru )rK rL r� � escape_idrO r r r �parse_basic_str_escape� s0 � �r� c C s t | |dd�S )NTr� )r� r� r r r � parse_basic_str_escape_multiline� s r� �hex_lenrZ c C sd | ||| � }t |�|kst�|�st| |d��||7 }t|d�}t|�s,t| |d��|t|�fS )NzInvalid hex value� z/Escaped character is not a Unicode scalar value)r� �HEXDIGIT_CHARS� issupersetrG rZ �is_unicode_scalar_valuer )rK rL r� �hex_str�hex_intr r r r� � s r� c C s2 |d7 }|}t | |dtdd�}|d | ||� fS )Nr r� Tr� )r� �ILLEGAL_LITERAL_STR_CHARS)rK rL r� r r r r� s �r� �literalc C s� |d7 }| � d|�r|d7 }|r&d}t| |dtdd�}| ||� }|d }n d}t| |dd �\}}| � ||�s;||fS |d7 }| � ||�sK||| fS |d7 }|||d fS ) N� r r r� �'''Tr� r! r� r� )r� r� �#ILLEGAL_MULTILINE_LITERAL_STR_CHARSr� )rK rL r� �delim�end_pos�resultr r r �parse_multiline_str s. � r� c C s� |rt }t}nt}t}d}|} z| | }W n ty$ t| |d�d �w |dkrN|s7|d || ||� fS | �d|�rI|d || ||� fS |d7 }q|dkrh|| ||� 7 }|| |�\}}||7 }|}q||v rut| |d |����|d7 }q) Nr� TzUnterminated stringr! r �"""r� r" zIllegal character )�!ILLEGAL_MULTILINE_BASIC_STR_CHARSr� �ILLEGAL_BASIC_STR_CHARSr� r@ rG r� ) rK rL r� r � parse_escapesr� r� rO � parsed_escaper r r r� ( s< � �r� �tuple[Pos, Any]c C s� z| | }W n t y d }Y nw |dkr(| �d|�r#t| |dd�S t| |�S |dkr>| �d|�r9t| |dd�S t| |�S |dkrN| �d |�rN|d dfS |d kr^| �d |�r^|d dfS |dkrht| ||�S |dkrrt| ||�S t�| |�}|r�zt |�}W n t y� } zt | |d�|�d }~ww |� � |fS t �| |�}|r�|� � t|�fS t�| |�}|r�|� � t||�fS | ||d � } | dv r�|d || �fS | ||d � } | dv r�|d || �fS t | |d��)Nr! r� F)r� r� r� T�t�truer� �f�false� r7 �{zInvalid date or datetimer� > �inf�nan> �+inf�+nan�-inf�-nanz Invalid value)r@ r� r� r� r� r� r� r �matchr r� rG �endr r r r ) rK rL r) rO �datetime_match� datetime_obj�e�localtime_match� number_match� first_three� first_fourr r r r� H sZ � �� r� �msgc C s$ d dd�}t |� d|| |�� d ��S ) zZReturn a `TOMLDecodeError` where error message is suffixed with coordinates in source.rK r6 rL r r+ c S sV |t | �krdS | �dd|�d }|dkr|d }n || �dd|� }d|� d|� �S )Nzend of documentr r r zline z , column )r� �count�rindex)rK rL �line�columnr r r � coord_repr� s z suffixed_err.<locals>.coord_reprz (at �)N)rK r6 rL r r+ r6 )r# )rK rL r� r� r r r rG � s rG � codepointc C s0 d| ko dkn pd| kodkS S )Nr i�� i � i�� r )r� r r r r� � s 0r� c s � t u rt S d� fdd� }|S ) a% A decorator to make `parse_float` safe. `parse_float` must not return dicts or lists, because these types would be mixed with parsed TOML tables and arrays, thus confusing the parser. The returned decorated callable raises `ValueError` instead of returning illegal types. � float_strr6 r+ r c s" � | �}t |ttf�rtd��|S )Nz*parse_float must not return dicts or lists)rs rJ rt r� )r� � float_valuer( r r �safe_parse_float� s z/make_safe_parse_float.<locals>.safe_parse_floatN)r� r6 r+ r )�float)r) r� r r( r r= � s r= )r* r r) r r+ r, )r5 r6 r) r r+ r, )rK r6 rL r r| r} r+ r ) rK r6 rL r r~ r6 r r� r� rg r+ r )rK r6 rL r r+ r )rK r6 rL r rM r: r+ r� ) rK r6 rL r rM r: rN r r) r r+ r )rK r6 rL r r) r r+ r� )rK r6 rL r r+ r� )rK r6 rL r r+ r� )rK r6 rL r r) r r+ r� )rK r6 rL r r) r r+ r� )rK r6 rL r r� rg r+ r� )rK r6 rL r r� rZ r+ r� )rK r6 rL r r� rg r+ r� )rK r6 rL r r) r r+ r� )rK r6 rL r r� r6 r+ r# )r� rZ r+ rg )r) r r+ r )G� __future__r �collections.abcr �string�typesr �typingr r r �_rer r r r r r �_typesr r r � frozensetr� r � ASCII_CTRLr� r� r� r� r� r? r� � ascii_letters�digitsr� rA � hexdigitsr� r� r� r# r� r4 r1 r< r; r: r> r� rH r� rF rE rB r� r� r� r� r� r� r� r� r� r� r� r� r� rG r� r= r r r r �<module> st " �� B:" " !� D _vendor/tomli/__pycache__/__init__.cpython-310.pyc 0000644 00000000527 15030122015 0015765 0 ustar 00 o �h� � @ s& d Z dZddlmZmZmZ ee_dS ))�loads�load�TOMLDecodeErrorz2.0.1� )r r r N)�__all__� __version__�_parserr r r �__name__� __module__� r r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/tomli/__init__.py�<module> s _vendor/tomli/__pycache__/_types.cpython-310.pyc 0000644 00000000471 15030122015 0015527 0 ustar 00 o �h� � @ s6 d dl mZmZmZ eegef Zeedf ZeZdS )� )�Any�Callable�Tuple.N) �typingr r r �str� ParseFloat�Key�int�Pos� r r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/tomli/_types.py�<module> s _vendor/tomli/__pycache__/_re.cpython-310.pyc 0000644 00000005511 15030122015 0014771 0 ustar 00 o �h � @ s� d dl mZ d dlmZmZmZmZmZmZ d dlm Z d dl Z d dl m Z ddl mZ dZe jd e jd �Ze �e�Ze jd e� d �e jd �Zd#dd�Ze dd�d$dd��Zd%d d �Zd&d!d"�ZdS )'� )� annotations)�date�datetime�time� timedelta�timezone�tzinfo)� lru_cacheN)�Any� )� ParseFloatzE([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?a` 0 (?: x[0-9A-Fa-f](?:_?[0-9A-Fa-f])* # hex | b[01](?:_?[01])* # bin | o[0-7](?:_?[0-7])* # oct ) | [+-]?(?:0|[1-9](?:_?[0-9])*) # dec, integer part (?P<floatpart> (?:\.[0-9](?:_?[0-9])*)? # optional fractional part (?:[eE][+-]?[0-9](?:_?[0-9])*)? # optional exponent part ) )�flagsz` ([0-9]{4})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01]) # date, e.g. 1988-10-27 (?: [Tt ] zR (?:([Zz])|([+-])([01][0-9]|2[0-3]):([0-5][0-9]))? # optional time offset )? �match�re.Match�return�datetime | datec C s� | � � \ }}}}}}}}} } } t|�t|�t|�} } }|du r't| | |�S t|�t|�t|�}}}|r?t|�dd��nd}| rJt| | | �}n|rPtj}nd}t| | ||||||d�S )z�Convert a `RE_DATETIME` match to `datetime.datetime` or `datetime.date`. Raises ValueError if the match does not correspond to a valid date or datetime. N� �0r )r )�groups�intr �ljust� cached_tzr �utcr )r �year_str� month_str�day_str�hour_str� minute_str�sec_str� micros_str� zulu_time�offset_sign_str�offset_hour_str�offset_minute_str�year�month�day�hour�minute�sec�micros�tz� r, �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/tomli/_re.py�match_to_datetime4 s4 � �r. )�maxsizer �strr �sign_strr c C s0 |dkrdnd}t t|t| � |t|� d��S )N�+r ���)�hours�minutes)r r r )r r r1 �signr, r, r- r W s ��r r c C sB | � � \}}}}|rt|�dd��nd}tt|�t|�t|�|�S )Nr r r )r r r r )r r r r r r* r, r, r- �match_to_localtimeb s r7 � parse_floatr r c C s$ | � d�r || � � �S t| � � d�S )N� floatpartr )�groupr )r r8 r, r, r- �match_to_numberh s r; )r r r r )r r0 r r0 r1 r0 r r )r r r r )r r r8 r r r )� __future__r r r r r r r � functoolsr �re�typingr �_typesr � _TIME_RE_STR�compile�VERBOSE� RE_NUMBER� RE_LOCALTIME� RE_DATETIMEr. r r7 r; r, r, r, r- �<module> s. � �� # _vendor/tomli/_types.py 0000644 00000000376 15030122015 0011174 0 ustar 00 # SPDX-License-Identifier: MIT # SPDX-FileCopyrightText: 2021 Taneli Hukkinen # Licensed to PSF under a Contributor Agreement. from typing import Any, Callable, Tuple # Type annotations ParseFloat = Callable[[str], Any] Key = Tuple[str, ...] Pos = int _vendor/tomli/py.typed 0000644 00000000032 15030122015 0011003 0 ustar 00 # Marker file for PEP 561 _vendor/tomli/__init__.py 0000644 00000000614 15030122015 0011423 0 ustar 00 # SPDX-License-Identifier: MIT # SPDX-FileCopyrightText: 2021 Taneli Hukkinen # Licensed to PSF under a Contributor Agreement. __all__ = ("loads", "load", "TOMLDecodeError") __version__ = "2.0.1" # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT from ._parser import TOMLDecodeError, load, loads # Pretend this exception was created here. TOMLDecodeError.__module__ = __name__ _vendor/jaraco/context.py 0000644 00000022520 15030122015 0011463 0 ustar 00 from __future__ import annotations import contextlib import functools import operator import os import shutil import subprocess import sys import tempfile import urllib.request import warnings from typing import Iterator if sys.version_info < (3, 12): from backports import tarfile else: import tarfile @contextlib.contextmanager def pushd(dir: str | os.PathLike) -> Iterator[str | os.PathLike]: """ >>> tmp_path = getfixture('tmp_path') >>> with pushd(tmp_path): ... assert os.getcwd() == os.fspath(tmp_path) >>> assert os.getcwd() != os.fspath(tmp_path) """ orig = os.getcwd() os.chdir(dir) try: yield dir finally: os.chdir(orig) @contextlib.contextmanager def tarball( url, target_dir: str | os.PathLike | None = None ) -> Iterator[str | os.PathLike]: """ Get a tarball, extract it, yield, then clean up. >>> import urllib.request >>> url = getfixture('tarfile_served') >>> target = getfixture('tmp_path') / 'out' >>> tb = tarball(url, target_dir=target) >>> import pathlib >>> with tb as extracted: ... contents = pathlib.Path(extracted, 'contents.txt').read_text(encoding='utf-8') >>> assert not os.path.exists(extracted) """ if target_dir is None: target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '') # In the tar command, use --strip-components=1 to strip the first path and # then # use -C to cause the files to be extracted to {target_dir}. This ensures # that we always know where the files were extracted. os.mkdir(target_dir) try: req = urllib.request.urlopen(url) with tarfile.open(fileobj=req, mode='r|*') as tf: tf.extractall(path=target_dir, filter=strip_first_component) yield target_dir finally: shutil.rmtree(target_dir) def strip_first_component( member: tarfile.TarInfo, path, ) -> tarfile.TarInfo: _, member.name = member.name.split('/', 1) return member def _compose(*cmgrs): """ Compose any number of dependent context managers into a single one. The last, innermost context manager may take arbitrary arguments, but each successive context manager should accept the result from the previous as a single parameter. Like :func:`jaraco.functools.compose`, behavior works from right to left, so the context manager should be indicated from outermost to innermost. Example, to create a context manager to change to a temporary directory: >>> temp_dir_as_cwd = _compose(pushd, temp_dir) >>> with temp_dir_as_cwd() as dir: ... assert os.path.samefile(os.getcwd(), dir) """ def compose_two(inner, outer): def composed(*args, **kwargs): with inner(*args, **kwargs) as saved, outer(saved) as res: yield res return contextlib.contextmanager(composed) return functools.reduce(compose_two, reversed(cmgrs)) tarball_cwd = _compose(pushd, tarball) @contextlib.contextmanager def tarball_context(*args, **kwargs): warnings.warn( "tarball_context is deprecated. Use tarball or tarball_cwd instead.", DeprecationWarning, stacklevel=2, ) pushd_ctx = kwargs.pop('pushd', pushd) with tarball(*args, **kwargs) as tball, pushd_ctx(tball) as dir: yield dir def infer_compression(url): """ Given a URL or filename, infer the compression code for tar. >>> infer_compression('http://foo/bar.tar.gz') 'z' >>> infer_compression('http://foo/bar.tgz') 'z' >>> infer_compression('file.bz') 'j' >>> infer_compression('file.xz') 'J' """ warnings.warn( "infer_compression is deprecated with no replacement", DeprecationWarning, stacklevel=2, ) # cheat and just assume it's the last two characters compression_indicator = url[-2:] mapping = dict(gz='z', bz='j', xz='J') # Assume 'z' (gzip) if no match return mapping.get(compression_indicator, 'z') @contextlib.contextmanager def temp_dir(remover=shutil.rmtree): """ Create a temporary directory context. Pass a custom remover to override the removal behavior. >>> import pathlib >>> with temp_dir() as the_dir: ... assert os.path.isdir(the_dir) ... _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents', encoding='utf-8') >>> assert not os.path.exists(the_dir) """ temp_dir = tempfile.mkdtemp() try: yield temp_dir finally: remover(temp_dir) @contextlib.contextmanager def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir): """ Check out the repo indicated by url. If dest_ctx is supplied, it should be a context manager to yield the target directory for the check out. """ exe = 'git' if 'git' in url else 'hg' with dest_ctx() as repo_dir: cmd = [exe, 'clone', url, repo_dir] if branch: cmd.extend(['--branch', branch]) devnull = open(os.path.devnull, 'w') stdout = devnull if quiet else None subprocess.check_call(cmd, stdout=stdout) yield repo_dir def null(): """ A null context suitable to stand in for a meaningful context. >>> with null() as value: ... assert value is None This context is most useful when dealing with two or more code branches but only some need a context. Wrap the others in a null context to provide symmetry across all options. """ warnings.warn( "null is deprecated. Use contextlib.nullcontext", DeprecationWarning, stacklevel=2, ) return contextlib.nullcontext() class ExceptionTrap: """ A context manager that will catch certain exceptions and provide an indication they occurred. >>> with ExceptionTrap() as trap: ... raise Exception() >>> bool(trap) True >>> with ExceptionTrap() as trap: ... pass >>> bool(trap) False >>> with ExceptionTrap(ValueError) as trap: ... raise ValueError("1 + 1 is not 3") >>> bool(trap) True >>> trap.value ValueError('1 + 1 is not 3') >>> trap.tb <traceback object at ...> >>> with ExceptionTrap(ValueError) as trap: ... raise Exception() Traceback (most recent call last): ... Exception >>> bool(trap) False """ exc_info = None, None, None def __init__(self, exceptions=(Exception,)): self.exceptions = exceptions def __enter__(self): return self @property def type(self): return self.exc_info[0] @property def value(self): return self.exc_info[1] @property def tb(self): return self.exc_info[2] def __exit__(self, *exc_info): type = exc_info[0] matches = type and issubclass(type, self.exceptions) if matches: self.exc_info = exc_info return matches def __bool__(self): return bool(self.type) def raises(self, func, *, _test=bool): """ Wrap func and replace the result with the truth value of the trap (True if an exception occurred). First, give the decorator an alias to support Python 3.8 Syntax. >>> raises = ExceptionTrap(ValueError).raises Now decorate a function that always fails. >>> @raises ... def fail(): ... raise ValueError('failed') >>> fail() True """ @functools.wraps(func) def wrapper(*args, **kwargs): with ExceptionTrap(self.exceptions) as trap: func(*args, **kwargs) return _test(trap) return wrapper def passes(self, func): """ Wrap func and replace the result with the truth value of the trap (True if no exception). First, give the decorator an alias to support Python 3.8 Syntax. >>> passes = ExceptionTrap(ValueError).passes Now decorate a function that always fails. >>> @passes ... def fail(): ... raise ValueError('failed') >>> fail() False """ return self.raises(func, _test=operator.not_) class suppress(contextlib.suppress, contextlib.ContextDecorator): """ A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() """ class on_interrupt(contextlib.ContextDecorator): """ Replace a KeyboardInterrupt with SystemExit(1) >>> def do_interrupt(): ... raise KeyboardInterrupt() >>> on_interrupt('error')(do_interrupt)() Traceback (most recent call last): ... SystemExit: 1 >>> on_interrupt('error', code=255)(do_interrupt)() Traceback (most recent call last): ... SystemExit: 255 >>> on_interrupt('suppress')(do_interrupt)() >>> with __import__('pytest').raises(KeyboardInterrupt): ... on_interrupt('ignore')(do_interrupt)() """ def __init__(self, action='error', /, code=1): self.action = action self.code = code def __enter__(self): return self def __exit__(self, exctype, excinst, exctb): if exctype is not KeyboardInterrupt or self.action == 'ignore': return elif self.action == 'error': raise SystemExit(self.code) from excinst return self.action == 'suppress' _vendor/jaraco/functools/__pycache__/__init__.cpython-310.pyc 0000644 00000045454 15030122015 0020124 0 ustar 00 o �hA � @ sJ d dl Zd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z dd� Z dd� Z e� � fdd�Z dd � Zd d � Zd d � Zdd� ZG dd� d�Zdd� Zedd� ej�Zdd� d dfdd�Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zddd$�d%d&�Z d'd(� Z e d)�d*d+�Z d,d-� Z ej d.d/� �Z!e!j"d0ej#j$fd1d2��Z%d3d4� Z&dS )5� Nc G s dd� }t �|| �S )a; Compose any number of unary functions into a single unary function. >>> import textwrap >>> expected = str.strip(textwrap.dedent(compose.__doc__)) >>> strip_and_dedent = compose(str.strip, textwrap.dedent) >>> strip_and_dedent(compose.__doc__) == expected True Compose also allows the innermost function to take arbitrary arguments. >>> round_three = lambda x: round(x, ndigits=3) >>> f = compose(round_three, int.__truediv__) >>> [f(3*x, x+1) for x in range(1,10)] [1.5, 2.0, 2.25, 2.4, 2.5, 2.571, 2.625, 2.667, 2.7] c s � �fdd�S )Nc s � �| i |���S �N� ��args�kwargs��f1�f2r �_/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/functools/__init__.py�<lambda> s z.compose.<locals>.compose_two.<locals>.<lambda>r r r r r � compose_two s z compose.<locals>.compose_two)� functools�reduce)�funcsr r r r �compose s r c s* t �� �� �fdd����fdd��_�S )ad Decorate func so it's only ever called the first time. This decorator can ensure that an expensive or non-idempotent function will not be expensive on subsequent calls and is idempotent. >>> add_three = once(lambda a: a+3) >>> add_three(3) 6 >>> add_three(9) 6 >>> add_three('12') 6 To reset the stored value, simply clear the property ``saved_result``. >>> del add_three.saved_result >>> add_three(9) 12 >>> add_three(8) 12 Or invoke 'reset()' on it. >>> add_three.reset() >>> add_three(-3) 0 >>> add_three(0) 0 c s t �d�s � | i |���_�jS �N� saved_result)�hasattrr r ��func�wrapperr r r E s zonce.<locals>.wrapperc s t � ��d�S r )�vars� __delitem__r )r r r r K s zonce.<locals>.<lambda>)r �wraps�reset�r r r r �once% s r c s& � �fdd�}dd� |_ t�� �p|S )aV Wrap lru_cache to support storing the cache data in the object instances. Abstracts the common paradigm where the method explicitly saves an underscore-prefixed protected property on first call and returns that subsequently. >>> class MyClass: ... calls = 0 ... ... @method_cache ... def method(self, value): ... self.calls += 1 ... return value >>> a = MyClass() >>> a.method(3) 3 >>> for x in range(75): ... res = a.method(x) >>> a.calls 75 Note that the apparent behavior will be exactly like that of lru_cache except that the cache is stored on each instance, so values in one instance will not flush values from another, and when an instance is deleted, so are the cached values for that instance. >>> b = MyClass() >>> for x in range(35): ... res = b.method(x) >>> b.calls 35 >>> a.method(0) 0 >>> a.calls 75 Note that if method had been decorated with ``functools.lru_cache()``, a.calls would have been 76 (due to the cached value of 0 having been flushed by the 'b' instance). Clear the cache with ``.cache_clear()`` >>> a.method.cache_clear() Same for a method that hasn't yet been called. >>> c = MyClass() >>> c.method.cache_clear() Another cache wrapper may be supplied: >>> cache = functools.lru_cache(maxsize=2) >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) >>> a = MyClass() >>> a.method2() 3 Caution - do not subsequently wrap the method with another decorator, such as ``@property``, which changes the semantics of the function. See also http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ for another implementation and additional justification. c s0 t ��| �}� |�}t| �j|� ||i |��S r )�types� MethodType�setattr�__name__)�selfr r � bound_method� cached_method�� cache_wrapper�methodr r r � s z method_cache.<locals>.wrapperc S � d S r r r r r r r � � z method_cache.<locals>.<lambda>)� cache_clear�_special_method_cache)r& r% r r r$ r � method_cacheO s D r+ c s2 �j }d}||vr dS d| �� ��fdd�}|S )a: Because Python treats special methods differently, it's not possible to use instance attributes to implement the cached methods. Instead, install the wrapper method under a different name and return a simple proxy to that wrapper. https://github.com/jaraco/jaraco.functools/issues/5 )� __getattr__� __getitem__N�__cachedc sF �t | �vrt��| �}� |�}t| �|� nt| ��}||i |��S r )r r r r �getattr)r! r r �bound�cache�r% r& � wrapper_namer r �proxy� s z$_special_method_cache.<locals>.proxy)r )r& r% �name� special_namesr4 r r2 r r* � s r* c � � fdd�}|S )ab Decorate a function with a transform function that is invoked on results returned from the decorated function. >>> @apply(reversed) ... def get_numbers(start): ... "doc for get_numbers" ... return range(start, start+3) >>> list(get_numbers(4)) [6, 5, 4] >>> get_numbers.__doc__ 'doc for get_numbers' c s t �| �t� | ��S r )r r r r �� transformr r �wrap� s zapply.<locals>.wrapr )r9 r: r r8 r �apply� s r; c r7 )a@ Decorate a function with an action function that is invoked on the results returned from the decorated function (for its side effect), then return the original result. >>> @result_invoke(print) ... def add_two(a, b): ... return a + b >>> x = add_two(2, 3) 5 >>> x 5 c s t �� ��� fdd��}|S )Nc s �| i |��}� |� |S r r )r r �result)�actionr r r r � s z,result_invoke.<locals>.wrap.<locals>.wrapper�r r r �r= r r r: � s zresult_invoke.<locals>.wrapr )r= r: r r? r � result_invoke� s r@ c O s | |i |�� | S )a� Call a function for its side effect after initialization. The benefit of using the decorator instead of simply invoking a function after defining it is that it makes explicit the author's intent for the function to be called immediately. Whereas if one simply calls the function immediately, it's less obvious if that was intentional or incidental. It also avoids repeating the name - the two actions, defining the function and calling it immediately are modeled separately, but linked by the decorator construct. The benefit of having a function construct (opposed to just invoking some behavior inline) is to serve as a scope in which the behavior occurs. It avoids polluting the global namespace with local variables, provides an anchor on which to attach documentation (docstring), keeps the behavior logically separated (instead of conceptually separated or not separated at all), and provides potential to re-use the behavior for testing or other purposes. This function is named as a pithy way to communicate, "call this function primarily for its side effect", or "while defining this function, also take it aside and call it". It exists because there's no Python construct for "define and call" (nor should there be, as decorators serve this need just fine). The behavior happens immediately and synchronously. >>> @invoke ... def func(): print("called") called >>> func() called Use functools.partial to pass parameters to the initial call >>> @functools.partial(invoke, name='bingo') ... def func(name): print('called with', name) called with bingo r )�fr r r r r �invoke� s &rB c @ sB e Zd ZdZed�fdd�Zdd� Zdd� Zd d � Zdd d �Z d S )� Throttlerz*Rate-limit a function (or other callable).�Infc C s( t |t�r|j}|| _|| _| �� d S r )� isinstancerC r �max_rater )r! r rF r r r �__init__ s zThrottler.__init__c C s d| _ d S )Nr )� last_called)r! r r r r $ s zThrottler.resetc O s | � � | j|i |��S r )�_waitr )r! r r r r r �__call__' s zThrottler.__call__c C s: t � � | j }d| j | }t �td|�� t � � | _dS )z2Ensure at least 1/max_rate seconds from last call.� r N)�timerH rF �sleep�max)r! �elapsed� must_waitr r r rI + s zThrottler._waitNc C s t | jt�| j|��S r )� first_invokerI r �partialr )r! �obj�ownerr r r �__get__2 s zThrottler.__get__r ) r � __module__� __qualname__�__doc__�floatrG r rJ rI rU r r r r rC s rC c � � �fdd�}|S )z� Return a function that when invoked will invoke func1 without any parameters (for its side effect) and then invoke func2 with whatever parameters were passed, returning its result. c s � � �| i |��S r r r ��func1�func2r r r = s z first_invoke.<locals>.wrapperr )r\ r] r r r[ r rQ 6 s rQ c C s t jdtdd�S )NzS`jaraco.functools.method_caller` is deprecated, use `operator.methodcaller` instead� )� stacklevel)�warnings�warn�DeprecationWarningr r r r r E s �r c C r' r r r r r r r O r( r c C sP |t d�kr t�� nt|�}|D ]}z| � W S |y$ |� Y qw | � S )z� Given a callable func, trap the indicated exceptions for up to 'retries' times, invoking cleanup on the exception. On the final attempt, allow any exceptions to propagate. �inf)rY � itertools�count�range)r �cleanup�retries�trap�attempts�_r r r � retry_callO s �rl c rZ )a7 Decorator wrapper for retry_call. Accepts arguments to retry_call except func and then returns a decorator for the decorated function. Ex: >>> @retry(retries=3) ... def my_func(a, b): ... "this is my funk" ... print(a, b) >>> my_func.__doc__ 'this is my funk' c s t �� �� ��fdd��}|S )Nc s. t j� g| �R i |��}t|g��R i ���S r )r rR rl )�f_args�f_kwargsr0 )r �r_args�r_kwargsr r r p s z(retry.<locals>.decorate.<locals>.wrapperr> r �ro rp r r �decorateo s zretry.<locals>.decorater )ro rp rr r rq r �retry` s rs c C s( t �tt�}ttj|| �}t �| �|�S )z� Convert a generator into a function that prints all yielded elements. >>> @print_yielded ... def x(): ... yield 3; yield None >>> x() 3 None )r rR �map�printr �more_itertools�consumer )r � print_all� print_resultsr r r � print_yieldedz s rz c s t �� �� fdd��}|S )z� Wrap func so it's not called if its first param is None. >>> print_text = pass_none(print) >>> print_text('text') text >>> print_text(None) c s" | d ur� | g|�R i |��S d S r r )�paramr r r r r r � s zpass_none.<locals>.wrapperr> r r r r � pass_none� s r| c s8 t �| �}|j�� }� fdd�|D �}tj| fi |��S )a� Assign parameters from namespace where func solicits. >>> def func(x, y=3): ... print(x, y) >>> assigned = assign_params(func, dict(x=2, z=4)) >>> assigned() 2 3 The usual errors are raised if a function doesn't receive its required parameters: >>> assigned = assign_params(func, dict(y=3, z=4)) >>> assigned() Traceback (most recent call last): TypeError: func() ...argument... It even works on methods: >>> class Handler: ... def meth(self, arg): ... print(arg) >>> assign_params(Handler().meth, dict(arg='crystal', foo='clear'))() crystal c s i | ] }|� v r|� | �qS r r )�.0�k�� namespacer r � <dictcomp>� s z!assign_params.<locals>.<dictcomp>)�inspect� signature� parameters�keysr rR )r r� �sig�params�call_nsr r r � assign_params� s r� c s( t �dd�� t���� �fdd��}|S )a& Wrap a method such that when it is called, the args and kwargs are saved on the method. >>> class MyClass: ... @save_method_args ... def method(self, a, b): ... print(a, b) >>> my_ob = MyClass() >>> my_ob.method(1, 2) 1 2 >>> my_ob._saved_method.args (1, 2) >>> my_ob._saved_method.kwargs {} >>> my_ob.method(a=3, b='foo') 3 foo >>> my_ob._saved_method.args () >>> my_ob._saved_method.kwargs == dict(a=3, b='foo') True The arguments are stored on the instance, allowing for different instance to save different args. >>> your_ob = MyClass() >>> your_ob.method({str('x'): 3}, b=[4]) {'x': 3} [4] >>> your_ob._saved_method.args ({'x': 3},) >>> my_ob._saved_method.args () �args_and_kwargsz args kwargsc s6 d�j }� ||�}t| ||� �| g|�R i |��S )N�_saved_)r r )r! r r � attr_name�attr�r� r& r r r � s z!save_method_args.<locals>.wrapper)� collections� namedtupler r )r& r r r� r �save_method_args� s "r� )�replace�usec s � ��fdd�}|S )a- Replace the indicated exceptions, if raised, with the indicated literal replacement or evaluated expression (if present). >>> safe_int = except_(ValueError)(int) >>> safe_int('five') >>> safe_int('5') 5 Specify a literal replacement with ``replace``. >>> safe_int_r = except_(ValueError, replace=0)(int) >>> safe_int_r('five') 0 Provide an expression to ``use`` to pass through particular parameters. >>> safe_int_pt = except_(ValueError, use='args[0]')(int) >>> safe_int_pt('five') 'five' c s t �� ��� ��fdd��}|S )Nc sJ z�| i |��W S � y$ zt ��W Y S ty# � Y Y S w w r )�eval� TypeErrorr )� exceptionsr r� r� r r r s ��z*except_.<locals>.decorate.<locals>.wrapperr> r �r� r� r� r r rr s zexcept_.<locals>.decorater )r� r� r� rr r r� r �except_� s r� c C s | S )zV Return the argument. >>> o = object() >>> identity(o) is o True r )�xr r r �identity s r� ��_opc rZ )a Decorate a function to return its parameter when ``check``. >>> bypassed = [] # False >>> @bypass_when(bypassed) ... def double(x): ... return x * 2 >>> double(2) 4 >>> bypassed[:] = [object()] # True >>> double(2) 2 c s t �� ���� fdd��}|S )Nc s � ��r| S �| �S r r )r{ )r� �checkr r r r / s z.bypass_when.<locals>.decorate.<locals>.wrapperr> r �r� r� r r rr . s z bypass_when.<locals>.decorater )r� r� rr r r� r � bypass_when s r� c C s t | tjd�S )a Decorate a function to return its parameter unless ``check``. >>> enabled = [object()] # True >>> @bypass_unless(enabled) ... def double(x): ... return x * 2 >>> double(2) 4 >>> del enabled[:] # False >>> double(2) 2 r� )r� �operator�not_)r� r r r � bypass_unless8 s r� c C s || � S )zSplat args to func.r �r r r r r � _splat_innerJ s r� r c C s |di | ��S )z Splat kargs to func as kwargs.Nr r r� r r r rk P s rk c C s t �| �t jt| d��S )a� Wrap func to expect its parameters to be passed positionally in a tuple. Has a similar effect to that of ``itertools.starmap`` over simple ``map``. >>> pairs = [(-1, 1), (0, 2)] >>> more_itertools.consume(itertools.starmap(print, pairs)) -1 1 0 2 >>> more_itertools.consume(map(splat(print), pairs)) -1 1 0 2 The approach generalizes to other iterators that don't have a "star" equivalent, such as a "starfilter". >>> list(filter(splat(operator.add), pairs)) [(0, 2)] Splat also accepts a mapping argument. >>> def is_nice(msg, code): ... return "smile" in msg or code == 0 >>> msgs = [ ... dict(msg='smile!', code=20), ... dict(msg='error :(', code=1), ... dict(msg='unknown', code=0), ... ] >>> for msg in filter(splat(is_nice), msgs): ... print(msg) {'msg': 'smile!', 'code': 20} {'msg': 'unknown', 'code': 0} r )r r rR r� r r r r �splatV s #r� )'�collections.abcr� r r� rd r� rL r r` rv r r � lru_cacher+ r* r; r@ rB rC rQ � methodcaller� method_callerrl rs rz r| r� r� r� r� r� r� �singledispatchr� �register�abc�Mappingrk r� r r r r �<module> sJ *Q * � .( _vendor/jaraco/functools/__init__.pyi 0000644 00000007446 15030122015 0013735 0 ustar 00 from collections.abc import Callable, Hashable, Iterator from functools import partial from operator import methodcaller import sys from typing import ( Any, Generic, Protocol, TypeVar, overload, ) if sys.version_info >= (3, 10): from typing import Concatenate, ParamSpec else: from typing_extensions import Concatenate, ParamSpec _P = ParamSpec('_P') _R = TypeVar('_R') _T = TypeVar('_T') _R1 = TypeVar('_R1') _R2 = TypeVar('_R2') _V = TypeVar('_V') _S = TypeVar('_S') _R_co = TypeVar('_R_co', covariant=True) class _OnceCallable(Protocol[_P, _R]): saved_result: _R reset: Callable[[], None] def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ... class _ProxyMethodCacheWrapper(Protocol[_R_co]): cache_clear: Callable[[], None] def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... class _MethodCacheWrapper(Protocol[_R_co]): def cache_clear(self) -> None: ... def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... # `compose()` overloads below will cover most use cases. @overload def compose( __func1: Callable[[_R], _T], __func2: Callable[_P, _R], /, ) -> Callable[_P, _T]: ... @overload def compose( __func1: Callable[[_R], _T], __func2: Callable[[_R1], _R], __func3: Callable[_P, _R1], /, ) -> Callable[_P, _T]: ... @overload def compose( __func1: Callable[[_R], _T], __func2: Callable[[_R2], _R], __func3: Callable[[_R1], _R2], __func4: Callable[_P, _R1], /, ) -> Callable[_P, _T]: ... def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ... def method_cache( method: Callable[..., _R], cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ..., ) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ... def apply( transform: Callable[[_R], _T] ) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ... def result_invoke( action: Callable[[_R], Any] ) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ... def invoke( f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs ) -> Callable[_P, _R]: ... class Throttler(Generic[_R]): last_called: float func: Callable[..., _R] max_rate: float def __init__( self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ... ) -> None: ... def reset(self) -> None: ... def __call__(self, *args: Any, **kwargs: Any) -> _R: ... def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ... def first_invoke( func1: Callable[..., Any], func2: Callable[_P, _R] ) -> Callable[_P, _R]: ... method_caller: Callable[..., methodcaller] def retry_call( func: Callable[..., _R], cleanup: Callable[..., None] = ..., retries: int | float = ..., trap: type[BaseException] | tuple[type[BaseException], ...] = ..., ) -> _R: ... def retry( cleanup: Callable[..., None] = ..., retries: int | float = ..., trap: type[BaseException] | tuple[type[BaseException], ...] = ..., ) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ... def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ... def pass_none( func: Callable[Concatenate[_T, _P], _R] ) -> Callable[Concatenate[_T, _P], _R]: ... def assign_params( func: Callable[..., _R], namespace: dict[str, Any] ) -> partial[_R]: ... def save_method_args( method: Callable[Concatenate[_S, _P], _R] ) -> Callable[Concatenate[_S, _P], _R]: ... def except_( *exceptions: type[BaseException], replace: Any = ..., use: Any = ... ) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ... def identity(x: _T) -> _T: ... def bypass_when( check: _V, *, _op: Callable[[_V], Any] = ... ) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... def bypass_unless( check: Any, ) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... _vendor/jaraco/functools/py.typed 0000644 00000000000 15030122015 0013125 0 ustar 00 _vendor/jaraco/functools/__init__.py 0000644 00000040402 15030122015 0013551 0 ustar 00 import collections.abc import functools import inspect import itertools import operator import time import types import warnings import more_itertools def compose(*funcs): """ Compose any number of unary functions into a single unary function. >>> import textwrap >>> expected = str.strip(textwrap.dedent(compose.__doc__)) >>> strip_and_dedent = compose(str.strip, textwrap.dedent) >>> strip_and_dedent(compose.__doc__) == expected True Compose also allows the innermost function to take arbitrary arguments. >>> round_three = lambda x: round(x, ndigits=3) >>> f = compose(round_three, int.__truediv__) >>> [f(3*x, x+1) for x in range(1,10)] [1.5, 2.0, 2.25, 2.4, 2.5, 2.571, 2.625, 2.667, 2.7] """ def compose_two(f1, f2): return lambda *args, **kwargs: f1(f2(*args, **kwargs)) return functools.reduce(compose_two, funcs) def once(func): """ Decorate func so it's only ever called the first time. This decorator can ensure that an expensive or non-idempotent function will not be expensive on subsequent calls and is idempotent. >>> add_three = once(lambda a: a+3) >>> add_three(3) 6 >>> add_three(9) 6 >>> add_three('12') 6 To reset the stored value, simply clear the property ``saved_result``. >>> del add_three.saved_result >>> add_three(9) 12 >>> add_three(8) 12 Or invoke 'reset()' on it. >>> add_three.reset() >>> add_three(-3) 0 >>> add_three(0) 0 """ @functools.wraps(func) def wrapper(*args, **kwargs): if not hasattr(wrapper, 'saved_result'): wrapper.saved_result = func(*args, **kwargs) return wrapper.saved_result wrapper.reset = lambda: vars(wrapper).__delitem__('saved_result') return wrapper def method_cache(method, cache_wrapper=functools.lru_cache()): """ Wrap lru_cache to support storing the cache data in the object instances. Abstracts the common paradigm where the method explicitly saves an underscore-prefixed protected property on first call and returns that subsequently. >>> class MyClass: ... calls = 0 ... ... @method_cache ... def method(self, value): ... self.calls += 1 ... return value >>> a = MyClass() >>> a.method(3) 3 >>> for x in range(75): ... res = a.method(x) >>> a.calls 75 Note that the apparent behavior will be exactly like that of lru_cache except that the cache is stored on each instance, so values in one instance will not flush values from another, and when an instance is deleted, so are the cached values for that instance. >>> b = MyClass() >>> for x in range(35): ... res = b.method(x) >>> b.calls 35 >>> a.method(0) 0 >>> a.calls 75 Note that if method had been decorated with ``functools.lru_cache()``, a.calls would have been 76 (due to the cached value of 0 having been flushed by the 'b' instance). Clear the cache with ``.cache_clear()`` >>> a.method.cache_clear() Same for a method that hasn't yet been called. >>> c = MyClass() >>> c.method.cache_clear() Another cache wrapper may be supplied: >>> cache = functools.lru_cache(maxsize=2) >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) >>> a = MyClass() >>> a.method2() 3 Caution - do not subsequently wrap the method with another decorator, such as ``@property``, which changes the semantics of the function. See also http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ for another implementation and additional justification. """ def wrapper(self, *args, **kwargs): # it's the first call, replace the method with a cached, bound method bound_method = types.MethodType(method, self) cached_method = cache_wrapper(bound_method) setattr(self, method.__name__, cached_method) return cached_method(*args, **kwargs) # Support cache clear even before cache has been created. wrapper.cache_clear = lambda: None return _special_method_cache(method, cache_wrapper) or wrapper def _special_method_cache(method, cache_wrapper): """ Because Python treats special methods differently, it's not possible to use instance attributes to implement the cached methods. Instead, install the wrapper method under a different name and return a simple proxy to that wrapper. https://github.com/jaraco/jaraco.functools/issues/5 """ name = method.__name__ special_names = '__getattr__', '__getitem__' if name not in special_names: return None wrapper_name = '__cached' + name def proxy(self, /, *args, **kwargs): if wrapper_name not in vars(self): bound = types.MethodType(method, self) cache = cache_wrapper(bound) setattr(self, wrapper_name, cache) else: cache = getattr(self, wrapper_name) return cache(*args, **kwargs) return proxy def apply(transform): """ Decorate a function with a transform function that is invoked on results returned from the decorated function. >>> @apply(reversed) ... def get_numbers(start): ... "doc for get_numbers" ... return range(start, start+3) >>> list(get_numbers(4)) [6, 5, 4] >>> get_numbers.__doc__ 'doc for get_numbers' """ def wrap(func): return functools.wraps(func)(compose(transform, func)) return wrap def result_invoke(action): r""" Decorate a function with an action function that is invoked on the results returned from the decorated function (for its side effect), then return the original result. >>> @result_invoke(print) ... def add_two(a, b): ... return a + b >>> x = add_two(2, 3) 5 >>> x 5 """ def wrap(func): @functools.wraps(func) def wrapper(*args, **kwargs): result = func(*args, **kwargs) action(result) return result return wrapper return wrap def invoke(f, /, *args, **kwargs): """ Call a function for its side effect after initialization. The benefit of using the decorator instead of simply invoking a function after defining it is that it makes explicit the author's intent for the function to be called immediately. Whereas if one simply calls the function immediately, it's less obvious if that was intentional or incidental. It also avoids repeating the name - the two actions, defining the function and calling it immediately are modeled separately, but linked by the decorator construct. The benefit of having a function construct (opposed to just invoking some behavior inline) is to serve as a scope in which the behavior occurs. It avoids polluting the global namespace with local variables, provides an anchor on which to attach documentation (docstring), keeps the behavior logically separated (instead of conceptually separated or not separated at all), and provides potential to re-use the behavior for testing or other purposes. This function is named as a pithy way to communicate, "call this function primarily for its side effect", or "while defining this function, also take it aside and call it". It exists because there's no Python construct for "define and call" (nor should there be, as decorators serve this need just fine). The behavior happens immediately and synchronously. >>> @invoke ... def func(): print("called") called >>> func() called Use functools.partial to pass parameters to the initial call >>> @functools.partial(invoke, name='bingo') ... def func(name): print('called with', name) called with bingo """ f(*args, **kwargs) return f class Throttler: """Rate-limit a function (or other callable).""" def __init__(self, func, max_rate=float('Inf')): if isinstance(func, Throttler): func = func.func self.func = func self.max_rate = max_rate self.reset() def reset(self): self.last_called = 0 def __call__(self, *args, **kwargs): self._wait() return self.func(*args, **kwargs) def _wait(self): """Ensure at least 1/max_rate seconds from last call.""" elapsed = time.time() - self.last_called must_wait = 1 / self.max_rate - elapsed time.sleep(max(0, must_wait)) self.last_called = time.time() def __get__(self, obj, owner=None): return first_invoke(self._wait, functools.partial(self.func, obj)) def first_invoke(func1, func2): """ Return a function that when invoked will invoke func1 without any parameters (for its side effect) and then invoke func2 with whatever parameters were passed, returning its result. """ def wrapper(*args, **kwargs): func1() return func2(*args, **kwargs) return wrapper method_caller = first_invoke( lambda: warnings.warn( '`jaraco.functools.method_caller` is deprecated, ' 'use `operator.methodcaller` instead', DeprecationWarning, stacklevel=3, ), operator.methodcaller, ) def retry_call(func, cleanup=lambda: None, retries=0, trap=()): """ Given a callable func, trap the indicated exceptions for up to 'retries' times, invoking cleanup on the exception. On the final attempt, allow any exceptions to propagate. """ attempts = itertools.count() if retries == float('inf') else range(retries) for _ in attempts: try: return func() except trap: cleanup() return func() def retry(*r_args, **r_kwargs): """ Decorator wrapper for retry_call. Accepts arguments to retry_call except func and then returns a decorator for the decorated function. Ex: >>> @retry(retries=3) ... def my_func(a, b): ... "this is my funk" ... print(a, b) >>> my_func.__doc__ 'this is my funk' """ def decorate(func): @functools.wraps(func) def wrapper(*f_args, **f_kwargs): bound = functools.partial(func, *f_args, **f_kwargs) return retry_call(bound, *r_args, **r_kwargs) return wrapper return decorate def print_yielded(func): """ Convert a generator into a function that prints all yielded elements. >>> @print_yielded ... def x(): ... yield 3; yield None >>> x() 3 None """ print_all = functools.partial(map, print) print_results = compose(more_itertools.consume, print_all, func) return functools.wraps(func)(print_results) def pass_none(func): """ Wrap func so it's not called if its first param is None. >>> print_text = pass_none(print) >>> print_text('text') text >>> print_text(None) """ @functools.wraps(func) def wrapper(param, /, *args, **kwargs): if param is not None: return func(param, *args, **kwargs) return None return wrapper def assign_params(func, namespace): """ Assign parameters from namespace where func solicits. >>> def func(x, y=3): ... print(x, y) >>> assigned = assign_params(func, dict(x=2, z=4)) >>> assigned() 2 3 The usual errors are raised if a function doesn't receive its required parameters: >>> assigned = assign_params(func, dict(y=3, z=4)) >>> assigned() Traceback (most recent call last): TypeError: func() ...argument... It even works on methods: >>> class Handler: ... def meth(self, arg): ... print(arg) >>> assign_params(Handler().meth, dict(arg='crystal', foo='clear'))() crystal """ sig = inspect.signature(func) params = sig.parameters.keys() call_ns = {k: namespace[k] for k in params if k in namespace} return functools.partial(func, **call_ns) def save_method_args(method): """ Wrap a method such that when it is called, the args and kwargs are saved on the method. >>> class MyClass: ... @save_method_args ... def method(self, a, b): ... print(a, b) >>> my_ob = MyClass() >>> my_ob.method(1, 2) 1 2 >>> my_ob._saved_method.args (1, 2) >>> my_ob._saved_method.kwargs {} >>> my_ob.method(a=3, b='foo') 3 foo >>> my_ob._saved_method.args () >>> my_ob._saved_method.kwargs == dict(a=3, b='foo') True The arguments are stored on the instance, allowing for different instance to save different args. >>> your_ob = MyClass() >>> your_ob.method({str('x'): 3}, b=[4]) {'x': 3} [4] >>> your_ob._saved_method.args ({'x': 3},) >>> my_ob._saved_method.args () """ args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs') @functools.wraps(method) def wrapper(self, /, *args, **kwargs): attr_name = '_saved_' + method.__name__ attr = args_and_kwargs(args, kwargs) setattr(self, attr_name, attr) return method(self, *args, **kwargs) return wrapper def except_(*exceptions, replace=None, use=None): """ Replace the indicated exceptions, if raised, with the indicated literal replacement or evaluated expression (if present). >>> safe_int = except_(ValueError)(int) >>> safe_int('five') >>> safe_int('5') 5 Specify a literal replacement with ``replace``. >>> safe_int_r = except_(ValueError, replace=0)(int) >>> safe_int_r('five') 0 Provide an expression to ``use`` to pass through particular parameters. >>> safe_int_pt = except_(ValueError, use='args[0]')(int) >>> safe_int_pt('five') 'five' """ def decorate(func): @functools.wraps(func) def wrapper(*args, **kwargs): try: return func(*args, **kwargs) except exceptions: try: return eval(use) except TypeError: return replace return wrapper return decorate def identity(x): """ Return the argument. >>> o = object() >>> identity(o) is o True """ return x def bypass_when(check, *, _op=identity): """ Decorate a function to return its parameter when ``check``. >>> bypassed = [] # False >>> @bypass_when(bypassed) ... def double(x): ... return x * 2 >>> double(2) 4 >>> bypassed[:] = [object()] # True >>> double(2) 2 """ def decorate(func): @functools.wraps(func) def wrapper(param, /): return param if _op(check) else func(param) return wrapper return decorate def bypass_unless(check): """ Decorate a function to return its parameter unless ``check``. >>> enabled = [object()] # True >>> @bypass_unless(enabled) ... def double(x): ... return x * 2 >>> double(2) 4 >>> del enabled[:] # False >>> double(2) 2 """ return bypass_when(check, _op=operator.not_) @functools.singledispatch def _splat_inner(args, func): """Splat args to func.""" return func(*args) @_splat_inner.register def _(args: collections.abc.Mapping, func): """Splat kargs to func as kwargs.""" return func(**args) def splat(func): """ Wrap func to expect its parameters to be passed positionally in a tuple. Has a similar effect to that of ``itertools.starmap`` over simple ``map``. >>> pairs = [(-1, 1), (0, 2)] >>> more_itertools.consume(itertools.starmap(print, pairs)) -1 1 0 2 >>> more_itertools.consume(map(splat(print), pairs)) -1 1 0 2 The approach generalizes to other iterators that don't have a "star" equivalent, such as a "starfilter". >>> list(filter(splat(operator.add), pairs)) [(0, 2)] Splat also accepts a mapping argument. >>> def is_nice(msg, code): ... return "smile" in msg or code == 0 >>> msgs = [ ... dict(msg='smile!', code=20), ... dict(msg='error :(', code=1), ... dict(msg='unknown', code=0), ... ] >>> for msg in filter(splat(is_nice), msgs): ... print(msg) {'msg': 'smile!', 'code': 20} {'msg': 'unknown', 'code': 0} """ return functools.wraps(func)(functools.partial(_splat_inner, func=func)) _vendor/jaraco/__pycache__/context.cpython-310.pyc 0000644 00000025517 15030122015 0016033 0 ustar 00 o �hP% � @ sJ d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl mZ ejdk r@d dlmZ nd dlZejd'd d ��Zej d(d)dd��Zd*dd�Zdd� Zeee�Zejdd� �Zdd� Zejejfdd��Zejdd efd d ��Z d d � Z G d!d"� d"�Z G d#d$� d$ej ej �Z G d%d&� d&ej �Z!dS )+� )� annotationsN)�Iterator)� � )�tarfile�dir�str | os.PathLike�return�Iterator[str | os.PathLike]c c s8 � t �� }t �| � z | V W t �|� dS t �|� w )z� >>> tmp_path = getfixture('tmp_path') >>> with pushd(tmp_path): ... assert os.getcwd() == os.fspath(tmp_path) >>> assert os.getcwd() != os.fspath(tmp_path) N)�os�getcwd�chdir)r �orig� r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/context.py�pushd s � r � target_dir�str | os.PathLike | Nonec c s� � |du rt j�| ��dd��dd�}t �|� z/tj�| �}tj |dd��}|j |t d� W d � n1 s8w Y |V W t � |� dS t � |� w )a� Get a tarball, extract it, yield, then clean up. >>> import urllib.request >>> url = getfixture('tarfile_served') >>> target = getfixture('tmp_path') / 'out' >>> tb = tarball(url, target_dir=target) >>> import pathlib >>> with tb as extracted: ... contents = pathlib.Path(extracted, 'contents.txt').read_text(encoding='utf-8') >>> assert not os.path.exists(extracted) Nz.tar.gz� z.tgzzr|*)�fileobj�mode)�path�filter)r r �basename�replace�mkdir�urllib�request�urlopenr �open� extractall�strip_first_component�shutil�rmtree)�urlr �req�tfr r r �tarball' s � �r' �member�tarfile.TarInfoc C s | j �dd�\}| _ | S )N�/� )�name�split)r( r �_r r r r! G s r! c G s dd� }t �|t| ��S )a� Compose any number of dependent context managers into a single one. The last, innermost context manager may take arbitrary arguments, but each successive context manager should accept the result from the previous as a single parameter. Like :func:`jaraco.functools.compose`, behavior works from right to left, so the context manager should be indicated from outermost to innermost. Example, to create a context manager to change to a temporary directory: >>> temp_dir_as_cwd = _compose(pushd, temp_dir) >>> with temp_dir_as_cwd() as dir: ... assert os.path.samefile(os.getcwd(), dir) c s � �fdd�}t �|�S )Nc ? st � � | i |���(}�|�� }|V W d � n1 sw Y W d � d S W d � d S 1 s3w Y d S �Nr )�args�kwargs�saved�res��inner�outerr r �composedd s �P�z/_compose.<locals>.compose_two.<locals>.composed)� contextlib�contextmanager)r5 r6 r7 r r4 r � compose_twoc s z _compose.<locals>.compose_two)� functools�reduce�reversed)�cmgrsr: r r r �_composeO s r? c o s� � t jdtdd� |�dt�}t| i |���(}||�� }|V W d � n1 s)w Y W d � d S W d � d S 1 sAw Y d S )NzBtarball_context is deprecated. Use tarball or tarball_cwd instead.� �� stacklevelr )�warnings�warn�DeprecationWarning�popr r' )r0 r1 � pushd_ctx�tballr r r r �tarball_contextp s �� P�rI c C s6 t jdtdd� | dd� }tdddd �}|�|d�S ) a Given a URL or filename, infer the compression code for tar. >>> infer_compression('http://foo/bar.tar.gz') 'z' >>> infer_compression('http://foo/bar.tgz') 'z' >>> infer_compression('file.bz') 'j' >>> infer_compression('file.xz') 'J' z3infer_compression is deprecated with no replacementr@ rA ���N�z�j�J)�gz�bz�xz)rC rD rE �dict�get)r$ �compression_indicator�mappingr r r �infer_compression| s � rU c c s* � t �� }z |V W | |� dS | |� w )a` Create a temporary directory context. Pass a custom remover to override the removal behavior. >>> import pathlib >>> with temp_dir() as the_dir: ... assert os.path.isdir(the_dir) ... _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents', encoding='utf-8') >>> assert not os.path.exists(the_dir) N)�tempfile�mkdtemp)�remover�temp_dirr r r rY � s � rY Tc c s� � d| v rdnd}|� �/}|d| |g}|r |� d|g� ttjjd�}|r'|nd}tj||d� |V W d � dS 1 s>w Y dS )z� Check out the repo indicated by url. If dest_ctx is supplied, it should be a context manager to yield the target directory for the check out. �git�hg�clonez--branch�wN)�stdout)�extendr r r �devnull� subprocess� check_call) r$ �branch�quiet�dest_ctx�exe�repo_dir�cmdr` r^ r r r � repo_context� s � "�ri c C s t jdtdd� t�� S )aD A null context suitable to stand in for a meaningful context. >>> with null() as value: ... assert value is None This context is most useful when dealing with two or more code branches but only some need a context. Wrap the others in a null context to provide symmetry across all options. z.null is deprecated. Use contextlib.nullcontextr@ rA )rC rD rE r8 � nullcontextr r r r �null� s �rk c @ st e Zd ZdZdZeffdd�Zdd� Zedd� �Z ed d � �Z ed d � �Z d d� Z dd� Z ed�dd�Zdd� ZdS )� ExceptionTrapa� A context manager that will catch certain exceptions and provide an indication they occurred. >>> with ExceptionTrap() as trap: ... raise Exception() >>> bool(trap) True >>> with ExceptionTrap() as trap: ... pass >>> bool(trap) False >>> with ExceptionTrap(ValueError) as trap: ... raise ValueError("1 + 1 is not 3") >>> bool(trap) True >>> trap.value ValueError('1 + 1 is not 3') >>> trap.tb <traceback object at ...> >>> with ExceptionTrap(ValueError) as trap: ... raise Exception() Traceback (most recent call last): ... Exception >>> bool(trap) False )NNNc C s || _ d S r/ )� exceptions)�selfrm r r r �__init__� � zExceptionTrap.__init__c C � | S r/ r �rn r r r � __enter__� � zExceptionTrap.__enter__c C � | j d S �Nr ��exc_inforr r r r �type� � zExceptionTrap.typec C ru )Nr+ rw rr r r r �value� rz zExceptionTrap.valuec C ru )Nr@ rw rr r r r �tb rz zExceptionTrap.tbc G s& |d }|o t || j�}|r|| _|S rv )� issubclassrm rx )rn rx ry �matchesr r r �__exit__ s zExceptionTrap.__exit__c C s t | j�S r/ )�boolry rr r r r �__bool__ rp zExceptionTrap.__bool__��_testc s t ���� ��fdd��}|S )a� Wrap func and replace the result with the truth value of the trap (True if an exception occurred). First, give the decorator an alias to support Python 3.8 Syntax. >>> raises = ExceptionTrap(ValueError).raises Now decorate a function that always fails. >>> @raises ... def fail(): ... raise ValueError('failed') >>> fail() True c sF t �j��}�| i |�� W d � � |�S 1 sw Y � |�S r/ )rl rm )r0 r1 �trap�r� �funcrn r r �wrapper! s ��z%ExceptionTrap.raises.<locals>.wrapper)r; �wraps)rn r� r� r� r r� r �raises s zExceptionTrap.raisesc C s | j |tjd�S )a� Wrap func and replace the result with the truth value of the trap (True if no exception). First, give the decorator an alias to support Python 3.8 Syntax. >>> passes = ExceptionTrap(ValueError).passes Now decorate a function that always fails. >>> @passes ... def fail(): ... raise ValueError('failed') >>> fail() False r� )r� �operator�not_)rn r� r r r �passes) s zExceptionTrap.passesN)�__name__� __module__� __qualname__�__doc__rx � Exceptionro rs �propertyry r{ r| r r� r� r� r� r r r r rl � s ! rl c @ s e Zd ZdZdS )�suppressz� A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() N)r� r� r� r� r r r r r� ? s r� c @ s* e Zd ZdZd dd�Zdd� Zdd � Zd S ) � on_interrupta Replace a KeyboardInterrupt with SystemExit(1) >>> def do_interrupt(): ... raise KeyboardInterrupt() >>> on_interrupt('error')(do_interrupt)() Traceback (most recent call last): ... SystemExit: 1 >>> on_interrupt('error', code=255)(do_interrupt)() Traceback (most recent call last): ... SystemExit: 255 >>> on_interrupt('suppress')(do_interrupt)() >>> with __import__('pytest').raises(KeyboardInterrupt): ... on_interrupt('ignore')(do_interrupt)() �errorr+ c C s || _ || _d S r/ )�action�code)rn r� r� r r r ro ] s zon_interrupt.__init__c C rq r/ r rr r r r rs a rt zon_interrupt.__enter__c C s6 |t us | jdkr d S | jdkrt| j�|�| jdkS )N�ignorer� r� )�KeyboardInterruptr� � SystemExitr� )rn �exctype�excinst�exctbr r r r d s zon_interrupt.__exit__N)r� r+ )r� r� r� r� ro rs r r r r r r� J s r� )r r r r r/ )r r r r )r( r) r r) )"� __future__r r8 r; r� r r" ra �sysrV �urllib.requestr rC �typingr � version_info� backportsr r9 r r' r! r? � tarball_cwdrI rU r# rY ri rk rl r� �ContextDecoratorr� r r r r �<module> sD � q _vendor/jaraco/text/__pycache__/__init__.cpython-310.pyc 0000644 00000047757 15030122015 0017104 0 ustar 00 o �hz? � @ s� U d dl Z d dlZd dlZd dlZzd dlmZ W n ey( d dlmZ Y nw d dlm Z m Z d dl m Z dd� Z dd� ZG d d � d e�Ze e�Zejd d � �Zd d� Zdd� Zdd� Zdd� Zee��d�jdd�Z ee d< G dd� d�Z d9d d �Z G d d � d e �Z!e!j"Z#d d!� Z$G d"d#� d#e�Z%G d$d%� d%�Z&d&d'� Z'd(d)� Z(d*d+� Z)d,d-� Z*ej+d.d/� �Z,e,�-e�d0d1� �Z.d2d3� Z/d4d5� Z0d:d7d8�Z1dS );� N)�files)�compose� method_cache)� ExceptionTrapc s � �fdd�S )zH Return a function that will perform a substitution on a string c s | � �� �S �N��replace��s��new�old� �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/__init__.py�<lambda> s z substitution.<locals>.<lambda>r )r r r r r � substitution s r c G s t �t| �} tt| ��} t| � S )z� Take a sequence of pairs specifying substitutions, and create a function that performs those substitutions. >>> multi_substitution(('foo', 'bar'), ('bar', 'baz'))('foo') 'baz' )� itertools�starmapr �reversed�tupler )� substitutionsr r r �multi_substitution s r c sr e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Z� fd d �Z dd� Z e � fdd��Z dd� Z ddd�Z� ZS )� FoldedCaseu� A case insensitive string class; behaves just like str except compares equal when the only variation is case. >>> s = FoldedCase('hello world') >>> s == 'Hello World' True >>> 'Hello World' == s True >>> s != 'Hello World' False >>> s.index('O') 4 >>> s.split('O') ['hell', ' w', 'rld'] >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) ['alpha', 'Beta', 'GAMMA'] Sequence membership is straightforward. >>> "Hello World" in [s] True >>> s in ["Hello World"] True Allows testing for set inclusion, but candidate and elements must both be folded. >>> FoldedCase("Hello World") in {s} True >>> s in {FoldedCase("Hello World")} True String inclusion works as long as the FoldedCase object is on the right. >>> "hello" in FoldedCase("Hello World") True But not if the FoldedCase object is on the left: >>> FoldedCase('hello') in 'Hello World' False In that case, use ``in_``: >>> FoldedCase('hello').in_('Hello World') True >>> FoldedCase('hello') > FoldedCase('Hello') False >>> FoldedCase('ß') == FoldedCase('ss') True c C s | � � |� � k S r ��casefold��self�otherr r r �__lt__d � zFoldedCase.__lt__c C s | � � |� � kS r r r r r r �__gt__g r zFoldedCase.__gt__c C s | � � |� � kS r r r r r r �__eq__j r zFoldedCase.__eq__c C s | � � |� � kS r r r r r r �__ne__m r zFoldedCase.__ne__c C s t | �� �S r )�hashr �r r r r �__hash__p � zFoldedCase.__hash__c s t � �� �|�� �S r )�superr � __contains__r �� __class__r r r( s s zFoldedCase.__contains__c C s | t |�v S )zDoes self appear in other?)r r r r r �in_v s zFoldedCase.in_c s t � �� S r )r' r r$ r) r r r { s zFoldedCase.casefoldc C s | � � �|� � �S r )r �index)r �subr r r r, � zFoldedCase.index� r c C s t �t �|�t j�}|�| |�S r )�re�compile�escape�I�split)r �splitter�maxsplit�patternr r r r4 � s zFoldedCase.split)r/ r )�__name__� __module__� __qualname__�__doc__r r r! r" r% r( r+ r r r, r4 � __classcell__r r r) r r % s > r c C s | � � dS )z� Return True if the supplied value is decodable (using the default encoding). >>> is_decodable(b'\xff') False >>> is_decodable(b'\x32') True N)�decode��valuer r r � is_decodable� s r@ c C s t | t�o t| � S )z� Return True if the value appears to be binary (that is, it's a byte string and isn't decodable). >>> is_binary(b'\xff') True >>> is_binary('\xff') False )� isinstance�bytesr@ r> r r r � is_binary� s rC c C s t �| ��� S )z� Trim something like a docstring to remove the whitespace that is common due to indentation and formatting. >>> trim("\n\tfoo = bar\n\t\tbar = baz\n") 'foo = bar\n\tbar = baz' )�textwrap�dedent�stripr r r r �trim� s rG c C s | � � }dd� |D �}d�|�S )a Wrap lines of text, retaining existing newlines as paragraph markers. >>> print(wrap(lorem_ipsum)) Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. <BLANKLINE> Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst. c s s � | ] }d � t�|��V qdS )� N)�joinrD �wrap��.0�parar r r � <genexpr>� s � zwrap.<locals>.<genexpr>z )� splitlinesrI )r � paragraphs�wrappedr r r rJ � s rJ c C s$ t �d| �}dd� |D �}d�|�S )ad Given a multi-line string, return an unwrapped version. >>> wrapped = wrap(lorem_ipsum) >>> wrapped.count('\n') 20 >>> unwrapped = unwrap(wrapped) >>> unwrapped.count('\n') 1 >>> print(unwrapped) Lorem ipsum dolor sit amet, consectetur adipiscing ... Curabitur pretium tincidunt lacus. Nulla gravida orci ... z\n\n+c s s � | ] }|� d d�V qdS )rH r/ Nr rK r r r rN � s � zunwrap.<locals>.<genexpr>rH )r0 r4 rI )r rP �cleanedr r r �unwrap� s rS zLorem ipsum.txt�utf-8��encoding� lorem_ipsumc @ s e Zd ZdZdd� Zdd� ZdS )�Splitterz�object that will split a string with the given arguments for each call >>> s = Splitter(',') >>> s('hello, world, this is your, master calling') ['hello', ' world', ' this is your', ' master calling'] c G s || _ d S r )�args)r rY r r r �__init__� � zSplitter.__init__c C s |j | j� S r )r4 rY )r r r r r �__call__� r& zSplitter.__call__N)r8 r9 r: r; rZ r\ r r r r rX � s rX � c C s || S )z) >>> indent('foo') ' foo' r )�string�prefixr r r �indent� s r` c s� e Zd ZdZe�d�Zdd� Zdd� Zdd� Z d d � Z d d � Z d d� Z dd� Z dd� Zdd� Zdd� Z� fdd�Zedd� �Zedd � �Z� ZS ) �WordSeta Given an identifier, return the words that identifier represents, whether in camel case, underscore-separated, etc. >>> WordSet.parse("camelCase") ('camel', 'Case') >>> WordSet.parse("under_sep") ('under', 'sep') Acronyms should be retained >>> WordSet.parse("firstSNL") ('first', 'SNL') >>> WordSet.parse("you_and_I") ('you', 'and', 'I') >>> WordSet.parse("A simple test") ('A', 'simple', 'test') Multiple caps should not interfere with the first cap of another word. >>> WordSet.parse("myABCClass") ('my', 'ABC', 'Class') The result is a WordSet, providing access to other forms. >>> WordSet.parse("myABCClass").underscore_separated() 'my_ABC_Class' >>> WordSet.parse('a-command').camel_case() 'ACommand' >>> WordSet.parse('someIdentifier').lowered().space_separated() 'some identifier' Slices of the result should return another WordSet. >>> WordSet.parse('taken-out-of-context')[1:].underscore_separated() 'out_of_context' >>> WordSet.from_class_name(WordSet()).lowered().space_separated() 'word set' >>> example = WordSet.parse('figured it out') >>> example.headless_camel_case() 'figuredItOut' >>> example.dash_separated() 'figured-it-out' z ([A-Z]?[a-z]+)|([A-Z]+(?![a-z]))c C � t dd� | D ��S )Nc s � � | ]}|� � V qd S r )� capitalize�rL �wordr r r rN ; � � z&WordSet.capitalized.<locals>.<genexpr>�ra r$ r r r � capitalized: r. zWordSet.capitalizedc C rb )Nc s rc r )�lowerre r r r rN > rg z"WordSet.lowered.<locals>.<genexpr>rh r$ r r r �lowered= r. zWordSet.loweredc C s d� | �� �S �N� )rI ri r$ r r r � camel_case@ s zWordSet.camel_casec C s4 t | �}t|��� }t�|ft|��� �}d�|�S rl )�iter�nextrj r �chainra rn rI )r �words�first� new_wordsr r r �headless_camel_caseC s zWordSet.headless_camel_casec C � d� | �S )N�_�rI r$ r r r �underscore_separatedI r[ z WordSet.underscore_separatedc C rv )N�-rx r$ r r r �dash_separatedL r[ zWordSet.dash_separatedc C rv )Nr/ rx r$ r r r �space_separatedO r[ zWordSet.space_separatedc C s | r| d |kr| dd� S | S )a Remove the item from the end of the set. >>> WordSet.parse('foo bar').trim_right('foo') ('foo', 'bar') >>> WordSet.parse('foo bar').trim_right('bar') ('foo',) >>> WordSet.parse('').trim_right('bar') () ���Nr �r �itemr r r � trim_rightR � zWordSet.trim_rightc C s | r| d |kr| dd� S | S )a Remove the item from the beginning of the set. >>> WordSet.parse('foo bar').trim_left('foo') ('bar',) >>> WordSet.parse('foo bar').trim_left('bar') ('foo', 'bar') >>> WordSet.parse('').trim_left('bar') () r � Nr r~ r r r � trim_left_ r� zWordSet.trim_leftc C s | � |��|�S )zK >>> WordSet.parse('foo bar').trim('foo') ('bar',) )r� r� r~ r r r rG l s z WordSet.trimc s" t � �|�}t|t�rt|�}|S r )r' � __getitem__rA �slicera )r r �resultr) r r r� s s zWordSet.__getitem__c C s | j �|�}tdd� |D ��S )Nc s s � | ]}|� d �V qdS )r N��group�rL �matchr r r rN | s � z WordSet.parse.<locals>.<genexpr>)�_pattern�finditerra )�cls� identifier�matchesr r r �parsey s z WordSet.parsec C s | � |jj�S r )r� r* r8 )r� �subjectr r r �from_class_name~ s zWordSet.from_class_name)r8 r9 r: r; r0 r1 r� ri rk rn ru ry r{ r| r� r� rG r� � classmethodr� r� r< r r r) r ra s$ 5 ra c C s, t �dt j�}dd� |�| �D �}d�|�S )a� Remove HTML from the string `s`. >>> str(simple_html_strip('')) '' >>> print(simple_html_strip('A <bold>stormy</bold> day in paradise')) A stormy day in paradise >>> print(simple_html_strip('Somebody <!-- do not --> tell the truth.')) Somebody tell the truth. >>> print(simple_html_strip('What about<br/>\nmultiple lines?')) What about multiple lines? z (<!--.*?-->)|(<[^>]*>)|([^<]+)c s s � | ] }|� d �p dV qdS )� rm Nr� r� r r r rN � s � z$simple_html_strip.<locals>.<genexpr>rm )r0 r1 �DOTALLr� rI )r � html_stripper�textsr r r �simple_html_strip� s r� c @ s e Zd ZdZdZdd� ZdS )�SeparatedValuesa A string separated by a separator. Overrides __iter__ for getting the values. >>> list(SeparatedValues('a,b,c')) ['a', 'b', 'c'] Whitespace is stripped and empty values are discarded. >>> list(SeparatedValues(' a, b , c, ')) ['a', 'b', 'c'] �,c C s | � | j�}td dd� |D ��S )Nc s rc r )rF )rL �partr r r rN � rg z+SeparatedValues.__iter__.<locals>.<genexpr>)r4 � separator�filter)r �partsr r r �__iter__� s zSeparatedValues.__iter__N)r8 r9 r: r; r� r� r r r r r� � s r� c @ s8 e Zd ZdZdd� Zedd� �Zdd� Zedd � �Z d S ) �Strippera& Given a series of lines, find the common prefix and strip it from them. >>> lines = [ ... 'abcdefg\n', ... 'abc\n', ... 'abcde\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix 'abc' >>> list(res.lines) ['defg\n', '\n', 'de\n'] If no prefix is common, nothing should be stripped. >>> lines = [ ... 'abcd\n', ... '1234\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix = '' >>> list(res.lines) ['abcd\n', '1234\n'] c C s || _ t| |�| _d S r )r_ �map�lines)r r_ r� r r r rZ � s zStripper.__init__c C s& t �|�\}}t�| j|�}| ||�S r )r �tee� functools�reduce� common_prefix)r� r� � prefix_linesr_ r r r � strip_prefix� s zStripper.strip_prefixc C s | j s|S |�| j �\}}}|S r )r_ � partition)r �line�nullr_ �restr r r r\ � s zStripper.__call__c C sV t t| �t|��}| d|� |d|� kr%|d8 }| d|� |d|� ks| d|� S )z8 Return the common prefix of two lines. Nr� )�min�len)�s1�s2r, r r r r� � s � zStripper.common_prefixN) r8 r9 r: r; rZ r� r� r\ � staticmethodr� r r r r r� � s r� c C s | � |�\}}}|S )z� Remove the prefix from the text if it exists. >>> remove_prefix('underwhelming performance', 'underwhelming ') 'performance' >>> remove_prefix('something special', 'sample') 'something special' )� rpartition)�textr_ r� r� r r r � remove_prefix� � r� c C s | � |�\}}}|S )z� Remove the suffix from the text if it exists. >>> remove_suffix('name.git', '.git') 'name' >>> remove_suffix('something special', 'sample') 'something special' �r� )r� �suffixr� r� r r r � remove_suffix� r� r� c C s g d�}d� |�}t�|d| �S )a Replace alternate newlines with the canonical newline. >>> normalize_newlines('Lorem Ipsum\u2029') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\r\n') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\x85') 'Lorem Ipsum\n' )z � rH � u u �|rH )rI r0 r- )r� �newlinesr7 r r r �normalize_newlines s r� c C s | o| � d� S )N�#)� startswith)�strr r r � _nonblank r r� c C s t j�tt| ��S )a� Yield valid lines of a string or iterable. >>> list(yield_lines('')) [] >>> list(yield_lines(['foo', 'bar'])) ['foo', 'bar'] >>> list(yield_lines('foo\nbar')) ['foo', 'bar'] >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) ['foo', 'baz #comment'] >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) ['foo', 'bar', 'baz', 'bing'] )r rq � from_iterabler� � yield_lines)�iterabler r r r� s r� c C s t tttj| �� ��S r )r� r� r� r� rF rO )r� r r r rw + s rw c C s | � d�d S )z� Drop comments. >>> drop_comment('foo # bar') 'foo' A hash without a space may be in a URL. >>> drop_comment('http://example.com/foo#bar') 'http://example.com/foo#bar' z #r r� )r� r r r � drop_comment0 s r� c c sf � t | �} | D ])}|�d�r-z|dd� �� t| � }W n ty' Y dS w |�d�s|V qdS )a^ Join lines continued by a trailing backslash. >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) ['foobarbaz'] Not sure why, but... The character preceding the backslash is also elided. >>> list(join_continuation(['goo\\', 'dly'])) ['godly'] A terrible idea, but... If no line is available to continue, suppress the lines. >>> list(join_continuation(['foo', 'bar\\', 'baz\\'])) ['foo'] �\N���)ro �endswithrF rp � StopIteration)r� r r r r �join_continuation? s � � ��r� � c C s@ t | dd��}|�|� W d � |jS 1 sw Y |jS )a� >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\n' >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\r\n' >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8') >>> read_newlines(filename) ('\r', '\n', '\r\n') rT rU N)�open�readr� )�filename�limit�fpr r r � read_newlines` s ��r� )r] )r� )2r0 r rD r� �importlib.resourcesr � ImportError�importlib_resources�jaraco.functoolsr r �jaraco.contextr r r r� r �UnicodeDecodeError� _unicode_trap�passesr@ rC rG rJ rS r8 �joinpath� read_textrW �__annotations__rX r` r ra r� rr r� r� r� r� r� r� r� �singledispatchr� �registerrw r� r� r� r r r r �<module> sT � c ! � 6 ! _vendor/jaraco/text/__pycache__/strip-prefix.cpython-310.pyc 0000644 00000001235 15030122015 0017756 0 ustar 00 o �h� � @ s6 d dl Z d dlZd dlmZ dd� Ze�e�e� dS )� N)�Stripperc C s t j�t�t j�j� dS )z� Strip any common prefix from stdin. >>> import io, pytest >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123')) >>> strip_prefix() def 123 N)�sys�stdout� writelinesr � strip_prefix�stdin�lines� r r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.pyr s r )r � autocommand� jaraco.textr r �__name__r r r r �<module> s _vendor/jaraco/text/__pycache__/to-qwerty.cpython-310.pyc 0000644 00000000505 15030122015 0017274 0 ustar 00 o �hw � @ s6 d dl Z ddlmZ edkoe�e jej� dS dS )� N� )�layouts�__main__)�sys� r �__name__�_translate_stream�stdin� to_qwerty� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py�<module> s " _vendor/jaraco/text/__pycache__/show-newlines.cpython-310.pyc 0000644 00000002141 15030122015 0020121 0 ustar 00 o �h� � @ s> d dl Z d dlZd dlmZ d dlZdd� Ze � e�e� dS )� N)�always_iterablec C sH t j�| �}ttt|���}t�� }t|� d|�|� d|�t |�� dS )a� Report the newlines in the indicated file. >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8') >>> report_newlines(filename) newline is '\n' >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8') >>> report_newlines(filename) newlines are ('\n', '\r\n') �newline�isN) �jaraco�text� read_newlines�len�tupler �inflect�engine�print� plural_noun� plural_verb�repr)�filename�newlines�countr � r �_/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py�report_newlines s �r )� autocommandr �more_itertoolsr � jaraco.textr r �__name__r r r r �<module> s _vendor/jaraco/text/__pycache__/layouts.cpython-310.pyc 0000644 00000001603 15030122015 0017021 0 ustar 00 o �h� � @ s4 d Z dZe�e e�Ze�ee �Zdd� Zdd� ZdS )zF-=qwertyuiop[]asdfghjkl;'zxcvbnm,./_+QWERTYUIOP{}ASDFGHJKL:"ZXCVBNM<>?zF[]',.pyfgcrl/=aoeuidhtns-;qjkxbmwvz{}"<>PYFGCRL?+AOEUIDHTNS_:QJKXBMWVZc C s | � |�S )zm >>> translate('dvorak', to_dvorak) 'ekrpat' >>> translate('qwerty', to_qwerty) 'x,dokt' )� translate)�input� translation� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/layouts.pyr s r c C s t t| �� |�� dS )zX >>> import io >>> _translate_stream(io.StringIO('foo'), to_dvorak) urr N)�printr �read)�streamr r r r �_translate_stream s r N)�qwerty�dvorak�str� maketrans� to_dvorak� to_qwertyr r r r r r �<module> s _vendor/jaraco/text/__pycache__/to-dvorak.cpython-310.pyc 0000644 00000000505 15030122015 0017227 0 ustar 00 o �hw � @ s6 d dl Z ddlmZ edkoe�e jej� dS dS )� N� )�layouts�__main__)�sys� r �__name__�_translate_stream�stdin� to_dvorak� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py�<module> s " _vendor/jaraco/text/to-qwerty.py 0000644 00000000167 15030122015 0012741 0 ustar 00 import sys from . import layouts __name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_qwerty) _vendor/jaraco/text/Lorem ipsum.txt 0000644 00000002467 15030122015 0013356 0 ustar 00 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst. _vendor/jaraco/text/layouts.py 0000644 00000001203 15030122015 0012456 0 ustar 00 qwerty = "-=qwertyuiop[]asdfghjkl;'zxcvbnm,./_+QWERTYUIOP{}ASDFGHJKL:\"ZXCVBNM<>?" dvorak = "[]',.pyfgcrl/=aoeuidhtns-;qjkxbmwvz{}\"<>PYFGCRL?+AOEUIDHTNS_:QJKXBMWVZ" to_dvorak = str.maketrans(qwerty, dvorak) to_qwerty = str.maketrans(dvorak, qwerty) def translate(input, translation): """ >>> translate('dvorak', to_dvorak) 'ekrpat' >>> translate('qwerty', to_qwerty) 'x,dokt' """ return input.translate(translation) def _translate_stream(stream, translation): """ >>> import io >>> _translate_stream(io.StringIO('foo'), to_dvorak) urr """ print(translate(stream.read(), translation)) _vendor/jaraco/text/to-dvorak.py 0000644 00000000167 15030122015 0012674 0 ustar 00 import sys from . import layouts __name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_dvorak) _vendor/jaraco/text/strip-prefix.py 0000644 00000000634 15030122015 0013421 0 ustar 00 import sys import autocommand from jaraco.text import Stripper def strip_prefix(): r""" Strip any common prefix from stdin. >>> import io, pytest >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123')) >>> strip_prefix() def 123 """ sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines) autocommand.autocommand(__name__)(strip_prefix) _vendor/jaraco/text/show-newlines.py 0000644 00000001610 15030122015 0013562 0 ustar 00 import autocommand import inflect from more_itertools import always_iterable import jaraco.text def report_newlines(filename): r""" Report the newlines in the indicated file. >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8') >>> report_newlines(filename) newline is '\n' >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8') >>> report_newlines(filename) newlines are ('\n', '\r\n') """ newlines = jaraco.text.read_newlines(filename) count = len(tuple(always_iterable(newlines))) engine = inflect.engine() print( engine.plural_noun("newline", count), engine.plural_verb("is", count), repr(newlines), ) autocommand.autocommand(__name__)(report_newlines) _vendor/jaraco/text/__init__.py 0000644 00000037572 15030122015 0012537 0 ustar 00 import re import itertools import textwrap import functools try: from importlib.resources import files # type: ignore except ImportError: # pragma: nocover from importlib_resources import files # type: ignore from jaraco.functools import compose, method_cache from jaraco.context import ExceptionTrap def substitution(old, new): """ Return a function that will perform a substitution on a string """ return lambda s: s.replace(old, new) def multi_substitution(*substitutions): """ Take a sequence of pairs specifying substitutions, and create a function that performs those substitutions. >>> multi_substitution(('foo', 'bar'), ('bar', 'baz'))('foo') 'baz' """ substitutions = itertools.starmap(substitution, substitutions) # compose function applies last function first, so reverse the # substitutions to get the expected order. substitutions = reversed(tuple(substitutions)) return compose(*substitutions) class FoldedCase(str): """ A case insensitive string class; behaves just like str except compares equal when the only variation is case. >>> s = FoldedCase('hello world') >>> s == 'Hello World' True >>> 'Hello World' == s True >>> s != 'Hello World' False >>> s.index('O') 4 >>> s.split('O') ['hell', ' w', 'rld'] >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) ['alpha', 'Beta', 'GAMMA'] Sequence membership is straightforward. >>> "Hello World" in [s] True >>> s in ["Hello World"] True Allows testing for set inclusion, but candidate and elements must both be folded. >>> FoldedCase("Hello World") in {s} True >>> s in {FoldedCase("Hello World")} True String inclusion works as long as the FoldedCase object is on the right. >>> "hello" in FoldedCase("Hello World") True But not if the FoldedCase object is on the left: >>> FoldedCase('hello') in 'Hello World' False In that case, use ``in_``: >>> FoldedCase('hello').in_('Hello World') True >>> FoldedCase('hello') > FoldedCase('Hello') False >>> FoldedCase('ß') == FoldedCase('ss') True """ def __lt__(self, other): return self.casefold() < other.casefold() def __gt__(self, other): return self.casefold() > other.casefold() def __eq__(self, other): return self.casefold() == other.casefold() def __ne__(self, other): return self.casefold() != other.casefold() def __hash__(self): return hash(self.casefold()) def __contains__(self, other): return super().casefold().__contains__(other.casefold()) def in_(self, other): "Does self appear in other?" return self in FoldedCase(other) # cache casefold since it's likely to be called frequently. @method_cache def casefold(self): return super().casefold() def index(self, sub): return self.casefold().index(sub.casefold()) def split(self, splitter=' ', maxsplit=0): pattern = re.compile(re.escape(splitter), re.I) return pattern.split(self, maxsplit) # Python 3.8 compatibility _unicode_trap = ExceptionTrap(UnicodeDecodeError) @_unicode_trap.passes def is_decodable(value): r""" Return True if the supplied value is decodable (using the default encoding). >>> is_decodable(b'\xff') False >>> is_decodable(b'\x32') True """ value.decode() def is_binary(value): r""" Return True if the value appears to be binary (that is, it's a byte string and isn't decodable). >>> is_binary(b'\xff') True >>> is_binary('\xff') False """ return isinstance(value, bytes) and not is_decodable(value) def trim(s): r""" Trim something like a docstring to remove the whitespace that is common due to indentation and formatting. >>> trim("\n\tfoo = bar\n\t\tbar = baz\n") 'foo = bar\n\tbar = baz' """ return textwrap.dedent(s).strip() def wrap(s): """ Wrap lines of text, retaining existing newlines as paragraph markers. >>> print(wrap(lorem_ipsum)) Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. <BLANKLINE> Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst. """ paragraphs = s.splitlines() wrapped = ('\n'.join(textwrap.wrap(para)) for para in paragraphs) return '\n\n'.join(wrapped) def unwrap(s): r""" Given a multi-line string, return an unwrapped version. >>> wrapped = wrap(lorem_ipsum) >>> wrapped.count('\n') 20 >>> unwrapped = unwrap(wrapped) >>> unwrapped.count('\n') 1 >>> print(unwrapped) Lorem ipsum dolor sit amet, consectetur adipiscing ... Curabitur pretium tincidunt lacus. Nulla gravida orci ... """ paragraphs = re.split(r'\n\n+', s) cleaned = (para.replace('\n', ' ') for para in paragraphs) return '\n'.join(cleaned) lorem_ipsum: str = ( files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8') ) class Splitter: """object that will split a string with the given arguments for each call >>> s = Splitter(',') >>> s('hello, world, this is your, master calling') ['hello', ' world', ' this is your', ' master calling'] """ def __init__(self, *args): self.args = args def __call__(self, s): return s.split(*self.args) def indent(string, prefix=' ' * 4): """ >>> indent('foo') ' foo' """ return prefix + string class WordSet(tuple): """ Given an identifier, return the words that identifier represents, whether in camel case, underscore-separated, etc. >>> WordSet.parse("camelCase") ('camel', 'Case') >>> WordSet.parse("under_sep") ('under', 'sep') Acronyms should be retained >>> WordSet.parse("firstSNL") ('first', 'SNL') >>> WordSet.parse("you_and_I") ('you', 'and', 'I') >>> WordSet.parse("A simple test") ('A', 'simple', 'test') Multiple caps should not interfere with the first cap of another word. >>> WordSet.parse("myABCClass") ('my', 'ABC', 'Class') The result is a WordSet, providing access to other forms. >>> WordSet.parse("myABCClass").underscore_separated() 'my_ABC_Class' >>> WordSet.parse('a-command').camel_case() 'ACommand' >>> WordSet.parse('someIdentifier').lowered().space_separated() 'some identifier' Slices of the result should return another WordSet. >>> WordSet.parse('taken-out-of-context')[1:].underscore_separated() 'out_of_context' >>> WordSet.from_class_name(WordSet()).lowered().space_separated() 'word set' >>> example = WordSet.parse('figured it out') >>> example.headless_camel_case() 'figuredItOut' >>> example.dash_separated() 'figured-it-out' """ _pattern = re.compile('([A-Z]?[a-z]+)|([A-Z]+(?![a-z]))') def capitalized(self): return WordSet(word.capitalize() for word in self) def lowered(self): return WordSet(word.lower() for word in self) def camel_case(self): return ''.join(self.capitalized()) def headless_camel_case(self): words = iter(self) first = next(words).lower() new_words = itertools.chain((first,), WordSet(words).camel_case()) return ''.join(new_words) def underscore_separated(self): return '_'.join(self) def dash_separated(self): return '-'.join(self) def space_separated(self): return ' '.join(self) def trim_right(self, item): """ Remove the item from the end of the set. >>> WordSet.parse('foo bar').trim_right('foo') ('foo', 'bar') >>> WordSet.parse('foo bar').trim_right('bar') ('foo',) >>> WordSet.parse('').trim_right('bar') () """ return self[:-1] if self and self[-1] == item else self def trim_left(self, item): """ Remove the item from the beginning of the set. >>> WordSet.parse('foo bar').trim_left('foo') ('bar',) >>> WordSet.parse('foo bar').trim_left('bar') ('foo', 'bar') >>> WordSet.parse('').trim_left('bar') () """ return self[1:] if self and self[0] == item else self def trim(self, item): """ >>> WordSet.parse('foo bar').trim('foo') ('bar',) """ return self.trim_left(item).trim_right(item) def __getitem__(self, item): result = super().__getitem__(item) if isinstance(item, slice): result = WordSet(result) return result @classmethod def parse(cls, identifier): matches = cls._pattern.finditer(identifier) return WordSet(match.group(0) for match in matches) @classmethod def from_class_name(cls, subject): return cls.parse(subject.__class__.__name__) # for backward compatibility words = WordSet.parse def simple_html_strip(s): r""" Remove HTML from the string `s`. >>> str(simple_html_strip('')) '' >>> print(simple_html_strip('A <bold>stormy</bold> day in paradise')) A stormy day in paradise >>> print(simple_html_strip('Somebody <!-- do not --> tell the truth.')) Somebody tell the truth. >>> print(simple_html_strip('What about<br/>\nmultiple lines?')) What about multiple lines? """ html_stripper = re.compile('(<!--.*?-->)|(<[^>]*>)|([^<]+)', re.DOTALL) texts = (match.group(3) or '' for match in html_stripper.finditer(s)) return ''.join(texts) class SeparatedValues(str): """ A string separated by a separator. Overrides __iter__ for getting the values. >>> list(SeparatedValues('a,b,c')) ['a', 'b', 'c'] Whitespace is stripped and empty values are discarded. >>> list(SeparatedValues(' a, b , c, ')) ['a', 'b', 'c'] """ separator = ',' def __iter__(self): parts = self.split(self.separator) return filter(None, (part.strip() for part in parts)) class Stripper: r""" Given a series of lines, find the common prefix and strip it from them. >>> lines = [ ... 'abcdefg\n', ... 'abc\n', ... 'abcde\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix 'abc' >>> list(res.lines) ['defg\n', '\n', 'de\n'] If no prefix is common, nothing should be stripped. >>> lines = [ ... 'abcd\n', ... '1234\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix = '' >>> list(res.lines) ['abcd\n', '1234\n'] """ def __init__(self, prefix, lines): self.prefix = prefix self.lines = map(self, lines) @classmethod def strip_prefix(cls, lines): prefix_lines, lines = itertools.tee(lines) prefix = functools.reduce(cls.common_prefix, prefix_lines) return cls(prefix, lines) def __call__(self, line): if not self.prefix: return line null, prefix, rest = line.partition(self.prefix) return rest @staticmethod def common_prefix(s1, s2): """ Return the common prefix of two lines. """ index = min(len(s1), len(s2)) while s1[:index] != s2[:index]: index -= 1 return s1[:index] def remove_prefix(text, prefix): """ Remove the prefix from the text if it exists. >>> remove_prefix('underwhelming performance', 'underwhelming ') 'performance' >>> remove_prefix('something special', 'sample') 'something special' """ null, prefix, rest = text.rpartition(prefix) return rest def remove_suffix(text, suffix): """ Remove the suffix from the text if it exists. >>> remove_suffix('name.git', '.git') 'name' >>> remove_suffix('something special', 'sample') 'something special' """ rest, suffix, null = text.partition(suffix) return rest def normalize_newlines(text): r""" Replace alternate newlines with the canonical newline. >>> normalize_newlines('Lorem Ipsum\u2029') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\r\n') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\x85') 'Lorem Ipsum\n' """ newlines = ['\r\n', '\r', '\n', '\u0085', '\u2028', '\u2029'] pattern = '|'.join(newlines) return re.sub(pattern, '\n', text) def _nonblank(str): return str and not str.startswith('#') @functools.singledispatch def yield_lines(iterable): r""" Yield valid lines of a string or iterable. >>> list(yield_lines('')) [] >>> list(yield_lines(['foo', 'bar'])) ['foo', 'bar'] >>> list(yield_lines('foo\nbar')) ['foo', 'bar'] >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) ['foo', 'baz #comment'] >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) ['foo', 'bar', 'baz', 'bing'] """ return itertools.chain.from_iterable(map(yield_lines, iterable)) @yield_lines.register(str) def _(text): return filter(_nonblank, map(str.strip, text.splitlines())) def drop_comment(line): """ Drop comments. >>> drop_comment('foo # bar') 'foo' A hash without a space may be in a URL. >>> drop_comment('http://example.com/foo#bar') 'http://example.com/foo#bar' """ return line.partition(' #')[0] def join_continuation(lines): r""" Join lines continued by a trailing backslash. >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) ['foobarbaz'] Not sure why, but... The character preceding the backslash is also elided. >>> list(join_continuation(['goo\\', 'dly'])) ['godly'] A terrible idea, but... If no line is available to continue, suppress the lines. >>> list(join_continuation(['foo', 'bar\\', 'baz\\'])) ['foo'] """ lines = iter(lines) for item in lines: while item.endswith('\\'): try: item = item[:-2].strip() + next(lines) except StopIteration: return yield item def read_newlines(filename, limit=1024): r""" >>> tmp_path = getfixture('tmp_path') >>> filename = tmp_path / 'out.txt' >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\n' >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8') >>> read_newlines(filename) '\r\n' >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8') >>> read_newlines(filename) ('\r', '\n', '\r\n') """ with open(filename, encoding='utf-8') as fp: fp.read(limit) return fp.newlines _vendor/jaraco/collections/__pycache__/__init__.cpython-310.pyc 0000644 00000076744 15030122015 0020434 0 ustar 00 o �hh � @ sf d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dlm Z m Z m Z d dl mZmZmZmZmZmZmZ d dlZer]d dlmZ d dlmZ d dlm Z eded �Z ned�Z ed �Z ed �Z eee e e j f Z!dCdd�Z"G dd� dej#j �Z$G dd� de$�Z%dd� Z&G dd� dee e f �Z'dd� Z(e(d fd d �Z)G d d � d e*�Z+G d!d"� d"e+�Z,G d#d$� d$�Z-G d%d&� d&�Z.d'd(� Z/G d)d*� d*e*�Z0G d+d,� d,e1ej#j2�Z3G d-d.� d.e*�Z4G d/d0� d0ej#j ej#j5�Z6G d1d2� d2e.e4�Z7G d3d4� d4�Z8G d5d6� d6ej9�Z:G d7d8� d8�Z;G d9d:� d:�Z<d;d<� Z=G d=d>� d>ej>�Z?G d?d@� d@�Z@G dAdB� dBe'�ZAdS )D� )� annotationsN)� Container�Iterable�Mapping)� TYPE_CHECKING�Any�Callable�Dict�TypeVar�Union�overload)�_SupportsComparison)�SupportsKeysAndGetItem)�Self� _RangeMapKT)�bound�_T�_VT�obj� _Matchable�returnr c C s8 t | tj�r | jS t | t�st | t�st| �} | j} | S �N)� isinstance�re�Pattern� fullmatchr r �set� __contains__)r � r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/jaraco/collections/__init__.py� _dispatch! s r c @ s: e Zd ZdZddd�Zdd � Zd d � Zd d � Zdd� ZdS )� ProjectionaT Project a set of keys over a mapping >>> sample = {'a': 1, 'b': 2, 'c': 3} >>> prj = Projection(['a', 'c', 'd'], sample) >>> dict(prj) {'a': 1, 'c': 3} Projection also accepts an iterable or callable or pattern. >>> iter_prj = Projection(iter('acd'), sample) >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample) >>> pat_prj = Projection(re.compile(r'[acd]'), sample) >>> prj == iter_prj == call_prj == pat_prj True Keys should only appear if they were specified and exist in the space. Order is retained. >>> list(prj) ['a', 'c'] Attempting to access a key not in the projection results in a KeyError. >>> prj['b'] Traceback (most recent call last): ... KeyError: 'b' Use the projection to update another dict. >>> target = {'a': 2, 'b': 2} >>> target.update(prj) >>> target {'a': 1, 'b': 2, 'c': 3} Projection keeps a reference to the original dict, so modifying the original dict may modify the Projection. >>> del sample['a'] >>> dict(prj) {'c': 3} �keysr �spacer c C s t |�| _|| _d S r )r �_match�_space)�selfr" r# r r r �__init__] � zProjection.__init__c C s | � |�s t|��| j| S r )r$ �KeyErrorr% �r& �keyr r r � __getitem__a s zProjection.__getitem__c C s t | j| j�S r )�filterr$ r% �r& r r r �_keys_resolvedf � zProjection._keys_resolvedc C s | � � S r )r/ r. r r r �__iter__i s zProjection.__iter__c C s t t| �� ��S r )�len�tupler/ r. r r r �__len__l � zProjection.__len__N)r" r r# r ) �__name__� __module__� __qualname__�__doc__r' r, r/ r1 r4 r r r r r! / s - r! c � e Zd ZdZ� fdd�Z� ZS )�Maskz� The inverse of a :class:`Projection`, masking out keys. >>> sample = {'a': 1, 'b': 2, 'c': 3} >>> msk = Mask(['a', 'c', 'd'], sample) >>> dict(msk) {'b': 2} c s& t � j|i |�� | jfdd�| _d S )Nc S s || � S r r )r+ �origr r r �<lambda>} s z Mask.__init__.<locals>.<lambda>)�superr' r$ �r& �args�kwargs�� __class__r r r' z s z Mask.__init__�r6 r7 r8 r9 r' � __classcell__r r rB r r; p s r; c s t � fdd�|�� D ��S )z� Return a new dict with function applied to values of dictionary. >>> dict_map(lambda x: x+1, dict(a=1, b=2)) {'a': 2, 'b': 3} c 3 s � | ] \}}|� |�fV qd S r r )�.0r+ �value��functionr r � <genexpr>� s � zdict_map.<locals>.<genexpr>)�dict�items)rI � dictionaryr rH r �dict_map� s rN c @ s� e Zd ZdZi ejfd-dd �Zed.d d ��Zd/dd�Z e d0dd��Z e d1d2d d��Z d1d3d d�Z d4d"d#�Z d5d%d&�Z ed'd(i �� ZG d)d*� d*e�Zed+�Zed,�ZdS )6�RangeMapaP A dictionary-like object that uses the keys as bounds for a range. Inclusion of the value for that range is determined by the key_match_comparator, which defaults to less-than-or-equal. A value is returned for a key if it is the first key that matches in the sorted list of keys. One may supply keyword parameters to be passed to the sort function used to sort keys (i.e. key, reverse) as sort_params. Create a map that maps 1-3 -> 'a', 4-6 -> 'b' >>> r = RangeMap({3: 'a', 6: 'b'}) # boy, that was easy >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') Even float values should work so long as the comparison operator supports it. >>> r[4.5] 'b' Notice that the way rangemap is defined, it must be open-ended on one side. >>> r[0] 'a' >>> r[-1] 'a' One can close the open-end of the RangeMap by using undefined_value >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'}) >>> r[0] Traceback (most recent call last): ... KeyError: 0 One can get the first or last elements in the range by using RangeMap.Item >>> last_item = RangeMap.Item(-1) >>> r[last_item] 'b' .last_item is a shortcut for Item(-1) >>> r[RangeMap.last_item] 'b' Sometimes it's useful to find the bounds for a RangeMap >>> r.bounds() (0, 6) RangeMap supports .get(key, default) >>> r.get(0, 'not found') 'not found' >>> r.get(7, 'not found') 'not found' One often wishes to define the ranges by their left-most values, which requires use of sort params and a key_match_comparator. >>> r = RangeMap({1: 'a', 4: 'b'}, ... sort_params=dict(reverse=True), ... key_match_comparator=operator.ge) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') That wasn't nearly as easy as before, so an alternate constructor is provided: >>> r = RangeMap.left({1: 'a', 4: 'b', 7: RangeMap.undefined_value}) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') �source�LSupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]]� sort_params�Mapping[str, Any]�key_match_comparator�*Callable[[_RangeMapKT, _RangeMapKT], bool]c C s t �| |� || _|| _d S r )rK r' rR �match)r& rP rR rT r r r r' � s zRangeMap.__init__r r c C s | |t dd�tjd�S )NT)�reverse)rR rT )rK �operator�ge)�clsrP r r r �left� s �z RangeMap.left�itemr r c C sb t | �� fi | j��}t|tj�r| �|| �}|S | �||�}t�| |�}|tj u r/t |��|S r ) �sortedr" rR r rO �Itemr, �_find_first_match_rK �undefined_valuer) )r& r\ � sorted_keys�resultr+ r r r r, � s � zRangeMap.__getitem__r+ �defaultr �_VT | _Tc C � d S r r �r& r+ rc r r r �get� � z RangeMap.getN�None� _VT | Nonec C re r r rf r r r rg � rh � _T | None�_VT | _T | Nonec C �" z| | W S t y | Y S w )z� Return the value for key if key is in the dictionary, else default. If default is not given, it defaults to None, so that this method never raises a KeyError. �r) rf r r r rg s �r" �Iterable[_RangeMapKT]c C s< t �| j|�}t||�}zt|�W S ty t|�d �w r )� functools�partialrV r- �next� StopIterationr) )r& r" r\ �is_match�matchesr r r r_ s �zRangeMap._find_first_match_� tuple[_RangeMapKT, _RangeMapKT]c C s* t | �� fi | j��}|tj |tj fS r )r] r" rR rO � first_item� last_item)r& ra r r r �bounds s zRangeMap.bounds�RangeValueUndefinedr c @ s e Zd ZdZdS )z RangeMap.Itemz RangeMap ItemN)r6 r7 r8 r9 r r r r r^ s r^ r ���)rP rQ rR rS rT rU )rP rQ r r )r\ r r r )r+ r rc r r rd r )r+ r rc ri r rj )r+ r rc rk r rl )r" ro r\ r r r )r rv )r6 r7 r8 r9 rX �ler' � classmethodr[ r, r rg r_ ry �typer` �intr^ rw rx r r r r rO � s& U � rO c C � | S r r )�xr r r � __identity$ rh r� Fc s � fdd�}t | �� ||d�S )a� Return the items of the dictionary sorted by the keys. >>> sample = dict(foo=20, bar=42, baz=10) >>> tuple(sorted_items(sample)) (('bar', 42), ('baz', 10), ('foo', 20)) >>> reverse_string = lambda s: ''.join(reversed(s)) >>> tuple(sorted_items(sample, key=reverse_string)) (('foo', 20), ('bar', 42), ('baz', 10)) >>> tuple(sorted_items(sample, reverse=True)) (('foo', 20), ('baz', 10), ('bar', 42)) c s � | d �S )Nr r )r\ �r+ r r � pairkey_key9 � z!sorted_items.<locals>.pairkey_key)r+ rW )r] rL )�dr+ rW r� r r� r � sorted_items( s r� c s� e Zd ZdZedd� �Z� fdd�Z� fdd�Z� fdd �Z� fd d �Z � fd d �Z � fdd�Z � fdd�Z � fdd�Z dd� Z� ZS )�KeyTransformingDictz� A dict subclass that transforms the keys before they're used. Subclasses may override the default transform_key to customize behavior. c C r� r r r� r r r � transform_keyE s z!KeyTransformingDict.transform_keyc s4 t � �� t|i |��}|�� D ]}| j|� qd S r )r> r' rK rL � __setitem__)r& r@ �kargsr� r\ rB r r r' I s �z KeyTransformingDict.__init__c s | � |�}t� �||� d S r )r� r> r� )r& r+ �valrB r r r� Q s z KeyTransformingDict.__setitem__c � | � |�}t� �|�S r )r� r> r, r* rB r r r, U � z KeyTransformingDict.__getitem__c r� r )r� r> r r* rB r r r Y r� z KeyTransformingDict.__contains__c r� r )r� r> � __delitem__r* rB r r r� ] r� z KeyTransformingDict.__delitem__c �$ | � |�}t� j|g|�R i |��S r )r� r> rg �r& r+ r@ rA rB r r rg a � zKeyTransformingDict.getc r� r )r� r> � setdefaultr� rB r r r� e r� z KeyTransformingDict.setdefaultc r� r )r� r> �popr� rB r r r� i r� zKeyTransformingDict.popc s@ zt � fdd�| �� D ��W S ty } zt� �|�d}~ww )z� Given a key, return the actual key stored in self that matches. Raise KeyError if the key isn't found. c 3 s � | ] }|� kr|V qd S r r )rF �e_keyr� r r rJ s � � z7KeyTransformingDict.matching_key_for.<locals>.<genexpr>N)rr r" rs r) )r& r+ �errr r� r �matching_key_form s ��z$KeyTransformingDict.matching_key_for)r6 r7 r8 r9 � staticmethodr� r' r� r, r r� rg r� r� r� rE r r rB r r� ? s r� c @ s e Zd ZdZedd� �ZdS )�FoldedCaseKeyedDicta� A case-insensitive dictionary (keys are compared as insensitive if they are strings). >>> d = FoldedCaseKeyedDict() >>> d['heLlo'] = 'world' >>> list(d.keys()) == ['heLlo'] True >>> list(d.values()) == ['world'] True >>> d['hello'] == 'world' True >>> 'hello' in d True >>> 'HELLO' in d True >>> print(repr(FoldedCaseKeyedDict({'heLlo': 'world'}))) {'heLlo': 'world'} >>> d = FoldedCaseKeyedDict({'heLlo': 'world'}) >>> print(d['hello']) world >>> print(d['Hello']) world >>> list(d.keys()) ['heLlo'] >>> d = FoldedCaseKeyedDict({'heLlo': 'world', 'Hello': 'world'}) >>> list(d.values()) ['world'] >>> key, = d.keys() >>> key in ['heLlo', 'Hello'] True >>> del d['HELLO'] >>> d {} get should work >>> d['Sumthin'] = 'else' >>> d.get('SUMTHIN') 'else' >>> d.get('OTHER', 'thing') 'thing' >>> del d['sumthin'] setdefault should also work >>> d['This'] = 'that' >>> print(d.setdefault('this', 'other')) that >>> len(d) 1 >>> print(d['this']) that >>> print(d.setdefault('That', 'other')) other >>> print(d['THAT']) other Make it pop! >>> print(d.pop('THAT')) other To retrieve the key in its originally-supplied form, use matching_key_for >>> print(d.matching_key_for('this')) This >>> d.matching_key_for('missing') Traceback (most recent call last): ... KeyError: 'missing' c C s t j�| �S r )�jaraco�text� FoldedCaser� r r r r� � s z!FoldedCaseKeyedDict.transform_keyN)r6 r7 r8 r9 r� r� r r r r r� x s Jr� c @ s e Zd ZdZdd� Zdd� ZdS )� DictAdapteraD Provide a getitem interface for attributes of an object. Let's say you want to get at the string.lowercase property in a formatted string. It's easy with DictAdapter. >>> import string >>> print("lowercase is %(ascii_lowercase)s" % DictAdapter(string)) lowercase is abcdefghijklmnopqrstuvwxyz c C � || _ d S r )�object)r& � wrapped_obr r r r' � � zDictAdapter.__init__c C s t | j|�S r )�getattrr� )r& �namer r r r, � r� zDictAdapter.__getitem__N)r6 r7 r8 r9 r' r, r r r r r� � s r� c r: )�ItemsAsAttributesa� Mix-in class to enable a mapping object to provide items as attributes. >>> C = type('C', (dict, ItemsAsAttributes), dict()) >>> i = C() >>> i['foo'] = 'bar' >>> i.foo 'bar' Natural attribute access takes precedence >>> i.foo = 'henry' >>> i.foo 'henry' But as you might expect, the mapping functionality is preserved. >>> i['foo'] 'bar' A normal attribute error should be raised if an attribute is requested that doesn't exist. >>> i.missing Traceback (most recent call last): ... AttributeError: 'C' object has no attribute 'missing' It also works on dicts that customize __getitem__ >>> missing_func = lambda self, key: 'missing item' >>> C = type( ... 'C', ... (dict, ItemsAsAttributes), ... dict(__missing__ = missing_func), ... ) >>> i = C() >>> i.missing 'missing item' >>> i.foo 'missing item' c s~ zt t� |�W S ty> } z+t� }dd� }|| ||�}||ur(|W Y d }~S |j\}|�d| jjd�}|f|_� d }~ww )Nc S rm r rn )�contr+ �missing_resultr r r � _safe_getitem s �z4ItemsAsAttributes.__getattr__.<locals>._safe_getitemr> � )r� r> �AttributeErrorr� r@ �replacerC r6 )r& r+ �e�novalr� rb �messagerB r r � __getattr__ s ��z ItemsAsAttributes.__getattr__)r6 r7 r8 r9 r� rE r r rB r r� � s ,r� c C s2 t dd� | �� D ��}t|�t| �kstd��|S )a� Given a dictionary, return another dictionary with keys and values switched. If any of the values resolve to the same key, raises a ValueError. >>> numbers = dict(a=1, b=2, c=3) >>> letters = invert_map(numbers) >>> letters[1] 'a' >>> numbers['d'] = 3 >>> invert_map(numbers) Traceback (most recent call last): ... ValueError: Key conflict in inverted mapping c s s � | ] \}}||fV qd S r r )rF �k�vr r r rJ 1 r� z invert_map.<locals>.<genexpr>z Key conflict in inverted mapping)rK rL r2 � ValueError)�map�resr r r � invert_map! s r� c @ � e Zd ZdZdd� ZdS )�IdentityOverrideMapz� A dictionary that by default maps each key to itself, but otherwise acts like a normal dictionary. >>> d = IdentityOverrideMap() >>> d[42] 42 >>> d['speed'] = 'speedo' >>> print(d['speed']) speedo c C s |S r r r* r r r � __missing__D rh z IdentityOverrideMap.__missing__N)r6 r7 r8 r9 r� r r r r r� 7 s r� c @ sN e Zd ZdZdd� Zdd� ZejZdd� Z dd � Z d d � Z d d � Z dd� Z dS )� DictStacka A stack of dictionaries that behaves as a view on those dictionaries, giving preference to the last. >>> stack = DictStack([dict(a=1, c=2), dict(b=2, a=2)]) >>> stack['a'] 2 >>> stack['b'] 2 >>> stack['c'] 2 >>> len(stack) 3 >>> stack.push(dict(a=3)) >>> stack['a'] 3 >>> stack['a'] = 4 >>> set(stack.keys()) == set(['a', 'b', 'c']) True >>> set(stack.items()) == set([('a', 4), ('b', 2), ('c', 2)]) True >>> dict(**stack) == dict(stack) == dict(a=4, c=2, b=2) True >>> d = stack.pop() >>> stack['a'] 2 >>> d = stack.pop() >>> stack['a'] 1 >>> stack.get('b', None) >>> 'c' in stack True >>> del stack['c'] >>> dict(stack) {'a': 1} c C s( t �| �}tttj�dd� |D ����S )Nc s s � | ]}|� � V qd S r )r" )rF �cr r r rJ p � � z%DictStack.__iter__.<locals>.<genexpr>)�listr1 �iterr � itertools�chain� from_iterable)r& �dictsr r r r1 n s zDictStack.__iter__c C s4 t tt�| ���D ] }||v r|| S q t|��r )�reversedr3 r� r1 r) )r& r+ �scoper r r r, r s �zDictStack.__getitem__c C s t jj�| |�S r )� collections�abcr r �r& �otherr r r r z r5 zDictStack.__contains__c C s t tt| ���S r )r2 r� r� r. r r r r4 } r5 zDictStack.__len__c C s t �| d�}|�||�S �Nr{ )r� r, r� )r& r+ r\ �lastr r r r� � s zDictStack.__setitem__c C s t �| d�}|�|�S r� )r� r, r� )r& r+ r� r r r r� � s zDictStack.__delitem__c O s t j| g|�R i |��S r )r� r� r? r r r r� � s z DictStack.popN)r6 r7 r8 r9 r1 r, r� �append�pushr r4 r� r� r� r r r r r� H s % r� c sT e Zd ZdZ� fdd�Z� fdd�Zdd� Z� fdd �Z� fd d �Zd d � Z � Z S )� BijectiveMapa� A Bijective Map (two-way mapping). Implemented as a simple dictionary of 2x the size, mapping values back to keys. Note, this implementation may be incomplete. If there's not a test for your use case below, it's likely to fail, so please test and send pull requests or patches for additional functionality needed. >>> m = BijectiveMap() >>> m['a'] = 'b' >>> m == {'a': 'b', 'b': 'a'} True >>> print(m['b']) a >>> m['c'] = 'd' >>> len(m) 2 Some weird things happen if you map an item to itself or overwrite a single key of a pair, so it's disallowed. >>> m['e'] = 'e' Traceback (most recent call last): ValueError: Key cannot map to itself >>> m['d'] = 'e' Traceback (most recent call last): ValueError: Key/Value pairs may not overlap >>> m['e'] = 'd' Traceback (most recent call last): ValueError: Key/Value pairs may not overlap >>> print(m.pop('d')) c >>> 'c' in m False >>> m = BijectiveMap(dict(a='b')) >>> len(m) 1 >>> print(m['b']) a >>> m = BijectiveMap() >>> m.update(a='b') >>> m['b'] 'a' >>> del m['b'] >>> len(m) 0 >>> 'a' in m False c s t � �� | j|i |�� d S r )r> r' �updater? rB r r r' � s zBijectiveMap.__init__c sd ||krt d��|| v r| | |kp|| v o| | |k}|r"t d��t� �||� t� �||� d S )NzKey cannot map to itselfz Key/Value pairs may not overlap)r� r> r� )r& r\ rG �overlaprB r r r� � s � �zBijectiveMap.__setitem__c C s | � |� d S r )r� )r& r\ r r r r� � r0 zBijectiveMap.__delitem__c s t � �� d S )N� )r> r4 r. rB r r r4 � r0 zBijectiveMap.__len__c s. | | }t � �|� t � j|g|�R i |��S r )r> r� r� )r& r+ r@ rA �mirrorrB r r r� � s zBijectiveMap.popc O s* t |i |��}|�� D ]}| j|� q d S r )rK rL r� )r& r@ rA r� r\ r r r r� � s �zBijectiveMap.update) r6 r7 r8 r9 r' r� r� r4 r� r� rE r r rB r r� � s = r� c sf e Zd ZdZdgZ� fdd�Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z � ZS )� FrozenDicta� An immutable mapping. >>> a = FrozenDict(a=1, b=2) >>> b = FrozenDict(a=1, b=2) >>> a == b True >>> a == dict(a=1, b=2) True >>> dict(a=1, b=2) == a True >>> 'a' in a True >>> type(hash(a)) is type(0) True >>> set(iter(a)) == {'a', 'b'} True >>> len(a) 2 >>> a['a'] == a.get('a') == 1 True >>> a['c'] = 3 Traceback (most recent call last): ... TypeError: 'FrozenDict' object does not support item assignment >>> a.update(y=3) Traceback (most recent call last): ... AttributeError: 'FrozenDict' object has no attribute 'update' Copies should compare equal >>> copy.copy(a) == a True Copies should be the same type >>> isinstance(copy.copy(a), FrozenDict) True FrozenDict supplies .copy(), even though collections.abc.Mapping doesn't demand it. >>> a.copy() == a True >>> a.copy() is not a True �__datac s t � �| �}t|i |��|_|S r )r> �__new__rK �_FrozenDict__data)rZ r@ rA r& rB r r r� ' s zFrozenDict.__new__c C s || j v S r �r� r* r r r r - r� zFrozenDict.__contains__c C s t tt| j�� ���S r )�hashr3 r] r� rL r. r r r �__hash__1 s zFrozenDict.__hash__c C � t | j�S r )r� r� r. r r r r1 5 r� zFrozenDict.__iter__c C r� r )r2 r� r. r r r r4 8 r� zFrozenDict.__len__c C s | j | S r r� r* r r r r, ; r� zFrozenDict.__getitem__c O s | j j|i |��S r )r� rg r? r r r rg ? � zFrozenDict.getc C s t |t�r|j}| j�|�S r )r r� r� �__eq__r� r r r r� C s zFrozenDict.__eq__c C s t � | �S )z Return a shallow copy of self)�copyr. r r r r� H s zFrozenDict.copy)r6 r7 r8 r9 � __slots__r� r r� r1 r4 r, rg r� r� rE r r rB r r� � s 4 r� c s: e Zd ZdZd � fdd� Zedd� �Zedd� �Z� ZS ) � Enumerationa� A convenient way to provide enumerated values >>> e = Enumeration('a b c') >>> e['a'] 0 >>> e.a 0 >>> e[1] 'b' >>> set(e.names) == set('abc') True >>> set(e.codes) == set(range(3)) True >>> e.get('d') is None True Codes need not start with 0 >>> e = Enumeration('a b c', range(1, 4)) >>> e['a'] 1 >>> e[3] 'c' Nc s8 t |t�r |�� }|d u rt�� }t� �t||�� d S r )r �str�splitr� �countr> r' �zip)r& �names�codesrB r r r' n s zEnumeration.__init__c C s dd� | D �S )Nc s s � | ] }t |t�r|V qd S r )r r� )rF r+ r r r rJ w s � z$Enumeration.names.<locals>.<genexpr>r r. r r r r� u s zEnumeration.namesc s � fdd�� j D �S )Nc 3 s � | ]}� | V qd S r r )rF r� r. r r rJ { r� z$Enumeration.codes.<locals>.<genexpr>)r� r. r r. r r� y s zEnumeration.codesr ) r6 r7 r8 r9 r' �propertyr� r� rE r r rB r r� M s r� c @ r� )� Everythinga A collection "containing" every possible thing. >>> 'foo' in Everything() True >>> import random >>> random.randint(1, 999) in Everything() True >>> random.choice([None, 'foo', 42, ('a', 'b', 'c')]) in Everything() True c C � dS �NTr r� r r r r � rh zEverything.__contains__N)r6 r7 r8 r9 r r r r r r� ~ s r� c r: )�InstrumentedDictaD Instrument an existing dictionary with additional functionality, but always reference and mutate the original dictionary. >>> orig = {'a': 1, 'b': 2} >>> inst = InstrumentedDict(orig) >>> inst['a'] 1 >>> inst['c'] = 3 >>> orig['c'] 3 >>> inst.keys() == orig.keys() True c s t � �� || _d S r )r> r' �data)r& r� rB r r r' � r( zInstrumentedDict.__init__rD r r rB r r� � s r� c @ �( e Zd ZdZdd� ZeZdd� ZeZdS )�Leasta A value that is always lesser than any other >>> least = Least() >>> 3 < least False >>> 3 > least True >>> least < 3 True >>> least <= 3 True >>> least > 3 False >>> 'x' > least True >>> None > least True c C r� r� r r� r r r �__le__� rh z Least.__le__c C r� �NFr r� r r r �__ge__� rh z Least.__ge__N)r6 r7 r8 r9 r� �__lt__r� �__gt__r r r r r� � � r� c @ r� )�Greatesta2 A value that is always greater than any other >>> greatest = Greatest() >>> 3 < greatest True >>> 3 > greatest False >>> greatest < 3 False >>> greatest > 3 True >>> greatest >= 3 True >>> 'x' > greatest False >>> None > greatest False c C r� r� r r� r r r r� � rh zGreatest.__ge__c C r� r� r r� r r r r� � rh zGreatest.__le__N)r6 r7 r8 r9 r� r� r� r� r r r r r� � r� r� c C s | dd� g }| dd�< |S )z� Clear items in place and return a copy of items. >>> items = [1, 2, 3] >>> popped = pop_all(items) >>> popped is items False >>> popped [1, 2, 3] >>> items [] Nr )rL rb r r r �pop_all� s r� c �( e Zd ZdZ� fdd�Zdd� Z� ZS )�FreezableDefaultDicta! Often it is desirable to prevent the mutation of a default dict after its initial construction, such as to prevent mutation during iteration. >>> dd = FreezableDefaultDict(list) >>> dd[0].append('1') >>> dd.freeze() >>> dd[1] [] >>> len(dd) 1 c s t | dt� j�|�S )N�_frozen)r� r> r� r* rB r r r� s z FreezableDefaultDict.__missing__c s � fdd�� _ d S )Nc s � � � S r )�default_factoryr� r. r r r= s z-FreezableDefaultDict.freeze.<locals>.<lambda>)r� r. r r. r �freeze r� zFreezableDefaultDict.freeze)r6 r7 r8 r9 r� r� rE r r rB r r� � s r� c @ s e Zd Zddd�Zdd� ZdS )� Accumulatorr c C r� r �r� )r& �initialr r r r' r� zAccumulator.__init__c C s | j |7 _ | j S r r� )r& r� r r r �__call__ s zAccumulator.__call__N)r )r6 r7 r8 r' r� r r r r r� s r� c r� )�WeightedLookupa� Given parameters suitable for a dict representing keys and a weighted proportion, return a RangeMap representing spans of values proportial to the weights: >>> even = WeightedLookup(a=1, b=1) [0, 1) -> a [1, 2) -> b >>> lk = WeightedLookup(a=1, b=2) [0, 1) -> a [1, 3) -> b >>> lk[.5] 'a' >>> lk[1.5] 'b' Adds ``.random()`` to select a random weighted value: >>> lk.random() in ['a', 'b'] True >>> choices = [lk.random() for x in range(1000)] Statistically speaking, choices should be .5 a:b >>> ratio = choices.count('a') / choices.count('b') >>> .4 < ratio < .6 True c s> t |i |��}tt� |�� �}t� jt||�� �tj d� d S )N)rT ) rK r� r� �valuesr> r' r� r" rX �lt)r& r@ rA �raw�indexesrB r r r' 9 s zWeightedLookup.__init__c C s | � � \}}t�� | }| | S r )ry �random)r& �lower�upper�selectorr r r r @ s zWeightedLookup.random)r6 r7 r8 r9 r' r rE r r rB r r� s !r� )r r r r )B� __future__r �collections.abcr� r� rp r� rX r r r r r �typingr r r r r r r � jaraco.textr� � _operatorr � _typeshedr �typing_extensionsr r r r r r r r� r! r; rN rO r� r� rK r� r� r� r� r� r� r� �MutableMappingr� r� �Hashabler� r� r� �UserDictr� r� r� r� � defaultdictr� r� r� r r r r �<module> s\ $ A 9PFEc]1 _vendor/jaraco/collections/py.typed 0000644 00000000000 15030122015 0013427 0 ustar 00 _vendor/jaraco/collections/__init__.py 0000644 00000064020 15030122015 0014055 0 ustar 00 from __future__ import annotations import collections.abc import copy import functools import itertools import operator import random import re from collections.abc import Container, Iterable, Mapping from typing import TYPE_CHECKING, Any, Callable, Dict, TypeVar, Union, overload import jaraco.text if TYPE_CHECKING: from _operator import _SupportsComparison from _typeshed import SupportsKeysAndGetItem from typing_extensions import Self _RangeMapKT = TypeVar('_RangeMapKT', bound=_SupportsComparison) else: # _SupportsComparison doesn't exist at runtime, # but _RangeMapKT is used in RangeMap's superclass' type parameters _RangeMapKT = TypeVar('_RangeMapKT') _T = TypeVar('_T') _VT = TypeVar('_VT') _Matchable = Union[Callable, Container, Iterable, re.Pattern] def _dispatch(obj: _Matchable) -> Callable: # can't rely on singledispatch for Union[Container, Iterable] # due to ambiguity # (https://peps.python.org/pep-0443/#abstract-base-classes). if isinstance(obj, re.Pattern): return obj.fullmatch # mypy issue: https://github.com/python/mypy/issues/11071 if not isinstance(obj, Callable): # type: ignore[arg-type] if not isinstance(obj, Container): obj = set(obj) # type: ignore[arg-type] obj = obj.__contains__ return obj # type: ignore[return-value] class Projection(collections.abc.Mapping): """ Project a set of keys over a mapping >>> sample = {'a': 1, 'b': 2, 'c': 3} >>> prj = Projection(['a', 'c', 'd'], sample) >>> dict(prj) {'a': 1, 'c': 3} Projection also accepts an iterable or callable or pattern. >>> iter_prj = Projection(iter('acd'), sample) >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample) >>> pat_prj = Projection(re.compile(r'[acd]'), sample) >>> prj == iter_prj == call_prj == pat_prj True Keys should only appear if they were specified and exist in the space. Order is retained. >>> list(prj) ['a', 'c'] Attempting to access a key not in the projection results in a KeyError. >>> prj['b'] Traceback (most recent call last): ... KeyError: 'b' Use the projection to update another dict. >>> target = {'a': 2, 'b': 2} >>> target.update(prj) >>> target {'a': 1, 'b': 2, 'c': 3} Projection keeps a reference to the original dict, so modifying the original dict may modify the Projection. >>> del sample['a'] >>> dict(prj) {'c': 3} """ def __init__(self, keys: _Matchable, space: Mapping): self._match = _dispatch(keys) self._space = space def __getitem__(self, key): if not self._match(key): raise KeyError(key) return self._space[key] def _keys_resolved(self): return filter(self._match, self._space) def __iter__(self): return self._keys_resolved() def __len__(self): return len(tuple(self._keys_resolved())) class Mask(Projection): """ The inverse of a :class:`Projection`, masking out keys. >>> sample = {'a': 1, 'b': 2, 'c': 3} >>> msk = Mask(['a', 'c', 'd'], sample) >>> dict(msk) {'b': 2} """ def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) # self._match = compose(operator.not_, self._match) self._match = lambda key, orig=self._match: not orig(key) def dict_map(function, dictionary): """ Return a new dict with function applied to values of dictionary. >>> dict_map(lambda x: x+1, dict(a=1, b=2)) {'a': 2, 'b': 3} """ return dict((key, function(value)) for key, value in dictionary.items()) class RangeMap(Dict[_RangeMapKT, _VT]): """ A dictionary-like object that uses the keys as bounds for a range. Inclusion of the value for that range is determined by the key_match_comparator, which defaults to less-than-or-equal. A value is returned for a key if it is the first key that matches in the sorted list of keys. One may supply keyword parameters to be passed to the sort function used to sort keys (i.e. key, reverse) as sort_params. Create a map that maps 1-3 -> 'a', 4-6 -> 'b' >>> r = RangeMap({3: 'a', 6: 'b'}) # boy, that was easy >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') Even float values should work so long as the comparison operator supports it. >>> r[4.5] 'b' Notice that the way rangemap is defined, it must be open-ended on one side. >>> r[0] 'a' >>> r[-1] 'a' One can close the open-end of the RangeMap by using undefined_value >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'}) >>> r[0] Traceback (most recent call last): ... KeyError: 0 One can get the first or last elements in the range by using RangeMap.Item >>> last_item = RangeMap.Item(-1) >>> r[last_item] 'b' .last_item is a shortcut for Item(-1) >>> r[RangeMap.last_item] 'b' Sometimes it's useful to find the bounds for a RangeMap >>> r.bounds() (0, 6) RangeMap supports .get(key, default) >>> r.get(0, 'not found') 'not found' >>> r.get(7, 'not found') 'not found' One often wishes to define the ranges by their left-most values, which requires use of sort params and a key_match_comparator. >>> r = RangeMap({1: 'a', 4: 'b'}, ... sort_params=dict(reverse=True), ... key_match_comparator=operator.ge) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') That wasn't nearly as easy as before, so an alternate constructor is provided: >>> r = RangeMap.left({1: 'a', 4: 'b', 7: RangeMap.undefined_value}) >>> r[1], r[2], r[3], r[4], r[5], r[6] ('a', 'a', 'a', 'b', 'b', 'b') """ def __init__( self, source: ( SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]] ), sort_params: Mapping[str, Any] = {}, key_match_comparator: Callable[[_RangeMapKT, _RangeMapKT], bool] = operator.le, ): dict.__init__(self, source) self.sort_params = sort_params self.match = key_match_comparator @classmethod def left( cls, source: ( SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]] ), ) -> Self: return cls( source, sort_params=dict(reverse=True), key_match_comparator=operator.ge ) def __getitem__(self, item: _RangeMapKT) -> _VT: sorted_keys = sorted(self.keys(), **self.sort_params) if isinstance(item, RangeMap.Item): result = self.__getitem__(sorted_keys[item]) else: key = self._find_first_match_(sorted_keys, item) result = dict.__getitem__(self, key) if result is RangeMap.undefined_value: raise KeyError(key) return result @overload # type: ignore[override] # Signature simplified over dict and Mapping def get(self, key: _RangeMapKT, default: _T) -> _VT | _T: ... @overload def get(self, key: _RangeMapKT, default: None = None) -> _VT | None: ... def get(self, key: _RangeMapKT, default: _T | None = None) -> _VT | _T | None: """ Return the value for key if key is in the dictionary, else default. If default is not given, it defaults to None, so that this method never raises a KeyError. """ try: return self[key] except KeyError: return default def _find_first_match_( self, keys: Iterable[_RangeMapKT], item: _RangeMapKT ) -> _RangeMapKT: is_match = functools.partial(self.match, item) matches = filter(is_match, keys) try: return next(matches) except StopIteration: raise KeyError(item) from None def bounds(self) -> tuple[_RangeMapKT, _RangeMapKT]: sorted_keys = sorted(self.keys(), **self.sort_params) return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item]) # some special values for the RangeMap undefined_value = type('RangeValueUndefined', (), {})() class Item(int): """RangeMap Item""" first_item = Item(0) last_item = Item(-1) def __identity(x): return x def sorted_items(d, key=__identity, reverse=False): """ Return the items of the dictionary sorted by the keys. >>> sample = dict(foo=20, bar=42, baz=10) >>> tuple(sorted_items(sample)) (('bar', 42), ('baz', 10), ('foo', 20)) >>> reverse_string = lambda s: ''.join(reversed(s)) >>> tuple(sorted_items(sample, key=reverse_string)) (('foo', 20), ('bar', 42), ('baz', 10)) >>> tuple(sorted_items(sample, reverse=True)) (('foo', 20), ('baz', 10), ('bar', 42)) """ # wrap the key func so it operates on the first element of each item def pairkey_key(item): return key(item[0]) return sorted(d.items(), key=pairkey_key, reverse=reverse) class KeyTransformingDict(dict): """ A dict subclass that transforms the keys before they're used. Subclasses may override the default transform_key to customize behavior. """ @staticmethod def transform_key(key): # pragma: nocover return key def __init__(self, *args, **kargs): super().__init__() # build a dictionary using the default constructs d = dict(*args, **kargs) # build this dictionary using transformed keys. for item in d.items(): self.__setitem__(*item) def __setitem__(self, key, val): key = self.transform_key(key) super().__setitem__(key, val) def __getitem__(self, key): key = self.transform_key(key) return super().__getitem__(key) def __contains__(self, key): key = self.transform_key(key) return super().__contains__(key) def __delitem__(self, key): key = self.transform_key(key) return super().__delitem__(key) def get(self, key, *args, **kwargs): key = self.transform_key(key) return super().get(key, *args, **kwargs) def setdefault(self, key, *args, **kwargs): key = self.transform_key(key) return super().setdefault(key, *args, **kwargs) def pop(self, key, *args, **kwargs): key = self.transform_key(key) return super().pop(key, *args, **kwargs) def matching_key_for(self, key): """ Given a key, return the actual key stored in self that matches. Raise KeyError if the key isn't found. """ try: return next(e_key for e_key in self.keys() if e_key == key) except StopIteration as err: raise KeyError(key) from err class FoldedCaseKeyedDict(KeyTransformingDict): """ A case-insensitive dictionary (keys are compared as insensitive if they are strings). >>> d = FoldedCaseKeyedDict() >>> d['heLlo'] = 'world' >>> list(d.keys()) == ['heLlo'] True >>> list(d.values()) == ['world'] True >>> d['hello'] == 'world' True >>> 'hello' in d True >>> 'HELLO' in d True >>> print(repr(FoldedCaseKeyedDict({'heLlo': 'world'}))) {'heLlo': 'world'} >>> d = FoldedCaseKeyedDict({'heLlo': 'world'}) >>> print(d['hello']) world >>> print(d['Hello']) world >>> list(d.keys()) ['heLlo'] >>> d = FoldedCaseKeyedDict({'heLlo': 'world', 'Hello': 'world'}) >>> list(d.values()) ['world'] >>> key, = d.keys() >>> key in ['heLlo', 'Hello'] True >>> del d['HELLO'] >>> d {} get should work >>> d['Sumthin'] = 'else' >>> d.get('SUMTHIN') 'else' >>> d.get('OTHER', 'thing') 'thing' >>> del d['sumthin'] setdefault should also work >>> d['This'] = 'that' >>> print(d.setdefault('this', 'other')) that >>> len(d) 1 >>> print(d['this']) that >>> print(d.setdefault('That', 'other')) other >>> print(d['THAT']) other Make it pop! >>> print(d.pop('THAT')) other To retrieve the key in its originally-supplied form, use matching_key_for >>> print(d.matching_key_for('this')) This >>> d.matching_key_for('missing') Traceback (most recent call last): ... KeyError: 'missing' """ @staticmethod def transform_key(key): return jaraco.text.FoldedCase(key) class DictAdapter: """ Provide a getitem interface for attributes of an object. Let's say you want to get at the string.lowercase property in a formatted string. It's easy with DictAdapter. >>> import string >>> print("lowercase is %(ascii_lowercase)s" % DictAdapter(string)) lowercase is abcdefghijklmnopqrstuvwxyz """ def __init__(self, wrapped_ob): self.object = wrapped_ob def __getitem__(self, name): return getattr(self.object, name) class ItemsAsAttributes: """ Mix-in class to enable a mapping object to provide items as attributes. >>> C = type('C', (dict, ItemsAsAttributes), dict()) >>> i = C() >>> i['foo'] = 'bar' >>> i.foo 'bar' Natural attribute access takes precedence >>> i.foo = 'henry' >>> i.foo 'henry' But as you might expect, the mapping functionality is preserved. >>> i['foo'] 'bar' A normal attribute error should be raised if an attribute is requested that doesn't exist. >>> i.missing Traceback (most recent call last): ... AttributeError: 'C' object has no attribute 'missing' It also works on dicts that customize __getitem__ >>> missing_func = lambda self, key: 'missing item' >>> C = type( ... 'C', ... (dict, ItemsAsAttributes), ... dict(__missing__ = missing_func), ... ) >>> i = C() >>> i.missing 'missing item' >>> i.foo 'missing item' """ def __getattr__(self, key): try: return getattr(super(), key) except AttributeError as e: # attempt to get the value from the mapping (return self[key]) # but be careful not to lose the original exception context. noval = object() def _safe_getitem(cont, key, missing_result): try: return cont[key] except KeyError: return missing_result result = _safe_getitem(self, key, noval) if result is not noval: return result # raise the original exception, but use the original class # name, not 'super'. (message,) = e.args message = message.replace('super', self.__class__.__name__, 1) e.args = (message,) raise def invert_map(map): """ Given a dictionary, return another dictionary with keys and values switched. If any of the values resolve to the same key, raises a ValueError. >>> numbers = dict(a=1, b=2, c=3) >>> letters = invert_map(numbers) >>> letters[1] 'a' >>> numbers['d'] = 3 >>> invert_map(numbers) Traceback (most recent call last): ... ValueError: Key conflict in inverted mapping """ res = dict((v, k) for k, v in map.items()) if not len(res) == len(map): raise ValueError('Key conflict in inverted mapping') return res class IdentityOverrideMap(dict): """ A dictionary that by default maps each key to itself, but otherwise acts like a normal dictionary. >>> d = IdentityOverrideMap() >>> d[42] 42 >>> d['speed'] = 'speedo' >>> print(d['speed']) speedo """ def __missing__(self, key): return key class DictStack(list, collections.abc.MutableMapping): """ A stack of dictionaries that behaves as a view on those dictionaries, giving preference to the last. >>> stack = DictStack([dict(a=1, c=2), dict(b=2, a=2)]) >>> stack['a'] 2 >>> stack['b'] 2 >>> stack['c'] 2 >>> len(stack) 3 >>> stack.push(dict(a=3)) >>> stack['a'] 3 >>> stack['a'] = 4 >>> set(stack.keys()) == set(['a', 'b', 'c']) True >>> set(stack.items()) == set([('a', 4), ('b', 2), ('c', 2)]) True >>> dict(**stack) == dict(stack) == dict(a=4, c=2, b=2) True >>> d = stack.pop() >>> stack['a'] 2 >>> d = stack.pop() >>> stack['a'] 1 >>> stack.get('b', None) >>> 'c' in stack True >>> del stack['c'] >>> dict(stack) {'a': 1} """ def __iter__(self): dicts = list.__iter__(self) return iter(set(itertools.chain.from_iterable(c.keys() for c in dicts))) def __getitem__(self, key): for scope in reversed(tuple(list.__iter__(self))): if key in scope: return scope[key] raise KeyError(key) push = list.append def __contains__(self, other): return collections.abc.Mapping.__contains__(self, other) def __len__(self): return len(list(iter(self))) def __setitem__(self, key, item): last = list.__getitem__(self, -1) return last.__setitem__(key, item) def __delitem__(self, key): last = list.__getitem__(self, -1) return last.__delitem__(key) # workaround for mypy confusion def pop(self, *args, **kwargs): return list.pop(self, *args, **kwargs) class BijectiveMap(dict): """ A Bijective Map (two-way mapping). Implemented as a simple dictionary of 2x the size, mapping values back to keys. Note, this implementation may be incomplete. If there's not a test for your use case below, it's likely to fail, so please test and send pull requests or patches for additional functionality needed. >>> m = BijectiveMap() >>> m['a'] = 'b' >>> m == {'a': 'b', 'b': 'a'} True >>> print(m['b']) a >>> m['c'] = 'd' >>> len(m) 2 Some weird things happen if you map an item to itself or overwrite a single key of a pair, so it's disallowed. >>> m['e'] = 'e' Traceback (most recent call last): ValueError: Key cannot map to itself >>> m['d'] = 'e' Traceback (most recent call last): ValueError: Key/Value pairs may not overlap >>> m['e'] = 'd' Traceback (most recent call last): ValueError: Key/Value pairs may not overlap >>> print(m.pop('d')) c >>> 'c' in m False >>> m = BijectiveMap(dict(a='b')) >>> len(m) 1 >>> print(m['b']) a >>> m = BijectiveMap() >>> m.update(a='b') >>> m['b'] 'a' >>> del m['b'] >>> len(m) 0 >>> 'a' in m False """ def __init__(self, *args, **kwargs): super().__init__() self.update(*args, **kwargs) def __setitem__(self, item, value): if item == value: raise ValueError("Key cannot map to itself") overlap = ( item in self and self[item] != value or value in self and self[value] != item ) if overlap: raise ValueError("Key/Value pairs may not overlap") super().__setitem__(item, value) super().__setitem__(value, item) def __delitem__(self, item): self.pop(item) def __len__(self): return super().__len__() // 2 def pop(self, key, *args, **kwargs): mirror = self[key] super().__delitem__(mirror) return super().pop(key, *args, **kwargs) def update(self, *args, **kwargs): # build a dictionary using the default constructs d = dict(*args, **kwargs) # build this dictionary using transformed keys. for item in d.items(): self.__setitem__(*item) class FrozenDict(collections.abc.Mapping, collections.abc.Hashable): """ An immutable mapping. >>> a = FrozenDict(a=1, b=2) >>> b = FrozenDict(a=1, b=2) >>> a == b True >>> a == dict(a=1, b=2) True >>> dict(a=1, b=2) == a True >>> 'a' in a True >>> type(hash(a)) is type(0) True >>> set(iter(a)) == {'a', 'b'} True >>> len(a) 2 >>> a['a'] == a.get('a') == 1 True >>> a['c'] = 3 Traceback (most recent call last): ... TypeError: 'FrozenDict' object does not support item assignment >>> a.update(y=3) Traceback (most recent call last): ... AttributeError: 'FrozenDict' object has no attribute 'update' Copies should compare equal >>> copy.copy(a) == a True Copies should be the same type >>> isinstance(copy.copy(a), FrozenDict) True FrozenDict supplies .copy(), even though collections.abc.Mapping doesn't demand it. >>> a.copy() == a True >>> a.copy() is not a True """ __slots__ = ['__data'] def __new__(cls, *args, **kwargs): self = super().__new__(cls) self.__data = dict(*args, **kwargs) return self # Container def __contains__(self, key): return key in self.__data # Hashable def __hash__(self): return hash(tuple(sorted(self.__data.items()))) # Mapping def __iter__(self): return iter(self.__data) def __len__(self): return len(self.__data) def __getitem__(self, key): return self.__data[key] # override get for efficiency provided by dict def get(self, *args, **kwargs): return self.__data.get(*args, **kwargs) # override eq to recognize underlying implementation def __eq__(self, other): if isinstance(other, FrozenDict): other = other.__data return self.__data.__eq__(other) def copy(self): "Return a shallow copy of self" return copy.copy(self) class Enumeration(ItemsAsAttributes, BijectiveMap): """ A convenient way to provide enumerated values >>> e = Enumeration('a b c') >>> e['a'] 0 >>> e.a 0 >>> e[1] 'b' >>> set(e.names) == set('abc') True >>> set(e.codes) == set(range(3)) True >>> e.get('d') is None True Codes need not start with 0 >>> e = Enumeration('a b c', range(1, 4)) >>> e['a'] 1 >>> e[3] 'c' """ def __init__(self, names, codes=None): if isinstance(names, str): names = names.split() if codes is None: codes = itertools.count() super().__init__(zip(names, codes)) @property def names(self): return (key for key in self if isinstance(key, str)) @property def codes(self): return (self[name] for name in self.names) class Everything: """ A collection "containing" every possible thing. >>> 'foo' in Everything() True >>> import random >>> random.randint(1, 999) in Everything() True >>> random.choice([None, 'foo', 42, ('a', 'b', 'c')]) in Everything() True """ def __contains__(self, other): return True class InstrumentedDict(collections.UserDict): """ Instrument an existing dictionary with additional functionality, but always reference and mutate the original dictionary. >>> orig = {'a': 1, 'b': 2} >>> inst = InstrumentedDict(orig) >>> inst['a'] 1 >>> inst['c'] = 3 >>> orig['c'] 3 >>> inst.keys() == orig.keys() True """ def __init__(self, data): super().__init__() self.data = data class Least: """ A value that is always lesser than any other >>> least = Least() >>> 3 < least False >>> 3 > least True >>> least < 3 True >>> least <= 3 True >>> least > 3 False >>> 'x' > least True >>> None > least True """ def __le__(self, other): return True __lt__ = __le__ def __ge__(self, other): return False __gt__ = __ge__ class Greatest: """ A value that is always greater than any other >>> greatest = Greatest() >>> 3 < greatest True >>> 3 > greatest False >>> greatest < 3 False >>> greatest > 3 True >>> greatest >= 3 True >>> 'x' > greatest False >>> None > greatest False """ def __ge__(self, other): return True __gt__ = __ge__ def __le__(self, other): return False __lt__ = __le__ def pop_all(items): """ Clear items in place and return a copy of items. >>> items = [1, 2, 3] >>> popped = pop_all(items) >>> popped is items False >>> popped [1, 2, 3] >>> items [] """ result, items[:] = items[:], [] return result class FreezableDefaultDict(collections.defaultdict): """ Often it is desirable to prevent the mutation of a default dict after its initial construction, such as to prevent mutation during iteration. >>> dd = FreezableDefaultDict(list) >>> dd[0].append('1') >>> dd.freeze() >>> dd[1] [] >>> len(dd) 1 """ def __missing__(self, key): return getattr(self, '_frozen', super().__missing__)(key) def freeze(self): self._frozen = lambda key: self.default_factory() class Accumulator: def __init__(self, initial=0): self.val = initial def __call__(self, val): self.val += val return self.val class WeightedLookup(RangeMap): """ Given parameters suitable for a dict representing keys and a weighted proportion, return a RangeMap representing spans of values proportial to the weights: >>> even = WeightedLookup(a=1, b=1) [0, 1) -> a [1, 2) -> b >>> lk = WeightedLookup(a=1, b=2) [0, 1) -> a [1, 3) -> b >>> lk[.5] 'a' >>> lk[1.5] 'b' Adds ``.random()`` to select a random weighted value: >>> lk.random() in ['a', 'b'] True >>> choices = [lk.random() for x in range(1000)] Statistically speaking, choices should be .5 a:b >>> ratio = choices.count('a') / choices.count('b') >>> .4 < ratio < .6 True """ def __init__(self, *args, **kwargs): raw = dict(*args, **kwargs) # allocate keys by weight indexes = map(Accumulator(), raw.values()) super().__init__(zip(indexes, raw.keys()), key_match_comparator=operator.lt) def random(self): lower, upper = self.bounds() selector = random.random() * upper return self[selector] _vendor/typeguard-4.3.0.dist-info/RECORD 0000644 00000004542 15030122015 0013432 0 ustar 00 typeguard-4.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 typeguard-4.3.0.dist-info/LICENSE,sha256=YWP3mH37ONa8MgzitwsvArhivEESZRbVUu8c1DJH51g,1130 typeguard-4.3.0.dist-info/METADATA,sha256=z2dcHAp0TwhYCFU5Deh8x31nazElgujUz9tbuP0pjSE,3717 typeguard-4.3.0.dist-info/RECORD,, typeguard-4.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 typeguard-4.3.0.dist-info/entry_points.txt,sha256=qp7NQ1aLtiSgMQqo6gWlfGpy0IIXzoMJmeQTLpzqFZQ,48 typeguard-4.3.0.dist-info/top_level.txt,sha256=4z28AhuDodwRS_c1J_l8H51t5QuwfTseskYzlxp6grs,10 typeguard/__init__.py,sha256=Onh4w38elPCjtlcU3JY9k3h70NjsxXIkAflmQn-Z0FY,2071 typeguard/__pycache__/__init__.cpython-312.pyc,, typeguard/__pycache__/_checkers.cpython-312.pyc,, typeguard/__pycache__/_config.cpython-312.pyc,, typeguard/__pycache__/_decorators.cpython-312.pyc,, typeguard/__pycache__/_exceptions.cpython-312.pyc,, typeguard/__pycache__/_functions.cpython-312.pyc,, typeguard/__pycache__/_importhook.cpython-312.pyc,, typeguard/__pycache__/_memo.cpython-312.pyc,, typeguard/__pycache__/_pytest_plugin.cpython-312.pyc,, typeguard/__pycache__/_suppression.cpython-312.pyc,, typeguard/__pycache__/_transformer.cpython-312.pyc,, typeguard/__pycache__/_union_transformer.cpython-312.pyc,, typeguard/__pycache__/_utils.cpython-312.pyc,, typeguard/_checkers.py,sha256=JRrgKicdOEfIBoNEtegYCEIlhpad-a1u1Em7GCj0WCI,31360 typeguard/_config.py,sha256=nIz8QwDa-oFO3L9O8_6srzlmd99pSby2wOM4Wb7F_B0,2846 typeguard/_decorators.py,sha256=v6dsIeWvPhExGLP_wXF-RmDUyjZf_Ak28g7gBJ_v0-0,9033 typeguard/_exceptions.py,sha256=ZIPeiV-FBd5Emw2EaWd2Fvlsrwi4ocwT2fVGBIAtHcQ,1121 typeguard/_functions.py,sha256=ibgSAKa5ptIm1eR9ARG0BSozAFJPFNASZqhPVyQeqig,10393 typeguard/_importhook.py,sha256=ugjCDvFcdWMU7UugqlJG91IpVNpEIxtRr-99s0h1k7M,6389 typeguard/_memo.py,sha256=1juQV_vxnD2JYKbSrebiQuj4oKHz6n67v9pYA-CCISg,1303 typeguard/_pytest_plugin.py,sha256=-fcSqkv54rIfIF8pDavY5YQPkj4OX8GMt_lL7CQSD4I,4416 typeguard/_suppression.py,sha256=VQfzxcwIbu3if0f7VBkKM7hkYOA7tNFw9a7jMBsmMg4,2266 typeguard/_transformer.py,sha256=9Ha7_QhdwoUni_6hvdY-hZbuEergowHrNL2vzHIakFY,44937 typeguard/_union_transformer.py,sha256=v_42r7-6HuRX2SoFwnyJ-E5PlxXpVeUJPJR1-HU9qSo,1354 typeguard/_utils.py,sha256=5HhO1rPn5f1M6ymkVAEv7Xmlz1cX-j0OnTMlyHqqrR8,5270 typeguard/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 _vendor/typeguard-4.3.0.dist-info/METADATA 0000644 00000007205 15030122015 0013633 0 ustar 00 Metadata-Version: 2.1 Name: typeguard Version: 4.3.0 Summary: Run-time type checker for Python Author-email: Alex Grönholm <alex.gronholm@nextday.fi> License: MIT Project-URL: Documentation, https://typeguard.readthedocs.io/en/latest/ Project-URL: Change log, https://typeguard.readthedocs.io/en/latest/versionhistory.html Project-URL: Source code, https://github.com/agronholm/typeguard Project-URL: Issue tracker, https://github.com/agronholm/typeguard/issues Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: typing-extensions >=4.10.0 Requires-Dist: importlib-metadata >=3.6 ; python_version < "3.10" Provides-Extra: doc Requires-Dist: packaging ; extra == 'doc' Requires-Dist: Sphinx >=7 ; extra == 'doc' Requires-Dist: sphinx-autodoc-typehints >=1.2.0 ; extra == 'doc' Requires-Dist: sphinx-rtd-theme >=1.3.0 ; extra == 'doc' Provides-Extra: test Requires-Dist: coverage[toml] >=7 ; extra == 'test' Requires-Dist: pytest >=7 ; extra == 'test' Requires-Dist: mypy >=1.2.0 ; (platform_python_implementation != "PyPy") and extra == 'test' .. image:: https://github.com/agronholm/typeguard/actions/workflows/test.yml/badge.svg :target: https://github.com/agronholm/typeguard/actions/workflows/test.yml :alt: Build Status .. image:: https://coveralls.io/repos/agronholm/typeguard/badge.svg?branch=master&service=github :target: https://coveralls.io/github/agronholm/typeguard?branch=master :alt: Code Coverage .. image:: https://readthedocs.org/projects/typeguard/badge/?version=latest :target: https://typeguard.readthedocs.io/en/latest/?badge=latest :alt: Documentation This library provides run-time type checking for functions defined with `PEP 484 <https://www.python.org/dev/peps/pep-0484/>`_ argument (and return) type annotations, and any arbitrary objects. It can be used together with static type checkers as an additional layer of type safety, to catch type violations that could only be detected at run time. Two principal ways to do type checking are provided: #. The ``check_type`` function: * like ``isinstance()``, but supports arbitrary type annotations (within limits) * can be used as a ``cast()`` replacement, but with actual checking of the value #. Code instrumentation: * entire modules, or individual functions (via ``@typechecked``) are recompiled, with type checking code injected into them * automatically checks function arguments, return values and assignments to annotated local variables * for generator functions (regular and async), checks yield and send values * requires the original source code of the instrumented module(s) to be accessible Two options are provided for code instrumentation: #. the ``@typechecked`` function: * can be applied to functions individually #. the import hook (``typeguard.install_import_hook()``): * automatically instruments targeted modules on import * no manual code changes required in the target modules * requires the import hook to be installed before the targeted modules are imported * may clash with other import hooks See the documentation_ for further information. .. _documentation: https://typeguard.readthedocs.io/en/latest/ _vendor/typeguard-4.3.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0013776 0 ustar 00 pip _vendor/typeguard-4.3.0.dist-info/WHEEL 0000644 00000000134 15030122015 0013311 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/typeguard-4.3.0.dist-info/LICENSE 0000644 00000002152 15030122015 0013531 0 ustar 00 This is the MIT license: http://www.opensource.org/licenses/mit-license.php Copyright (c) Alex Grönholm Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/typeguard-4.3.0.dist-info/entry_points.txt 0000644 00000000060 15030122015 0016016 0 ustar 00 [pytest11] typeguard = typeguard._pytest_plugin _vendor/typeguard-4.3.0.dist-info/top_level.txt 0000644 00000000012 15030122015 0015247 0 ustar 00 typeguard _vendor/autocommand/__pycache__/__init__.cpython-310.pyc 0000644 00000000572 15030122015 0017150 0 ustar 00 o �h � @ sP d dl m Z d dlmZmZ d dlmZ z d dlmZ W dS ey' Y dS w )� )�automain)� autoparse� smart_open)� autocommand)� autoasyncN)r r r r r � ImportError� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/__init__.py�<module> s � _vendor/autocommand/__pycache__/autoasync.cpython-310.pyc 0000644 00000010113 15030122015 0017407 0 ustar 00 o �h0 � @ sH d dl mZmZ d dlmZ d dlmZ dd� Zd dddd�d d �ZdS ) � )�get_event_loop� iscoroutine)�wraps)� signaturec � s* �| |i |��}t |�r|I dH dS dS )aT This helper function launches an async main function that was tagged with forever=True. There are two possibilities: - The function is a normal function, which handles initializing the event loop, which is then run forever - The function is a coroutine, which needs to be scheduled in the event loop, which is then run forever - There is also the possibility that the function is a normal function wrapping a coroutine function The function is therefore called unconditionally and scheduled in the event loop if the return value is a coroutine object. The reason this is a separate function is to make absolutely sure that all the objects created are garbage collected after all is said and done; we do this to ensure that any exceptions raised in the tasks are collected ASAP. N)r )�coro�args�kwargs�loop�thing� r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/autoasync.py�_run_forever_coro s ��r NF�r �forever� pass_loopc sl � du r ���fdd�S �r t � ���jdd� �j�� D �d��t� �� �����fdd��}�r4�|_|S ) ak Convert an asyncio coroutine into a function which, when called, is evaluted in an event loop, and the return value returned. This is intented to make it easy to write entry points into asyncio coroutines, which otherwise need to be explictly evaluted with an event loop's run_until_complete. If `loop` is given, it is used as the event loop to run the coro in. If it is None (the default), the loop is retreived using asyncio.get_event_loop. This call is defered until the decorated function is called, so that callers can install custom event loops or event loop policies after @autoasync is applied. If `forever` is True, the loop is run forever after the decorated coroutine is finished. Use this for servers created with asyncio.start_server and the like. If `pass_loop` is True, the event loop object is passed into the coroutine as the `loop` kwarg when the wrapper function is called. In this case, the wrapper function's __signature__ is updated to remove this parameter, so that autoparse can still be used on it without generating a parameter for `loop`. This coroutine can be called with ( @autoasync(...) ) or without ( @autoasync ) arguments. Examples: @autoasync def get_file(host, port): reader, writer = yield from asyncio.open_connection(host, port) data = reader.read() sys.stdout.write(data.decode()) get_file(host, port) @autoasync(forever=True, pass_loop=True) def server(host, port, loop): yield_from loop.create_server(Proto, host, port) server('localhost', 8899) Nc s t | �� �d�S )Nr )� autoasync)�c)r r r r r �<lambda>c s �zautoasync.<locals>.<lambda>c s s � | ] \}}|d kr|V qdS )r Nr )�.0�name�paramr r r � <genexpr>n s � ��z autoasync.<locals>.<genexpr>)� parametersc s� �d u rt � n�}�r(��� }|jjdd|i�j| i |��j�� |j|j} }�r:|�t� | ||�� |� � d S |� � | i |���S )Nr r ) r � bind_partial� arguments�update�bindr r � create_taskr � run_forever�run_until_complete)r r � local_loop� bound_args�r r r �new_sig�old_sigr r r �autoasync_wrapperr s ��� z$autoasync.<locals>.autoasync_wrapper)r �replacer �itemsr � __signature__)r r r r r% r r" r r 6 s , �r )N) �asyncior r � functoolsr �inspectr r r r r r r �<module> s _vendor/autocommand/__pycache__/errors.cpython-310.pyc 0000644 00000000630 15030122015 0016720 0 ustar 00 o �hv � @ s G d d� de �ZdS )c @ s e Zd ZdZdS )�AutocommandErrorz%Base class for autocommand exceptionsN)�__name__� __module__� __qualname__�__doc__� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/errors.pyr s r N)� Exceptionr r r r r �<module> s _vendor/autocommand/__pycache__/automain.cpython-310.pyc 0000644 00000003175 15030122015 0017230 0 ustar 00 o �h � @ s: d dl Z ddlmZ G dd� dee�Zddd�dd �ZdS ) � N� )�AutocommandErrorc @ s e Zd ZdS )�AutomainRequiresModuleErrorN)�__name__� __module__� __qualname__� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/automain.pyr s r r ��args�kwargsc sF t | �rt| ��| dks| du r �du ri �� �fdd�}|S dd� S )a� This decorator automatically invokes a function if the module is being run as the "__main__" module. Optionally, provide args or kwargs with which to call the function. If `module` is "__main__", the function is called, and the program is `sys.exit`ed with the return value. You can also pass `True` to cause the function to be called unconditionally. If the function is not called, it is returned unchanged by the decorator. Usage: @automain(__name__) # Pass __name__ to check __name__=="__main__" def main(): ... If __name__ is "__main__" here, the main function is called, and then sys.exit called with the return value. �__main__TNc s t �| � i ���� d S �N)�sys�exit��mainr r r �automain_decorator6 s z$automain.<locals>.automain_decoratorc S s | S r r r r r r �<lambda>; s zautomain.<locals>.<lambda>)�callabler )�moduler r r r r r �automain s r )r �errorsr � TypeErrorr r r r r r �<module> s _vendor/autocommand/__pycache__/autoparse.cpython-310.pyc 0000644 00000020272 15030122015 0017413 0 ustar 00 o �hz- � @ s d dl Z d dlmZ d dlmZmZmZ d dlm Z d dl m Z d dl m Z d dlmZ d dlmZ ejZG d d � d e�ZG d d � d e�ZG d d� de�ZG dd� de�ZG dd� de�Zdd� Zdd� Zdd� Zed�Z dd� Z d"ddd dd �d d �Z e d d!� �Z dS )#� N)�compile)� signature�getdoc� Parameter)�ArgumentParser)�contextmanager)�wraps)�IOBase)�AutocommandErrorc @ � e Zd ZdZdS )�AnnotationErrorzEAnnotation error: annotation must be a string, type, or tuple of bothN��__name__� __module__� __qualname__�__doc__� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/autoparse.pyr � r c @ r )�PositionalArgErrorzQ Postional Arg Error: autocommand can't handle postional-only parameters Nr r r r r r # r r c @ r )� KWArgErrorz:kwarg Error: autocommand can't handle a **kwargs parameterNr r r r r r ) r r c @ r )�DocstringErrorzDocstring errorNr r r r r r - r r c @ r )�TooManySplitsErrorz� The docstring had too many ---- section splits. Currently we only support using up to a single split, to split the docstring into description and epilog parts. Nr r r r r r 1 r r c C s� | t u rdS t| �r| dfS t| t�rd| fS t| t�rNz| \}}W n ty3 } zt| �|�d}~ww t|�rAt|t�rA||fS t|t�rNt|�rN||fS t| ��)z� Given an annotation, return the (type, description) for the parameter. If you provide an annotation that is somehow both a string and a callable, the behavior is undefined. )NNN)�_empty�callable� isinstance�str�tuple� ValueErrorr )� annotation�arg1�arg2�er r r �_get_type_description9 s$ ��r# c C s� | j | ju r t| ��| j | ju rt| ��i }d}t| j�\}}| j}|du r0|tdhvr0t |�}|tur:||d< d}|durb|t u rT|rH|tu rMd|d< nd|d< d}nt |t �r^t |d< n||d< | j | ju rld |d < |durt||d < g } | j} |r�| d | d �� fD ]} | |vr�|�| � | �d �| �� nq�t| �dks�| s�| �d�| �� | |d< n| �| � |j| i |�� |r�|t u r�|jd�| �d| |tur�|ndd� dS dS dS )a� Add the argument(s) to an ArgumentParser (using add_argument) for a given parameter. used_char_args is the set of -short options currently already in use, and is updated (if necessary) by this function. If add_nos is True, this will also add an inverse switch for all boolean options. For instance, for the boolean parameter "verbose", this will create --verbose and --no-verbose. FN�defaultT� store_true�action� store_false�type�*�nargs�helpr z-{}� z--{}�destz--no-{}� store_const)r& r- �const)�kind�POSITIONAL_ONLYr � VAR_KEYWORDr r# r r$ r r( �boolr r r �VAR_POSITIONAL�name�swapcase�add�append�format�len� add_argument) �param�parser�used_char_args�add_nos�arg_spec� is_option�arg_type� descriptionr$ �flagsr5 �letterr r r �_add_argumentsS s` � ��rF c C sD t ||d�}dh}t| j�� dd� d�}|D ] }t||||� q|S )zE Given the signature of a function, create an ArgumentParser )rC �epilog�hc S s t | j�dkS �Nr, )r: r5 )r< r r r �<lambda>� s z make_parser.<locals>.<lambda>)�key)r �sorted� parameters�valuesrF )�func_sigrC rG r? r= r> �paramsr< r r r � make_parser� s �rQ z\n\s*-{4,}\s*\nc C sL | du rdS t �| �}t|�dkr| dfS t|�dkr#|d |d fS t� �)zH Given a docstring, parse it into a description and epilog part N)� rR r, rR � r )�_DOCSTRING_SPLIT�splitr: r )� docstring�partsr r r �parse_docstring� s rX F�rC rG r? r= c sz �du r � ���fdd�S t ���tt���\}}�du r(t��p"|�p%|� ��t��d���fdd� �}�|_�|_|S )a This decorator converts a function that takes normal arguments into a function which takes a single optional argument, argv, parses it using an argparse.ArgumentParser, and calls the underlying function with the parsed arguments. If it is not given, sys.argv[1:] is used. This is so that the function can be used as a setuptools entry point, as well as a normal main function. sys.argv[1:] is not evaluated until the function is called, to allow injecting different arguments for testing. It uses the argument signature of the function to create an ArgumentParser. Parameters without defaults become positional parameters, while parameters *with* defaults become --options. Use annotations to set the type of the parameter. The `desctiption` and `epilog` parameters corrospond to the same respective argparse parameters. If no description is given, it defaults to the decorated functions's docstring, if present. If add_nos is True, every boolean option (that is, every parameter with a default of True/False or a type of bool) will have a --no- version created as well, which inverts the option. For instance, the --verbose option will have a --no-verbose counterpart. These are not mutually exclusive- whichever one appears last in the argument list will have precedence. If a parser is given, it is used instead of one generated from the function signature. In this case, no parser is created; instead, the given parser is used to parse the argv argument. The parser's results' argument names must match up with the parameter names of the decorated function. The decorated function is attached to the result as the `func` attribute, and the parser is attached as the `parser` attribute. Nc s t | ��� �d�S )NrY )� autoparse)�f)r? rC rG r= r r rJ s �zautoparse.<locals>.<lambda>c sF | d u r t jdd � } ��� }|j�t��| ��� � |ji |j��S rI ) �sys�argv� bind_partial� arguments�update�vars� parse_args�args�kwargs)r] � parsed_args)�funcrO r= r r �autoparse_wrapper" s z$autoparse.<locals>.autoparse_wrapper�N)r rX r rQ r rf r= )rf rC rG r? r= �docstr_description� docstr_epilogrg r )r? rC rG rf rO r= r rZ � s (�rZ c o s^ � t | tttf�r*t| g|�R i |��� }|V W d � dS 1 s#w Y dS | V dS )a] This context manager allows you to open a filename, if you want to default some already-existing file object, like sys.stdout, which shouldn't be closed at the end of the context. If the filename argument is a str, bytes, or int, the file object is created via a call to open with the given *args and **kwargs, sent to the context, and closed at the end of the context, just like "with open(filename) as f:". If it isn't one of the openable types, the object simply sent to the context unchanged, and left unclosed at the end of the context. Example: def work_with_file(name=sys.stdout): with smart_open(name) as f: # Works correctly if name is a str filename or sys.stdout print("Some stuff", file=f) # If it was a filename, f is closed at the end here. N)r r �bytes�int�open)�filename_or_filerc rd �filer r r � smart_open7 s �"� rp rh ) r\ �rer � compile_regex�inspectr r r �argparser � contextlibr � functoolsr �ior �autocommand.errorsr �emptyr r r r r r r# rF rQ rT rX rZ rp r r r r �<module> s8 l� �O _vendor/autocommand/__pycache__/autocommand.cpython-310.pyc 0000644 00000001777 15030122015 0017730 0 ustar 00 o �h� � @ sZ d dl m Z d dlmZ zd dlmZ W n ey Y nw dddddddd�dd�ZdS ) � )� autoparse)�automain)� autoasyncNF)� description�epilog�add_nos�parser�loop�forever� pass_loopc s. t ��rtd��� �������fdd�}|S )Nz+autocommand requires a module name argumentc sN �d us�s�rt | �du rd n���d�} t| ��� �d�} t��| �} | S )NT)r r r )r r r r )r r r )�func�r r r r r �moduler r � �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/autocommand/autocommand.py�autocommand_decorator' s � � z*autocommand.<locals>.autocommand_decorator)�callable� TypeError) r r r r r r r r r r r r � autocommand s r )r r r � ImportErrorr r r r r �<module> s �� _vendor/autocommand/autocommand.py 0000644 00000004711 15030122015 0013360 0 ustar 00 # Copyright 2014-2015 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. from .autoparse import autoparse from .automain import automain try: from .autoasync import autoasync except ImportError: # pragma: no cover pass def autocommand( module, *, description=None, epilog=None, add_nos=False, parser=None, loop=None, forever=False, pass_loop=False): if callable(module): raise TypeError('autocommand requires a module name argument') def autocommand_decorator(func): # Step 1: if requested, run it all in an asyncio event loop. autoasync # patches the __signature__ of the decorated function, so that in the # event that pass_loop is True, the `loop` parameter of the original # function will *not* be interpreted as a command-line argument by # autoparse if loop is not None or forever or pass_loop: func = autoasync( func, loop=None if loop is True else loop, pass_loop=pass_loop, forever=forever) # Step 2: create parser. We do this second so that the arguments are # parsed and passed *before* entering the asyncio event loop, if it # exists. This simplifies the stack trace and ensures errors are # reported earlier. It also ensures that errors raised during parsing & # passing are still raised if `forever` is True. func = autoparse( func, description=description, epilog=epilog, add_nos=add_nos, parser=parser) # Step 3: call the function automatically if __name__ == '__main__' (or # if True was provided) func = automain(module)(func) return func return autocommand_decorator _vendor/autocommand/autoparse.py 0000644 00000026572 15030122015 0013065 0 ustar 00 # Copyright 2014-2015 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. import sys from re import compile as compile_regex from inspect import signature, getdoc, Parameter from argparse import ArgumentParser from contextlib import contextmanager from functools import wraps from io import IOBase from autocommand.errors import AutocommandError _empty = Parameter.empty class AnnotationError(AutocommandError): '''Annotation error: annotation must be a string, type, or tuple of both''' class PositionalArgError(AutocommandError): ''' Postional Arg Error: autocommand can't handle postional-only parameters ''' class KWArgError(AutocommandError): '''kwarg Error: autocommand can't handle a **kwargs parameter''' class DocstringError(AutocommandError): '''Docstring error''' class TooManySplitsError(DocstringError): ''' The docstring had too many ---- section splits. Currently we only support using up to a single split, to split the docstring into description and epilog parts. ''' def _get_type_description(annotation): ''' Given an annotation, return the (type, description) for the parameter. If you provide an annotation that is somehow both a string and a callable, the behavior is undefined. ''' if annotation is _empty: return None, None elif callable(annotation): return annotation, None elif isinstance(annotation, str): return None, annotation elif isinstance(annotation, tuple): try: arg1, arg2 = annotation except ValueError as e: raise AnnotationError(annotation) from e else: if callable(arg1) and isinstance(arg2, str): return arg1, arg2 elif isinstance(arg1, str) and callable(arg2): return arg2, arg1 raise AnnotationError(annotation) def _add_arguments(param, parser, used_char_args, add_nos): ''' Add the argument(s) to an ArgumentParser (using add_argument) for a given parameter. used_char_args is the set of -short options currently already in use, and is updated (if necessary) by this function. If add_nos is True, this will also add an inverse switch for all boolean options. For instance, for the boolean parameter "verbose", this will create --verbose and --no-verbose. ''' # Impl note: This function is kept separate from make_parser because it's # already very long and I wanted to separate out as much as possible into # its own call scope, to prevent even the possibility of suble mutation # bugs. if param.kind is param.POSITIONAL_ONLY: raise PositionalArgError(param) elif param.kind is param.VAR_KEYWORD: raise KWArgError(param) # These are the kwargs for the add_argument function. arg_spec = {} is_option = False # Get the type and default from the annotation. arg_type, description = _get_type_description(param.annotation) # Get the default value default = param.default # If there is no explicit type, and the default is present and not None, # infer the type from the default. if arg_type is None and default not in {_empty, None}: arg_type = type(default) # Add default. The presence of a default means this is an option, not an # argument. if default is not _empty: arg_spec['default'] = default is_option = True # Add the type if arg_type is not None: # Special case for bool: make it just a --switch if arg_type is bool: if not default or default is _empty: arg_spec['action'] = 'store_true' else: arg_spec['action'] = 'store_false' # Switches are always options is_option = True # Special case for file types: make it a string type, for filename elif isinstance(default, IOBase): arg_spec['type'] = str # TODO: special case for list type. # - How to specificy type of list members? # - param: [int] # - param: int =[] # - action='append' vs nargs='*' else: arg_spec['type'] = arg_type # nargs: if the signature includes *args, collect them as trailing CLI # arguments in a list. *args can't have a default value, so it can never be # an option. if param.kind is param.VAR_POSITIONAL: # TODO: consider depluralizing metavar/name here. arg_spec['nargs'] = '*' # Add description. if description is not None: arg_spec['help'] = description # Get the --flags flags = [] name = param.name if is_option: # Add the first letter as a -short option. for letter in name[0], name[0].swapcase(): if letter not in used_char_args: used_char_args.add(letter) flags.append('-{}'.format(letter)) break # If the parameter is a --long option, or is a -short option that # somehow failed to get a flag, add it. if len(name) > 1 or not flags: flags.append('--{}'.format(name)) arg_spec['dest'] = name else: flags.append(name) parser.add_argument(*flags, **arg_spec) # Create the --no- version for boolean switches if add_nos and arg_type is bool: parser.add_argument( '--no-{}'.format(name), action='store_const', dest=name, const=default if default is not _empty else False) def make_parser(func_sig, description, epilog, add_nos): ''' Given the signature of a function, create an ArgumentParser ''' parser = ArgumentParser(description=description, epilog=epilog) used_char_args = {'h'} # Arange the params so that single-character arguments are first. This # esnures they don't have to get --long versions. sorted is stable, so the # parameters will otherwise still be in relative order. params = sorted( func_sig.parameters.values(), key=lambda param: len(param.name) > 1) for param in params: _add_arguments(param, parser, used_char_args, add_nos) return parser _DOCSTRING_SPLIT = compile_regex(r'\n\s*-{4,}\s*\n') def parse_docstring(docstring): ''' Given a docstring, parse it into a description and epilog part ''' if docstring is None: return '', '' parts = _DOCSTRING_SPLIT.split(docstring) if len(parts) == 1: return docstring, '' elif len(parts) == 2: return parts[0], parts[1] else: raise TooManySplitsError() def autoparse( func=None, *, description=None, epilog=None, add_nos=False, parser=None): ''' This decorator converts a function that takes normal arguments into a function which takes a single optional argument, argv, parses it using an argparse.ArgumentParser, and calls the underlying function with the parsed arguments. If it is not given, sys.argv[1:] is used. This is so that the function can be used as a setuptools entry point, as well as a normal main function. sys.argv[1:] is not evaluated until the function is called, to allow injecting different arguments for testing. It uses the argument signature of the function to create an ArgumentParser. Parameters without defaults become positional parameters, while parameters *with* defaults become --options. Use annotations to set the type of the parameter. The `desctiption` and `epilog` parameters corrospond to the same respective argparse parameters. If no description is given, it defaults to the decorated functions's docstring, if present. If add_nos is True, every boolean option (that is, every parameter with a default of True/False or a type of bool) will have a --no- version created as well, which inverts the option. For instance, the --verbose option will have a --no-verbose counterpart. These are not mutually exclusive- whichever one appears last in the argument list will have precedence. If a parser is given, it is used instead of one generated from the function signature. In this case, no parser is created; instead, the given parser is used to parse the argv argument. The parser's results' argument names must match up with the parameter names of the decorated function. The decorated function is attached to the result as the `func` attribute, and the parser is attached as the `parser` attribute. ''' # If @autoparse(...) is used instead of @autoparse if func is None: return lambda f: autoparse( f, description=description, epilog=epilog, add_nos=add_nos, parser=parser) func_sig = signature(func) docstr_description, docstr_epilog = parse_docstring(getdoc(func)) if parser is None: parser = make_parser( func_sig, description or docstr_description, epilog or docstr_epilog, add_nos) @wraps(func) def autoparse_wrapper(argv=None): if argv is None: argv = sys.argv[1:] # Get empty argument binding, to fill with parsed arguments. This # object does all the heavy lifting of turning named arguments into # into correctly bound *args and **kwargs. parsed_args = func_sig.bind_partial() parsed_args.arguments.update(vars(parser.parse_args(argv))) return func(*parsed_args.args, **parsed_args.kwargs) # TODO: attach an updated __signature__ to autoparse_wrapper, just in case. # Attach the wrapped function and parser, and return the wrapper. autoparse_wrapper.func = func autoparse_wrapper.parser = parser return autoparse_wrapper @contextmanager def smart_open(filename_or_file, *args, **kwargs): ''' This context manager allows you to open a filename, if you want to default some already-existing file object, like sys.stdout, which shouldn't be closed at the end of the context. If the filename argument is a str, bytes, or int, the file object is created via a call to open with the given *args and **kwargs, sent to the context, and closed at the end of the context, just like "with open(filename) as f:". If it isn't one of the openable types, the object simply sent to the context unchanged, and left unclosed at the end of the context. Example: def work_with_file(name=sys.stdout): with smart_open(name) as f: # Works correctly if name is a str filename or sys.stdout print("Some stuff", file=f) # If it was a filename, f is closed at the end here. ''' if isinstance(filename_or_file, (str, bytes, int)): with open(filename_or_file, *args, **kwargs) as file: yield file else: yield filename_or_file _vendor/autocommand/autoasync.py 0000644 00000013060 15030122015 0013054 0 ustar 00 # Copyright 2014-2015 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. from asyncio import get_event_loop, iscoroutine from functools import wraps from inspect import signature async def _run_forever_coro(coro, args, kwargs, loop): ''' This helper function launches an async main function that was tagged with forever=True. There are two possibilities: - The function is a normal function, which handles initializing the event loop, which is then run forever - The function is a coroutine, which needs to be scheduled in the event loop, which is then run forever - There is also the possibility that the function is a normal function wrapping a coroutine function The function is therefore called unconditionally and scheduled in the event loop if the return value is a coroutine object. The reason this is a separate function is to make absolutely sure that all the objects created are garbage collected after all is said and done; we do this to ensure that any exceptions raised in the tasks are collected ASAP. ''' # Personal note: I consider this an antipattern, as it relies on the use of # unowned resources. The setup function dumps some stuff into the event # loop where it just whirls in the ether without a well defined owner or # lifetime. For this reason, there's a good chance I'll remove the # forever=True feature from autoasync at some point in the future. thing = coro(*args, **kwargs) if iscoroutine(thing): await thing def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False): ''' Convert an asyncio coroutine into a function which, when called, is evaluted in an event loop, and the return value returned. This is intented to make it easy to write entry points into asyncio coroutines, which otherwise need to be explictly evaluted with an event loop's run_until_complete. If `loop` is given, it is used as the event loop to run the coro in. If it is None (the default), the loop is retreived using asyncio.get_event_loop. This call is defered until the decorated function is called, so that callers can install custom event loops or event loop policies after @autoasync is applied. If `forever` is True, the loop is run forever after the decorated coroutine is finished. Use this for servers created with asyncio.start_server and the like. If `pass_loop` is True, the event loop object is passed into the coroutine as the `loop` kwarg when the wrapper function is called. In this case, the wrapper function's __signature__ is updated to remove this parameter, so that autoparse can still be used on it without generating a parameter for `loop`. This coroutine can be called with ( @autoasync(...) ) or without ( @autoasync ) arguments. Examples: @autoasync def get_file(host, port): reader, writer = yield from asyncio.open_connection(host, port) data = reader.read() sys.stdout.write(data.decode()) get_file(host, port) @autoasync(forever=True, pass_loop=True) def server(host, port, loop): yield_from loop.create_server(Proto, host, port) server('localhost', 8899) ''' if coro is None: return lambda c: autoasync( c, loop=loop, forever=forever, pass_loop=pass_loop) # The old and new signatures are required to correctly bind the loop # parameter in 100% of cases, even if it's a positional parameter. # NOTE: A future release will probably require the loop parameter to be # a kwonly parameter. if pass_loop: old_sig = signature(coro) new_sig = old_sig.replace(parameters=( param for name, param in old_sig.parameters.items() if name != "loop")) @wraps(coro) def autoasync_wrapper(*args, **kwargs): # Defer the call to get_event_loop so that, if a custom policy is # installed after the autoasync decorator, it is respected at call time local_loop = get_event_loop() if loop is None else loop # Inject the 'loop' argument. We have to use this signature binding to # ensure it's injected in the correct place (positional, keyword, etc) if pass_loop: bound_args = old_sig.bind_partial() bound_args.arguments.update( loop=local_loop, **new_sig.bind(*args, **kwargs).arguments) args, kwargs = bound_args.args, bound_args.kwargs if forever: local_loop.create_task(_run_forever_coro( coro, args, kwargs, local_loop )) local_loop.run_forever() else: return local_loop.run_until_complete(coro(*args, **kwargs)) # Attach the updated signature. This allows 'pass_loop' to be used with # autoparse if pass_loop: autoasync_wrapper.__signature__ = new_sig return autoasync_wrapper _vendor/autocommand/automain.py 0000644 00000004034 15030122015 0012664 0 ustar 00 # Copyright 2014-2015 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. import sys from .errors import AutocommandError class AutomainRequiresModuleError(AutocommandError, TypeError): pass def automain(module, *, args=(), kwargs=None): ''' This decorator automatically invokes a function if the module is being run as the "__main__" module. Optionally, provide args or kwargs with which to call the function. If `module` is "__main__", the function is called, and the program is `sys.exit`ed with the return value. You can also pass `True` to cause the function to be called unconditionally. If the function is not called, it is returned unchanged by the decorator. Usage: @automain(__name__) # Pass __name__ to check __name__=="__main__" def main(): ... If __name__ is "__main__" here, the main function is called, and then sys.exit called with the return value. ''' # Check that @automain(...) was called, rather than @automain if callable(module): raise AutomainRequiresModuleError(module) if module == '__main__' or module is True: if kwargs is None: kwargs = {} # Use a function definition instead of a lambda for a neater traceback def automain_decorator(main): sys.exit(main(*args, **kwargs)) return automain_decorator else: return lambda main: main _vendor/autocommand/__init__.py 0000644 00000002015 15030122015 0012603 0 ustar 00 # Copyright 2014-2016 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. # flake8 flags all these imports as unused, hence the NOQAs everywhere. from .automain import automain # NOQA from .autoparse import autoparse, smart_open # NOQA from .autocommand import autocommand # NOQA try: from .autoasync import autoasync # NOQA except ImportError: # pragma: no cover pass _vendor/autocommand/errors.py 0000644 00000001566 15030122015 0012372 0 ustar 00 # Copyright 2014-2016 Nathan West # # This file is part of autocommand. # # autocommand is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # autocommand is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with autocommand. If not, see <http://www.gnu.org/licenses/>. class AutocommandError(Exception): '''Base class for autocommand exceptions''' pass # Individual modules will define errors specific to that module. _vendor/importlib_metadata-8.0.0.dist-info/RECORD 0000644 00000004726 15030122015 0015274 0 ustar 00 importlib_metadata-8.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 importlib_metadata-8.0.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358 importlib_metadata-8.0.0.dist-info/METADATA,sha256=anuQ7_7h4J1bSEzfcjIBakPi2cyVQ7y7jklLHsBeH1k,4648 importlib_metadata-8.0.0.dist-info/RECORD,, importlib_metadata-8.0.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 importlib_metadata-8.0.0.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91 importlib_metadata-8.0.0.dist-info/top_level.txt,sha256=CO3fD9yylANiXkrMo4qHLV_mqXL2sC5JFKgt1yWAT-A,19 importlib_metadata/__init__.py,sha256=tZNB-23h8Bixi9uCrQqj9Yf0aeC--Josdy3IZRIQeB0,33798 importlib_metadata/__pycache__/__init__.cpython-312.pyc,, importlib_metadata/__pycache__/_adapters.cpython-312.pyc,, importlib_metadata/__pycache__/_collections.cpython-312.pyc,, importlib_metadata/__pycache__/_compat.cpython-312.pyc,, importlib_metadata/__pycache__/_functools.cpython-312.pyc,, importlib_metadata/__pycache__/_itertools.cpython-312.pyc,, importlib_metadata/__pycache__/_meta.cpython-312.pyc,, importlib_metadata/__pycache__/_text.cpython-312.pyc,, importlib_metadata/__pycache__/diagnose.cpython-312.pyc,, importlib_metadata/_adapters.py,sha256=rIhWTwBvYA1bV7i-5FfVX38qEXDTXFeS5cb5xJtP3ks,2317 importlib_metadata/_collections.py,sha256=CJ0OTCHIjWA0ZIVS4voORAsn2R4R2cQBEtPsZEJpASY,743 importlib_metadata/_compat.py,sha256=73QKrN9KNoaZzhbX5yPCCZa-FaALwXe8TPlDR72JgBU,1314 importlib_metadata/_functools.py,sha256=PsY2-4rrKX4RVeRC1oGp1lB1pmC9eKN88_f-bD9uOoA,2895 importlib_metadata/_itertools.py,sha256=cvr_2v8BRbxcIl5x5ldfqdHjhI8Yi8s8yk50G_nm6jQ,2068 importlib_metadata/_meta.py,sha256=nxZ7C8GVlcBFAKWyVOn_dn7ot_twBcbm1NmvjIetBHI,1801 importlib_metadata/_text.py,sha256=HCsFksZpJLeTP3NEk_ngrAeXVRRtTrtyh9eOABoRP4A,2166 importlib_metadata/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc,, importlib_metadata/compat/__pycache__/py311.cpython-312.pyc,, importlib_metadata/compat/__pycache__/py39.cpython-312.pyc,, importlib_metadata/compat/py311.py,sha256=uqm-K-uohyj1042TH4a9Er_I5o7667DvulcD-gC_fSA,608 importlib_metadata/compat/py39.py,sha256=cPkMv6-0ilK-0Jw_Tkn0xYbOKJZc4WJKQHow0c2T44w,1102 importlib_metadata/diagnose.py,sha256=nkSRMiowlmkhLYhKhvCg9glmt_11Cox-EmLzEbqYTa8,379 importlib_metadata/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 _vendor/importlib_metadata-8.0.0.dist-info/METADATA 0000644 00000011050 15030122015 0015462 0 ustar 00 Metadata-Version: 2.1 Name: importlib_metadata Version: 8.0.0 Summary: Read metadata from Python packages Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Source, https://github.com/python/importlib_metadata Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: Apache Software License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: zipp >=0.5 Requires-Dist: typing-extensions >=3.6.4 ; python_version < "3.8" Provides-Extra: doc Requires-Dist: sphinx >=3.5 ; extra == 'doc' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' Requires-Dist: rst.linker >=1.9 ; extra == 'doc' Requires-Dist: furo ; extra == 'doc' Requires-Dist: sphinx-lint ; extra == 'doc' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' Provides-Extra: perf Requires-Dist: ipython ; extra == 'perf' Provides-Extra: test Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' Requires-Dist: pytest-cov ; extra == 'test' Requires-Dist: pytest-mypy ; extra == 'test' Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' Requires-Dist: packaging ; extra == 'test' Requires-Dist: pyfakefs ; extra == 'test' Requires-Dist: flufl.flake8 ; extra == 'test' Requires-Dist: pytest-perf >=0.9.2 ; extra == 'test' Requires-Dist: jaraco.test >=5.4 ; extra == 'test' Requires-Dist: importlib-resources >=1.3 ; (python_version < "3.9") and extra == 'test' .. image:: https://img.shields.io/pypi/v/importlib_metadata.svg :target: https://pypi.org/project/importlib_metadata .. image:: https://img.shields.io/pypi/pyversions/importlib_metadata.svg .. image:: https://github.com/python/importlib_metadata/actions/workflows/main.yml/badge.svg :target: https://github.com/python/importlib_metadata/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/importlib-metadata/badge/?version=latest :target: https://importlib-metadata.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/importlib-metadata :target: https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=readme Library to access the metadata for a Python package. This package supplies third-party access to the functionality of `importlib.metadata <https://docs.python.org/3/library/importlib.metadata.html>`_ including improvements added to subsequent Python versions. Compatibility ============= New features are introduced in this third-party library and later merged into CPython. The following table indicates which versions of this library were contributed to different versions in the standard library: .. list-table:: :header-rows: 1 * - importlib_metadata - stdlib * - 7.0 - 3.13 * - 6.5 - 3.12 * - 4.13 - 3.11 * - 4.6 - 3.10 * - 1.4 - 3.8 Usage ===== See the `online documentation <https://importlib-metadata.readthedocs.io/>`_ for usage details. `Finder authors <https://docs.python.org/3/reference/import.html#finders-and-loaders>`_ can also add support for custom package installers. See the above documentation for details. Caveats ======= This project primarily supports third-party packages installed by PyPA tools (or other conforming packages). It does not support: - Packages in the stdlib. - Packages installed without metadata. Project details =============== * Project home: https://github.com/python/importlib_metadata * Report bugs at: https://github.com/python/importlib_metadata/issues * Code hosting: https://github.com/python/importlib_metadata * Documentation: https://importlib-metadata.readthedocs.io/ For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=referral&utm_campaign=github>`_. _vendor/importlib_metadata-8.0.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0015634 0 ustar 00 pip _vendor/importlib_metadata-8.0.0.dist-info/WHEEL 0000644 00000000133 15030122015 0015146 0 ustar 00 Wheel-Version: 1.0 Generator: setuptools (70.1.1) Root-Is-Purelib: true Tag: py3-none-any _vendor/importlib_metadata-8.0.0.dist-info/LICENSE 0000644 00000026136 15030122015 0015377 0 ustar 00 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. _vendor/importlib_metadata-8.0.0.dist-info/top_level.txt 0000644 00000000023 15030122015 0017107 0 ustar 00 importlib_metadata _vendor/importlib_metadata-8.0.0.dist-info/REQUESTED 0000644 00000000000 15030122015 0015634 0 ustar 00 _vendor/more_itertools-10.3.0.dist-info/RECORD 0000644 00000002353 15030122015 0014547 0 ustar 00 more_itertools-10.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 more_itertools-10.3.0.dist-info/LICENSE,sha256=CfHIyelBrz5YTVlkHqm4fYPAyw_QB-te85Gn4mQ8GkY,1053 more_itertools-10.3.0.dist-info/METADATA,sha256=BFO90O-fLNiVQMpj7oIS5ztzgJUUQZ3TA32P5HH3N-A,36293 more_itertools-10.3.0.dist-info/RECORD,, more_itertools-10.3.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 more_itertools-10.3.0.dist-info/WHEEL,sha256=rSgq_JpHF9fHR1lx53qwg_1-2LypZE_qmcuXbVUq948,81 more_itertools/__init__.py,sha256=dtAbGjTDmn_ghiU5YXfhyDy0phAlXVdt5klZA5fUa-Q,149 more_itertools/__init__.pyi,sha256=5B3eTzON1BBuOLob1vCflyEb2lSd6usXQQ-Cv-hXkeA,43 more_itertools/__pycache__/__init__.cpython-312.pyc,, more_itertools/__pycache__/more.cpython-312.pyc,, more_itertools/__pycache__/recipes.cpython-312.pyc,, more_itertools/more.py,sha256=1E5kzFncRKTDw0cYv1yRXMgDdunstLQd1QStcnL6U90,148370 more_itertools/more.pyi,sha256=iXXeqt48Nxe8VGmIWpkVXuKpR2FYNuu2DU8nQLWCCu0,21484 more_itertools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 more_itertools/recipes.py,sha256=WedhhfhGVgr6zii8fIbGJVmRTw0ZKRiLKnYBDGJv4nY,28591 more_itertools/recipes.pyi,sha256=T_mdGpcFdfrP3JSWbwzYP9JyNV-Go-7RPfpxfftAWlA,4617 _vendor/more_itertools-10.3.0.dist-info/METADATA 0000644 00000106705 15030122015 0014757 0 ustar 00 Metadata-Version: 2.1 Name: more-itertools Version: 10.3.0 Summary: More routines for operating on iterables, beyond itertools Keywords: itertools,iterator,iteration,filter,peek,peekable,chunk,chunked Author-email: Erik Rose <erikrose@grinchcentral.com> Requires-Python: >=3.8 Description-Content-Type: text/x-rst Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: Natural Language :: English Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: Implementation :: CPython Classifier: Programming Language :: Python :: Implementation :: PyPy Classifier: Topic :: Software Development :: Libraries Project-URL: Homepage, https://github.com/more-itertools/more-itertools ============== More Itertools ============== .. image:: https://readthedocs.org/projects/more-itertools/badge/?version=latest :target: https://more-itertools.readthedocs.io/en/stable/ Python's ``itertools`` library is a gem - you can compose elegant solutions for a variety of problems with the functions it provides. In ``more-itertools`` we collect additional building blocks, recipes, and routines for working with Python iterables. +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Grouping | `chunked <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.chunked>`_, | | | `ichunked <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.ichunked>`_, | | | `chunked_even <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.chunked_even>`_, | | | `sliced <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sliced>`_, | | | `constrained_batches <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.constrained_batches>`_, | | | `distribute <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.distribute>`_, | | | `divide <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.divide>`_, | | | `split_at <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.split_at>`_, | | | `split_before <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.split_before>`_, | | | `split_after <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.split_after>`_, | | | `split_into <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.split_into>`_, | | | `split_when <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.split_when>`_, | | | `bucket <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.bucket>`_, | | | `unzip <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unzip>`_, | | | `batched <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.batched>`_, | | | `grouper <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.grouper>`_, | | | `partition <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.partition>`_, | | | `transpose <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.transpose>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Lookahead and lookback | `spy <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.spy>`_, | | | `peekable <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.peekable>`_, | | | `seekable <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.seekable>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Windowing | `windowed <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.windowed>`_, | | | `substrings <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.substrings>`_, | | | `substrings_indexes <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.substrings_indexes>`_, | | | `stagger <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.stagger>`_, | | | `windowed_complete <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.windowed_complete>`_, | | | `pairwise <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.pairwise>`_, | | | `triplewise <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.triplewise>`_, | | | `sliding_window <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sliding_window>`_, | | | `subslices <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.subslices>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Augmenting | `count_cycle <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.count_cycle>`_, | | | `intersperse <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.intersperse>`_, | | | `padded <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.padded>`_, | | | `repeat_each <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.repeat_each>`_, | | | `mark_ends <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.mark_ends>`_, | | | `repeat_last <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.repeat_last>`_, | | | `adjacent <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.adjacent>`_, | | | `groupby_transform <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.groupby_transform>`_, | | | `pad_none <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.pad_none>`_, | | | `ncycles <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.ncycles>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Combining | `collapse <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.collapse>`_, | | | `sort_together <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sort_together>`_, | | | `interleave <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.interleave>`_, | | | `interleave_longest <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.interleave_longest>`_, | | | `interleave_evenly <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.interleave_evenly>`_, | | | `zip_offset <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.zip_offset>`_, | | | `zip_equal <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.zip_equal>`_, | | | `zip_broadcast <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.zip_broadcast>`_, | | | `flatten <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.flatten>`_, | | | `roundrobin <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.roundrobin>`_, | | | `prepend <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.prepend>`_, | | | `value_chain <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.value_chain>`_, | | | `partial_product <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.partial_product>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Summarizing | `ilen <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.ilen>`_, | | | `unique_to_each <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unique_to_each>`_, | | | `sample <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sample>`_, | | | `consecutive_groups <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.consecutive_groups>`_, | | | `run_length <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.run_length>`_, | | | `map_reduce <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.map_reduce>`_, | | | `join_mappings <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.join_mappings>`_, | | | `exactly_n <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.exactly_n>`_, | | | `is_sorted <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.is_sorted>`_, | | | `all_equal <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.all_equal>`_, | | | `all_unique <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.all_unique>`_, | | | `minmax <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.minmax>`_, | | | `first_true <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.first_true>`_, | | | `quantify <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.quantify>`_, | | | `iequals <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.iequals>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Selecting | `islice_extended <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.islice_extended>`_, | | | `first <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.first>`_, | | | `last <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.last>`_, | | | `one <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.one>`_, | | | `only <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.only>`_, | | | `strictly_n <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.strictly_n>`_, | | | `strip <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.strip>`_, | | | `lstrip <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.lstrip>`_, | | | `rstrip <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.rstrip>`_, | | | `filter_except <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.filter_except>`_, | | | `map_except <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.map_except>`_, | | | `filter_map <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.filter_map>`_, | | | `iter_suppress <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.iter_suppress>`_, | | | `nth_or_last <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth_or_last>`_, | | | `unique_in_window <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unique_in_window>`_, | | | `before_and_after <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.before_and_after>`_, | | | `nth <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth>`_, | | | `take <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.take>`_, | | | `tail <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.tail>`_, | | | `unique_everseen <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unique_everseen>`_, | | | `unique_justseen <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unique_justseen>`_, | | | `unique <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.unique>`_, | | | `duplicates_everseen <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.duplicates_everseen>`_, | | | `duplicates_justseen <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.duplicates_justseen>`_, | | | `classify_unique <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.classify_unique>`_, | | | `longest_common_prefix <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.longest_common_prefix>`_, | | | `takewhile_inclusive <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.takewhile_inclusive>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Math | `dft <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.dft>`_, | | | `idft <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.idft>`_, | | | `convolve <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.convolve>`_, | | | `dotproduct <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.dotproduct>`_, | | | `factor <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.factor>`_, | | | `matmul <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.matmul>`_, | | | `polynomial_from_roots <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.polynomial_from_roots>`_, | | | `polynomial_derivative <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.polynomial_derivative>`_, | | | `polynomial_eval <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.polynomial_eval>`_, | | | `sieve <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sieve>`_, | | | `sum_of_squares <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.sum_of_squares>`_, | | | `totient <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.totient>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Combinatorics | `distinct_permutations <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.distinct_permutations>`_, | | | `distinct_combinations <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.distinct_combinations>`_, | | | `circular_shifts <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.circular_shifts>`_, | | | `partitions <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.partitions>`_, | | | `set_partitions <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.set_partitions>`_, | | | `product_index <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.product_index>`_, | | | `combination_index <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.combination_index>`_, | | | `permutation_index <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.permutation_index>`_, | | | `combination_with_replacement_index <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.combination_with_replacement_index>`_, | | | `gray_product <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.gray_product>`_, | | | `outer_product <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.outer_product>`_, | | | `powerset <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.powerset>`_, | | | `powerset_of_sets <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.powerset_of_sets>`_, | | | `random_product <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.random_product>`_, | | | `random_permutation <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.random_permutation>`_, | | | `random_combination <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.random_combination>`_, | | | `random_combination_with_replacement <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.random_combination_with_replacement>`_, | | | `nth_product <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth_product>`_, | | | `nth_permutation <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth_permutation>`_, | | | `nth_combination <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth_combination>`_, | | | `nth_combination_with_replacement <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.nth_combination_with_replacement>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Wrapping | `always_iterable <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.always_iterable>`_, | | | `always_reversible <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.always_reversible>`_, | | | `countable <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.countable>`_, | | | `consumer <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.consumer>`_, | | | `with_iter <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.with_iter>`_, | | | `iter_except <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.iter_except>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Others | `locate <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.locate>`_, | | | `rlocate <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.rlocate>`_, | | | `replace <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.replace>`_, | | | `numeric_range <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.numeric_range>`_, | | | `side_effect <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.side_effect>`_, | | | `iterate <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.iterate>`_, | | | `difference <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.difference>`_, | | | `make_decorator <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.make_decorator>`_, | | | `SequenceView <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.SequenceView>`_, | | | `time_limited <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.time_limited>`_, | | | `map_if <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.map_if>`_, | | | `iter_index <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.iter_index>`_, | | | `consume <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.consume>`_, | | | `tabulate <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.tabulate>`_, | | | `repeatfunc <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.repeatfunc>`_, | | | `reshape <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.reshape>`_ | | | `doublestarmap <https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.doublestarmap>`_ | +------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Getting started =============== To get started, install the library with `pip <https://pip.pypa.io/en/stable/>`_: .. code-block:: shell pip install more-itertools The recipes from the `itertools docs <https://docs.python.org/3/library/itertools.html#itertools-recipes>`_ are included in the top-level package: .. code-block:: python >>> from more_itertools import flatten >>> iterable = [(0, 1), (2, 3)] >>> list(flatten(iterable)) [0, 1, 2, 3] Several new recipes are available as well: .. code-block:: python >>> from more_itertools import chunked >>> iterable = [0, 1, 2, 3, 4, 5, 6, 7, 8] >>> list(chunked(iterable, 3)) [[0, 1, 2], [3, 4, 5], [6, 7, 8]] >>> from more_itertools import spy >>> iterable = (x * x for x in range(1, 6)) >>> head, iterable = spy(iterable, n=3) >>> list(head) [1, 4, 9] >>> list(iterable) [1, 4, 9, 16, 25] For the full listing of functions, see the `API documentation <https://more-itertools.readthedocs.io/en/stable/api.html>`_. Links elsewhere =============== Blog posts about ``more-itertools``: * `Yo, I heard you like decorators <https://www.bbayles.com/index/decorator_factory>`__ * `Tour of Python Itertools <https://martinheinz.dev/blog/16>`__ (`Alternate <https://dev.to/martinheinz/tour-of-python-itertools-4122>`__) * `Real-World Python More Itertools <https://www.gidware.com/real-world-more-itertools/>`_ Development =========== ``more-itertools`` is maintained by `@erikrose <https://github.com/erikrose>`_ and `@bbayles <https://github.com/bbayles>`_, with help from `many others <https://github.com/more-itertools/more-itertools/graphs/contributors>`_. If you have a problem or suggestion, please file a bug or pull request in this repository. Thanks for contributing! Version History =============== The version history can be found in `documentation <https://more-itertools.readthedocs.io/en/stable/versions.html>`_. _vendor/more_itertools-10.3.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0015115 0 ustar 00 pip _vendor/more_itertools-10.3.0.dist-info/WHEEL 0000644 00000000121 15030122015 0014424 0 ustar 00 Wheel-Version: 1.0 Generator: flit 3.8.0 Root-Is-Purelib: true Tag: py3-none-any _vendor/more_itertools-10.3.0.dist-info/LICENSE 0000644 00000002035 15030122015 0014650 0 ustar 00 Copyright (c) 2012 Erik Rose Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/more_itertools-10.3.0.dist-info/REQUESTED 0000644 00000000000 15030122015 0015115 0 ustar 00 _vendor/more_itertools/__pycache__/__init__.cpython-310.pyc 0000644 00000000510 15030122015 0017677 0 ustar 00 o �h� � @ s d Z ddlT ddlT dZdS )z:More routines for operating on iterables, beyond itertools� )�*z10.3.0N)�__doc__�more�recipes� __version__� r r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/more_itertools/__init__.py�<module> s _vendor/more_itertools/__pycache__/more.cpython-310.pyc 0000644 00000416060 15030122015 0017115 0 ustar 00 o �h�C � @ sT d dl Z d dlZd dlmZmZmZmZ d dlmZ d dl m Z m Z m Z m Z d dlmZmZmZ d dlmZmZmZmZmZmZmZmZmZm Z m Z m Z m Z m Z d dl m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) d dl*m+Z+m,Z, d d l-m-Z-m.Z.m/Z/ d d l0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7 d d l8m9Z9m:Z: d d l;m<Z< d dl=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZH g d�ZIeJe ddd� �ZK�ddd�ZLe>fdd�ZMe>fdd�ZNe>fdd�ZOG d d � d �ZPd d � ZQd d!� ZRd"d#� ZSd$d%� ZT�dd&d'�ZUd(d)� ZV�dd*d+�ZW�dd,d-�ZX�dd.d/�ZYd0d1� ZZ�dd2d3�Z[d4d5� Z\�dd6d7�Z]G d8d9� d9�Z^�dd:d;�Z_d<d=� Z`d>d?� Za�dd@dA�Zb�ddBdC�Zc�ddDdE�Zd�ddFdG�Ze�d dIdJ�Zf�d dKdL�Zg�d dMdN�Zh�d dOdP�ZidQdR� Zj�d dSdT�Zk�d dVdW�Zl�ddXdY�ZmdZd[� Zn�d d]d^�Zod_d`� Zpddda�dbdc�Zq�ddedf�Zrdgdh� Zsdidj� Zteuevffdkdl�Zw�ddmdn�Zx�ddodp�ZyG dqdr� drejejz�Z{�ddsdt�Z|dudv� Z}e~dfdwdx�Zdydz� Z�d{d|� Z�d}d~� Z�dd�� Z�G d�d�� d��Z�d�d�� Z�d�d�� Z�d�d� fd�d��Z�e3fdd��d�d��Z�G d�d�� d�e�Z�G d�d�� d��Z�G d�d�� d��Z�e~fd�d��Z�d�d�� Z�ddd�d��Z��dd�d��Z�e~dfd�d��Z��dd�d��Z�d�d�� Z��dd�d��Z�G d�d�� d��Z��dd�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d� fd�d��Z�d�d�� Z�d�d�� Z��dd�d��Z��dd�d��Z�G d�d�� d�e��Z�G d�d�� d��Z�d�dÄ Z��dd�dńZ�d�dDŽ Z�d�dɄ Z�d�d˄ Z�d�d̈́ Z�d�dτ Z�d�dф Z�d�dӄ Z�d�dՄ Z�G d�dׄ d׃Z�d�dل Z�euevfddڜd�d܄Z��dd�dބZ��dd�d�Z��dd�d�Z��dd�d�Z�de>d�d�d�Z�de�d�fd�d�Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d��d � Zd�d� Z�dS ( � N)�Counter� defaultdict�deque�abc)�Sequence)�cached_property�partial�reduce�wraps)�heapify� heapreplace�heappop)�chain� combinations�compress�count�cycle� dropwhile�groupby�islice�repeat�starmap� takewhile�tee� zip_longest�product) �comb�e�exp� factorial�floor�fsum�log�perm�tau)�Empty�Queue)�random� randrange�uniform)� itemgetter�mul�sub�gt�lt�ge�le)� hexversion�maxsize)� monotonic� ) �_marker� _zip_equal�UnequalIterablesError�consume�flatten�pairwise�powerset�take�unique_everseen� all_equal�batched)n� AbortThread� SequenceViewr7 �adjacent� all_unique�always_iterable�always_reversible�bucket� callback_iter�chunked� chunked_even�circular_shifts�collapse�combination_index�"combination_with_replacement_index�consecutive_groups�constrained_batches�consumer� count_cycle� countable�dft� difference�distinct_combinations�distinct_permutations� distribute�divide� doublestarmap�duplicates_everseen�duplicates_justseen�classify_unique� exactly_n� filter_except� filter_map�first� gray_product�groupby_transform�ichunked�iequals�idft�ilen� interleave�interleave_evenly�interleave_longest� intersperse� is_sorted�islice_extended�iterate� iter_suppress� join_mappings�last�locate�longest_common_prefix�lstrip�make_decorator� map_except�map_if� map_reduce� mark_ends�minmax� nth_or_last�nth_permutation� nth_product� nth_combination_with_replacement� numeric_range�one�only� outer_product�padded�partial_product� partitions�peekable�permutation_index�powerset_of_sets� product_index�raise_� repeat_each� repeat_last�replace�rlocate�rstrip� run_length�sample�seekable�set_partitions� side_effect�sliced� sort_together� split_after�split_at� split_before� split_into� split_when�spy�stagger�strip� strictly_n� substrings�substrings_indexes�takewhile_inclusive� time_limited�unique_in_window�unique_to_each�unzip� value_chain�windowed�windowed_complete� with_iter� zip_broadcast� zip_equal� zip_offset�sumprodc C s t tt| |��S �N)r! �mapr+ ��x�y� r� �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/more_itertools/more.py�<lambda>� s r� Fc sF t tt�t | ��g �� |r!�du rtd��� �fdd�}t |� �S � S )aJ Break *iterable* into lists of length *n*: >>> list(chunked([1, 2, 3, 4, 5, 6], 3)) [[1, 2, 3], [4, 5, 6]] By the default, the last yielded list will have fewer than *n* elements if the length of *iterable* is not divisible by *n*: >>> list(chunked([1, 2, 3, 4, 5, 6, 7, 8], 3)) [[1, 2, 3], [4, 5, 6], [7, 8]] To use a fill-in value instead, see the :func:`grouper` recipe. If the length of *iterable* is not divisible by *n* and *strict* is ``True``, then ``ValueError`` will be raised before the last list is yielded. Nz*n must not be None when using strict mode.c 3 �* � � D ]} t | ��krtd��| V qd S )Nz iterable is not divisible by n.��len� ValueError)�chunk��iterator�nr� r� �ret� � � �zchunked.<locals>.ret)�iterr r< r� )�iterabler� �strictr� r� r� r� rH � s rH c C s$ | D ]}| S |t u rtd��|S )a� Return the first item of *iterable*, or *default* if *iterable* is empty. >>> first([0, 1, 2, 3]) 0 >>> first([], 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. :func:`first` is useful when you have a generator of expensive-to-retrieve values and want any arbitrary one. It is marginally shorter than ``next(iter(iterable), default)``. zKfirst() was called on an empty iterable, and no default value was provided.)r5 r� )r� �default�itemr� r� r� r` � s �r` c C st z#t | t�r | d W S t| d�rtdkrtt| ��W S t| dd�d W S ttt fy9 |t u r5t d��| Y S w )a Return the last item of *iterable*, or *default* if *iterable* is empty. >>> last([0, 1, 2, 3]) 3 >>> last([], 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. ���� __reversed__i� r4 ��maxlenzDlast() was called on an empty iterable, and no default was provided.) � isinstancer �hasattrr1 �next�reversedr � IndexError� TypeError� StopIterationr5 r� )r� r� r� r� r� rp � s ��rp c C s t t| |d �|d�S )ag Return the nth or the last item of *iterable*, or *default* if *iterable* is empty. >>> nth_or_last([0, 1, 2, 3], 2) 2 >>> nth_or_last([0, 1], 2) 1 >>> nth_or_last([], 0, 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. r4 �r� )rp r )r� r� r� r� r� r� rz � s rz c @ sT e Zd ZdZdd� Zdd� Zdd� Zefdd �Zd d � Z d d � Z dd� Z dd� Z dS )r� a Wrap an iterator to allow lookahead and prepending elements. Call :meth:`peek` on the result to get the value that will be returned by :func:`next`. This won't advance the iterator: >>> p = peekable(['a', 'b']) >>> p.peek() 'a' >>> next(p) 'a' Pass :meth:`peek` a default value to return that instead of raising ``StopIteration`` when the iterator is exhausted. >>> p = peekable([]) >>> p.peek('hi') 'hi' peekables also offer a :meth:`prepend` method, which "inserts" items at the head of the iterable: >>> p = peekable([1, 2, 3]) >>> p.prepend(10, 11, 12) >>> next(p) 10 >>> p.peek() 11 >>> list(p) [11, 12, 1, 2, 3] peekables can be indexed. Index 0 is the item that will be returned by :func:`next`, index 1 is the item after that, and so on: The values up to the given index will be cached. >>> p = peekable(['a', 'b', 'c', 'd']) >>> p[0] 'a' >>> p[1] 'b' >>> next(p) 'a' Negative indexes are supported, but be aware that they will cache the remaining items in the source iterator, which may require significant storage. To check whether a peekable is exhausted, check its truth value: >>> p = peekable(['a', 'b']) >>> if p: # peekable has items ... list(p) ['a', 'b'] >>> if not p: # peekable is exhausted ... list(p) [] c C s t |�| _t� | _d S r� )r� �_itr �_cache��selfr� r� r� r� �__init__I s zpeekable.__init__c C � | S r� r� �r� r� r� r� �__iter__M � zpeekable.__iter__c C �$ z| � � W dS ty Y dS w �NFT��peekr� r� r� r� r� �__bool__P � ��zpeekable.__bool__c C sH | j s z | j �t| j�� W n ty |tu r� | Y S w | j d S )z�Return the item that will be next returned from ``next()``. Return ``default`` if there are no items left. If ``default`` is not provided, raise ``StopIteration``. r )r� �appendr� r� r� r5 )r� r� r� r� r� r� W s � z peekable.peekc G s | j �t|�� dS )a Stack up items to be the next ones returned from ``next()`` or ``self.peek()``. The items will be returned in first in, first out order:: >>> p = peekable([1, 2, 3]) >>> p.prepend(10, 11, 12) >>> next(p) 10 >>> list(p) [11, 12, 1, 2, 3] It is possible, by prepending items, to "resurrect" a peekable that previously raised ``StopIteration``. >>> p = peekable([]) >>> next(p) Traceback (most recent call last): ... StopIteration >>> p.prepend(1) >>> next(p) 1 >>> next(p) Traceback (most recent call last): ... StopIteration N)r� � extendleftr� )r� �itemsr� r� r� �prependg s zpeekable.prependc C s | j r| j �� S t| j�S r� )r� �popleftr� r� r� r� r� r� �__next__� s zpeekable.__next__c C s� |j d u rdn|j }|dkr#|jd u rdn|j}|jd u r tn|j}n |dk r?|jd u r.dn|j}|jd u r;t d n|j}ntd��|dk sK|dk rS| j�| j� n tt ||�d t�}t | j�}||krr| j�t | j|| �� t | j�| S )Nr4 r r� zslice step cannot be zero) �step�start�stopr2 r� r� �extendr� �min�maxr� r �list)r� �indexr� r� r� r� � cache_lenr� r� r� � _get_slice� s zpeekable._get_slicec C sd t |t�r | �|�S t| j�}|dk r| j�| j� n||kr-| j�t| j|d | �� | j| S �Nr r4 )r� �slicer� r� r� r� r� r )r� r� r� r� r� r� � __getitem__� s zpeekable.__getitem__N) �__name__� __module__� __qualname__�__doc__r� r� r� r5 r� r� r� r� r� r� r� r� r� r� s : r� c s t � �� fdd��}|S )ab Decorator that automatically advances a PEP-342-style "reverse iterator" to its first yield point so you don't have to call ``next()`` on it manually. >>> @consumer ... def tally(): ... i = 0 ... while True: ... print('Thing number %s is %s.' % (i, (yield))) ... i += 1 ... >>> t = tally() >>> t.send('red') Thing number 0 is red. >>> t.send('fish') Thing number 1 is fish. Without the decorator, you would have to call ``next(t)`` before ``t.send()`` could be used. c s � | i |��}t |� |S r� �r� )�args�kwargs�gen��funcr� r� �wrapper� s zconsumer.<locals>.wrapper)r )r� r� r� r� r� rP � s rP c C s t � }tt| |�dd� t|�S )z�Return the number of items in *iterable*. >>> ilen(x for x in range(1000000) if x % 3 == 0) 333334 This consumes the iterable, so handle with care. r r� )r r �zipr� )r� �counterr� r� r� rf � s rf c c s. � |V z| |�}W n t y Y dS w q)z�Return ``start``, ``func(start)``, ``func(func(start))``, ... >>> from itertools import islice >>> list(islice(iterate(lambda x: 2*x, 1), 10)) [1, 2, 4, 8, 16, 32, 64, 128, 256, 512] TN)r� )r� r� r� r� r� rm � s � ��rm c c s6 � | �}|E dH W d � dS 1 sw Y dS )a: Wrap an iterable in a ``with`` statement, so it closes once exhausted. For example, this will close the file when the iterator is exhausted:: upper_lines = (line.upper() for line in with_iter(open('foo'))) Any context manager which returns an iterable is a candidate for ``with_iter``. Nr� )�context_managerr� r� r� r� r� � s � "�r� c C sv t | �}zt|�}W n ty } z|ptd�|�d}~ww zt|�}W n ty. Y |S w d�||�}|p:t|��)a� Return the first item from *iterable*, which is expected to contain only that item. Raise an exception if *iterable* is empty or has more than one item. :func:`one` is useful for ensuring that an iterable contains only one item. For example, it can be used to retrieve the result of a database query that is expected to return a single row. If *iterable* is empty, ``ValueError`` will be raised. You may specify a different exception with the *too_short* keyword: >>> it = [] >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too many items in iterable (expected 1)' >>> too_short = IndexError('too few items') >>> one(it, too_short=too_short) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... IndexError: too few items Similarly, if *iterable* contains more than one item, ``ValueError`` will be raised. You may specify a different exception with the *too_long* keyword: >>> it = ['too', 'many'] >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: Expected exactly one item in iterable, but got 'too', 'many', and perhaps more. >>> too_long = RuntimeError >>> one(it, too_long=too_long) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... RuntimeError Note that :func:`one` attempts to advance *iterable* twice to ensure there is only one item. See :func:`spy` or :func:`peekable` to check iterable contents less destructively. z&too few items in iterable (expected 1)N�LExpected exactly one item in iterable, but got {!r}, {!r}, and perhaps more.)r� r� r� r� �format)r� � too_short�too_long�it� first_value�exc� second_value�msgr� r� r� r s& , ��� �� r c G s | |� �r� r� )� exceptionr� r� r� r� r� F s r� c c s� � |du r dd� }|du rdd� }t | �}t|�D ]}zt|�}W n ty0 ||� Y dS w |V qzt|� W n tyE Y dS w ||d � dS )aw Validate that *iterable* has exactly *n* items and return them if it does. If it has fewer than *n* items, call function *too_short* with those items. If it has more than *n* items, call function *too_long* with the first ``n + 1`` items. >>> iterable = ['a', 'b', 'c', 'd'] >>> n = 4 >>> list(strictly_n(iterable, n)) ['a', 'b', 'c', 'd'] Note that the returned iterable must be consumed in order for the check to be made. By default, *too_short* and *too_long* are functions that raise ``ValueError``. >>> list(strictly_n('ab', 3)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too few items in iterable (got 2) >>> list(strictly_n('abc', 2)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too many items in iterable (got at least 3) You can instead supply functions that do something else. *too_short* will be called with the number of items in *iterable*. *too_long* will be called with `n + 1`. >>> def too_short(item_count): ... raise RuntimeError >>> it = strictly_n('abcd', 6, too_short=too_short) >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... RuntimeError >>> def too_long(item_count): ... print('The boss is going to hear about this') >>> it = strictly_n('abcdef', 4, too_long=too_long) >>> list(it) The boss is going to hear about this ['a', 'b', 'c', 'd'] Nc S � t td�| ��S )Nz"Too few items in iterable (got {})�r� r� r �� item_countr� r� r� r� z � �z strictly_n.<locals>.<lambda>c S r )Nz,Too many items in iterable (got at least {})r r r� r� r� r� � r r4 )r� �ranger� r� )r� r� r r r �ir� r� r� r� r� J s( �/ � �r� c st � fdd�}dd� }t | �}t|�� |du r� }d| k r"� kr1n n |� kr,||�S |||�S t|r7d�S d�S ) a� Yield successive distinct permutations of the elements in *iterable*. >>> sorted(distinct_permutations([1, 0, 1])) [(0, 1, 1), (1, 0, 1), (1, 1, 0)] Equivalent to ``set(permutations(iterable))``, except duplicates are not generated and thrown away. For larger input sequences this is much more efficient. Duplicate permutations arise when there are duplicated elements in the input iterable. The number of items returned is `n! / (x_1! * x_2! * ... * x_n!)`, where `n` is the total number of items input, and each `x_i` is the count of a distinct item in the input sequence. If *r* is given, only the *r*-length permutations are yielded. >>> sorted(distinct_permutations([1, 0, 1], r=2)) [(0, 1), (1, 0), (1, 1)] >>> sorted(distinct_permutations(range(3), r=2)) [(0, 1), (0, 2), (1, 0), (1, 2), (2, 0), (2, 1)] c 3 s� � t | �V t� d dd�D ]}| | | |d k r nqd S t� d |d�D ] }| | | | k r4 nq(| | | | | |< | |< | d |� d� | |d d �< q)NT� r� r4 )�tupler )�Ar �j��sizer� r� �_full� s � �� �z$distinct_permutations.<locals>._fullc s s4 � | d |� | |d � }}t |d dd�}t t|��} t|�V |d }|D ]}|| |k r2 n|| }q(d S |D ]}|| || krT|| || ||< ||< n q;|D ]}|| || krp|| || ||< ||< nqW||d || d� 7 }|d7 }|d || � ||| d � ||d �< |d d �< q )Nr4 r� )r r� r ) r �r�head�tail�right_head_indexes�left_tail_indexes�pivotr r r� r� r� �_partial� s4 � ��2�z'distinct_permutations.<locals>._partialNr r� )r� )�sortedr� r� )r� r r r r� r� r r� rV � s 'rV c C sX |dkrt d��|dkrttt| �|�dd�S t| g�}t||�}ttt||�dd��S )a6 Intersperse filler element *e* among the items in *iterable*, leaving *n* items between each filler element. >>> list(intersperse('!', [1, 2, 3, 4, 5])) [1, '!', 2, '!', 3, '!', 4, '!', 5] >>> list(intersperse(None, [1, 2, 3, 4, 5], n=2)) [1, 2, None, 3, 4, None, 5] r z n must be > 0r4 N)r� r rg r rH r9 )r r� r� �filler�chunksr� r� r� rj � s rj c sF dd� | D �}t t�tt|���� � fdd�� D ���fdd�|D �S )a� Return the elements from each of the input iterables that aren't in the other input iterables. For example, suppose you have a set of packages, each with a set of dependencies:: {'pkg_1': {'A', 'B'}, 'pkg_2': {'B', 'C'}, 'pkg_3': {'B', 'D'}} If you remove one package, which dependencies can also be removed? If ``pkg_1`` is removed, then ``A`` is no longer necessary - it is not associated with ``pkg_2`` or ``pkg_3``. Similarly, ``C`` is only needed for ``pkg_2``, and ``D`` is only needed for ``pkg_3``:: >>> unique_to_each({'A', 'B'}, {'B', 'C'}, {'B', 'D'}) [['A'], ['C'], ['D']] If there are duplicates in one input iterable that aren't in the others they will be duplicated in the output. Input order is preserved:: >>> unique_to_each("mississippi", "missouri") [['p', 'p'], ['o', 'u', 'r']] It is assumed that the elements of each iterable are hashable. c S � g | ]}t |��qS r� )r� ��.0r r� r� r� � <listcomp>1 � z"unique_to_each.<locals>.<listcomp>c s h | ] }� | d kr|�qS �r4 r� )r% �element)�countsr� r� � <setcomp>3 � z!unique_to_each.<locals>.<setcomp>c s g | ] }t t� j|���qS r� )r� �filter� __contains__r$ )�uniquesr� r� r& 4 r, )r r � from_iterabler� �set)� iterables�poolr� )r* r/ r� r� s r� c c s� � |dk r t d��|dkrdV dS |dk rt d��t| �}tt||�|d�}|s+dS t|�|k rAt|�|f|t|� V dS t|�V |f||krP|d n|d }t|jt||��}t||d d|�D ]}t|�V qgdS )aM Return a sliding window of width *n* over the given iterable. >>> all_windows = windowed([1, 2, 3, 4, 5], 3) >>> list(all_windows) [(1, 2, 3), (2, 3, 4), (3, 4, 5)] When the window is larger than the iterable, *fillvalue* is used in place of missing values: >>> list(windowed([1, 2, 3], 4)) [(1, 2, 3, None)] Each window will advance in increments of *step*: >>> list(windowed([1, 2, 3, 4, 5, 6], 3, fillvalue='!', step=2)) [(1, 2, 3), (3, 4, 5), (5, 6, '!')] To slide into the iterable's items, use :func:`chain` to add filler items to the left: >>> iterable = [1, 2, 3, 4] >>> n = 3 >>> padding = [None] * (n - 1) >>> list(windowed(chain(padding, iterable), 3)) [(None, None, 1), (None, 1, 2), (1, 2, 3), (2, 3, 4)] r �n must be >= 0r� Nr4 zstep must be >= 1r� ) r� r� r r r� r r� r� r ) �seqr� � fillvaluer� r� �window�paddingr! �_r� r� r� r� 7 s* � �r� c c sv � g }t | �D ] }|�|� |fV qt|�}t|�}td|d �D ]}t|| d �D ] }|||| � V q,q"dS )aF Yield all of the substrings of *iterable*. >>> [''.join(s) for s in substrings('more')] ['m', 'o', 'r', 'e', 'mo', 'or', 're', 'mor', 'ore', 'more'] Note that non-string iterables can also be subdivided. >>> list(substrings([0, 1, 2])) [(0,), (1,), (2,), (0, 1), (1, 2), (0, 1, 2)] r r4 N)r� r� r r� r )r� r5 r� r r� r r� r� r� r� q s � ��r� c s0 t dt� �d �}|rt|�}� fdd�|D �S )a@ Yield all substrings and their positions in *seq* The items yielded will be a tuple of the form ``(substr, i, j)``, where ``substr == seq[i:j]``. This function only works for iterables that support slicing, such as ``str`` objects. >>> for item in substrings_indexes('more'): ... print(item) ('m', 0, 1) ('o', 1, 2) ('r', 2, 3) ('e', 3, 4) ('mo', 0, 2) ('or', 1, 3) ('re', 2, 4) ('mor', 0, 3) ('ore', 1, 4) ('more', 0, 4) Set *reverse* to ``True`` to yield the same items in the opposite order. r4 c 3 sD � | ] }t t� �| d �D ]}� ||| � ||| fV qqdS �r4 N)r r� )r% �Lr �r5 r� r� � <genexpr>� s � � �z%substrings_indexes.<locals>.<genexpr>)r r� r� )r5 �reverser r� r< r� r� � s �r� c @ s: e Zd ZdZd dd�Zdd� Zdd� Zd d � Zd d � ZdS )rF a� Wrap *iterable* and return an object that buckets the iterable into child iterables based on a *key* function. >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3'] >>> s = bucket(iterable, key=lambda x: x[0]) # Bucket by 1st character >>> sorted(list(s)) # Get the keys ['a', 'b', 'c'] >>> a_iterable = s['a'] >>> next(a_iterable) 'a1' >>> next(a_iterable) 'a2' >>> list(s['b']) ['b1', 'b2', 'b3'] The original iterable will be advanced and its items will be cached until they are used by the child iterables. This may require significant storage. By default, attempting to select a bucket to which no items belong will exhaust the iterable and cache all values. If you specify a *validator* function, selected buckets will instead be checked against it. >>> from itertools import count >>> it = count(1, 2) # Infinite sequence of odd numbers >>> key = lambda x: x % 10 # Bucket by last digit >>> validator = lambda x: x in {1, 3, 5, 7, 9} # Odd digits only >>> s = bucket(it, key=key, validator=validator) >>> 2 in s False >>> list(s[2]) [] Nc C s, t |�| _|| _tt�| _|pdd� | _d S )Nc S s dS �NTr� �r� r� r� r� r� � � z!bucket.__init__.<locals>.<lambda>)r� r� �_keyr r r� � _validator)r� r� �key� validatorr� r� r� r� � s zbucket.__init__c C sH | � |�sdS zt| | �}W n ty Y dS w | j| �|� dS r� )rC r� r� r� � appendleft)r� �valuer� r� r� r� r. � s �zbucket.__contains__c c s~ � | j | r| j | �� V n. zt| j�}W n ty" Y dS w | �|�}||kr0|V n| �|�r=| j | �|� qq)z� Helper to yield items from the parent iterator that match *value*. Items that don't match are stored in the local cache as they are encountered. TN)r� r� r� r� r� rB rC r� )r� rG r� � item_valuer� r� r� � _get_values� s$ � � ��zbucket._get_valuesc c sF � | j D ]}| �|�}| �|�r| j| �|� q| j�� E d H d S r� )r� rB rC r� r� �keys)r� r� rH r� r� r� r� � s � �zbucket.__iter__c C s | � |�s td�S | �|�S )Nr� )rC r� rI �r� rG r� r� r� r� s zbucket.__getitem__r� ) r� r� r� r� r� r. rI r� r� r� r� r� r� rF � s # rF c C s$ t | �}t||�}|�� t||�fS )a� Return a 2-tuple with a list containing the first *n* elements of *iterable*, and an iterator with the same items as *iterable*. This allows you to "look ahead" at the items in the iterable without advancing it. There is one item in the list by default: >>> iterable = 'abcdefg' >>> head, iterable = spy(iterable) >>> head ['a'] >>> list(iterable) ['a', 'b', 'c', 'd', 'e', 'f', 'g'] You may use unpacking to retrieve items instead of lists: >>> (head,), iterable = spy('abcdefg') >>> head 'a' >>> (first, second), iterable = spy('abcdefg', 2) >>> first 'a' >>> second 'b' The number of items requested can be larger than the number of items in the iterable: >>> iterable = [1, 2, 3, 4, 5] >>> head, iterable = spy(iterable, 10) >>> head [1, 2, 3, 4, 5] >>> list(iterable) [1, 2, 3, 4, 5] )r� r< �copyr )r� r� r r r� r� r� r� s % r� c G s t �t| � �S )a4 Return a new iterable yielding from each iterable in turn, until the shortest is exhausted. >>> list(interleave([1, 2, 3], [4, 5], [6, 7, 8])) [1, 4, 6, 2, 5, 7] For a version that doesn't terminate after the shortest iterable is exhausted, see :func:`interleave_longest`. )r r0 r� �r2 r� r� r� rg 8 s rg c G s" t �t| dti��}dd� |D �S )as Return a new iterable yielding from each iterable in turn, skipping any that are exhausted. >>> list(interleave_longest([1, 2, 3], [4, 5], [6, 7, 8])) [1, 4, 6, 2, 5, 7, 3, 8] This function produces the same output as :func:`roundrobin`, but may perform better for some inputs (in particular when the number of iterables is large). r6 c s s � | ] }|t ur|V qd S r� )r5 �r% r� r� r� r� r= S � � z%interleave_longest.<locals>.<genexpr>)r r0 r r5 )r2 r r� r� r� ri F s ri c # sN � �du rz dd� � D ��W n t y td��w t� �t��kr&td��t��}tt|��fdd�dd �}�fd d�|D �}� fd d�|D �}|d |d d� }}|d |d d� }} || gt|� } t��} | r�t|�V | d 8 } dd� t| |�D �} t| �D ]\} } | d k r�t| | �V | d 8 } | | |7 < q�| sndS dS )aG Interleave multiple iterables so that their elements are evenly distributed throughout the output sequence. >>> iterables = [1, 2, 3, 4, 5], ['a', 'b'] >>> list(interleave_evenly(iterables)) [1, 2, 'a', 3, 4, 'b', 5] >>> iterables = [[1, 2, 3], [4, 5], [6, 7, 8]] >>> list(interleave_evenly(iterables)) [1, 6, 4, 2, 7, 3, 8, 5] This function requires iterables of known length. Iterables without ``__len__()`` can be used by manually specifying lengths with *lengths*: >>> from itertools import combinations, repeat >>> iterables = [combinations(range(4), 2), ['a', 'b', 'c']] >>> lengths = [4 * (4 - 1) // 2, 3] >>> list(interleave_evenly(iterables, lengths=lengths)) [(0, 1), (0, 2), 'a', (0, 3), (1, 2), 'b', (1, 3), (2, 3), 'c'] Based on Bresenham's algorithm. Nc S r# r� )r� r$ r� r� r� r& p r' z%interleave_evenly.<locals>.<listcomp>z^Iterable lengths could not be determined automatically. Specify them with the lengths keyword.z,Mismatching number of iterables and lengths.c s � | S r� r� �r ��lengthsr� r� r� } s z#interleave_evenly.<locals>.<lambda>T�rD r> c s g | ]}� | �qS r� r� �r% r rQ r� r� r& r' c s g | ]}t � | ��qS r� )r� rT rM r� r� r& � � r r4 c S s g | ]\}}|| �qS r� r� )r% r �deltar� r� r� r& � rU ) r� r� r� r r �sumr� r� � enumerate)r2 rR �dims�lengths_permute� lengths_desc� iters_desc� delta_primary�deltas_secondary� iter_primary�iters_secondary�errors�to_yieldr �e_r� )r2 rR r� rh V s@ � ��� � �rh c c s� � t � }|�dt| d�f� |rd|�� }|\}}|dur&||kr&|E dH q|D ]7}t|ttf�s:|dur>t||�r>|V q(zt|�}W n tyP |V Y q(w |�|� |�|d |f� |sdS dS )a> Flatten an iterable with multiple levels of nesting (e.g., a list of lists of tuples) into non-iterable types. >>> iterable = [(1, 2), ([3, 4], [[5], [6]])] >>> list(collapse(iterable)) [1, 2, 3, 4, 5, 6] Binary and text strings are not considered iterable and will not be collapsed. To avoid collapsing other types, specify *base_type*: >>> iterable = ['ab', ('cd', 'ef'), ['gh', 'ij']] >>> list(collapse(iterable, base_type=tuple)) ['ab', ('cd', 'ef'), 'gh', 'ij'] Specify *levels* to stop flattening after a certain level: >>> iterable = [('a', ['b']), ('c', ['d'])] >>> list(collapse(iterable)) # Fully flattened ['a', 'b', 'c', 'd'] >>> list(collapse(iterable, levels=1)) # Only one level flattened ['a', ['b'], 'c', ['d']] r r4 N) r rF r r� r� �str�bytesr� r� ) r� � base_type�levels�stack� node_group�level�nodes�node�treer� r� r� rK � s, � � �rK c c s� � z5|dur |� |du r|D ] }| |� |V qnt ||�D ] }| |� |E dH q W |dur5|� dS dS |dur?|� w w )au Invoke *func* on each item in *iterable* (or on each *chunk_size* group of items) before yielding the item. `func` must be a function that takes a single argument. Its return value will be discarded. *before* and *after* are optional functions that take no arguments. They will be executed before iteration starts and after it ends, respectively. `side_effect` can be used for logging, updating progress bars, or anything that is not functionally "pure." Emitting a status message: >>> from more_itertools import consume >>> func = lambda item: print('Received {}'.format(item)) >>> consume(side_effect(func, range(2))) Received 0 Received 1 Operating on chunks of items: >>> pair_sums = [] >>> func = lambda chunk: pair_sums.append(sum(chunk)) >>> list(side_effect(func, [0, 1, 2, 3, 4, 5], 2)) [0, 1, 2, 3, 4, 5] >>> list(pair_sums) [1, 5, 9] Writing to a file-like object: >>> from io import StringIO >>> from more_itertools import consume >>> f = StringIO() >>> func = lambda x: print(x, file=f) >>> before = lambda: print(u'HEADER', file=f) >>> after = f.close >>> it = [u'a', u'b', u'c'] >>> consume(side_effect(func, it, before=before, after=after)) >>> f.closed True N)rH )r� r� � chunk_size�before�afterr� r� r� r� r� r� � s$ �,� � ��r� c s@ t t��fdd�td��D ��� |r � �fdd�}t|� �S � S )ap Yield slices of length *n* from the sequence *seq*. >>> list(sliced((1, 2, 3, 4, 5, 6), 3)) [(1, 2, 3), (4, 5, 6)] By the default, the last yielded slice will have fewer than *n* elements if the length of *seq* is not divisible by *n*: >>> list(sliced((1, 2, 3, 4, 5, 6, 7, 8), 3)) [(1, 2, 3), (4, 5, 6), (7, 8)] If the length of *seq* is not divisible by *n* and *strict* is ``True``, then ``ValueError`` will be raised before the last slice is yielded. This function will only work for iterables that support slicing. For non-sliceable iterables, see :func:`chunked`. c 3 s � | ] }�||� � V qd S r� r� rT )r� r5 r� r� r= % � � zsliced.<locals>.<genexpr>r c 3 r� )Nzseq is not divisible by n.r� )�_slicer� r� r� r� ( r� zsliced.<locals>.ret)r r� r r� )r5 r� r� r� r� )r� r� r5 r� r� s r� r� c c s� � |dkr t | �V dS g }t| �}|D ]'}||�r6|V |r#|gV |dkr/t |�V dS g }|d8 }q|�|� q|V dS )a; Yield lists of items from *iterable*, where each list is delimited by an item where callable *pred* returns ``True``. >>> list(split_at('abcdcba', lambda x: x == 'b')) [['a'], ['c', 'd', 'c'], ['a']] >>> list(split_at(range(10), lambda n: n % 2 == 1)) [[0], [2], [4], [6], [8], []] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_at(range(10), lambda n: n % 2 == 1, maxsplit=2)) [[0], [2], [4, 5, 6, 7, 8, 9]] By default, the delimiting items are not included in the output. To include them, set *keep_separator* to ``True``. >>> list(split_at('abcdcba', lambda x: x == 'b', keep_separator=True)) [['a'], ['b'], ['c', 'd', 'c'], ['b'], ['a']] r Nr4 �r� r� r� )r� �pred�maxsplit�keep_separator�bufr r� r� r� r� r� 3 s$ � r� c c s� � |dkr t | �V dS g }t| �}|D ]%}||�r4|r4|V |dkr.|gt |� V dS g }|d8 }|�|� q|rA|V dS dS )a\ Yield lists of items from *iterable*, where each list ends just before an item for which callable *pred* returns ``True``: >>> list(split_before('OneTwo', lambda s: s.isupper())) [['O', 'n', 'e'], ['T', 'w', 'o']] >>> list(split_before(range(10), lambda n: n % 3 == 0)) [[0, 1, 2], [3, 4, 5], [6, 7, 8], [9]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_before(range(10), lambda n: n % 3 == 0, maxsplit=2)) [[0, 1, 2], [3, 4, 5], [6, 7, 8, 9]] r Nr4 rs �r� rt ru rw r r� r� r� r� r� _ s$ � �r� c c s� � |dkr t | �V dS g }t| �}|D ]&}|�|� ||�r:|r:|V |dkr4t |�}|r1|V dS g }|d8 }q|rB|V dS dS )a[ Yield lists of items from *iterable*, where each list ends with an item where callable *pred* returns ``True``: >>> list(split_after('one1two2', lambda s: s.isdigit())) [['o', 'n', 'e', '1'], ['t', 'w', 'o', '2']] >>> list(split_after(range(10), lambda n: n % 3 == 0)) [[0], [1, 2, 3], [4, 5, 6], [7, 8, 9]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_after(range(10), lambda n: n % 3 == 0, maxsplit=2)) [[0], [1, 2, 3], [4, 5, 6, 7, 8, 9]] r Nr4 rs rx r� r� r� r� � s* � � �r� c c s� � |dkr t | �V dS t| �}zt|�}W n ty Y dS w |g}|D ]&}|||�rE|V |dkr?|gt |� V dS g }|d8 }|�|� |}q&|V dS )a� Split *iterable* into pieces based on the output of *pred*. *pred* should be a function that takes successive pairs of items and returns ``True`` if the iterable should be split in between them. For example, to find runs of increasing numbers, split the iterable when element ``i`` is larger than element ``i + 1``: >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], lambda x, y: x > y)) [[1, 2, 3, 3], [2, 5], [2, 4], [2]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], ... lambda x, y: x > y, maxsplit=2)) [[1, 2, 3, 3], [2, 5], [2, 4, 2]] r Nr4 )r� r� r� r� r� )r� rt ru r �cur_itemrw � next_itemr� r� r� r� � s, � � r� c c s@ � t | �}|D ]}|du rt|�V dS tt||��V qdS )a� Yield a list of sequential items from *iterable* of length 'n' for each integer 'n' in *sizes*. >>> list(split_into([1,2,3,4,5,6], [1,2,3])) [[1], [2, 3], [4, 5, 6]] If the sum of *sizes* is smaller than the length of *iterable*, then the remaining items of *iterable* will not be returned. >>> list(split_into([1,2,3,4,5,6], [2,3])) [[1, 2], [3, 4, 5]] If the sum of *sizes* is larger than the length of *iterable*, fewer items will be returned in the iteration that overruns *iterable* and further lists will be empty: >>> list(split_into([1,2,3,4], [1,2,3,4])) [[1], [2, 3], [4], []] When a ``None`` object is encountered in *sizes*, the returned list will contain items up to the end of *iterable* the same way that itertools.slice does: >>> list(split_into([1,2,3,4,5,6,7,8,9,0], [2,3,None])) [[1, 2], [3, 4, 5], [6, 7, 8, 9, 0]] :func:`split_into` can be useful for grouping a series of items where the sizes of the groups are not uniform. An example would be where in a row from a table, multiple columns represent elements of the same feature (e.g. a point represented by x,y,z) but, the format is not the same for all columns. N)r� r� r )r� �sizesr r r� r� r� r� � s �# �r� c sb t � �� t� t|����du r�S �dk rtd��|r)� ��fdd�}t�|� �S tt���� �S )a� Yield the elements from *iterable*, followed by *fillvalue*, such that at least *n* items are emitted. >>> list(padded([1, 2, 3], '?', 5)) [1, 2, 3, '?', '?'] If *next_multiple* is ``True``, *fillvalue* will be emitted until the number of items emitted is a multiple of *n*: >>> list(padded([1, 2, 3, 4], n=3, next_multiple=True)) [1, 2, 3, 4, None, None] If *n* is ``None``, *fillvalue* will be emitted indefinitely. To create an *iterable* of exactly size *n*, you can truncate with :func:`islice`. >>> list(islice(padded([1, 2, 3], '?'), 5)) [1, 2, 3, '?', '?'] >>> list(islice(padded([1, 2, 3, 4, 5, 6, 7, 8], '?'), 5)) [1, 2, 3, 4, 5] Nr4 �n must be at least 1c 3 s( � � D ]} | fV t ��d �V qd S �Nr4 �r )r` �r� �iterable_with_repeatr� r� r� �slice_generator# s ��z padded.<locals>.slice_generator)r� r r r� r0 r )r� r6 r� � next_multipler� r� r r� r� s r� r c C s t �tt| t|���S )z�Repeat each element in *iterable* *n* times. >>> list(repeat_each('ABC', 3)) ['A', 'A', 'A', 'B', 'B', 'B', 'C', 'C', 'C'] )r r0 r� r )r� r� r� r� r� r� / s r� c c s8 � t }| D ]}|V q|t u r|n|}t|�E dH dS )a" After the *iterable* is exhausted, keep yielding its last element. >>> list(islice(repeat_last(range(3)), 5)) [0, 1, 2, 2, 2] If the iterable is empty, yield *default* forever:: >>> list(islice(repeat_last(range(0), 42), 5)) [42, 42, 42, 42, 42] N)r5 r )r� r� r� �finalr� r� r� r� 8 s � r� c s0 � dk rt d��t|� �}� fdd�t|�D �S )a� Distribute the items from *iterable* among *n* smaller iterables. >>> group_1, group_2 = distribute(2, [1, 2, 3, 4, 5, 6]) >>> list(group_1) [1, 3, 5] >>> list(group_2) [2, 4, 6] If the length of *iterable* is not evenly divisible by *n*, then the length of the returned iterables will not be identical: >>> children = distribute(3, [1, 2, 3, 4, 5, 6, 7]) >>> [list(c) for c in children] [[1, 4, 7], [2, 5], [3, 6]] If the length of *iterable* is smaller than *n*, then the last returned iterables will be empty: >>> children = distribute(5, [1, 2, 3]) >>> [list(c) for c in children] [[1], [2], [3], [], []] This function uses :func:`itertools.tee` and may require significant storage. If you need the order items in the smaller iterables to match the original iterable, see :func:`divide`. r4 r| c s g | ] \}}t ||d � ��qS r� r~ )r% r� r �r� r� r� r& m s z distribute.<locals>.<listcomp>)r� r rX )r� r� �childrenr� r� r� rW K s rW �r� r r4 c C s t | t|��}t||||d��S )a[ Yield tuples whose elements are offset from *iterable*. The amount by which the `i`-th item in each tuple is offset is given by the `i`-th item in *offsets*. >>> list(stagger([0, 1, 2, 3])) [(None, 0, 1), (0, 1, 2), (1, 2, 3)] >>> list(stagger(range(8), offsets=(0, 2, 4))) [(0, 2, 4), (1, 3, 5), (2, 4, 6), (3, 5, 7)] By default, the sequence will end when the final element of a tuple is the last item in the iterable. To continue until the first element of a tuple is the last item in the iterable, set *longest* to ``True``:: >>> list(stagger([0, 1, 2, 3], longest=True)) [(None, 0, 1), (0, 1, 2), (1, 2, 3), (2, 3, None), (3, None, None)] By default, ``None`` will be used to replace offsets beyond the end of the sequence. Specify *fillvalue* to use some other value. )�offsets�longestr6 )r r� r� )r� r� r� r6 r� r� r� r� r� p s �r� c G s t dkr t�dt� t| � S )a ``zip`` the input *iterables* together, but raise ``UnequalIterablesError`` if they aren't all the same length. >>> it_1 = range(3) >>> it_2 = iter('abc') >>> list(zip_equal(it_1, it_2)) [(0, 'a'), (1, 'b'), (2, 'c')] >>> it_1 = range(3) >>> it_2 = iter('abcd') >>> list(zip_equal(it_1, it_2)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... more_itertools.more.UnequalIterablesError: Iterables have different lengths i� zwzip_equal will be removed in a future version of more-itertools. Use the builtin zip function with strict=True instead.)r1 �warnings�warn�DeprecationWarningr6 rM r� r� r� r� � s � r� )r� r6 c G s� t |�t | �kr td��g }t|| �D ](\}}|dk r(|�tt|| �|�� q|dkr6|�t||d�� q|�|� q|rEt|d|i�S t|� S )aF ``zip`` the input *iterables* together, but offset the `i`-th iterable by the `i`-th item in *offsets*. >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1))) [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e')] This can be used as a lightweight alternative to SciPy or pandas to analyze data sets in which some series have a lead or lag relationship. By default, the sequence will end when the shortest iterable is exhausted. To continue until the longest iterable is exhausted, set *longest* to ``True``. >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1), longest=True)) [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e'), (None, 'f')] By default, ``None`` will be used to replace offsets beyond the end of the sequence. Specify *fillvalue* to use some other value. z,Number of iterables and offsets didn't matchr Nr6 )r� r� r� r� r r r r )r� r� r6 r2 � staggeredr r� r� r� r� r� � s r� �r c sn �du r t |� }n!t|�}t|�dkr |d ���fdd�}n t |� � � �fdd�}tttt| � ||d�� �S )a� Return the input iterables sorted together, with *key_list* as the priority for sorting. All iterables are trimmed to the length of the shortest one. This can be used like the sorting function in a spreadsheet. If each iterable represents a column of data, the key list determines which columns are used for sorting. By default, all iterables are sorted using the ``0``-th iterable:: >>> iterables = [(4, 3, 2, 1), ('a', 'b', 'c', 'd')] >>> sort_together(iterables) [(1, 2, 3, 4), ('d', 'c', 'b', 'a')] Set a different key list to sort according to another iterable. Specifying multiple keys dictates how ties are broken:: >>> iterables = [(3, 1, 2), (0, 1, 0), ('c', 'b', 'a')] >>> sort_together(iterables, key_list=(1, 2)) [(2, 3, 1), (0, 0, 1), ('a', 'c', 'b')] To sort by a function of the elements of the iterable, pass a *key* function. Its arguments are the elements of the iterables corresponding to the key list:: >>> names = ('a', 'b', 'c') >>> lengths = (1, 2, 3) >>> widths = (5, 2, 1) >>> def area(length, width): ... return length * width >>> sort_together([names, lengths, widths], key_list=(1, 2), key=area) [('c', 'b', 'a'), (3, 2, 1), (1, 2, 5)] Set *reverse* to ``True`` to sort in descending order. >>> sort_together([(1, 2, 3), ('c', 'b', 'a')], reverse=True) [(3, 2, 1), ('a', 'b', 'c')] Nr4 r c s � | � �S r� r� �� zipped_items)rD � key_offsetr� r� r� s z sort_together.<locals>.<lambda>c s �� | �� S r� r� r� )� get_key_itemsrD r� r� r� s �rS )r* r� r� r� r )r2 �key_listrD r> � key_argumentr� )r� rD r� r� r� � s ( �r� c sP t t| ��\}} |s dS |d }t| t|��}dd� � t� fdd�t|�D ��S )a� The inverse of :func:`zip`, this function disaggregates the elements of the zipped *iterable*. The ``i``-th iterable contains the ``i``-th element from each element of the zipped iterable. The first element is used to determine the length of the remaining elements. >>> iterable = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] >>> letters, numbers = unzip(iterable) >>> list(letters) ['a', 'b', 'c', 'd'] >>> list(numbers) [1, 2, 3, 4] This is similar to using ``zip(*iterable)``, but it avoids reading *iterable* into memory. Note, however, that this function uses :func:`itertools.tee` and thus may require significant storage. r� r c s � fdd�}|S )Nc s z| � W S t y t�w r� )r� r� ��objrP r� r� �getter1 s �z)unzip.<locals>.itemgetter.<locals>.getterr� )r r� r� rP r� r* 0 s zunzip.<locals>.itemgetterc 3 s" � | ] \}}t � |�|�V qd S r� �r� )r% r r �r* r� r� r= B � � zunzip.<locals>.<genexpr>)r� r� r r� r rX )r� r r2 r� r� r� r� s r� c C s� | dk rt d��z|dd� W n ty t|�}Y nw |}tt|�| �\}}g }d}td| d �D ]}|}|||krA|d n|7 }|�t|||� �� q4|S )a~ Divide the elements from *iterable* into *n* parts, maintaining order. >>> group_1, group_2 = divide(2, [1, 2, 3, 4, 5, 6]) >>> list(group_1) [1, 2, 3] >>> list(group_2) [4, 5, 6] If the length of *iterable* is not evenly divisible by *n*, then the length of the returned iterables will not be identical: >>> children = divide(3, [1, 2, 3, 4, 5, 6, 7]) >>> [list(c) for c in children] [[1, 2, 3], [4, 5], [6, 7]] If the length of the iterable is smaller than n, then the last returned iterables will be empty: >>> children = divide(5, [1, 2, 3]) >>> [list(c) for c in children] [[1], [2], [3], [], []] This function will exhaust the iterable before returning. If order is not important, see :func:`distribute`, which does not first pull the iterable into memory. r4 r| Nr )r� r� r �divmodr� r r� r� ) r� r� r5 �qr r� r� r r� r� r� r� rX E s �rX c C sT | du rt d�S |durt| |�rt | f�S zt | �W S ty) t | f� Y S w )ax If *obj* is iterable, return an iterator over its items:: >>> obj = (1, 2, 3) >>> list(always_iterable(obj)) [1, 2, 3] If *obj* is not iterable, return a one-item iterable containing *obj*:: >>> obj = 1 >>> list(always_iterable(obj)) [1] If *obj* is ``None``, return an empty iterable: >>> obj = None >>> list(always_iterable(None)) [] By default, binary and text strings are not considered iterable:: >>> obj = 'foo' >>> list(always_iterable(obj)) ['foo'] If *base_type* is set, objects for which ``isinstance(obj, base_type)`` returns ``True`` won't be considered iterable. >>> obj = {'a': 1} >>> list(always_iterable(obj)) # Iterate over the dict's keys ['a'] >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit [{'a': 1}] Set *base_type* to ``None`` to avoid any special handling and treat objects Python considers iterable as iterable: >>> obj = 'foo' >>> list(always_iterable(obj, base_type=None)) ['f', 'o', 'o'] Nr� )r� r� r� )r� rf r� r� r� rD x s ) �rD c C sZ |dk rt d��t|�\}}dg| }t|t| |�|�}ttt|d| d ��}t||�S )as Return an iterable over `(bool, item)` tuples where the `item` is drawn from *iterable* and the `bool` indicates whether that item satisfies the *predicate* or is adjacent to an item that does. For example, to find whether items are adjacent to a ``3``:: >>> list(adjacent(lambda x: x == 3, range(6))) [(False, 0), (False, 1), (True, 2), (True, 3), (True, 4), (False, 5)] Set *distance* to change what counts as adjacent. For example, to find whether items are two places away from a ``3``: >>> list(adjacent(lambda x: x == 3, range(6), distance=2)) [(False, 0), (True, 1), (True, 2), (True, 3), (True, 4), (True, 5)] This is useful for contextualizing the results of a search function. For example, a code comparison tool might want to identify lines that have changed, but also surrounding lines to give the viewer of the diff context. The predicate function will only be called once for each item in the iterable. See also :func:`groupby_transform`, which can be used with this function to group ranges of items with the same `bool` value. r zdistance must be at least 0Fr r4 )r� r r r� �anyr� r� )� predicater� �distance�i1�i2r8 �selected�adjacent_to_selectedr� r� r� rB � s rB c s: t | |�}�r�fdd�|D �}� r� fdd�|D �}|S )a An extension of :func:`itertools.groupby` that can apply transformations to the grouped data. * *keyfunc* is a function computing a key value for each item in *iterable* * *valuefunc* is a function that transforms the individual items from *iterable* after grouping * *reducefunc* is a function that transforms each group of items >>> iterable = 'aAAbBBcCC' >>> keyfunc = lambda k: k.upper() >>> valuefunc = lambda v: v.lower() >>> reducefunc = lambda g: ''.join(g) >>> list(groupby_transform(iterable, keyfunc, valuefunc, reducefunc)) [('A', 'aaa'), ('B', 'bbb'), ('C', 'ccc')] Each optional argument defaults to an identity function if not specified. :func:`groupby_transform` is useful when grouping elements of an iterable using a separate iterable as the key. To do this, :func:`zip` the iterables and pass a *keyfunc* that extracts the first element and a *valuefunc* that extracts the second element:: >>> from operator import itemgetter >>> keys = [0, 0, 1, 1, 1, 2, 2, 2, 3] >>> values = 'abcdefghi' >>> iterable = zip(keys, values) >>> grouper = groupby_transform(iterable, itemgetter(0), itemgetter(1)) >>> [(k, ''.join(g)) for k, g in grouper] [(0, 'ab'), (1, 'cde'), (2, 'fgh'), (3, 'i')] Note that the order of items in the iterable is significant. Only adjacent items are grouped together, so if you don't want any duplicate groups, you should sort the iterable by the key function. c 3 s" � | ] \}}|t � |�fV qd S r� r� �r% �k�g)� valuefuncr� r� r= � r� z$groupby_transform.<locals>.<genexpr>c 3 s � | ] \}}|� |�fV qd S r� r� r� )� reducefuncr� r� r= � rq �r )r� �keyfuncr� r� r� r� )r� r� r� rb � s $rb c @ s� e Zd ZdZeedd��Zdd� Zdd� Zdd� Z d d � Z d d � Z d d� Z dd� Z dd� Zedd� �Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!S )"r~ a< An extension of the built-in ``range()`` function whose arguments can be any orderable numeric type. With only *stop* specified, *start* defaults to ``0`` and *step* defaults to ``1``. The output items will match the type of *stop*: >>> list(numeric_range(3.5)) [0.0, 1.0, 2.0, 3.0] With only *start* and *stop* specified, *step* defaults to ``1``. The output items will match the type of *start*: >>> from decimal import Decimal >>> start = Decimal('2.1') >>> stop = Decimal('5.1') >>> list(numeric_range(start, stop)) [Decimal('2.1'), Decimal('3.1'), Decimal('4.1')] With *start*, *stop*, and *step* specified the output items will match the type of ``start + step``: >>> from fractions import Fraction >>> start = Fraction(1, 2) # Start at 1/2 >>> stop = Fraction(5, 2) # End at 5/2 >>> step = Fraction(1, 2) # Count by 1/2 >>> list(numeric_range(start, stop, step)) [Fraction(1, 2), Fraction(1, 1), Fraction(3, 2), Fraction(2, 1)] If *step* is zero, ``ValueError`` is raised. Negative steps are supported: >>> list(numeric_range(3, -1, -1.0)) [3.0, 2.0, 1.0, 0.0] Be aware of the limitations of floating point numbers; the representation of the yielded numbers may be surprising. ``datetime.datetime`` objects can be used for *start* and *stop*, if *step* is a ``datetime.timedelta`` object: >>> import datetime >>> start = datetime.datetime(2019, 1, 1) >>> stop = datetime.datetime(2019, 1, 3) >>> step = datetime.timedelta(days=1) >>> items = iter(numeric_range(start, stop, step)) >>> next(items) datetime.datetime(2019, 1, 1, 0, 0) >>> next(items) datetime.datetime(2019, 1, 2, 0, 0) r c G s� t |�}|dkr |\| _t| j�d�| _t| j| j �d�| _n5|dkr6|\| _| _t| j| j �d�| _n |dkrC|\| _| _| _n|dkrNtd�|���td�|���t| j�d�| _| j| jkrgtd��| j| jk| _ d S )Nr4 r r � z2numeric_range expected at least 1 argument, got {}z2numeric_range expected at most 3 arguments, got {}z&numeric_range() arg 3 must not be zero) r� �_stop�type�_start�_stepr� r �_zeror� �_growing)r� r� �argcr� r� r� r� 7 s. �� znumeric_range.__init__c C s | j r | j| jk S | j| jkS r� )r� r� r� r� r� r� r� r� R s znumeric_range.__bool__c C sx | j r | j| kr| jk r n dS || j | j | jkS dS | j| kr+| jkr:n dS | j| | j | jkS dS �NF)r� r� r� r� r� )r� �elemr� r� r� r. X s ���znumeric_range.__contains__c C s^ t |t�r-t| � }t|� }|s|r|o|S | j|jko,| j|jko,| �d�|�d�kS dS )Nr� F)r� r~ �boolr� r� � _get_by_index)r� �other� empty_self� empty_otherr� r� r� �__eq__b s ��znumeric_range.__eq__c C s� t |t�r | �|�S t |t�rc|jd u r| jn|j| j }|jd u s)|j| j kr-| j}n|j| jkr7| j }n| �|j�}|j d u sH|j | jkrL| j }n|j | j krW| j}n| �|j �}t |||�S t d� t|�j���)Nz8numeric range indices must be integers or slices, not {})r� �intr� r� r� r� r� �_lenr� r� r� r~ r� r r� r� )r� rD r� r� r� r� r� r� r� q s& �znumeric_range.__getitem__c C s" | rt | j| �d�| jf�S | jS �Nr� )�hashr� r� r� � _EMPTY_HASHr� r� r� r� �__hash__� s znumeric_range.__hash__c s> � fdd�t � D �}� jrttt� j�|�S ttt� j�|�S )Nc 3 s � | ] }� j |� j V qd S r� )r� r� �r% r� r� r� r� r= � rq z)numeric_range.__iter__.<locals>.<genexpr>)r r� r r r- r� r. )r� �valuesr� r� r� r� � s znumeric_range.__iter__c C s | j S r� )r� r� r� r� r� �__len__� s znumeric_range.__len__c C sh | j r | j}| j}| j}n | j}| j}| j }|| }|| jkr"dS t||�\}}t|�t|| jk� S �Nr )r� r� r� r� r� r� r� )r� r� r� r� r� r� r r� r� r� r� � s znumeric_range._lenc C s t | j| j| jffS r� )r~ r� r� r� r� r� r� r� � __reduce__� s znumeric_range.__reduce__c C sB | j dkrd�t| j�t| j��S d�t| j�t| j�t| j ��S )Nr4 znumeric_range({}, {})znumeric_range({}, {}, {}))r� r �reprr� r� r� r� r� r� �__repr__� s ��znumeric_range.__repr__c C s" t t| �d�| j| j | j ��S r� )r� r~ r� r� r� r� r� r� r� r� � s ��znumeric_range.__reversed__c C s t || v �S r� )r� rK r� r� r� r � s znumeric_range.countc C s� | j r&| j| kr| jk r%n n8t|| j | j�\}}|| jkr%t|�S n#| j| kr2| jkrIn nt| j| | j �\}}|| jkrIt|�S td�|���)Nz{} is not in numeric range) r� r� r� r� r� r� r� r� r )r� rG r� r r� r� r� r� � s � znumeric_range.indexc C s< |dk r || j 7 }|dk s|| j krtd��| j|| j S )Nr z'numeric range object index out of range)r� r� r� r� )r� r r� r� r� r� � s znumeric_range._get_by_indexN)r� r� r� r� r� r r� r� r� r. r� r� r� r� r� r r� r� r� r� r r� r� r� r� r� r� r~ s& 3 r~ c s< t � �� � s td�S |du rt� nt|�}� fdd�|D �S )a Cycle through the items from *iterable* up to *n* times, yielding the number of completed cycles along with each item. If *n* is omitted the process repeats indefinitely. >>> list(count_cycle('AB', 3)) [(0, 'A'), (0, 'B'), (1, 'A'), (1, 'B'), (2, 'A'), (2, 'B')] r� Nc 3 s" � | ] }� D ]}||fV qqd S r� r� )r% r r� �r� r� r� r= � r� z count_cycle.<locals>.<genexpr>)r r� r r )r� r� r� r� r� r� rQ � s rQ c c s� � t | �}zt|�}W n ty Y dS w zt� D ]}|}t|�}|dkd|fV qW dS ty? |dkd|fV Y dS w )aH Yield 3-tuples of the form ``(is_first, is_last, item)``. >>> list(mark_ends('ABC')) [(True, False, 'A'), (False, False, 'B'), (False, True, 'C')] Use this when looping over an iterable to take special action on its first and/or last items: >>> iterable = ['Header', 100, 200, 'Footer'] >>> total = 0 >>> for is_first, is_last, item in mark_ends(iterable): ... if is_first: ... continue # Skip the header ... if is_last: ... continue # Skip the footer ... total += item >>> print(total) 300 Nr FT)r� r� r� r )r� r �br �ar� r� r� rx � s � � � �rx c C sJ |du r t t� t|| ��S |dk rtd��t| |td�}t t� t||��S )a� Yield the index of each item in *iterable* for which *pred* returns ``True``. *pred* defaults to :func:`bool`, which will select truthy items: >>> list(locate([0, 1, 1, 0, 1, 0, 0])) [1, 2, 4] Set *pred* to a custom function to, e.g., find the indexes for a particular item. >>> list(locate(['a', 'b', 'c', 'b'], lambda x: x == 'b')) [1, 3] If *window_size* is given, then the *pred* function will be called with that many items. This enables searching for sub-sequences: >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] >>> pred = lambda *args: args == (1, 2, 3) >>> list(locate(iterable, pred=pred, window_size=3)) [1, 5, 9] Use with :func:`seekable` to find indexes and then retrieve the associated items: >>> from itertools import count >>> from more_itertools import seekable >>> source = (3 * n + 1 if (n % 2) else n // 2 for n in count()) >>> it = seekable(source) >>> pred = lambda x: x > 100 >>> indexes = locate(it, pred=pred) >>> i = next(indexes) >>> it.seek(i) >>> next(it) 106 Nr4 z window size must be at least 1�r6 )r r r� r� r� r5 r )r� rt � window_sizer r� r� r� rq s &rq c C s dd� t tt| � �D �S )z�Yield elements of the longest common prefix amongst given *iterables*. >>> ''.join(longest_common_prefix(['abcd', 'abc', 'abf'])) 'ab' c s s � | ]}|d V qdS )r Nr� )r% �cr� r� r� r= F � � z(longest_common_prefix.<locals>.<genexpr>)r r> r� rM r� r� r� rr ? s rr c C s t || �S )a� Yield the items from *iterable*, but strip any from the beginning for which *pred* returns ``True``. For example, to remove a set of items from the start of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(lstrip(iterable, pred)) [1, 2, None, 3, False, None] This function is analogous to to :func:`str.lstrip`, and is essentially an wrapper for :func:`itertools.dropwhile`. )r �r� rt r� r� r� rs I s rs c c sH � g }|j }|j}| D ]}||�r||� q |E dH |� |V q dS )a� Yield the items from *iterable*, but strip any from the end for which *pred* returns ``True``. For example, to remove a set of items from the end of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(rstrip(iterable, pred)) [None, False, None, 1, 2, None, 3] This function is analogous to :func:`str.rstrip`. N)r� �clear)r� rt �cache� cache_append� cache_clearr� r� r� r� r� [ s � �r� c C s t t| |�|�S )a� Yield the items from *iterable*, but strip any from the beginning and end for which *pred* returns ``True``. For example, to remove a set of items from both ends of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(strip(iterable, pred)) [1, 2, None, 3] This function is analogous to :func:`str.strip`. )r� rs r� r� r� r� r� u s r� c @ �0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) rl a An extension of :func:`itertools.islice` that supports negative values for *stop*, *start*, and *step*. >>> iterable = iter('abcdefgh') >>> list(islice_extended(iterable, -4, -1)) ['e', 'f', 'g'] Slices with negative values require some caching of *iterable*, but this function takes care to minimize the amount of memory required. For example, you can use a negative step with an infinite iterator: >>> from itertools import count >>> list(islice_extended(count(), 110, 99, -2)) [110, 108, 106, 104, 102, 100] You can also use slice notation directly: >>> iterable = map(str, count()) >>> it = islice_extended(iterable)[10:20:2] >>> list(it) ['10', '12', '14', '16', '18'] c G s* t |�}|rt|t|� �| _d S || _d S r� )r� �_islice_helperr� � _iterable)r� r� r� r r� r� r� r� � s zislice_extended.__init__c C r� r� r� r� r� r� r� r� � r� zislice_extended.__iter__c C � t | j�S r� )r� r� r� r� r� r� r� � � zislice_extended.__next__c C s" t |t�r tt| j|��S td��)Nz4islice_extended.__getitem__ argument must be a slice)r� r� rl r� r� r� )r� rD r� r� r� r� � s zislice_extended.__getitem__N)r� r� r� r� r� r� r� r� r� r� r� r� rl � s rl c c s� � |j }|j}|jdkrtd��|jpd}|dkr�|d u r dn|}|dk rstt| d�| d�}|r7|d d nd}t|| d�}|d u rG|}n|dkrQt||�}nt|| d�}|| } | dkrbd S t|d| |�D ]\} } | V qid S |d ur�|dk r�t t| ||�d � tt| | �| d�}t| �D ]\} } |� � } | | dkr�| V |� | � q�d S t| |||�E d H d S |d u r�dn|}|d u�r |dk �r | d } tt| d�| d�}|r�|d d nd}|dk r�||}}n t|| d�d }}t |�|||� D ]\} } | V q�d S |d u�r|d } t t| | | �d � |dk �r%|}d } n|d u �r1d }|d } n d }|| } | dk�r>d S t t| | ��}||d |� E d H d S )Nr z1step argument must be a non-zero integer or None.r4 r� r� ) r� r� r� r� r rX r� r� r r� r� r� r� )r �sr� r� r� r� �len_iterr r r� r� r� � cached_item�mr� r� r� r� � sv � � � � r� c C s* zt | �W S ty t t| �� Y S w )a� An extension of :func:`reversed` that supports all iterables, not just those which implement the ``Reversible`` or ``Sequence`` protocols. >>> print(*always_reversible(x for x in range(3))) 2 1 0 If the iterable is already reversible, this function returns the result of :func:`reversed()`. If the iterable is not reversible, this function will cache the remaining items in the iterable and yield them in reverse order, which may require significant storage. )r� r� r� r� r� r� r� rE s �rE c C r� r� r� r@ r� r� r� r� & rA c # s8 � t t| �� fdd�d�D ] \}}ttd�|�V q dS )a� Yield groups of consecutive items using :func:`itertools.groupby`. The *ordering* function determines whether two items are adjacent by returning their position. By default, the ordering function is the identity function. This is suitable for finding runs of numbers: >>> iterable = [1, 10, 11, 12, 20, 30, 31, 32, 33, 40] >>> for group in consecutive_groups(iterable): ... print(list(group)) [1] [10, 11, 12] [20] [30, 31, 32, 33] [40] For finding runs of adjacent letters, try using the :meth:`index` method of a string of letters: >>> from string import ascii_lowercase >>> iterable = 'abcdfgilmnop' >>> ordering = ascii_lowercase.index >>> for group in consecutive_groups(iterable, ordering): ... print(list(group)) ['a', 'b', 'c', 'd'] ['f', 'g'] ['i'] ['l', 'm', 'n', 'o', 'p'] Each group of consecutive items is an iterator that shares it source with *iterable*. When an an output group is advanced, the previous group is no longer available unless its elements are copied (e.g., into a ``list``). >>> iterable = [1, 2, 11, 12, 21, 22] >>> saved_groups = [] >>> for group in consecutive_groups(iterable): ... saved_groups.append(list(group)) # Copy group elements >>> saved_groups [[1, 2], [11, 12], [21, 22]] c s | d � | d � S r� r� r@ ��orderingr� r� r� Q r' z$consecutive_groups.<locals>.<lambda>�rD r4 N)r rX r� r* )r� r� r� r� r� r� r� rN & s �*��rN )�initialc C sT t | �\}}zt|�g}W n ty tg � Y S w |dur!g }t|t|||��S )a� This function is the inverse of :func:`itertools.accumulate`. By default it will compute the first difference of *iterable* using :func:`operator.sub`: >>> from itertools import accumulate >>> iterable = accumulate([0, 1, 2, 3, 4]) # produces 0, 1, 3, 6, 10 >>> list(difference(iterable)) [0, 1, 2, 3, 4] *func* defaults to :func:`operator.sub`, but other functions can be specified. They will be applied as follows:: A, B, C, D, ... --> A, func(B, A), func(C, B), func(D, C), ... For example, to do progressive division: >>> iterable = [1, 2, 6, 24, 120] >>> func = lambda x, y: x // y >>> list(difference(iterable, func)) [1, 2, 3, 4, 5] If the *initial* keyword is set, the first element will be skipped when computing successive differences. >>> it = [10, 11, 13, 16] # from accumulate([1, 2, 3], initial=10) >>> list(difference(it, initial=10)) [1, 2, 3] N)r r� r� r� r r� )r� r� r� r� r� r` r� r� r� rT V s �rT c @ r� ) rA aS Return a read-only view of the sequence object *target*. :class:`SequenceView` objects are analogous to Python's built-in "dictionary view" types. They provide a dynamic view of a sequence's items, meaning that when the sequence updates, so does the view. >>> seq = ['0', '1', '2'] >>> view = SequenceView(seq) >>> view SequenceView(['0', '1', '2']) >>> seq.append('3') >>> view SequenceView(['0', '1', '2', '3']) Sequence views support indexing, slicing, and length queries. They act like the underlying sequence, except they don't allow assignment: >>> view[1] '1' >>> view[1:-1] ['1', '2'] >>> len(view) 4 Sequence views are useful as an alternative to copying, as they don't require (much) extra storage. c C s t |t�st�|| _d S r� )r� r r� �_target)r� �targetr� r� r� r� � s zSequenceView.__init__c C s | j | S r� )r� )r� r� r� r� r� r� � r� zSequenceView.__getitem__c C r� r� )r� r� r� r� r� r� r� � r� zSequenceView.__len__c C s d� | jjt| j��S )Nz{}({}))r � __class__r� r� r� r� r� r� r� r� � s zSequenceView.__repr__N)r� r� r� r� r� r� r� r� r� r� r� r� rA � s rA c @ sV e Zd ZdZddd�Zdd� Zdd� Zd d � Zefd d �Z d d� Z dd� Z dd� Z dS )r� ap Wrap an iterator to allow for seeking backward and forward. This progressively caches the items in the source iterable so they can be re-visited. Call :meth:`seek` with an index to seek to that position in the source iterable. To "reset" an iterator, seek to ``0``: >>> from itertools import count >>> it = seekable((str(n) for n in count())) >>> next(it), next(it), next(it) ('0', '1', '2') >>> it.seek(0) >>> next(it), next(it), next(it) ('0', '1', '2') >>> next(it) '3' You can also seek forward: >>> it = seekable((str(n) for n in range(20))) >>> it.seek(10) >>> next(it) '10' >>> it.relative_seek(-2) # Seeking relative to the current position >>> next(it) '9' >>> it.seek(20) # Seeking past the end of the source isn't a problem >>> list(it) [] >>> it.seek(0) # Resetting works even after hitting the end >>> next(it), next(it), next(it) ('0', '1', '2') Call :meth:`peek` to look ahead one item without advancing the iterator: >>> it = seekable('1234') >>> it.peek() '1' >>> list(it) ['1', '2', '3', '4'] >>> it.peek(default='empty') 'empty' Before the iterator is at its end, calling :func:`bool` on it will return ``True``. After it will return ``False``: >>> it = seekable('5678') >>> bool(it) True >>> list(it) ['5', '6', '7', '8'] >>> bool(it) False You may view the contents of the cache with the :meth:`elements` method. That returns a :class:`SequenceView`, a view that updates automatically: >>> it = seekable((str(n) for n in range(10))) >>> next(it), next(it), next(it) ('0', '1', '2') >>> elements = it.elements() >>> elements SequenceView(['0', '1', '2']) >>> next(it) '3' >>> elements SequenceView(['0', '1', '2', '3']) By default, the cache grows as the source iterable progresses, so beware of wrapping very large or infinite iterables. Supply *maxlen* to limit the size of the cache (this of course limits how far back you can seek). >>> from itertools import count >>> it = seekable((str(n) for n in count()), maxlen=2) >>> next(it), next(it), next(it), next(it) ('0', '1', '2', '3') >>> list(it.elements()) ['2', '3'] >>> it.seek(0) >>> next(it), next(it), next(it), next(it) ('2', '3', '4', '5') >>> next(it) '6' Nc C s0 t |�| _|d u r g | _ntg |�| _d | _d S r� )r� �_sourcer� r �_index)r� r� r� r� r� r� r� s zseekable.__init__c C r� r� r� r� r� r� r� r� r� zseekable.__iter__c C s` | j d ur#z| j| j }W n ty d | _ Y n w | j d7 _ |S t| j�}| j�|� |S r} )r� r� r� r� r� r� �r� r� r� r� r� r� s � zseekable.__next__c C r� r� r� r� r� r� r� r� r� zseekable.__bool__c C sV zt | �}W n ty |tu r� | Y S w | jd u r"t| j�| _| jd8 _|S r} )r� r� r5 r� r� r� )r� r� �peekedr� r� r� r� & s � z seekable.peekc C r� r� )rA r� r� r� r� r� �elements2 r� zseekable.elementsc C s. || _ |t| j� }|dkrt| |� d S d S r� )r� r� r� r8 )r� r� � remainderr� r� r� �seek5 s �z seekable.seekc C s" t | j�}| �t|| d�� d S r� )r� r� r� r� )r� r r� r� r� r� � relative_seek; s zseekable.relative_seekr� ) r� r� r� r� r� r� r� r� r5 r� r� r� r� r� r� r� r� r� � s X r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )r� a� :func:`run_length.encode` compresses an iterable with run-length encoding. It yields groups of repeated items with the count of how many times they were repeated: >>> uncompressed = 'abbcccdddd' >>> list(run_length.encode(uncompressed)) [('a', 1), ('b', 2), ('c', 3), ('d', 4)] :func:`run_length.decode` decompresses an iterable that was previously compressed with run-length encoding. It yields the items of the decompressed iterable: >>> compressed = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] >>> list(run_length.decode(compressed)) ['a', 'b', 'b', 'c', 'c', 'c', 'd', 'd', 'd', 'd'] c C s dd� t | �D �S )Nc s s � | ] \}}|t |�fV qd S r� )rf r� r� r� r� r= V rq z$run_length.encode.<locals>.<genexpr>r� r� r� r� r� �encodeT s zrun_length.encodec C s t �dd� | D ��S )Nc s s � | ] \}}t ||�V qd S r� )r )r% r� r� r� r� r� r= Z � � z$run_length.decode.<locals>.<genexpr>)r r0 r� r� r� r� �decodeX s zrun_length.decodeN)r� r� r� r� � staticmethodr� r� r� r� r� r� r� @ s r� c C s t t|d t|| ���|kS )a� Return ``True`` if exactly ``n`` items in the iterable are ``True`` according to the *predicate* function. >>> exactly_n([True, True, False], 2) True >>> exactly_n([True, True, False], 1) False >>> exactly_n([0, 1, 2, 3, 4, 5], 3, lambda x: x < 3) True The iterable will be advanced until ``n + 1`` truthy items are encountered, so avoid calling it on infinite iterables. r4 )r� r< r- )r� r� r� r� r� r� r] ] s r] c C s$ t | �}tt|�tt|�t|���S )z�Return a list of circular shifts of *iterable*. >>> circular_shifts(range(4)) [(0, 1, 2, 3), (1, 2, 3, 0), (2, 3, 0, 1), (3, 0, 1, 2)] )r� r< r� r� r )r� �lstr� r� r� rJ o s rJ c s � �fdd�}|S )a� Return a decorator version of *wrapping_func*, which is a function that modifies an iterable. *result_index* is the position in that function's signature where the iterable goes. This lets you use itertools on the "production end," i.e. at function definition. This can augment what the function returns without changing the function's code. For example, to produce a decorator version of :func:`chunked`: >>> from more_itertools import chunked >>> chunker = make_decorator(chunked, result_index=0) >>> @chunker(3) ... def iter_range(n): ... return iter(range(n)) ... >>> list(iter_range(9)) [[0, 1, 2], [3, 4, 5], [6, 7, 8]] To only allow truthy items to be returned: >>> truth_serum = make_decorator(filter, result_index=1) >>> @truth_serum(bool) ... def boolean_test(): ... return [0, 1, '', ' ', False, True] ... >>> list(boolean_test()) [1, ' ', True] The :func:`peekable` and :func:`seekable` wrappers make for practical decorators: >>> from more_itertools import peekable >>> peekable_function = make_decorator(peekable) >>> @peekable_function() ... def str_range(*args): ... return (str(x) for x in range(*args)) ... >>> it = str_range(1, 20, 2) >>> next(it), next(it), next(it) ('1', '3', '5') >>> it.peek() '7' >>> next(it) '7' c s �� ��fdd�}|S )Nc s � ����fdd�}|S )Nc s0 � | i |��}t ��}|��|� �|i ���S r� )r� �insert)r� r� �result�wrapping_args_)�f� result_index� wrapping_args� wrapping_func�wrapping_kwargsr� r� � inner_wrapper� s zOmake_decorator.<locals>.decorator.<locals>.outer_wrapper.<locals>.inner_wrapperr� )r� r� )r� r� r� r� )r� r� � outer_wrapper� s z8make_decorator.<locals>.decorator.<locals>.outer_wrapperr� )r� r� r� �r� r� )r� r� r� � decorator� s z!make_decorator.<locals>.decoratorr� )r� r� r� r� r� r� rt y s 3 rt c C st |du rdd� n|}t t�}| D ]}||�}||�}|| �|� q|dur5|�� D ] \}}||�||< q*d|_|S )a� Return a dictionary that maps the items in *iterable* to categories defined by *keyfunc*, transforms them with *valuefunc*, and then summarizes them by category with *reducefunc*. *valuefunc* defaults to the identity function if it is unspecified. If *reducefunc* is unspecified, no summarization takes place: >>> keyfunc = lambda x: x.upper() >>> result = map_reduce('abbccc', keyfunc) >>> sorted(result.items()) [('A', ['a']), ('B', ['b', 'b']), ('C', ['c', 'c', 'c'])] Specifying *valuefunc* transforms the categorized items: >>> keyfunc = lambda x: x.upper() >>> valuefunc = lambda x: 1 >>> result = map_reduce('abbccc', keyfunc, valuefunc) >>> sorted(result.items()) [('A', [1]), ('B', [1, 1]), ('C', [1, 1, 1])] Specifying *reducefunc* summarizes the categorized items: >>> keyfunc = lambda x: x.upper() >>> valuefunc = lambda x: 1 >>> reducefunc = sum >>> result = map_reduce('abbccc', keyfunc, valuefunc, reducefunc) >>> sorted(result.items()) [('A', 1), ('B', 2), ('C', 3)] You may want to filter the input iterable before applying the map/reduce procedure: >>> all_items = range(30) >>> items = [x for x in all_items if 10 <= x <= 20] # Filter >>> keyfunc = lambda x: x % 2 # Evens map to 0; odds to 1 >>> categories = map_reduce(items, keyfunc=keyfunc) >>> sorted(categories.items()) [(0, [10, 12, 14, 16, 18, 20]), (1, [11, 13, 15, 17, 19])] >>> summaries = map_reduce(items, keyfunc=keyfunc, reducefunc=sum) >>> sorted(summaries.items()) [(0, 90), (1, 75)] Note that all items in the iterable are gathered into a list before the summarization step, which may require significant storage. The returned object is a :obj:`collections.defaultdict` with the ``default_factory`` set to ``None``, such that it behaves like a normal dictionary. Nc S r� r� r� r@ r� r� r� r� � rA z map_reduce.<locals>.<lambda>)r r� r� r� �default_factory) r� r� r� r� r� r� rD rG � value_listr� r� r� rw � s 3rw c sV |du r!zt | �� � fdd�tt| �|�D �W S ty Y nw ttt| ||���S )a� Yield the index of each item in *iterable* for which *pred* returns ``True``, starting from the right and moving left. *pred* defaults to :func:`bool`, which will select truthy items: >>> list(rlocate([0, 1, 1, 0, 1, 0, 0])) # Truthy at 1, 2, and 4 [4, 2, 1] Set *pred* to a custom function to, e.g., find the indexes for a particular item: >>> iterable = iter('abcb') >>> pred = lambda x: x == 'b' >>> list(rlocate(iterable, pred)) [3, 1] If *window_size* is given, then the *pred* function will be called with that many items. This enables searching for sub-sequences: >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] >>> pred = lambda *args: args == (1, 2, 3) >>> list(rlocate(iterable, pred=pred, window_size=3)) [9, 5, 1] Beware, this function won't return anything for infinite iterables. If *iterable* is reversible, ``rlocate`` will reverse it and search from the right. Otherwise, it will search from the left and return the results in reverse order. See :func:`locate` to for other example applications. Nc 3 s � | ] }� | d V qdS r: r� rT �r� r� r� r= " rO zrlocate.<locals>.<genexpr>)r� rq r� r� r� )r� rt r� r� r� r� r� � s ! �r� c c s� � |dk r t d��t|�}t| tg|d �}t||�}d}|D ],}||� r?|du s.||k r?|d7 }|E dH t||d � q |rL|d turL|d V q dS )aY Yield the items from *iterable*, replacing the items for which *pred* returns ``True`` with the items from the iterable *substitutes*. >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1] >>> pred = lambda x: x == 0 >>> substitutes = (2, 3) >>> list(replace(iterable, pred, substitutes)) [1, 1, 2, 3, 1, 1, 2, 3, 1, 1] If *count* is given, the number of replacements will be limited: >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1, 0] >>> pred = lambda x: x == 0 >>> substitutes = [None] >>> list(replace(iterable, pred, substitutes, count=2)) [1, 1, None, 1, 1, None, 1, 1, 0] Use *window_size* to control the number of items passed as arguments to *pred*. This allows for locating and replacing subsequences. >>> iterable = [0, 1, 2, 5, 0, 1, 2, 5] >>> window_size = 3 >>> pred = lambda *args: args == (0, 1, 2) # 3 items passed to pred >>> substitutes = [3, 4] # Splice in these items >>> list(replace(iterable, pred, substitutes, window_size=window_size)) [3, 4, 5, 3, 4, 5] r4 z window_size must be at least 1r N)r� r r r5 r� r8 ) r� rt � substitutesr r� r �windowsr� �wr� r� r� r� ) s$ � ��r� c # sN � t | �� t� �}ttd|��D ]}� fdd�td| ||f �D �V qdS )a" Yield all possible order-preserving partitions of *iterable*. >>> iterable = 'abc' >>> for part in partitions(iterable): ... print([''.join(p) for p in part]) ['abc'] ['a', 'bc'] ['ab', 'c'] ['a', 'b', 'c'] This is unrelated to :func:`partition`. r4 c s g | ] \}}� ||� �qS r� r� )r% r r ��sequencer� r� r& w r, z partitions.<locals>.<listcomp>r� N)r� r� r; r r� )r� r� r r� r r� r� f s �&�r� c # s� � t | �}t|�}|dur|dk rtd��||krdS � fdd�� |du r9td|d �D ] }� ||�E dH q,dS � ||�E dH dS )a Yield the set partitions of *iterable* into *k* parts. Set partitions are not order-preserving. >>> iterable = 'abc' >>> for part in set_partitions(iterable, 2): ... print([''.join(p) for p in part]) ['a', 'bc'] ['ab', 'c'] ['b', 'ac'] If *k* is not given, every set partition is generated. >>> iterable = 'abc' >>> for part in set_partitions(iterable): ... print([''.join(p) for p in part]) ['abc'] ['a', 'bc'] ['ab', 'c'] ['b', 'ac'] ['a', 'b', 'c'] Nr4 z6Can't partition in a negative or zero number of groupsc 3 s� � t | �}|dkr| gV d S ||kr dd� | D �V d S | ^}}� ||d �D ] }|gg|�V q(� ||�D ]"}tt |��D ]}|d |� |g|| g ||d d � V q?q7d S )Nr4 c S s g | ]}|g�qS r� r� )r% r� r� r� r� r& � s zAset_partitions.<locals>.set_partitions_helper.<locals>.<listcomp>)r� r )r; r� r� r �M�pr ��set_partitions_helperr� r� r � s � 0��z-set_partitions.<locals>.set_partitions_helper)r� r� r� r )r� r� r; r� r� r r� r� z s �� �r� c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) r� a] Yield items from *iterable* until *limit_seconds* have passed. If the time limit expires before all items have been yielded, the ``timed_out`` parameter will be set to ``True``. >>> from time import sleep >>> def generator(): ... yield 1 ... yield 2 ... sleep(0.2) ... yield 3 >>> iterable = time_limited(0.1, generator()) >>> list(iterable) [1, 2] >>> iterable.timed_out True Note that the time is checked before each item is yielded, and iteration stops if the time elapsed is greater than *limit_seconds*. If your time limit is 1 second, but it takes 2 seconds to generate the first item from the iterable, the function will run for 2 seconds and not yield anything. As a special case, when *limit_seconds* is zero, the iterator never returns anything. c C s2 |dk rt d��|| _t|�| _t� | _d| _d S )Nr z limit_seconds must be positiveF)r� � limit_secondsr� r� r3 � _start_time� timed_out)r� r r� r� r� r� r� � s ztime_limited.__init__c C r� r� r� r� r� r� r� r� � r� ztime_limited.__iter__c C s> | j dkr d| _t�t| j�}t� | j | j kr d| _t�|S )Nr T)r r r� r� r� r3 r r� r� r� r� r� � s ztime_limited.__next__N�r� r� r� r� r� r� r� r� r� r� r� r� � s r� c C sL t | �}t||�}zt|�}W n ty Y |S w d�||�}|p%t|��)a* If *iterable* has only one item, return it. If it has zero items, return *default*. If it has more than one item, raise the exception given by *too_long*, which is ``ValueError`` by default. >>> only([], default='missing') 'missing' >>> only([1]) 1 >>> only([1, 2]) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: Expected exactly one item in iterable, but got 1, 2, and perhaps more.' >>> only([1, 2], too_long=TypeError) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... TypeError Note that :func:`only` attempts to advance *iterable* twice to ensure there is only one item. See :func:`spy` or :func:`peekable` to check iterable contents less destructively. r )r� r� r� r r� )r� r� r r r r r r� r� r� r� � s �� r� c s8 t � � t| |��� �fdd�}d� �fdd� }|� |fS )Nc 3 s> � � r � � � V nzt��} W n ty Y d S w | V qr� )r� r� r� )r� �r� r� r� r� � generator s � ��z_ichunk.<locals>.generatorr4 c sL | d u r � � �� t� �S | t� � }|dkr � � t�|�� t| t� ��S r� )r� r� r r� )r� �to_cacher r� r� �materialize_next s z!_ichunk.<locals>.materialize_nextr( )r r )r� r� r r r� r r� �_ichunk s r c c s4 � t | �} t| |�\}}|� sdS |V |d� q)a� Break *iterable* into sub-iterables with *n* elements each. :func:`ichunked` is like :func:`chunked`, but it yields iterables instead of lists. If the sub-iterables are read in order, the elements of *iterable* won't be stored in memory. If they are read out of order, :func:`itertools.tee` is used to cache elements as necessary. >>> from itertools import count >>> all_chunks = ichunked(count(), 4) >>> c_1, c_2, c_3 = next(all_chunks), next(all_chunks), next(all_chunks) >>> list(c_2) # c_1's elements have been cached; c_3's haven't been [4, 5, 6, 7] >>> list(c_1) [0, 1, 2, 3] >>> list(c_3) [8, 9, 10, 11] TN)r� r )r� r� r� r r� r� r� rc / s ��rc c G s t ttt| dt� i���S )a Return ``True`` if all given *iterables* are equal to each other, which means that they contain the same elements in the same order. The function is useful for comparing iterables of different data types or iterables that do not support equality checks. >>> iequals("abc", ['a', 'b', 'c'], ('a', 'b', 'c'), iter("abc")) True >>> iequals("abc", "acb") False Not to be confused with :func:`all_equal`, which checks whether all elements of iterable are equal to each other. r6 )�allr� r> r �objectrM r� r� r� rd S s rd c c s� � |dk r t d��|dkrdV dS t| �}tt|�td�d�g}dg| }d}|rtz t|d �\}}W n tyE |�� |d8 }Y q(w |||< |d |krVt|�V n|�tt||d d� |d �td�d�� |d7 }|s*dS dS )aB Yield the distinct combinations of *r* items taken from *iterable*. >>> list(distinct_combinations([0, 0, 1], 2)) [(0, 0), (0, 1)] Equivalent to ``set(combinations(iterable))``, except duplicates are not generated and thrown away. For larger input sequences this is much more efficient. r zr must be non-negativer� Nr4 r� r� ) r� r r= rX r* r� r� �popr� )r� r r3 � generators� current_comborj �cur_idxr r� r� r� rU g s: � � �� �rU c g s6 � |D ]}z| |� W n |y Y qw |V qdS )a Yield the items from *iterable* for which the *validator* function does not raise one of the specified *exceptions*. *validator* is called for each item in *iterable*. It should be a function that accepts one argument and raises an exception if that item is not valid. >>> iterable = ['1', '2', 'three', '4', None] >>> list(filter_except(int, iterable, ValueError, TypeError)) ['1', '2', '4'] If an exception other than one given by *exceptions* is raised by *validator*, it is raised like normal. Nr� )rE r� � exceptionsr� r� r� r� r^ � s � ��r^ c g s0 � |D ]}z| |�V W q |y Y qw dS )a� Transform each item from *iterable* with *function* and yield the result, unless *function* raises one of the specified *exceptions*. *function* is called to transform each item in *iterable*. It should accept one argument. >>> iterable = ['1', '2', 'three', '4', None] >>> list(map_except(int, iterable, ValueError, TypeError)) [1, 2, 4] If an exception other than one given by *exceptions* is raised by *function*, it is raised like normal. Nr� )�functionr� r r� r� r� r� ru � s � ��ru c C r� r� r� r@ r� r� r� r� � rA c c s* � | D ]}||�r ||�n||�V qdS )a� Evaluate each item from *iterable* using *pred*. If the result is equivalent to ``True``, transform the item with *func* and yield it. Otherwise, transform the item with *func_else* and yield it. *pred*, *func*, and *func_else* should each be functions that accept one argument. By default, *func_else* is the identity function. >>> from math import sqrt >>> iterable = list(range(-5, 5)) >>> iterable [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4] >>> list(map_if(iterable, lambda x: x > 3, lambda x: 'toobig')) [-5, -4, -3, -2, -1, 0, 1, 2, 3, 'toobig'] >>> list(map_if(iterable, lambda x: x >= 0, ... lambda x: f'{sqrt(x):.2f}', lambda x: None)) [None, None, None, None, None, '0.00', '1.00', '1.41', '1.73', '2.00'] Nr� )r� rt r� � func_elser� r� r� r� rv � s � �rv c C s� t || �}ttt� �| �}|ttt� �td| � � }t| |�D ]*\}}||krL||t|�< |ttt� �| �9 }|ttt� �td| � �d 7 }q"|S r} )r< r r" r' r rX r( )r� r� � reservoir�W� next_indexr� r) r� r� r� �_sample_unweighted� s "�r c s� dd� |D �}t |t|| ��� t� � � d \}}tt� �| }t|| �D ]8\}}||krY� d \}}t|| �} t| d�} t| �| } t� | |f� � d \}}tt� �| }q%||8 }q%� fdd�t|�D �S )Nc s s � | ] }t t� �| V qd S r� )r" r' )r% �weightr� r� r� r= � r� z#_sample_weighted.<locals>.<genexpr>r r4 c s g | ]}t � �d �qS r( )r )r% r9 �r r� r� r& rU z$_sample_weighted.<locals>.<listcomp>) r< r� r r" r' r r) r r ) r� r� �weights� weight_keys�smallest_weight_keyr9 �weights_to_skipr r) �t_w�r_2� weight_keyr� r r� �_sample_weighted� s r( c C s: |dkrg S t | �} |du rt| |�S t |�}t| ||�S )af Return a *k*-length list of elements chosen (without replacement) from the *iterable*. Like :func:`random.sample`, but works on iterables of unknown length. >>> iterable = range(100) >>> sample(iterable, 5) # doctest: +SKIP [81, 60, 96, 16, 4] An iterable with *weights* may also be given: >>> iterable = range(100) >>> weights = (i * i + 1 for i in range(100)) >>> sampled = sample(iterable, 5, weights=weights) # doctest: +SKIP [79, 67, 74, 66, 78] The algorithm can also be used to generate weighted random permutations. The relative weight of each item determines the probability that it appears late in the permutation. >>> data = "abcdefgh" >>> weights = range(1, len(data) + 1) >>> sample(data, k=len(data), weights=weights) # doctest: +SKIP ['c', 'a', 'b', 'e', 'g', 'd', 'h', 'f'] r N)r� r r( )r� r� r! r� r� r� r� s r� c C sF |r|rt ntn|r tnt}|du r| nt|| �}tt|t|��� S )a� Returns ``True`` if the items of iterable are in sorted order, and ``False`` otherwise. *key* and *reverse* have the same meaning that they do in the built-in :func:`sorted` function. >>> is_sorted(['1', '2', '3', '4', '5'], key=int) True >>> is_sorted([5, 4, 3, 1, 2], reverse=True) False If *strict*, tests for strict sorting, that is, returns ``False`` if equal elements are found: >>> is_sorted([1, 2, 2]) True >>> is_sorted([1, 2, 2], strict=True) False The function returns ``False`` after encountering the first out-of-order item. If there are no out-of-order items, the iterable is exhausted. N)r0 r/ r. r- r� r� r r: )r� rD r> r� �comparer r� r� r� rk 2 s rk c @ s e Zd ZdS )r@ N)r� r� r� r� r� r� r� r@ M s r@ c @ sZ e Zd ZdZddd�Zdd� Zdd � Zd d � Zd d � Ze dd� �Z e dd� �Z dd� Z dS )rG a� Convert a function that uses callbacks to an iterator. Let *func* be a function that takes a `callback` keyword argument. For example: >>> def func(callback=None): ... for i, c in [(1, 'a'), (2, 'b'), (3, 'c')]: ... if callback: ... callback(i, c) ... return 4 Use ``with callback_iter(func)`` to get an iterator over the parameters that are delivered to the callback. >>> with callback_iter(func) as it: ... for args, kwargs in it: ... print(args) (1, 'a') (2, 'b') (3, 'c') The function will be called in a background thread. The ``done`` property indicates whether it has completed execution. >>> it.done True If it completes successfully, its return value will be available in the ``result`` property. >>> it.result 4 Notes: * If the function uses some keyword argument besides ``callback``, supply *callback_kwd*. * If it finished executing, but raised an exception, accessing the ``result`` property will raise the same exception. * If it hasn't finished executing, accessing the ``result`` property from within the ``with`` block will raise ``RuntimeError``. * If it hasn't finished executing, accessing the ``result`` property from outside the ``with`` block will raise a ``more_itertools.AbortThread`` exception. * Provide *wait_seconds* to adjust how frequently the it is polled for output. �callback皙�����?c C s@ || _ || _d| _d | _|| _td�jjdd�| _| � � | _ d S )NFzconcurrent.futuresr4 )� max_workers) �_func� _callback_kwd�_aborted�_future� _wait_seconds� __import__�futures�ThreadPoolExecutor� _executor�_reader� _iterator)r� r� � callback_kwd� wait_secondsr� r� r� r� � s ��zcallback_iter.__init__c C r� r� r� r� r� r� r� � __enter__� r� zcallback_iter.__enter__c C s d| _ | j�� d S r? )r/ r5 �shutdown)r� �exc_type� exc_value� tracebackr� r� r� �__exit__� s zcallback_iter.__exit__c C r� r� r� r� r� r� r� r� � r� zcallback_iter.__iter__c C r� r� )r� r7 r� r� r� r� r� � r� zcallback_iter.__next__c C s | j d u rdS | j �� S r� )r0 �doner� r� r� r� r@ � s zcallback_iter.donec C s | j std��| j�� S )Nz Function has not yet completed)r@ � RuntimeErrorr0 r� r� r� r� r� r� � s zcallback_iter.resultc # s� � t � � � �fdd�}�jj�jfi �j|i���_ z � j�jd�}W n ty- Y nw � � � |V �j� � r;nqg } z� � � }W n tyN Y n w � � � |� |� q?� � � |E d H d S )Nc s �j rtd��� �| |f� d S )Nzcanceled by user)r/ r@ �put)r� r� �r� r� r� r� r* � s z'callback_iter._reader.<locals>.callbackT)�timeout)r& r5 �submitr- r. r0 �getr1 r% � task_doner@ � get_nowaitr� �join)r� r* r� � remainingr� rC r� r6 � s> ��� � � � �zcallback_iter._readerN)r* r+ ) r� r� r� r� r� r: r? r� r� �propertyr@ r� r6 r� r� r� r� rG Q s 2 rG c c s� � |dk r t d��t| �}t|�}||krt d��t|| d �D ] }|d|� }|||| � }||| d� }|||fV q!dS )a� Yield ``(beginning, middle, end)`` tuples, where: * Each ``middle`` has *n* items from *iterable* * Each ``beginning`` has the items before the ones in ``middle`` * Each ``end`` has the items after the ones in ``middle`` >>> iterable = range(7) >>> n = 3 >>> for beginning, middle, end in windowed_complete(iterable, n): ... print(beginning, middle, end) () (0, 1, 2) (3, 4, 5, 6) (0,) (1, 2, 3) (4, 5, 6) (0, 1) (2, 3, 4) (5, 6) (0, 1, 2) (3, 4, 5) (6,) (0, 1, 2, 3) (4, 5, 6) () Note that *n* must be at least 0 and most equal to the length of *iterable*. This function will exhaust the iterable and may require significant storage. r r4 zn must be <= len(seq)r4 N)r� r r� r )r� r� r5 r r � beginning�middle�endr� r� r� r� � s � �r� c C sx t � }|j}g }|j}|rt|| �n| D ]%}z||v r W dS ||� W q ty9 ||v r3Y dS ||� Y qw dS )a Returns ``True`` if all the elements of *iterable* are unique (no two elements are equal). >>> all_unique('ABCB') False If a *key* function is specified, it will be used to make comparisons. >>> all_unique('ABCb') True >>> all_unique('ABCb', str.lower) False The function returns as soon as the first non-unique element is encountered. Iterables with a mix of hashable and unhashable items can be used, but the function will be slower for unhashable items. FT)r1 �addr� r� r� )r� rD �seenset� seenset_add�seenlist� seenlist_addr) r� r� r� rC � s �rC c G s� t ttt|���}t tt|��}tt|�}| dk r | |7 } d| kr(|k s+t� t�g }t||�D ]\}}|� || | � | | } q2tt|��S )a� Equivalent to ``list(product(*args))[index]``. The products of *args* can be ordered lexicographically. :func:`nth_product` computes the product at sort position *index* without computing the previous products. >>> nth_product(8, range(2), range(2), range(2), range(2)) (1, 0, 0, 0) ``IndexError`` will be raised if the given *index* is invalid. r ) r� r� r r� r� r r+ r� r� r� )r� r� �pools�nsr� r� r3 r� r� r� r� r| s � r| c C s t | �}t|�}|du s||kr|t|�}}nd| kr#|k s&t� t�t||�}|dks1J �|dk r9||7 }d| krD|k sGt� t�dg| }||k rX|t|� | n|}td|d �D ]#}t||�\}} d|| krv|k r~n n| ||| < |dkr� nqatt |j |��S )a' Equivalent to ``list(permutations(iterable, r))[index]``` The subsequences of *iterable* that are of length *r* where order is important can be ordered lexicographically. :func:`nth_permutation` computes the subsequence at sort position *index* directly, without computing the previous subsequences. >>> nth_permutation('ghijk', 2, 5) ('h', 'i') ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. Nr r4 ) r� r� r r� r# r� r r� r r� r ) r� r r� r3 r� r� r� r� �dr r� r� r� r{ : s4 � � �r{ c C s� t | �}t|�}|dk s||krt�t|| d |�}|dk r#||7 }|dk s+||kr-t�g }d}|rb|d8 }|dkrYt|| d |�}||k rIn|d8 }|d7 }||8 }|dks;|�|| � |s3t |�S )ag Equivalent to ``list(combinations_with_replacement(iterable, r))[index]``. The subsequences with repetition of *iterable* that are of length *r* can be ordered lexicographically. :func:`nth_combination_with_replacement` computes the subsequence at sort position *index* directly, without computing the previous subsequences with replacement. >>> nth_combination_with_replacement(range(5), 3, 5) (0, 1, 1) ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. r r4 )r r� r� r r� r� ) r� r r� r3 r� r� r� r � num_combsr� r� r� r} f s0 �� r} c g sL � | D ] }t |ttf�r|V qz|E dH W q ty# |V Y qw dS )a� Yield all arguments passed to the function in the same order in which they were passed. If an argument itself is iterable then iterate over its values. >>> list(value_chain(1, 2, 3, [4, 5, 6])) [1, 2, 3, 4, 5, 6] Binary and text strings are not considered iterable and are emitted as-is: >>> list(value_chain('12', '34', ['56', '78'])) ['12', '34', '56', '78'] Pre- or postpend a single element to an iterable: >>> list(value_chain(1, [2, 3, 4, 5, 6])) [1, 2, 3, 4, 5, 6] >>> list(value_chain([1, 2, 3, 4, 5], 6)) [1, 2, 3, 4, 5, 6] Multiple levels of nesting are not flattened. N)r� rd re r� )r� rG r� r� r� r� � s � ��r� c G sV d}t | |td�D ] \}}|tu s|tu rtd��t|�}|t|� |�|� }q |S )a� Equivalent to ``list(product(*args)).index(element)`` The products of *args* can be ordered lexicographically. :func:`product_index` computes the first index of *element* without computing the previous products. >>> product_index([8, 2], range(10), range(5)) 42 ``ValueError`` will be raised if the given *element* isn't in the product of *args*. r r� z element is not a product of args)r r5 r� r r� r� )r) r� r� r� r3 r� r� r� r� � s r� c C s� t | �} t| d�\}}|du rdS g }t |�}|D ] \}}||kr5|�|� t| d�\}}|du r3 n|}qtd��t||dfd�\}} d} t t|�dd�D ]\} } || } | | kra| t| | �7 } qNt|d |d �| S )a� Equivalent to ``list(combinations(iterable, r)).index(element)`` The subsequences of *iterable* that are of length *r* can be ordered lexicographically. :func:`combination_index` computes the index of the first *element*, without computing the previous combinations. >>> combination_index('adf', 'abcdefg') 10 ``ValueError`` will be raised if the given *element* isn't one of the combinations of *iterable*. �NNNr z(element is not a combination of iterabler� r4 )r� )rX r� r� r� rp r� r ) r) r� r� r� �indexesr3 r� r� �tmpr9 r� r r r� r� r� rL � s. ��rL c C s$ t | �} t| �}t| �} t| d�\}}|du rdS g }t |�}t|�D ]%\}}||krB|�|� t| d�\} }| du r<n| }||ks+|du rH nq#td��t|�}dg| } |D ] } | | d7 < qXd} d} td|�D ]#}| | |d 7 } || d | | }|| }||kr�| t||�7 } ql| S )a0 Equivalent to ``list(combinations_with_replacement(iterable, r)).index(element)`` The subsequences with repetition of *iterable* that are of length *r* can be ordered lexicographically. :func:`combination_with_replacement_index` computes the index of the first *element*, without computing the previous combinations with replacement. >>> combination_with_replacement_index('adf', 'abcdefg') 20 ``ValueError`` will be raised if the given *element* isn't one of the combinations with replacement of *iterable*. rX Nr z9element is not a combination with replacement of iterabler4 )r r� rX r� r� r� r r )r) r� �lr� r� rY r3 r� r� rZ � occupationsr r� �cumulative_sumr r r� r� r� rM � sH ��� �rM c C sL d}t |�}ttt|�dd�| �D ]\}}|�|�}|| | }||= q|S )a� Equivalent to ``list(permutations(iterable, r)).index(element)``` The subsequences of *iterable* that are of length *r* where order is important can be ordered lexicographically. :func:`permutation_index` computes the index of the first *element* directly, without computing the previous permutations. >>> permutation_index([1, 3, 2], range(5)) 19 ``ValueError`` will be raised if the given *element* isn't one of the permutations of *iterable*. r r� )r� r� r r� r� )r) r� r� r3 r r� r r� r� r� r� 3 s r� c @ r ) rR a� Wrap *iterable* and keep a count of how many items have been consumed. The ``items_seen`` attribute starts at ``0`` and increments as the iterable is consumed: >>> iterable = map(str, range(10)) >>> it = countable(iterable) >>> it.items_seen 0 >>> next(it), next(it) ('0', '1') >>> list(it) ['2', '3', '4', '5', '6', '7', '8', '9'] >>> it.items_seen 10 c C s t |�| _d| _d S r� )r� r� � items_seenr� r� r� r� r� ] s zcountable.__init__c C r� r� r� r� r� r� r� r� a r� zcountable.__iter__c C s t | j�}| jd7 _|S r} )r� r� r^ r� r� r� r� r� d s zcountable.__next__Nr r� r� r� r� rR K s rR c c s, � t | �} |d |d }tt| |��}tt|j| �|d|�D ]}|d|� V |d|�= q |s2dS t|�}t||�\}}||dkrDdnd }t||�\}}||dkrUdnd } | d } || | } | | } | dkr|td| | �D ] } || | | � V qp| dkr�t| || �D ] } || | | � V q�dS dS )a� Break *iterable* into lists of approximately length *n*. Items are distributed such the lengths of the lists differ by at most 1 item. >>> iterable = [1, 2, 3, 4, 5, 6, 7] >>> n = 3 >>> list(chunked_even(iterable, n)) # List lengths: 3, 2, 2 [[1, 2, 3], [4, 5], [6, 7]] >>> list(chunked(iterable, n)) # List lengths: 3, 3, 1 [[1, 2, 3], [4, 5, 6], [7]] r4 r Nr )r� r� r r� r� r� r� r )r� r� � min_buffer�bufferr9 �lengthr� r � num_lists� full_size� partial_size�num_full�partial_start_idxr r� r� r� rI k s2 � �rI )� scalar_typesr� c ' s� � � fdd�}t |�}|sdS dg| }g g }}t|�D ]\}} || �r*| ||< q |�t| �� |�|� q |s@t|�V dS |rDtnt} | |� D ]} t|| �D ]\}||< qQt|�V qJdS )a A version of :func:`zip` that "broadcasts" any scalar (i.e., non-iterable) items into output tuples. >>> iterable_1 = [1, 2, 3] >>> iterable_2 = ['a', 'b', 'c'] >>> scalar = '_' >>> list(zip_broadcast(iterable_1, iterable_2, scalar)) [(1, 'a', '_'), (2, 'b', '_'), (3, 'c', '_')] The *scalar_types* keyword argument determines what types are considered scalar. It is set to ``(str, bytes)`` by default. Set it to ``None`` to treat strings and byte strings as iterable: >>> list(zip_broadcast('abc', 0, 'xyz', scalar_types=None)) [('a', 0, 'x'), ('b', 0, 'y'), ('c', 0, 'z')] If the *strict* keyword argument is ``True``, then ``UnequalIterablesError`` will be raised if any of the iterables have different lengths. c s6 � r t | � �r dS zt| � W dS ty Y dS w )NTF)r� r� r� r� �rg r� r� � is_scalar� s ��z zip_broadcast.<locals>.is_scalarN)r� rX r� r� r r6 r� ) rg r� �objectsri r �new_itemr2 �iterable_positionsr r� �zipperr� r� rh r� r� � s* � �r� c c s� � |dkr t d��t|d�}tt�}|du}| D ]:}t|�|kr6|d }|| dkr.||= n|| d8 < |r<||�n|}||vrE|V || d7 < |�|� qdS )a� Yield the items from *iterable* that haven't been seen recently. *n* is the size of the lookback window. >>> iterable = [0, 1, 0, 2, 3, 0] >>> n = 3 >>> list(unique_in_window(iterable, n)) [0, 1, 2, 3, 0] The *key* function, if provided, will be used to determine uniqueness: >>> list(unique_in_window('abAcda', 3, key=lambda x: x.lower())) ['a', 'b', 'c', 'd', 'a'] The items in *iterable* must be hashable. r zn must be greater than 0r� Nr4 )r� r r r� r� r� ) r� r� rD r7 r* �use_keyr� � to_discardr� r� r� r� r� � s$ � �r� c c s| � t � }g }|du}| D ]/}|r||�n|}z||vr!|�|� n|V W q ty; ||vr6|�|� n|V Y q w dS )a{ Yield duplicate elements after their first appearance. >>> list(duplicates_everseen('mississippi')) ['s', 'i', 's', 's', 'i', 'p', 'i'] >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a'] This function is analogous to :func:`unique_everseen` and is subject to the same performance considerations. N)r1 rO r� r� )r� rD �seen_set� seen_listrn r) r� r� r� r� rZ � s$ � � ���rZ c C s t dd� t| |�D ��S )a2 Yields serially-duplicate elements after their first appearance. >>> list(duplicates_justseen('mississippi')) ['s', 's', 'p'] >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a'] This function is analogous to :func:`unique_justseen`. c s s" � | ] \}}|D ]}|V qqd S r� r� )r% r9 r� r� r� r� r= % r� z&duplicates_justseen.<locals>.<genexpr>)r9 r )r� rD r� r� r� r[ s r[ c c s� � t � }g }|du}d}t| �D ]?\}}|r||�n|}| p"||k} |}d} z ||vr3|�|� d} W n tyH ||vrF|�|� d} Y nw || | fV qdS )a� Classify each element in terms of its uniqueness. For each element in the input iterable, return a 3-tuple consisting of: 1. The element itself 2. ``False`` if the element is equal to the one preceding it in the input, ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`) 3. ``False`` if this element has been seen anywhere in the input before, ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`) >>> list(classify_unique('otto')) # doctest: +NORMALIZE_WHITESPACE [('o', True, True), ('t', True, True), ('t', False, False), ('o', True, False)] This function is analogous to :func:`unique_everseen` and is subject to the same performance considerations. NFT)r1 rX rO r� r� ) r� rD rp rq rn �previousr r) r� �is_unique_justseen�is_unique_everseenr� r� r� r\ ( s. � � ���r\ )rD r� c G s8 |r| g|�R n| }t |�}zt|� }}W n ty3 } z|tu r'td�|�|W Y d}~S d}~ww |du r]t|||d�D ]\} } | | k rL| | } } | |k rR| }|| k rX| }q?||fS ||� } } t|||d�D ]-\} } || �|| �} }|| k r�| | || f\} } } }| | k r�| | }} | |k r�| |}} qj||fS )a� Returns both the smallest and largest items in an iterable or the largest of two or more arguments. >>> minmax([3, 1, 5]) (1, 5) >>> minmax(4, 2, 6) (2, 6) If a *key* function is provided, it will be used to transform the input items for comparison. >>> minmax([5, 30], key=str) # '30' sorts before '5' (30, 5) If a *default* value is provided, it will be returned if there are no input items. >>> minmax([], default=(0, 0)) (0, 0) Otherwise ``ValueError`` is raised. This function is based on the `recipe <http://code.activestate.com/recipes/577916/>`__ by Raymond Hettinger and takes care to minimize the number of comparisons performed. z[`minmax()` argument is an empty iterable. Provide a `default` value to suppress this error.Nr� )r� r� r� r5 r� r )�iterable_or_valuerD r� �othersr� r �lo�hir r� r� �lo_key�hi_key�x_key�y_keyr� r� r� ry R sF ���� � � �ry Tc c s� � |dkr t d��g }d}d}| D ]:}||�} |r!| |kr!t d��||k} | | |k} |r>| s1| r>t|�V |�� d}d}|�|� || 7 }|d7 }q|rUt|�V dS dS )aB Yield batches of items from *iterable* with a combined size limited by *max_size*. >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] >>> list(constrained_batches(iterable, 10)) [(b'12345', b'123'), (b'12345678', b'1', b'1'), (b'12', b'1')] If a *max_count* is supplied, the number of items per batch is also limited: >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] >>> list(constrained_batches(iterable, 10, max_count = 2)) [(b'12345', b'123'), (b'12345678', b'1'), (b'1', b'12'), (b'1',)] If a *get_len* function is supplied, use that instead of :func:`len` to determine item size. If *strict* is ``True``, raise ``ValueError`` if any single item is bigger than *max_size*. Otherwise, allow single items to exceed *max_size*. r z&maximum size must be greater than zeroz item size exceeds maximum sizer4 N)r� r r� r� ) r� �max_size� max_count�get_lenr� �batch� batch_size� batch_countr� �item_len� reached_count� reached_sizer� r� r� rO � s. � �rO c ' s � t dd� | D ���t��}�D ] }t|�dk r td��qdg| � tt|d ��}dg| } t � �fdd�t|�D ��V |d }d|d< ||krMd S � | || � |< � | dksi� | t�| �d kr�|| ||< ||d ||< |d ||d < q0) af Like :func:`itertools.product`, but return tuples in an order such that only one element in the generated tuple changes from one iteration to the next. >>> list(gray_product('AB','CD')) [('A', 'C'), ('B', 'C'), ('B', 'D'), ('A', 'D')] This function consumes all of the input iterables before producing output. If any of the input iterables have fewer than two items, ``ValueError`` is raised. For information on the algorithm, see `this section <https://www-cs-faculty.stanford.edu/~knuth/fasc2a.ps.gz>`__ of Donald Knuth's *The Art of Computer Programming*. c s s � | ]}t |�V qd S r� )r rN r� r� r� r= � r� z gray_product.<locals>.<genexpr>r z)each iterable must have two or more itemsr r4 Tc 3 s � | ] }�| � | V qd S r� r� rT �r� � all_iterablesr� r� r= � rq N)r r� r� r� r )r2 �iterable_countr� r� �or r� r� r� ra � s, � � $�ra c g sp � t tt| ��}z dd� |D �}W n ty Y dS w t|�V t|�D ]\}}|D ] ||< t|�V q+q%dS )a� Yields tuples containing one item from each iterator, with subsequent tuples changing a single item at a time by advancing each iterator until it is exhausted. This sequence guarantees every value in each iterable is output at least once without generating all possible combinations. This may be useful, for example, when testing an expensive function. >>> list(partial_product('AB', 'C', 'DEF')) [('A', 'C', 'D'), ('B', 'C', 'D'), ('B', 'C', 'E'), ('B', 'C', 'F')] c S r# r� r� r$ r� r� r� r& r' z#partial_product.<locals>.<listcomp>N)r� r� r� r� r rX )r2 � iterators�prodr r r� r� r� r� � s � � ��r� c c s$ � |D ] }|V | |�s dS qdS )z�A variant of :func:`takewhile` that yields one additional element. >>> list(takewhile_inclusive(lambda x: x < 5, [1, 4, 6, 4, 1])) [1, 4, 6] :func:`takewhile` would return ``[1, 4]``. Nr� )r� r� r� r� r� r� r� s ���r� c s0 t |�}tt� ��fdd�t||��t|�d�S )a� A generalized outer product that applies a binary function to all pairs of items. Returns a 2D matrix with ``len(xs)`` rows and ``len(ys)`` columns. Also accepts ``*args`` and ``**kwargs`` that are passed to ``func``. Multiplication table: >>> list(outer_product(mul, range(1, 4), range(1, 6))) [(1, 2, 3, 4, 5), (2, 4, 6, 8, 10), (3, 6, 9, 12, 15)] Cross tabulation: >>> xs = ['A', 'B', 'A', 'A', 'B', 'B', 'A', 'A', 'B', 'B'] >>> ys = ['X', 'X', 'X', 'Y', 'Z', 'Z', 'Y', 'Y', 'Z', 'Z'] >>> rows = list(zip(xs, ys)) >>> count_rows = lambda x, y: rows.count((x, y)) >>> list(outer_product(count_rows, sorted(set(xs)), sorted(set(ys)))) [(2, 3, 0), (1, 0, 4)] Usage with ``*args`` and ``**kwargs``: >>> animals = ['cat', 'wolf', 'mouse'] >>> list(outer_product(min, animals, animals, key=len)) [('cat', 'cat', 'cat'), ('cat', 'wolf', 'wolf'), ('cat', 'wolf', 'mouse')] c s �| |g� �R i ���S r� r� r� �r� r� r� r� r� r� 8 rU z outer_product.<locals>.<lambda>r� )r r? r r r� )r� �xs�ysr� r� r� r� r� r� s �r� c g s( � z| E dH W dS |y Y dS w )a. Yield each of the items from *iterable*. If the iteration raises one of the specified *exceptions*, that exception will be suppressed and iteration will stop. >>> from itertools import chain >>> def breaks_at_five(x): ... while True: ... if x >= 5: ... raise RuntimeError ... yield x ... x += 1 >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError) >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError) >>> list(chain(it_1, it_2)) [1, 2, 3, 4, 2, 3, 4] Nr� )r� r r� r� r� rn = s � �rn c c s& � |D ] }| |�}|dur|V qdS )z�Apply *func* to every element of *iterable*, yielding only those which are not ``None``. >>> elems = ['1', 'a', '2', 'b', '3'] >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems)) [1, 2, 3] Nr� )r� r� r� r� r� r� r� r_ T s ���r_ c c sT � t ttt�ttt| �����}tt|�d �D ]}t t� j t ||��E dH qdS )ax Yields all possible subsets of the iterable. >>> list(powerset_of_sets([1, 2, 3])) # doctest: +SKIP [set(), {1}, {2}, {3}, {1, 2}, {1, 3}, {2, 3}, {1, 2, 3}] >>> list(powerset_of_sets([1, 1, 0])) # doctest: +SKIP [set(), {1}, {0}, {0, 1}] :func:`powerset_of_sets` takes care to minimize the number of hash operations performed. r4 N) r r� r1 �dict�fromkeys� frozensetr� r r� r �unionr )r� �setsr r� r� r� r� b s � �r� c K s@ t t�}| �� D ]\}}|�� D ] \}}||| |< qqt|�S )a2 Joins multiple mappings together using their common keys. >>> user_scores = {'elliot': 50, 'claris': 60} >>> user_times = {'elliot': 30, 'claris': 40} >>> join_mappings(score=user_scores, time=user_times) {'elliot': {'score': 50, 'time': 30}, 'claris': {'score': 60, 'time': 40}} )r r� r� )� field_to_mapr� � field_name�mappingrD rG r� r� r� ro r s �ro c C s� t dd� | D �dd� | D ��}t dd� |D �dd� |D ��}t dd� | D �dd� | D ��}t dd� |D �d d� |D ��}tt||�t||��S ) z\High precision sumprod() for complex numbers. Used by :func:`dft` and :func:`idft`. c s � � | ]}|j V qd S r� ��real�r% r r� r� r� r= � � � z#_complex_sumprod.<locals>.<genexpr>c s s � | ]}|j V qd S r� ��imagr� r� r� r� r= � r� c s r� r� r� �r% r� r� r� r� r= � r� c s r� r� r� r� r� r� r� r= � r� c s r� r� r� r� r� r� r� r= � r� c s r� r� r� r� r� r� r� r= � r� c s r� r� r� r� r� r� r� r= � r� c s r� r� r� r� r� r� r� r= � r� )r �complex� _fsumprod)�v1�v2�r1�r2r� r� r� r� r� �_complex_sumprod� s r� c # sX � t | �� � fdd�t� �D ��t� �D ]�� ��fdd�t� �D �}t| |�V qdS )an Discrete Fourier Tranform. *xarr* is a sequence of complex numbers. Yields the components of the corresponding transformed output vector. >>> import cmath >>> xarr = [1, 2-1j, -1j, -1+2j] >>> Xarr = [2, -2-2j, -2j, 4+4j] >>> all(map(cmath.isclose, dft(xarr), Xarr)) True See :func:`idft` for the inverse Discrete Fourier Transform. c � g | ] }t |� t d �qS )y � �r r$ r� ��Nr� r� r& � � zdft.<locals>.<listcomp>c � g | ] }��| � �qS r� r� r� �r� r� �roots_of_unityr� r� r& � r, N�r� r r� )�xarr�coeffsr� r� r� rS � s � �rS c # s\ � t | �� � fdd�t� �D ��t� �D ]�� ��fdd�t� �D �}t| |�� V qdS )az Inverse Discrete Fourier Tranform. *Xarr* is a sequence of complex numbers. Yields the components of the corresponding inverse-transformed output vector. >>> import cmath >>> xarr = [1, 2-1j, -1j, -1+2j] >>> Xarr = [2, -2-2j, -2j, 4+4j] >>> all(map(cmath.isclose, idft(Xarr), xarr)) True See :func:`dft` for the Discrete Fourier Transform. c r� )y �?r� r� r� r� r� r& � r� zidft.<locals>.<listcomp>c r� r� r� r� r� r� r� r& � r, Nr� )�Xarrr� r� r� r� re � s � �re c c s � |D ] }| di |��V qdS )a Apply *func* to every item of *iterable* by dictionary unpacking the item into *func*. The difference between :func:`itertools.starmap` and :func:`doublestarmap` parallels the distinction between ``func(*a)`` and ``func(**a)``. >>> iterable = [{'a': 1, 'b': 2}, {'a': 40, 'b': 60}] >>> list(doublestarmap(lambda a, b: a + b, iterable)) [3, 100] ``TypeError`` will be raised if *func*'s signature doesn't match the mapping contained in *iterable* or if *iterable* does not contain mappings. Nr� r� )r� r� r� r� r� r� rY � s ��rY )FrX r� r( r} )NNN)r� F)r� )NNF)r )r� FN)r� NF)NFF)��mathr� � collectionsr r r r �collections.abcr � functoolsr r r r �heapqr r r � itertoolsr r r r r r r r r r r r r r r r r r r r! r" r# r$ �queuer% r& r' r( r) �operatorr* r+ r, r- r. r/ r0 �sysr1 r2 �timer3 �recipesr5 r6 r7 r8 r9 r: r; r< r= r> r? �__all__�getattrr� rH r` rp rz r� rP rf rm r� r r� r� rV rj r� r� r� r� rF r� rg ri rh rK r� r� r� r� r� r� r� r� r� r� rW r� r� r� r� r� rX rd re rD rB rb �Hashabler~ rQ rx r� rq rr rs r� r� rl r� rE rN rT rA r� r� r] rJ rt rw r� r� r� r� r� r� r rc rd rU r^ ru rv r r( r� rk � BaseExceptionr@ rG r� rC r| r{ r} r� r� rL rM r� rR rI r� r� rZ r[ r\ ry r� rO ra r� r� r� rn r_ r� ro r� rS re rY r� r� r� r� �<module> s @,$ 4r # & C M e !: " `+ B < = " , # &- - - % 'B13 5 '- Z%0 .`0*- BC += 8 2)"$( # $ (# ,."+9 2 8 ' *H �2*! _vendor/more_itertools/__pycache__/recipes.cpython-310.pyc 0000644 00000071045 15030122015 0017605 0 ustar 00 o �h�o � @ s d Z ddlZddlZddlmZ ddlmZ ddlmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZ ddlmZmZmZ ddlm Z g d �Z e � Z ze d d � W n e!yc e Z"Y nw ee d d �Z"e#ed d d� �Z$dd� Z%dzdd�Z&dd� Z'd{dd�Z(d{dd�Z)d{dd�Z*e+fdd �Z,d d � Z-e-Z.d d � Z/d!d"� Z0d#d$� Z1d{d%d&�Z2d'd(� Z3zdd)l m4Z5 W n e6y� e3Z4Y n w d*d+� Z4e3j e4_ G d,d-� d-e7�Z8d.d/� Z9d0d1� Z:d|d3d4�Z;d5d6� Z<d7d8� Z=d9d:� Z>d{d;d<�Z?d{d=d>�Z@d}d@dA�ZAd{dBdC�ZBd~dDdE�ZCdFdG�dHdI�ZDd{dJdK�ZEdLdM� ZFdNdO� ZGdPdQ� ZHdRdS� ZIdTdU� ZJdVdW� ZKdXdY� ZLdZd[� ZMd\d]� ZNd^d_� ZOdd`da�ZPdbdc� ZQd?d �ddde�ZRe dfk�r\ddgl mSZT d?d �dhdi�ZSneRZSeRj eS_ djdk� ZUdldm� ZVdndo� ZWdpdq� ZXdrds� ZYdtdu� ZZdvdw� Z[dxdy� Z\dS )�a Imported from the recipes section of the itertools documentation. All functions taken from the recipes section of the itertools library docs [1]_. Some backward-compatible usability improvements have been made. .. [1] http://docs.python.org/library/itertools.html#recipes � N)�deque)�Sized)�partial�reduce) �chain� combinations�compress�count�cycle�groupby�islice�product�repeat�starmap�tee� zip_longest)� randrange�sample�choice)� hexversion).� all_equal�batched�before_and_after�consume�convolve� dotproduct� first_true�factor�flatten�grouper� iter_except� iter_index�matmul�ncycles�nth�nth_combination�padnone�pad_none�pairwise� partition�polynomial_eval�polynomial_from_roots�polynomial_derivative�powerset�prepend�quantify�reshape�#random_combination_with_replacement�random_combination�random_permutation�random_product� repeatfunc� roundrobin�sieve�sliding_window� subslices�sum_of_squares�tabulate�tail�take�totient� transpose� triplewise�unique�unique_everseen�unique_justseenT��strict�sumprodc C s t | |�S �N)r )�x�y� rJ �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/more_itertools/recipes.py�<lambda>_ s rL c C � t t|| ��S )z�Return first *n* items of the iterable as a list. >>> take(3, range(10)) [0, 1, 2] If there are fewer than *n* items in the iterable, all of them are returned. >>> take(10, range(3)) [0, 1, 2] )�listr ��n�iterablerJ rJ rK r= b s r= c C s t | t|��S )a� Return an iterator over the results of ``func(start)``, ``func(start + 1)``, ``func(start + 2)``... *func* should be a function that accepts one integer argument. If *start* is not specified it defaults to 0. It will be incremented each time the iterator is advanced. >>> square = lambda x: x ** 2 >>> iterator = tabulate(square, -3) >>> take(4, iterator) [9, 4, 1, 0] )�mapr )�function�startrJ rJ rK r; r s r; c c sJ � t |t�rt|tdt|�| �d�E dH dS tt|| d��E dH dS )z�Return an iterator over the last *n* items of *iterable*. >>> t = tail(3, 'ABCDEFG') >>> list(t) ['E', 'F', 'G'] r N��maxlen)� isinstancer r �max�len�iterr rO rJ rJ rK r< � s � $r< c C s. |du r t | dd� dS tt| ||�d� dS )aX Advance *iterable* by *n* steps. If *n* is ``None``, consume it entirely. Efficiently exhausts an iterator without returning values. Defaults to consuming the whole iterator, but an optional second argument may be provided to limit consumption. >>> i = (x for x in range(10)) >>> next(i) 0 >>> consume(i, 3) >>> next(i) 4 >>> consume(i) >>> next(i) Traceback (most recent call last): File "<stdin>", line 1, in <module> StopIteration If the iterator has fewer items remaining than the provided limit, the whole iterator will be consumed. >>> i = (x for x in range(3)) >>> consume(i, 5) >>> next(i) Traceback (most recent call last): File "<stdin>", line 1, in <module> StopIteration Nr rU )r �nextr )�iteratorrP rJ rJ rK r � s r c C s t t| |d�|�S )z�Returns the nth item or a default value. >>> l = range(10) >>> nth(l, 3) 3 >>> nth(l, 20, "zebra") 'zebra' N)r[ r )rQ rP �defaultrJ rJ rK r$ � s r$ c C s t ttt| |�d���dkS )a� Returns ``True`` if all the elements are equal to each other. >>> all_equal('aaaa') True >>> all_equal('aaab') False A function that accepts a single argument and returns a transformed version of each input item can be specified with *key*: >>> all_equal('AaaA', key=str.casefold) True >>> all_equal([1, 2, 3], key=lambda x: x < 10) True � � )rY rN r r �rQ �keyrJ rJ rK r � s r c C rM )zcReturn the how many times the predicate is true. >>> quantify([True, False, True]) 2 )�sumrR )rQ �predrJ rJ rK r/ � s r/ c C s t | td��S )a Returns the sequence of elements and then returns ``None`` indefinitely. >>> take(5, pad_none(range(3))) [0, 1, 2, None, None] Useful for emulating the behavior of the built-in :func:`map` function. See also :func:`padded`. N)r r �rQ rJ rJ rK r' � s r' c C s t �tt| �|��S )zvReturns the sequence elements *n* times >>> list(ncycles(["a", "b"], 3)) ['a', 'b', 'a', 'b', 'a', 'b'] )r � from_iterabler �tuple)rQ rP rJ rJ rK r# � s r# c C s t ttj| |��S )zcReturns the dot product of the two iterables. >>> dotproduct([10, 10], [20, 20]) 400 )rb rR �operator�mul)�vec1�vec2rJ rJ rK r s r c C s t �| �S )z�Return an iterator flattening one level of nesting in a list of lists. >>> list(flatten([[0, 1], [2, 3]])) [0, 1, 2, 3] See also :func:`collapse`, which can flatten multiple levels of nesting. )r re )� listOfListsrJ rJ rK r s r c G s& |du r t | t|��S t | t||��S )aG Call *func* with *args* repeatedly, returning an iterable over the results. If *times* is specified, the iterable will terminate after that many repetitions: >>> from operator import add >>> times = 4 >>> args = 3, 5 >>> list(repeatfunc(add, times, *args)) [8, 8, 8, 8] If *times* is ``None`` the iterable will not terminate: >>> from random import randrange >>> times = None >>> args = 1, 11 >>> take(6, repeatfunc(randrange, times, *args)) # doctest:+SKIP [2, 4, 8, 1, 8, 4] N)r r )�func�times�argsrJ rJ rK r5 s r5 c C s t | �\}}t|d� t||�S )z�Returns an iterator of paired items, overlapping, from the original >>> take(4, pairwise(count())) [(0, 1), (1, 2), (2, 3), (3, 4)] On Python 3.10 and above, this is an alias for :func:`itertools.pairwise`. N)r r[ �zip)rQ �a�brJ rJ rK � _pairwise6 s rr �r( c C s t | �S rG )�itertools_pairwiserd rJ rJ rK r( J s r( c s e Zd Zd� fdd� Z� ZS )�UnequalIterablesErrorNc s* d}|d ur |dj |� 7 }t� �|� d S )Nz Iterables have different lengthsz/: index 0 has length {}; index {} has length {})�format�super�__init__)�self�details�msg�� __class__rJ rK rx Q s �z UnequalIterablesError.__init__rG )�__name__� __module__� __qualname__rx � __classcell__rJ rJ r| rK ru P s ru c c s8 � t | dti�D ]}|D ] }|tu rt� �q |V qd S )N� fillvalue)r �_markerru )� iterables�combo�valrJ rJ rK �_zip_equal_generator[ s ���r� c G sn z)t | d �}t| dd � d�D ]\}}t |�}||kr$t|||fd��qt| � W S ty6 t| � Y S w )Nr r_ )rz )rY � enumerateru ro � TypeErrorr� )r� � first_size�i�it�sizerJ rJ rK � _zip_equalc s � �r� �fillc C sL t | �g| }|dkrt|d|i�S |dkrt|� S |dkr"t|� S td��)a� Group elements from *iterable* into fixed-length groups of length *n*. >>> list(grouper('ABCDEF', 3)) [('A', 'B', 'C'), ('D', 'E', 'F')] The keyword arguments *incomplete* and *fillvalue* control what happens for iterables whose length is not a multiple of *n*. When *incomplete* is `'fill'`, the last group will contain instances of *fillvalue*. >>> list(grouper('ABCDEFG', 3, incomplete='fill', fillvalue='x')) [('A', 'B', 'C'), ('D', 'E', 'F'), ('G', 'x', 'x')] When *incomplete* is `'ignore'`, the last group will not be emitted. >>> list(grouper('ABCDEFG', 3, incomplete='ignore', fillvalue='x')) [('A', 'B', 'C'), ('D', 'E', 'F')] When *incomplete* is `'strict'`, a subclass of `ValueError` will be raised. >>> it = grouper('ABCDEFG', 3, incomplete='strict') >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... UnequalIterablesError r� r� rE �ignorez Expected fill, strict, or ignore)rZ r r� ro � ValueError)rQ rP � incompleter� rn rJ rJ rK r s s r c g sD � t t| �}tt| �dd�D ]}tt||��}t t|�E dH qdS )aJ Yields an item from each iterable, alternating between them. >>> list(roundrobin('ABC', 'D', 'EF')) ['A', 'D', 'E', 'B', 'F', 'C'] This function produces the same output as :func:`interleave_longest`, but may perform better for some inputs (in particular when the number of iterables is small). r ���N)rR rZ �rangerY r r r[ )r� � iterators� num_activerJ rJ rK r6 � s � �r6 c C sJ | du rt } t|d�\}}}tt| |��\}}t|ttj|��t||�fS )a� Returns a 2-tuple of iterables derived from the input iterable. The first yields the items that have ``pred(item) == False``. The second yields the items that have ``pred(item) == True``. >>> is_odd = lambda x: x % 2 != 0 >>> iterable = range(10) >>> even_items, odd_items = partition(is_odd, iterable) >>> list(even_items), list(odd_items) ([0, 2, 4, 6, 8], [1, 3, 5, 7, 9]) If *pred* is None, :func:`bool` is used. >>> iterable = [0, 1, False, True, '', ' '] >>> false_items, true_items = partition(None, iterable) >>> list(false_items), list(true_items) ([0, False, ''], [1, True, ' ']) N� )�boolr rR r rg �not_)rc rQ �t1�t2�p�p1�p2rJ rJ rK r) � s r) c s, t | �� t�� fdd�tt� �d �D ��S )a1 Yields all possible subsets of the iterable. >>> list(powerset([1, 2, 3])) [(), (1,), (2,), (3,), (1, 2), (1, 3), (2, 3), (1, 2, 3)] :func:`powerset` will operate on iterables that aren't :class:`set` instances, so repeated elements in the input will produce repeated elements in the output. >>> seq = [1, 1, 0] >>> list(powerset(seq)) [(), (1,), (1,), (0,), (1, 1), (1, 0), (1, 0), (1, 1, 0)] For a variant that efficiently yields actual :class:`set` instances, see :func:`powerset_of_sets`. c 3 s � | ]}t � |�V qd S rG )r )�.0�r��srJ rK � <genexpr>� s � zpowerset.<locals>.<genexpr>r_ )rN r re r� rY rd rJ r� rK r- � s $r- c c s� � t � }|j}g }|j}|du}| D ]+}|r||�n|}z ||vr(||� |V W q ty= ||vr;||� |V Y qw dS )a� Yield unique elements, preserving order. >>> list(unique_everseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D'] >>> list(unique_everseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'D'] Sequences with a mix of hashable and unhashable items can be used. The function will be slower (i.e., `O(n^2)`) for unhashable items. Remember that ``list`` objects are unhashable - you can use the *key* parameter to transform the list to a tuple (which is hashable) to avoid a slowdown. >>> iterable = ([1, 2], [2, 3], [1, 2]) >>> list(unique_everseen(iterable)) # Slow [[1, 2], [2, 3]] >>> list(unique_everseen(iterable, key=tuple)) # Faster [[1, 2], [2, 3]] Similarly, you may want to convert unhashable ``set`` objects with ``key=frozenset``. For ``dict`` objects, ``key=lambda x: frozenset(x.items())`` can be used. N)�set�add�appendr� ) rQ ra �seenset� seenset_add�seenlist� seenlist_add�use_key�element�krJ rJ rK rB � s( �� ���rB c C s8 |du rt t�d�t| ��S t tt t�d�t| |���S )z�Yields elements in order, ignoring serial duplicates >>> list(unique_justseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D', 'A', 'B'] >>> list(unique_justseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'A', 'D'] Nr r_ )rR rg � itemgetterr r[ r` rJ rJ rK rC s rC Fc C s t t| ||d�|d�S )a� Yields unique elements in sorted order. >>> list(unique([[1, 2], [3, 4], [1, 2]])) [[1, 2], [3, 4]] *key* and *reverse* are passed to :func:`sorted`. >>> list(unique('ABBcCAD', str.casefold)) ['A', 'B', 'c', 'D'] >>> list(unique('ABBcCAD', str.casefold, reverse=True)) ['D', 'c', 'B', 'A'] The elements in *iterable* need not be hashable, but they must be comparable for sorting to work. )ra �reverse)ra )rC �sorted)rQ ra r� rJ rJ rK rA s rA c c s4 � z|dur |� V | � V q |y Y dS w )a� Yields results from a function repeatedly until an exception is raised. Converts a call-until-exception interface to an iterator interface. Like ``iter(func, sentinel)``, but uses an exception instead of a sentinel to end the loop. >>> l = [0, 1, 2] >>> list(iter_except(l.pop, IndexError)) [2, 1, 0] Multiple exceptions can be specified as a stopping condition: >>> l = [1, 2, 3, '...', 4, 5, 6] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [7, 6, 5] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [4, 3, 2] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [] NrJ )rl � exception�firstrJ rJ rK r - s �� �r c C s t t|| �|�S )a� Returns the first true value in the iterable. If no true value is found, returns *default* If *pred* is not None, returns the first item for which ``pred(item) == True`` . >>> first_true(range(10)) 1 >>> first_true(range(10), pred=lambda x: x > 5) 6 >>> first_true(range(10), default='missing', pred=lambda x: x > 9) 'missing' )r[ �filter)rQ r] rc rJ rJ rK r L s r r_ )r c G s$ dd� |D �| }t dd� |D ��S )a� Draw an item at random from each of the input iterables. >>> random_product('abc', range(4), 'XYZ') # doctest:+SKIP ('c', 3, 'Z') If *repeat* is provided as a keyword argument, that many items will be drawn from each iterable. >>> random_product('abcd', range(4), repeat=2) # doctest:+SKIP ('a', 2, 'd', 3) This equivalent to taking a random selection from ``itertools.product(*args, **kwarg)``. c S s g | ]}t |��qS rJ �rf �r� �poolrJ rJ rK � <listcomp>p s z"random_product.<locals>.<listcomp>c s s � | ]}t |�V qd S rG )r r� rJ rJ rK r� q � � z!random_product.<locals>.<genexpr>r� )r rn �poolsrJ rJ rK r4 ` s r4 c C s* t | �}|du r t|�n|}t t||��S )ab Return a random *r* length permutation of the elements in *iterable*. If *r* is not specified or is ``None``, then *r* defaults to the length of *iterable*. >>> random_permutation(range(5)) # doctest:+SKIP (3, 4, 0, 1, 2) This equivalent to taking a random selection from ``itertools.permutations(iterable, r)``. N)rf rY r )rQ r� r� rJ rJ rK r3 t s r3 c s8 t | �� t� �}ttt|�|��}t � fdd�|D ��S )z�Return a random *r* length subsequence of the elements in *iterable*. >>> random_combination(range(5), 3) # doctest:+SKIP (2, 3, 4) This equivalent to taking a random selection from ``itertools.combinations(iterable, r)``. c 3 � � | ]}� | V qd S rG rJ �r� r� �r� rJ rK r� � r� z%random_combination.<locals>.<genexpr>)rf rY r� r r� )rQ r� rP �indicesrJ r� rK r2 � s r2 c s@ t | ��t��� t� fdd�t|�D ��}t �fdd�|D ��S )aS Return a random *r* length subsequence of elements in *iterable*, allowing individual elements to be repeated. >>> random_combination_with_replacement(range(3), 5) # doctest:+SKIP (0, 0, 1, 2, 2) This equivalent to taking a random selection from ``itertools.combinations_with_replacement(iterable, r)``. c 3 s � | ]}t � �V qd S rG )r r� )rP rJ rK r� � r� z6random_combination_with_replacement.<locals>.<genexpr>c 3 r� rG rJ r� r� rJ rK r� � r� )rf rY r� r� )rQ r� r� rJ )rP r� rK r1 � s r1 c C s� t | �}t|�}|dk s||krt�d}t||| �}td|d �D ] }||| | | }q"|dk r7||7 }|dk s?||krAt�g }|ry|| | |d |d }}}||krn||8 }||| | |d }}||ksY|�|d| � |sEt |�S )a Equivalent to ``list(combinations(iterable, r))[index]``. The subsequences of *iterable* that are of length *r* can be ordered lexicographically. :func:`nth_combination` computes the subsequence at sort position *index* directly, without computing the previous subsequences. >>> nth_combination(range(5), 3, 5) (0, 3, 4) ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. r r_ r� )rf rY r� �minr� � IndexErrorr� ) rQ r� �indexr� rP �cr� r� �resultrJ rJ rK r% � s, ��r% c C s t | g|�S )a Yield *value*, followed by the elements in *iterator*. >>> value = '0' >>> iterator = ['1', '2', '3'] >>> list(prepend(value, iterator)) ['0', '1', '2', '3'] To prepend multiple values, see :func:`itertools.chain` or :func:`value_chain`. )r )�valuer\ rJ rJ rK r. � s r. c c sb � t |�ddd� }t|�}tdg|d�| }t| td|d ��D ] }|�|� t||�V q!dS )aB Convolve the iterable *signal* with the iterable *kernel*. >>> signal = (1, 2, 3, 4, 5) >>> kernel = [3, 2, 1] >>> list(convolve(signal, kernel)) [3, 8, 14, 20, 26, 14, 5] Note: the input arguments are not interchangeable, as the *kernel* is immediately consumed and stored. Nr� r rU r_ )rf rY r r r r� �_sumprod)�signal�kernelrP �windowrH rJ rJ rK r � s � �r c s0 t � �� g �� ��fdd�}t�� �}|� |fS )a� A variant of :func:`takewhile` that allows complete access to the remainder of the iterator. >>> it = iter('ABCdEfGhI') >>> all_upper, remainder = before_and_after(str.isupper, it) >>> ''.join(all_upper) 'ABC' >>> ''.join(remainder) # takewhile() would lose the 'd' 'dEfGhI' Note that the first iterator must be fully consumed before the second iterator can generate valid results. c 3 s. � � D ]} �| �r | V q�� | � d S d S rG )r� )�elem�r� � predicate� transitionrJ rK � true_iterator s � �z'before_and_after.<locals>.true_iterator)rZ r )r� r� r� �remainder_iteratorrJ r� rK r � s r c c s0 � t t | ��D ]\\}}\}}|||fV qdS )z�Return overlapping triplets from *iterable*. >>> list(triplewise('ABCDE')) [('A', 'B', 'C'), ('B', 'C', 'D'), ('C', 'D', 'E')] Nrs )rQ rp �_rq r� rJ rJ rK r@ s � �r@ c c sB � t | �}tt||d �|d�}|D ] }|�|� t|�V qdS )aY Return a sliding window of width *n* over *iterable*. >>> list(sliding_window(range(6), 4)) [(0, 1, 2, 3), (1, 2, 3, 4), (2, 3, 4, 5)] If *iterable* has fewer than *n* items, then nothing is yielded: >>> list(sliding_window(range(3), 4)) [] For a variant with more features, see :func:`windowed`. r_ rU N)rZ r r r� rf )rQ rP r� r� rH rJ rJ rK r8 " s � �r8 c C s6 t | �}ttttt|�d �d��}ttjt |�|�S )z�Return all contiguous non-empty subslices of *iterable*. >>> list(subslices('ABC')) [['A'], ['A', 'B'], ['A', 'B', 'C'], ['B'], ['B', 'C'], ['C']] This is similar to :func:`substrings`, but emits items in a different order. r_ r^ ) rN r �slicer r� rY rR rg �getitemr )rQ �seq�slicesrJ rJ rK r9 6 s r9 c C s( t td�ttj| ��}ttt|dg��S )z�Compute a polynomial's coefficients from its roots. >>> roots = [5, -4, 3] # (x - 5) * (x + 4) * (x - 3) >>> polynomial_from_roots(roots) # x^3 - 4 * x^2 - 17 * x + 60 [1, -4, -17, 60] r_ )ro r rR rg �negrN r r )�roots�factorsrJ rJ rK r+ D s r+ c c s� � t | dd�}|du r(t| ||�}t||�D ]\}}||u s"||kr%|V qdS |du r0t| �n|}|d }z |||d |� }V q8 tyM Y dS w )a� Yield the index of each place in *iterable* that *value* occurs, beginning with index *start* and ending before index *stop*. >>> list(iter_index('AABCADEAF', 'A')) [0, 1, 4, 7] >>> list(iter_index('AABCADEAF', 'A', 1)) # start index is inclusive [1, 4, 7] >>> list(iter_index('AABCADEAF', 'A', 1, 7)) # stop index is not inclusive [1, 4] The behavior for non-scalar *values* matches the built-in Python types. >>> list(iter_index('ABCDABCD', 'AB')) [0, 4] >>> list(iter_index([0, 1, 2, 3, 0, 1, 2, 3], [0, 1])) [] >>> list(iter_index([[0, 1], [2, 3], [0, 1], [2, 3]], [0, 1])) [0, 2] See :func:`locate` for a more general means of finding the indexes associated with particular values. r� Nr_ )�getattrr r� rY r� )rQ r� rT �stop� seq_indexr� r� r� rJ rJ rK r! O s$ � ��� �r! c c s� � | dkrdV d}t d�| d }t�| �d }t|d||�D ])}t|d||| �E dH ttt|| | || ���||| | || �< || }q t|d|�E dH dS )zdYield the primes less than n. >>> list(sieve(30)) [2, 3, 5, 7, 11, 13, 17, 19, 23, 29] r^ r� )r r_ r_ N)� bytearray�math�isqrtr! �bytesrY r� )rP rT �data�limitr� rJ rJ rK r7 z s �. r7 c c sd � |dk r t d��t| �}tt||�� }r0|r"t|�|kr"t d��|V tt||�� }sdS dS )a� Batch data into tuples of length *n*. If the number of items in *iterable* is not divisible by *n*: * The last batch will be shorter if *strict* is ``False``. * :exc:`ValueError` will be raised if *strict* is ``True``. >>> list(batched('ABCDEFG', 3)) [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)] On Python 3.13 and above, this is an alias for :func:`itertools.batched`. r_ zn must be at least onezbatched(): incomplete batchN)r� rZ rf r rY )rQ rP rE r� �batchrJ rJ rK �_batched� s � �r� i� )r c C s t | ||d�S )NrD )�itertools_batched)rQ rP rE rJ rJ rK r � s r c C s t | � S )a Swap the rows and columns of the input matrix. >>> list(transpose([(1, 2, 3), (11, 22, 33)])) [(1, 11), (2, 22), (3, 33)] The caller should ensure that the dimensions of the input are compatible. If the input is empty, no output will be produced. )� _zip_strict�r� rJ rJ rK r? � s r? c C s t t�| �|�S )z�Reshape the 2-D input *matrix* to have a column count given by *cols*. >>> matrix = [(0, 1), (2, 3), (4, 5)] >>> cols = 3 >>> list(reshape(matrix, cols)) [(0, 1, 2), (3, 4, 5)] )r r re )�matrix�colsrJ rJ rK r0 � s r0 c C s& t |d �}tttt| t|���|�S )z�Multiply two matrices. >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)])) [(49, 80), (41, 60)] The caller should ensure that the dimensions of the input matrices are compatible with each other. r )rY r r r� r r? )�m1�m2rP rJ rJ rK r" � s r" c c s\ � t t�| �d �D ]}| | s"|V | | } | dkr dS | | rq | dkr,| V dS dS )zTYield the prime factors of n. >>> list(factor(360)) [2, 2, 2, 3, 3, 5] r_ N)r7 r� r� )rP �primerJ rJ rK r � s ��� �r c C s: t | �}|dkr |d S ttt|�tt|���}t| |�S )z�Evaluate a polynomial at a specific value. Example: evaluating x^3 - 4 * x^2 - 17 * x + 60 at x = 2.5: >>> coefficients = [1, -4, -17, 60] >>> x = 2.5 >>> polynomial_eval(coefficients, x) 8.125 r )rY rR �powr �reversedr� r� )� coefficientsrH rP �powersrJ rJ rK r* � s r* c C s t t| �� S )zfReturn the sum of the squares of the input values. >>> sum_of_squares([10, 20, 30]) 1400 )r� r r� rJ rJ rK r: � s r: c C s( t | �}ttd|��}tttj| |��S )a Compute the first derivative of a polynomial. Example: evaluating the derivative of x^3 - 4 * x^2 - 17 * x + 60 >>> coefficients = [1, -4, -17, 60] >>> derivative_coefficients = polynomial_derivative(coefficients) >>> derivative_coefficients [3, -8, -17] r_ )rY r� r� rN rR rg rh )r� rP r� rJ rJ rK r, � s r, c C s& t t| ��D ] }| | |d } q| S )z�Return the count of natural numbers up to *n* that are coprime with *n*. >>> totient(9) 6 >>> totient(12) 4 r_ )r� r )rP r� rJ rJ rK r> s r> )r rG )r� N)NF)NN)r N)]�__doc__r� rg � collectionsr �collections.abcr � functoolsr r � itertoolsr r r r r r r r r r r r �randomr r r �sysr �__all__�objectr� ro r� r� r� r� r= r; r< r r$ r r� r/ r' r& r# r r r5 rr r( rt � ImportErrorr� ru r� r� r r6 r) r- rB rC rA r r r4 r3 r2 r1 r% r. r r r@ r8 r9 r+ r! r7 r� r r� r? r0 r" r r* r: r, r> rJ rJ rJ rK �<module> s� 8 1 � ( � ( - *! + _vendor/more_itertools/more.pyi 0000644 00000051754 15030122015 0012734 0 ustar 00 """Stubs for more_itertools.more""" from __future__ import annotations from types import TracebackType from typing import ( Any, Callable, Container, ContextManager, Generic, Hashable, Mapping, Iterable, Iterator, Mapping, overload, Reversible, Sequence, Sized, Type, TypeVar, type_check_only, ) from typing_extensions import Protocol # Type and type variable definitions _T = TypeVar('_T') _T1 = TypeVar('_T1') _T2 = TypeVar('_T2') _U = TypeVar('_U') _V = TypeVar('_V') _W = TypeVar('_W') _T_co = TypeVar('_T_co', covariant=True) _GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]]) _Raisable = BaseException | Type[BaseException] @type_check_only class _SizedIterable(Protocol[_T_co], Sized, Iterable[_T_co]): ... @type_check_only class _SizedReversible(Protocol[_T_co], Sized, Reversible[_T_co]): ... @type_check_only class _SupportsSlicing(Protocol[_T_co]): def __getitem__(self, __k: slice) -> _T_co: ... def chunked( iterable: Iterable[_T], n: int | None, strict: bool = ... ) -> Iterator[list[_T]]: ... @overload def first(iterable: Iterable[_T]) -> _T: ... @overload def first(iterable: Iterable[_T], default: _U) -> _T | _U: ... @overload def last(iterable: Iterable[_T]) -> _T: ... @overload def last(iterable: Iterable[_T], default: _U) -> _T | _U: ... @overload def nth_or_last(iterable: Iterable[_T], n: int) -> _T: ... @overload def nth_or_last(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ... class peekable(Generic[_T], Iterator[_T]): def __init__(self, iterable: Iterable[_T]) -> None: ... def __iter__(self) -> peekable[_T]: ... def __bool__(self) -> bool: ... @overload def peek(self) -> _T: ... @overload def peek(self, default: _U) -> _T | _U: ... def prepend(self, *items: _T) -> None: ... def __next__(self) -> _T: ... @overload def __getitem__(self, index: int) -> _T: ... @overload def __getitem__(self, index: slice) -> list[_T]: ... def consumer(func: _GenFn) -> _GenFn: ... def ilen(iterable: Iterable[_T]) -> int: ... def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ... def with_iter( context_manager: ContextManager[Iterable[_T]], ) -> Iterator[_T]: ... def one( iterable: Iterable[_T], too_short: _Raisable | None = ..., too_long: _Raisable | None = ..., ) -> _T: ... def raise_(exception: _Raisable, *args: Any) -> None: ... def strictly_n( iterable: Iterable[_T], n: int, too_short: _GenFn | None = ..., too_long: _GenFn | None = ..., ) -> list[_T]: ... def distinct_permutations( iterable: Iterable[_T], r: int | None = ... ) -> Iterator[tuple[_T, ...]]: ... def intersperse( e: _U, iterable: Iterable[_T], n: int = ... ) -> Iterator[_T | _U]: ... def unique_to_each(*iterables: Iterable[_T]) -> list[list[_T]]: ... @overload def windowed( seq: Iterable[_T], n: int, *, step: int = ... ) -> Iterator[tuple[_T | None, ...]]: ... @overload def windowed( seq: Iterable[_T], n: int, fillvalue: _U, step: int = ... ) -> Iterator[tuple[_T | _U, ...]]: ... def substrings(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... def substrings_indexes( seq: Sequence[_T], reverse: bool = ... ) -> Iterator[tuple[Sequence[_T], int, int]]: ... class bucket(Generic[_T, _U], Container[_U]): def __init__( self, iterable: Iterable[_T], key: Callable[[_T], _U], validator: Callable[[_U], object] | None = ..., ) -> None: ... def __contains__(self, value: object) -> bool: ... def __iter__(self) -> Iterator[_U]: ... def __getitem__(self, value: object) -> Iterator[_T]: ... def spy( iterable: Iterable[_T], n: int = ... ) -> tuple[list[_T], Iterator[_T]]: ... def interleave(*iterables: Iterable[_T]) -> Iterator[_T]: ... def interleave_longest(*iterables: Iterable[_T]) -> Iterator[_T]: ... def interleave_evenly( iterables: list[Iterable[_T]], lengths: list[int] | None = ... ) -> Iterator[_T]: ... def collapse( iterable: Iterable[Any], base_type: type | None = ..., levels: int | None = ..., ) -> Iterator[Any]: ... @overload def side_effect( func: Callable[[_T], object], iterable: Iterable[_T], chunk_size: None = ..., before: Callable[[], object] | None = ..., after: Callable[[], object] | None = ..., ) -> Iterator[_T]: ... @overload def side_effect( func: Callable[[list[_T]], object], iterable: Iterable[_T], chunk_size: int, before: Callable[[], object] | None = ..., after: Callable[[], object] | None = ..., ) -> Iterator[_T]: ... def sliced( seq: _SupportsSlicing[_T], n: int, strict: bool = ... ) -> Iterator[_T]: ... def split_at( iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ..., keep_separator: bool = ..., ) -> Iterator[list[_T]]: ... def split_before( iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ... ) -> Iterator[list[_T]]: ... def split_after( iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ... ) -> Iterator[list[_T]]: ... def split_when( iterable: Iterable[_T], pred: Callable[[_T, _T], object], maxsplit: int = ..., ) -> Iterator[list[_T]]: ... def split_into( iterable: Iterable[_T], sizes: Iterable[int | None] ) -> Iterator[list[_T]]: ... @overload def padded( iterable: Iterable[_T], *, n: int | None = ..., next_multiple: bool = ..., ) -> Iterator[_T | None]: ... @overload def padded( iterable: Iterable[_T], fillvalue: _U, n: int | None = ..., next_multiple: bool = ..., ) -> Iterator[_T | _U]: ... @overload def repeat_last(iterable: Iterable[_T]) -> Iterator[_T]: ... @overload def repeat_last(iterable: Iterable[_T], default: _U) -> Iterator[_T | _U]: ... def distribute(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ... @overload def stagger( iterable: Iterable[_T], offsets: _SizedIterable[int] = ..., longest: bool = ..., ) -> Iterator[tuple[_T | None, ...]]: ... @overload def stagger( iterable: Iterable[_T], offsets: _SizedIterable[int] = ..., longest: bool = ..., fillvalue: _U = ..., ) -> Iterator[tuple[_T | _U, ...]]: ... class UnequalIterablesError(ValueError): def __init__(self, details: tuple[int, int, int] | None = ...) -> None: ... @overload def zip_equal(__iter1: Iterable[_T1]) -> Iterator[tuple[_T1]]: ... @overload def zip_equal( __iter1: Iterable[_T1], __iter2: Iterable[_T2] ) -> Iterator[tuple[_T1, _T2]]: ... @overload def zip_equal( __iter1: Iterable[_T], __iter2: Iterable[_T], __iter3: Iterable[_T], *iterables: Iterable[_T], ) -> Iterator[tuple[_T, ...]]: ... @overload def zip_offset( __iter1: Iterable[_T1], *, offsets: _SizedIterable[int], longest: bool = ..., fillvalue: None = None, ) -> Iterator[tuple[_T1 | None]]: ... @overload def zip_offset( __iter1: Iterable[_T1], __iter2: Iterable[_T2], *, offsets: _SizedIterable[int], longest: bool = ..., fillvalue: None = None, ) -> Iterator[tuple[_T1 | None, _T2 | None]]: ... @overload def zip_offset( __iter1: Iterable[_T], __iter2: Iterable[_T], __iter3: Iterable[_T], *iterables: Iterable[_T], offsets: _SizedIterable[int], longest: bool = ..., fillvalue: None = None, ) -> Iterator[tuple[_T | None, ...]]: ... @overload def zip_offset( __iter1: Iterable[_T1], *, offsets: _SizedIterable[int], longest: bool = ..., fillvalue: _U, ) -> Iterator[tuple[_T1 | _U]]: ... @overload def zip_offset( __iter1: Iterable[_T1], __iter2: Iterable[_T2], *, offsets: _SizedIterable[int], longest: bool = ..., fillvalue: _U, ) -> Iterator[tuple[_T1 | _U, _T2 | _U]]: ... @overload def zip_offset( __iter1: Iterable[_T], __iter2: Iterable[_T], __iter3: Iterable[_T], *iterables: Iterable[_T], offsets: _SizedIterable[int], longest: bool = ..., fillvalue: _U, ) -> Iterator[tuple[_T | _U, ...]]: ... def sort_together( iterables: Iterable[Iterable[_T]], key_list: Iterable[int] = ..., key: Callable[..., Any] | None = ..., reverse: bool = ..., ) -> list[tuple[_T, ...]]: ... def unzip(iterable: Iterable[Sequence[_T]]) -> tuple[Iterator[_T], ...]: ... def divide(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ... def always_iterable( obj: object, base_type: type | tuple[type | tuple[Any, ...], ...] | None = ..., ) -> Iterator[Any]: ... def adjacent( predicate: Callable[[_T], bool], iterable: Iterable[_T], distance: int = ..., ) -> Iterator[tuple[bool, _T]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: None = None, valuefunc: None = None, reducefunc: None = None, ) -> Iterator[tuple[_T, Iterator[_T]]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: None, reducefunc: None, ) -> Iterator[tuple[_U, Iterator[_T]]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: None, valuefunc: Callable[[_T], _V], reducefunc: None, ) -> Iterable[tuple[_T, Iterable[_V]]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: Callable[[_T], _V], reducefunc: None, ) -> Iterable[tuple[_U, Iterator[_V]]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: None, valuefunc: None, reducefunc: Callable[[Iterator[_T]], _W], ) -> Iterable[tuple[_T, _W]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: None, reducefunc: Callable[[Iterator[_T]], _W], ) -> Iterable[tuple[_U, _W]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: None, valuefunc: Callable[[_T], _V], reducefunc: Callable[[Iterable[_V]], _W], ) -> Iterable[tuple[_T, _W]]: ... @overload def groupby_transform( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: Callable[[_T], _V], reducefunc: Callable[[Iterable[_V]], _W], ) -> Iterable[tuple[_U, _W]]: ... class numeric_range(Generic[_T, _U], Sequence[_T], Hashable, Reversible[_T]): @overload def __init__(self, __stop: _T) -> None: ... @overload def __init__(self, __start: _T, __stop: _T) -> None: ... @overload def __init__(self, __start: _T, __stop: _T, __step: _U) -> None: ... def __bool__(self) -> bool: ... def __contains__(self, elem: object) -> bool: ... def __eq__(self, other: object) -> bool: ... @overload def __getitem__(self, key: int) -> _T: ... @overload def __getitem__(self, key: slice) -> numeric_range[_T, _U]: ... def __hash__(self) -> int: ... def __iter__(self) -> Iterator[_T]: ... def __len__(self) -> int: ... def __reduce__( self, ) -> tuple[Type[numeric_range[_T, _U]], tuple[_T, _T, _U]]: ... def __repr__(self) -> str: ... def __reversed__(self) -> Iterator[_T]: ... def count(self, value: _T) -> int: ... def index(self, value: _T) -> int: ... # type: ignore def count_cycle( iterable: Iterable[_T], n: int | None = ... ) -> Iterable[tuple[int, _T]]: ... def mark_ends( iterable: Iterable[_T], ) -> Iterable[tuple[bool, bool, _T]]: ... def locate( iterable: Iterable[_T], pred: Callable[..., Any] = ..., window_size: int | None = ..., ) -> Iterator[int]: ... def lstrip( iterable: Iterable[_T], pred: Callable[[_T], object] ) -> Iterator[_T]: ... def rstrip( iterable: Iterable[_T], pred: Callable[[_T], object] ) -> Iterator[_T]: ... def strip( iterable: Iterable[_T], pred: Callable[[_T], object] ) -> Iterator[_T]: ... class islice_extended(Generic[_T], Iterator[_T]): def __init__(self, iterable: Iterable[_T], *args: int | None) -> None: ... def __iter__(self) -> islice_extended[_T]: ... def __next__(self) -> _T: ... def __getitem__(self, index: slice) -> islice_extended[_T]: ... def always_reversible(iterable: Iterable[_T]) -> Iterator[_T]: ... def consecutive_groups( iterable: Iterable[_T], ordering: Callable[[_T], int] = ... ) -> Iterator[Iterator[_T]]: ... @overload def difference( iterable: Iterable[_T], func: Callable[[_T, _T], _U] = ..., *, initial: None = ..., ) -> Iterator[_T | _U]: ... @overload def difference( iterable: Iterable[_T], func: Callable[[_T, _T], _U] = ..., *, initial: _U ) -> Iterator[_U]: ... class SequenceView(Generic[_T], Sequence[_T]): def __init__(self, target: Sequence[_T]) -> None: ... @overload def __getitem__(self, index: int) -> _T: ... @overload def __getitem__(self, index: slice) -> Sequence[_T]: ... def __len__(self) -> int: ... class seekable(Generic[_T], Iterator[_T]): def __init__( self, iterable: Iterable[_T], maxlen: int | None = ... ) -> None: ... def __iter__(self) -> seekable[_T]: ... def __next__(self) -> _T: ... def __bool__(self) -> bool: ... @overload def peek(self) -> _T: ... @overload def peek(self, default: _U) -> _T | _U: ... def elements(self) -> SequenceView[_T]: ... def seek(self, index: int) -> None: ... def relative_seek(self, count: int) -> None: ... class run_length: @staticmethod def encode(iterable: Iterable[_T]) -> Iterator[tuple[_T, int]]: ... @staticmethod def decode(iterable: Iterable[tuple[_T, int]]) -> Iterator[_T]: ... def exactly_n( iterable: Iterable[_T], n: int, predicate: Callable[[_T], object] = ... ) -> bool: ... def circular_shifts(iterable: Iterable[_T]) -> list[tuple[_T, ...]]: ... def make_decorator( wrapping_func: Callable[..., _U], result_index: int = ... ) -> Callable[..., Callable[[Callable[..., Any]], Callable[..., _U]]]: ... @overload def map_reduce( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: None = ..., reducefunc: None = ..., ) -> dict[_U, list[_T]]: ... @overload def map_reduce( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: Callable[[_T], _V], reducefunc: None = ..., ) -> dict[_U, list[_V]]: ... @overload def map_reduce( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: None = ..., reducefunc: Callable[[list[_T]], _W] = ..., ) -> dict[_U, _W]: ... @overload def map_reduce( iterable: Iterable[_T], keyfunc: Callable[[_T], _U], valuefunc: Callable[[_T], _V], reducefunc: Callable[[list[_V]], _W], ) -> dict[_U, _W]: ... def rlocate( iterable: Iterable[_T], pred: Callable[..., object] = ..., window_size: int | None = ..., ) -> Iterator[int]: ... def replace( iterable: Iterable[_T], pred: Callable[..., object], substitutes: Iterable[_U], count: int | None = ..., window_size: int = ..., ) -> Iterator[_T | _U]: ... def partitions(iterable: Iterable[_T]) -> Iterator[list[list[_T]]]: ... def set_partitions( iterable: Iterable[_T], k: int | None = ... ) -> Iterator[list[list[_T]]]: ... class time_limited(Generic[_T], Iterator[_T]): def __init__( self, limit_seconds: float, iterable: Iterable[_T] ) -> None: ... def __iter__(self) -> islice_extended[_T]: ... def __next__(self) -> _T: ... @overload def only( iterable: Iterable[_T], *, too_long: _Raisable | None = ... ) -> _T | None: ... @overload def only( iterable: Iterable[_T], default: _U, too_long: _Raisable | None = ... ) -> _T | _U: ... def ichunked(iterable: Iterable[_T], n: int) -> Iterator[Iterator[_T]]: ... def distinct_combinations( iterable: Iterable[_T], r: int ) -> Iterator[tuple[_T, ...]]: ... def filter_except( validator: Callable[[Any], object], iterable: Iterable[_T], *exceptions: Type[BaseException], ) -> Iterator[_T]: ... def map_except( function: Callable[[Any], _U], iterable: Iterable[_T], *exceptions: Type[BaseException], ) -> Iterator[_U]: ... def map_if( iterable: Iterable[Any], pred: Callable[[Any], bool], func: Callable[[Any], Any], func_else: Callable[[Any], Any] | None = ..., ) -> Iterator[Any]: ... def sample( iterable: Iterable[_T], k: int, weights: Iterable[float] | None = ..., ) -> list[_T]: ... def is_sorted( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ..., reverse: bool = False, strict: bool = False, ) -> bool: ... class AbortThread(BaseException): pass class callback_iter(Generic[_T], Iterator[_T]): def __init__( self, func: Callable[..., Any], callback_kwd: str = ..., wait_seconds: float = ..., ) -> None: ... def __enter__(self) -> callback_iter[_T]: ... def __exit__( self, exc_type: Type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, ) -> bool | None: ... def __iter__(self) -> callback_iter[_T]: ... def __next__(self) -> _T: ... def _reader(self) -> Iterator[_T]: ... @property def done(self) -> bool: ... @property def result(self) -> Any: ... def windowed_complete( iterable: Iterable[_T], n: int ) -> Iterator[tuple[_T, ...]]: ... def all_unique( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> bool: ... def nth_product(index: int, *args: Iterable[_T]) -> tuple[_T, ...]: ... def nth_combination_with_replacement( iterable: Iterable[_T], r: int, index: int ) -> tuple[_T, ...]: ... def nth_permutation( iterable: Iterable[_T], r: int, index: int ) -> tuple[_T, ...]: ... def value_chain(*args: _T | Iterable[_T]) -> Iterable[_T]: ... def product_index(element: Iterable[_T], *args: Iterable[_T]) -> int: ... def combination_index( element: Iterable[_T], iterable: Iterable[_T] ) -> int: ... def combination_with_replacement_index( element: Iterable[_T], iterable: Iterable[_T] ) -> int: ... def permutation_index( element: Iterable[_T], iterable: Iterable[_T] ) -> int: ... def repeat_each(iterable: Iterable[_T], n: int = ...) -> Iterator[_T]: ... class countable(Generic[_T], Iterator[_T]): def __init__(self, iterable: Iterable[_T]) -> None: ... def __iter__(self) -> countable[_T]: ... def __next__(self) -> _T: ... items_seen: int def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[list[_T]]: ... def zip_broadcast( *objects: _T | Iterable[_T], scalar_types: type | tuple[type | tuple[Any, ...], ...] | None = ..., strict: bool = ..., ) -> Iterable[tuple[_T, ...]]: ... def unique_in_window( iterable: Iterable[_T], n: int, key: Callable[[_T], _U] | None = ... ) -> Iterator[_T]: ... def duplicates_everseen( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> Iterator[_T]: ... def duplicates_justseen( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> Iterator[_T]: ... def classify_unique( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> Iterator[tuple[_T, bool, bool]]: ... class _SupportsLessThan(Protocol): def __lt__(self, __other: Any) -> bool: ... _SupportsLessThanT = TypeVar("_SupportsLessThanT", bound=_SupportsLessThan) @overload def minmax( iterable_or_value: Iterable[_SupportsLessThanT], *, key: None = None ) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ... @overload def minmax( iterable_or_value: Iterable[_T], *, key: Callable[[_T], _SupportsLessThan] ) -> tuple[_T, _T]: ... @overload def minmax( iterable_or_value: Iterable[_SupportsLessThanT], *, key: None = None, default: _U, ) -> _U | tuple[_SupportsLessThanT, _SupportsLessThanT]: ... @overload def minmax( iterable_or_value: Iterable[_T], *, key: Callable[[_T], _SupportsLessThan], default: _U, ) -> _U | tuple[_T, _T]: ... @overload def minmax( iterable_or_value: _SupportsLessThanT, __other: _SupportsLessThanT, *others: _SupportsLessThanT, ) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ... @overload def minmax( iterable_or_value: _T, __other: _T, *others: _T, key: Callable[[_T], _SupportsLessThan], ) -> tuple[_T, _T]: ... def longest_common_prefix( iterables: Iterable[Iterable[_T]], ) -> Iterator[_T]: ... def iequals(*iterables: Iterable[Any]) -> bool: ... def constrained_batches( iterable: Iterable[_T], max_size: int, max_count: int | None = ..., get_len: Callable[[_T], object] = ..., strict: bool = ..., ) -> Iterator[tuple[_T]]: ... def gray_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... def partial_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... def takewhile_inclusive( predicate: Callable[[_T], bool], iterable: Iterable[_T] ) -> Iterator[_T]: ... def outer_product( func: Callable[[_T, _U], _V], xs: Iterable[_T], ys: Iterable[_U], *args: Any, **kwargs: Any, ) -> Iterator[tuple[_V, ...]]: ... def iter_suppress( iterable: Iterable[_T], *exceptions: Type[BaseException], ) -> Iterator[_T]: ... def filter_map( func: Callable[[_T], _V | None], iterable: Iterable[_T], ) -> Iterator[_V]: ... def powerset_of_sets(iterable: Iterable[_T]) -> Iterator[set[_T]]: ... def join_mappings( **field_to_map: Mapping[_T, _V] ) -> dict[_T, dict[str, _V]]: ... def doublestarmap( func: Callable[..., _T], iterable: Iterable[Mapping[str, Any]], ) -> Iterator[_T]: ... def dft(xarr: Sequence[complex]) -> Iterator[complex]: ... def idft(Xarr: Sequence[complex]) -> Iterator[complex]: ... _vendor/more_itertools/__init__.pyi 0000644 00000000053 15030122015 0013513 0 ustar 00 from .more import * from .recipes import * _vendor/more_itertools/recipes.pyi 0000644 00000011011 15030122015 0013402 0 ustar 00 """Stubs for more_itertools.recipes""" from __future__ import annotations from typing import ( Any, Callable, Iterable, Iterator, overload, Sequence, Type, TypeVar, ) # Type and type variable definitions _T = TypeVar('_T') _T1 = TypeVar('_T1') _T2 = TypeVar('_T2') _U = TypeVar('_U') def take(n: int, iterable: Iterable[_T]) -> list[_T]: ... def tabulate( function: Callable[[int], _T], start: int = ... ) -> Iterator[_T]: ... def tail(n: int, iterable: Iterable[_T]) -> Iterator[_T]: ... def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ... @overload def nth(iterable: Iterable[_T], n: int) -> _T | None: ... @overload def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ... def all_equal( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> bool: ... def quantify( iterable: Iterable[_T], pred: Callable[[_T], bool] = ... ) -> int: ... def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ... def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ... def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ... def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ... def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ... def repeatfunc( func: Callable[..., _U], times: int | None = ..., *args: Any ) -> Iterator[_U]: ... def pairwise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T]]: ... def grouper( iterable: Iterable[_T], n: int, incomplete: str = ..., fillvalue: _U = ..., ) -> Iterator[tuple[_T | _U, ...]]: ... def roundrobin(*iterables: Iterable[_T]) -> Iterator[_T]: ... def partition( pred: Callable[[_T], object] | None, iterable: Iterable[_T] ) -> tuple[Iterator[_T], Iterator[_T]]: ... def powerset(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... def unique_everseen( iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... ) -> Iterator[_T]: ... def unique_justseen( iterable: Iterable[_T], key: Callable[[_T], object] | None = ... ) -> Iterator[_T]: ... def unique( iterable: Iterable[_T], key: Callable[[_T], object] | None = ..., reverse: bool = False, ) -> Iterator[_T]: ... @overload def iter_except( func: Callable[[], _T], exception: Type[BaseException] | tuple[Type[BaseException], ...], first: None = ..., ) -> Iterator[_T]: ... @overload def iter_except( func: Callable[[], _T], exception: Type[BaseException] | tuple[Type[BaseException], ...], first: Callable[[], _U], ) -> Iterator[_T | _U]: ... @overload def first_true( iterable: Iterable[_T], *, pred: Callable[[_T], object] | None = ... ) -> _T | None: ... @overload def first_true( iterable: Iterable[_T], default: _U, pred: Callable[[_T], object] | None = ..., ) -> _T | _U: ... def random_product( *args: Iterable[_T], repeat: int = ... ) -> tuple[_T, ...]: ... def random_permutation( iterable: Iterable[_T], r: int | None = ... ) -> tuple[_T, ...]: ... def random_combination(iterable: Iterable[_T], r: int) -> tuple[_T, ...]: ... def random_combination_with_replacement( iterable: Iterable[_T], r: int ) -> tuple[_T, ...]: ... def nth_combination( iterable: Iterable[_T], r: int, index: int ) -> tuple[_T, ...]: ... def prepend(value: _T, iterator: Iterable[_U]) -> Iterator[_T | _U]: ... def convolve(signal: Iterable[_T], kernel: Iterable[_T]) -> Iterator[_T]: ... def before_and_after( predicate: Callable[[_T], bool], it: Iterable[_T] ) -> tuple[Iterator[_T], Iterator[_T]]: ... def triplewise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T, _T]]: ... def sliding_window( iterable: Iterable[_T], n: int ) -> Iterator[tuple[_T, ...]]: ... def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ... def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ... def iter_index( iterable: Iterable[_T], value: Any, start: int | None = ..., stop: int | None = ..., ) -> Iterator[int]: ... def sieve(n: int) -> Iterator[int]: ... def batched( iterable: Iterable[_T], n: int, *, strict: bool = False ) -> Iterator[tuple[_T]]: ... def transpose( it: Iterable[Iterable[_T]], ) -> Iterator[tuple[_T, ...]]: ... def reshape( matrix: Iterable[Iterable[_T]], cols: int ) -> Iterator[tuple[_T, ...]]: ... def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ... def factor(n: int) -> Iterator[int]: ... def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ... def sum_of_squares(it: Iterable[_T]) -> _T: ... def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ... def totient(n: int) -> int: ... _vendor/more_itertools/py.typed 0000644 00000000000 15030122015 0012720 0 ustar 00 _vendor/more_itertools/more.py 0000644 00000441622 15030122015 0012560 0 ustar 00 import math import warnings from collections import Counter, defaultdict, deque, abc from collections.abc import Sequence from functools import cached_property, partial, reduce, wraps from heapq import heapify, heapreplace, heappop from itertools import ( chain, combinations, compress, count, cycle, dropwhile, groupby, islice, repeat, starmap, takewhile, tee, zip_longest, product, ) from math import comb, e, exp, factorial, floor, fsum, log, perm, tau from queue import Empty, Queue from random import random, randrange, uniform from operator import itemgetter, mul, sub, gt, lt, ge, le from sys import hexversion, maxsize from time import monotonic from .recipes import ( _marker, _zip_equal, UnequalIterablesError, consume, flatten, pairwise, powerset, take, unique_everseen, all_equal, batched, ) __all__ = [ 'AbortThread', 'SequenceView', 'UnequalIterablesError', 'adjacent', 'all_unique', 'always_iterable', 'always_reversible', 'bucket', 'callback_iter', 'chunked', 'chunked_even', 'circular_shifts', 'collapse', 'combination_index', 'combination_with_replacement_index', 'consecutive_groups', 'constrained_batches', 'consumer', 'count_cycle', 'countable', 'dft', 'difference', 'distinct_combinations', 'distinct_permutations', 'distribute', 'divide', 'doublestarmap', 'duplicates_everseen', 'duplicates_justseen', 'classify_unique', 'exactly_n', 'filter_except', 'filter_map', 'first', 'gray_product', 'groupby_transform', 'ichunked', 'iequals', 'idft', 'ilen', 'interleave', 'interleave_evenly', 'interleave_longest', 'intersperse', 'is_sorted', 'islice_extended', 'iterate', 'iter_suppress', 'join_mappings', 'last', 'locate', 'longest_common_prefix', 'lstrip', 'make_decorator', 'map_except', 'map_if', 'map_reduce', 'mark_ends', 'minmax', 'nth_or_last', 'nth_permutation', 'nth_product', 'nth_combination_with_replacement', 'numeric_range', 'one', 'only', 'outer_product', 'padded', 'partial_product', 'partitions', 'peekable', 'permutation_index', 'powerset_of_sets', 'product_index', 'raise_', 'repeat_each', 'repeat_last', 'replace', 'rlocate', 'rstrip', 'run_length', 'sample', 'seekable', 'set_partitions', 'side_effect', 'sliced', 'sort_together', 'split_after', 'split_at', 'split_before', 'split_into', 'split_when', 'spy', 'stagger', 'strip', 'strictly_n', 'substrings', 'substrings_indexes', 'takewhile_inclusive', 'time_limited', 'unique_in_window', 'unique_to_each', 'unzip', 'value_chain', 'windowed', 'windowed_complete', 'with_iter', 'zip_broadcast', 'zip_equal', 'zip_offset', ] # math.sumprod is available for Python 3.12+ _fsumprod = getattr(math, 'sumprod', lambda x, y: fsum(map(mul, x, y))) def chunked(iterable, n, strict=False): """Break *iterable* into lists of length *n*: >>> list(chunked([1, 2, 3, 4, 5, 6], 3)) [[1, 2, 3], [4, 5, 6]] By the default, the last yielded list will have fewer than *n* elements if the length of *iterable* is not divisible by *n*: >>> list(chunked([1, 2, 3, 4, 5, 6, 7, 8], 3)) [[1, 2, 3], [4, 5, 6], [7, 8]] To use a fill-in value instead, see the :func:`grouper` recipe. If the length of *iterable* is not divisible by *n* and *strict* is ``True``, then ``ValueError`` will be raised before the last list is yielded. """ iterator = iter(partial(take, n, iter(iterable)), []) if strict: if n is None: raise ValueError('n must not be None when using strict mode.') def ret(): for chunk in iterator: if len(chunk) != n: raise ValueError('iterable is not divisible by n.') yield chunk return iter(ret()) else: return iterator def first(iterable, default=_marker): """Return the first item of *iterable*, or *default* if *iterable* is empty. >>> first([0, 1, 2, 3]) 0 >>> first([], 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. :func:`first` is useful when you have a generator of expensive-to-retrieve values and want any arbitrary one. It is marginally shorter than ``next(iter(iterable), default)``. """ for item in iterable: return item if default is _marker: raise ValueError( 'first() was called on an empty iterable, and no ' 'default value was provided.' ) return default def last(iterable, default=_marker): """Return the last item of *iterable*, or *default* if *iterable* is empty. >>> last([0, 1, 2, 3]) 3 >>> last([], 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. """ try: if isinstance(iterable, Sequence): return iterable[-1] # Work around https://bugs.python.org/issue38525 elif hasattr(iterable, '__reversed__') and (hexversion != 0x030800F0): return next(reversed(iterable)) else: return deque(iterable, maxlen=1)[-1] except (IndexError, TypeError, StopIteration): if default is _marker: raise ValueError( 'last() was called on an empty iterable, and no default was ' 'provided.' ) return default def nth_or_last(iterable, n, default=_marker): """Return the nth or the last item of *iterable*, or *default* if *iterable* is empty. >>> nth_or_last([0, 1, 2, 3], 2) 2 >>> nth_or_last([0, 1], 2) 1 >>> nth_or_last([], 0, 'some default') 'some default' If *default* is not provided and there are no items in the iterable, raise ``ValueError``. """ return last(islice(iterable, n + 1), default=default) class peekable: """Wrap an iterator to allow lookahead and prepending elements. Call :meth:`peek` on the result to get the value that will be returned by :func:`next`. This won't advance the iterator: >>> p = peekable(['a', 'b']) >>> p.peek() 'a' >>> next(p) 'a' Pass :meth:`peek` a default value to return that instead of raising ``StopIteration`` when the iterator is exhausted. >>> p = peekable([]) >>> p.peek('hi') 'hi' peekables also offer a :meth:`prepend` method, which "inserts" items at the head of the iterable: >>> p = peekable([1, 2, 3]) >>> p.prepend(10, 11, 12) >>> next(p) 10 >>> p.peek() 11 >>> list(p) [11, 12, 1, 2, 3] peekables can be indexed. Index 0 is the item that will be returned by :func:`next`, index 1 is the item after that, and so on: The values up to the given index will be cached. >>> p = peekable(['a', 'b', 'c', 'd']) >>> p[0] 'a' >>> p[1] 'b' >>> next(p) 'a' Negative indexes are supported, but be aware that they will cache the remaining items in the source iterator, which may require significant storage. To check whether a peekable is exhausted, check its truth value: >>> p = peekable(['a', 'b']) >>> if p: # peekable has items ... list(p) ['a', 'b'] >>> if not p: # peekable is exhausted ... list(p) [] """ def __init__(self, iterable): self._it = iter(iterable) self._cache = deque() def __iter__(self): return self def __bool__(self): try: self.peek() except StopIteration: return False return True def peek(self, default=_marker): """Return the item that will be next returned from ``next()``. Return ``default`` if there are no items left. If ``default`` is not provided, raise ``StopIteration``. """ if not self._cache: try: self._cache.append(next(self._it)) except StopIteration: if default is _marker: raise return default return self._cache[0] def prepend(self, *items): """Stack up items to be the next ones returned from ``next()`` or ``self.peek()``. The items will be returned in first in, first out order:: >>> p = peekable([1, 2, 3]) >>> p.prepend(10, 11, 12) >>> next(p) 10 >>> list(p) [11, 12, 1, 2, 3] It is possible, by prepending items, to "resurrect" a peekable that previously raised ``StopIteration``. >>> p = peekable([]) >>> next(p) Traceback (most recent call last): ... StopIteration >>> p.prepend(1) >>> next(p) 1 >>> next(p) Traceback (most recent call last): ... StopIteration """ self._cache.extendleft(reversed(items)) def __next__(self): if self._cache: return self._cache.popleft() return next(self._it) def _get_slice(self, index): # Normalize the slice's arguments step = 1 if (index.step is None) else index.step if step > 0: start = 0 if (index.start is None) else index.start stop = maxsize if (index.stop is None) else index.stop elif step < 0: start = -1 if (index.start is None) else index.start stop = (-maxsize - 1) if (index.stop is None) else index.stop else: raise ValueError('slice step cannot be zero') # If either the start or stop index is negative, we'll need to cache # the rest of the iterable in order to slice from the right side. if (start < 0) or (stop < 0): self._cache.extend(self._it) # Otherwise we'll need to find the rightmost index and cache to that # point. else: n = min(max(start, stop) + 1, maxsize) cache_len = len(self._cache) if n >= cache_len: self._cache.extend(islice(self._it, n - cache_len)) return list(self._cache)[index] def __getitem__(self, index): if isinstance(index, slice): return self._get_slice(index) cache_len = len(self._cache) if index < 0: self._cache.extend(self._it) elif index >= cache_len: self._cache.extend(islice(self._it, index + 1 - cache_len)) return self._cache[index] def consumer(func): """Decorator that automatically advances a PEP-342-style "reverse iterator" to its first yield point so you don't have to call ``next()`` on it manually. >>> @consumer ... def tally(): ... i = 0 ... while True: ... print('Thing number %s is %s.' % (i, (yield))) ... i += 1 ... >>> t = tally() >>> t.send('red') Thing number 0 is red. >>> t.send('fish') Thing number 1 is fish. Without the decorator, you would have to call ``next(t)`` before ``t.send()`` could be used. """ @wraps(func) def wrapper(*args, **kwargs): gen = func(*args, **kwargs) next(gen) return gen return wrapper def ilen(iterable): """Return the number of items in *iterable*. >>> ilen(x for x in range(1000000) if x % 3 == 0) 333334 This consumes the iterable, so handle with care. """ # This approach was selected because benchmarks showed it's likely the # fastest of the known implementations at the time of writing. # See GitHub tracker: #236, #230. counter = count() deque(zip(iterable, counter), maxlen=0) return next(counter) def iterate(func, start): """Return ``start``, ``func(start)``, ``func(func(start))``, ... >>> from itertools import islice >>> list(islice(iterate(lambda x: 2*x, 1), 10)) [1, 2, 4, 8, 16, 32, 64, 128, 256, 512] """ while True: yield start try: start = func(start) except StopIteration: break def with_iter(context_manager): """Wrap an iterable in a ``with`` statement, so it closes once exhausted. For example, this will close the file when the iterator is exhausted:: upper_lines = (line.upper() for line in with_iter(open('foo'))) Any context manager which returns an iterable is a candidate for ``with_iter``. """ with context_manager as iterable: yield from iterable def one(iterable, too_short=None, too_long=None): """Return the first item from *iterable*, which is expected to contain only that item. Raise an exception if *iterable* is empty or has more than one item. :func:`one` is useful for ensuring that an iterable contains only one item. For example, it can be used to retrieve the result of a database query that is expected to return a single row. If *iterable* is empty, ``ValueError`` will be raised. You may specify a different exception with the *too_short* keyword: >>> it = [] >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too many items in iterable (expected 1)' >>> too_short = IndexError('too few items') >>> one(it, too_short=too_short) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... IndexError: too few items Similarly, if *iterable* contains more than one item, ``ValueError`` will be raised. You may specify a different exception with the *too_long* keyword: >>> it = ['too', 'many'] >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: Expected exactly one item in iterable, but got 'too', 'many', and perhaps more. >>> too_long = RuntimeError >>> one(it, too_long=too_long) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... RuntimeError Note that :func:`one` attempts to advance *iterable* twice to ensure there is only one item. See :func:`spy` or :func:`peekable` to check iterable contents less destructively. """ it = iter(iterable) try: first_value = next(it) except StopIteration as exc: raise ( too_short or ValueError('too few items in iterable (expected 1)') ) from exc try: second_value = next(it) except StopIteration: pass else: msg = ( 'Expected exactly one item in iterable, but got {!r}, {!r}, ' 'and perhaps more.'.format(first_value, second_value) ) raise too_long or ValueError(msg) return first_value def raise_(exception, *args): raise exception(*args) def strictly_n(iterable, n, too_short=None, too_long=None): """Validate that *iterable* has exactly *n* items and return them if it does. If it has fewer than *n* items, call function *too_short* with those items. If it has more than *n* items, call function *too_long* with the first ``n + 1`` items. >>> iterable = ['a', 'b', 'c', 'd'] >>> n = 4 >>> list(strictly_n(iterable, n)) ['a', 'b', 'c', 'd'] Note that the returned iterable must be consumed in order for the check to be made. By default, *too_short* and *too_long* are functions that raise ``ValueError``. >>> list(strictly_n('ab', 3)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too few items in iterable (got 2) >>> list(strictly_n('abc', 2)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: too many items in iterable (got at least 3) You can instead supply functions that do something else. *too_short* will be called with the number of items in *iterable*. *too_long* will be called with `n + 1`. >>> def too_short(item_count): ... raise RuntimeError >>> it = strictly_n('abcd', 6, too_short=too_short) >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... RuntimeError >>> def too_long(item_count): ... print('The boss is going to hear about this') >>> it = strictly_n('abcdef', 4, too_long=too_long) >>> list(it) The boss is going to hear about this ['a', 'b', 'c', 'd'] """ if too_short is None: too_short = lambda item_count: raise_( ValueError, 'Too few items in iterable (got {})'.format(item_count), ) if too_long is None: too_long = lambda item_count: raise_( ValueError, 'Too many items in iterable (got at least {})'.format(item_count), ) it = iter(iterable) for i in range(n): try: item = next(it) except StopIteration: too_short(i) return else: yield item try: next(it) except StopIteration: pass else: too_long(n + 1) def distinct_permutations(iterable, r=None): """Yield successive distinct permutations of the elements in *iterable*. >>> sorted(distinct_permutations([1, 0, 1])) [(0, 1, 1), (1, 0, 1), (1, 1, 0)] Equivalent to ``set(permutations(iterable))``, except duplicates are not generated and thrown away. For larger input sequences this is much more efficient. Duplicate permutations arise when there are duplicated elements in the input iterable. The number of items returned is `n! / (x_1! * x_2! * ... * x_n!)`, where `n` is the total number of items input, and each `x_i` is the count of a distinct item in the input sequence. If *r* is given, only the *r*-length permutations are yielded. >>> sorted(distinct_permutations([1, 0, 1], r=2)) [(0, 1), (1, 0), (1, 1)] >>> sorted(distinct_permutations(range(3), r=2)) [(0, 1), (0, 2), (1, 0), (1, 2), (2, 0), (2, 1)] """ # Algorithm: https://w.wiki/Qai def _full(A): while True: # Yield the permutation we have yield tuple(A) # Find the largest index i such that A[i] < A[i + 1] for i in range(size - 2, -1, -1): if A[i] < A[i + 1]: break # If no such index exists, this permutation is the last one else: return # Find the largest index j greater than j such that A[i] < A[j] for j in range(size - 1, i, -1): if A[i] < A[j]: break # Swap the value of A[i] with that of A[j], then reverse the # sequence from A[i + 1] to form the new permutation A[i], A[j] = A[j], A[i] A[i + 1 :] = A[: i - size : -1] # A[i + 1:][::-1] # Algorithm: modified from the above def _partial(A, r): # Split A into the first r items and the last r items head, tail = A[:r], A[r:] right_head_indexes = range(r - 1, -1, -1) left_tail_indexes = range(len(tail)) while True: # Yield the permutation we have yield tuple(head) # Starting from the right, find the first index of the head with # value smaller than the maximum value of the tail - call it i. pivot = tail[-1] for i in right_head_indexes: if head[i] < pivot: break pivot = head[i] else: return # Starting from the left, find the first value of the tail # with a value greater than head[i] and swap. for j in left_tail_indexes: if tail[j] > head[i]: head[i], tail[j] = tail[j], head[i] break # If we didn't find one, start from the right and find the first # index of the head with a value greater than head[i] and swap. else: for j in right_head_indexes: if head[j] > head[i]: head[i], head[j] = head[j], head[i] break # Reverse head[i + 1:] and swap it with tail[:r - (i + 1)] tail += head[: i - r : -1] # head[i + 1:][::-1] i += 1 head[i:], tail[:] = tail[: r - i], tail[r - i :] items = sorted(iterable) size = len(items) if r is None: r = size if 0 < r <= size: return _full(items) if (r == size) else _partial(items, r) return iter(() if r else ((),)) def intersperse(e, iterable, n=1): """Intersperse filler element *e* among the items in *iterable*, leaving *n* items between each filler element. >>> list(intersperse('!', [1, 2, 3, 4, 5])) [1, '!', 2, '!', 3, '!', 4, '!', 5] >>> list(intersperse(None, [1, 2, 3, 4, 5], n=2)) [1, 2, None, 3, 4, None, 5] """ if n == 0: raise ValueError('n must be > 0') elif n == 1: # interleave(repeat(e), iterable) -> e, x_0, e, x_1, e, x_2... # islice(..., 1, None) -> x_0, e, x_1, e, x_2... return islice(interleave(repeat(e), iterable), 1, None) else: # interleave(filler, chunks) -> [e], [x_0, x_1], [e], [x_2, x_3]... # islice(..., 1, None) -> [x_0, x_1], [e], [x_2, x_3]... # flatten(...) -> x_0, x_1, e, x_2, x_3... filler = repeat([e]) chunks = chunked(iterable, n) return flatten(islice(interleave(filler, chunks), 1, None)) def unique_to_each(*iterables): """Return the elements from each of the input iterables that aren't in the other input iterables. For example, suppose you have a set of packages, each with a set of dependencies:: {'pkg_1': {'A', 'B'}, 'pkg_2': {'B', 'C'}, 'pkg_3': {'B', 'D'}} If you remove one package, which dependencies can also be removed? If ``pkg_1`` is removed, then ``A`` is no longer necessary - it is not associated with ``pkg_2`` or ``pkg_3``. Similarly, ``C`` is only needed for ``pkg_2``, and ``D`` is only needed for ``pkg_3``:: >>> unique_to_each({'A', 'B'}, {'B', 'C'}, {'B', 'D'}) [['A'], ['C'], ['D']] If there are duplicates in one input iterable that aren't in the others they will be duplicated in the output. Input order is preserved:: >>> unique_to_each("mississippi", "missouri") [['p', 'p'], ['o', 'u', 'r']] It is assumed that the elements of each iterable are hashable. """ pool = [list(it) for it in iterables] counts = Counter(chain.from_iterable(map(set, pool))) uniques = {element for element in counts if counts[element] == 1} return [list(filter(uniques.__contains__, it)) for it in pool] def windowed(seq, n, fillvalue=None, step=1): """Return a sliding window of width *n* over the given iterable. >>> all_windows = windowed([1, 2, 3, 4, 5], 3) >>> list(all_windows) [(1, 2, 3), (2, 3, 4), (3, 4, 5)] When the window is larger than the iterable, *fillvalue* is used in place of missing values: >>> list(windowed([1, 2, 3], 4)) [(1, 2, 3, None)] Each window will advance in increments of *step*: >>> list(windowed([1, 2, 3, 4, 5, 6], 3, fillvalue='!', step=2)) [(1, 2, 3), (3, 4, 5), (5, 6, '!')] To slide into the iterable's items, use :func:`chain` to add filler items to the left: >>> iterable = [1, 2, 3, 4] >>> n = 3 >>> padding = [None] * (n - 1) >>> list(windowed(chain(padding, iterable), 3)) [(None, None, 1), (None, 1, 2), (1, 2, 3), (2, 3, 4)] """ if n < 0: raise ValueError('n must be >= 0') if n == 0: yield () return if step < 1: raise ValueError('step must be >= 1') iterable = iter(seq) # Generate first window window = deque(islice(iterable, n), maxlen=n) # Deal with the first window not being full if not window: return if len(window) < n: yield tuple(window) + ((fillvalue,) * (n - len(window))) return yield tuple(window) # Create the filler for the next windows. The padding ensures # we have just enough elements to fill the last window. padding = (fillvalue,) * (n - 1 if step >= n else step - 1) filler = map(window.append, chain(iterable, padding)) # Generate the rest of the windows for _ in islice(filler, step - 1, None, step): yield tuple(window) def substrings(iterable): """Yield all of the substrings of *iterable*. >>> [''.join(s) for s in substrings('more')] ['m', 'o', 'r', 'e', 'mo', 'or', 're', 'mor', 'ore', 'more'] Note that non-string iterables can also be subdivided. >>> list(substrings([0, 1, 2])) [(0,), (1,), (2,), (0, 1), (1, 2), (0, 1, 2)] """ # The length-1 substrings seq = [] for item in iter(iterable): seq.append(item) yield (item,) seq = tuple(seq) item_count = len(seq) # And the rest for n in range(2, item_count + 1): for i in range(item_count - n + 1): yield seq[i : i + n] def substrings_indexes(seq, reverse=False): """Yield all substrings and their positions in *seq* The items yielded will be a tuple of the form ``(substr, i, j)``, where ``substr == seq[i:j]``. This function only works for iterables that support slicing, such as ``str`` objects. >>> for item in substrings_indexes('more'): ... print(item) ('m', 0, 1) ('o', 1, 2) ('r', 2, 3) ('e', 3, 4) ('mo', 0, 2) ('or', 1, 3) ('re', 2, 4) ('mor', 0, 3) ('ore', 1, 4) ('more', 0, 4) Set *reverse* to ``True`` to yield the same items in the opposite order. """ r = range(1, len(seq) + 1) if reverse: r = reversed(r) return ( (seq[i : i + L], i, i + L) for L in r for i in range(len(seq) - L + 1) ) class bucket: """Wrap *iterable* and return an object that buckets the iterable into child iterables based on a *key* function. >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3'] >>> s = bucket(iterable, key=lambda x: x[0]) # Bucket by 1st character >>> sorted(list(s)) # Get the keys ['a', 'b', 'c'] >>> a_iterable = s['a'] >>> next(a_iterable) 'a1' >>> next(a_iterable) 'a2' >>> list(s['b']) ['b1', 'b2', 'b3'] The original iterable will be advanced and its items will be cached until they are used by the child iterables. This may require significant storage. By default, attempting to select a bucket to which no items belong will exhaust the iterable and cache all values. If you specify a *validator* function, selected buckets will instead be checked against it. >>> from itertools import count >>> it = count(1, 2) # Infinite sequence of odd numbers >>> key = lambda x: x % 10 # Bucket by last digit >>> validator = lambda x: x in {1, 3, 5, 7, 9} # Odd digits only >>> s = bucket(it, key=key, validator=validator) >>> 2 in s False >>> list(s[2]) [] """ def __init__(self, iterable, key, validator=None): self._it = iter(iterable) self._key = key self._cache = defaultdict(deque) self._validator = validator or (lambda x: True) def __contains__(self, value): if not self._validator(value): return False try: item = next(self[value]) except StopIteration: return False else: self._cache[value].appendleft(item) return True def _get_values(self, value): """ Helper to yield items from the parent iterator that match *value*. Items that don't match are stored in the local cache as they are encountered. """ while True: # If we've cached some items that match the target value, emit # the first one and evict it from the cache. if self._cache[value]: yield self._cache[value].popleft() # Otherwise we need to advance the parent iterator to search for # a matching item, caching the rest. else: while True: try: item = next(self._it) except StopIteration: return item_value = self._key(item) if item_value == value: yield item break elif self._validator(item_value): self._cache[item_value].append(item) def __iter__(self): for item in self._it: item_value = self._key(item) if self._validator(item_value): self._cache[item_value].append(item) yield from self._cache.keys() def __getitem__(self, value): if not self._validator(value): return iter(()) return self._get_values(value) def spy(iterable, n=1): """Return a 2-tuple with a list containing the first *n* elements of *iterable*, and an iterator with the same items as *iterable*. This allows you to "look ahead" at the items in the iterable without advancing it. There is one item in the list by default: >>> iterable = 'abcdefg' >>> head, iterable = spy(iterable) >>> head ['a'] >>> list(iterable) ['a', 'b', 'c', 'd', 'e', 'f', 'g'] You may use unpacking to retrieve items instead of lists: >>> (head,), iterable = spy('abcdefg') >>> head 'a' >>> (first, second), iterable = spy('abcdefg', 2) >>> first 'a' >>> second 'b' The number of items requested can be larger than the number of items in the iterable: >>> iterable = [1, 2, 3, 4, 5] >>> head, iterable = spy(iterable, 10) >>> head [1, 2, 3, 4, 5] >>> list(iterable) [1, 2, 3, 4, 5] """ it = iter(iterable) head = take(n, it) return head.copy(), chain(head, it) def interleave(*iterables): """Return a new iterable yielding from each iterable in turn, until the shortest is exhausted. >>> list(interleave([1, 2, 3], [4, 5], [6, 7, 8])) [1, 4, 6, 2, 5, 7] For a version that doesn't terminate after the shortest iterable is exhausted, see :func:`interleave_longest`. """ return chain.from_iterable(zip(*iterables)) def interleave_longest(*iterables): """Return a new iterable yielding from each iterable in turn, skipping any that are exhausted. >>> list(interleave_longest([1, 2, 3], [4, 5], [6, 7, 8])) [1, 4, 6, 2, 5, 7, 3, 8] This function produces the same output as :func:`roundrobin`, but may perform better for some inputs (in particular when the number of iterables is large). """ i = chain.from_iterable(zip_longest(*iterables, fillvalue=_marker)) return (x for x in i if x is not _marker) def interleave_evenly(iterables, lengths=None): """ Interleave multiple iterables so that their elements are evenly distributed throughout the output sequence. >>> iterables = [1, 2, 3, 4, 5], ['a', 'b'] >>> list(interleave_evenly(iterables)) [1, 2, 'a', 3, 4, 'b', 5] >>> iterables = [[1, 2, 3], [4, 5], [6, 7, 8]] >>> list(interleave_evenly(iterables)) [1, 6, 4, 2, 7, 3, 8, 5] This function requires iterables of known length. Iterables without ``__len__()`` can be used by manually specifying lengths with *lengths*: >>> from itertools import combinations, repeat >>> iterables = [combinations(range(4), 2), ['a', 'b', 'c']] >>> lengths = [4 * (4 - 1) // 2, 3] >>> list(interleave_evenly(iterables, lengths=lengths)) [(0, 1), (0, 2), 'a', (0, 3), (1, 2), 'b', (1, 3), (2, 3), 'c'] Based on Bresenham's algorithm. """ if lengths is None: try: lengths = [len(it) for it in iterables] except TypeError: raise ValueError( 'Iterable lengths could not be determined automatically. ' 'Specify them with the lengths keyword.' ) elif len(iterables) != len(lengths): raise ValueError('Mismatching number of iterables and lengths.') dims = len(lengths) # sort iterables by length, descending lengths_permute = sorted( range(dims), key=lambda i: lengths[i], reverse=True ) lengths_desc = [lengths[i] for i in lengths_permute] iters_desc = [iter(iterables[i]) for i in lengths_permute] # the longest iterable is the primary one (Bresenham: the longest # distance along an axis) delta_primary, deltas_secondary = lengths_desc[0], lengths_desc[1:] iter_primary, iters_secondary = iters_desc[0], iters_desc[1:] errors = [delta_primary // dims] * len(deltas_secondary) to_yield = sum(lengths) while to_yield: yield next(iter_primary) to_yield -= 1 # update errors for each secondary iterable errors = [e - delta for e, delta in zip(errors, deltas_secondary)] # those iterables for which the error is negative are yielded # ("diagonal step" in Bresenham) for i, e_ in enumerate(errors): if e_ < 0: yield next(iters_secondary[i]) to_yield -= 1 errors[i] += delta_primary def collapse(iterable, base_type=None, levels=None): """Flatten an iterable with multiple levels of nesting (e.g., a list of lists of tuples) into non-iterable types. >>> iterable = [(1, 2), ([3, 4], [[5], [6]])] >>> list(collapse(iterable)) [1, 2, 3, 4, 5, 6] Binary and text strings are not considered iterable and will not be collapsed. To avoid collapsing other types, specify *base_type*: >>> iterable = ['ab', ('cd', 'ef'), ['gh', 'ij']] >>> list(collapse(iterable, base_type=tuple)) ['ab', ('cd', 'ef'), 'gh', 'ij'] Specify *levels* to stop flattening after a certain level: >>> iterable = [('a', ['b']), ('c', ['d'])] >>> list(collapse(iterable)) # Fully flattened ['a', 'b', 'c', 'd'] >>> list(collapse(iterable, levels=1)) # Only one level flattened ['a', ['b'], 'c', ['d']] """ stack = deque() # Add our first node group, treat the iterable as a single node stack.appendleft((0, repeat(iterable, 1))) while stack: node_group = stack.popleft() level, nodes = node_group # Check if beyond max level if levels is not None and level > levels: yield from nodes continue for node in nodes: # Check if done iterating if isinstance(node, (str, bytes)) or ( (base_type is not None) and isinstance(node, base_type) ): yield node # Otherwise try to create child nodes else: try: tree = iter(node) except TypeError: yield node else: # Save our current location stack.appendleft(node_group) # Append the new child node stack.appendleft((level + 1, tree)) # Break to process child node break def side_effect(func, iterable, chunk_size=None, before=None, after=None): """Invoke *func* on each item in *iterable* (or on each *chunk_size* group of items) before yielding the item. `func` must be a function that takes a single argument. Its return value will be discarded. *before* and *after* are optional functions that take no arguments. They will be executed before iteration starts and after it ends, respectively. `side_effect` can be used for logging, updating progress bars, or anything that is not functionally "pure." Emitting a status message: >>> from more_itertools import consume >>> func = lambda item: print('Received {}'.format(item)) >>> consume(side_effect(func, range(2))) Received 0 Received 1 Operating on chunks of items: >>> pair_sums = [] >>> func = lambda chunk: pair_sums.append(sum(chunk)) >>> list(side_effect(func, [0, 1, 2, 3, 4, 5], 2)) [0, 1, 2, 3, 4, 5] >>> list(pair_sums) [1, 5, 9] Writing to a file-like object: >>> from io import StringIO >>> from more_itertools import consume >>> f = StringIO() >>> func = lambda x: print(x, file=f) >>> before = lambda: print(u'HEADER', file=f) >>> after = f.close >>> it = [u'a', u'b', u'c'] >>> consume(side_effect(func, it, before=before, after=after)) >>> f.closed True """ try: if before is not None: before() if chunk_size is None: for item in iterable: func(item) yield item else: for chunk in chunked(iterable, chunk_size): func(chunk) yield from chunk finally: if after is not None: after() def sliced(seq, n, strict=False): """Yield slices of length *n* from the sequence *seq*. >>> list(sliced((1, 2, 3, 4, 5, 6), 3)) [(1, 2, 3), (4, 5, 6)] By the default, the last yielded slice will have fewer than *n* elements if the length of *seq* is not divisible by *n*: >>> list(sliced((1, 2, 3, 4, 5, 6, 7, 8), 3)) [(1, 2, 3), (4, 5, 6), (7, 8)] If the length of *seq* is not divisible by *n* and *strict* is ``True``, then ``ValueError`` will be raised before the last slice is yielded. This function will only work for iterables that support slicing. For non-sliceable iterables, see :func:`chunked`. """ iterator = takewhile(len, (seq[i : i + n] for i in count(0, n))) if strict: def ret(): for _slice in iterator: if len(_slice) != n: raise ValueError("seq is not divisible by n.") yield _slice return iter(ret()) else: return iterator def split_at(iterable, pred, maxsplit=-1, keep_separator=False): """Yield lists of items from *iterable*, where each list is delimited by an item where callable *pred* returns ``True``. >>> list(split_at('abcdcba', lambda x: x == 'b')) [['a'], ['c', 'd', 'c'], ['a']] >>> list(split_at(range(10), lambda n: n % 2 == 1)) [[0], [2], [4], [6], [8], []] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_at(range(10), lambda n: n % 2 == 1, maxsplit=2)) [[0], [2], [4, 5, 6, 7, 8, 9]] By default, the delimiting items are not included in the output. To include them, set *keep_separator* to ``True``. >>> list(split_at('abcdcba', lambda x: x == 'b', keep_separator=True)) [['a'], ['b'], ['c', 'd', 'c'], ['b'], ['a']] """ if maxsplit == 0: yield list(iterable) return buf = [] it = iter(iterable) for item in it: if pred(item): yield buf if keep_separator: yield [item] if maxsplit == 1: yield list(it) return buf = [] maxsplit -= 1 else: buf.append(item) yield buf def split_before(iterable, pred, maxsplit=-1): """Yield lists of items from *iterable*, where each list ends just before an item for which callable *pred* returns ``True``: >>> list(split_before('OneTwo', lambda s: s.isupper())) [['O', 'n', 'e'], ['T', 'w', 'o']] >>> list(split_before(range(10), lambda n: n % 3 == 0)) [[0, 1, 2], [3, 4, 5], [6, 7, 8], [9]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_before(range(10), lambda n: n % 3 == 0, maxsplit=2)) [[0, 1, 2], [3, 4, 5], [6, 7, 8, 9]] """ if maxsplit == 0: yield list(iterable) return buf = [] it = iter(iterable) for item in it: if pred(item) and buf: yield buf if maxsplit == 1: yield [item] + list(it) return buf = [] maxsplit -= 1 buf.append(item) if buf: yield buf def split_after(iterable, pred, maxsplit=-1): """Yield lists of items from *iterable*, where each list ends with an item where callable *pred* returns ``True``: >>> list(split_after('one1two2', lambda s: s.isdigit())) [['o', 'n', 'e', '1'], ['t', 'w', 'o', '2']] >>> list(split_after(range(10), lambda n: n % 3 == 0)) [[0], [1, 2, 3], [4, 5, 6], [7, 8, 9]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_after(range(10), lambda n: n % 3 == 0, maxsplit=2)) [[0], [1, 2, 3], [4, 5, 6, 7, 8, 9]] """ if maxsplit == 0: yield list(iterable) return buf = [] it = iter(iterable) for item in it: buf.append(item) if pred(item) and buf: yield buf if maxsplit == 1: buf = list(it) if buf: yield buf return buf = [] maxsplit -= 1 if buf: yield buf def split_when(iterable, pred, maxsplit=-1): """Split *iterable* into pieces based on the output of *pred*. *pred* should be a function that takes successive pairs of items and returns ``True`` if the iterable should be split in between them. For example, to find runs of increasing numbers, split the iterable when element ``i`` is larger than element ``i + 1``: >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], lambda x, y: x > y)) [[1, 2, 3, 3], [2, 5], [2, 4], [2]] At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, then there is no limit on the number of splits: >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], ... lambda x, y: x > y, maxsplit=2)) [[1, 2, 3, 3], [2, 5], [2, 4, 2]] """ if maxsplit == 0: yield list(iterable) return it = iter(iterable) try: cur_item = next(it) except StopIteration: return buf = [cur_item] for next_item in it: if pred(cur_item, next_item): yield buf if maxsplit == 1: yield [next_item] + list(it) return buf = [] maxsplit -= 1 buf.append(next_item) cur_item = next_item yield buf def split_into(iterable, sizes): """Yield a list of sequential items from *iterable* of length 'n' for each integer 'n' in *sizes*. >>> list(split_into([1,2,3,4,5,6], [1,2,3])) [[1], [2, 3], [4, 5, 6]] If the sum of *sizes* is smaller than the length of *iterable*, then the remaining items of *iterable* will not be returned. >>> list(split_into([1,2,3,4,5,6], [2,3])) [[1, 2], [3, 4, 5]] If the sum of *sizes* is larger than the length of *iterable*, fewer items will be returned in the iteration that overruns *iterable* and further lists will be empty: >>> list(split_into([1,2,3,4], [1,2,3,4])) [[1], [2, 3], [4], []] When a ``None`` object is encountered in *sizes*, the returned list will contain items up to the end of *iterable* the same way that itertools.slice does: >>> list(split_into([1,2,3,4,5,6,7,8,9,0], [2,3,None])) [[1, 2], [3, 4, 5], [6, 7, 8, 9, 0]] :func:`split_into` can be useful for grouping a series of items where the sizes of the groups are not uniform. An example would be where in a row from a table, multiple columns represent elements of the same feature (e.g. a point represented by x,y,z) but, the format is not the same for all columns. """ # convert the iterable argument into an iterator so its contents can # be consumed by islice in case it is a generator it = iter(iterable) for size in sizes: if size is None: yield list(it) return else: yield list(islice(it, size)) def padded(iterable, fillvalue=None, n=None, next_multiple=False): """Yield the elements from *iterable*, followed by *fillvalue*, such that at least *n* items are emitted. >>> list(padded([1, 2, 3], '?', 5)) [1, 2, 3, '?', '?'] If *next_multiple* is ``True``, *fillvalue* will be emitted until the number of items emitted is a multiple of *n*: >>> list(padded([1, 2, 3, 4], n=3, next_multiple=True)) [1, 2, 3, 4, None, None] If *n* is ``None``, *fillvalue* will be emitted indefinitely. To create an *iterable* of exactly size *n*, you can truncate with :func:`islice`. >>> list(islice(padded([1, 2, 3], '?'), 5)) [1, 2, 3, '?', '?'] >>> list(islice(padded([1, 2, 3, 4, 5, 6, 7, 8], '?'), 5)) [1, 2, 3, 4, 5] """ iterable = iter(iterable) iterable_with_repeat = chain(iterable, repeat(fillvalue)) if n is None: return iterable_with_repeat elif n < 1: raise ValueError('n must be at least 1') elif next_multiple: def slice_generator(): for first in iterable: yield (first,) yield islice(iterable_with_repeat, n - 1) # While elements exist produce slices of size n return chain.from_iterable(slice_generator()) else: # Ensure the first batch is at least size n then iterate return chain(islice(iterable_with_repeat, n), iterable) def repeat_each(iterable, n=2): """Repeat each element in *iterable* *n* times. >>> list(repeat_each('ABC', 3)) ['A', 'A', 'A', 'B', 'B', 'B', 'C', 'C', 'C'] """ return chain.from_iterable(map(repeat, iterable, repeat(n))) def repeat_last(iterable, default=None): """After the *iterable* is exhausted, keep yielding its last element. >>> list(islice(repeat_last(range(3)), 5)) [0, 1, 2, 2, 2] If the iterable is empty, yield *default* forever:: >>> list(islice(repeat_last(range(0), 42), 5)) [42, 42, 42, 42, 42] """ item = _marker for item in iterable: yield item final = default if item is _marker else item yield from repeat(final) def distribute(n, iterable): """Distribute the items from *iterable* among *n* smaller iterables. >>> group_1, group_2 = distribute(2, [1, 2, 3, 4, 5, 6]) >>> list(group_1) [1, 3, 5] >>> list(group_2) [2, 4, 6] If the length of *iterable* is not evenly divisible by *n*, then the length of the returned iterables will not be identical: >>> children = distribute(3, [1, 2, 3, 4, 5, 6, 7]) >>> [list(c) for c in children] [[1, 4, 7], [2, 5], [3, 6]] If the length of *iterable* is smaller than *n*, then the last returned iterables will be empty: >>> children = distribute(5, [1, 2, 3]) >>> [list(c) for c in children] [[1], [2], [3], [], []] This function uses :func:`itertools.tee` and may require significant storage. If you need the order items in the smaller iterables to match the original iterable, see :func:`divide`. """ if n < 1: raise ValueError('n must be at least 1') children = tee(iterable, n) return [islice(it, index, None, n) for index, it in enumerate(children)] def stagger(iterable, offsets=(-1, 0, 1), longest=False, fillvalue=None): """Yield tuples whose elements are offset from *iterable*. The amount by which the `i`-th item in each tuple is offset is given by the `i`-th item in *offsets*. >>> list(stagger([0, 1, 2, 3])) [(None, 0, 1), (0, 1, 2), (1, 2, 3)] >>> list(stagger(range(8), offsets=(0, 2, 4))) [(0, 2, 4), (1, 3, 5), (2, 4, 6), (3, 5, 7)] By default, the sequence will end when the final element of a tuple is the last item in the iterable. To continue until the first element of a tuple is the last item in the iterable, set *longest* to ``True``:: >>> list(stagger([0, 1, 2, 3], longest=True)) [(None, 0, 1), (0, 1, 2), (1, 2, 3), (2, 3, None), (3, None, None)] By default, ``None`` will be used to replace offsets beyond the end of the sequence. Specify *fillvalue* to use some other value. """ children = tee(iterable, len(offsets)) return zip_offset( *children, offsets=offsets, longest=longest, fillvalue=fillvalue ) def zip_equal(*iterables): """``zip`` the input *iterables* together, but raise ``UnequalIterablesError`` if they aren't all the same length. >>> it_1 = range(3) >>> it_2 = iter('abc') >>> list(zip_equal(it_1, it_2)) [(0, 'a'), (1, 'b'), (2, 'c')] >>> it_1 = range(3) >>> it_2 = iter('abcd') >>> list(zip_equal(it_1, it_2)) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... more_itertools.more.UnequalIterablesError: Iterables have different lengths """ if hexversion >= 0x30A00A6: warnings.warn( ( 'zip_equal will be removed in a future version of ' 'more-itertools. Use the builtin zip function with ' 'strict=True instead.' ), DeprecationWarning, ) return _zip_equal(*iterables) def zip_offset(*iterables, offsets, longest=False, fillvalue=None): """``zip`` the input *iterables* together, but offset the `i`-th iterable by the `i`-th item in *offsets*. >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1))) [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e')] This can be used as a lightweight alternative to SciPy or pandas to analyze data sets in which some series have a lead or lag relationship. By default, the sequence will end when the shortest iterable is exhausted. To continue until the longest iterable is exhausted, set *longest* to ``True``. >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1), longest=True)) [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e'), (None, 'f')] By default, ``None`` will be used to replace offsets beyond the end of the sequence. Specify *fillvalue* to use some other value. """ if len(iterables) != len(offsets): raise ValueError("Number of iterables and offsets didn't match") staggered = [] for it, n in zip(iterables, offsets): if n < 0: staggered.append(chain(repeat(fillvalue, -n), it)) elif n > 0: staggered.append(islice(it, n, None)) else: staggered.append(it) if longest: return zip_longest(*staggered, fillvalue=fillvalue) return zip(*staggered) def sort_together(iterables, key_list=(0,), key=None, reverse=False): """Return the input iterables sorted together, with *key_list* as the priority for sorting. All iterables are trimmed to the length of the shortest one. This can be used like the sorting function in a spreadsheet. If each iterable represents a column of data, the key list determines which columns are used for sorting. By default, all iterables are sorted using the ``0``-th iterable:: >>> iterables = [(4, 3, 2, 1), ('a', 'b', 'c', 'd')] >>> sort_together(iterables) [(1, 2, 3, 4), ('d', 'c', 'b', 'a')] Set a different key list to sort according to another iterable. Specifying multiple keys dictates how ties are broken:: >>> iterables = [(3, 1, 2), (0, 1, 0), ('c', 'b', 'a')] >>> sort_together(iterables, key_list=(1, 2)) [(2, 3, 1), (0, 0, 1), ('a', 'c', 'b')] To sort by a function of the elements of the iterable, pass a *key* function. Its arguments are the elements of the iterables corresponding to the key list:: >>> names = ('a', 'b', 'c') >>> lengths = (1, 2, 3) >>> widths = (5, 2, 1) >>> def area(length, width): ... return length * width >>> sort_together([names, lengths, widths], key_list=(1, 2), key=area) [('c', 'b', 'a'), (3, 2, 1), (1, 2, 5)] Set *reverse* to ``True`` to sort in descending order. >>> sort_together([(1, 2, 3), ('c', 'b', 'a')], reverse=True) [(3, 2, 1), ('a', 'b', 'c')] """ if key is None: # if there is no key function, the key argument to sorted is an # itemgetter key_argument = itemgetter(*key_list) else: # if there is a key function, call it with the items at the offsets # specified by the key function as arguments key_list = list(key_list) if len(key_list) == 1: # if key_list contains a single item, pass the item at that offset # as the only argument to the key function key_offset = key_list[0] key_argument = lambda zipped_items: key(zipped_items[key_offset]) else: # if key_list contains multiple items, use itemgetter to return a # tuple of items, which we pass as *args to the key function get_key_items = itemgetter(*key_list) key_argument = lambda zipped_items: key( *get_key_items(zipped_items) ) return list( zip(*sorted(zip(*iterables), key=key_argument, reverse=reverse)) ) def unzip(iterable): """The inverse of :func:`zip`, this function disaggregates the elements of the zipped *iterable*. The ``i``-th iterable contains the ``i``-th element from each element of the zipped iterable. The first element is used to determine the length of the remaining elements. >>> iterable = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] >>> letters, numbers = unzip(iterable) >>> list(letters) ['a', 'b', 'c', 'd'] >>> list(numbers) [1, 2, 3, 4] This is similar to using ``zip(*iterable)``, but it avoids reading *iterable* into memory. Note, however, that this function uses :func:`itertools.tee` and thus may require significant storage. """ head, iterable = spy(iter(iterable)) if not head: # empty iterable, e.g. zip([], [], []) return () # spy returns a one-length iterable as head head = head[0] iterables = tee(iterable, len(head)) def itemgetter(i): def getter(obj): try: return obj[i] except IndexError: # basically if we have an iterable like # iter([(1, 2, 3), (4, 5), (6,)]) # the second unzipped iterable would fail at the third tuple # since it would try to access tup[1] # same with the third unzipped iterable and the second tuple # to support these "improperly zipped" iterables, # we create a custom itemgetter # which just stops the unzipped iterables # at first length mismatch raise StopIteration return getter return tuple(map(itemgetter(i), it) for i, it in enumerate(iterables)) def divide(n, iterable): """Divide the elements from *iterable* into *n* parts, maintaining order. >>> group_1, group_2 = divide(2, [1, 2, 3, 4, 5, 6]) >>> list(group_1) [1, 2, 3] >>> list(group_2) [4, 5, 6] If the length of *iterable* is not evenly divisible by *n*, then the length of the returned iterables will not be identical: >>> children = divide(3, [1, 2, 3, 4, 5, 6, 7]) >>> [list(c) for c in children] [[1, 2, 3], [4, 5], [6, 7]] If the length of the iterable is smaller than n, then the last returned iterables will be empty: >>> children = divide(5, [1, 2, 3]) >>> [list(c) for c in children] [[1], [2], [3], [], []] This function will exhaust the iterable before returning. If order is not important, see :func:`distribute`, which does not first pull the iterable into memory. """ if n < 1: raise ValueError('n must be at least 1') try: iterable[:0] except TypeError: seq = tuple(iterable) else: seq = iterable q, r = divmod(len(seq), n) ret = [] stop = 0 for i in range(1, n + 1): start = stop stop += q + 1 if i <= r else q ret.append(iter(seq[start:stop])) return ret def always_iterable(obj, base_type=(str, bytes)): """If *obj* is iterable, return an iterator over its items:: >>> obj = (1, 2, 3) >>> list(always_iterable(obj)) [1, 2, 3] If *obj* is not iterable, return a one-item iterable containing *obj*:: >>> obj = 1 >>> list(always_iterable(obj)) [1] If *obj* is ``None``, return an empty iterable: >>> obj = None >>> list(always_iterable(None)) [] By default, binary and text strings are not considered iterable:: >>> obj = 'foo' >>> list(always_iterable(obj)) ['foo'] If *base_type* is set, objects for which ``isinstance(obj, base_type)`` returns ``True`` won't be considered iterable. >>> obj = {'a': 1} >>> list(always_iterable(obj)) # Iterate over the dict's keys ['a'] >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit [{'a': 1}] Set *base_type* to ``None`` to avoid any special handling and treat objects Python considers iterable as iterable: >>> obj = 'foo' >>> list(always_iterable(obj, base_type=None)) ['f', 'o', 'o'] """ if obj is None: return iter(()) if (base_type is not None) and isinstance(obj, base_type): return iter((obj,)) try: return iter(obj) except TypeError: return iter((obj,)) def adjacent(predicate, iterable, distance=1): """Return an iterable over `(bool, item)` tuples where the `item` is drawn from *iterable* and the `bool` indicates whether that item satisfies the *predicate* or is adjacent to an item that does. For example, to find whether items are adjacent to a ``3``:: >>> list(adjacent(lambda x: x == 3, range(6))) [(False, 0), (False, 1), (True, 2), (True, 3), (True, 4), (False, 5)] Set *distance* to change what counts as adjacent. For example, to find whether items are two places away from a ``3``: >>> list(adjacent(lambda x: x == 3, range(6), distance=2)) [(False, 0), (True, 1), (True, 2), (True, 3), (True, 4), (True, 5)] This is useful for contextualizing the results of a search function. For example, a code comparison tool might want to identify lines that have changed, but also surrounding lines to give the viewer of the diff context. The predicate function will only be called once for each item in the iterable. See also :func:`groupby_transform`, which can be used with this function to group ranges of items with the same `bool` value. """ # Allow distance=0 mainly for testing that it reproduces results with map() if distance < 0: raise ValueError('distance must be at least 0') i1, i2 = tee(iterable) padding = [False] * distance selected = chain(padding, map(predicate, i1), padding) adjacent_to_selected = map(any, windowed(selected, 2 * distance + 1)) return zip(adjacent_to_selected, i2) def groupby_transform(iterable, keyfunc=None, valuefunc=None, reducefunc=None): """An extension of :func:`itertools.groupby` that can apply transformations to the grouped data. * *keyfunc* is a function computing a key value for each item in *iterable* * *valuefunc* is a function that transforms the individual items from *iterable* after grouping * *reducefunc* is a function that transforms each group of items >>> iterable = 'aAAbBBcCC' >>> keyfunc = lambda k: k.upper() >>> valuefunc = lambda v: v.lower() >>> reducefunc = lambda g: ''.join(g) >>> list(groupby_transform(iterable, keyfunc, valuefunc, reducefunc)) [('A', 'aaa'), ('B', 'bbb'), ('C', 'ccc')] Each optional argument defaults to an identity function if not specified. :func:`groupby_transform` is useful when grouping elements of an iterable using a separate iterable as the key. To do this, :func:`zip` the iterables and pass a *keyfunc* that extracts the first element and a *valuefunc* that extracts the second element:: >>> from operator import itemgetter >>> keys = [0, 0, 1, 1, 1, 2, 2, 2, 3] >>> values = 'abcdefghi' >>> iterable = zip(keys, values) >>> grouper = groupby_transform(iterable, itemgetter(0), itemgetter(1)) >>> [(k, ''.join(g)) for k, g in grouper] [(0, 'ab'), (1, 'cde'), (2, 'fgh'), (3, 'i')] Note that the order of items in the iterable is significant. Only adjacent items are grouped together, so if you don't want any duplicate groups, you should sort the iterable by the key function. """ ret = groupby(iterable, keyfunc) if valuefunc: ret = ((k, map(valuefunc, g)) for k, g in ret) if reducefunc: ret = ((k, reducefunc(g)) for k, g in ret) return ret class numeric_range(abc.Sequence, abc.Hashable): """An extension of the built-in ``range()`` function whose arguments can be any orderable numeric type. With only *stop* specified, *start* defaults to ``0`` and *step* defaults to ``1``. The output items will match the type of *stop*: >>> list(numeric_range(3.5)) [0.0, 1.0, 2.0, 3.0] With only *start* and *stop* specified, *step* defaults to ``1``. The output items will match the type of *start*: >>> from decimal import Decimal >>> start = Decimal('2.1') >>> stop = Decimal('5.1') >>> list(numeric_range(start, stop)) [Decimal('2.1'), Decimal('3.1'), Decimal('4.1')] With *start*, *stop*, and *step* specified the output items will match the type of ``start + step``: >>> from fractions import Fraction >>> start = Fraction(1, 2) # Start at 1/2 >>> stop = Fraction(5, 2) # End at 5/2 >>> step = Fraction(1, 2) # Count by 1/2 >>> list(numeric_range(start, stop, step)) [Fraction(1, 2), Fraction(1, 1), Fraction(3, 2), Fraction(2, 1)] If *step* is zero, ``ValueError`` is raised. Negative steps are supported: >>> list(numeric_range(3, -1, -1.0)) [3.0, 2.0, 1.0, 0.0] Be aware of the limitations of floating point numbers; the representation of the yielded numbers may be surprising. ``datetime.datetime`` objects can be used for *start* and *stop*, if *step* is a ``datetime.timedelta`` object: >>> import datetime >>> start = datetime.datetime(2019, 1, 1) >>> stop = datetime.datetime(2019, 1, 3) >>> step = datetime.timedelta(days=1) >>> items = iter(numeric_range(start, stop, step)) >>> next(items) datetime.datetime(2019, 1, 1, 0, 0) >>> next(items) datetime.datetime(2019, 1, 2, 0, 0) """ _EMPTY_HASH = hash(range(0, 0)) def __init__(self, *args): argc = len(args) if argc == 1: (self._stop,) = args self._start = type(self._stop)(0) self._step = type(self._stop - self._start)(1) elif argc == 2: self._start, self._stop = args self._step = type(self._stop - self._start)(1) elif argc == 3: self._start, self._stop, self._step = args elif argc == 0: raise TypeError( 'numeric_range expected at least ' '1 argument, got {}'.format(argc) ) else: raise TypeError( 'numeric_range expected at most ' '3 arguments, got {}'.format(argc) ) self._zero = type(self._step)(0) if self._step == self._zero: raise ValueError('numeric_range() arg 3 must not be zero') self._growing = self._step > self._zero def __bool__(self): if self._growing: return self._start < self._stop else: return self._start > self._stop def __contains__(self, elem): if self._growing: if self._start <= elem < self._stop: return (elem - self._start) % self._step == self._zero else: if self._start >= elem > self._stop: return (self._start - elem) % (-self._step) == self._zero return False def __eq__(self, other): if isinstance(other, numeric_range): empty_self = not bool(self) empty_other = not bool(other) if empty_self or empty_other: return empty_self and empty_other # True if both empty else: return ( self._start == other._start and self._step == other._step and self._get_by_index(-1) == other._get_by_index(-1) ) else: return False def __getitem__(self, key): if isinstance(key, int): return self._get_by_index(key) elif isinstance(key, slice): step = self._step if key.step is None else key.step * self._step if key.start is None or key.start <= -self._len: start = self._start elif key.start >= self._len: start = self._stop else: # -self._len < key.start < self._len start = self._get_by_index(key.start) if key.stop is None or key.stop >= self._len: stop = self._stop elif key.stop <= -self._len: stop = self._start else: # -self._len < key.stop < self._len stop = self._get_by_index(key.stop) return numeric_range(start, stop, step) else: raise TypeError( 'numeric range indices must be ' 'integers or slices, not {}'.format(type(key).__name__) ) def __hash__(self): if self: return hash((self._start, self._get_by_index(-1), self._step)) else: return self._EMPTY_HASH def __iter__(self): values = (self._start + (n * self._step) for n in count()) if self._growing: return takewhile(partial(gt, self._stop), values) else: return takewhile(partial(lt, self._stop), values) def __len__(self): return self._len @cached_property def _len(self): if self._growing: start = self._start stop = self._stop step = self._step else: start = self._stop stop = self._start step = -self._step distance = stop - start if distance <= self._zero: return 0 else: # distance > 0 and step > 0: regular euclidean division q, r = divmod(distance, step) return int(q) + int(r != self._zero) def __reduce__(self): return numeric_range, (self._start, self._stop, self._step) def __repr__(self): if self._step == 1: return "numeric_range({}, {})".format( repr(self._start), repr(self._stop) ) else: return "numeric_range({}, {}, {})".format( repr(self._start), repr(self._stop), repr(self._step) ) def __reversed__(self): return iter( numeric_range( self._get_by_index(-1), self._start - self._step, -self._step ) ) def count(self, value): return int(value in self) def index(self, value): if self._growing: if self._start <= value < self._stop: q, r = divmod(value - self._start, self._step) if r == self._zero: return int(q) else: if self._start >= value > self._stop: q, r = divmod(self._start - value, -self._step) if r == self._zero: return int(q) raise ValueError("{} is not in numeric range".format(value)) def _get_by_index(self, i): if i < 0: i += self._len if i < 0 or i >= self._len: raise IndexError("numeric range object index out of range") return self._start + i * self._step def count_cycle(iterable, n=None): """Cycle through the items from *iterable* up to *n* times, yielding the number of completed cycles along with each item. If *n* is omitted the process repeats indefinitely. >>> list(count_cycle('AB', 3)) [(0, 'A'), (0, 'B'), (1, 'A'), (1, 'B'), (2, 'A'), (2, 'B')] """ iterable = tuple(iterable) if not iterable: return iter(()) counter = count() if n is None else range(n) return ((i, item) for i in counter for item in iterable) def mark_ends(iterable): """Yield 3-tuples of the form ``(is_first, is_last, item)``. >>> list(mark_ends('ABC')) [(True, False, 'A'), (False, False, 'B'), (False, True, 'C')] Use this when looping over an iterable to take special action on its first and/or last items: >>> iterable = ['Header', 100, 200, 'Footer'] >>> total = 0 >>> for is_first, is_last, item in mark_ends(iterable): ... if is_first: ... continue # Skip the header ... if is_last: ... continue # Skip the footer ... total += item >>> print(total) 300 """ it = iter(iterable) try: b = next(it) except StopIteration: return try: for i in count(): a = b b = next(it) yield i == 0, False, a except StopIteration: yield i == 0, True, a def locate(iterable, pred=bool, window_size=None): """Yield the index of each item in *iterable* for which *pred* returns ``True``. *pred* defaults to :func:`bool`, which will select truthy items: >>> list(locate([0, 1, 1, 0, 1, 0, 0])) [1, 2, 4] Set *pred* to a custom function to, e.g., find the indexes for a particular item. >>> list(locate(['a', 'b', 'c', 'b'], lambda x: x == 'b')) [1, 3] If *window_size* is given, then the *pred* function will be called with that many items. This enables searching for sub-sequences: >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] >>> pred = lambda *args: args == (1, 2, 3) >>> list(locate(iterable, pred=pred, window_size=3)) [1, 5, 9] Use with :func:`seekable` to find indexes and then retrieve the associated items: >>> from itertools import count >>> from more_itertools import seekable >>> source = (3 * n + 1 if (n % 2) else n // 2 for n in count()) >>> it = seekable(source) >>> pred = lambda x: x > 100 >>> indexes = locate(it, pred=pred) >>> i = next(indexes) >>> it.seek(i) >>> next(it) 106 """ if window_size is None: return compress(count(), map(pred, iterable)) if window_size < 1: raise ValueError('window size must be at least 1') it = windowed(iterable, window_size, fillvalue=_marker) return compress(count(), starmap(pred, it)) def longest_common_prefix(iterables): """Yield elements of the longest common prefix amongst given *iterables*. >>> ''.join(longest_common_prefix(['abcd', 'abc', 'abf'])) 'ab' """ return (c[0] for c in takewhile(all_equal, zip(*iterables))) def lstrip(iterable, pred): """Yield the items from *iterable*, but strip any from the beginning for which *pred* returns ``True``. For example, to remove a set of items from the start of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(lstrip(iterable, pred)) [1, 2, None, 3, False, None] This function is analogous to to :func:`str.lstrip`, and is essentially an wrapper for :func:`itertools.dropwhile`. """ return dropwhile(pred, iterable) def rstrip(iterable, pred): """Yield the items from *iterable*, but strip any from the end for which *pred* returns ``True``. For example, to remove a set of items from the end of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(rstrip(iterable, pred)) [None, False, None, 1, 2, None, 3] This function is analogous to :func:`str.rstrip`. """ cache = [] cache_append = cache.append cache_clear = cache.clear for x in iterable: if pred(x): cache_append(x) else: yield from cache cache_clear() yield x def strip(iterable, pred): """Yield the items from *iterable*, but strip any from the beginning and end for which *pred* returns ``True``. For example, to remove a set of items from both ends of an iterable: >>> iterable = (None, False, None, 1, 2, None, 3, False, None) >>> pred = lambda x: x in {None, False, ''} >>> list(strip(iterable, pred)) [1, 2, None, 3] This function is analogous to :func:`str.strip`. """ return rstrip(lstrip(iterable, pred), pred) class islice_extended: """An extension of :func:`itertools.islice` that supports negative values for *stop*, *start*, and *step*. >>> iterable = iter('abcdefgh') >>> list(islice_extended(iterable, -4, -1)) ['e', 'f', 'g'] Slices with negative values require some caching of *iterable*, but this function takes care to minimize the amount of memory required. For example, you can use a negative step with an infinite iterator: >>> from itertools import count >>> list(islice_extended(count(), 110, 99, -2)) [110, 108, 106, 104, 102, 100] You can also use slice notation directly: >>> iterable = map(str, count()) >>> it = islice_extended(iterable)[10:20:2] >>> list(it) ['10', '12', '14', '16', '18'] """ def __init__(self, iterable, *args): it = iter(iterable) if args: self._iterable = _islice_helper(it, slice(*args)) else: self._iterable = it def __iter__(self): return self def __next__(self): return next(self._iterable) def __getitem__(self, key): if isinstance(key, slice): return islice_extended(_islice_helper(self._iterable, key)) raise TypeError('islice_extended.__getitem__ argument must be a slice') def _islice_helper(it, s): start = s.start stop = s.stop if s.step == 0: raise ValueError('step argument must be a non-zero integer or None.') step = s.step or 1 if step > 0: start = 0 if (start is None) else start if start < 0: # Consume all but the last -start items cache = deque(enumerate(it, 1), maxlen=-start) len_iter = cache[-1][0] if cache else 0 # Adjust start to be positive i = max(len_iter + start, 0) # Adjust stop to be positive if stop is None: j = len_iter elif stop >= 0: j = min(stop, len_iter) else: j = max(len_iter + stop, 0) # Slice the cache n = j - i if n <= 0: return for index, item in islice(cache, 0, n, step): yield item elif (stop is not None) and (stop < 0): # Advance to the start position next(islice(it, start, start), None) # When stop is negative, we have to carry -stop items while # iterating cache = deque(islice(it, -stop), maxlen=-stop) for index, item in enumerate(it): cached_item = cache.popleft() if index % step == 0: yield cached_item cache.append(item) else: # When both start and stop are positive we have the normal case yield from islice(it, start, stop, step) else: start = -1 if (start is None) else start if (stop is not None) and (stop < 0): # Consume all but the last items n = -stop - 1 cache = deque(enumerate(it, 1), maxlen=n) len_iter = cache[-1][0] if cache else 0 # If start and stop are both negative they are comparable and # we can just slice. Otherwise we can adjust start to be negative # and then slice. if start < 0: i, j = start, stop else: i, j = min(start - len_iter, -1), None for index, item in list(cache)[i:j:step]: yield item else: # Advance to the stop position if stop is not None: m = stop + 1 next(islice(it, m, m), None) # stop is positive, so if start is negative they are not comparable # and we need the rest of the items. if start < 0: i = start n = None # stop is None and start is positive, so we just need items up to # the start index. elif stop is None: i = None n = start + 1 # Both stop and start are positive, so they are comparable. else: i = None n = start - stop if n <= 0: return cache = list(islice(it, n)) yield from cache[i::step] def always_reversible(iterable): """An extension of :func:`reversed` that supports all iterables, not just those which implement the ``Reversible`` or ``Sequence`` protocols. >>> print(*always_reversible(x for x in range(3))) 2 1 0 If the iterable is already reversible, this function returns the result of :func:`reversed()`. If the iterable is not reversible, this function will cache the remaining items in the iterable and yield them in reverse order, which may require significant storage. """ try: return reversed(iterable) except TypeError: return reversed(list(iterable)) def consecutive_groups(iterable, ordering=lambda x: x): """Yield groups of consecutive items using :func:`itertools.groupby`. The *ordering* function determines whether two items are adjacent by returning their position. By default, the ordering function is the identity function. This is suitable for finding runs of numbers: >>> iterable = [1, 10, 11, 12, 20, 30, 31, 32, 33, 40] >>> for group in consecutive_groups(iterable): ... print(list(group)) [1] [10, 11, 12] [20] [30, 31, 32, 33] [40] For finding runs of adjacent letters, try using the :meth:`index` method of a string of letters: >>> from string import ascii_lowercase >>> iterable = 'abcdfgilmnop' >>> ordering = ascii_lowercase.index >>> for group in consecutive_groups(iterable, ordering): ... print(list(group)) ['a', 'b', 'c', 'd'] ['f', 'g'] ['i'] ['l', 'm', 'n', 'o', 'p'] Each group of consecutive items is an iterator that shares it source with *iterable*. When an an output group is advanced, the previous group is no longer available unless its elements are copied (e.g., into a ``list``). >>> iterable = [1, 2, 11, 12, 21, 22] >>> saved_groups = [] >>> for group in consecutive_groups(iterable): ... saved_groups.append(list(group)) # Copy group elements >>> saved_groups [[1, 2], [11, 12], [21, 22]] """ for k, g in groupby( enumerate(iterable), key=lambda x: x[0] - ordering(x[1]) ): yield map(itemgetter(1), g) def difference(iterable, func=sub, *, initial=None): """This function is the inverse of :func:`itertools.accumulate`. By default it will compute the first difference of *iterable* using :func:`operator.sub`: >>> from itertools import accumulate >>> iterable = accumulate([0, 1, 2, 3, 4]) # produces 0, 1, 3, 6, 10 >>> list(difference(iterable)) [0, 1, 2, 3, 4] *func* defaults to :func:`operator.sub`, but other functions can be specified. They will be applied as follows:: A, B, C, D, ... --> A, func(B, A), func(C, B), func(D, C), ... For example, to do progressive division: >>> iterable = [1, 2, 6, 24, 120] >>> func = lambda x, y: x // y >>> list(difference(iterable, func)) [1, 2, 3, 4, 5] If the *initial* keyword is set, the first element will be skipped when computing successive differences. >>> it = [10, 11, 13, 16] # from accumulate([1, 2, 3], initial=10) >>> list(difference(it, initial=10)) [1, 2, 3] """ a, b = tee(iterable) try: first = [next(b)] except StopIteration: return iter([]) if initial is not None: first = [] return chain(first, map(func, b, a)) class SequenceView(Sequence): """Return a read-only view of the sequence object *target*. :class:`SequenceView` objects are analogous to Python's built-in "dictionary view" types. They provide a dynamic view of a sequence's items, meaning that when the sequence updates, so does the view. >>> seq = ['0', '1', '2'] >>> view = SequenceView(seq) >>> view SequenceView(['0', '1', '2']) >>> seq.append('3') >>> view SequenceView(['0', '1', '2', '3']) Sequence views support indexing, slicing, and length queries. They act like the underlying sequence, except they don't allow assignment: >>> view[1] '1' >>> view[1:-1] ['1', '2'] >>> len(view) 4 Sequence views are useful as an alternative to copying, as they don't require (much) extra storage. """ def __init__(self, target): if not isinstance(target, Sequence): raise TypeError self._target = target def __getitem__(self, index): return self._target[index] def __len__(self): return len(self._target) def __repr__(self): return '{}({})'.format(self.__class__.__name__, repr(self._target)) class seekable: """Wrap an iterator to allow for seeking backward and forward. This progressively caches the items in the source iterable so they can be re-visited. Call :meth:`seek` with an index to seek to that position in the source iterable. To "reset" an iterator, seek to ``0``: >>> from itertools import count >>> it = seekable((str(n) for n in count())) >>> next(it), next(it), next(it) ('0', '1', '2') >>> it.seek(0) >>> next(it), next(it), next(it) ('0', '1', '2') >>> next(it) '3' You can also seek forward: >>> it = seekable((str(n) for n in range(20))) >>> it.seek(10) >>> next(it) '10' >>> it.relative_seek(-2) # Seeking relative to the current position >>> next(it) '9' >>> it.seek(20) # Seeking past the end of the source isn't a problem >>> list(it) [] >>> it.seek(0) # Resetting works even after hitting the end >>> next(it), next(it), next(it) ('0', '1', '2') Call :meth:`peek` to look ahead one item without advancing the iterator: >>> it = seekable('1234') >>> it.peek() '1' >>> list(it) ['1', '2', '3', '4'] >>> it.peek(default='empty') 'empty' Before the iterator is at its end, calling :func:`bool` on it will return ``True``. After it will return ``False``: >>> it = seekable('5678') >>> bool(it) True >>> list(it) ['5', '6', '7', '8'] >>> bool(it) False You may view the contents of the cache with the :meth:`elements` method. That returns a :class:`SequenceView`, a view that updates automatically: >>> it = seekable((str(n) for n in range(10))) >>> next(it), next(it), next(it) ('0', '1', '2') >>> elements = it.elements() >>> elements SequenceView(['0', '1', '2']) >>> next(it) '3' >>> elements SequenceView(['0', '1', '2', '3']) By default, the cache grows as the source iterable progresses, so beware of wrapping very large or infinite iterables. Supply *maxlen* to limit the size of the cache (this of course limits how far back you can seek). >>> from itertools import count >>> it = seekable((str(n) for n in count()), maxlen=2) >>> next(it), next(it), next(it), next(it) ('0', '1', '2', '3') >>> list(it.elements()) ['2', '3'] >>> it.seek(0) >>> next(it), next(it), next(it), next(it) ('2', '3', '4', '5') >>> next(it) '6' """ def __init__(self, iterable, maxlen=None): self._source = iter(iterable) if maxlen is None: self._cache = [] else: self._cache = deque([], maxlen) self._index = None def __iter__(self): return self def __next__(self): if self._index is not None: try: item = self._cache[self._index] except IndexError: self._index = None else: self._index += 1 return item item = next(self._source) self._cache.append(item) return item def __bool__(self): try: self.peek() except StopIteration: return False return True def peek(self, default=_marker): try: peeked = next(self) except StopIteration: if default is _marker: raise return default if self._index is None: self._index = len(self._cache) self._index -= 1 return peeked def elements(self): return SequenceView(self._cache) def seek(self, index): self._index = index remainder = index - len(self._cache) if remainder > 0: consume(self, remainder) def relative_seek(self, count): index = len(self._cache) self.seek(max(index + count, 0)) class run_length: """ :func:`run_length.encode` compresses an iterable with run-length encoding. It yields groups of repeated items with the count of how many times they were repeated: >>> uncompressed = 'abbcccdddd' >>> list(run_length.encode(uncompressed)) [('a', 1), ('b', 2), ('c', 3), ('d', 4)] :func:`run_length.decode` decompresses an iterable that was previously compressed with run-length encoding. It yields the items of the decompressed iterable: >>> compressed = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] >>> list(run_length.decode(compressed)) ['a', 'b', 'b', 'c', 'c', 'c', 'd', 'd', 'd', 'd'] """ @staticmethod def encode(iterable): return ((k, ilen(g)) for k, g in groupby(iterable)) @staticmethod def decode(iterable): return chain.from_iterable(repeat(k, n) for k, n in iterable) def exactly_n(iterable, n, predicate=bool): """Return ``True`` if exactly ``n`` items in the iterable are ``True`` according to the *predicate* function. >>> exactly_n([True, True, False], 2) True >>> exactly_n([True, True, False], 1) False >>> exactly_n([0, 1, 2, 3, 4, 5], 3, lambda x: x < 3) True The iterable will be advanced until ``n + 1`` truthy items are encountered, so avoid calling it on infinite iterables. """ return len(take(n + 1, filter(predicate, iterable))) == n def circular_shifts(iterable): """Return a list of circular shifts of *iterable*. >>> circular_shifts(range(4)) [(0, 1, 2, 3), (1, 2, 3, 0), (2, 3, 0, 1), (3, 0, 1, 2)] """ lst = list(iterable) return take(len(lst), windowed(cycle(lst), len(lst))) def make_decorator(wrapping_func, result_index=0): """Return a decorator version of *wrapping_func*, which is a function that modifies an iterable. *result_index* is the position in that function's signature where the iterable goes. This lets you use itertools on the "production end," i.e. at function definition. This can augment what the function returns without changing the function's code. For example, to produce a decorator version of :func:`chunked`: >>> from more_itertools import chunked >>> chunker = make_decorator(chunked, result_index=0) >>> @chunker(3) ... def iter_range(n): ... return iter(range(n)) ... >>> list(iter_range(9)) [[0, 1, 2], [3, 4, 5], [6, 7, 8]] To only allow truthy items to be returned: >>> truth_serum = make_decorator(filter, result_index=1) >>> @truth_serum(bool) ... def boolean_test(): ... return [0, 1, '', ' ', False, True] ... >>> list(boolean_test()) [1, ' ', True] The :func:`peekable` and :func:`seekable` wrappers make for practical decorators: >>> from more_itertools import peekable >>> peekable_function = make_decorator(peekable) >>> @peekable_function() ... def str_range(*args): ... return (str(x) for x in range(*args)) ... >>> it = str_range(1, 20, 2) >>> next(it), next(it), next(it) ('1', '3', '5') >>> it.peek() '7' >>> next(it) '7' """ # See https://sites.google.com/site/bbayles/index/decorator_factory for # notes on how this works. def decorator(*wrapping_args, **wrapping_kwargs): def outer_wrapper(f): def inner_wrapper(*args, **kwargs): result = f(*args, **kwargs) wrapping_args_ = list(wrapping_args) wrapping_args_.insert(result_index, result) return wrapping_func(*wrapping_args_, **wrapping_kwargs) return inner_wrapper return outer_wrapper return decorator def map_reduce(iterable, keyfunc, valuefunc=None, reducefunc=None): """Return a dictionary that maps the items in *iterable* to categories defined by *keyfunc*, transforms them with *valuefunc*, and then summarizes them by category with *reducefunc*. *valuefunc* defaults to the identity function if it is unspecified. If *reducefunc* is unspecified, no summarization takes place: >>> keyfunc = lambda x: x.upper() >>> result = map_reduce('abbccc', keyfunc) >>> sorted(result.items()) [('A', ['a']), ('B', ['b', 'b']), ('C', ['c', 'c', 'c'])] Specifying *valuefunc* transforms the categorized items: >>> keyfunc = lambda x: x.upper() >>> valuefunc = lambda x: 1 >>> result = map_reduce('abbccc', keyfunc, valuefunc) >>> sorted(result.items()) [('A', [1]), ('B', [1, 1]), ('C', [1, 1, 1])] Specifying *reducefunc* summarizes the categorized items: >>> keyfunc = lambda x: x.upper() >>> valuefunc = lambda x: 1 >>> reducefunc = sum >>> result = map_reduce('abbccc', keyfunc, valuefunc, reducefunc) >>> sorted(result.items()) [('A', 1), ('B', 2), ('C', 3)] You may want to filter the input iterable before applying the map/reduce procedure: >>> all_items = range(30) >>> items = [x for x in all_items if 10 <= x <= 20] # Filter >>> keyfunc = lambda x: x % 2 # Evens map to 0; odds to 1 >>> categories = map_reduce(items, keyfunc=keyfunc) >>> sorted(categories.items()) [(0, [10, 12, 14, 16, 18, 20]), (1, [11, 13, 15, 17, 19])] >>> summaries = map_reduce(items, keyfunc=keyfunc, reducefunc=sum) >>> sorted(summaries.items()) [(0, 90), (1, 75)] Note that all items in the iterable are gathered into a list before the summarization step, which may require significant storage. The returned object is a :obj:`collections.defaultdict` with the ``default_factory`` set to ``None``, such that it behaves like a normal dictionary. """ valuefunc = (lambda x: x) if (valuefunc is None) else valuefunc ret = defaultdict(list) for item in iterable: key = keyfunc(item) value = valuefunc(item) ret[key].append(value) if reducefunc is not None: for key, value_list in ret.items(): ret[key] = reducefunc(value_list) ret.default_factory = None return ret def rlocate(iterable, pred=bool, window_size=None): """Yield the index of each item in *iterable* for which *pred* returns ``True``, starting from the right and moving left. *pred* defaults to :func:`bool`, which will select truthy items: >>> list(rlocate([0, 1, 1, 0, 1, 0, 0])) # Truthy at 1, 2, and 4 [4, 2, 1] Set *pred* to a custom function to, e.g., find the indexes for a particular item: >>> iterable = iter('abcb') >>> pred = lambda x: x == 'b' >>> list(rlocate(iterable, pred)) [3, 1] If *window_size* is given, then the *pred* function will be called with that many items. This enables searching for sub-sequences: >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] >>> pred = lambda *args: args == (1, 2, 3) >>> list(rlocate(iterable, pred=pred, window_size=3)) [9, 5, 1] Beware, this function won't return anything for infinite iterables. If *iterable* is reversible, ``rlocate`` will reverse it and search from the right. Otherwise, it will search from the left and return the results in reverse order. See :func:`locate` to for other example applications. """ if window_size is None: try: len_iter = len(iterable) return (len_iter - i - 1 for i in locate(reversed(iterable), pred)) except TypeError: pass return reversed(list(locate(iterable, pred, window_size))) def replace(iterable, pred, substitutes, count=None, window_size=1): """Yield the items from *iterable*, replacing the items for which *pred* returns ``True`` with the items from the iterable *substitutes*. >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1] >>> pred = lambda x: x == 0 >>> substitutes = (2, 3) >>> list(replace(iterable, pred, substitutes)) [1, 1, 2, 3, 1, 1, 2, 3, 1, 1] If *count* is given, the number of replacements will be limited: >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1, 0] >>> pred = lambda x: x == 0 >>> substitutes = [None] >>> list(replace(iterable, pred, substitutes, count=2)) [1, 1, None, 1, 1, None, 1, 1, 0] Use *window_size* to control the number of items passed as arguments to *pred*. This allows for locating and replacing subsequences. >>> iterable = [0, 1, 2, 5, 0, 1, 2, 5] >>> window_size = 3 >>> pred = lambda *args: args == (0, 1, 2) # 3 items passed to pred >>> substitutes = [3, 4] # Splice in these items >>> list(replace(iterable, pred, substitutes, window_size=window_size)) [3, 4, 5, 3, 4, 5] """ if window_size < 1: raise ValueError('window_size must be at least 1') # Save the substitutes iterable, since it's used more than once substitutes = tuple(substitutes) # Add padding such that the number of windows matches the length of the # iterable it = chain(iterable, [_marker] * (window_size - 1)) windows = windowed(it, window_size) n = 0 for w in windows: # If the current window matches our predicate (and we haven't hit # our maximum number of replacements), splice in the substitutes # and then consume the following windows that overlap with this one. # For example, if the iterable is (0, 1, 2, 3, 4...) # and the window size is 2, we have (0, 1), (1, 2), (2, 3)... # If the predicate matches on (0, 1), we need to zap (0, 1) and (1, 2) if pred(*w): if (count is None) or (n < count): n += 1 yield from substitutes consume(windows, window_size - 1) continue # If there was no match (or we've reached the replacement limit), # yield the first item from the window. if w and (w[0] is not _marker): yield w[0] def partitions(iterable): """Yield all possible order-preserving partitions of *iterable*. >>> iterable = 'abc' >>> for part in partitions(iterable): ... print([''.join(p) for p in part]) ['abc'] ['a', 'bc'] ['ab', 'c'] ['a', 'b', 'c'] This is unrelated to :func:`partition`. """ sequence = list(iterable) n = len(sequence) for i in powerset(range(1, n)): yield [sequence[i:j] for i, j in zip((0,) + i, i + (n,))] def set_partitions(iterable, k=None): """ Yield the set partitions of *iterable* into *k* parts. Set partitions are not order-preserving. >>> iterable = 'abc' >>> for part in set_partitions(iterable, 2): ... print([''.join(p) for p in part]) ['a', 'bc'] ['ab', 'c'] ['b', 'ac'] If *k* is not given, every set partition is generated. >>> iterable = 'abc' >>> for part in set_partitions(iterable): ... print([''.join(p) for p in part]) ['abc'] ['a', 'bc'] ['ab', 'c'] ['b', 'ac'] ['a', 'b', 'c'] """ L = list(iterable) n = len(L) if k is not None: if k < 1: raise ValueError( "Can't partition in a negative or zero number of groups" ) elif k > n: return def set_partitions_helper(L, k): n = len(L) if k == 1: yield [L] elif n == k: yield [[s] for s in L] else: e, *M = L for p in set_partitions_helper(M, k - 1): yield [[e], *p] for p in set_partitions_helper(M, k): for i in range(len(p)): yield p[:i] + [[e] + p[i]] + p[i + 1 :] if k is None: for k in range(1, n + 1): yield from set_partitions_helper(L, k) else: yield from set_partitions_helper(L, k) class time_limited: """ Yield items from *iterable* until *limit_seconds* have passed. If the time limit expires before all items have been yielded, the ``timed_out`` parameter will be set to ``True``. >>> from time import sleep >>> def generator(): ... yield 1 ... yield 2 ... sleep(0.2) ... yield 3 >>> iterable = time_limited(0.1, generator()) >>> list(iterable) [1, 2] >>> iterable.timed_out True Note that the time is checked before each item is yielded, and iteration stops if the time elapsed is greater than *limit_seconds*. If your time limit is 1 second, but it takes 2 seconds to generate the first item from the iterable, the function will run for 2 seconds and not yield anything. As a special case, when *limit_seconds* is zero, the iterator never returns anything. """ def __init__(self, limit_seconds, iterable): if limit_seconds < 0: raise ValueError('limit_seconds must be positive') self.limit_seconds = limit_seconds self._iterable = iter(iterable) self._start_time = monotonic() self.timed_out = False def __iter__(self): return self def __next__(self): if self.limit_seconds == 0: self.timed_out = True raise StopIteration item = next(self._iterable) if monotonic() - self._start_time > self.limit_seconds: self.timed_out = True raise StopIteration return item def only(iterable, default=None, too_long=None): """If *iterable* has only one item, return it. If it has zero items, return *default*. If it has more than one item, raise the exception given by *too_long*, which is ``ValueError`` by default. >>> only([], default='missing') 'missing' >>> only([1]) 1 >>> only([1, 2]) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: Expected exactly one item in iterable, but got 1, 2, and perhaps more.' >>> only([1, 2], too_long=TypeError) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... TypeError Note that :func:`only` attempts to advance *iterable* twice to ensure there is only one item. See :func:`spy` or :func:`peekable` to check iterable contents less destructively. """ it = iter(iterable) first_value = next(it, default) try: second_value = next(it) except StopIteration: pass else: msg = ( 'Expected exactly one item in iterable, but got {!r}, {!r}, ' 'and perhaps more.'.format(first_value, second_value) ) raise too_long or ValueError(msg) return first_value def _ichunk(iterable, n): cache = deque() chunk = islice(iterable, n) def generator(): while True: if cache: yield cache.popleft() else: try: item = next(chunk) except StopIteration: return else: yield item def materialize_next(n=1): # if n not specified materialize everything if n is None: cache.extend(chunk) return len(cache) to_cache = n - len(cache) # materialize up to n if to_cache > 0: cache.extend(islice(chunk, to_cache)) # return number materialized up to n return min(n, len(cache)) return (generator(), materialize_next) def ichunked(iterable, n): """Break *iterable* into sub-iterables with *n* elements each. :func:`ichunked` is like :func:`chunked`, but it yields iterables instead of lists. If the sub-iterables are read in order, the elements of *iterable* won't be stored in memory. If they are read out of order, :func:`itertools.tee` is used to cache elements as necessary. >>> from itertools import count >>> all_chunks = ichunked(count(), 4) >>> c_1, c_2, c_3 = next(all_chunks), next(all_chunks), next(all_chunks) >>> list(c_2) # c_1's elements have been cached; c_3's haven't been [4, 5, 6, 7] >>> list(c_1) [0, 1, 2, 3] >>> list(c_3) [8, 9, 10, 11] """ iterable = iter(iterable) while True: # Create new chunk chunk, materialize_next = _ichunk(iterable, n) # Check to see whether we're at the end of the source iterable if not materialize_next(): return yield chunk # Fill previous chunk's cache materialize_next(None) def iequals(*iterables): """Return ``True`` if all given *iterables* are equal to each other, which means that they contain the same elements in the same order. The function is useful for comparing iterables of different data types or iterables that do not support equality checks. >>> iequals("abc", ['a', 'b', 'c'], ('a', 'b', 'c'), iter("abc")) True >>> iequals("abc", "acb") False Not to be confused with :func:`all_equal`, which checks whether all elements of iterable are equal to each other. """ return all(map(all_equal, zip_longest(*iterables, fillvalue=object()))) def distinct_combinations(iterable, r): """Yield the distinct combinations of *r* items taken from *iterable*. >>> list(distinct_combinations([0, 0, 1], 2)) [(0, 0), (0, 1)] Equivalent to ``set(combinations(iterable))``, except duplicates are not generated and thrown away. For larger input sequences this is much more efficient. """ if r < 0: raise ValueError('r must be non-negative') elif r == 0: yield () return pool = tuple(iterable) generators = [unique_everseen(enumerate(pool), key=itemgetter(1))] current_combo = [None] * r level = 0 while generators: try: cur_idx, p = next(generators[-1]) except StopIteration: generators.pop() level -= 1 continue current_combo[level] = p if level + 1 == r: yield tuple(current_combo) else: generators.append( unique_everseen( enumerate(pool[cur_idx + 1 :], cur_idx + 1), key=itemgetter(1), ) ) level += 1 def filter_except(validator, iterable, *exceptions): """Yield the items from *iterable* for which the *validator* function does not raise one of the specified *exceptions*. *validator* is called for each item in *iterable*. It should be a function that accepts one argument and raises an exception if that item is not valid. >>> iterable = ['1', '2', 'three', '4', None] >>> list(filter_except(int, iterable, ValueError, TypeError)) ['1', '2', '4'] If an exception other than one given by *exceptions* is raised by *validator*, it is raised like normal. """ for item in iterable: try: validator(item) except exceptions: pass else: yield item def map_except(function, iterable, *exceptions): """Transform each item from *iterable* with *function* and yield the result, unless *function* raises one of the specified *exceptions*. *function* is called to transform each item in *iterable*. It should accept one argument. >>> iterable = ['1', '2', 'three', '4', None] >>> list(map_except(int, iterable, ValueError, TypeError)) [1, 2, 4] If an exception other than one given by *exceptions* is raised by *function*, it is raised like normal. """ for item in iterable: try: yield function(item) except exceptions: pass def map_if(iterable, pred, func, func_else=lambda x: x): """Evaluate each item from *iterable* using *pred*. If the result is equivalent to ``True``, transform the item with *func* and yield it. Otherwise, transform the item with *func_else* and yield it. *pred*, *func*, and *func_else* should each be functions that accept one argument. By default, *func_else* is the identity function. >>> from math import sqrt >>> iterable = list(range(-5, 5)) >>> iterable [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4] >>> list(map_if(iterable, lambda x: x > 3, lambda x: 'toobig')) [-5, -4, -3, -2, -1, 0, 1, 2, 3, 'toobig'] >>> list(map_if(iterable, lambda x: x >= 0, ... lambda x: f'{sqrt(x):.2f}', lambda x: None)) [None, None, None, None, None, '0.00', '1.00', '1.41', '1.73', '2.00'] """ for item in iterable: yield func(item) if pred(item) else func_else(item) def _sample_unweighted(iterable, k): # Implementation of "Algorithm L" from the 1994 paper by Kim-Hung Li: # "Reservoir-Sampling Algorithms of Time Complexity O(n(1+log(N/n)))". # Fill up the reservoir (collection of samples) with the first `k` samples reservoir = take(k, iterable) # Generate random number that's the largest in a sample of k U(0,1) numbers # Largest order statistic: https://en.wikipedia.org/wiki/Order_statistic W = exp(log(random()) / k) # The number of elements to skip before changing the reservoir is a random # number with a geometric distribution. Sample it using random() and logs. next_index = k + floor(log(random()) / log(1 - W)) for index, element in enumerate(iterable, k): if index == next_index: reservoir[randrange(k)] = element # The new W is the largest in a sample of k U(0, `old_W`) numbers W *= exp(log(random()) / k) next_index += floor(log(random()) / log(1 - W)) + 1 return reservoir def _sample_weighted(iterable, k, weights): # Implementation of "A-ExpJ" from the 2006 paper by Efraimidis et al. : # "Weighted random sampling with a reservoir". # Log-transform for numerical stability for weights that are small/large weight_keys = (log(random()) / weight for weight in weights) # Fill up the reservoir (collection of samples) with the first `k` # weight-keys and elements, then heapify the list. reservoir = take(k, zip(weight_keys, iterable)) heapify(reservoir) # The number of jumps before changing the reservoir is a random variable # with an exponential distribution. Sample it using random() and logs. smallest_weight_key, _ = reservoir[0] weights_to_skip = log(random()) / smallest_weight_key for weight, element in zip(weights, iterable): if weight >= weights_to_skip: # The notation here is consistent with the paper, but we store # the weight-keys in log-space for better numerical stability. smallest_weight_key, _ = reservoir[0] t_w = exp(weight * smallest_weight_key) r_2 = uniform(t_w, 1) # generate U(t_w, 1) weight_key = log(r_2) / weight heapreplace(reservoir, (weight_key, element)) smallest_weight_key, _ = reservoir[0] weights_to_skip = log(random()) / smallest_weight_key else: weights_to_skip -= weight # Equivalent to [element for weight_key, element in sorted(reservoir)] return [heappop(reservoir)[1] for _ in range(k)] def sample(iterable, k, weights=None): """Return a *k*-length list of elements chosen (without replacement) from the *iterable*. Like :func:`random.sample`, but works on iterables of unknown length. >>> iterable = range(100) >>> sample(iterable, 5) # doctest: +SKIP [81, 60, 96, 16, 4] An iterable with *weights* may also be given: >>> iterable = range(100) >>> weights = (i * i + 1 for i in range(100)) >>> sampled = sample(iterable, 5, weights=weights) # doctest: +SKIP [79, 67, 74, 66, 78] The algorithm can also be used to generate weighted random permutations. The relative weight of each item determines the probability that it appears late in the permutation. >>> data = "abcdefgh" >>> weights = range(1, len(data) + 1) >>> sample(data, k=len(data), weights=weights) # doctest: +SKIP ['c', 'a', 'b', 'e', 'g', 'd', 'h', 'f'] """ if k == 0: return [] iterable = iter(iterable) if weights is None: return _sample_unweighted(iterable, k) else: weights = iter(weights) return _sample_weighted(iterable, k, weights) def is_sorted(iterable, key=None, reverse=False, strict=False): """Returns ``True`` if the items of iterable are in sorted order, and ``False`` otherwise. *key* and *reverse* have the same meaning that they do in the built-in :func:`sorted` function. >>> is_sorted(['1', '2', '3', '4', '5'], key=int) True >>> is_sorted([5, 4, 3, 1, 2], reverse=True) False If *strict*, tests for strict sorting, that is, returns ``False`` if equal elements are found: >>> is_sorted([1, 2, 2]) True >>> is_sorted([1, 2, 2], strict=True) False The function returns ``False`` after encountering the first out-of-order item. If there are no out-of-order items, the iterable is exhausted. """ compare = (le if reverse else ge) if strict else (lt if reverse else gt) it = iterable if key is None else map(key, iterable) return not any(starmap(compare, pairwise(it))) class AbortThread(BaseException): pass class callback_iter: """Convert a function that uses callbacks to an iterator. Let *func* be a function that takes a `callback` keyword argument. For example: >>> def func(callback=None): ... for i, c in [(1, 'a'), (2, 'b'), (3, 'c')]: ... if callback: ... callback(i, c) ... return 4 Use ``with callback_iter(func)`` to get an iterator over the parameters that are delivered to the callback. >>> with callback_iter(func) as it: ... for args, kwargs in it: ... print(args) (1, 'a') (2, 'b') (3, 'c') The function will be called in a background thread. The ``done`` property indicates whether it has completed execution. >>> it.done True If it completes successfully, its return value will be available in the ``result`` property. >>> it.result 4 Notes: * If the function uses some keyword argument besides ``callback``, supply *callback_kwd*. * If it finished executing, but raised an exception, accessing the ``result`` property will raise the same exception. * If it hasn't finished executing, accessing the ``result`` property from within the ``with`` block will raise ``RuntimeError``. * If it hasn't finished executing, accessing the ``result`` property from outside the ``with`` block will raise a ``more_itertools.AbortThread`` exception. * Provide *wait_seconds* to adjust how frequently the it is polled for output. """ def __init__(self, func, callback_kwd='callback', wait_seconds=0.1): self._func = func self._callback_kwd = callback_kwd self._aborted = False self._future = None self._wait_seconds = wait_seconds # Lazily import concurrent.future self._executor = __import__( 'concurrent.futures' ).futures.ThreadPoolExecutor(max_workers=1) self._iterator = self._reader() def __enter__(self): return self def __exit__(self, exc_type, exc_value, traceback): self._aborted = True self._executor.shutdown() def __iter__(self): return self def __next__(self): return next(self._iterator) @property def done(self): if self._future is None: return False return self._future.done() @property def result(self): if not self.done: raise RuntimeError('Function has not yet completed') return self._future.result() def _reader(self): q = Queue() def callback(*args, **kwargs): if self._aborted: raise AbortThread('canceled by user') q.put((args, kwargs)) self._future = self._executor.submit( self._func, **{self._callback_kwd: callback} ) while True: try: item = q.get(timeout=self._wait_seconds) except Empty: pass else: q.task_done() yield item if self._future.done(): break remaining = [] while True: try: item = q.get_nowait() except Empty: break else: q.task_done() remaining.append(item) q.join() yield from remaining def windowed_complete(iterable, n): """ Yield ``(beginning, middle, end)`` tuples, where: * Each ``middle`` has *n* items from *iterable* * Each ``beginning`` has the items before the ones in ``middle`` * Each ``end`` has the items after the ones in ``middle`` >>> iterable = range(7) >>> n = 3 >>> for beginning, middle, end in windowed_complete(iterable, n): ... print(beginning, middle, end) () (0, 1, 2) (3, 4, 5, 6) (0,) (1, 2, 3) (4, 5, 6) (0, 1) (2, 3, 4) (5, 6) (0, 1, 2) (3, 4, 5) (6,) (0, 1, 2, 3) (4, 5, 6) () Note that *n* must be at least 0 and most equal to the length of *iterable*. This function will exhaust the iterable and may require significant storage. """ if n < 0: raise ValueError('n must be >= 0') seq = tuple(iterable) size = len(seq) if n > size: raise ValueError('n must be <= len(seq)') for i in range(size - n + 1): beginning = seq[:i] middle = seq[i : i + n] end = seq[i + n :] yield beginning, middle, end def all_unique(iterable, key=None): """ Returns ``True`` if all the elements of *iterable* are unique (no two elements are equal). >>> all_unique('ABCB') False If a *key* function is specified, it will be used to make comparisons. >>> all_unique('ABCb') True >>> all_unique('ABCb', str.lower) False The function returns as soon as the first non-unique element is encountered. Iterables with a mix of hashable and unhashable items can be used, but the function will be slower for unhashable items. """ seenset = set() seenset_add = seenset.add seenlist = [] seenlist_add = seenlist.append for element in map(key, iterable) if key else iterable: try: if element in seenset: return False seenset_add(element) except TypeError: if element in seenlist: return False seenlist_add(element) return True def nth_product(index, *args): """Equivalent to ``list(product(*args))[index]``. The products of *args* can be ordered lexicographically. :func:`nth_product` computes the product at sort position *index* without computing the previous products. >>> nth_product(8, range(2), range(2), range(2), range(2)) (1, 0, 0, 0) ``IndexError`` will be raised if the given *index* is invalid. """ pools = list(map(tuple, reversed(args))) ns = list(map(len, pools)) c = reduce(mul, ns) if index < 0: index += c if not 0 <= index < c: raise IndexError result = [] for pool, n in zip(pools, ns): result.append(pool[index % n]) index //= n return tuple(reversed(result)) def nth_permutation(iterable, r, index): """Equivalent to ``list(permutations(iterable, r))[index]``` The subsequences of *iterable* that are of length *r* where order is important can be ordered lexicographically. :func:`nth_permutation` computes the subsequence at sort position *index* directly, without computing the previous subsequences. >>> nth_permutation('ghijk', 2, 5) ('h', 'i') ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. """ pool = list(iterable) n = len(pool) if r is None or r == n: r, c = n, factorial(n) elif not 0 <= r < n: raise ValueError else: c = perm(n, r) assert c > 0 # factortial(n)>0, and r<n so perm(n,r) is never zero if index < 0: index += c if not 0 <= index < c: raise IndexError result = [0] * r q = index * factorial(n) // c if r < n else index for d in range(1, n + 1): q, i = divmod(q, d) if 0 <= n - d < r: result[n - d] = i if q == 0: break return tuple(map(pool.pop, result)) def nth_combination_with_replacement(iterable, r, index): """Equivalent to ``list(combinations_with_replacement(iterable, r))[index]``. The subsequences with repetition of *iterable* that are of length *r* can be ordered lexicographically. :func:`nth_combination_with_replacement` computes the subsequence at sort position *index* directly, without computing the previous subsequences with replacement. >>> nth_combination_with_replacement(range(5), 3, 5) (0, 1, 1) ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. """ pool = tuple(iterable) n = len(pool) if (r < 0) or (r > n): raise ValueError c = comb(n + r - 1, r) if index < 0: index += c if (index < 0) or (index >= c): raise IndexError result = [] i = 0 while r: r -= 1 while n >= 0: num_combs = comb(n + r - 1, r) if index < num_combs: break n -= 1 i += 1 index -= num_combs result.append(pool[i]) return tuple(result) def value_chain(*args): """Yield all arguments passed to the function in the same order in which they were passed. If an argument itself is iterable then iterate over its values. >>> list(value_chain(1, 2, 3, [4, 5, 6])) [1, 2, 3, 4, 5, 6] Binary and text strings are not considered iterable and are emitted as-is: >>> list(value_chain('12', '34', ['56', '78'])) ['12', '34', '56', '78'] Pre- or postpend a single element to an iterable: >>> list(value_chain(1, [2, 3, 4, 5, 6])) [1, 2, 3, 4, 5, 6] >>> list(value_chain([1, 2, 3, 4, 5], 6)) [1, 2, 3, 4, 5, 6] Multiple levels of nesting are not flattened. """ for value in args: if isinstance(value, (str, bytes)): yield value continue try: yield from value except TypeError: yield value def product_index(element, *args): """Equivalent to ``list(product(*args)).index(element)`` The products of *args* can be ordered lexicographically. :func:`product_index` computes the first index of *element* without computing the previous products. >>> product_index([8, 2], range(10), range(5)) 42 ``ValueError`` will be raised if the given *element* isn't in the product of *args*. """ index = 0 for x, pool in zip_longest(element, args, fillvalue=_marker): if x is _marker or pool is _marker: raise ValueError('element is not a product of args') pool = tuple(pool) index = index * len(pool) + pool.index(x) return index def combination_index(element, iterable): """Equivalent to ``list(combinations(iterable, r)).index(element)`` The subsequences of *iterable* that are of length *r* can be ordered lexicographically. :func:`combination_index` computes the index of the first *element*, without computing the previous combinations. >>> combination_index('adf', 'abcdefg') 10 ``ValueError`` will be raised if the given *element* isn't one of the combinations of *iterable*. """ element = enumerate(element) k, y = next(element, (None, None)) if k is None: return 0 indexes = [] pool = enumerate(iterable) for n, x in pool: if x == y: indexes.append(n) tmp, y = next(element, (None, None)) if tmp is None: break else: k = tmp else: raise ValueError('element is not a combination of iterable') n, _ = last(pool, default=(n, None)) # Python versions below 3.8 don't have math.comb index = 1 for i, j in enumerate(reversed(indexes), start=1): j = n - j if i <= j: index += comb(j, i) return comb(n + 1, k + 1) - index def combination_with_replacement_index(element, iterable): """Equivalent to ``list(combinations_with_replacement(iterable, r)).index(element)`` The subsequences with repetition of *iterable* that are of length *r* can be ordered lexicographically. :func:`combination_with_replacement_index` computes the index of the first *element*, without computing the previous combinations with replacement. >>> combination_with_replacement_index('adf', 'abcdefg') 20 ``ValueError`` will be raised if the given *element* isn't one of the combinations with replacement of *iterable*. """ element = tuple(element) l = len(element) element = enumerate(element) k, y = next(element, (None, None)) if k is None: return 0 indexes = [] pool = tuple(iterable) for n, x in enumerate(pool): while x == y: indexes.append(n) tmp, y = next(element, (None, None)) if tmp is None: break else: k = tmp if y is None: break else: raise ValueError( 'element is not a combination with replacement of iterable' ) n = len(pool) occupations = [0] * n for p in indexes: occupations[p] += 1 index = 0 cumulative_sum = 0 for k in range(1, n): cumulative_sum += occupations[k - 1] j = l + n - 1 - k - cumulative_sum i = n - k if i <= j: index += comb(j, i) return index def permutation_index(element, iterable): """Equivalent to ``list(permutations(iterable, r)).index(element)``` The subsequences of *iterable* that are of length *r* where order is important can be ordered lexicographically. :func:`permutation_index` computes the index of the first *element* directly, without computing the previous permutations. >>> permutation_index([1, 3, 2], range(5)) 19 ``ValueError`` will be raised if the given *element* isn't one of the permutations of *iterable*. """ index = 0 pool = list(iterable) for i, x in zip(range(len(pool), -1, -1), element): r = pool.index(x) index = index * i + r del pool[r] return index class countable: """Wrap *iterable* and keep a count of how many items have been consumed. The ``items_seen`` attribute starts at ``0`` and increments as the iterable is consumed: >>> iterable = map(str, range(10)) >>> it = countable(iterable) >>> it.items_seen 0 >>> next(it), next(it) ('0', '1') >>> list(it) ['2', '3', '4', '5', '6', '7', '8', '9'] >>> it.items_seen 10 """ def __init__(self, iterable): self._it = iter(iterable) self.items_seen = 0 def __iter__(self): return self def __next__(self): item = next(self._it) self.items_seen += 1 return item def chunked_even(iterable, n): """Break *iterable* into lists of approximately length *n*. Items are distributed such the lengths of the lists differ by at most 1 item. >>> iterable = [1, 2, 3, 4, 5, 6, 7] >>> n = 3 >>> list(chunked_even(iterable, n)) # List lengths: 3, 2, 2 [[1, 2, 3], [4, 5], [6, 7]] >>> list(chunked(iterable, n)) # List lengths: 3, 3, 1 [[1, 2, 3], [4, 5, 6], [7]] """ iterable = iter(iterable) # Initialize a buffer to process the chunks while keeping # some back to fill any underfilled chunks min_buffer = (n - 1) * (n - 2) buffer = list(islice(iterable, min_buffer)) # Append items until we have a completed chunk for _ in islice(map(buffer.append, iterable), n, None, n): yield buffer[:n] del buffer[:n] # Check if any chunks need addition processing if not buffer: return length = len(buffer) # Chunks are either size `full_size <= n` or `partial_size = full_size - 1` q, r = divmod(length, n) num_lists = q + (1 if r > 0 else 0) q, r = divmod(length, num_lists) full_size = q + (1 if r > 0 else 0) partial_size = full_size - 1 num_full = length - partial_size * num_lists # Yield chunks of full size partial_start_idx = num_full * full_size if full_size > 0: for i in range(0, partial_start_idx, full_size): yield buffer[i : i + full_size] # Yield chunks of partial size if partial_size > 0: for i in range(partial_start_idx, length, partial_size): yield buffer[i : i + partial_size] def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False): """A version of :func:`zip` that "broadcasts" any scalar (i.e., non-iterable) items into output tuples. >>> iterable_1 = [1, 2, 3] >>> iterable_2 = ['a', 'b', 'c'] >>> scalar = '_' >>> list(zip_broadcast(iterable_1, iterable_2, scalar)) [(1, 'a', '_'), (2, 'b', '_'), (3, 'c', '_')] The *scalar_types* keyword argument determines what types are considered scalar. It is set to ``(str, bytes)`` by default. Set it to ``None`` to treat strings and byte strings as iterable: >>> list(zip_broadcast('abc', 0, 'xyz', scalar_types=None)) [('a', 0, 'x'), ('b', 0, 'y'), ('c', 0, 'z')] If the *strict* keyword argument is ``True``, then ``UnequalIterablesError`` will be raised if any of the iterables have different lengths. """ def is_scalar(obj): if scalar_types and isinstance(obj, scalar_types): return True try: iter(obj) except TypeError: return True else: return False size = len(objects) if not size: return new_item = [None] * size iterables, iterable_positions = [], [] for i, obj in enumerate(objects): if is_scalar(obj): new_item[i] = obj else: iterables.append(iter(obj)) iterable_positions.append(i) if not iterables: yield tuple(objects) return zipper = _zip_equal if strict else zip for item in zipper(*iterables): for i, new_item[i] in zip(iterable_positions, item): pass yield tuple(new_item) def unique_in_window(iterable, n, key=None): """Yield the items from *iterable* that haven't been seen recently. *n* is the size of the lookback window. >>> iterable = [0, 1, 0, 2, 3, 0] >>> n = 3 >>> list(unique_in_window(iterable, n)) [0, 1, 2, 3, 0] The *key* function, if provided, will be used to determine uniqueness: >>> list(unique_in_window('abAcda', 3, key=lambda x: x.lower())) ['a', 'b', 'c', 'd', 'a'] The items in *iterable* must be hashable. """ if n <= 0: raise ValueError('n must be greater than 0') window = deque(maxlen=n) counts = defaultdict(int) use_key = key is not None for item in iterable: if len(window) == n: to_discard = window[0] if counts[to_discard] == 1: del counts[to_discard] else: counts[to_discard] -= 1 k = key(item) if use_key else item if k not in counts: yield item counts[k] += 1 window.append(k) def duplicates_everseen(iterable, key=None): """Yield duplicate elements after their first appearance. >>> list(duplicates_everseen('mississippi')) ['s', 'i', 's', 's', 'i', 'p', 'i'] >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a'] This function is analogous to :func:`unique_everseen` and is subject to the same performance considerations. """ seen_set = set() seen_list = [] use_key = key is not None for element in iterable: k = key(element) if use_key else element try: if k not in seen_set: seen_set.add(k) else: yield element except TypeError: if k not in seen_list: seen_list.append(k) else: yield element def duplicates_justseen(iterable, key=None): """Yields serially-duplicate elements after their first appearance. >>> list(duplicates_justseen('mississippi')) ['s', 's', 'p'] >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower)) ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a'] This function is analogous to :func:`unique_justseen`. """ return flatten(g for _, g in groupby(iterable, key) for _ in g) def classify_unique(iterable, key=None): """Classify each element in terms of its uniqueness. For each element in the input iterable, return a 3-tuple consisting of: 1. The element itself 2. ``False`` if the element is equal to the one preceding it in the input, ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`) 3. ``False`` if this element has been seen anywhere in the input before, ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`) >>> list(classify_unique('otto')) # doctest: +NORMALIZE_WHITESPACE [('o', True, True), ('t', True, True), ('t', False, False), ('o', True, False)] This function is analogous to :func:`unique_everseen` and is subject to the same performance considerations. """ seen_set = set() seen_list = [] use_key = key is not None previous = None for i, element in enumerate(iterable): k = key(element) if use_key else element is_unique_justseen = not i or previous != k previous = k is_unique_everseen = False try: if k not in seen_set: seen_set.add(k) is_unique_everseen = True except TypeError: if k not in seen_list: seen_list.append(k) is_unique_everseen = True yield element, is_unique_justseen, is_unique_everseen def minmax(iterable_or_value, *others, key=None, default=_marker): """Returns both the smallest and largest items in an iterable or the largest of two or more arguments. >>> minmax([3, 1, 5]) (1, 5) >>> minmax(4, 2, 6) (2, 6) If a *key* function is provided, it will be used to transform the input items for comparison. >>> minmax([5, 30], key=str) # '30' sorts before '5' (30, 5) If a *default* value is provided, it will be returned if there are no input items. >>> minmax([], default=(0, 0)) (0, 0) Otherwise ``ValueError`` is raised. This function is based on the `recipe <http://code.activestate.com/recipes/577916/>`__ by Raymond Hettinger and takes care to minimize the number of comparisons performed. """ iterable = (iterable_or_value, *others) if others else iterable_or_value it = iter(iterable) try: lo = hi = next(it) except StopIteration as exc: if default is _marker: raise ValueError( '`minmax()` argument is an empty iterable. ' 'Provide a `default` value to suppress this error.' ) from exc return default # Different branches depending on the presence of key. This saves a lot # of unimportant copies which would slow the "key=None" branch # significantly down. if key is None: for x, y in zip_longest(it, it, fillvalue=lo): if y < x: x, y = y, x if x < lo: lo = x if hi < y: hi = y else: lo_key = hi_key = key(lo) for x, y in zip_longest(it, it, fillvalue=lo): x_key, y_key = key(x), key(y) if y_key < x_key: x, y, x_key, y_key = y, x, y_key, x_key if x_key < lo_key: lo, lo_key = x, x_key if hi_key < y_key: hi, hi_key = y, y_key return lo, hi def constrained_batches( iterable, max_size, max_count=None, get_len=len, strict=True ): """Yield batches of items from *iterable* with a combined size limited by *max_size*. >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] >>> list(constrained_batches(iterable, 10)) [(b'12345', b'123'), (b'12345678', b'1', b'1'), (b'12', b'1')] If a *max_count* is supplied, the number of items per batch is also limited: >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] >>> list(constrained_batches(iterable, 10, max_count = 2)) [(b'12345', b'123'), (b'12345678', b'1'), (b'1', b'12'), (b'1',)] If a *get_len* function is supplied, use that instead of :func:`len` to determine item size. If *strict* is ``True``, raise ``ValueError`` if any single item is bigger than *max_size*. Otherwise, allow single items to exceed *max_size*. """ if max_size <= 0: raise ValueError('maximum size must be greater than zero') batch = [] batch_size = 0 batch_count = 0 for item in iterable: item_len = get_len(item) if strict and item_len > max_size: raise ValueError('item size exceeds maximum size') reached_count = batch_count == max_count reached_size = item_len + batch_size > max_size if batch_count and (reached_size or reached_count): yield tuple(batch) batch.clear() batch_size = 0 batch_count = 0 batch.append(item) batch_size += item_len batch_count += 1 if batch: yield tuple(batch) def gray_product(*iterables): """Like :func:`itertools.product`, but return tuples in an order such that only one element in the generated tuple changes from one iteration to the next. >>> list(gray_product('AB','CD')) [('A', 'C'), ('B', 'C'), ('B', 'D'), ('A', 'D')] This function consumes all of the input iterables before producing output. If any of the input iterables have fewer than two items, ``ValueError`` is raised. For information on the algorithm, see `this section <https://www-cs-faculty.stanford.edu/~knuth/fasc2a.ps.gz>`__ of Donald Knuth's *The Art of Computer Programming*. """ all_iterables = tuple(tuple(x) for x in iterables) iterable_count = len(all_iterables) for iterable in all_iterables: if len(iterable) < 2: raise ValueError("each iterable must have two or more items") # This is based on "Algorithm H" from section 7.2.1.1, page 20. # a holds the indexes of the source iterables for the n-tuple to be yielded # f is the array of "focus pointers" # o is the array of "directions" a = [0] * iterable_count f = list(range(iterable_count + 1)) o = [1] * iterable_count while True: yield tuple(all_iterables[i][a[i]] for i in range(iterable_count)) j = f[0] f[0] = 0 if j == iterable_count: break a[j] = a[j] + o[j] if a[j] == 0 or a[j] == len(all_iterables[j]) - 1: o[j] = -o[j] f[j] = f[j + 1] f[j + 1] = j + 1 def partial_product(*iterables): """Yields tuples containing one item from each iterator, with subsequent tuples changing a single item at a time by advancing each iterator until it is exhausted. This sequence guarantees every value in each iterable is output at least once without generating all possible combinations. This may be useful, for example, when testing an expensive function. >>> list(partial_product('AB', 'C', 'DEF')) [('A', 'C', 'D'), ('B', 'C', 'D'), ('B', 'C', 'E'), ('B', 'C', 'F')] """ iterators = list(map(iter, iterables)) try: prod = [next(it) for it in iterators] except StopIteration: return yield tuple(prod) for i, it in enumerate(iterators): for prod[i] in it: yield tuple(prod) def takewhile_inclusive(predicate, iterable): """A variant of :func:`takewhile` that yields one additional element. >>> list(takewhile_inclusive(lambda x: x < 5, [1, 4, 6, 4, 1])) [1, 4, 6] :func:`takewhile` would return ``[1, 4]``. """ for x in iterable: yield x if not predicate(x): break def outer_product(func, xs, ys, *args, **kwargs): """A generalized outer product that applies a binary function to all pairs of items. Returns a 2D matrix with ``len(xs)`` rows and ``len(ys)`` columns. Also accepts ``*args`` and ``**kwargs`` that are passed to ``func``. Multiplication table: >>> list(outer_product(mul, range(1, 4), range(1, 6))) [(1, 2, 3, 4, 5), (2, 4, 6, 8, 10), (3, 6, 9, 12, 15)] Cross tabulation: >>> xs = ['A', 'B', 'A', 'A', 'B', 'B', 'A', 'A', 'B', 'B'] >>> ys = ['X', 'X', 'X', 'Y', 'Z', 'Z', 'Y', 'Y', 'Z', 'Z'] >>> rows = list(zip(xs, ys)) >>> count_rows = lambda x, y: rows.count((x, y)) >>> list(outer_product(count_rows, sorted(set(xs)), sorted(set(ys)))) [(2, 3, 0), (1, 0, 4)] Usage with ``*args`` and ``**kwargs``: >>> animals = ['cat', 'wolf', 'mouse'] >>> list(outer_product(min, animals, animals, key=len)) [('cat', 'cat', 'cat'), ('cat', 'wolf', 'wolf'), ('cat', 'wolf', 'mouse')] """ ys = tuple(ys) return batched( starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)), n=len(ys), ) def iter_suppress(iterable, *exceptions): """Yield each of the items from *iterable*. If the iteration raises one of the specified *exceptions*, that exception will be suppressed and iteration will stop. >>> from itertools import chain >>> def breaks_at_five(x): ... while True: ... if x >= 5: ... raise RuntimeError ... yield x ... x += 1 >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError) >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError) >>> list(chain(it_1, it_2)) [1, 2, 3, 4, 2, 3, 4] """ try: yield from iterable except exceptions: return def filter_map(func, iterable): """Apply *func* to every element of *iterable*, yielding only those which are not ``None``. >>> elems = ['1', 'a', '2', 'b', '3'] >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems)) [1, 2, 3] """ for x in iterable: y = func(x) if y is not None: yield y def powerset_of_sets(iterable): """Yields all possible subsets of the iterable. >>> list(powerset_of_sets([1, 2, 3])) # doctest: +SKIP [set(), {1}, {2}, {3}, {1, 2}, {1, 3}, {2, 3}, {1, 2, 3}] >>> list(powerset_of_sets([1, 1, 0])) # doctest: +SKIP [set(), {1}, {0}, {0, 1}] :func:`powerset_of_sets` takes care to minimize the number of hash operations performed. """ sets = tuple(map(set, dict.fromkeys(map(frozenset, zip(iterable))))) for r in range(len(sets) + 1): yield from starmap(set().union, combinations(sets, r)) def join_mappings(**field_to_map): """ Joins multiple mappings together using their common keys. >>> user_scores = {'elliot': 50, 'claris': 60} >>> user_times = {'elliot': 30, 'claris': 40} >>> join_mappings(score=user_scores, time=user_times) {'elliot': {'score': 50, 'time': 30}, 'claris': {'score': 60, 'time': 40}} """ ret = defaultdict(dict) for field_name, mapping in field_to_map.items(): for key, value in mapping.items(): ret[key][field_name] = value return dict(ret) def _complex_sumprod(v1, v2): """High precision sumprod() for complex numbers. Used by :func:`dft` and :func:`idft`. """ r1 = chain((p.real for p in v1), (-p.imag for p in v1)) r2 = chain((q.real for q in v2), (q.imag for q in v2)) i1 = chain((p.real for p in v1), (p.imag for p in v1)) i2 = chain((q.imag for q in v2), (q.real for q in v2)) return complex(_fsumprod(r1, r2), _fsumprod(i1, i2)) def dft(xarr): """Discrete Fourier Tranform. *xarr* is a sequence of complex numbers. Yields the components of the corresponding transformed output vector. >>> import cmath >>> xarr = [1, 2-1j, -1j, -1+2j] >>> Xarr = [2, -2-2j, -2j, 4+4j] >>> all(map(cmath.isclose, dft(xarr), Xarr)) True See :func:`idft` for the inverse Discrete Fourier Transform. """ N = len(xarr) roots_of_unity = [e ** (n / N * tau * -1j) for n in range(N)] for k in range(N): coeffs = [roots_of_unity[k * n % N] for n in range(N)] yield _complex_sumprod(xarr, coeffs) def idft(Xarr): """Inverse Discrete Fourier Tranform. *Xarr* is a sequence of complex numbers. Yields the components of the corresponding inverse-transformed output vector. >>> import cmath >>> xarr = [1, 2-1j, -1j, -1+2j] >>> Xarr = [2, -2-2j, -2j, 4+4j] >>> all(map(cmath.isclose, idft(Xarr), xarr)) True See :func:`dft` for the Discrete Fourier Transform. """ N = len(Xarr) roots_of_unity = [e ** (n / N * tau * 1j) for n in range(N)] for k in range(N): coeffs = [roots_of_unity[k * n % N] for n in range(N)] yield _complex_sumprod(Xarr, coeffs) / N def doublestarmap(func, iterable): """Apply *func* to every item of *iterable* by dictionary unpacking the item into *func*. The difference between :func:`itertools.starmap` and :func:`doublestarmap` parallels the distinction between ``func(*a)`` and ``func(**a)``. >>> iterable = [{'a': 1, 'b': 2}, {'a': 40, 'b': 60}] >>> list(doublestarmap(lambda a, b: a + b, iterable)) [3, 100] ``TypeError`` will be raised if *func*'s signature doesn't match the mapping contained in *iterable* or if *iterable* does not contain mappings. """ for item in iterable: yield func(**item) _vendor/more_itertools/recipes.py 0000644 00000067657 15030122015 0013264 0 ustar 00 """Imported from the recipes section of the itertools documentation. All functions taken from the recipes section of the itertools library docs [1]_. Some backward-compatible usability improvements have been made. .. [1] http://docs.python.org/library/itertools.html#recipes """ import math import operator from collections import deque from collections.abc import Sized from functools import partial, reduce from itertools import ( chain, combinations, compress, count, cycle, groupby, islice, product, repeat, starmap, tee, zip_longest, ) from random import randrange, sample, choice from sys import hexversion __all__ = [ 'all_equal', 'batched', 'before_and_after', 'consume', 'convolve', 'dotproduct', 'first_true', 'factor', 'flatten', 'grouper', 'iter_except', 'iter_index', 'matmul', 'ncycles', 'nth', 'nth_combination', 'padnone', 'pad_none', 'pairwise', 'partition', 'polynomial_eval', 'polynomial_from_roots', 'polynomial_derivative', 'powerset', 'prepend', 'quantify', 'reshape', 'random_combination_with_replacement', 'random_combination', 'random_permutation', 'random_product', 'repeatfunc', 'roundrobin', 'sieve', 'sliding_window', 'subslices', 'sum_of_squares', 'tabulate', 'tail', 'take', 'totient', 'transpose', 'triplewise', 'unique', 'unique_everseen', 'unique_justseen', ] _marker = object() # zip with strict is available for Python 3.10+ try: zip(strict=True) except TypeError: _zip_strict = zip else: _zip_strict = partial(zip, strict=True) # math.sumprod is available for Python 3.12+ _sumprod = getattr(math, 'sumprod', lambda x, y: dotproduct(x, y)) def take(n, iterable): """Return first *n* items of the iterable as a list. >>> take(3, range(10)) [0, 1, 2] If there are fewer than *n* items in the iterable, all of them are returned. >>> take(10, range(3)) [0, 1, 2] """ return list(islice(iterable, n)) def tabulate(function, start=0): """Return an iterator over the results of ``func(start)``, ``func(start + 1)``, ``func(start + 2)``... *func* should be a function that accepts one integer argument. If *start* is not specified it defaults to 0. It will be incremented each time the iterator is advanced. >>> square = lambda x: x ** 2 >>> iterator = tabulate(square, -3) >>> take(4, iterator) [9, 4, 1, 0] """ return map(function, count(start)) def tail(n, iterable): """Return an iterator over the last *n* items of *iterable*. >>> t = tail(3, 'ABCDEFG') >>> list(t) ['E', 'F', 'G'] """ # If the given iterable has a length, then we can use islice to get its # final elements. Note that if the iterable is not actually Iterable, # either islice or deque will throw a TypeError. This is why we don't # check if it is Iterable. if isinstance(iterable, Sized): yield from islice(iterable, max(0, len(iterable) - n), None) else: yield from iter(deque(iterable, maxlen=n)) def consume(iterator, n=None): """Advance *iterable* by *n* steps. If *n* is ``None``, consume it entirely. Efficiently exhausts an iterator without returning values. Defaults to consuming the whole iterator, but an optional second argument may be provided to limit consumption. >>> i = (x for x in range(10)) >>> next(i) 0 >>> consume(i, 3) >>> next(i) 4 >>> consume(i) >>> next(i) Traceback (most recent call last): File "<stdin>", line 1, in <module> StopIteration If the iterator has fewer items remaining than the provided limit, the whole iterator will be consumed. >>> i = (x for x in range(3)) >>> consume(i, 5) >>> next(i) Traceback (most recent call last): File "<stdin>", line 1, in <module> StopIteration """ # Use functions that consume iterators at C speed. if n is None: # feed the entire iterator into a zero-length deque deque(iterator, maxlen=0) else: # advance to the empty slice starting at position n next(islice(iterator, n, n), None) def nth(iterable, n, default=None): """Returns the nth item or a default value. >>> l = range(10) >>> nth(l, 3) 3 >>> nth(l, 20, "zebra") 'zebra' """ return next(islice(iterable, n, None), default) def all_equal(iterable, key=None): """ Returns ``True`` if all the elements are equal to each other. >>> all_equal('aaaa') True >>> all_equal('aaab') False A function that accepts a single argument and returns a transformed version of each input item can be specified with *key*: >>> all_equal('AaaA', key=str.casefold) True >>> all_equal([1, 2, 3], key=lambda x: x < 10) True """ return len(list(islice(groupby(iterable, key), 2))) <= 1 def quantify(iterable, pred=bool): """Return the how many times the predicate is true. >>> quantify([True, False, True]) 2 """ return sum(map(pred, iterable)) def pad_none(iterable): """Returns the sequence of elements and then returns ``None`` indefinitely. >>> take(5, pad_none(range(3))) [0, 1, 2, None, None] Useful for emulating the behavior of the built-in :func:`map` function. See also :func:`padded`. """ return chain(iterable, repeat(None)) padnone = pad_none def ncycles(iterable, n): """Returns the sequence elements *n* times >>> list(ncycles(["a", "b"], 3)) ['a', 'b', 'a', 'b', 'a', 'b'] """ return chain.from_iterable(repeat(tuple(iterable), n)) def dotproduct(vec1, vec2): """Returns the dot product of the two iterables. >>> dotproduct([10, 10], [20, 20]) 400 """ return sum(map(operator.mul, vec1, vec2)) def flatten(listOfLists): """Return an iterator flattening one level of nesting in a list of lists. >>> list(flatten([[0, 1], [2, 3]])) [0, 1, 2, 3] See also :func:`collapse`, which can flatten multiple levels of nesting. """ return chain.from_iterable(listOfLists) def repeatfunc(func, times=None, *args): """Call *func* with *args* repeatedly, returning an iterable over the results. If *times* is specified, the iterable will terminate after that many repetitions: >>> from operator import add >>> times = 4 >>> args = 3, 5 >>> list(repeatfunc(add, times, *args)) [8, 8, 8, 8] If *times* is ``None`` the iterable will not terminate: >>> from random import randrange >>> times = None >>> args = 1, 11 >>> take(6, repeatfunc(randrange, times, *args)) # doctest:+SKIP [2, 4, 8, 1, 8, 4] """ if times is None: return starmap(func, repeat(args)) return starmap(func, repeat(args, times)) def _pairwise(iterable): """Returns an iterator of paired items, overlapping, from the original >>> take(4, pairwise(count())) [(0, 1), (1, 2), (2, 3), (3, 4)] On Python 3.10 and above, this is an alias for :func:`itertools.pairwise`. """ a, b = tee(iterable) next(b, None) return zip(a, b) try: from itertools import pairwise as itertools_pairwise except ImportError: pairwise = _pairwise else: def pairwise(iterable): return itertools_pairwise(iterable) pairwise.__doc__ = _pairwise.__doc__ class UnequalIterablesError(ValueError): def __init__(self, details=None): msg = 'Iterables have different lengths' if details is not None: msg += (': index 0 has length {}; index {} has length {}').format( *details ) super().__init__(msg) def _zip_equal_generator(iterables): for combo in zip_longest(*iterables, fillvalue=_marker): for val in combo: if val is _marker: raise UnequalIterablesError() yield combo def _zip_equal(*iterables): # Check whether the iterables are all the same size. try: first_size = len(iterables[0]) for i, it in enumerate(iterables[1:], 1): size = len(it) if size != first_size: raise UnequalIterablesError(details=(first_size, i, size)) # All sizes are equal, we can use the built-in zip. return zip(*iterables) # If any one of the iterables didn't have a length, start reading # them until one runs out. except TypeError: return _zip_equal_generator(iterables) def grouper(iterable, n, incomplete='fill', fillvalue=None): """Group elements from *iterable* into fixed-length groups of length *n*. >>> list(grouper('ABCDEF', 3)) [('A', 'B', 'C'), ('D', 'E', 'F')] The keyword arguments *incomplete* and *fillvalue* control what happens for iterables whose length is not a multiple of *n*. When *incomplete* is `'fill'`, the last group will contain instances of *fillvalue*. >>> list(grouper('ABCDEFG', 3, incomplete='fill', fillvalue='x')) [('A', 'B', 'C'), ('D', 'E', 'F'), ('G', 'x', 'x')] When *incomplete* is `'ignore'`, the last group will not be emitted. >>> list(grouper('ABCDEFG', 3, incomplete='ignore', fillvalue='x')) [('A', 'B', 'C'), ('D', 'E', 'F')] When *incomplete* is `'strict'`, a subclass of `ValueError` will be raised. >>> it = grouper('ABCDEFG', 3, incomplete='strict') >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... UnequalIterablesError """ args = [iter(iterable)] * n if incomplete == 'fill': return zip_longest(*args, fillvalue=fillvalue) if incomplete == 'strict': return _zip_equal(*args) if incomplete == 'ignore': return zip(*args) else: raise ValueError('Expected fill, strict, or ignore') def roundrobin(*iterables): """Yields an item from each iterable, alternating between them. >>> list(roundrobin('ABC', 'D', 'EF')) ['A', 'D', 'E', 'B', 'F', 'C'] This function produces the same output as :func:`interleave_longest`, but may perform better for some inputs (in particular when the number of iterables is small). """ # Algorithm credited to George Sakkis iterators = map(iter, iterables) for num_active in range(len(iterables), 0, -1): iterators = cycle(islice(iterators, num_active)) yield from map(next, iterators) def partition(pred, iterable): """ Returns a 2-tuple of iterables derived from the input iterable. The first yields the items that have ``pred(item) == False``. The second yields the items that have ``pred(item) == True``. >>> is_odd = lambda x: x % 2 != 0 >>> iterable = range(10) >>> even_items, odd_items = partition(is_odd, iterable) >>> list(even_items), list(odd_items) ([0, 2, 4, 6, 8], [1, 3, 5, 7, 9]) If *pred* is None, :func:`bool` is used. >>> iterable = [0, 1, False, True, '', ' '] >>> false_items, true_items = partition(None, iterable) >>> list(false_items), list(true_items) ([0, False, ''], [1, True, ' ']) """ if pred is None: pred = bool t1, t2, p = tee(iterable, 3) p1, p2 = tee(map(pred, p)) return (compress(t1, map(operator.not_, p1)), compress(t2, p2)) def powerset(iterable): """Yields all possible subsets of the iterable. >>> list(powerset([1, 2, 3])) [(), (1,), (2,), (3,), (1, 2), (1, 3), (2, 3), (1, 2, 3)] :func:`powerset` will operate on iterables that aren't :class:`set` instances, so repeated elements in the input will produce repeated elements in the output. >>> seq = [1, 1, 0] >>> list(powerset(seq)) [(), (1,), (1,), (0,), (1, 1), (1, 0), (1, 0), (1, 1, 0)] For a variant that efficiently yields actual :class:`set` instances, see :func:`powerset_of_sets`. """ s = list(iterable) return chain.from_iterable(combinations(s, r) for r in range(len(s) + 1)) def unique_everseen(iterable, key=None): """ Yield unique elements, preserving order. >>> list(unique_everseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D'] >>> list(unique_everseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'D'] Sequences with a mix of hashable and unhashable items can be used. The function will be slower (i.e., `O(n^2)`) for unhashable items. Remember that ``list`` objects are unhashable - you can use the *key* parameter to transform the list to a tuple (which is hashable) to avoid a slowdown. >>> iterable = ([1, 2], [2, 3], [1, 2]) >>> list(unique_everseen(iterable)) # Slow [[1, 2], [2, 3]] >>> list(unique_everseen(iterable, key=tuple)) # Faster [[1, 2], [2, 3]] Similarly, you may want to convert unhashable ``set`` objects with ``key=frozenset``. For ``dict`` objects, ``key=lambda x: frozenset(x.items())`` can be used. """ seenset = set() seenset_add = seenset.add seenlist = [] seenlist_add = seenlist.append use_key = key is not None for element in iterable: k = key(element) if use_key else element try: if k not in seenset: seenset_add(k) yield element except TypeError: if k not in seenlist: seenlist_add(k) yield element def unique_justseen(iterable, key=None): """Yields elements in order, ignoring serial duplicates >>> list(unique_justseen('AAAABBBCCDAABBB')) ['A', 'B', 'C', 'D', 'A', 'B'] >>> list(unique_justseen('ABBCcAD', str.lower)) ['A', 'B', 'C', 'A', 'D'] """ if key is None: return map(operator.itemgetter(0), groupby(iterable)) return map(next, map(operator.itemgetter(1), groupby(iterable, key))) def unique(iterable, key=None, reverse=False): """Yields unique elements in sorted order. >>> list(unique([[1, 2], [3, 4], [1, 2]])) [[1, 2], [3, 4]] *key* and *reverse* are passed to :func:`sorted`. >>> list(unique('ABBcCAD', str.casefold)) ['A', 'B', 'c', 'D'] >>> list(unique('ABBcCAD', str.casefold, reverse=True)) ['D', 'c', 'B', 'A'] The elements in *iterable* need not be hashable, but they must be comparable for sorting to work. """ return unique_justseen(sorted(iterable, key=key, reverse=reverse), key=key) def iter_except(func, exception, first=None): """Yields results from a function repeatedly until an exception is raised. Converts a call-until-exception interface to an iterator interface. Like ``iter(func, sentinel)``, but uses an exception instead of a sentinel to end the loop. >>> l = [0, 1, 2] >>> list(iter_except(l.pop, IndexError)) [2, 1, 0] Multiple exceptions can be specified as a stopping condition: >>> l = [1, 2, 3, '...', 4, 5, 6] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [7, 6, 5] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [4, 3, 2] >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) [] """ try: if first is not None: yield first() while 1: yield func() except exception: pass def first_true(iterable, default=None, pred=None): """ Returns the first true value in the iterable. If no true value is found, returns *default* If *pred* is not None, returns the first item for which ``pred(item) == True`` . >>> first_true(range(10)) 1 >>> first_true(range(10), pred=lambda x: x > 5) 6 >>> first_true(range(10), default='missing', pred=lambda x: x > 9) 'missing' """ return next(filter(pred, iterable), default) def random_product(*args, repeat=1): """Draw an item at random from each of the input iterables. >>> random_product('abc', range(4), 'XYZ') # doctest:+SKIP ('c', 3, 'Z') If *repeat* is provided as a keyword argument, that many items will be drawn from each iterable. >>> random_product('abcd', range(4), repeat=2) # doctest:+SKIP ('a', 2, 'd', 3) This equivalent to taking a random selection from ``itertools.product(*args, **kwarg)``. """ pools = [tuple(pool) for pool in args] * repeat return tuple(choice(pool) for pool in pools) def random_permutation(iterable, r=None): """Return a random *r* length permutation of the elements in *iterable*. If *r* is not specified or is ``None``, then *r* defaults to the length of *iterable*. >>> random_permutation(range(5)) # doctest:+SKIP (3, 4, 0, 1, 2) This equivalent to taking a random selection from ``itertools.permutations(iterable, r)``. """ pool = tuple(iterable) r = len(pool) if r is None else r return tuple(sample(pool, r)) def random_combination(iterable, r): """Return a random *r* length subsequence of the elements in *iterable*. >>> random_combination(range(5), 3) # doctest:+SKIP (2, 3, 4) This equivalent to taking a random selection from ``itertools.combinations(iterable, r)``. """ pool = tuple(iterable) n = len(pool) indices = sorted(sample(range(n), r)) return tuple(pool[i] for i in indices) def random_combination_with_replacement(iterable, r): """Return a random *r* length subsequence of elements in *iterable*, allowing individual elements to be repeated. >>> random_combination_with_replacement(range(3), 5) # doctest:+SKIP (0, 0, 1, 2, 2) This equivalent to taking a random selection from ``itertools.combinations_with_replacement(iterable, r)``. """ pool = tuple(iterable) n = len(pool) indices = sorted(randrange(n) for i in range(r)) return tuple(pool[i] for i in indices) def nth_combination(iterable, r, index): """Equivalent to ``list(combinations(iterable, r))[index]``. The subsequences of *iterable* that are of length *r* can be ordered lexicographically. :func:`nth_combination` computes the subsequence at sort position *index* directly, without computing the previous subsequences. >>> nth_combination(range(5), 3, 5) (0, 3, 4) ``ValueError`` will be raised If *r* is negative or greater than the length of *iterable*. ``IndexError`` will be raised if the given *index* is invalid. """ pool = tuple(iterable) n = len(pool) if (r < 0) or (r > n): raise ValueError c = 1 k = min(r, n - r) for i in range(1, k + 1): c = c * (n - k + i) // i if index < 0: index += c if (index < 0) or (index >= c): raise IndexError result = [] while r: c, n, r = c * r // n, n - 1, r - 1 while index >= c: index -= c c, n = c * (n - r) // n, n - 1 result.append(pool[-1 - n]) return tuple(result) def prepend(value, iterator): """Yield *value*, followed by the elements in *iterator*. >>> value = '0' >>> iterator = ['1', '2', '3'] >>> list(prepend(value, iterator)) ['0', '1', '2', '3'] To prepend multiple values, see :func:`itertools.chain` or :func:`value_chain`. """ return chain([value], iterator) def convolve(signal, kernel): """Convolve the iterable *signal* with the iterable *kernel*. >>> signal = (1, 2, 3, 4, 5) >>> kernel = [3, 2, 1] >>> list(convolve(signal, kernel)) [3, 8, 14, 20, 26, 14, 5] Note: the input arguments are not interchangeable, as the *kernel* is immediately consumed and stored. """ # This implementation intentionally doesn't match the one in the itertools # documentation. kernel = tuple(kernel)[::-1] n = len(kernel) window = deque([0], maxlen=n) * n for x in chain(signal, repeat(0, n - 1)): window.append(x) yield _sumprod(kernel, window) def before_and_after(predicate, it): """A variant of :func:`takewhile` that allows complete access to the remainder of the iterator. >>> it = iter('ABCdEfGhI') >>> all_upper, remainder = before_and_after(str.isupper, it) >>> ''.join(all_upper) 'ABC' >>> ''.join(remainder) # takewhile() would lose the 'd' 'dEfGhI' Note that the first iterator must be fully consumed before the second iterator can generate valid results. """ it = iter(it) transition = [] def true_iterator(): for elem in it: if predicate(elem): yield elem else: transition.append(elem) return # Note: this is different from itertools recipes to allow nesting # before_and_after remainders into before_and_after again. See tests # for an example. remainder_iterator = chain(transition, it) return true_iterator(), remainder_iterator def triplewise(iterable): """Return overlapping triplets from *iterable*. >>> list(triplewise('ABCDE')) [('A', 'B', 'C'), ('B', 'C', 'D'), ('C', 'D', 'E')] """ for (a, _), (b, c) in pairwise(pairwise(iterable)): yield a, b, c def sliding_window(iterable, n): """Return a sliding window of width *n* over *iterable*. >>> list(sliding_window(range(6), 4)) [(0, 1, 2, 3), (1, 2, 3, 4), (2, 3, 4, 5)] If *iterable* has fewer than *n* items, then nothing is yielded: >>> list(sliding_window(range(3), 4)) [] For a variant with more features, see :func:`windowed`. """ it = iter(iterable) window = deque(islice(it, n - 1), maxlen=n) for x in it: window.append(x) yield tuple(window) def subslices(iterable): """Return all contiguous non-empty subslices of *iterable*. >>> list(subslices('ABC')) [['A'], ['A', 'B'], ['A', 'B', 'C'], ['B'], ['B', 'C'], ['C']] This is similar to :func:`substrings`, but emits items in a different order. """ seq = list(iterable) slices = starmap(slice, combinations(range(len(seq) + 1), 2)) return map(operator.getitem, repeat(seq), slices) def polynomial_from_roots(roots): """Compute a polynomial's coefficients from its roots. >>> roots = [5, -4, 3] # (x - 5) * (x + 4) * (x - 3) >>> polynomial_from_roots(roots) # x^3 - 4 * x^2 - 17 * x + 60 [1, -4, -17, 60] """ factors = zip(repeat(1), map(operator.neg, roots)) return list(reduce(convolve, factors, [1])) def iter_index(iterable, value, start=0, stop=None): """Yield the index of each place in *iterable* that *value* occurs, beginning with index *start* and ending before index *stop*. >>> list(iter_index('AABCADEAF', 'A')) [0, 1, 4, 7] >>> list(iter_index('AABCADEAF', 'A', 1)) # start index is inclusive [1, 4, 7] >>> list(iter_index('AABCADEAF', 'A', 1, 7)) # stop index is not inclusive [1, 4] The behavior for non-scalar *values* matches the built-in Python types. >>> list(iter_index('ABCDABCD', 'AB')) [0, 4] >>> list(iter_index([0, 1, 2, 3, 0, 1, 2, 3], [0, 1])) [] >>> list(iter_index([[0, 1], [2, 3], [0, 1], [2, 3]], [0, 1])) [0, 2] See :func:`locate` for a more general means of finding the indexes associated with particular values. """ seq_index = getattr(iterable, 'index', None) if seq_index is None: # Slow path for general iterables it = islice(iterable, start, stop) for i, element in enumerate(it, start): if element is value or element == value: yield i else: # Fast path for sequences stop = len(iterable) if stop is None else stop i = start - 1 try: while True: yield (i := seq_index(value, i + 1, stop)) except ValueError: pass def sieve(n): """Yield the primes less than n. >>> list(sieve(30)) [2, 3, 5, 7, 11, 13, 17, 19, 23, 29] """ if n > 2: yield 2 start = 3 data = bytearray((0, 1)) * (n // 2) limit = math.isqrt(n) + 1 for p in iter_index(data, 1, start, limit): yield from iter_index(data, 1, start, p * p) data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p))) start = p * p yield from iter_index(data, 1, start) def _batched(iterable, n, *, strict=False): """Batch data into tuples of length *n*. If the number of items in *iterable* is not divisible by *n*: * The last batch will be shorter if *strict* is ``False``. * :exc:`ValueError` will be raised if *strict* is ``True``. >>> list(batched('ABCDEFG', 3)) [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)] On Python 3.13 and above, this is an alias for :func:`itertools.batched`. """ if n < 1: raise ValueError('n must be at least one') it = iter(iterable) while batch := tuple(islice(it, n)): if strict and len(batch) != n: raise ValueError('batched(): incomplete batch') yield batch if hexversion >= 0x30D00A2: from itertools import batched as itertools_batched def batched(iterable, n, *, strict=False): return itertools_batched(iterable, n, strict=strict) else: batched = _batched batched.__doc__ = _batched.__doc__ def transpose(it): """Swap the rows and columns of the input matrix. >>> list(transpose([(1, 2, 3), (11, 22, 33)])) [(1, 11), (2, 22), (3, 33)] The caller should ensure that the dimensions of the input are compatible. If the input is empty, no output will be produced. """ return _zip_strict(*it) def reshape(matrix, cols): """Reshape the 2-D input *matrix* to have a column count given by *cols*. >>> matrix = [(0, 1), (2, 3), (4, 5)] >>> cols = 3 >>> list(reshape(matrix, cols)) [(0, 1, 2), (3, 4, 5)] """ return batched(chain.from_iterable(matrix), cols) def matmul(m1, m2): """Multiply two matrices. >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)])) [(49, 80), (41, 60)] The caller should ensure that the dimensions of the input matrices are compatible with each other. """ n = len(m2[0]) return batched(starmap(_sumprod, product(m1, transpose(m2))), n) def factor(n): """Yield the prime factors of n. >>> list(factor(360)) [2, 2, 2, 3, 3, 5] """ for prime in sieve(math.isqrt(n) + 1): while not n % prime: yield prime n //= prime if n == 1: return if n > 1: yield n def polynomial_eval(coefficients, x): """Evaluate a polynomial at a specific value. Example: evaluating x^3 - 4 * x^2 - 17 * x + 60 at x = 2.5: >>> coefficients = [1, -4, -17, 60] >>> x = 2.5 >>> polynomial_eval(coefficients, x) 8.125 """ n = len(coefficients) if n == 0: return x * 0 # coerce zero to the type of x powers = map(pow, repeat(x), reversed(range(n))) return _sumprod(coefficients, powers) def sum_of_squares(it): """Return the sum of the squares of the input values. >>> sum_of_squares([10, 20, 30]) 1400 """ return _sumprod(*tee(it)) def polynomial_derivative(coefficients): """Compute the first derivative of a polynomial. Example: evaluating the derivative of x^3 - 4 * x^2 - 17 * x + 60 >>> coefficients = [1, -4, -17, 60] >>> derivative_coefficients = polynomial_derivative(coefficients) >>> derivative_coefficients [3, -8, -17] """ n = len(coefficients) powers = reversed(range(1, n)) return list(map(operator.mul, coefficients, powers)) def totient(n): """Return the count of natural numbers up to *n* that are coprime with *n*. >>> totient(9) 6 >>> totient(12) 4 """ # The itertools docs use unique_justseen instead of set; see # https://github.com/more-itertools/more-itertools/issues/823 for p in set(factor(n)): n = n // p * (p - 1) return n _vendor/more_itertools/__init__.py 0000644 00000000225 15030122015 0013343 0 ustar 00 """More routines for operating on iterables, beyond itertools""" from .more import * # noqa from .recipes import * # noqa __version__ = '10.3.0' _vendor/backports/tarfile/__pycache__/__init__.cpython-310.pyc 0000644 00000214360 15030122015 0020261 0 ustar 00 o �h˧ � @ s� d Z dZdZdZddlmZ ddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlmZ zddlZW n eyI dZY nw zddlZW n ey[ dZY nw eeefZg d �Zd Zd Zed Z d Z dZ dZ dZ dZ!dZ"d Z#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-d Z.d Z/d Z0dZ1dZ2d Z3e3Z4e"e#e$e%e(e)e*e&e'e+e,e-f Z5e"e#e*e-fZ6e+e,e-fZ7d Z8h d!�Z9e:e:e:e;e;e;d"�Z<ej=d#kr�d$Z>ne�?� Z>d%d&� Z@d'd(� ZAd)d*� ZBd+e4fd,d-�ZCd.d/� ZDdedfd0d1�ZEd2d3� ZFG d4d5� d5eG�ZHG d6d7� d7eH�ZIG d8d9� d9eH�ZJG d:d;� d;eH�ZKG d<d=� d=eH�ZLG d>d?� d?eH�ZMG d@dA� dAeM�ZNG dBdC� dCeM�ZOG dDdE� dEeM�ZPG dFdG� dGeM�ZQG dHdI� dIeM�ZRG dJdK� dK�ZSG dLdM� dM�ZTG dNdO� dOeU�ZVG dPdQ� dQeU�ZWG dRdS� dSe jX�ZYG dTdU� dUeH�ZZG dVdW� dWeZ�Z[G dXdY� dYeZ�Z\G dZd[� d[eZ�Z]G d\d]� d]eZ�Z^G d^d_� d_eZ�Z_dsdadb�Z`dcdd� Zadedf� Zbdgdh� Zceaebecdi�ZdeU� ZeG djdk� dkeU�ZfG dldm� dmeU�Zgdndo� ZhegjZdpdq� Ziejdrk�r�ei� dS dS )tz,Read from and write to tar format archives. z0.9.0u" Lars Gustäbel (lars@gustaebel.de)u4 Gustavo Niemeyer, Niels Gustäbel, Richard Townsend.� )�openN� )� removesuffix)�TarFile�TarInfo� is_tarfile�TarError� ReadError�CompressionError� StreamError� ExtractError� HeaderError�ENCODING� USTAR_FORMAT� GNU_FORMAT� PAX_FORMAT�DEFAULT_FORMATr �fully_trusted_filter� data_filter� tar_filter� FilterError�AbsoluteLinkError�OutsideDestinationError�SpecialFileError�AbsolutePathError�LinkOutsideDestinationError� i � s ustar s ustar 00�d � � 0� 1� 2� 3� 4� 5� 6� 7� L� K� S� x� g� X� )�path�linkpath�size�mtime�uid�gid�uname�gname> r/ r6 r5 r0 )�atime�ctimer2 r3 r4 r1 �nt�utf-8c C s8 | du rt d��| �||�} | d|� |t| � t S )z8Convert a string to a null-terminated bytes object. Nz metadata cannot contain None)� ValueError�encode�len�NUL)�s�length�encoding�errors� rC �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/backports/tarfile/__init__.py�stn� s rE c C s* | � d�}|dkr| d|� } | �||�S )z8Convert a null-terminated bytes object to a string. r ���N)�find�decode)r? rA rB �prC rC rD �nts� s rJ c C s� | d dv r2d}t t| �d �D ]}|dK }|| |d 7 }q| d dkr0dt| �d | }|S zt| dd�} t| �� p?d d�}W |S tyO td ��w ) z/Convert a number field to a python number. r )� � r � rL � �ascii�strict�0�invalid header)�ranger= rJ �int�stripr; �InvalidHeaderError)r? �n�irC rC rD �nti� s � ��rY rM c C s� | }t | �} d| krd|d k r%n ntd|d | f d�t }|S |tkrmd|d | kr<d|d k rmn td ��| dkrKtdg�}n tdg�}d| | } t|d �D ]}|�d| d@ � | dL } q\|S td ��) z/Convert a python number to a number field. r rM r z%0*orO rN rK rL zoverflow in number field)rT �bytesr> r � bytearrayrS �insertr; )rW �digits�format� original_nr? rX rC rC rD �itn� s 0� � �r` c C s0 dt t�d| �� }dt t�d| �� }||fS )a� Calculate the checksum for a member's header by summing up all characters except for the chksum field which is treated as if it was filled with spaces. According to the GNU tar sources, some tars (Sun and NeXT) calculate chksum with signed char, which will be different if there are chars in the buffer with the high bit set. So we calculate two checksums, unsigned and signed. rN � 148B8x356B� 148b8x356b)�sum�struct� unpack_from)�buf�unsigned_chksum� signed_chksumrC rC rD � calc_chksums� s ri c C s� |pd}|dkr dS |du rt �| ||� dS t||�\}}t|�D ]}| �|�}t|�|k r3|d��|�|� q"|dkrQ| �|�}t|�|k rL|d��|�|� dS )zjCopy length bytes from fileobj src to fileobj dst. If length is None, copy the entire content. i @ r N�unexpected end of data)�shutil� copyfileobj�divmodrS �readr= �write) �src�dstr@ � exception�bufsize�blocks� remainder�brf rC rC rD rl � s$ rl c C s8 t tjdd �}|d ur| �|d��|�} t| dd� d S )NrA �backslashreplace� )�end)�getattr�sys�stdoutr< rH �print)r? rA rC rC rD � _safe_print s r~ c @ � e Zd ZdZdS )r zBase exception.N��__name__� __module__� __qualname__�__doc__rC rC rC rD r � r c @ r )r z%General exception for extract errors.Nr� rC rC rC rD r r� r c @ r )r z&Exception for unreadable tar archives.Nr� rC rC rC rD r r� r c @ r )r z.Exception for unavailable compression methods.Nr� rC rC rC rD r r� r c @ r )r z=Exception for unsupported operations on stream-like TarFiles.Nr� rC rC rC rD r r� r c @ r )r z!Base exception for header errors.Nr� rC rC rC rD r r� r c @ r )�EmptyHeaderErrorz Exception for empty headers.Nr� rC rC rC rD r� r� r� c @ r )�TruncatedHeaderErrorz Exception for truncated headers.Nr� rC rC rC rD r� # r� r� c @ r )�EOFHeaderErrorz"Exception for end of file headers.Nr� rC rC rC rD r� & r� r� c @ r )rV z Exception for invalid headers.Nr� rC rC rC rD rV ) r� rV c @ r )�SubsequentHeaderErrorz3Exception for missing and invalid extended headers.Nr� rC rC rC rD r� , r� r� c @ �0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) � _LowLevelFilez�Low-level file object. Supports reading and writing. It is used instead of a regular file object for streaming access. c C sF t jt jt jB t jB d�| }tt d�r|t jO }t �||d�| _d S )N��r�w�O_BINARYi� ) �os�O_RDONLY�O_WRONLY�O_CREAT�O_TRUNC�hasattrr� r �fd)�self�name�moderC rC rD �__init__9 s �� z_LowLevelFile.__init__c C s t �| j� d S �N)r� �closer� �r� rC rC rD r� B s z_LowLevelFile.closec C s t �| j|�S r� )r� rn r� �r� r1 rC rC rD rn E � z_LowLevelFile.readc C s t �| j|� d S r� )r� ro r� �r� r? rC rC rD ro H s z_LowLevelFile.writeN)r� r� r� r� r� r� rn ro rC rC rC rD r� 3 s r� c @ sr e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z d dd�Z dd� Z dd� Zdd� ZdS ) �_Streama� Class that serves as an adapter between TarFile and a stream-like object. The stream-like object only needs to have a read() or write() method that works with bytes, and the method is accessed blockwise. Use of gzip or bzip2 compression is possible. A stream-like object could be for example: sys.stdin.buffer, sys.stdout.buffer, a socket, a tape device etc. _Stream is intended to be used only internally. c C s� d| _ |du rt||�}d| _ |dkrt|�}|�� }|p d| _|| _|| _|| _|| _d| _ d| _ d| _ z�|dkrmzddl }W n t yL td �d�w || _ |�d�| _|d kre|j| _| �� W dS | �|� W dS |d kr�zddl}W n t y� td �d�w |d kr�d| _|�� | _t| _W dS |�|�| _W dS |d kr�zddl} W n t y� td�d�w |d kr�d| _| � � | _| j | _W dS | � � | _W dS |dkr�td| ��W dS | j s�| j� � d| _ � )z$Construct a _Stream object. TNF�*� � r �gzz zlib module is not availabler� �bz2�bz2 module is not available�xz� lzma module is not available�tar�unknown compression type %r) � _extfileobjr� � _StreamProxy� getcomptyper� r� �comptype�fileobjrs rf �pos�closed�zlib� ImportErrorr �crc32�crc�errorrr � _init_read_gz�_init_write_gzr� �dbuf�BZ2Decompressor�cmp�OSError� BZ2Compressor�lzma�LZMADecompressor� LZMAError�LZMACompressorr� ) r� r� r� r� r� rs � compresslevelr� r� r� rC rC rD r� W st � � � � z_Stream.__init__c C s$ t | d�r| js| �� d S d S d S )Nr� )r� r� r� r� rC rC rD �__del__� s �z_Stream.__del__c C s� | j �|| j j| j j | j jd�| _t�dtt � � ��}| � d| d � | j � d�r3| j dd� | _ t j�| j �| _ | � | j �dd �t � dS ) z6Initialize for writing with gzip compression. r �<Ls �s ��.gzN���z iso-8859-1�replace)r� � compressobj�DEFLATED� MAX_WBITS� DEF_MEM_LEVELr� rd �packrT �time�_Stream__writer� �endswithr� r/ �basenamer< r> )r� r� � timestamprC rC rD r� � s � z_Stream._init_write_gzc C sR | j dkr| j�|| j�| _| jt|�7 _| j dkr"| j�|�}| �|� dS )z&Write string s to the stream. r� r� N) r� r� r� r� r� r= r� �compressr� r� rC rC rD ro � s z _Stream.writec C s` | j |7 _ t| j �| jkr.| j�| j d| j� � | j | jd� | _ t| j �| jksdS dS )z]Write string s to the stream if a whole new block is ready to be written. N)rf r= rs r� ro r� rC rC rD �__write� s �z_Stream.__writec C s� | j rdS d| _ zP| jdkr | jdkr | j| j�� 7 _| jdkrL| jrL| j�| j� d| _| jdkrL| j�t� d| j �� | j�t� d| j d@ �� W | j sW| j� � dS dS | j sb| j� � w w ) z[Close the _Stream object. No operation should be done on it afterwards. NTr� r� r� r� r� l �� )r� r� r� rf r� �flushr� ro rd r� r� r� r� r� r� rC rC rD r� � s$ � � �z _Stream.closec C s� | j �| j j �| _d| _| �d�dkrtd��| �d�dkr#td��t| �d��}| �d� |d @ rHt| �d��d t| �d�� }| � |� |d @ rZ | �d�}|rX|t krYnqM|d @ rl | �d�}|rj|t krknq_|d@ rw| �d� dS dS )z:Initialize for reading a gzip compressed fileobj. r� r. s ��not a gzip filer � z unsupported compression method� � rN rM T� N) r� � decompressobjr� r� r� � _Stream__readr r �ordrn r> )r� �flag�xlenr? rC rC rD r� � s4 � ��z_Stream._init_read_gzc C � | j S )z3Return the stream's file pointer position. )r� r� rC rC rD �tell� � z _Stream.tellr c C sV || j dkr't|| j | j�\}}t|�D ]}| �| j� q| �|� | j S td��)zXSet the stream's file pointer to pos. Negative seeking is forbidden. r z seeking backwards is not allowed)r� rm rs rS rn r )r� r� rt ru rX rC rC rD �seek s �z _Stream.seekc C s, |dusJ �| � |�}| jt|�7 _|S )z5Return the next size number of bytes from the stream.N)�_readr� r= )r� r1 rf rC rC rD rn s z _Stream.readc C s� | j dkr | �|�S t| j�}| jg}||k rU| jr!| j}d| _n | j�| j�}|s+n*z| j� |�}W n | j yE } zt d�|�d}~ww |� |� |t|�7 }||k sd� |�}||d� | _|d|� S )z+Return size bytes from the stream. r� r� zinvalid compressed dataN)r� r� r= r� rf r� rn rs r� � decompressrr r �append�join)r� r1 �c�trf �erC rC rD r� s. �� � z _Stream._readc C sp t | j�}| jg}||k r&| j�| j�}|sn|�|� |t |�7 }||k s d�|�}||d� | _|d|� S )zsReturn size bytes from stream. If internal buffer is empty, read another block from the stream. r� N)r= rf r� rn rs r� r� )r� r1 r� r� rf rC rC rD �__read/ s � z_Stream.__readN)r )r� r� r� r� r� r� r� ro r� r� r� r� r� rn r� r� rC rC rC rD r� K s G r� c @ r� ) r� zsSmall proxy class that enables transparent compression detection for the Stream interface (mode 'r|*'). c C s || _ | j �t�| _d S r� )r� rn � BLOCKSIZErf )r� r� rC rC rD r� E s z_StreamProxy.__init__c C s | j j| _| jS r� )r� rn rf r� rC rC rD rn I s z_StreamProxy.readc C sL | j �d�rdS | j dd� dkr | j dd� dkr d S | j �d �r$d S d S ) Ns �r� r � s BZhr� � s 1AY&SYr� )s ] �s �7zXZr� r� )rf � startswithr� rC rC rD r� M s $ z_StreamProxy.getcomptypec C s | j �� d S r� )r� r� r� rC rC rD r� W r� z_StreamProxy.closeN)r� r� r� r� r� rn r� r� rC rC rC rD r� @ s r� c @ sv e Zd ZdZddd�Zdd� Zedd� �Zd d � Zd d � Z d d� Z dd� Z e j fdd�Zddd�Zdd� Zdd� ZdS )� _FileInFilezA thin wrapper around an existing file object that provides a part of its data as an individual file object. Nc C s� || _ || _|| _d| _|| _d| _|d u rd|fg}d| _g | _d}| j}|D ]&\}}||kr:| j�d||d f� | j�d||| |f� ||7 }|| }q(|| jk ra| j�d|| jd f� d S d S )Nr FT) r� �offsetr1 �positionr� r� � map_index�mapr� )r� r� r� r1 r� � blockinfo�lastpos�realposrC rC rD r� d s* �z_FileInFile.__init__c C s d S r� rC r� rC rC rD r� } � z_FileInFile.flushc C � dS )N�rbrC r� rC rC rD r� � s z_FileInFile.modec C r� �NTrC r� rC rC rD �readable� r� z_FileInFile.readablec C r� �NFrC r� rC rC rD �writable� r� z_FileInFile.writablec C s | j �� S r� )r� �seekabler� rC rC rD r� � � z_FileInFile.seekablec C r� )z*Return the current file position. )r� r� rC rC rD r� � r� z_FileInFile.tellc C s� |t jkrtt|d�| j�| _| jS |t jkr4|dk r't| j| d�| _| jS t| j| | j�| _| jS |t jkrItt| j| | j�d�| _| jS td��)z(Seek to a position in the file. r zInvalid argument) �io�SEEK_SET�min�maxr1 r� �SEEK_CUR�SEEK_ENDr; )r� r� �whencerC rC rD r� � s �� ��z_FileInFile.seekc C s |du r | j | j }n t|| j | j �}d}|dkr� | j| j \}}}}|| j kr0|k r3n nn| jd7 _| jt| j�krEd| _qt||| j �}|rp| j�|| j| � | j�|�}t|�|krkt d��||7 }n|t | 7 }||8 }| j|7 _|dks|S )z!Read data from the file. Nr� r Tr rj ) r1 r� r r� r� r= r� r� rn r r> ) r� r1 rf �data�start�stopr� r@ rv rC rC rD rn � s2 � �z_FileInFile.readc C s& | � t|��}||d t|��< t|�S r� )rn r= )r� rv rf rC rC rD �readinto� s z_FileInFile.readintoc C s d| _ d S r� )r� r� rC rC rD r� � r z_FileInFile.closer� )r� r� r� r� r� r� �propertyr� r� r� r� r� r r r� rn r r� rC rC rC rD r� ^ s r� c � e Zd Z� fdd�Z� ZS )� ExFileObjectc s* t |j|j|j|j|j�}t� �|� d S r� )r� r� � offset_datar1 r� �sparse�superr� )r� �tarfile�tarinfor� �� __class__rC rD r� � s �zExFileObject.__init__�r� r� r� r� � __classcell__rC rC r rD r � s r c @ s e Zd ZdS )r N)r� r� r� rC rC rC rD r � s r c r )r c s || _ t� �d|j�d�� d S )Nzmember z has an absolute path�r r r� r� �r� r r rC rD r� � s zAbsolutePathError.__init__r rC rC r rD r � � r c r )r c �. || _ || _t� �|j�d|�d�d � d S )Nz would be extracted to �, � which is outside the destination�r �_pathr r� r� �r� r r/ r rC rD r� � � �z OutsideDestinationError.__init__r rC rC r rD r � r r c r )r c � || _ t� �|j�d�� d S )Nz is a special filer r r rC rD r� � � zSpecialFileError.__init__r rC rC r rD r � r r c r )r c r" )Nz is a link to an absolute pathr r r rC rD r� � r# zAbsoluteLinkError.__init__r rC rC r rD r � r r c r )r c r )Nz would link to r r r r r rC rD r� � r! z$LinkOutsideDestinationError.__init__r rC rC r rD r � r r Tc C s� i }| j }tj�|�}|�dtjf�r | j�dtj � }|d< tj�|�r*t| ��tj�tj� ||��}tj� ||g�|krDt | |��| j }|d ur~|d@ }|ru| � � sY| �� rf|d@ sa|dM }|dO }n| �� sn| �� rqd }nt| ��|| j kr~||d< |r�| jd ur�d |d< | jd ur�d |d < | jd ur�d |d < | jd ur�d |d < | �� s�| �� r�tj�| j�r�t| ��| �� r�tj� |tj�|�| j�}ntj� || j�}tj�|�}tj� ||g�|kr�t| |��|S ) N�/r� i� �@ i����� r� r3 r4 r5 r6 )r� r� r/ �realpathr� �sep�lstrip�isabsr r� � commonpathr r� �isreg�islnk�isdir�issymr r3 r4 r5 r6 �linknamer �dirnamer )�member� dest_path�for_data� new_attrsr� � target_pathr� rC rC rD �_get_filtered_attrs� s^ �� r7 c C s | S r� rC )r2 r3 rC rC rD r 6 r� r c C s, t | |d�}|r| jdi |�ddi��S | S )NF�deeprC �r7 r� �r2 r3 r5 rC rC rD r 9 � r c C s, t | |d�}|r| jdi |�ddi��S | S )NTr8 FrC r9 r: rC rC rD r ? r; r )� fully_trustedr� r c @ sF e Zd ZdZedi dd�dd�dd�dd �d d �d d �dd�dd�dd�dd�dd�dd�dd�d d �d d �d d!�d"d#�d$d%�d&d%�d'd%��Zd�d)d*�Zed+d,� �Zej d-d,� �Zed.d/� �Z e j d0d/� �Z ed1d2� �Z e j d3d2� �Z d4d5� Z e e e e e e e e d6e d7� d8d9�Zd:d;� Zeed<fd=d>�Zd?d@� ZdAdB� ZdCdD� ZedEdF� �ZdGdH� ZedIdJ� �ZedKdL� �ZedMdN� �Z edOdP� �Z edQdR� �Z edSdT� �Z dUdV� Z dWdX� Z!dYdZ� Z"d[d\� Z#d]d^� Z$d_d`� Z%dadb� Z&dcdd� Z'dedf� Z(dgdh� Z)didj� Z*dkdl� Z+dmdn� Z,dodp� Z-dqdr� Z.dsdt� Z/dudv� Z0dwdx� Z1dydz� Z2d{d|� Z3d}d~� Z4d%S )�r a Informational class which holds the details about an archive member given by a tar header block. TarInfo objects are returned by TarFile.getmember(), TarFile.getmembers() and TarFile.gettarinfo() and are usually created internally. r� zName of the archive member.r� zPermission bits.r3 z6User ID of the user who originally stored this member.r4 z7Group ID of the user who originally stored this member.r1 zSize in bytes.r2 zTime of last modification.�chksumzHeader checksum.�typez�File type. type is usually one of these constants: REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE.r0 zcName of the target file name, which is only present in TarInfo objects of type LNKTYPE and SYMTYPE.r5 z User name.r6 z Group name.�devmajorzDevice major number.�devminorzDevice minor number.r� zThe tar header starts here.r z The file's data starts here.� pax_headerszMA dictionary containing key-value pairs of an associated pax extended header.r zSparse member information.�_tarfileN�_sparse_structs� _link_targetr� c C sj || _ d| _d| _d| _d| _d| _d| _t| _d| _ d| _ d| _ d| _ d| _ d| _d| _d| _i | _dS )zXConstruct a TarInfo object. name is the optional name of the member. i� r r� N)r� r� r3 r4 r1 r2 r= �REGTYPEr> r0 r5 r6 r? r@ r� r r rA �r� r� rC rC rD r� u s" zTarInfo.__init__c C s dd l }|jdtdd� | jS �Nr zhThe undocumented "tarfile" attribute of TarInfo objects is deprecated and will be removed in Python 3.16r. �� stacklevel��warnings�warn�DeprecationWarningrB )r� rK rC rC rD r � s �zTarInfo.tarfilec C s" dd l }|jdtdd� || _d S rG rJ )r� r rK rC rC rD r � s � c C r� )z(In pax headers, "name" is called "path".�r� r� rC rC rD r/ � r� z TarInfo.pathc C � || _ d S r� rN rF rC rC rD r/ � � c C r� )z0In pax headers, "linkname" is called "linkpath".�r0 r� rC rC rD r0 � r� zTarInfo.linkpathc C rO r� rQ )r� r0 rC rC rD r0 � rP c C s d| j j| jt| �f S )Nz<%s %r at %#x>)r r� r� �idr� rC rC rD �__repr__� s zTarInfo.__repr__T) r� r2 r� r0 r3 r4 r5 r6 r8 �_KEEPc C s� | rt �| �} nt � | �} || ur|| _|| ur|| _|| ur"|| _|| ur)|| _|| ur0|| _|| ur7|| _|| ur>|| _|| urE|| _ | S )zGReturn a deep copy of self with the given attributes replaced. ) �copy�deepcopyr� r2 r� r0 r3 r4 r5 r6 ) r� r� r2 r� r0 r3 r4 r5 r6 r8 rT �resultrC rC rD r� � s( zTarInfo.replacec C s� | j du rd}n| j d@ }| j|| j| j| j| j| j| j| j| j | j | j | j d� }|d t kr>|d �d�s>|d d7 < |S )z9Return the TarInfo's attributes as a dictionary. N� ) r� r� r3 r4 r1 r2 r= r> r0 r5 r6 r? r@ r> r� r$ )r� r� r3 r4 r1 r2 r= r> r0 r5 r6 r? r@ �DIRTYPEr� )r� r� �inforC rC rD �get_info� s( �zTarInfo.get_info�surrogateescapec C sv | � � }|�� D ]\}}|du rtd| ��q|tkr"| �|||�S |tkr-| �|||�S |tkr7| �||�S td��)z<Return a tar header as a string of 512 byte blocks. Nz%s may not be Nonezinvalid format) r[ �itemsr; r �create_ustar_headerr �create_gnu_headerr �create_pax_header)r� r^ rA rB rZ r� �valuerC rC rD �tobuf� s � z TarInfo.tobufc C sn t |d< t|d �||��tkrtd��t|d �||��tkr/| �|d ||�\|d< |d< | �|t||�S )z3Return the object as a ustar header block. �magicr0 zlinkname is too longr� �prefix) � POSIX_MAGICr= r< � LENGTH_LINKr; � LENGTH_NAME�_posix_split_name�_create_headerr )r� rZ rA rB rC rC rD r^ � s zTarInfo.create_ustar_headerc C s� t |d< d}t|d �||��tkr || �|d t||�7 }t|d �||��tkr6|| �|d t||�7 }|| �|t ||� S )z:Return the object as a GNU header block sequence. rc r� r0 r� ) � GNU_MAGICr= r< rf �_create_gnu_long_header�GNUTYPE_LONGLINKrg �GNUTYPE_LONGNAMEri r )r� rZ rA rB rf rC rC rD r_ s zTarInfo.create_gnu_headerc C sD t |d< | j�� }ddtfddtfddfD ]2\}}}||v r qz || �dd � W n ty8 || ||< Y qw t|| �|krG|| ||< qd D ]A\}}d }|| } t| t �} | r_t | �n| } d | krod |d k swn d ||< d}n| r| ||< d}|r�||vr�t | �||< qJ|r�| � |t |�} nd} | | �|tdd� S )z�Return the object as a ustar header block. If it cannot be represented this way, prepend a pax extended header sequence with supplement information. rc r� r/ r0 r0 )r5 r5 � )r6 r6 rn rO rP ))r3 rM )r4 rM )r1 � )r2 ro Fr rM r Tr� r� )re rA rU rg rf r< �UnicodeEncodeErrorr= � isinstance�float�round�str�_create_pax_generic_header�XHDTYPEri r ) r� rZ rA rA r� �hnamer@ r] � needs_pax�val� val_is_float�val_intrf rC rC rD r` sD � � � �zTarInfo.create_pax_headerc C s | � |td�S )zAReturn the object as a pax global header block sequence. r: )ru �XGLTYPE)�clsrA rC rC rD �create_pax_global_headerR s z TarInfo.create_pax_global_headerc C s| |� d�}tdt|��D ]-}d�|d|� �}d�||d� �}t|�||��tkr9t|�||��tkr9 ||fS q td��)zUSplit a name longer than 100 chars into a prefix and a name part. r$ r Nzname is too long)�splitrS r= r� r< � LENGTH_PREFIXrg r; )r� r� rA rB � componentsrX rd rC rC rD rh X s ��zTarInfo._posix_split_namec C s� | � d�ttfv }|r t| � dd�d|�}t| � dd�d|�}ntdd||�}tdd||�}| � dt�}|du r<td��t| � d d�d ||�t| � d d�d @ d|�t| � d d�d|�t| � dd�d|�t| � dd�d|�t| � dd�d|�d|t| � dd�d ||�| � dt�t| � dd�d||�t| � dd�d||�||t| � dd�d||�g}t� dt d� |��} t | t d� �d } | dd � t d | d � | d d� } | S ) z�Return a header block. info is a dictionary with file information, format must be one of the *_FORMAT constants. r> r? r rM r@ r� Nz TarInfo.type must not be Noner� r r� rX r3 r4 r1 ro r2 s r0 rc r5 rn r6 rd r z%dsr� i����z%06o rO i����)�get�CHRTYPE�BLKTYPEr` rE rE r; re rd r� r� r� ri rZ ) rZ r^ rA rB �has_device_fieldsr? r@ �filetype�partsrf r= rC rC rD ri h s: �&zTarInfo._create_headerc C s. t t| �t�\}}|dkr| t| t 7 } | S )zdReturn the string payload filled with zero bytes up to the next 512 byte border. r )rm r= r� r> )�payloadrt ru rC rC rD �_create_payload� s zTarInfo._create_payloadc C sR |� ||�t }i }d|d< ||d< t|�|d< t|d< | �|t||�| �|� S )zTReturn a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence for name. z ././@LongLinkr� r> r1 rc )r< r> r= rj ri r r� )r} r� r> rA rB rZ rC rC rD rk � s �z TarInfo._create_gnu_long_headerc C s, d}|� � D ]\}}z|�dd� W q ty d}Y nw d}|r'|d7 }|� � D ]I\}}|�d�}|r=|�|d�}n|�d�}t|�t|� d }d } } |tt| �� } | | kr^n| } qQ|tt| �d �d | d | d 7 }q+i } d| d< || d< t|�| d< t| d< | �| td d�| � |� S )z�Return a POSIX.1-2008 extended or global header sequence that contains a list of keyword, value pairs. The values must be strings. Fr: rP Tr� s 21 hdrcharset=BINARY r\ r� r rO � � =� z././@PaxHeaderr� r> r1 rc r� ) r] r< rp r= rt rZ re ri r r� ) r} rA r> rA �binary�keywordra �records�lrW rI rZ rC rC rD ru � sB � �( �z"TarInfo._create_pax_generic_headerc C sf t |�dkr td��t |�tkrtd��|�t�tkr td��t|dd� �}|t|�vr1t d��| � }t |dd� ||�|_ t|dd � �|_ t|d d � �|_ t|d d � �|_t|d d � �|_t|d d� �|_||_|dd � |_t |d d� ||�|_t |dd� ||�|_t |dd� ||�|_t|dd� �|_t|dd� �|_t |dd� ||�}|jtkr�|j �d�r�t|_|jtk�rd}g }t d�D ]0} zt|||d � �} t||d |d � �} W n t y� Y n w |� | | f� |d7 }q�t |d �} t|dd � �} || | f|_ |�!� �r |j �"d�|_ |�r1|jt#v�r1|d |j |_ |S ) zAConstruct a TarInfo object from a 512 byte bytes object. r z empty headerztruncated headerzend of file header� � z bad checksumr �l �t �| � � i i i) iI iQ iY i� r$ i� r� ro � i� i� i� )$r= r� r� r� �countr> r� rY ri rV rJ r� r� r3 r4 r1 r2 r= r> r0 r5 r6 r? r@ �AREGTYPEr� rY �GNUTYPE_SPARSErS r; r� �boolrC r. �rstrip� GNU_TYPES)r} rf rA rB r= �objrd r� �structsrX r� �numbytes� isextended�origsizerC rC rD �frombuf� s\ � zTarInfo.frombufc C s8 |j �t�}| �||j|j�}|j �� t |_|�|�S )zOReturn the next TarInfo object from TarFile object tarfile. ) r� rn r� r� rA rB r� r� � _proc_member)r} r rf r� rC rC rD � fromtarfile s zTarInfo.fromtarfilec C sP | j ttfv r | �|�S | j tkr| �|�S | j tttfv r#| � |�S | � |�S )zYChoose the right processing method depending on the type and call it. ) r> rm rl � _proc_gnulongr� � _proc_sparserv r| �SOLARIS_XHDTYPE� _proc_pax� _proc_builtin)r� r rC rC rD r� 4 s zTarInfo._proc_memberc C sh |j �� | _| j}| �� s| jtvr|| �| j�7 }||_| � |j |j |j � | � � r2| j�d�| _| S )zfProcess a builtin type or an unknown type which will be treated as a regular file. r$ )r� r� r r, r> �SUPPORTED_TYPES�_blockr1 r� �_apply_pax_inforA rA rB r. r� r� )r� r r� rC rC rD r� A s zTarInfo._proc_builtinc C s� |j �| �| j��}z| �|�}W n ty$ } ztt|��d�d}~ww | j|_| j t kr8t ||j |j �|_n| j tkrFt ||j |j �|_|�� rQt|jd�|_|S )zSProcess the blocks that hold a GNU longname or longlink member. Nr$ )r� rn r� r1 r� r r� rt r� r> rm rJ rA rB r� rl r0 r. r )r� r rf �nextr� rC rC rD r� W s �� zTarInfo._proc_gnulongc C s� | j \}}}| ` |rS|j�t�}d}td�D ]4}zt|||d � �}t||d |d � �} W n ty: Y nw |rF| rF|�|| f� |d7 }qt|d �}|s || _ |j� � | _ | j | � | j � |_|| _ | S )z8Process a GNU sparse header plus extra headers. r � ro r� i� )rC r� rn r� rS rY r; r� r� r r� r r� r1 r� ) r� r r� r� r� rf r� rX r� r� rC rC rD r� r s, � � zTarInfo._proc_sparsec C s6 |j �| �| j��}| jtkr|j}n|j�� }t� d|�}|dur,|� d�� d�|d< |� d�}|dkr9|j }nd}t�d�}d}|�||� }r�|�� \} } t| �} | dkr\td ��||�d �d |�d�| d � } | �| dd|j�} | tv r�| �| ||j |j�} n | �| dd|j�} | || < || 7 }|�||� }sJz| �|�} W n ty� } ztt| ��d�d} ~ ww d |v r�| � | |� n!d |v r�| � | ||� n|� d �dkr�|� d�dkr�| � | ||� | jt t fv �r| �!||j |j� | j"| _"d|v �r| j#}| �$� �s| jt%v�r|| �| j�7 }||_"| S )zVProcess an extended or global header as described in POSIX.1-2008. s \d+ hdrcharset=([^\n]+)\nNr r: � hdrcharset�BINARYs (\d+) ([^=]+)=r rR r. �GNU.sparse.map�GNU.sparse.sizezGNU.sparse.major�1zGNU.sparse.minorrQ r1 )&r� rn r� r1 r> r| rA rU �re�search�grouprH r� rA �compile�match�groupsrT rV ry r �_decode_pax_fieldrB �PAX_NAME_FIELDSr� r r� rt �_proc_gnusparse_01�_proc_gnusparse_00�_proc_gnusparse_10rv r� r� r� r r, r� )r� r rf rA r� r� rA �regexr� r@ r� ra r� r� r� rC rC rD r� � sj $ � � ���� zTarInfo._proc_paxc C sh g }t �d|�D ] }|�t|�d��� qg }t �d|�D ] }|�t|�d��� q tt||��|_dS )z?Process a GNU tar extended sparse header, version 0.0. s \d+ GNU.sparse.offset=(\d+)\nr s \d+ GNU.sparse.numbytes=(\d+)\nN)r� �finditerr� rT r� �list�zipr )r� r� rA rf �offsetsr� r� rC rC rD r� � s zTarInfo._proc_gnusparse_00c C s@ dd� |d � d�D �}tt|ddd� |ddd� ��|_dS )z?Process a GNU tar extended sparse header, version 0.1. c S s g | ]}t |��qS rC )rT )�.0�xrC rC rD � <listcomp> s z.TarInfo._proc_gnusparse_01.<locals>.<listcomp>r� �,Nr. r )r r� r� r )r� r� rA r rC rC rD r� � s (zTarInfo._proc_gnusparse_01c C s� d}g }|j �t�}|�dd�\}}t|�}t|�|d k rAd|vr*||j �t�7 }|�dd�\}}|�t|�� t|�|d k s |j �� |_t t |ddd� |ddd� ��|_ dS )z?Process a GNU tar extended sparse header, version 1.0. Nr� r r. ) r� rn r� r rT r= r� r� r r� r� r )r� r� rA r �fieldsr rf �numberrC rC rD r� s � (zTarInfo._proc_gnusparse_10c C s� |� � D ]T\}}|dkrt| d|� q|dkr t| dt|�� q|dkr-t| dt|�� q|tv rX|tv rIzt| |�}W n tyH d}Y nw |dkrR|�d�}t| ||� q|�� | _dS ) zoReplace fields with supplemental information from a previous pax extended or global header. zGNU.sparse.namer/ r� r1 zGNU.sparse.realsizer r$ N) r] �setattrrT � PAX_FIELDS�PAX_NUMBER_FIELDSr; r� rU rA )r� rA rA rB r� ra rC rC rD r� s& � �zTarInfo._apply_pax_infoc C s. z|� |d�W S ty |� ||� Y S w )z1Decode a single field from a pax record. rP )rH �UnicodeDecodeError)r� ra rA �fallback_encoding�fallback_errorsrC rC rD r� * s �zTarInfo._decode_pax_fieldc C s" t |t�\}}|r |d7 }|t S )z_Round up a byte count by BLOCKSIZE and return it, e.g. _block(834) => 1024. r )rm r� )r� r� rt ru rC rC rD r� 2 s zTarInfo._blockc C s | j tv S �z4Return True if the Tarinfo object is a regular file.)r> � REGULAR_TYPESr� rC rC rD r, ; rP z TarInfo.isregc C s | � � S r� )r, r� rC rC rD �isfile? s zTarInfo.isfilec C � | j tkS )z!Return True if it is a directory.)r> rY r� rC rC rD r. C rP z TarInfo.isdirc C r� )z%Return True if it is a symbolic link.)r> �SYMTYPEr� rC rC rD r/ G rP z TarInfo.issymc C r� )z!Return True if it is a hard link.)r> �LNKTYPEr� rC rC rD r- K rP z TarInfo.islnkc C r� )z(Return True if it is a character device.)r> r� r� rC rC rD �ischrO rP z TarInfo.ischrc C r� )z$Return True if it is a block device.)r> r� r� rC rC rD �isblkS rP z TarInfo.isblkc C r� )z Return True if it is a FIFO.)r> �FIFOTYPEr� rC rC rD �isfifoW rP zTarInfo.isfifoc C s | j d uS r� )r r� rC rC rD �issparse[ r zTarInfo.issparsec C s | j tttfv S )zCReturn True if it is one of character device, block device or FIFO.)r> r� r� r� r� rC rC rD �isdev^ s z TarInfo.isdevrC )r� )5r� r� r� r� �dict� __slots__r� r r �setterr/ r0 rS rT r� r[ r r rb r^ r_ r` � classmethodr~ rh � staticmethodri r� rk ru r� r� r� r� r� r� r� r� r� r� r� r� r� r, r� r. r/ r- r� r� r� r� r� rC rC rC rD r R s� �������� � ����������� � : ) 2 > d r c @ s� e Zd ZdZdZdZdZdZeZ e Z dZ e ZeZdZ dfdd �Zedddefd d ��Zedgd d ��Zedhdd��Zedhdd��Zedidd��Zddddd�Zdd� Zd d � Z d d � Z d d!� Z djd"d#�Z dkdd%�d&d'�Z dldd(�d)d*�Z!dmd+d,�Z"d-d.� Z#dnddd0�d1d2�Z$doddd0�d4d5�Z%d6d7� Z&d8d9� Z'd:d;� Z(d<d=� Z)d>d?� Z* $ dpd@dA�Z+dBdC� Z,dDdE� Z-dFdG� Z.dHdI� Z/dJdK� Z0dLdM� Z1dNdO� Z2dPdQ� Z3dRdS� Z4dTdU� Z5dqdVdW�Z6dXdY� Z7dmdZd[�Z8d\d]� Z9d^d_� Z:d`da� Z;dbdc� Z<ddde� Z=dS )rr z=The TarFile Class provides an interface to tar archives. r Fr Nr� r\ c C s� ddddd�}||vrt d��|| _|| | _|s4| jdkr*tj�|�s*d| _d| _t|| j�}d | _n |d u rHt|d �rHt |j t t f�rH|j }t|d �rQ|j| _d | _|r\tj� |�nd | _ || _|| _|d url|| _|d urs|| _|d urz|| _|d ur�|| _|d ur�|| _| | _| d ur�| jtkr�| | _ni | _| d ur�| | _| d ur�| | _| | _d | _g | _ d | _ | j� � | _ i | _ z|| jdkr�d | _!| �"� | _!| jdk�r | j�#| j � z| j�$| �}| j �%|� W n# t&y� | j�#| j � Y n t'�y } zt(t |��d �d }~ww q�| jdv �r5d | _ | j�r8| j�)| j�*� �}| j�+|� | j t,|�7 _ W d S W d S W d S | j�sG| j�-� d | _� )a� Open an (uncompressed) tar archive 'name'. 'mode' is either 'r' to read from an existing archive, 'a' to append data to an existing file or 'w' to create a new file overwriting an existing one. 'mode' defaults to 'r'. If 'fileobj' is given, it is used for reading or writing data. If it can be determined, 'mode' is overridden by 'fileobj's mode. 'fileobj' is not closed, when TarFile is closed. r� zr+b�wb�xb�r� �ar� r� �!mode must be 'r', 'a', 'w' or 'x'r� r� FNr� r� Tr� �r� r� r� ).r; r� �_moder� r/ �exists� bltn_openr� r� rq r� rt rZ �abspathr� �streamr^ r � dereference� ignore_zerosrA rB r rA �debug� errorlevel� copybufsizer� �members�_loadedr� r� �inodes� firstmemberr� r� r� r� r� r r r~ rU ro r= r� )r� r� r� r� r^ r r� r� rA rB rA r� r� r� r� �modesr� rf rC rC rD r� s� � ��� � zTarFile.__init__c s� |s|st d��|dv ro� fdd�}g }t� j|d�D ]G}t� � j| �} |dur-|�� } z | |d|fi |��W S ttfyb } z|�d|� d | ��� |durX|�| � W Y d} ~ qd} ~ ww d � |�} td | � ���d |v r�|� d d �\} }| p~d} |p�d}|� jv r�t� � j| �} ntd| ��| || |fi |��S d|v r�|� dd �\} }| p�d} |p�d}| dvr�t d��|� dd�}t || ||||�}z � || |fi |��}W n |� � � d|_|S |dv r�� j|||fi |��S t d��)a� Open a tar archive for reading, writing or appending. Return an appropriate TarFile class. mode: 'r' or 'r:\*' open for reading with transparent compression 'r:' open for reading exclusively uncompressed 'r:gz' open for reading with gzip compression 'r:bz2' open for reading with bzip2 compression 'r:xz' open for reading with lzma compression 'a' or 'a:' open for appending, creating the file if necessary 'w' or 'w:' open for writing without compression 'w:gz' open for writing with gzip compression 'w:bz2' open for writing with bzip2 compression 'w:xz' open for writing with lzma compression 'x' or 'x:' create a tarfile exclusively without compression, raise an exception if the file is already created 'x:gz' create a gzip compressed tarfile, raise an exception if the file is already created 'x:bz2' create a bzip2 compressed tarfile, raise an exception if the file is already created 'x:xz' create an lzma compressed tarfile, raise an exception if the file is already created 'r|\*' open a stream of tar blocks with transparent compression 'r|' open an uncompressed stream of tar blocks for reading 'r|gz' open a gzip compressed stream of tar blocks 'r|bz2' open a bzip2 compressed stream of tar blocks 'r|xz' open an lzma compressed stream of tar blocks 'w|' open an uncompressed stream for writing 'w|gz' open a gzip compressed stream for writing 'w|bz2' open a bzip2 compressed stream for writing 'w|xz' open an lzma compressed stream for writing znothing to open)r� �r:*c s � j | dkS )N�taropen)� OPEN_METH)r� �r} rC rD �not_compressed r� z$TarFile.open.<locals>.not_compressed)�keyNr� z - method z: � z'file could not be opened successfully: �:r r� r� �|r� zmode must be 'r' or 'w'r� � Fr� zundiscernible mode)r; �sortedr� rz r� r r r� r� r� r �popr� r� r� r� )r} r� r� r� rs �kwargsr� � error_msgsr� �func� saved_posr� �error_msgs_summary�filemoder� r� r� rC r� rD r � s` % �� �z TarFile.openc K s$ |dvrt d��| |||fi |��S )zCOpen uncompressed tar archive name for reading or writing. r� r� )r; )r} r� r� r� r rC rC rD r� P s zTarFile.taropenr c K s� |dvrt d��zddlm} W n ty td�d�w z |||d ||�}W n tyB } z|dur=|dkr=td �|�� d}~ww z | j|||fi |��}W n! tyj } z|�� |dkretd �|�� d}~w |�� � d |_ |S ) zkOpen gzip compressed tar archive name for reading or writing. Appending is not allowed. �r� r� r� � mode must be 'r', 'w' or 'x'r )�GzipFilez gzip module is not availableNrv r� r� F) r; �gzipr r� r r� r r� r� r� ) r} r� r� r� r� r r r� r� rC rC rD �gzopenX s8 � �� �zTarFile.gzopenc K s� |dvrt d��zddlm} W n ty td�d�w ||p!|||d�}z | j|||fi |��}W n# ttfyO } z|�� |dkrJt d �|�� d}~w |�� � d |_ |S ) zlOpen bzip2 compressed tar archive name for reading or writing. Appending is not allowed. r r r )�BZ2Filer� N)r� r� znot a bzip2 fileF) r; r� r r� r r� r� �EOFErrorr� r r� ) r} r� r� r� r� r r r� r� rC rC rD �bz2openy s* � �zTarFile.bz2openc K s� |dvrt d��z ddlm}m} W n ty td�d�w ||p#|||d�}z | j|||fi |��}W n# |tfyQ } z|�� |dkrLt d �| �� d} ~ w |�� � d |_ |S ) zkOpen lzma compressed tar archive name for reading or writing. Appending is not allowed. r r r )�LZMAFiler� r� N)�presetr� znot an lzma fileF) r; r� r r� r� r r� r r� r r� ) r} r� r� r� r r r r� r� r� rC rC rD �xzopen� s* � �zTarFile.xzopenr� r r r )r� r� r� r� c C s� | j rdS d| _ z;| jdv r7| j�ttd � | jtd 7 _t| jt�\}}|dkr7| j�tt| � W | j sB| j� � dS dS | j sM| j� � w w )zlClose the TarFile. In write-mode, two finishing zero blocks are appended to the archive. NTr� r. r ) r� r� r� ro r> r� r� rm � RECORDSIZEr� r� )r� rt ru rC rC rD r� � s � � �z TarFile.closec C s( | � |�d��}|du rtd| ��|S )a Return a TarInfo object for member 'name'. If 'name' can not be found in the archive, KeyError is raised. If a member occurs more than once in the archive, its last occurrence is assumed to be the most up-to-date version. r$ Nzfilename %r not found)� _getmemberr� �KeyError)r� r� r rC rC rD � getmember� s zTarFile.getmemberc C s | � � | js | �� | jS )z�Return the members of the archive as a list of TarInfo objects. The list has the same order as the members in the archive. )�_checkr� �_loadr� r� rC rC rD � getmembers� s zTarFile.getmembersc C s dd� | � � D �S )z�Return the members of the archive as a list of their names. It has the same order as the list returned by getmembers(). c S s g | ]}|j �qS rC rN )r� r rC rC rD r� � s z$TarFile.getnames.<locals>.<listcomp>)r r� rC rC rD �getnames� s zTarFile.getnamesc C sJ | � d� |dur |j}|du r|}tj�|�\}}|�tjd�}|�d�}| �� }| |_ |du r@| j s:t� |�}n t� |�}nt� |�� �}d}|j}t �|�r|j|jf} | j ss|jdkrs| | jv rs|| j| krst} | j| }n;t} | d r~|| j| < n/t �|�r�t} n't �|�r�t} n t �|�r�t } t� |�}nt � |�r�t } n t � |�r�t!} ndS ||_||_"|j#|_$|j%|_&| tkr�|j'|_(nd|_(|j)|_*| |_+||_,t-r�z t-�.|j$�d |_/W n t0y� Y nw t1�rz t1�2|j&�d |_3W n t0�y Y nw | t t!fv �r#t4td��r#t4td��r#t�5|j6�|_7t�8|j6�|_9|S ) a� Create a TarInfo object from the result of os.stat or equivalent on an existing file. The file is either named by 'name', or specified as a file object 'fileobj' with a file descriptor. If given, 'arcname' specifies an alternative name for the file in the archive, otherwise, the name is taken from the 'name' attribute of 'fileobj', or the 'name' argument. The name should be a text string. �awxNr$ r� r r �major�minor):r r� r� r/ � splitdriver� r( r) r rB r� �lstat�stat�fstat�fileno�st_mode�S_ISREG�st_ino�st_dev�st_nlinkr� r� rE �S_ISDIRrY �S_ISFIFOr� �S_ISLNKr� �readlink�S_ISCHRr� �S_ISBLKr� r� �st_uidr3 �st_gidr4 �st_sizer1 �st_mtimer2 r> r0 �pwd�getpwuidr5 r �grp�getgrgidr6 r� r �st_rdevr? r r@ ) r� r� �arcnamer� �drvr �statresr0 �stmd�inoder> rC rC rD � gettarinfo� s� � ��zTarFile.gettarinfoT)r� c C s\ t tjttjttjttjt tj t tj i}| � � |du r | }|D ]�}|r�|jdu r.td� n|�|jd�}tt�||jB �� td|jpF|j|jpK|jf � |�� sW|�� rdtdd|j|jf � ntd|j � |j du rutd� ntd t � |j �dd � � t|j |� � r�d nd � |r�|�!� r�td |j" � |�#� r�td|j" � t$� q dS )a Print a table of contents to sys.stdout. If 'verbose' is False, only the names of the members are printed. If it is True, an 'ls -l'-like output is produced. 'members' is optional and must be a subset of the list returned by getmembers(). Nz ??????????r z%s/%sz%10sz%d,%dz%10dz????-??-?? ??:??:??z%d-%02d-%02d %02d:%02d:%02dr� r$ r� z-> zlink to )%rE r" �S_IFREGr� �S_IFLNKr� �S_IFIFOr� �S_IFCHRrY �S_IFDIRr� �S_IFBLKr r� r~ r� r> r r5 r3 r6 r4 r� r� r? r@ r1 r2 r� � localtimer� r. r/ r0 r- r} )r� �verboser� � type2moder �modetyperC rC rD r� O sD � �� ��z TarFile.list��filterc C sP | � d� |du r |}| jdur#tj�|�| jkr#| �dd| � dS | �d|� | �||�}|du r=| �dd| � dS |durS||�}|du rS| �dd| � dS |�� rut|d��}| � ||� W d � dS 1 snw Y dS |� � r�| � |� |r�t t� |��D ]}| j tj�||�tj�||�||d � q�dS dS | � |� dS ) a! Add the file 'name' to the archive. 'name' may be any type of file (directory, fifo, symbolic link, etc.). If given, 'arcname' specifies an alternative name for the file in the archive. Directories are added recursively by default. This can be avoided by setting 'recursive' to False. 'filter' is a function that expects a TarInfo object argument and returns the changed TarInfo object, if it returns None the TarInfo object will be excluded from the archive. r Nr. ztarfile: Skipped %rr z tarfile: Unsupported type %r�tarfile: Excluded %rr� rI )r r� r� r/ r� �_dbgr> r, r� �addfiler. r �listdir�addr� )r� r� r9 � recursiverJ r �frC rC rD rO z s< "� ��z TarFile.addc C s� | � d� |du r|�� r|jdkrtd��t�|�}|�| j| j| j�}| j � |� | j t |�7 _ | j }|durht|| j |j|d� t|jt�\}}|dkr_| j � tt| � |d7 }| j |t 7 _ | j�|� dS )aE Add the TarInfo object 'tarinfo' to the archive. If 'tarinfo' represents a non zero-size regular file, the 'fileobj' argument should be a binary file, and tarinfo.size bytes are read from it and added to the archive. You can create TarInfo objects directly, or by using gettarinfo(). r Nr z3fileobj not provided for non zero-size regular file)rs r )r r, r1 r; rU rb r^ rA rB r� ro r� r= r� rl rm r� r> r� r� )r� r r� rf rs rt ru rC rC rD rM � s zTarFile.addfilec C s� |d u r$| j }|d u rdd l}|jdtdd� tS t|t�r"td��|S t|�r*|S zt | W S t y? t d|�d��d �w )Nr z�Python 3.14 will, by default, filter extracted tar archives and reject files or modify their metadata. Use the filter argument to control this behavior.r� rH zrString names are not supported for TarFile.extraction_filter. Use a function such as tarfile.data_filter directly.zfilter z not found) �extraction_filterrK rL rM r rq rt � TypeError�callable�_NAMED_FILTERSr r; )r� rJ rK rC rC rD �_get_filter_function� s* � � �z TarFile._get_filter_function�.)� numeric_ownerrJ c C s� g }| � |�}|du r | }|D ]#}| �|||�}|du r q|�� r&|�|� | j|||�� |d� q|jdd� dd� |D ]7}tj�||j �} z| j || |d� | � || � | � || � W q> t yu } z | �| � W Y d} ~ q>d} ~ ww dS )a� Extract all members from the archive to the current working directory and set owner, modification time and permissions on directories afterwards. 'path' specifies a different directory to extract to. 'members' is optional and must be a subset of the list returned by getmembers(). If 'numeric_owner' is True, only the numbers for user/group names are used and not the names. The 'filter' function will be called on each member just before extraction. It can return a changed TarInfo or None to skip the member. String names of common filters are accepted. N�� set_attrsrX c S r� r� rN )r� rC rC rD �<lambda> s z$TarFile.extractall.<locals>.<lambda>T)r� �reverse)rX )rV �_get_extract_tarinfor. r� � _extract_one�sortr� r/ r� r� �chown�utime�chmodr �_handle_nonfatal_error) r� r/ r� rX rJ � directories�filter_functionr2 r �dirpathr� rC rC rD � extractall� s2 � ���zTarFile.extractallr� c C s8 | � |�}| �|||�}|dur| �||||� dS dS )a� Extract a member from the archive to the current working directory, using its full name. Its file information is extracted as accurately as possible. 'member' may be a filename or a TarInfo object. You can specify a different directory using 'path'. File attributes (owner, mtime, mode) are set unless 'set_attrs' is False. If 'numeric_owner' is True, only the numbers for user/group names are used and not the names. The 'filter' function will be called before extraction. It can return a changed TarInfo or None to skip the member. String names of common filters are accepted. N)rV r] r^ )r� r2 r/ rZ rX rJ re r rC rC rD �extract s �zTarFile.extractc C s� t |t�r | �|�}n|}|}z|||�}W n/ ttfy/ } z | �|� W Y d}~nd}~w tyE } z | �|� W Y d}~nd}~ww |du rU| �dd|j � dS |� � rgt � |�}t j �||j�|_|S )z@Get filtered TarInfo (or None) from member, which might be a strNr. rK )rq rt r r� r �_handle_fatal_errorr rc rL r� r- rU r� r/ r� r0 rD )r� r2 re r/ r � unfilteredr� rC rC rD r] ! s( ��� z TarFile._get_extract_tarinfoc C s� | � d� z| j|tj�||j�||d� W dS ty/ } z | �|� W Y d}~dS d}~w tyF } z | � |� W Y d}~dS d}~ww )z%Extract from filtered tarinfo to diskr� rY N) r �_extract_memberr� r/ r� r� r� ri r rc )r� r r/ rZ rX r� rC rC rD r^ 8 s ����zTarFile._extract_onec C s | j dkr� | �dd| � dS )z=Handle non-fatal error (ExtractError) according to errorlevelr � tarfile: %sN)r� rL �r� r� rC rC rD rc E s z TarFile._handle_nonfatal_errorc C sp | j dkr� t|t�r)|jdu r| �dd|j � dS | �dd|j|jf � dS | �ddt|�j|f � dS )z1Handle "fatal" error according to self.errorlevelr Nr rl ztarfile: %s %rztarfile: %s %s)r� rq r� �filenamerL �strerrorr> r� rm rC rC rD ri L s zTarFile._handle_fatal_errorc C sz | � d� t|t�r| �|�}n|}|�� s|jtvr!| �| |�S |�� s)|� � r;t| j t �r3t d��| � | �|��S dS )a\ Extract a member from the archive as a file object. 'member' may be a filename or a TarInfo object. If 'member' is a regular file or a link, an io.BufferedReader object is returned. For all other existing members, None is returned. If 'member' does not appear in the archive, KeyError is raised. r� z'cannot extract (sym)link as file objectN)r rq rt r r, r> r� � fileobjectr- r/ r� r� r � extractfile�_find_link_target)r� r2 r rC rC rD rq X s zTarFile.extractfilec C sZ |� d�}|�dtj�}tj�|�}|r!tj�|�s!tj|dd� |�� s)|� � r6| � dd|j |j f � n| � d|j � |� � rH| �||� nF|�� rS| �||� n;|�� r^| �||� n0|�� sf|�� rm| �||� n!|�� su|� � r|| �||� n|jtvr�| �||� n| �||� |r�| �|||� |� � s�| �||� | � ||� dS dS dS )z\Extract the TarInfo object tarinfo to a physical file called targetpath. r$ T)�exist_okr z%s -> %sN) r� r� r� r( r/ r1 r� �makedirsr- r/ rL r� r0 r, �makefiler. �makedirr� �makefifor� r� �makedev�makelinkr> r� � makeunknownr` rb ra )r� r � targetpathrZ rX � upperdirsrC rC rD rk x s8 �zTarFile._extract_memberc C sP z|j du rt�|� W dS t�|d� W dS ty' tj�|�s$� Y dS w )z,Make a directory called targetpath. Ni� )r� r� �mkdir�FileExistsErrorr/ r. �r� r r{ rC rC rD rv � s ��zTarFile.makedirc C s� | j }|�|j� | j}t|d��?}|jdur7|jD ]\}}|�|� t|||t|� q|�|j� |� � nt|||jt|� W d � dS W d � dS 1 sSw Y dS )z'Make a file called targetpath. r� N) r� r� r r� r� r rl r r1 �truncate)r� r r{ �sourcers �targetr� r1 rC rC rD ru � s �"�zTarFile.makefilec C s" | � ||� | �dd|j � dS )zYMake a file from a TarInfo object with an unknown type at targetpath. r z9tarfile: Unknown file type %r, extracted as regular file.N)ru rL r> r rC rC rD rz � s �zTarFile.makeunknownc C s t td�r t�|� dS td��)z'Make a fifo called targetpath. �mkfifoz fifo not supported by systemN)r� r� r� r r rC rC rD rw � s zTarFile.makefifoc C sj t td�r t td�std��|j}|du rd}|�� r!|tjO }n|tjO }t�||t� |j |j �� dS )z<Make a character or block device called targetpath. �mknodrx z'special devices not supported by systemNr& ) r� r� r r� r� r" rD rB r� rx r? r@ )r� r r{ r� rC rC rD rx � s �zTarFile.makedevc C s� z6|� � rtj�|�rt�|� t�|j|� W dS tj�|j�r+t� |j|� W dS | � | � |�|� W dS t yW z | � | � |�|� W Y dS t yV td�d�w w )z�Make a (symbolic) link called targetpath. If it cannot be created (platform limitation), we try to make a copy of the referenced file instead of a link. z%unable to resolve link inside archiveN)r/ r� r/ �lexists�unlink�symlinkr0 r� rD �linkrk rr �symlink_exceptionr r r rC rC rD ry � s& � � ��zTarFile.makelinkc C s t td�r�t�� dkr�|j}|j}|sEztr!|jr!t�|j�d }W n ty+ Y nw zt r:|j r:t � |j �d }W n tyD Y nw |du rKd}|du rQd}z |� � ret td�ret� |||� W dS t�|||� W dS ttfy� } ztd�|�d}~ww dS dS )z�Set owner of targetpath according to tarinfo. If numeric_owner is True, use .gid/.uid instead of .gname/.uname. If numeric_owner is False, fall back to .gid/.uid when the search based on name fails. �geteuidr r. NrF �lchownzcould not change owner)r� r� r� r4 r3 r6 r6 �getgrnamr r4 r5 �getpwnamr/ r� r` r� � OverflowErrorr )r� r r{ rX �g�ur� rC rC rD r` s> � � � � ���z TarFile.chownc C sF |j du rdS z t�||j � W dS ty" } ztd�|�d}~ww )zASet file permissions of targetpath according to tarinfo. Nzcould not change mode)r� r� rb r� r )r� r r{ r� rC rC rD rb % s ��z TarFile.chmodc C sZ |j }|du r dS ttd�sdS z t�|||f� W dS ty, } ztd�|�d}~ww )zBSet modification time of targetpath according to tarinfo. Nra z"could not change modification time)r2 r� r� ra r� r )r� r r{ r2 r� rC rC rD ra / s ��z TarFile.utimec C sR | � d� | jdur| j}d| _|S | j| j�� kr4| jdkr!dS | j�| jd � | j�d�s4td��d} z| j� | �}W n� t yl } z!| j rb| � dd| j|f � | jt 7 _W Y d}~q6W Y d}~n�d}~w ty� } z-| j r�| � dd| j|f � | jt 7 _W Y d}~q6| jdkr�tt|��d�W Y d}~nrd}~w ty� | jdkr�td �d�Y n\ ty� } z| jdkr�tt|��d�W Y d}~nCd}~w ty� } ztt|��d�d}~w t�y } z zddl}t||j��rtd |� ��d�|� t�y |�w d}~ww |du�r$| j�s"| j�|� |S d| _|S ) z�Return the next member of the archive as a TarInfo object, when TarFile is opened for reading. Return None if there is no more available. �raNr r rj Tr. z0x%X: %sz empty filez zlib error: ) r r� r� r� r� r� rn r r r� r� r� rL r� rV rt r� r� r� � Exceptionr� rq r� r� r� r� r� r� )r� �mr r� r� rC rC rD r� = sz �� �� � ������ �z TarFile.nextc C s� | � � }d}|dur#z|�|�}W n ty d}Y nw |d|� }|r+tj�|�}t|�D ]"}|r<|j|jkr;d}q/|rFtj�|j�}n|j}||krQ| S q/|rXt|��dS )z}Find an archive member by name from bottom to top. If tarinfo is given, it is used as the starting point. FNT) r �indexr; r� r/ �normpath�reversedr� r� ) r� r� r � normalizer� �skippingr� r2 � member_namerC rC rD r � s2 � ��zTarFile._getmemberc C s. | j s| �� dur | �� dus d| _dS dS )z�Read through the entire archive file and look for readable members. This should not run if the file is set to stream. NT)r� r� r� r� rC rC rD r � s � �z TarFile._loadc C s> | j r td| jj ��|dur| j|vr td| j ��dS dS )znCheck if TarFile is still open, and if the operation's mode corresponds to TarFile's mode. z %s is closedNzbad operation for mode %r)r� r� r r� r� )r� r� rC rC rD r � s �zTarFile._checkc C s` |� � rd�tdtj�|j�|jf��}d}n|j}|}| j||dd�}|du r.t d| ��|S )zZFind the target member of a symlink or hardlink member in the archive. r$ NT)r r� zlinkname %r not found) r/ r� rJ r� r/ r1 r� r0 r r )r� r r0 �limitr2 rC rC rD rr � s zTarFile._find_link_targetc c s� � | j r | jE dH dS d}| jdur | �� }|d7 }|V |t| j�k r,| j| }n| j s;| �� }|s:d| _ dS ndS |d7 }|V q )z$Provide an iterator object. Nr r T)r� r� r� r� r= )r� r� r rC rC rD �__iter__� s, � ��zTarFile.__iter__c C s || j krt|tjd� dS dS )z.Write debugging output to sys.stderr. ��fileN)r� r} r{ �stderr)r� �level�msgrC rC rD rL � s �z TarFile._dbgc C s | � � | S r� )r r� rC rC rD � __enter__� s zTarFile.__enter__c C s. |d u r | � � d S | js| j� � d| _d S r� )r� r� r� r� )r� r> ra � tracebackrC rC rD �__exit__� s zTarFile.__exit__)Nr� NNNNNNr\ NNNNF)r� N)r� Nr )r� NN)NNN�Tr� r� )rW N)r� T)TFr� )>r� r� r� r� r� r� r� r� r r^ r rA rB r r r rp rR r� r� r r r� r r r r� r� r r r r> r� rO rM rV rg rh r] r^ rc ri rq rk rv ru rz rw rx ry r` rb ra r� r r r rr r� rL r� r� rC rC rC rD r c s� �q_ � c+ 3 �- � �1" C( r c C sT z t | d�r| �� }t| d�}| �|� nt| �}|�� W dS ty) Y dS w )z�Return True if name points to a tar archive that we are able to handle, else return False. 'name' should be a string, file, or file-like object. rn )r� TF)r� r� r r� r� r )r� r� r� rC rC rD r s �r c C sh dd l } d}| j|d�}|jdddddd � |jd d td d � |jdd�}|jddddd� |jdddddd� |jdd dd d d� |jd d dd!d� |�� }|jr]|jd u r]|�d"d#� |j d ur�|j }t |�r�t |d$��}|� � t |� � tjd%� W d � n1 s�w Y |jr�t d&�|�� d S d S |�d"d'�|�� d S |jd ur�|j}t |�r�t� |d(��}|j|jd)� W d � d S 1 s�w Y d S |�d"d'�|�� d S |jd u�rRt|j�d"kr�|jd }tj}nt|j�d*kr�|j\}}n|�d"|�� � t |��rGt� |d(��}|j||jd+� W d � n 1 �s%w Y |j�rE|d,k�r9d-�|�} nd.�||�} t | � d S d S |�d"d'�|�� d S |jd u�r�|j�d�} tj� | �\} } d/d/d0d0d1d1d1d1d2�} | | v �r|d3| | nd4}|j}t� | |��}|D ]}|� |� �q�W d � n 1 �s�w Y |j�r�t d5�| �� d S d S d S )6Nr z3A simple command-line interface for tarfile module.)� descriptionz-vz --verbose� store_trueFzVerbose output)�action�default�helpz--filterz <filtername>zFilter for extraction)�metavar�choicesr� T)�requiredz-lz--list� <tarfile>zShow listing of a tarfile)r� r� z-ez --extract�+)r� z <output_dir>z Extract tarfile into target dir)�nargsr� r� z-cz--create)z<name>z<file>zCreate tarfile from sourcesz-tz--testzTest if a tarfile is validr z&--filter is only valid for extraction r� r� z{!r} is a tar archive.z{!r} is not a tar archive. r� )rF r. )r/ rJ rW z{!r} file is extracted.z+{!r} file is extracted into {!r} directory.r� r� r� )r� z.tgzz.xzz.txzz.bz2z.tbzz.tbz2z.tb2zw:r� z{!r} file created.) �argparse�ArgumentParser� add_argumentrU � add_mutually_exclusive_group� parse_argsrJ rh �exit�testr r r r} r{ r� rF r^ r� r r= r� �curdir� format_helprg �creater r/ �splitextrO )r� r� �parserr� �argsrp r� �tfr� r� �tar_name�_�ext� compressions�tar_mode� tar_files� file_namerC rC rD �main s� �� � � � � �� "� � � � � � ��r� �__main__r� )kr� �version� __author__� __credits__�builtinsr r� r{ r� r rk r" r� rd rU r� � compat.py38r r4 r� r6 �AttributeError�NotImplementedErrorr� r� �__all__r> r� r rj re rg rf r� rE r� r� r� r� r� rY r� �CONTTYPErm rl r� rv r| r� r r r r r� r� r� r� r� rr rT r� r� r �getfilesystemencodingrE rJ rY r` ri rl r~ r� r r r r r r r� r� r� rV r� r� r� �objectr� r� �BufferedReaderr r r r r r r r7 r r r rU rT r r r r� r� rC rC rC rD �<module> s � � ���� v l ?� * _ � _vendor/backports/tarfile/__pycache__/__main__.cpython-310.pyc 0000644 00000000406 15030122015 0020234 0 ustar 00 o �h; � @ s" d dl mZ edkre� dS dS )� )�main�__main__N)� r �__name__� r r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/backports/tarfile/__main__.py�<module> s � _vendor/backports/tarfile/__main__.py 0000644 00000000073 15030122015 0013675 0 ustar 00 from . import main if __name__ == '__main__': main() _vendor/backports/tarfile/compat/py38.py 0000644 00000001070 15030122015 0014241 0 ustar 00 import sys if sys.version_info < (3, 9): def removesuffix(self, suffix): # suffix='' should not call self[:-0]. if suffix and self.endswith(suffix): return self[: -len(suffix)] else: return self[:] def removeprefix(self, prefix): if self.startswith(prefix): return self[len(prefix) :] else: return self[:] else: def removesuffix(self, suffix): return self.removesuffix(suffix) def removeprefix(self, prefix): return self.removeprefix(prefix) _vendor/backports/tarfile/compat/__pycache__/py38.cpython-310.pyc 0000644 00000001412 15030122015 0020600 0 ustar 00 o �h8 � @ s: d dl Z e jdk rdd� Zdd� ZdS dd� Zdd� ZdS ) � N)� � c C s, |r| � |�r| d t|� � S | d d � S �N)�endswith�len��self�suffix� r �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/backports/tarfile/compat/py38.py� removesuffix s r c C s& | � |�r | t|�d � S | d d � S r )� startswithr �r �prefixr r r � removeprefix s r c C � | � |�S r )r r r r r r � c C r r )r r r r r r r )�sys� version_infor r r r r r �<module> s _vendor/backports/tarfile/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000304 15030122015 0021533 0 ustar 00 o �h � @ s d S )N� r r r �g/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py�<module> s _vendor/backports/tarfile/compat/__init__.py 0000644 00000000000 15030122015 0015165 0 ustar 00 _vendor/backports/tarfile/__init__.py 0000644 00000323713 15030122015 0013725 0 ustar 00 #------------------------------------------------------------------- # tarfile.py #------------------------------------------------------------------- # Copyright (C) 2002 Lars Gustaebel <lars@gustaebel.de> # All rights reserved. # # Permission is hereby granted, free of charge, to any person # obtaining a copy of this software and associated documentation # files (the "Software"), to deal in the Software without # restriction, including without limitation the rights to use, # copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the # Software is furnished to do so, subject to the following # conditions: # # The above copyright notice and this permission notice shall be # included in all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES # OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT # HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, # WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR # OTHER DEALINGS IN THE SOFTWARE. # """Read from and write to tar format archives. """ version = "0.9.0" __author__ = "Lars Gust\u00e4bel (lars@gustaebel.de)" __credits__ = "Gustavo Niemeyer, Niels Gust\u00e4bel, Richard Townsend." #--------- # Imports #--------- from builtins import open as bltn_open import sys import os import io import shutil import stat import time import struct import copy import re from .compat.py38 import removesuffix try: import pwd except ImportError: pwd = None try: import grp except ImportError: grp = None # os.symlink on Windows prior to 6.0 raises NotImplementedError # OSError (winerror=1314) will be raised if the caller does not hold the # SeCreateSymbolicLinkPrivilege privilege symlink_exception = (AttributeError, NotImplementedError, OSError) # from tarfile import * __all__ = ["TarFile", "TarInfo", "is_tarfile", "TarError", "ReadError", "CompressionError", "StreamError", "ExtractError", "HeaderError", "ENCODING", "USTAR_FORMAT", "GNU_FORMAT", "PAX_FORMAT", "DEFAULT_FORMAT", "open","fully_trusted_filter", "data_filter", "tar_filter", "FilterError", "AbsoluteLinkError", "OutsideDestinationError", "SpecialFileError", "AbsolutePathError", "LinkOutsideDestinationError"] #--------------------------------------------------------- # tar constants #--------------------------------------------------------- NUL = b"\0" # the null character BLOCKSIZE = 512 # length of processing blocks RECORDSIZE = BLOCKSIZE * 20 # length of records GNU_MAGIC = b"ustar \0" # magic gnu tar string POSIX_MAGIC = b"ustar\x0000" # magic posix tar string LENGTH_NAME = 100 # maximum length of a filename LENGTH_LINK = 100 # maximum length of a linkname LENGTH_PREFIX = 155 # maximum length of the prefix field REGTYPE = b"0" # regular file AREGTYPE = b"\0" # regular file LNKTYPE = b"1" # link (inside tarfile) SYMTYPE = b"2" # symbolic link CHRTYPE = b"3" # character special device BLKTYPE = b"4" # block special device DIRTYPE = b"5" # directory FIFOTYPE = b"6" # fifo special device CONTTYPE = b"7" # contiguous file GNUTYPE_LONGNAME = b"L" # GNU tar longname GNUTYPE_LONGLINK = b"K" # GNU tar longlink GNUTYPE_SPARSE = b"S" # GNU tar sparse file XHDTYPE = b"x" # POSIX.1-2001 extended header XGLTYPE = b"g" # POSIX.1-2001 global header SOLARIS_XHDTYPE = b"X" # Solaris extended header USTAR_FORMAT = 0 # POSIX.1-1988 (ustar) format GNU_FORMAT = 1 # GNU tar format PAX_FORMAT = 2 # POSIX.1-2001 (pax) format DEFAULT_FORMAT = PAX_FORMAT #--------------------------------------------------------- # tarfile constants #--------------------------------------------------------- # File types that tarfile supports: SUPPORTED_TYPES = (REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_LONGNAME, GNUTYPE_LONGLINK, GNUTYPE_SPARSE) # File types that will be treated as a regular file. REGULAR_TYPES = (REGTYPE, AREGTYPE, CONTTYPE, GNUTYPE_SPARSE) # File types that are part of the GNU tar format. GNU_TYPES = (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK, GNUTYPE_SPARSE) # Fields from a pax header that override a TarInfo attribute. PAX_FIELDS = ("path", "linkpath", "size", "mtime", "uid", "gid", "uname", "gname") # Fields from a pax header that are affected by hdrcharset. PAX_NAME_FIELDS = {"path", "linkpath", "uname", "gname"} # Fields in a pax header that are numbers, all other fields # are treated as strings. PAX_NUMBER_FIELDS = { "atime": float, "ctime": float, "mtime": float, "uid": int, "gid": int, "size": int } #--------------------------------------------------------- # initialization #--------------------------------------------------------- if os.name == "nt": ENCODING = "utf-8" else: ENCODING = sys.getfilesystemencoding() #--------------------------------------------------------- # Some useful functions #--------------------------------------------------------- def stn(s, length, encoding, errors): """Convert a string to a null-terminated bytes object. """ if s is None: raise ValueError("metadata cannot contain None") s = s.encode(encoding, errors) return s[:length] + (length - len(s)) * NUL def nts(s, encoding, errors): """Convert a null-terminated bytes object to a string. """ p = s.find(b"\0") if p != -1: s = s[:p] return s.decode(encoding, errors) def nti(s): """Convert a number field to a python number. """ # There are two possible encodings for a number field, see # itn() below. if s[0] in (0o200, 0o377): n = 0 for i in range(len(s) - 1): n <<= 8 n += s[i + 1] if s[0] == 0o377: n = -(256 ** (len(s) - 1) - n) else: try: s = nts(s, "ascii", "strict") n = int(s.strip() or "0", 8) except ValueError: raise InvalidHeaderError("invalid header") return n def itn(n, digits=8, format=DEFAULT_FORMAT): """Convert a python number to a number field. """ # POSIX 1003.1-1988 requires numbers to be encoded as a string of # octal digits followed by a null-byte, this allows values up to # (8**(digits-1))-1. GNU tar allows storing numbers greater than # that if necessary. A leading 0o200 or 0o377 byte indicate this # particular encoding, the following digits-1 bytes are a big-endian # base-256 representation. This allows values up to (256**(digits-1))-1. # A 0o200 byte indicates a positive number, a 0o377 byte a negative # number. original_n = n n = int(n) if 0 <= n < 8 ** (digits - 1): s = bytes("%0*o" % (digits - 1, n), "ascii") + NUL elif format == GNU_FORMAT and -256 ** (digits - 1) <= n < 256 ** (digits - 1): if n >= 0: s = bytearray([0o200]) else: s = bytearray([0o377]) n = 256 ** digits + n for i in range(digits - 1): s.insert(1, n & 0o377) n >>= 8 else: raise ValueError("overflow in number field") return s def calc_chksums(buf): """Calculate the checksum for a member's header by summing up all characters except for the chksum field which is treated as if it was filled with spaces. According to the GNU tar sources, some tars (Sun and NeXT) calculate chksum with signed char, which will be different if there are chars in the buffer with the high bit set. So we calculate two checksums, unsigned and signed. """ unsigned_chksum = 256 + sum(struct.unpack_from("148B8x356B", buf)) signed_chksum = 256 + sum(struct.unpack_from("148b8x356b", buf)) return unsigned_chksum, signed_chksum def copyfileobj(src, dst, length=None, exception=OSError, bufsize=None): """Copy length bytes from fileobj src to fileobj dst. If length is None, copy the entire content. """ bufsize = bufsize or 16 * 1024 if length == 0: return if length is None: shutil.copyfileobj(src, dst, bufsize) return blocks, remainder = divmod(length, bufsize) for b in range(blocks): buf = src.read(bufsize) if len(buf) < bufsize: raise exception("unexpected end of data") dst.write(buf) if remainder != 0: buf = src.read(remainder) if len(buf) < remainder: raise exception("unexpected end of data") dst.write(buf) return def _safe_print(s): encoding = getattr(sys.stdout, 'encoding', None) if encoding is not None: s = s.encode(encoding, 'backslashreplace').decode(encoding) print(s, end=' ') class TarError(Exception): """Base exception.""" pass class ExtractError(TarError): """General exception for extract errors.""" pass class ReadError(TarError): """Exception for unreadable tar archives.""" pass class CompressionError(TarError): """Exception for unavailable compression methods.""" pass class StreamError(TarError): """Exception for unsupported operations on stream-like TarFiles.""" pass class HeaderError(TarError): """Base exception for header errors.""" pass class EmptyHeaderError(HeaderError): """Exception for empty headers.""" pass class TruncatedHeaderError(HeaderError): """Exception for truncated headers.""" pass class EOFHeaderError(HeaderError): """Exception for end of file headers.""" pass class InvalidHeaderError(HeaderError): """Exception for invalid headers.""" pass class SubsequentHeaderError(HeaderError): """Exception for missing and invalid extended headers.""" pass #--------------------------- # internal stream interface #--------------------------- class _LowLevelFile: """Low-level file object. Supports reading and writing. It is used instead of a regular file object for streaming access. """ def __init__(self, name, mode): mode = { "r": os.O_RDONLY, "w": os.O_WRONLY | os.O_CREAT | os.O_TRUNC, }[mode] if hasattr(os, "O_BINARY"): mode |= os.O_BINARY self.fd = os.open(name, mode, 0o666) def close(self): os.close(self.fd) def read(self, size): return os.read(self.fd, size) def write(self, s): os.write(self.fd, s) class _Stream: """Class that serves as an adapter between TarFile and a stream-like object. The stream-like object only needs to have a read() or write() method that works with bytes, and the method is accessed blockwise. Use of gzip or bzip2 compression is possible. A stream-like object could be for example: sys.stdin.buffer, sys.stdout.buffer, a socket, a tape device etc. _Stream is intended to be used only internally. """ def __init__(self, name, mode, comptype, fileobj, bufsize, compresslevel): """Construct a _Stream object. """ self._extfileobj = True if fileobj is None: fileobj = _LowLevelFile(name, mode) self._extfileobj = False if comptype == '*': # Enable transparent compression detection for the # stream interface fileobj = _StreamProxy(fileobj) comptype = fileobj.getcomptype() self.name = name or "" self.mode = mode self.comptype = comptype self.fileobj = fileobj self.bufsize = bufsize self.buf = b"" self.pos = 0 self.closed = False try: if comptype == "gz": try: import zlib except ImportError: raise CompressionError("zlib module is not available") from None self.zlib = zlib self.crc = zlib.crc32(b"") if mode == "r": self.exception = zlib.error self._init_read_gz() else: self._init_write_gz(compresslevel) elif comptype == "bz2": try: import bz2 except ImportError: raise CompressionError("bz2 module is not available") from None if mode == "r": self.dbuf = b"" self.cmp = bz2.BZ2Decompressor() self.exception = OSError else: self.cmp = bz2.BZ2Compressor(compresslevel) elif comptype == "xz": try: import lzma except ImportError: raise CompressionError("lzma module is not available") from None if mode == "r": self.dbuf = b"" self.cmp = lzma.LZMADecompressor() self.exception = lzma.LZMAError else: self.cmp = lzma.LZMACompressor() elif comptype != "tar": raise CompressionError("unknown compression type %r" % comptype) except: if not self._extfileobj: self.fileobj.close() self.closed = True raise def __del__(self): if hasattr(self, "closed") and not self.closed: self.close() def _init_write_gz(self, compresslevel): """Initialize for writing with gzip compression. """ self.cmp = self.zlib.compressobj(compresslevel, self.zlib.DEFLATED, -self.zlib.MAX_WBITS, self.zlib.DEF_MEM_LEVEL, 0) timestamp = struct.pack("<L", int(time.time())) self.__write(b"\037\213\010\010" + timestamp + b"\002\377") if self.name.endswith(".gz"): self.name = self.name[:-3] # Honor "directory components removed" from RFC1952 self.name = os.path.basename(self.name) # RFC1952 says we must use ISO-8859-1 for the FNAME field. self.__write(self.name.encode("iso-8859-1", "replace") + NUL) def write(self, s): """Write string s to the stream. """ if self.comptype == "gz": self.crc = self.zlib.crc32(s, self.crc) self.pos += len(s) if self.comptype != "tar": s = self.cmp.compress(s) self.__write(s) def __write(self, s): """Write string s to the stream if a whole new block is ready to be written. """ self.buf += s while len(self.buf) > self.bufsize: self.fileobj.write(self.buf[:self.bufsize]) self.buf = self.buf[self.bufsize:] def close(self): """Close the _Stream object. No operation should be done on it afterwards. """ if self.closed: return self.closed = True try: if self.mode == "w" and self.comptype != "tar": self.buf += self.cmp.flush() if self.mode == "w" and self.buf: self.fileobj.write(self.buf) self.buf = b"" if self.comptype == "gz": self.fileobj.write(struct.pack("<L", self.crc)) self.fileobj.write(struct.pack("<L", self.pos & 0xffffFFFF)) finally: if not self._extfileobj: self.fileobj.close() def _init_read_gz(self): """Initialize for reading a gzip compressed fileobj. """ self.cmp = self.zlib.decompressobj(-self.zlib.MAX_WBITS) self.dbuf = b"" # taken from gzip.GzipFile with some alterations if self.__read(2) != b"\037\213": raise ReadError("not a gzip file") if self.__read(1) != b"\010": raise CompressionError("unsupported compression method") flag = ord(self.__read(1)) self.__read(6) if flag & 4: xlen = ord(self.__read(1)) + 256 * ord(self.__read(1)) self.read(xlen) if flag & 8: while True: s = self.__read(1) if not s or s == NUL: break if flag & 16: while True: s = self.__read(1) if not s or s == NUL: break if flag & 2: self.__read(2) def tell(self): """Return the stream's file pointer position. """ return self.pos def seek(self, pos=0): """Set the stream's file pointer to pos. Negative seeking is forbidden. """ if pos - self.pos >= 0: blocks, remainder = divmod(pos - self.pos, self.bufsize) for i in range(blocks): self.read(self.bufsize) self.read(remainder) else: raise StreamError("seeking backwards is not allowed") return self.pos def read(self, size): """Return the next size number of bytes from the stream.""" assert size is not None buf = self._read(size) self.pos += len(buf) return buf def _read(self, size): """Return size bytes from the stream. """ if self.comptype == "tar": return self.__read(size) c = len(self.dbuf) t = [self.dbuf] while c < size: # Skip underlying buffer to avoid unaligned double buffering. if self.buf: buf = self.buf self.buf = b"" else: buf = self.fileobj.read(self.bufsize) if not buf: break try: buf = self.cmp.decompress(buf) except self.exception as e: raise ReadError("invalid compressed data") from e t.append(buf) c += len(buf) t = b"".join(t) self.dbuf = t[size:] return t[:size] def __read(self, size): """Return size bytes from stream. If internal buffer is empty, read another block from the stream. """ c = len(self.buf) t = [self.buf] while c < size: buf = self.fileobj.read(self.bufsize) if not buf: break t.append(buf) c += len(buf) t = b"".join(t) self.buf = t[size:] return t[:size] # class _Stream class _StreamProxy(object): """Small proxy class that enables transparent compression detection for the Stream interface (mode 'r|*'). """ def __init__(self, fileobj): self.fileobj = fileobj self.buf = self.fileobj.read(BLOCKSIZE) def read(self, size): self.read = self.fileobj.read return self.buf def getcomptype(self): if self.buf.startswith(b"\x1f\x8b\x08"): return "gz" elif self.buf[0:3] == b"BZh" and self.buf[4:10] == b"1AY&SY": return "bz2" elif self.buf.startswith((b"\x5d\x00\x00\x80", b"\xfd7zXZ")): return "xz" else: return "tar" def close(self): self.fileobj.close() # class StreamProxy #------------------------ # Extraction file object #------------------------ class _FileInFile(object): """A thin wrapper around an existing file object that provides a part of its data as an individual file object. """ def __init__(self, fileobj, offset, size, name, blockinfo=None): self.fileobj = fileobj self.offset = offset self.size = size self.position = 0 self.name = name self.closed = False if blockinfo is None: blockinfo = [(0, size)] # Construct a map with data and zero blocks. self.map_index = 0 self.map = [] lastpos = 0 realpos = self.offset for offset, size in blockinfo: if offset > lastpos: self.map.append((False, lastpos, offset, None)) self.map.append((True, offset, offset + size, realpos)) realpos += size lastpos = offset + size if lastpos < self.size: self.map.append((False, lastpos, self.size, None)) def flush(self): pass @property def mode(self): return 'rb' def readable(self): return True def writable(self): return False def seekable(self): return self.fileobj.seekable() def tell(self): """Return the current file position. """ return self.position def seek(self, position, whence=io.SEEK_SET): """Seek to a position in the file. """ if whence == io.SEEK_SET: self.position = min(max(position, 0), self.size) elif whence == io.SEEK_CUR: if position < 0: self.position = max(self.position + position, 0) else: self.position = min(self.position + position, self.size) elif whence == io.SEEK_END: self.position = max(min(self.size + position, self.size), 0) else: raise ValueError("Invalid argument") return self.position def read(self, size=None): """Read data from the file. """ if size is None: size = self.size - self.position else: size = min(size, self.size - self.position) buf = b"" while size > 0: while True: data, start, stop, offset = self.map[self.map_index] if start <= self.position < stop: break else: self.map_index += 1 if self.map_index == len(self.map): self.map_index = 0 length = min(size, stop - self.position) if data: self.fileobj.seek(offset + (self.position - start)) b = self.fileobj.read(length) if len(b) != length: raise ReadError("unexpected end of data") buf += b else: buf += NUL * length size -= length self.position += length return buf def readinto(self, b): buf = self.read(len(b)) b[:len(buf)] = buf return len(buf) def close(self): self.closed = True #class _FileInFile class ExFileObject(io.BufferedReader): def __init__(self, tarfile, tarinfo): fileobj = _FileInFile(tarfile.fileobj, tarinfo.offset_data, tarinfo.size, tarinfo.name, tarinfo.sparse) super().__init__(fileobj) #class ExFileObject #----------------------------- # extraction filters (PEP 706) #----------------------------- class FilterError(TarError): pass class AbsolutePathError(FilterError): def __init__(self, tarinfo): self.tarinfo = tarinfo super().__init__(f'member {tarinfo.name!r} has an absolute path') class OutsideDestinationError(FilterError): def __init__(self, tarinfo, path): self.tarinfo = tarinfo self._path = path super().__init__(f'{tarinfo.name!r} would be extracted to {path!r}, ' + 'which is outside the destination') class SpecialFileError(FilterError): def __init__(self, tarinfo): self.tarinfo = tarinfo super().__init__(f'{tarinfo.name!r} is a special file') class AbsoluteLinkError(FilterError): def __init__(self, tarinfo): self.tarinfo = tarinfo super().__init__(f'{tarinfo.name!r} is a link to an absolute path') class LinkOutsideDestinationError(FilterError): def __init__(self, tarinfo, path): self.tarinfo = tarinfo self._path = path super().__init__(f'{tarinfo.name!r} would link to {path!r}, ' + 'which is outside the destination') def _get_filtered_attrs(member, dest_path, for_data=True): new_attrs = {} name = member.name dest_path = os.path.realpath(dest_path) # Strip leading / (tar's directory separator) from filenames. # Include os.sep (target OS directory separator) as well. if name.startswith(('/', os.sep)): name = new_attrs['name'] = member.path.lstrip('/' + os.sep) if os.path.isabs(name): # Path is absolute even after stripping. # For example, 'C:/foo' on Windows. raise AbsolutePathError(member) # Ensure we stay in the destination target_path = os.path.realpath(os.path.join(dest_path, name)) if os.path.commonpath([target_path, dest_path]) != dest_path: raise OutsideDestinationError(member, target_path) # Limit permissions (no high bits, and go-w) mode = member.mode if mode is not None: # Strip high bits & group/other write bits mode = mode & 0o755 if for_data: # For data, handle permissions & file types if member.isreg() or member.islnk(): if not mode & 0o100: # Clear executable bits if not executable by user mode &= ~0o111 # Ensure owner can read & write mode |= 0o600 elif member.isdir() or member.issym(): # Ignore mode for directories & symlinks mode = None else: # Reject special files raise SpecialFileError(member) if mode != member.mode: new_attrs['mode'] = mode if for_data: # Ignore ownership for 'data' if member.uid is not None: new_attrs['uid'] = None if member.gid is not None: new_attrs['gid'] = None if member.uname is not None: new_attrs['uname'] = None if member.gname is not None: new_attrs['gname'] = None # Check link destination for 'data' if member.islnk() or member.issym(): if os.path.isabs(member.linkname): raise AbsoluteLinkError(member) if member.issym(): target_path = os.path.join(dest_path, os.path.dirname(name), member.linkname) else: target_path = os.path.join(dest_path, member.linkname) target_path = os.path.realpath(target_path) if os.path.commonpath([target_path, dest_path]) != dest_path: raise LinkOutsideDestinationError(member, target_path) return new_attrs def fully_trusted_filter(member, dest_path): return member def tar_filter(member, dest_path): new_attrs = _get_filtered_attrs(member, dest_path, False) if new_attrs: return member.replace(**new_attrs, deep=False) return member def data_filter(member, dest_path): new_attrs = _get_filtered_attrs(member, dest_path, True) if new_attrs: return member.replace(**new_attrs, deep=False) return member _NAMED_FILTERS = { "fully_trusted": fully_trusted_filter, "tar": tar_filter, "data": data_filter, } #------------------ # Exported Classes #------------------ # Sentinel for replace() defaults, meaning "don't change the attribute" _KEEP = object() class TarInfo(object): """Informational class which holds the details about an archive member given by a tar header block. TarInfo objects are returned by TarFile.getmember(), TarFile.getmembers() and TarFile.gettarinfo() and are usually created internally. """ __slots__ = dict( name = 'Name of the archive member.', mode = 'Permission bits.', uid = 'User ID of the user who originally stored this member.', gid = 'Group ID of the user who originally stored this member.', size = 'Size in bytes.', mtime = 'Time of last modification.', chksum = 'Header checksum.', type = ('File type. type is usually one of these constants: ' 'REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, ' 'CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE.'), linkname = ('Name of the target file name, which is only present ' 'in TarInfo objects of type LNKTYPE and SYMTYPE.'), uname = 'User name.', gname = 'Group name.', devmajor = 'Device major number.', devminor = 'Device minor number.', offset = 'The tar header starts here.', offset_data = "The file's data starts here.", pax_headers = ('A dictionary containing key-value pairs of an ' 'associated pax extended header.'), sparse = 'Sparse member information.', _tarfile = None, _sparse_structs = None, _link_target = None, ) def __init__(self, name=""): """Construct a TarInfo object. name is the optional name of the member. """ self.name = name # member name self.mode = 0o644 # file permissions self.uid = 0 # user id self.gid = 0 # group id self.size = 0 # file size self.mtime = 0 # modification time self.chksum = 0 # header checksum self.type = REGTYPE # member type self.linkname = "" # link name self.uname = "" # user name self.gname = "" # group name self.devmajor = 0 # device major number self.devminor = 0 # device minor number self.offset = 0 # the tar header starts here self.offset_data = 0 # the file's data starts here self.sparse = None # sparse member information self.pax_headers = {} # pax header information @property def tarfile(self): import warnings warnings.warn( 'The undocumented "tarfile" attribute of TarInfo objects ' + 'is deprecated and will be removed in Python 3.16', DeprecationWarning, stacklevel=2) return self._tarfile @tarfile.setter def tarfile(self, tarfile): import warnings warnings.warn( 'The undocumented "tarfile" attribute of TarInfo objects ' + 'is deprecated and will be removed in Python 3.16', DeprecationWarning, stacklevel=2) self._tarfile = tarfile @property def path(self): 'In pax headers, "name" is called "path".' return self.name @path.setter def path(self, name): self.name = name @property def linkpath(self): 'In pax headers, "linkname" is called "linkpath".' return self.linkname @linkpath.setter def linkpath(self, linkname): self.linkname = linkname def __repr__(self): return "<%s %r at %#x>" % (self.__class__.__name__,self.name,id(self)) def replace(self, *, name=_KEEP, mtime=_KEEP, mode=_KEEP, linkname=_KEEP, uid=_KEEP, gid=_KEEP, uname=_KEEP, gname=_KEEP, deep=True, _KEEP=_KEEP): """Return a deep copy of self with the given attributes replaced. """ if deep: result = copy.deepcopy(self) else: result = copy.copy(self) if name is not _KEEP: result.name = name if mtime is not _KEEP: result.mtime = mtime if mode is not _KEEP: result.mode = mode if linkname is not _KEEP: result.linkname = linkname if uid is not _KEEP: result.uid = uid if gid is not _KEEP: result.gid = gid if uname is not _KEEP: result.uname = uname if gname is not _KEEP: result.gname = gname return result def get_info(self): """Return the TarInfo's attributes as a dictionary. """ if self.mode is None: mode = None else: mode = self.mode & 0o7777 info = { "name": self.name, "mode": mode, "uid": self.uid, "gid": self.gid, "size": self.size, "mtime": self.mtime, "chksum": self.chksum, "type": self.type, "linkname": self.linkname, "uname": self.uname, "gname": self.gname, "devmajor": self.devmajor, "devminor": self.devminor } if info["type"] == DIRTYPE and not info["name"].endswith("/"): info["name"] += "/" return info def tobuf(self, format=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescape"): """Return a tar header as a string of 512 byte blocks. """ info = self.get_info() for name, value in info.items(): if value is None: raise ValueError("%s may not be None" % name) if format == USTAR_FORMAT: return self.create_ustar_header(info, encoding, errors) elif format == GNU_FORMAT: return self.create_gnu_header(info, encoding, errors) elif format == PAX_FORMAT: return self.create_pax_header(info, encoding) else: raise ValueError("invalid format") def create_ustar_header(self, info, encoding, errors): """Return the object as a ustar header block. """ info["magic"] = POSIX_MAGIC if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK: raise ValueError("linkname is too long") if len(info["name"].encode(encoding, errors)) > LENGTH_NAME: info["prefix"], info["name"] = self._posix_split_name(info["name"], encoding, errors) return self._create_header(info, USTAR_FORMAT, encoding, errors) def create_gnu_header(self, info, encoding, errors): """Return the object as a GNU header block sequence. """ info["magic"] = GNU_MAGIC buf = b"" if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK: buf += self._create_gnu_long_header(info["linkname"], GNUTYPE_LONGLINK, encoding, errors) if len(info["name"].encode(encoding, errors)) > LENGTH_NAME: buf += self._create_gnu_long_header(info["name"], GNUTYPE_LONGNAME, encoding, errors) return buf + self._create_header(info, GNU_FORMAT, encoding, errors) def create_pax_header(self, info, encoding): """Return the object as a ustar header block. If it cannot be represented this way, prepend a pax extended header sequence with supplement information. """ info["magic"] = POSIX_MAGIC pax_headers = self.pax_headers.copy() # Test string fields for values that exceed the field length or cannot # be represented in ASCII encoding. for name, hname, length in ( ("name", "path", LENGTH_NAME), ("linkname", "linkpath", LENGTH_LINK), ("uname", "uname", 32), ("gname", "gname", 32)): if hname in pax_headers: # The pax header has priority. continue # Try to encode the string as ASCII. try: info[name].encode("ascii", "strict") except UnicodeEncodeError: pax_headers[hname] = info[name] continue if len(info[name]) > length: pax_headers[hname] = info[name] # Test number fields for values that exceed the field limit or values # that like to be stored as float. for name, digits in (("uid", 8), ("gid", 8), ("size", 12), ("mtime", 12)): needs_pax = False val = info[name] val_is_float = isinstance(val, float) val_int = round(val) if val_is_float else val if not 0 <= val_int < 8 ** (digits - 1): # Avoid overflow. info[name] = 0 needs_pax = True elif val_is_float: # Put rounded value in ustar header, and full # precision value in pax header. info[name] = val_int needs_pax = True # The existing pax header has priority. if needs_pax and name not in pax_headers: pax_headers[name] = str(val) # Create a pax extended header if necessary. if pax_headers: buf = self._create_pax_generic_header(pax_headers, XHDTYPE, encoding) else: buf = b"" return buf + self._create_header(info, USTAR_FORMAT, "ascii", "replace") @classmethod def create_pax_global_header(cls, pax_headers): """Return the object as a pax global header block sequence. """ return cls._create_pax_generic_header(pax_headers, XGLTYPE, "utf-8") def _posix_split_name(self, name, encoding, errors): """Split a name longer than 100 chars into a prefix and a name part. """ components = name.split("/") for i in range(1, len(components)): prefix = "/".join(components[:i]) name = "/".join(components[i:]) if len(prefix.encode(encoding, errors)) <= LENGTH_PREFIX and \ len(name.encode(encoding, errors)) <= LENGTH_NAME: break else: raise ValueError("name is too long") return prefix, name @staticmethod def _create_header(info, format, encoding, errors): """Return a header block. info is a dictionary with file information, format must be one of the *_FORMAT constants. """ has_device_fields = info.get("type") in (CHRTYPE, BLKTYPE) if has_device_fields: devmajor = itn(info.get("devmajor", 0), 8, format) devminor = itn(info.get("devminor", 0), 8, format) else: devmajor = stn("", 8, encoding, errors) devminor = stn("", 8, encoding, errors) # None values in metadata should cause ValueError. # itn()/stn() do this for all fields except type. filetype = info.get("type", REGTYPE) if filetype is None: raise ValueError("TarInfo.type must not be None") parts = [ stn(info.get("name", ""), 100, encoding, errors), itn(info.get("mode", 0) & 0o7777, 8, format), itn(info.get("uid", 0), 8, format), itn(info.get("gid", 0), 8, format), itn(info.get("size", 0), 12, format), itn(info.get("mtime", 0), 12, format), b" ", # checksum field filetype, stn(info.get("linkname", ""), 100, encoding, errors), info.get("magic", POSIX_MAGIC), stn(info.get("uname", ""), 32, encoding, errors), stn(info.get("gname", ""), 32, encoding, errors), devmajor, devminor, stn(info.get("prefix", ""), 155, encoding, errors) ] buf = struct.pack("%ds" % BLOCKSIZE, b"".join(parts)) chksum = calc_chksums(buf[-BLOCKSIZE:])[0] buf = buf[:-364] + bytes("%06o\0" % chksum, "ascii") + buf[-357:] return buf @staticmethod def _create_payload(payload): """Return the string payload filled with zero bytes up to the next 512 byte border. """ blocks, remainder = divmod(len(payload), BLOCKSIZE) if remainder > 0: payload += (BLOCKSIZE - remainder) * NUL return payload @classmethod def _create_gnu_long_header(cls, name, type, encoding, errors): """Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence for name. """ name = name.encode(encoding, errors) + NUL info = {} info["name"] = "././@LongLink" info["type"] = type info["size"] = len(name) info["magic"] = GNU_MAGIC # create extended header + name blocks. return cls._create_header(info, USTAR_FORMAT, encoding, errors) + \ cls._create_payload(name) @classmethod def _create_pax_generic_header(cls, pax_headers, type, encoding): """Return a POSIX.1-2008 extended or global header sequence that contains a list of keyword, value pairs. The values must be strings. """ # Check if one of the fields contains surrogate characters and thereby # forces hdrcharset=BINARY, see _proc_pax() for more information. binary = False for keyword, value in pax_headers.items(): try: value.encode("utf-8", "strict") except UnicodeEncodeError: binary = True break records = b"" if binary: # Put the hdrcharset field at the beginning of the header. records += b"21 hdrcharset=BINARY\n" for keyword, value in pax_headers.items(): keyword = keyword.encode("utf-8") if binary: # Try to restore the original byte representation of 'value'. # Needless to say, that the encoding must match the string. value = value.encode(encoding, "surrogateescape") else: value = value.encode("utf-8") l = len(keyword) + len(value) + 3 # ' ' + '=' + '\n' n = p = 0 while True: n = l + len(str(p)) if n == p: break p = n records += bytes(str(p), "ascii") + b" " + keyword + b"=" + value + b"\n" # We use a hardcoded "././@PaxHeader" name like star does # instead of the one that POSIX recommends. info = {} info["name"] = "././@PaxHeader" info["type"] = type info["size"] = len(records) info["magic"] = POSIX_MAGIC # Create pax header + record blocks. return cls._create_header(info, USTAR_FORMAT, "ascii", "replace") + \ cls._create_payload(records) @classmethod def frombuf(cls, buf, encoding, errors): """Construct a TarInfo object from a 512 byte bytes object. """ if len(buf) == 0: raise EmptyHeaderError("empty header") if len(buf) != BLOCKSIZE: raise TruncatedHeaderError("truncated header") if buf.count(NUL) == BLOCKSIZE: raise EOFHeaderError("end of file header") chksum = nti(buf[148:156]) if chksum not in calc_chksums(buf): raise InvalidHeaderError("bad checksum") obj = cls() obj.name = nts(buf[0:100], encoding, errors) obj.mode = nti(buf[100:108]) obj.uid = nti(buf[108:116]) obj.gid = nti(buf[116:124]) obj.size = nti(buf[124:136]) obj.mtime = nti(buf[136:148]) obj.chksum = chksum obj.type = buf[156:157] obj.linkname = nts(buf[157:257], encoding, errors) obj.uname = nts(buf[265:297], encoding, errors) obj.gname = nts(buf[297:329], encoding, errors) obj.devmajor = nti(buf[329:337]) obj.devminor = nti(buf[337:345]) prefix = nts(buf[345:500], encoding, errors) # Old V7 tar format represents a directory as a regular # file with a trailing slash. if obj.type == AREGTYPE and obj.name.endswith("/"): obj.type = DIRTYPE # The old GNU sparse format occupies some of the unused # space in the buffer for up to 4 sparse structures. # Save them for later processing in _proc_sparse(). if obj.type == GNUTYPE_SPARSE: pos = 386 structs = [] for i in range(4): try: offset = nti(buf[pos:pos + 12]) numbytes = nti(buf[pos + 12:pos + 24]) except ValueError: break structs.append((offset, numbytes)) pos += 24 isextended = bool(buf[482]) origsize = nti(buf[483:495]) obj._sparse_structs = (structs, isextended, origsize) # Remove redundant slashes from directories. if obj.isdir(): obj.name = obj.name.rstrip("/") # Reconstruct a ustar longname. if prefix and obj.type not in GNU_TYPES: obj.name = prefix + "/" + obj.name return obj @classmethod def fromtarfile(cls, tarfile): """Return the next TarInfo object from TarFile object tarfile. """ buf = tarfile.fileobj.read(BLOCKSIZE) obj = cls.frombuf(buf, tarfile.encoding, tarfile.errors) obj.offset = tarfile.fileobj.tell() - BLOCKSIZE return obj._proc_member(tarfile) #-------------------------------------------------------------------------- # The following are methods that are called depending on the type of a # member. The entry point is _proc_member() which can be overridden in a # subclass to add custom _proc_*() methods. A _proc_*() method MUST # implement the following # operations: # 1. Set self.offset_data to the position where the data blocks begin, # if there is data that follows. # 2. Set tarfile.offset to the position where the next member's header will # begin. # 3. Return self or another valid TarInfo object. def _proc_member(self, tarfile): """Choose the right processing method depending on the type and call it. """ if self.type in (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK): return self._proc_gnulong(tarfile) elif self.type == GNUTYPE_SPARSE: return self._proc_sparse(tarfile) elif self.type in (XHDTYPE, XGLTYPE, SOLARIS_XHDTYPE): return self._proc_pax(tarfile) else: return self._proc_builtin(tarfile) def _proc_builtin(self, tarfile): """Process a builtin type or an unknown type which will be treated as a regular file. """ self.offset_data = tarfile.fileobj.tell() offset = self.offset_data if self.isreg() or self.type not in SUPPORTED_TYPES: # Skip the following data blocks. offset += self._block(self.size) tarfile.offset = offset # Patch the TarInfo object with saved global # header information. self._apply_pax_info(tarfile.pax_headers, tarfile.encoding, tarfile.errors) # Remove redundant slashes from directories. This is to be consistent # with frombuf(). if self.isdir(): self.name = self.name.rstrip("/") return self def _proc_gnulong(self, tarfile): """Process the blocks that hold a GNU longname or longlink member. """ buf = tarfile.fileobj.read(self._block(self.size)) # Fetch the next header and process it. try: next = self.fromtarfile(tarfile) except HeaderError as e: raise SubsequentHeaderError(str(e)) from None # Patch the TarInfo object from the next header with # the longname information. next.offset = self.offset if self.type == GNUTYPE_LONGNAME: next.name = nts(buf, tarfile.encoding, tarfile.errors) elif self.type == GNUTYPE_LONGLINK: next.linkname = nts(buf, tarfile.encoding, tarfile.errors) # Remove redundant slashes from directories. This is to be consistent # with frombuf(). if next.isdir(): next.name = removesuffix(next.name, "/") return next def _proc_sparse(self, tarfile): """Process a GNU sparse header plus extra headers. """ # We already collected some sparse structures in frombuf(). structs, isextended, origsize = self._sparse_structs del self._sparse_structs # Collect sparse structures from extended header blocks. while isextended: buf = tarfile.fileobj.read(BLOCKSIZE) pos = 0 for i in range(21): try: offset = nti(buf[pos:pos + 12]) numbytes = nti(buf[pos + 12:pos + 24]) except ValueError: break if offset and numbytes: structs.append((offset, numbytes)) pos += 24 isextended = bool(buf[504]) self.sparse = structs self.offset_data = tarfile.fileobj.tell() tarfile.offset = self.offset_data + self._block(self.size) self.size = origsize return self def _proc_pax(self, tarfile): """Process an extended or global header as described in POSIX.1-2008. """ # Read the header information. buf = tarfile.fileobj.read(self._block(self.size)) # A pax header stores supplemental information for either # the following file (extended) or all following files # (global). if self.type == XGLTYPE: pax_headers = tarfile.pax_headers else: pax_headers = tarfile.pax_headers.copy() # Check if the pax header contains a hdrcharset field. This tells us # the encoding of the path, linkpath, uname and gname fields. Normally, # these fields are UTF-8 encoded but since POSIX.1-2008 tar # implementations are allowed to store them as raw binary strings if # the translation to UTF-8 fails. match = re.search(br"\d+ hdrcharset=([^\n]+)\n", buf) if match is not None: pax_headers["hdrcharset"] = match.group(1).decode("utf-8") # For the time being, we don't care about anything other than "BINARY". # The only other value that is currently allowed by the standard is # "ISO-IR 10646 2000 UTF-8" in other words UTF-8. hdrcharset = pax_headers.get("hdrcharset") if hdrcharset == "BINARY": encoding = tarfile.encoding else: encoding = "utf-8" # Parse pax header information. A record looks like that: # "%d %s=%s\n" % (length, keyword, value). length is the size # of the complete record including the length field itself and # the newline. keyword and value are both UTF-8 encoded strings. regex = re.compile(br"(\d+) ([^=]+)=") pos = 0 while match := regex.match(buf, pos): length, keyword = match.groups() length = int(length) if length == 0: raise InvalidHeaderError("invalid header") value = buf[match.end(2) + 1:match.start(1) + length - 1] # Normally, we could just use "utf-8" as the encoding and "strict" # as the error handler, but we better not take the risk. For # example, GNU tar <= 1.23 is known to store filenames it cannot # translate to UTF-8 as raw strings (unfortunately without a # hdrcharset=BINARY header). # We first try the strict standard encoding, and if that fails we # fall back on the user's encoding and error handler. keyword = self._decode_pax_field(keyword, "utf-8", "utf-8", tarfile.errors) if keyword in PAX_NAME_FIELDS: value = self._decode_pax_field(value, encoding, tarfile.encoding, tarfile.errors) else: value = self._decode_pax_field(value, "utf-8", "utf-8", tarfile.errors) pax_headers[keyword] = value pos += length # Fetch the next header. try: next = self.fromtarfile(tarfile) except HeaderError as e: raise SubsequentHeaderError(str(e)) from None # Process GNU sparse information. if "GNU.sparse.map" in pax_headers: # GNU extended sparse format version 0.1. self._proc_gnusparse_01(next, pax_headers) elif "GNU.sparse.size" in pax_headers: # GNU extended sparse format version 0.0. self._proc_gnusparse_00(next, pax_headers, buf) elif pax_headers.get("GNU.sparse.major") == "1" and pax_headers.get("GNU.sparse.minor") == "0": # GNU extended sparse format version 1.0. self._proc_gnusparse_10(next, pax_headers, tarfile) if self.type in (XHDTYPE, SOLARIS_XHDTYPE): # Patch the TarInfo object with the extended header info. next._apply_pax_info(pax_headers, tarfile.encoding, tarfile.errors) next.offset = self.offset if "size" in pax_headers: # If the extended header replaces the size field, # we need to recalculate the offset where the next # header starts. offset = next.offset_data if next.isreg() or next.type not in SUPPORTED_TYPES: offset += next._block(next.size) tarfile.offset = offset return next def _proc_gnusparse_00(self, next, pax_headers, buf): """Process a GNU tar extended sparse header, version 0.0. """ offsets = [] for match in re.finditer(br"\d+ GNU.sparse.offset=(\d+)\n", buf): offsets.append(int(match.group(1))) numbytes = [] for match in re.finditer(br"\d+ GNU.sparse.numbytes=(\d+)\n", buf): numbytes.append(int(match.group(1))) next.sparse = list(zip(offsets, numbytes)) def _proc_gnusparse_01(self, next, pax_headers): """Process a GNU tar extended sparse header, version 0.1. """ sparse = [int(x) for x in pax_headers["GNU.sparse.map"].split(",")] next.sparse = list(zip(sparse[::2], sparse[1::2])) def _proc_gnusparse_10(self, next, pax_headers, tarfile): """Process a GNU tar extended sparse header, version 1.0. """ fields = None sparse = [] buf = tarfile.fileobj.read(BLOCKSIZE) fields, buf = buf.split(b"\n", 1) fields = int(fields) while len(sparse) < fields * 2: if b"\n" not in buf: buf += tarfile.fileobj.read(BLOCKSIZE) number, buf = buf.split(b"\n", 1) sparse.append(int(number)) next.offset_data = tarfile.fileobj.tell() next.sparse = list(zip(sparse[::2], sparse[1::2])) def _apply_pax_info(self, pax_headers, encoding, errors): """Replace fields with supplemental information from a previous pax extended or global header. """ for keyword, value in pax_headers.items(): if keyword == "GNU.sparse.name": setattr(self, "path", value) elif keyword == "GNU.sparse.size": setattr(self, "size", int(value)) elif keyword == "GNU.sparse.realsize": setattr(self, "size", int(value)) elif keyword in PAX_FIELDS: if keyword in PAX_NUMBER_FIELDS: try: value = PAX_NUMBER_FIELDS[keyword](value) except ValueError: value = 0 if keyword == "path": value = value.rstrip("/") setattr(self, keyword, value) self.pax_headers = pax_headers.copy() def _decode_pax_field(self, value, encoding, fallback_encoding, fallback_errors): """Decode a single field from a pax record. """ try: return value.decode(encoding, "strict") except UnicodeDecodeError: return value.decode(fallback_encoding, fallback_errors) def _block(self, count): """Round up a byte count by BLOCKSIZE and return it, e.g. _block(834) => 1024. """ blocks, remainder = divmod(count, BLOCKSIZE) if remainder: blocks += 1 return blocks * BLOCKSIZE def isreg(self): 'Return True if the Tarinfo object is a regular file.' return self.type in REGULAR_TYPES def isfile(self): 'Return True if the Tarinfo object is a regular file.' return self.isreg() def isdir(self): 'Return True if it is a directory.' return self.type == DIRTYPE def issym(self): 'Return True if it is a symbolic link.' return self.type == SYMTYPE def islnk(self): 'Return True if it is a hard link.' return self.type == LNKTYPE def ischr(self): 'Return True if it is a character device.' return self.type == CHRTYPE def isblk(self): 'Return True if it is a block device.' return self.type == BLKTYPE def isfifo(self): 'Return True if it is a FIFO.' return self.type == FIFOTYPE def issparse(self): return self.sparse is not None def isdev(self): 'Return True if it is one of character device, block device or FIFO.' return self.type in (CHRTYPE, BLKTYPE, FIFOTYPE) # class TarInfo class TarFile(object): """The TarFile Class provides an interface to tar archives. """ debug = 0 # May be set from 0 (no msgs) to 3 (all msgs) dereference = False # If true, add content of linked file to the # tar file, else the link. ignore_zeros = False # If true, skips empty or invalid blocks and # continues processing. errorlevel = 1 # If 0, fatal errors only appear in debug # messages (if debug >= 0). If > 0, errors # are passed to the caller as exceptions. format = DEFAULT_FORMAT # The format to use when creating an archive. encoding = ENCODING # Encoding for 8-bit character strings. errors = None # Error handler for unicode conversion. tarinfo = TarInfo # The default TarInfo class to use. fileobject = ExFileObject # The file-object for extractfile(). extraction_filter = None # The default filter for extraction. def __init__(self, name=None, mode="r", fileobj=None, format=None, tarinfo=None, dereference=None, ignore_zeros=None, encoding=None, errors="surrogateescape", pax_headers=None, debug=None, errorlevel=None, copybufsize=None, stream=False): """Open an (uncompressed) tar archive 'name'. 'mode' is either 'r' to read from an existing archive, 'a' to append data to an existing file or 'w' to create a new file overwriting an existing one. 'mode' defaults to 'r'. If 'fileobj' is given, it is used for reading or writing data. If it can be determined, 'mode' is overridden by 'fileobj's mode. 'fileobj' is not closed, when TarFile is closed. """ modes = {"r": "rb", "a": "r+b", "w": "wb", "x": "xb"} if mode not in modes: raise ValueError("mode must be 'r', 'a', 'w' or 'x'") self.mode = mode self._mode = modes[mode] if not fileobj: if self.mode == "a" and not os.path.exists(name): # Create nonexistent files in append mode. self.mode = "w" self._mode = "wb" fileobj = bltn_open(name, self._mode) self._extfileobj = False else: if (name is None and hasattr(fileobj, "name") and isinstance(fileobj.name, (str, bytes))): name = fileobj.name if hasattr(fileobj, "mode"): self._mode = fileobj.mode self._extfileobj = True self.name = os.path.abspath(name) if name else None self.fileobj = fileobj self.stream = stream # Init attributes. if format is not None: self.format = format if tarinfo is not None: self.tarinfo = tarinfo if dereference is not None: self.dereference = dereference if ignore_zeros is not None: self.ignore_zeros = ignore_zeros if encoding is not None: self.encoding = encoding self.errors = errors if pax_headers is not None and self.format == PAX_FORMAT: self.pax_headers = pax_headers else: self.pax_headers = {} if debug is not None: self.debug = debug if errorlevel is not None: self.errorlevel = errorlevel # Init datastructures. self.copybufsize = copybufsize self.closed = False self.members = [] # list of members as TarInfo objects self._loaded = False # flag if all members have been read self.offset = self.fileobj.tell() # current position in the archive file self.inodes = {} # dictionary caching the inodes of # archive members already added try: if self.mode == "r": self.firstmember = None self.firstmember = self.next() if self.mode == "a": # Move to the end of the archive, # before the first empty block. while True: self.fileobj.seek(self.offset) try: tarinfo = self.tarinfo.fromtarfile(self) self.members.append(tarinfo) except EOFHeaderError: self.fileobj.seek(self.offset) break except HeaderError as e: raise ReadError(str(e)) from None if self.mode in ("a", "w", "x"): self._loaded = True if self.pax_headers: buf = self.tarinfo.create_pax_global_header(self.pax_headers.copy()) self.fileobj.write(buf) self.offset += len(buf) except: if not self._extfileobj: self.fileobj.close() self.closed = True raise #-------------------------------------------------------------------------- # Below are the classmethods which act as alternate constructors to the # TarFile class. The open() method is the only one that is needed for # public use; it is the "super"-constructor and is able to select an # adequate "sub"-constructor for a particular compression using the mapping # from OPEN_METH. # # This concept allows one to subclass TarFile without losing the comfort of # the super-constructor. A sub-constructor is registered and made available # by adding it to the mapping in OPEN_METH. @classmethod def open(cls, name=None, mode="r", fileobj=None, bufsize=RECORDSIZE, **kwargs): r"""Open a tar archive for reading, writing or appending. Return an appropriate TarFile class. mode: 'r' or 'r:\*' open for reading with transparent compression 'r:' open for reading exclusively uncompressed 'r:gz' open for reading with gzip compression 'r:bz2' open for reading with bzip2 compression 'r:xz' open for reading with lzma compression 'a' or 'a:' open for appending, creating the file if necessary 'w' or 'w:' open for writing without compression 'w:gz' open for writing with gzip compression 'w:bz2' open for writing with bzip2 compression 'w:xz' open for writing with lzma compression 'x' or 'x:' create a tarfile exclusively without compression, raise an exception if the file is already created 'x:gz' create a gzip compressed tarfile, raise an exception if the file is already created 'x:bz2' create a bzip2 compressed tarfile, raise an exception if the file is already created 'x:xz' create an lzma compressed tarfile, raise an exception if the file is already created 'r|\*' open a stream of tar blocks with transparent compression 'r|' open an uncompressed stream of tar blocks for reading 'r|gz' open a gzip compressed stream of tar blocks 'r|bz2' open a bzip2 compressed stream of tar blocks 'r|xz' open an lzma compressed stream of tar blocks 'w|' open an uncompressed stream for writing 'w|gz' open a gzip compressed stream for writing 'w|bz2' open a bzip2 compressed stream for writing 'w|xz' open an lzma compressed stream for writing """ if not name and not fileobj: raise ValueError("nothing to open") if mode in ("r", "r:*"): # Find out which *open() is appropriate for opening the file. def not_compressed(comptype): return cls.OPEN_METH[comptype] == 'taropen' error_msgs = [] for comptype in sorted(cls.OPEN_METH, key=not_compressed): func = getattr(cls, cls.OPEN_METH[comptype]) if fileobj is not None: saved_pos = fileobj.tell() try: return func(name, "r", fileobj, **kwargs) except (ReadError, CompressionError) as e: error_msgs.append(f'- method {comptype}: {e!r}') if fileobj is not None: fileobj.seek(saved_pos) continue error_msgs_summary = '\n'.join(error_msgs) raise ReadError(f"file could not be opened successfully:\n{error_msgs_summary}") elif ":" in mode: filemode, comptype = mode.split(":", 1) filemode = filemode or "r" comptype = comptype or "tar" # Select the *open() function according to # given compression. if comptype in cls.OPEN_METH: func = getattr(cls, cls.OPEN_METH[comptype]) else: raise CompressionError("unknown compression type %r" % comptype) return func(name, filemode, fileobj, **kwargs) elif "|" in mode: filemode, comptype = mode.split("|", 1) filemode = filemode or "r" comptype = comptype or "tar" if filemode not in ("r", "w"): raise ValueError("mode must be 'r' or 'w'") compresslevel = kwargs.pop("compresslevel", 9) stream = _Stream(name, filemode, comptype, fileobj, bufsize, compresslevel) try: t = cls(name, filemode, stream, **kwargs) except: stream.close() raise t._extfileobj = False return t elif mode in ("a", "w", "x"): return cls.taropen(name, mode, fileobj, **kwargs) raise ValueError("undiscernible mode") @classmethod def taropen(cls, name, mode="r", fileobj=None, **kwargs): """Open uncompressed tar archive name for reading or writing. """ if mode not in ("r", "a", "w", "x"): raise ValueError("mode must be 'r', 'a', 'w' or 'x'") return cls(name, mode, fileobj, **kwargs) @classmethod def gzopen(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs): """Open gzip compressed tar archive name for reading or writing. Appending is not allowed. """ if mode not in ("r", "w", "x"): raise ValueError("mode must be 'r', 'w' or 'x'") try: from gzip import GzipFile except ImportError: raise CompressionError("gzip module is not available") from None try: fileobj = GzipFile(name, mode + "b", compresslevel, fileobj) except OSError as e: if fileobj is not None and mode == 'r': raise ReadError("not a gzip file") from e raise try: t = cls.taropen(name, mode, fileobj, **kwargs) except OSError as e: fileobj.close() if mode == 'r': raise ReadError("not a gzip file") from e raise except: fileobj.close() raise t._extfileobj = False return t @classmethod def bz2open(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs): """Open bzip2 compressed tar archive name for reading or writing. Appending is not allowed. """ if mode not in ("r", "w", "x"): raise ValueError("mode must be 'r', 'w' or 'x'") try: from bz2 import BZ2File except ImportError: raise CompressionError("bz2 module is not available") from None fileobj = BZ2File(fileobj or name, mode, compresslevel=compresslevel) try: t = cls.taropen(name, mode, fileobj, **kwargs) except (OSError, EOFError) as e: fileobj.close() if mode == 'r': raise ReadError("not a bzip2 file") from e raise except: fileobj.close() raise t._extfileobj = False return t @classmethod def xzopen(cls, name, mode="r", fileobj=None, preset=None, **kwargs): """Open lzma compressed tar archive name for reading or writing. Appending is not allowed. """ if mode not in ("r", "w", "x"): raise ValueError("mode must be 'r', 'w' or 'x'") try: from lzma import LZMAFile, LZMAError except ImportError: raise CompressionError("lzma module is not available") from None fileobj = LZMAFile(fileobj or name, mode, preset=preset) try: t = cls.taropen(name, mode, fileobj, **kwargs) except (LZMAError, EOFError) as e: fileobj.close() if mode == 'r': raise ReadError("not an lzma file") from e raise except: fileobj.close() raise t._extfileobj = False return t # All *open() methods are registered here. OPEN_METH = { "tar": "taropen", # uncompressed tar "gz": "gzopen", # gzip compressed tar "bz2": "bz2open", # bzip2 compressed tar "xz": "xzopen" # lzma compressed tar } #-------------------------------------------------------------------------- # The public methods which TarFile provides: def close(self): """Close the TarFile. In write-mode, two finishing zero blocks are appended to the archive. """ if self.closed: return self.closed = True try: if self.mode in ("a", "w", "x"): self.fileobj.write(NUL * (BLOCKSIZE * 2)) self.offset += (BLOCKSIZE * 2) # fill up the end with zero-blocks # (like option -b20 for tar does) blocks, remainder = divmod(self.offset, RECORDSIZE) if remainder > 0: self.fileobj.write(NUL * (RECORDSIZE - remainder)) finally: if not self._extfileobj: self.fileobj.close() def getmember(self, name): """Return a TarInfo object for member 'name'. If 'name' can not be found in the archive, KeyError is raised. If a member occurs more than once in the archive, its last occurrence is assumed to be the most up-to-date version. """ tarinfo = self._getmember(name.rstrip('/')) if tarinfo is None: raise KeyError("filename %r not found" % name) return tarinfo def getmembers(self): """Return the members of the archive as a list of TarInfo objects. The list has the same order as the members in the archive. """ self._check() if not self._loaded: # if we want to obtain a list of self._load() # all members, we first have to # scan the whole archive. return self.members def getnames(self): """Return the members of the archive as a list of their names. It has the same order as the list returned by getmembers(). """ return [tarinfo.name for tarinfo in self.getmembers()] def gettarinfo(self, name=None, arcname=None, fileobj=None): """Create a TarInfo object from the result of os.stat or equivalent on an existing file. The file is either named by 'name', or specified as a file object 'fileobj' with a file descriptor. If given, 'arcname' specifies an alternative name for the file in the archive, otherwise, the name is taken from the 'name' attribute of 'fileobj', or the 'name' argument. The name should be a text string. """ self._check("awx") # When fileobj is given, replace name by # fileobj's real name. if fileobj is not None: name = fileobj.name # Building the name of the member in the archive. # Backward slashes are converted to forward slashes, # Absolute paths are turned to relative paths. if arcname is None: arcname = name drv, arcname = os.path.splitdrive(arcname) arcname = arcname.replace(os.sep, "/") arcname = arcname.lstrip("/") # Now, fill the TarInfo object with # information specific for the file. tarinfo = self.tarinfo() tarinfo._tarfile = self # To be removed in 3.16. # Use os.stat or os.lstat, depending on if symlinks shall be resolved. if fileobj is None: if not self.dereference: statres = os.lstat(name) else: statres = os.stat(name) else: statres = os.fstat(fileobj.fileno()) linkname = "" stmd = statres.st_mode if stat.S_ISREG(stmd): inode = (statres.st_ino, statres.st_dev) if not self.dereference and statres.st_nlink > 1 and \ inode in self.inodes and arcname != self.inodes[inode]: # Is it a hardlink to an already # archived file? type = LNKTYPE linkname = self.inodes[inode] else: # The inode is added only if its valid. # For win32 it is always 0. type = REGTYPE if inode[0]: self.inodes[inode] = arcname elif stat.S_ISDIR(stmd): type = DIRTYPE elif stat.S_ISFIFO(stmd): type = FIFOTYPE elif stat.S_ISLNK(stmd): type = SYMTYPE linkname = os.readlink(name) elif stat.S_ISCHR(stmd): type = CHRTYPE elif stat.S_ISBLK(stmd): type = BLKTYPE else: return None # Fill the TarInfo object with all # information we can get. tarinfo.name = arcname tarinfo.mode = stmd tarinfo.uid = statres.st_uid tarinfo.gid = statres.st_gid if type == REGTYPE: tarinfo.size = statres.st_size else: tarinfo.size = 0 tarinfo.mtime = statres.st_mtime tarinfo.type = type tarinfo.linkname = linkname if pwd: try: tarinfo.uname = pwd.getpwuid(tarinfo.uid)[0] except KeyError: pass if grp: try: tarinfo.gname = grp.getgrgid(tarinfo.gid)[0] except KeyError: pass if type in (CHRTYPE, BLKTYPE): if hasattr(os, "major") and hasattr(os, "minor"): tarinfo.devmajor = os.major(statres.st_rdev) tarinfo.devminor = os.minor(statres.st_rdev) return tarinfo def list(self, verbose=True, *, members=None): """Print a table of contents to sys.stdout. If 'verbose' is False, only the names of the members are printed. If it is True, an 'ls -l'-like output is produced. 'members' is optional and must be a subset of the list returned by getmembers(). """ # Convert tarinfo type to stat type. type2mode = {REGTYPE: stat.S_IFREG, SYMTYPE: stat.S_IFLNK, FIFOTYPE: stat.S_IFIFO, CHRTYPE: stat.S_IFCHR, DIRTYPE: stat.S_IFDIR, BLKTYPE: stat.S_IFBLK} self._check() if members is None: members = self for tarinfo in members: if verbose: if tarinfo.mode is None: _safe_print("??????????") else: modetype = type2mode.get(tarinfo.type, 0) _safe_print(stat.filemode(modetype | tarinfo.mode)) _safe_print("%s/%s" % (tarinfo.uname or tarinfo.uid, tarinfo.gname or tarinfo.gid)) if tarinfo.ischr() or tarinfo.isblk(): _safe_print("%10s" % ("%d,%d" % (tarinfo.devmajor, tarinfo.devminor))) else: _safe_print("%10d" % tarinfo.size) if tarinfo.mtime is None: _safe_print("????-??-?? ??:??:??") else: _safe_print("%d-%02d-%02d %02d:%02d:%02d" \ % time.localtime(tarinfo.mtime)[:6]) _safe_print(tarinfo.name + ("/" if tarinfo.isdir() else "")) if verbose: if tarinfo.issym(): _safe_print("-> " + tarinfo.linkname) if tarinfo.islnk(): _safe_print("link to " + tarinfo.linkname) print() def add(self, name, arcname=None, recursive=True, *, filter=None): """Add the file 'name' to the archive. 'name' may be any type of file (directory, fifo, symbolic link, etc.). If given, 'arcname' specifies an alternative name for the file in the archive. Directories are added recursively by default. This can be avoided by setting 'recursive' to False. 'filter' is a function that expects a TarInfo object argument and returns the changed TarInfo object, if it returns None the TarInfo object will be excluded from the archive. """ self._check("awx") if arcname is None: arcname = name # Skip if somebody tries to archive the archive... if self.name is not None and os.path.abspath(name) == self.name: self._dbg(2, "tarfile: Skipped %r" % name) return self._dbg(1, name) # Create a TarInfo object from the file. tarinfo = self.gettarinfo(name, arcname) if tarinfo is None: self._dbg(1, "tarfile: Unsupported type %r" % name) return # Change or exclude the TarInfo object. if filter is not None: tarinfo = filter(tarinfo) if tarinfo is None: self._dbg(2, "tarfile: Excluded %r" % name) return # Append the tar header and data to the archive. if tarinfo.isreg(): with bltn_open(name, "rb") as f: self.addfile(tarinfo, f) elif tarinfo.isdir(): self.addfile(tarinfo) if recursive: for f in sorted(os.listdir(name)): self.add(os.path.join(name, f), os.path.join(arcname, f), recursive, filter=filter) else: self.addfile(tarinfo) def addfile(self, tarinfo, fileobj=None): """Add the TarInfo object 'tarinfo' to the archive. If 'tarinfo' represents a non zero-size regular file, the 'fileobj' argument should be a binary file, and tarinfo.size bytes are read from it and added to the archive. You can create TarInfo objects directly, or by using gettarinfo(). """ self._check("awx") if fileobj is None and tarinfo.isreg() and tarinfo.size != 0: raise ValueError("fileobj not provided for non zero-size regular file") tarinfo = copy.copy(tarinfo) buf = tarinfo.tobuf(self.format, self.encoding, self.errors) self.fileobj.write(buf) self.offset += len(buf) bufsize=self.copybufsize # If there's data to follow, append it. if fileobj is not None: copyfileobj(fileobj, self.fileobj, tarinfo.size, bufsize=bufsize) blocks, remainder = divmod(tarinfo.size, BLOCKSIZE) if remainder > 0: self.fileobj.write(NUL * (BLOCKSIZE - remainder)) blocks += 1 self.offset += blocks * BLOCKSIZE self.members.append(tarinfo) def _get_filter_function(self, filter): if filter is None: filter = self.extraction_filter if filter is None: import warnings warnings.warn( 'Python 3.14 will, by default, filter extracted tar ' + 'archives and reject files or modify their metadata. ' + 'Use the filter argument to control this behavior.', DeprecationWarning, stacklevel=3) return fully_trusted_filter if isinstance(filter, str): raise TypeError( 'String names are not supported for ' + 'TarFile.extraction_filter. Use a function such as ' + 'tarfile.data_filter directly.') return filter if callable(filter): return filter try: return _NAMED_FILTERS[filter] except KeyError: raise ValueError(f"filter {filter!r} not found") from None def extractall(self, path=".", members=None, *, numeric_owner=False, filter=None): """Extract all members from the archive to the current working directory and set owner, modification time and permissions on directories afterwards. 'path' specifies a different directory to extract to. 'members' is optional and must be a subset of the list returned by getmembers(). If 'numeric_owner' is True, only the numbers for user/group names are used and not the names. The 'filter' function will be called on each member just before extraction. It can return a changed TarInfo or None to skip the member. String names of common filters are accepted. """ directories = [] filter_function = self._get_filter_function(filter) if members is None: members = self for member in members: tarinfo = self._get_extract_tarinfo(member, filter_function, path) if tarinfo is None: continue if tarinfo.isdir(): # For directories, delay setting attributes until later, # since permissions can interfere with extraction and # extracting contents can reset mtime. directories.append(tarinfo) self._extract_one(tarinfo, path, set_attrs=not tarinfo.isdir(), numeric_owner=numeric_owner) # Reverse sort directories. directories.sort(key=lambda a: a.name, reverse=True) # Set correct owner, mtime and filemode on directories. for tarinfo in directories: dirpath = os.path.join(path, tarinfo.name) try: self.chown(tarinfo, dirpath, numeric_owner=numeric_owner) self.utime(tarinfo, dirpath) self.chmod(tarinfo, dirpath) except ExtractError as e: self._handle_nonfatal_error(e) def extract(self, member, path="", set_attrs=True, *, numeric_owner=False, filter=None): """Extract a member from the archive to the current working directory, using its full name. Its file information is extracted as accurately as possible. 'member' may be a filename or a TarInfo object. You can specify a different directory using 'path'. File attributes (owner, mtime, mode) are set unless 'set_attrs' is False. If 'numeric_owner' is True, only the numbers for user/group names are used and not the names. The 'filter' function will be called before extraction. It can return a changed TarInfo or None to skip the member. String names of common filters are accepted. """ filter_function = self._get_filter_function(filter) tarinfo = self._get_extract_tarinfo(member, filter_function, path) if tarinfo is not None: self._extract_one(tarinfo, path, set_attrs, numeric_owner) def _get_extract_tarinfo(self, member, filter_function, path): """Get filtered TarInfo (or None) from member, which might be a str""" if isinstance(member, str): tarinfo = self.getmember(member) else: tarinfo = member unfiltered = tarinfo try: tarinfo = filter_function(tarinfo, path) except (OSError, FilterError) as e: self._handle_fatal_error(e) except ExtractError as e: self._handle_nonfatal_error(e) if tarinfo is None: self._dbg(2, "tarfile: Excluded %r" % unfiltered.name) return None # Prepare the link target for makelink(). if tarinfo.islnk(): tarinfo = copy.copy(tarinfo) tarinfo._link_target = os.path.join(path, tarinfo.linkname) return tarinfo def _extract_one(self, tarinfo, path, set_attrs, numeric_owner): """Extract from filtered tarinfo to disk""" self._check("r") try: self._extract_member(tarinfo, os.path.join(path, tarinfo.name), set_attrs=set_attrs, numeric_owner=numeric_owner) except OSError as e: self._handle_fatal_error(e) except ExtractError as e: self._handle_nonfatal_error(e) def _handle_nonfatal_error(self, e): """Handle non-fatal error (ExtractError) according to errorlevel""" if self.errorlevel > 1: raise else: self._dbg(1, "tarfile: %s" % e) def _handle_fatal_error(self, e): """Handle "fatal" error according to self.errorlevel""" if self.errorlevel > 0: raise elif isinstance(e, OSError): if e.filename is None: self._dbg(1, "tarfile: %s" % e.strerror) else: self._dbg(1, "tarfile: %s %r" % (e.strerror, e.filename)) else: self._dbg(1, "tarfile: %s %s" % (type(e).__name__, e)) def extractfile(self, member): """Extract a member from the archive as a file object. 'member' may be a filename or a TarInfo object. If 'member' is a regular file or a link, an io.BufferedReader object is returned. For all other existing members, None is returned. If 'member' does not appear in the archive, KeyError is raised. """ self._check("r") if isinstance(member, str): tarinfo = self.getmember(member) else: tarinfo = member if tarinfo.isreg() or tarinfo.type not in SUPPORTED_TYPES: # Members with unknown types are treated as regular files. return self.fileobject(self, tarinfo) elif tarinfo.islnk() or tarinfo.issym(): if isinstance(self.fileobj, _Stream): # A small but ugly workaround for the case that someone tries # to extract a (sym)link as a file-object from a non-seekable # stream of tar blocks. raise StreamError("cannot extract (sym)link as file object") else: # A (sym)link's file object is its target's file object. return self.extractfile(self._find_link_target(tarinfo)) else: # If there's no data associated with the member (directory, chrdev, # blkdev, etc.), return None instead of a file object. return None def _extract_member(self, tarinfo, targetpath, set_attrs=True, numeric_owner=False): """Extract the TarInfo object tarinfo to a physical file called targetpath. """ # Fetch the TarInfo object for the given name # and build the destination pathname, replacing # forward slashes to platform specific separators. targetpath = targetpath.rstrip("/") targetpath = targetpath.replace("/", os.sep) # Create all upper directories. upperdirs = os.path.dirname(targetpath) if upperdirs and not os.path.exists(upperdirs): # Create directories that are not part of the archive with # default permissions. os.makedirs(upperdirs, exist_ok=True) if tarinfo.islnk() or tarinfo.issym(): self._dbg(1, "%s -> %s" % (tarinfo.name, tarinfo.linkname)) else: self._dbg(1, tarinfo.name) if tarinfo.isreg(): self.makefile(tarinfo, targetpath) elif tarinfo.isdir(): self.makedir(tarinfo, targetpath) elif tarinfo.isfifo(): self.makefifo(tarinfo, targetpath) elif tarinfo.ischr() or tarinfo.isblk(): self.makedev(tarinfo, targetpath) elif tarinfo.islnk() or tarinfo.issym(): self.makelink(tarinfo, targetpath) elif tarinfo.type not in SUPPORTED_TYPES: self.makeunknown(tarinfo, targetpath) else: self.makefile(tarinfo, targetpath) if set_attrs: self.chown(tarinfo, targetpath, numeric_owner) if not tarinfo.issym(): self.chmod(tarinfo, targetpath) self.utime(tarinfo, targetpath) #-------------------------------------------------------------------------- # Below are the different file methods. They are called via # _extract_member() when extract() is called. They can be replaced in a # subclass to implement other functionality. def makedir(self, tarinfo, targetpath): """Make a directory called targetpath. """ try: if tarinfo.mode is None: # Use the system's default mode os.mkdir(targetpath) else: # Use a safe mode for the directory, the real mode is set # later in _extract_member(). os.mkdir(targetpath, 0o700) except FileExistsError: if not os.path.isdir(targetpath): raise def makefile(self, tarinfo, targetpath): """Make a file called targetpath. """ source = self.fileobj source.seek(tarinfo.offset_data) bufsize = self.copybufsize with bltn_open(targetpath, "wb") as target: if tarinfo.sparse is not None: for offset, size in tarinfo.sparse: target.seek(offset) copyfileobj(source, target, size, ReadError, bufsize) target.seek(tarinfo.size) target.truncate() else: copyfileobj(source, target, tarinfo.size, ReadError, bufsize) def makeunknown(self, tarinfo, targetpath): """Make a file from a TarInfo object with an unknown type at targetpath. """ self.makefile(tarinfo, targetpath) self._dbg(1, "tarfile: Unknown file type %r, " \ "extracted as regular file." % tarinfo.type) def makefifo(self, tarinfo, targetpath): """Make a fifo called targetpath. """ if hasattr(os, "mkfifo"): os.mkfifo(targetpath) else: raise ExtractError("fifo not supported by system") def makedev(self, tarinfo, targetpath): """Make a character or block device called targetpath. """ if not hasattr(os, "mknod") or not hasattr(os, "makedev"): raise ExtractError("special devices not supported by system") mode = tarinfo.mode if mode is None: # Use mknod's default mode = 0o600 if tarinfo.isblk(): mode |= stat.S_IFBLK else: mode |= stat.S_IFCHR os.mknod(targetpath, mode, os.makedev(tarinfo.devmajor, tarinfo.devminor)) def makelink(self, tarinfo, targetpath): """Make a (symbolic) link called targetpath. If it cannot be created (platform limitation), we try to make a copy of the referenced file instead of a link. """ try: # For systems that support symbolic and hard links. if tarinfo.issym(): if os.path.lexists(targetpath): # Avoid FileExistsError on following os.symlink. os.unlink(targetpath) os.symlink(tarinfo.linkname, targetpath) else: if os.path.exists(tarinfo._link_target): os.link(tarinfo._link_target, targetpath) else: self._extract_member(self._find_link_target(tarinfo), targetpath) except symlink_exception: try: self._extract_member(self._find_link_target(tarinfo), targetpath) except KeyError: raise ExtractError("unable to resolve link inside archive") from None def chown(self, tarinfo, targetpath, numeric_owner): """Set owner of targetpath according to tarinfo. If numeric_owner is True, use .gid/.uid instead of .gname/.uname. If numeric_owner is False, fall back to .gid/.uid when the search based on name fails. """ if hasattr(os, "geteuid") and os.geteuid() == 0: # We have to be root to do so. g = tarinfo.gid u = tarinfo.uid if not numeric_owner: try: if grp and tarinfo.gname: g = grp.getgrnam(tarinfo.gname)[2] except KeyError: pass try: if pwd and tarinfo.uname: u = pwd.getpwnam(tarinfo.uname)[2] except KeyError: pass if g is None: g = -1 if u is None: u = -1 try: if tarinfo.issym() and hasattr(os, "lchown"): os.lchown(targetpath, u, g) else: os.chown(targetpath, u, g) except (OSError, OverflowError) as e: # OverflowError can be raised if an ID doesn't fit in 'id_t' raise ExtractError("could not change owner") from e def chmod(self, tarinfo, targetpath): """Set file permissions of targetpath according to tarinfo. """ if tarinfo.mode is None: return try: os.chmod(targetpath, tarinfo.mode) except OSError as e: raise ExtractError("could not change mode") from e def utime(self, tarinfo, targetpath): """Set modification time of targetpath according to tarinfo. """ mtime = tarinfo.mtime if mtime is None: return if not hasattr(os, 'utime'): return try: os.utime(targetpath, (mtime, mtime)) except OSError as e: raise ExtractError("could not change modification time") from e #-------------------------------------------------------------------------- def next(self): """Return the next member of the archive as a TarInfo object, when TarFile is opened for reading. Return None if there is no more available. """ self._check("ra") if self.firstmember is not None: m = self.firstmember self.firstmember = None return m # Advance the file pointer. if self.offset != self.fileobj.tell(): if self.offset == 0: return None self.fileobj.seek(self.offset - 1) if not self.fileobj.read(1): raise ReadError("unexpected end of data") # Read the next block. tarinfo = None while True: try: tarinfo = self.tarinfo.fromtarfile(self) except EOFHeaderError as e: if self.ignore_zeros: self._dbg(2, "0x%X: %s" % (self.offset, e)) self.offset += BLOCKSIZE continue except InvalidHeaderError as e: if self.ignore_zeros: self._dbg(2, "0x%X: %s" % (self.offset, e)) self.offset += BLOCKSIZE continue elif self.offset == 0: raise ReadError(str(e)) from None except EmptyHeaderError: if self.offset == 0: raise ReadError("empty file") from None except TruncatedHeaderError as e: if self.offset == 0: raise ReadError(str(e)) from None except SubsequentHeaderError as e: raise ReadError(str(e)) from None except Exception as e: try: import zlib if isinstance(e, zlib.error): raise ReadError(f'zlib error: {e}') from None else: raise e except ImportError: raise e break if tarinfo is not None: # if streaming the file we do not want to cache the tarinfo if not self.stream: self.members.append(tarinfo) else: self._loaded = True return tarinfo #-------------------------------------------------------------------------- # Little helper methods: def _getmember(self, name, tarinfo=None, normalize=False): """Find an archive member by name from bottom to top. If tarinfo is given, it is used as the starting point. """ # Ensure that all members have been loaded. members = self.getmembers() # Limit the member search list up to tarinfo. skipping = False if tarinfo is not None: try: index = members.index(tarinfo) except ValueError: # The given starting point might be a (modified) copy. # We'll later skip members until we find an equivalent. skipping = True else: # Happy fast path members = members[:index] if normalize: name = os.path.normpath(name) for member in reversed(members): if skipping: if tarinfo.offset == member.offset: skipping = False continue if normalize: member_name = os.path.normpath(member.name) else: member_name = member.name if name == member_name: return member if skipping: # Starting point was not found raise ValueError(tarinfo) def _load(self): """Read through the entire archive file and look for readable members. This should not run if the file is set to stream. """ if not self.stream: while self.next() is not None: pass self._loaded = True def _check(self, mode=None): """Check if TarFile is still open, and if the operation's mode corresponds to TarFile's mode. """ if self.closed: raise OSError("%s is closed" % self.__class__.__name__) if mode is not None and self.mode not in mode: raise OSError("bad operation for mode %r" % self.mode) def _find_link_target(self, tarinfo): """Find the target member of a symlink or hardlink member in the archive. """ if tarinfo.issym(): # Always search the entire archive. linkname = "/".join(filter(None, (os.path.dirname(tarinfo.name), tarinfo.linkname))) limit = None else: # Search the archive before the link, because a hard link is # just a reference to an already archived file. linkname = tarinfo.linkname limit = tarinfo member = self._getmember(linkname, tarinfo=limit, normalize=True) if member is None: raise KeyError("linkname %r not found" % linkname) return member def __iter__(self): """Provide an iterator object. """ if self._loaded: yield from self.members return # Yield items using TarFile's next() method. # When all members have been read, set TarFile as _loaded. index = 0 # Fix for SF #1100429: Under rare circumstances it can # happen that getmembers() is called during iteration, # which will have already exhausted the next() method. if self.firstmember is not None: tarinfo = self.next() index += 1 yield tarinfo while True: if index < len(self.members): tarinfo = self.members[index] elif not self._loaded: tarinfo = self.next() if not tarinfo: self._loaded = True return else: return index += 1 yield tarinfo def _dbg(self, level, msg): """Write debugging output to sys.stderr. """ if level <= self.debug: print(msg, file=sys.stderr) def __enter__(self): self._check() return self def __exit__(self, type, value, traceback): if type is None: self.close() else: # An exception occurred. We must not call close() because # it would try to write end-of-archive blocks and padding. if not self._extfileobj: self.fileobj.close() self.closed = True #-------------------- # exported functions #-------------------- def is_tarfile(name): """Return True if name points to a tar archive that we are able to handle, else return False. 'name' should be a string, file, or file-like object. """ try: if hasattr(name, "read"): pos = name.tell() t = open(fileobj=name) name.seek(pos) else: t = open(name) t.close() return True except TarError: return False open = TarFile.open def main(): import argparse description = 'A simple command-line interface for tarfile module.' parser = argparse.ArgumentParser(description=description) parser.add_argument('-v', '--verbose', action='store_true', default=False, help='Verbose output') parser.add_argument('--filter', metavar='<filtername>', choices=_NAMED_FILTERS, help='Filter for extraction') group = parser.add_mutually_exclusive_group(required=True) group.add_argument('-l', '--list', metavar='<tarfile>', help='Show listing of a tarfile') group.add_argument('-e', '--extract', nargs='+', metavar=('<tarfile>', '<output_dir>'), help='Extract tarfile into target dir') group.add_argument('-c', '--create', nargs='+', metavar=('<name>', '<file>'), help='Create tarfile from sources') group.add_argument('-t', '--test', metavar='<tarfile>', help='Test if a tarfile is valid') args = parser.parse_args() if args.filter and args.extract is None: parser.exit(1, '--filter is only valid for extraction\n') if args.test is not None: src = args.test if is_tarfile(src): with open(src, 'r') as tar: tar.getmembers() print(tar.getmembers(), file=sys.stderr) if args.verbose: print('{!r} is a tar archive.'.format(src)) else: parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) elif args.list is not None: src = args.list if is_tarfile(src): with TarFile.open(src, 'r:*') as tf: tf.list(verbose=args.verbose) else: parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) elif args.extract is not None: if len(args.extract) == 1: src = args.extract[0] curdir = os.curdir elif len(args.extract) == 2: src, curdir = args.extract else: parser.exit(1, parser.format_help()) if is_tarfile(src): with TarFile.open(src, 'r:*') as tf: tf.extractall(path=curdir, filter=args.filter) if args.verbose: if curdir == '.': msg = '{!r} file is extracted.'.format(src) else: msg = ('{!r} file is extracted ' 'into {!r} directory.').format(src, curdir) print(msg) else: parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) elif args.create is not None: tar_name = args.create.pop(0) _, ext = os.path.splitext(tar_name) compressions = { # gz '.gz': 'gz', '.tgz': 'gz', # xz '.xz': 'xz', '.txz': 'xz', # bz2 '.bz2': 'bz2', '.tbz': 'bz2', '.tbz2': 'bz2', '.tb2': 'bz2', } tar_mode = 'w:' + compressions[ext] if ext in compressions else 'w' tar_files = args.create with TarFile.open(tar_name, tar_mode) as tf: for file_name in tar_files: tf.add(file_name) if args.verbose: print('{!r} file created.'.format(tar_name)) if __name__ == '__main__': main() _vendor/backports/__pycache__/__init__.cpython-310.pyc 0000644 00000000370 15030122015 0016625 0 ustar 00 o �hQ � @ s e d ��ee�ZdS )�pkgutilN)� __import__� extend_path�__path__�__name__� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/backports/__init__.py�<module> s _vendor/backports/__init__.py 0000644 00000000121 15030122015 0012260 0 ustar 00 __path__ = __import__('pkgutil').extend_path(__path__, __name__) # type: ignore _vendor/packaging-24.2.dist-info/LICENSE.BSD 0000644 00000002500 15030122015 0014000 0 ustar 00 Copyright (c) Donald Stufft and individual contributors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. _vendor/packaging-24.2.dist-info/RECORD 0000644 00000003731 15030122015 0013274 0 ustar 00 packaging-24.2.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2 packaging-24.2.dist-info/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 packaging-24.2.dist-info/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 packaging-24.2.dist-info/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 packaging-24.2.dist-info/METADATA,sha256=ohH86s6k5mIfQxY2TS0LcSfADeOFa4BiCC-bxZV-pNs,3204 packaging-24.2.dist-info/RECORD,, packaging-24.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 packaging-24.2.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494 packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306 packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612 packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 packaging/licenses/__init__.py,sha256=1x5M1nEYjcgwEbLt0dXwz2ukjr18DiCzC0sraQqJ-Ww,5715 packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561 packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762 packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 packaging/specifiers.py,sha256=GG1wPNMcL0fMJO68vF53wKMdwnfehDcaI-r9NpTfilA,40074 packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014 packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 packaging/version.py,sha256=olfyuk_DPbflNkJ4wBWetXQ17c74x3DB501degUv7DY,16676 _vendor/packaging-24.2.dist-info/METADATA 0000644 00000006204 15030122015 0013474 0 ustar 00 Metadata-Version: 2.3 Name: packaging Version: 24.2 Summary: Core utilities for Python packages Author-email: Donald Stufft <donald@stufft.io> Requires-Python: >=3.8 Description-Content-Type: text/x-rst Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: Apache Software License Classifier: License :: OSI Approved :: BSD License Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Programming Language :: Python :: Implementation :: CPython Classifier: Programming Language :: Python :: Implementation :: PyPy Classifier: Typing :: Typed Project-URL: Documentation, https://packaging.pypa.io/ Project-URL: Source, https://github.com/pypa/packaging packaging ========= .. start-intro Reusable core utilities for various Python Packaging `interoperability specifications <https://packaging.python.org/specifications/>`_. This library provides utilities that implement the interoperability specifications which have clearly one correct behaviour (eg: :pep:`440`) or benefit greatly from having a single shared implementation (eg: :pep:`425`). .. end-intro The ``packaging`` project includes the following: version handling, specifiers, markers, requirements, tags, utilities. Documentation ------------- The `documentation`_ provides information and the API for the following: - Version Handling - Specifiers - Markers - Requirements - Tags - Utilities Installation ------------ Use ``pip`` to install these utilities:: pip install packaging The ``packaging`` library uses calendar-based versioning (``YY.N``). Discussion ---------- If you run into bugs, you can file them in our `issue tracker`_. You can also join ``#pypa`` on Freenode to ask questions or get involved. .. _`documentation`: https://packaging.pypa.io/ .. _`issue tracker`: https://github.com/pypa/packaging/issues Code of Conduct --------------- Everyone interacting in the packaging project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. .. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md Contributing ------------ The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as well as how to report a potential security issue. The documentation for this project also covers information about `project development`_ and `security`_. .. _`project development`: https://packaging.pypa.io/en/latest/development/ .. _`security`: https://packaging.pypa.io/en/latest/security/ Project History --------------- Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for recent changes and project history. .. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/ _vendor/packaging-24.2.dist-info/INSTALLER 0000644 00000000002 15030122015 0013637 0 ustar 00 uv _vendor/packaging-24.2.dist-info/WHEEL 0000644 00000000122 15030122015 0013151 0 ustar 00 Wheel-Version: 1.0 Generator: flit 3.10.1 Root-Is-Purelib: true Tag: py3-none-any _vendor/packaging-24.2.dist-info/LICENSE.APACHE 0000644 00000023676 15030122015 0014332 0 ustar 00 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS _vendor/packaging-24.2.dist-info/LICENSE 0000644 00000000305 15030122015 0013372 0 ustar 00 This software is made available under the terms of *either* of the licenses found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made under the terms of *both* these licenses. _vendor/packaging-24.2.dist-info/REQUESTED 0000644 00000000000 15030122015 0013641 0 ustar 00 _vendor/platformdirs-4.2.2.dist-info/RECORD 0000644 00000003152 15030122015 0014131 0 ustar 00 platformdirs-4.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 platformdirs-4.2.2.dist-info/METADATA,sha256=zmsie01G1MtXR0wgIv5XpVeTO7idr0WWvfmxKsKWuGk,11429 platformdirs-4.2.2.dist-info/RECORD,, platformdirs-4.2.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 platformdirs-4.2.2.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87 platformdirs-4.2.2.dist-info/licenses/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089 platformdirs/__init__.py,sha256=EMGE8qeHRR9CzDFr8kL3tA8hdZZniYjXBVZd0UGTWK0,22225 platformdirs/__main__.py,sha256=HnsUQHpiBaiTxwcmwVw-nFaPdVNZtQIdi1eWDtI-MzI,1493 platformdirs/__pycache__/__init__.cpython-312.pyc,, platformdirs/__pycache__/__main__.cpython-312.pyc,, platformdirs/__pycache__/android.cpython-312.pyc,, platformdirs/__pycache__/api.cpython-312.pyc,, platformdirs/__pycache__/macos.cpython-312.pyc,, platformdirs/__pycache__/unix.cpython-312.pyc,, platformdirs/__pycache__/version.cpython-312.pyc,, platformdirs/__pycache__/windows.cpython-312.pyc,, platformdirs/android.py,sha256=xZXY9Jd46WOsxT2U6-5HsNtDZ-IQqxcEUrBLl3hYk4o,9016 platformdirs/api.py,sha256=QBYdUac2eC521ek_y53uD1Dcq-lJX8IgSRVd4InC6uc,8996 platformdirs/macos.py,sha256=wftsbsvq6nZ0WORXSiCrZNkRHz_WKuktl0a6mC7MFkI,5580 platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 platformdirs/unix.py,sha256=Cci9Wqt35dAMsg6HT9nRGHSBW5obb0pR3AE1JJnsCXg,10643 platformdirs/version.py,sha256=r7F76tZRjgQKzrpx_I0_ZMQOMU-PS7eGnHD7zEK3KB0,411 platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125 _vendor/platformdirs-4.2.2.dist-info/METADATA 0000644 00000026245 15030122015 0014343 0 ustar 00 Metadata-Version: 2.3 Name: platformdirs Version: 4.2.2 Summary: A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`. Project-URL: Documentation, https://platformdirs.readthedocs.io Project-URL: Homepage, https://github.com/platformdirs/platformdirs Project-URL: Source, https://github.com/platformdirs/platformdirs Project-URL: Tracker, https://github.com/platformdirs/platformdirs/issues Maintainer-email: Bernát Gábor <gaborjbernat@gmail.com>, Julian Berman <Julian@GrayVines.com>, Ofek Lev <oss@ofek.dev>, Ronny Pfannschmidt <opensource@ronnypfannschmidt.de> License-Expression: MIT License-File: LICENSE Keywords: appdirs,application,cache,directory,log,user Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: Implementation :: CPython Classifier: Programming Language :: Python :: Implementation :: PyPy Classifier: Topic :: Software Development :: Libraries :: Python Modules Requires-Python: >=3.8 Provides-Extra: docs Requires-Dist: furo>=2023.9.10; extra == 'docs' Requires-Dist: proselint>=0.13; extra == 'docs' Requires-Dist: sphinx-autodoc-typehints>=1.25.2; extra == 'docs' Requires-Dist: sphinx>=7.2.6; extra == 'docs' Provides-Extra: test Requires-Dist: appdirs==1.4.4; extra == 'test' Requires-Dist: covdefaults>=2.3; extra == 'test' Requires-Dist: pytest-cov>=4.1; extra == 'test' Requires-Dist: pytest-mock>=3.12; extra == 'test' Requires-Dist: pytest>=7.4.3; extra == 'test' Provides-Extra: type Requires-Dist: mypy>=1.8; extra == 'type' Description-Content-Type: text/x-rst The problem =========== .. image:: https://github.com/platformdirs/platformdirs/actions/workflows/check.yml/badge.svg :target: https://github.com/platformdirs/platformdirs/actions When writing desktop application, finding the right location to store user data and configuration varies per platform. Even for single-platform apps, there may by plenty of nuances in figuring out the right location. For example, if running on macOS, you should use:: ~/Library/Application Support/<AppName> If on Windows (at least English Win) that should be:: C:\Documents and Settings\<User>\Application Data\Local Settings\<AppAuthor>\<AppName> or possibly:: C:\Documents and Settings\<User>\Application Data\<AppAuthor>\<AppName> for `roaming profiles <https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-vista/cc766489(v=ws.10)>`_ but that is another story. On Linux (and other Unices), according to the `XDG Basedir Spec`_, it should be:: ~/.local/share/<AppName> .. _XDG Basedir Spec: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html ``platformdirs`` to the rescue ============================== This kind of thing is what the ``platformdirs`` package is for. ``platformdirs`` will help you choose an appropriate: - user data dir (``user_data_dir``) - user config dir (``user_config_dir``) - user cache dir (``user_cache_dir``) - site data dir (``site_data_dir``) - site config dir (``site_config_dir``) - user log dir (``user_log_dir``) - user documents dir (``user_documents_dir``) - user downloads dir (``user_downloads_dir``) - user pictures dir (``user_pictures_dir``) - user videos dir (``user_videos_dir``) - user music dir (``user_music_dir``) - user desktop dir (``user_desktop_dir``) - user runtime dir (``user_runtime_dir``) And also: - Is slightly opinionated on the directory names used. Look for "OPINION" in documentation and code for when an opinion is being applied. Example output ============== On macOS: .. code-block:: pycon >>> from platformdirs import * >>> appname = "SuperApp" >>> appauthor = "Acme" >>> user_data_dir(appname, appauthor) '/Users/trentm/Library/Application Support/SuperApp' >>> site_data_dir(appname, appauthor) '/Library/Application Support/SuperApp' >>> user_cache_dir(appname, appauthor) '/Users/trentm/Library/Caches/SuperApp' >>> user_log_dir(appname, appauthor) '/Users/trentm/Library/Logs/SuperApp' >>> user_documents_dir() '/Users/trentm/Documents' >>> user_downloads_dir() '/Users/trentm/Downloads' >>> user_pictures_dir() '/Users/trentm/Pictures' >>> user_videos_dir() '/Users/trentm/Movies' >>> user_music_dir() '/Users/trentm/Music' >>> user_desktop_dir() '/Users/trentm/Desktop' >>> user_runtime_dir(appname, appauthor) '/Users/trentm/Library/Caches/TemporaryItems/SuperApp' On Windows: .. code-block:: pycon >>> from platformdirs import * >>> appname = "SuperApp" >>> appauthor = "Acme" >>> user_data_dir(appname, appauthor) 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp' >>> user_data_dir(appname, appauthor, roaming=True) 'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp' >>> user_cache_dir(appname, appauthor) 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache' >>> user_log_dir(appname, appauthor) 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs' >>> user_documents_dir() 'C:\\Users\\trentm\\Documents' >>> user_downloads_dir() 'C:\\Users\\trentm\\Downloads' >>> user_pictures_dir() 'C:\\Users\\trentm\\Pictures' >>> user_videos_dir() 'C:\\Users\\trentm\\Videos' >>> user_music_dir() 'C:\\Users\\trentm\\Music' >>> user_desktop_dir() 'C:\\Users\\trentm\\Desktop' >>> user_runtime_dir(appname, appauthor) 'C:\\Users\\trentm\\AppData\\Local\\Temp\\Acme\\SuperApp' On Linux: .. code-block:: pycon >>> from platformdirs import * >>> appname = "SuperApp" >>> appauthor = "Acme" >>> user_data_dir(appname, appauthor) '/home/trentm/.local/share/SuperApp' >>> site_data_dir(appname, appauthor) '/usr/local/share/SuperApp' >>> site_data_dir(appname, appauthor, multipath=True) '/usr/local/share/SuperApp:/usr/share/SuperApp' >>> user_cache_dir(appname, appauthor) '/home/trentm/.cache/SuperApp' >>> user_log_dir(appname, appauthor) '/home/trentm/.local/state/SuperApp/log' >>> user_config_dir(appname) '/home/trentm/.config/SuperApp' >>> user_documents_dir() '/home/trentm/Documents' >>> user_downloads_dir() '/home/trentm/Downloads' >>> user_pictures_dir() '/home/trentm/Pictures' >>> user_videos_dir() '/home/trentm/Videos' >>> user_music_dir() '/home/trentm/Music' >>> user_desktop_dir() '/home/trentm/Desktop' >>> user_runtime_dir(appname, appauthor) '/run/user/{os.getuid()}/SuperApp' >>> site_config_dir(appname) '/etc/xdg/SuperApp' >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc" >>> site_config_dir(appname, multipath=True) '/etc/SuperApp:/usr/local/etc/SuperApp' On Android:: >>> from platformdirs import * >>> appname = "SuperApp" >>> appauthor = "Acme" >>> user_data_dir(appname, appauthor) '/data/data/com.myApp/files/SuperApp' >>> user_cache_dir(appname, appauthor) '/data/data/com.myApp/cache/SuperApp' >>> user_log_dir(appname, appauthor) '/data/data/com.myApp/cache/SuperApp/log' >>> user_config_dir(appname) '/data/data/com.myApp/shared_prefs/SuperApp' >>> user_documents_dir() '/storage/emulated/0/Documents' >>> user_downloads_dir() '/storage/emulated/0/Downloads' >>> user_pictures_dir() '/storage/emulated/0/Pictures' >>> user_videos_dir() '/storage/emulated/0/DCIM/Camera' >>> user_music_dir() '/storage/emulated/0/Music' >>> user_desktop_dir() '/storage/emulated/0/Desktop' >>> user_runtime_dir(appname, appauthor) '/data/data/com.myApp/cache/SuperApp/tmp' Note: Some android apps like Termux and Pydroid are used as shells. These apps are used by the end user to emulate Linux environment. Presence of ``SHELL`` environment variable is used by Platformdirs to differentiate between general android apps and android apps used as shells. Shell android apps also support ``XDG_*`` environment variables. ``PlatformDirs`` for convenience ================================ .. code-block:: pycon >>> from platformdirs import PlatformDirs >>> dirs = PlatformDirs("SuperApp", "Acme") >>> dirs.user_data_dir '/Users/trentm/Library/Application Support/SuperApp' >>> dirs.site_data_dir '/Library/Application Support/SuperApp' >>> dirs.user_cache_dir '/Users/trentm/Library/Caches/SuperApp' >>> dirs.user_log_dir '/Users/trentm/Library/Logs/SuperApp' >>> dirs.user_documents_dir '/Users/trentm/Documents' >>> dirs.user_downloads_dir '/Users/trentm/Downloads' >>> dirs.user_pictures_dir '/Users/trentm/Pictures' >>> dirs.user_videos_dir '/Users/trentm/Movies' >>> dirs.user_music_dir '/Users/trentm/Music' >>> dirs.user_desktop_dir '/Users/trentm/Desktop' >>> dirs.user_runtime_dir '/Users/trentm/Library/Caches/TemporaryItems/SuperApp' Per-version isolation ===================== If you have multiple versions of your app in use that you want to be able to run side-by-side, then you may want version-isolation for these dirs:: >>> from platformdirs import PlatformDirs >>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0") >>> dirs.user_data_dir '/Users/trentm/Library/Application Support/SuperApp/1.0' >>> dirs.site_data_dir '/Library/Application Support/SuperApp/1.0' >>> dirs.user_cache_dir '/Users/trentm/Library/Caches/SuperApp/1.0' >>> dirs.user_log_dir '/Users/trentm/Library/Logs/SuperApp/1.0' >>> dirs.user_documents_dir '/Users/trentm/Documents' >>> dirs.user_downloads_dir '/Users/trentm/Downloads' >>> dirs.user_pictures_dir '/Users/trentm/Pictures' >>> dirs.user_videos_dir '/Users/trentm/Movies' >>> dirs.user_music_dir '/Users/trentm/Music' >>> dirs.user_desktop_dir '/Users/trentm/Desktop' >>> dirs.user_runtime_dir '/Users/trentm/Library/Caches/TemporaryItems/SuperApp/1.0' Be wary of using this for configuration files though; you'll need to handle migrating configuration files manually. Why this Fork? ============== This repository is a friendly fork of the wonderful work started by `ActiveState <https://github.com/ActiveState/appdirs>`_ who created ``appdirs``, this package's ancestor. Maintaining an open source project is no easy task, particularly from within an organization, and the Python community is indebted to ``appdirs`` (and to Trent Mick and Jeff Rouse in particular) for creating an incredibly useful simple module, as evidenced by the wide number of users it has attracted over the years. Nonetheless, given the number of long-standing open issues and pull requests, and no clear path towards `ensuring that maintenance of the package would continue or grow <https://github.com/ActiveState/appdirs/issues/79>`_, this fork was created. Contributions are most welcome. _vendor/platformdirs-4.2.2.dist-info/INSTALLER 0000644 00000000004 15030122015 0014501 0 ustar 00 pip _vendor/platformdirs-4.2.2.dist-info/WHEEL 0000644 00000000127 15030122015 0014016 0 ustar 00 Wheel-Version: 1.0 Generator: hatchling 1.24.2 Root-Is-Purelib: true Tag: py3-none-any _vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE 0000644 00000002101 15030122015 0016033 0 ustar 00 MIT License Copyright (c) 2010-202x The platformdirs developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/platformdirs-4.2.2.dist-info/REQUESTED 0000644 00000000000 15030122015 0014501 0 ustar 00 _vendor/jaraco.collections-5.1.0.dist-info/RECORD 0000644 00000001551 15030122015 0015176 0 ustar 00 jaraco.collections-5.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 jaraco.collections-5.1.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 jaraco.collections-5.1.0.dist-info/METADATA,sha256=IMUaliNsA5X1Ox9MXUWOagch5R4Wwb_3M7erp29dBtg,3933 jaraco.collections-5.1.0.dist-info/RECORD,, jaraco.collections-5.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 jaraco.collections-5.1.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91 jaraco.collections-5.1.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 jaraco/collections/__init__.py,sha256=Pc1-SqjWm81ad1P0-GttpkwO_LWlnaY6gUq8gcKh2v0,26640 jaraco/collections/__pycache__/__init__.cpython-312.pyc,, jaraco/collections/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 _vendor/jaraco.collections-5.1.0.dist-info/METADATA 0000644 00000007535 15030122015 0015410 0 ustar 00 Metadata-Version: 2.1 Name: jaraco.collections Version: 5.1.0 Summary: Collection objects similar to those in stdlib by jaraco Author-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Source, https://github.com/jaraco/jaraco.collections Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: jaraco.text Provides-Extra: check Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'check' Requires-Dist: pytest-ruff >=0.2.1 ; (sys_platform != "cygwin") and extra == 'check' Provides-Extra: cover Requires-Dist: pytest-cov ; extra == 'cover' Provides-Extra: doc Requires-Dist: sphinx >=3.5 ; extra == 'doc' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' Requires-Dist: rst.linker >=1.9 ; extra == 'doc' Requires-Dist: furo ; extra == 'doc' Requires-Dist: sphinx-lint ; extra == 'doc' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' Provides-Extra: enabler Requires-Dist: pytest-enabler >=2.2 ; extra == 'enabler' Provides-Extra: test Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' Provides-Extra: type Requires-Dist: pytest-mypy ; extra == 'type' .. image:: https://img.shields.io/pypi/v/jaraco.collections.svg :target: https://pypi.org/project/jaraco.collections .. image:: https://img.shields.io/pypi/pyversions/jaraco.collections.svg .. image:: https://github.com/jaraco/jaraco.collections/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/jaraco.collections/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/jaracocollections/badge/?version=latest :target: https://jaracocollections.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/jaraco.collections :target: https://tidelift.com/subscription/pkg/pypi-jaraco.collections?utm_source=pypi-jaraco.collections&utm_medium=readme Models and classes to supplement the stdlib 'collections' module. See the docs, linked above, for descriptions and usage examples. Highlights include: - RangeMap: A mapping that accepts a range of values for keys. - Projection: A subset over an existing mapping. - KeyTransformingDict: Generalized mapping with keys transformed by a function. - FoldedCaseKeyedDict: A dict whose string keys are case-insensitive. - BijectiveMap: A map where keys map to values and values back to their keys. - ItemsAsAttributes: A mapping mix-in exposing items as attributes. - IdentityOverrideMap: A map whose keys map by default to themselves unless overridden. - FrozenDict: A hashable, immutable map. - Enumeration: An object whose keys are enumerated. - Everything: A container that contains all things. - Least, Greatest: Objects that are always less than or greater than any other. - pop_all: Return all items from the mutable sequence and remove them from that sequence. - DictStack: A stack of dicts, great for sharing scopes. - WeightedLookup: A specialized RangeMap for selecting an item by weights. For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-jaraco.collections?utm_source=pypi-jaraco.collections&utm_medium=referral&utm_campaign=github>`_. _vendor/jaraco.collections-5.1.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0015545 0 ustar 00 pip _vendor/jaraco.collections-5.1.0.dist-info/WHEEL 0000644 00000000133 15030122015 0015057 0 ustar 00 Wheel-Version: 1.0 Generator: setuptools (73.0.1) Root-Is-Purelib: true Tag: py3-none-any _vendor/jaraco.collections-5.1.0.dist-info/LICENSE 0000644 00000001777 15030122015 0015314 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/jaraco.collections-5.1.0.dist-info/top_level.txt 0000644 00000000007 15030122015 0017022 0 ustar 00 jaraco _vendor/jaraco.collections-5.1.0.dist-info/REQUESTED 0000644 00000000000 15030122015 0015545 0 ustar 00 _vendor/typing_extensions.py 0000644 00000406463 15030122015 0012345 0 ustar 00 import abc import collections import collections.abc import contextlib import functools import inspect import operator import sys import types as _types import typing import warnings __all__ = [ # Super-special typing primitives. 'Any', 'ClassVar', 'Concatenate', 'Final', 'LiteralString', 'ParamSpec', 'ParamSpecArgs', 'ParamSpecKwargs', 'Self', 'Type', 'TypeVar', 'TypeVarTuple', 'Unpack', # ABCs (from collections.abc). 'Awaitable', 'AsyncIterator', 'AsyncIterable', 'Coroutine', 'AsyncGenerator', 'AsyncContextManager', 'Buffer', 'ChainMap', # Concrete collection types. 'ContextManager', 'Counter', 'Deque', 'DefaultDict', 'NamedTuple', 'OrderedDict', 'TypedDict', # Structural checks, a.k.a. protocols. 'SupportsAbs', 'SupportsBytes', 'SupportsComplex', 'SupportsFloat', 'SupportsIndex', 'SupportsInt', 'SupportsRound', # One-off things. 'Annotated', 'assert_never', 'assert_type', 'clear_overloads', 'dataclass_transform', 'deprecated', 'Doc', 'get_overloads', 'final', 'get_args', 'get_origin', 'get_original_bases', 'get_protocol_members', 'get_type_hints', 'IntVar', 'is_protocol', 'is_typeddict', 'Literal', 'NewType', 'overload', 'override', 'Protocol', 'reveal_type', 'runtime', 'runtime_checkable', 'Text', 'TypeAlias', 'TypeAliasType', 'TypeGuard', 'TypeIs', 'TYPE_CHECKING', 'Never', 'NoReturn', 'ReadOnly', 'Required', 'NotRequired', # Pure aliases, have always been in typing 'AbstractSet', 'AnyStr', 'BinaryIO', 'Callable', 'Collection', 'Container', 'Dict', 'ForwardRef', 'FrozenSet', 'Generator', 'Generic', 'Hashable', 'IO', 'ItemsView', 'Iterable', 'Iterator', 'KeysView', 'List', 'Mapping', 'MappingView', 'Match', 'MutableMapping', 'MutableSequence', 'MutableSet', 'NoDefault', 'Optional', 'Pattern', 'Reversible', 'Sequence', 'Set', 'Sized', 'TextIO', 'Tuple', 'Union', 'ValuesView', 'cast', 'no_type_check', 'no_type_check_decorator', ] # for backward compatibility PEP_560 = True GenericMeta = type _PEP_696_IMPLEMENTED = sys.version_info >= (3, 13, 0, "beta") # The functions below are modified copies of typing internal helpers. # They are needed by _ProtocolMeta and they provide support for PEP 646. class _Sentinel: def __repr__(self): return "<sentinel>" _marker = _Sentinel() if sys.version_info >= (3, 10): def _should_collect_from_parameters(t): return isinstance( t, (typing._GenericAlias, _types.GenericAlias, _types.UnionType) ) elif sys.version_info >= (3, 9): def _should_collect_from_parameters(t): return isinstance(t, (typing._GenericAlias, _types.GenericAlias)) else: def _should_collect_from_parameters(t): return isinstance(t, typing._GenericAlias) and not t._special NoReturn = typing.NoReturn # Some unconstrained type variables. These are used by the container types. # (These are not for export.) T = typing.TypeVar('T') # Any type. KT = typing.TypeVar('KT') # Key type. VT = typing.TypeVar('VT') # Value type. T_co = typing.TypeVar('T_co', covariant=True) # Any type covariant containers. T_contra = typing.TypeVar('T_contra', contravariant=True) # Ditto contravariant. if sys.version_info >= (3, 11): from typing import Any else: class _AnyMeta(type): def __instancecheck__(self, obj): if self is Any: raise TypeError("typing_extensions.Any cannot be used with isinstance()") return super().__instancecheck__(obj) def __repr__(self): if self is Any: return "typing_extensions.Any" return super().__repr__() class Any(metaclass=_AnyMeta): """Special type indicating an unconstrained type. - Any is compatible with every type. - Any assumed to have all methods. - All values assumed to be instances of Any. Note that all the above statements are true from the point of view of static type checkers. At runtime, Any should not be used with instance checks. """ def __new__(cls, *args, **kwargs): if cls is Any: raise TypeError("Any cannot be instantiated") return super().__new__(cls, *args, **kwargs) ClassVar = typing.ClassVar class _ExtensionsSpecialForm(typing._SpecialForm, _root=True): def __repr__(self): return 'typing_extensions.' + self._name Final = typing.Final if sys.version_info >= (3, 11): final = typing.final else: # @final exists in 3.8+, but we backport it for all versions # before 3.11 to keep support for the __final__ attribute. # See https://bugs.python.org/issue46342 def final(f): """This decorator can be used to indicate to type checkers that the decorated method cannot be overridden, and decorated class cannot be subclassed. For example: class Base: @final def done(self) -> None: ... class Sub(Base): def done(self) -> None: # Error reported by type checker ... @final class Leaf: ... class Other(Leaf): # Error reported by type checker ... There is no runtime checking of these properties. The decorator sets the ``__final__`` attribute to ``True`` on the decorated object to allow runtime introspection. """ try: f.__final__ = True except (AttributeError, TypeError): # Skip the attribute silently if it is not writable. # AttributeError happens if the object has __slots__ or a # read-only property, TypeError if it's a builtin class. pass return f def IntVar(name): return typing.TypeVar(name) # A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8 if sys.version_info >= (3, 10, 1): Literal = typing.Literal else: def _flatten_literal_params(parameters): """An internal helper for Literal creation: flatten Literals among parameters""" params = [] for p in parameters: if isinstance(p, _LiteralGenericAlias): params.extend(p.__args__) else: params.append(p) return tuple(params) def _value_and_type_iter(params): for p in params: yield p, type(p) class _LiteralGenericAlias(typing._GenericAlias, _root=True): def __eq__(self, other): if not isinstance(other, _LiteralGenericAlias): return NotImplemented these_args_deduped = set(_value_and_type_iter(self.__args__)) other_args_deduped = set(_value_and_type_iter(other.__args__)) return these_args_deduped == other_args_deduped def __hash__(self): return hash(frozenset(_value_and_type_iter(self.__args__))) class _LiteralForm(_ExtensionsSpecialForm, _root=True): def __init__(self, doc: str): self._name = 'Literal' self._doc = self.__doc__ = doc def __getitem__(self, parameters): if not isinstance(parameters, tuple): parameters = (parameters,) parameters = _flatten_literal_params(parameters) val_type_pairs = list(_value_and_type_iter(parameters)) try: deduped_pairs = set(val_type_pairs) except TypeError: # unhashable parameters pass else: # similar logic to typing._deduplicate on Python 3.9+ if len(deduped_pairs) < len(val_type_pairs): new_parameters = [] for pair in val_type_pairs: if pair in deduped_pairs: new_parameters.append(pair[0]) deduped_pairs.remove(pair) assert not deduped_pairs, deduped_pairs parameters = tuple(new_parameters) return _LiteralGenericAlias(self, parameters) Literal = _LiteralForm(doc="""\ A type that can be used to indicate to type checkers that the corresponding value has a value literally equivalent to the provided parameter. For example: var: Literal[4] = 4 The type checker understands that 'var' is literally equal to the value 4 and no other value. Literal[...] cannot be subclassed. There is no runtime checking verifying that the parameter is actually a value instead of a type.""") _overload_dummy = typing._overload_dummy if hasattr(typing, "get_overloads"): # 3.11+ overload = typing.overload get_overloads = typing.get_overloads clear_overloads = typing.clear_overloads else: # {module: {qualname: {firstlineno: func}}} _overload_registry = collections.defaultdict( functools.partial(collections.defaultdict, dict) ) def overload(func): """Decorator for overloaded functions/methods. In a stub file, place two or more stub definitions for the same function in a row, each decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... In a non-stub file (i.e. a regular .py file), do the same but follow it with an implementation. The implementation should *not* be decorated with @overload. For example: @overload def utf8(value: None) -> None: ... @overload def utf8(value: bytes) -> bytes: ... @overload def utf8(value: str) -> bytes: ... def utf8(value): # implementation goes here The overloads for a function can be retrieved at runtime using the get_overloads() function. """ # classmethod and staticmethod f = getattr(func, "__func__", func) try: _overload_registry[f.__module__][f.__qualname__][ f.__code__.co_firstlineno ] = func except AttributeError: # Not a normal function; ignore. pass return _overload_dummy def get_overloads(func): """Return all defined overloads for *func* as a sequence.""" # classmethod and staticmethod f = getattr(func, "__func__", func) if f.__module__ not in _overload_registry: return [] mod_dict = _overload_registry[f.__module__] if f.__qualname__ not in mod_dict: return [] return list(mod_dict[f.__qualname__].values()) def clear_overloads(): """Clear all overloads in the registry.""" _overload_registry.clear() # This is not a real generic class. Don't use outside annotations. Type = typing.Type # Various ABCs mimicking those in collections.abc. # A few are simply re-exported for completeness. Awaitable = typing.Awaitable Coroutine = typing.Coroutine AsyncIterable = typing.AsyncIterable AsyncIterator = typing.AsyncIterator Deque = typing.Deque DefaultDict = typing.DefaultDict OrderedDict = typing.OrderedDict Counter = typing.Counter ChainMap = typing.ChainMap Text = typing.Text TYPE_CHECKING = typing.TYPE_CHECKING if sys.version_info >= (3, 13, 0, "beta"): from typing import AsyncContextManager, AsyncGenerator, ContextManager, Generator else: def _is_dunder(attr): return attr.startswith('__') and attr.endswith('__') # Python <3.9 doesn't have typing._SpecialGenericAlias _special_generic_alias_base = getattr( typing, "_SpecialGenericAlias", typing._GenericAlias ) class _SpecialGenericAlias(_special_generic_alias_base, _root=True): def __init__(self, origin, nparams, *, inst=True, name=None, defaults=()): if _special_generic_alias_base is typing._GenericAlias: # Python <3.9 self.__origin__ = origin self._nparams = nparams super().__init__(origin, nparams, special=True, inst=inst, name=name) else: # Python >= 3.9 super().__init__(origin, nparams, inst=inst, name=name) self._defaults = defaults def __setattr__(self, attr, val): allowed_attrs = {'_name', '_inst', '_nparams', '_defaults'} if _special_generic_alias_base is typing._GenericAlias: # Python <3.9 allowed_attrs.add("__origin__") if _is_dunder(attr) or attr in allowed_attrs: object.__setattr__(self, attr, val) else: setattr(self.__origin__, attr, val) @typing._tp_cache def __getitem__(self, params): if not isinstance(params, tuple): params = (params,) msg = "Parameters to generic types must be types." params = tuple(typing._type_check(p, msg) for p in params) if ( self._defaults and len(params) < self._nparams and len(params) + len(self._defaults) >= self._nparams ): params = (*params, *self._defaults[len(params) - self._nparams:]) actual_len = len(params) if actual_len != self._nparams: if self._defaults: expected = f"at least {self._nparams - len(self._defaults)}" else: expected = str(self._nparams) if not self._nparams: raise TypeError(f"{self} is not a generic class") raise TypeError( f"Too {'many' if actual_len > self._nparams else 'few'}" f" arguments for {self};" f" actual {actual_len}, expected {expected}" ) return self.copy_with(params) _NoneType = type(None) Generator = _SpecialGenericAlias( collections.abc.Generator, 3, defaults=(_NoneType, _NoneType) ) AsyncGenerator = _SpecialGenericAlias( collections.abc.AsyncGenerator, 2, defaults=(_NoneType,) ) ContextManager = _SpecialGenericAlias( contextlib.AbstractContextManager, 2, name="ContextManager", defaults=(typing.Optional[bool],) ) AsyncContextManager = _SpecialGenericAlias( contextlib.AbstractAsyncContextManager, 2, name="AsyncContextManager", defaults=(typing.Optional[bool],) ) _PROTO_ALLOWLIST = { 'collections.abc': [ 'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable', 'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer', ], 'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'], 'typing_extensions': ['Buffer'], } _EXCLUDED_ATTRS = frozenset(typing.EXCLUDED_ATTRIBUTES) | { "__match_args__", "__protocol_attrs__", "__non_callable_proto_members__", "__final__", } def _get_protocol_attrs(cls): attrs = set() for base in cls.__mro__[:-1]: # without object if base.__name__ in {'Protocol', 'Generic'}: continue annotations = getattr(base, '__annotations__', {}) for attr in (*base.__dict__, *annotations): if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS): attrs.add(attr) return attrs def _caller(depth=2): try: return sys._getframe(depth).f_globals.get('__name__', '__main__') except (AttributeError, ValueError): # For platforms without _getframe() return None # `__match_args__` attribute was removed from protocol members in 3.13, # we want to backport this change to older Python versions. if sys.version_info >= (3, 13): Protocol = typing.Protocol else: def _allow_reckless_class_checks(depth=3): """Allow instance and class checks for special stdlib modules. The abc and functools modules indiscriminately call isinstance() and issubclass() on the whole MRO of a user class, which may contain protocols. """ return _caller(depth) in {'abc', 'functools', None} def _no_init(self, *args, **kwargs): if type(self)._is_protocol: raise TypeError('Protocols cannot be instantiated') def _type_check_issubclass_arg_1(arg): """Raise TypeError if `arg` is not an instance of `type` in `issubclass(arg, <protocol>)`. In most cases, this is verified by type.__subclasscheck__. Checking it again unnecessarily would slow down issubclass() checks, so, we don't perform this check unless we absolutely have to. For various error paths, however, we want to ensure that *this* error message is shown to the user where relevant, rather than a typing.py-specific error message. """ if not isinstance(arg, type): # Same error message as for issubclass(1, int). raise TypeError('issubclass() arg 1 must be a class') # Inheriting from typing._ProtocolMeta isn't actually desirable, # but is necessary to allow typing.Protocol and typing_extensions.Protocol # to mix without getting TypeErrors about "metaclass conflict" class _ProtocolMeta(type(typing.Protocol)): # This metaclass is somewhat unfortunate, # but is necessary for several reasons... # # NOTE: DO NOT call super() in any methods in this class # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11 # and those are slow def __new__(mcls, name, bases, namespace, **kwargs): if name == "Protocol" and len(bases) < 2: pass elif {Protocol, typing.Protocol} & set(bases): for base in bases: if not ( base in {object, typing.Generic, Protocol, typing.Protocol} or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, []) or is_protocol(base) ): raise TypeError( f"Protocols can only inherit from other protocols, " f"got {base!r}" ) return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs) def __init__(cls, *args, **kwargs): abc.ABCMeta.__init__(cls, *args, **kwargs) if getattr(cls, "_is_protocol", False): cls.__protocol_attrs__ = _get_protocol_attrs(cls) def __subclasscheck__(cls, other): if cls is Protocol: return type.__subclasscheck__(cls, other) if ( getattr(cls, '_is_protocol', False) and not _allow_reckless_class_checks() ): if not getattr(cls, '_is_runtime_protocol', False): _type_check_issubclass_arg_1(other) raise TypeError( "Instance and class checks can only be used with " "@runtime_checkable protocols" ) if ( # this attribute is set by @runtime_checkable: cls.__non_callable_proto_members__ and cls.__dict__.get("__subclasshook__") is _proto_hook ): _type_check_issubclass_arg_1(other) non_method_attrs = sorted(cls.__non_callable_proto_members__) raise TypeError( "Protocols with non-method members don't support issubclass()." f" Non-method members: {str(non_method_attrs)[1:-1]}." ) return abc.ABCMeta.__subclasscheck__(cls, other) def __instancecheck__(cls, instance): # We need this method for situations where attributes are # assigned in __init__. if cls is Protocol: return type.__instancecheck__(cls, instance) if not getattr(cls, "_is_protocol", False): # i.e., it's a concrete subclass of a protocol return abc.ABCMeta.__instancecheck__(cls, instance) if ( not getattr(cls, '_is_runtime_protocol', False) and not _allow_reckless_class_checks() ): raise TypeError("Instance and class checks can only be used with" " @runtime_checkable protocols") if abc.ABCMeta.__instancecheck__(cls, instance): return True for attr in cls.__protocol_attrs__: try: val = inspect.getattr_static(instance, attr) except AttributeError: break # this attribute is set by @runtime_checkable: if val is None and attr not in cls.__non_callable_proto_members__: break else: return True return False def __eq__(cls, other): # Hack so that typing.Generic.__class_getitem__ # treats typing_extensions.Protocol # as equivalent to typing.Protocol if abc.ABCMeta.__eq__(cls, other) is True: return True return cls is Protocol and other is typing.Protocol # This has to be defined, or the abc-module cache # complains about classes with this metaclass being unhashable, # if we define only __eq__! def __hash__(cls) -> int: return type.__hash__(cls) @classmethod def _proto_hook(cls, other): if not cls.__dict__.get('_is_protocol', False): return NotImplemented for attr in cls.__protocol_attrs__: for base in other.__mro__: # Check if the members appears in the class dictionary... if attr in base.__dict__: if base.__dict__[attr] is None: return NotImplemented break # ...or in annotations, if it is a sub-protocol. annotations = getattr(base, '__annotations__', {}) if ( isinstance(annotations, collections.abc.Mapping) and attr in annotations and is_protocol(other) ): break else: return NotImplemented return True class Protocol(typing.Generic, metaclass=_ProtocolMeta): __doc__ = typing.Protocol.__doc__ __slots__ = () _is_protocol = True _is_runtime_protocol = False def __init_subclass__(cls, *args, **kwargs): super().__init_subclass__(*args, **kwargs) # Determine if this is a protocol or a concrete subclass. if not cls.__dict__.get('_is_protocol', False): cls._is_protocol = any(b is Protocol for b in cls.__bases__) # Set (or override) the protocol subclass hook. if '__subclasshook__' not in cls.__dict__: cls.__subclasshook__ = _proto_hook # Prohibit instantiation for protocol classes if cls._is_protocol and cls.__init__ is Protocol.__init__: cls.__init__ = _no_init if sys.version_info >= (3, 13): runtime_checkable = typing.runtime_checkable else: def runtime_checkable(cls): """Mark a protocol class as a runtime protocol. Such protocol can be used with isinstance() and issubclass(). Raise TypeError if applied to a non-protocol class. This allows a simple-minded structural check very similar to one trick ponies in collections.abc such as Iterable. For example:: @runtime_checkable class Closable(Protocol): def close(self): ... assert isinstance(open('/some/file'), Closable) Warning: this will check only the presence of the required methods, not their type signatures! """ if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False): raise TypeError(f'@runtime_checkable can be only applied to protocol classes,' f' got {cls!r}') cls._is_runtime_protocol = True # typing.Protocol classes on <=3.11 break if we execute this block, # because typing.Protocol classes on <=3.11 don't have a # `__protocol_attrs__` attribute, and this block relies on the # `__protocol_attrs__` attribute. Meanwhile, typing.Protocol classes on 3.12.2+ # break if we *don't* execute this block, because *they* assume that all # protocol classes have a `__non_callable_proto_members__` attribute # (which this block sets) if isinstance(cls, _ProtocolMeta) or sys.version_info >= (3, 12, 2): # PEP 544 prohibits using issubclass() # with protocols that have non-method members. # See gh-113320 for why we compute this attribute here, # rather than in `_ProtocolMeta.__init__` cls.__non_callable_proto_members__ = set() for attr in cls.__protocol_attrs__: try: is_callable = callable(getattr(cls, attr, None)) except Exception as e: raise TypeError( f"Failed to determine whether protocol member {attr!r} " "is a method member" ) from e else: if not is_callable: cls.__non_callable_proto_members__.add(attr) return cls # The "runtime" alias exists for backwards compatibility. runtime = runtime_checkable # Our version of runtime-checkable protocols is faster on Python 3.8-3.11 if sys.version_info >= (3, 12): SupportsInt = typing.SupportsInt SupportsFloat = typing.SupportsFloat SupportsComplex = typing.SupportsComplex SupportsBytes = typing.SupportsBytes SupportsIndex = typing.SupportsIndex SupportsAbs = typing.SupportsAbs SupportsRound = typing.SupportsRound else: @runtime_checkable class SupportsInt(Protocol): """An ABC with one abstract method __int__.""" __slots__ = () @abc.abstractmethod def __int__(self) -> int: pass @runtime_checkable class SupportsFloat(Protocol): """An ABC with one abstract method __float__.""" __slots__ = () @abc.abstractmethod def __float__(self) -> float: pass @runtime_checkable class SupportsComplex(Protocol): """An ABC with one abstract method __complex__.""" __slots__ = () @abc.abstractmethod def __complex__(self) -> complex: pass @runtime_checkable class SupportsBytes(Protocol): """An ABC with one abstract method __bytes__.""" __slots__ = () @abc.abstractmethod def __bytes__(self) -> bytes: pass @runtime_checkable class SupportsIndex(Protocol): __slots__ = () @abc.abstractmethod def __index__(self) -> int: pass @runtime_checkable class SupportsAbs(Protocol[T_co]): """ An ABC with one abstract method __abs__ that is covariant in its return type. """ __slots__ = () @abc.abstractmethod def __abs__(self) -> T_co: pass @runtime_checkable class SupportsRound(Protocol[T_co]): """ An ABC with one abstract method __round__ that is covariant in its return type. """ __slots__ = () @abc.abstractmethod def __round__(self, ndigits: int = 0) -> T_co: pass def _ensure_subclassable(mro_entries): def inner(func): if sys.implementation.name == "pypy" and sys.version_info < (3, 9): cls_dict = { "__call__": staticmethod(func), "__mro_entries__": staticmethod(mro_entries) } t = type(func.__name__, (), cls_dict) return functools.update_wrapper(t(), func) else: func.__mro_entries__ = mro_entries return func return inner # Update this to something like >=3.13.0b1 if and when # PEP 728 is implemented in CPython _PEP_728_IMPLEMENTED = False if _PEP_728_IMPLEMENTED: # The standard library TypedDict in Python 3.8 does not store runtime information # about which (if any) keys are optional. See https://bugs.python.org/issue38834 # The standard library TypedDict in Python 3.9.0/1 does not honour the "total" # keyword with old-style TypedDict(). See https://bugs.python.org/issue42059 # The standard library TypedDict below Python 3.11 does not store runtime # information about optional and required keys when using Required or NotRequired. # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11. # Aaaand on 3.12 we add __orig_bases__ to TypedDict # to enable better runtime introspection. # On 3.13 we deprecate some odd ways of creating TypedDicts. # Also on 3.13, PEP 705 adds the ReadOnly[] qualifier. # PEP 728 (still pending) makes more changes. TypedDict = typing.TypedDict _TypedDictMeta = typing._TypedDictMeta is_typeddict = typing.is_typeddict else: # 3.10.0 and later _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters def _get_typeddict_qualifiers(annotation_type): while True: annotation_origin = get_origin(annotation_type) if annotation_origin is Annotated: annotation_args = get_args(annotation_type) if annotation_args: annotation_type = annotation_args[0] else: break elif annotation_origin is Required: yield Required annotation_type, = get_args(annotation_type) elif annotation_origin is NotRequired: yield NotRequired annotation_type, = get_args(annotation_type) elif annotation_origin is ReadOnly: yield ReadOnly annotation_type, = get_args(annotation_type) else: break class _TypedDictMeta(type): def __new__(cls, name, bases, ns, *, total=True, closed=False): """Create new typed dict class object. This method is called when TypedDict is subclassed, or when TypedDict is instantiated. This way TypedDict supports all three syntax forms described in its docstring. Subclasses and instances of TypedDict return actual dictionaries. """ for base in bases: if type(base) is not _TypedDictMeta and base is not typing.Generic: raise TypeError('cannot inherit from both a TypedDict type ' 'and a non-TypedDict base class') if any(issubclass(b, typing.Generic) for b in bases): generic_base = (typing.Generic,) else: generic_base = () # typing.py generally doesn't let you inherit from plain Generic, unless # the name of the class happens to be "Protocol" tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns) tp_dict.__name__ = name if tp_dict.__qualname__ == "Protocol": tp_dict.__qualname__ = name if not hasattr(tp_dict, '__orig_bases__'): tp_dict.__orig_bases__ = bases annotations = {} if "__annotations__" in ns: own_annotations = ns["__annotations__"] elif "__annotate__" in ns: # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated own_annotations = ns["__annotate__"](1) else: own_annotations = {} msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type" if _TAKES_MODULE: own_annotations = { n: typing._type_check(tp, msg, module=tp_dict.__module__) for n, tp in own_annotations.items() } else: own_annotations = { n: typing._type_check(tp, msg) for n, tp in own_annotations.items() } required_keys = set() optional_keys = set() readonly_keys = set() mutable_keys = set() extra_items_type = None for base in bases: base_dict = base.__dict__ annotations.update(base_dict.get('__annotations__', {})) required_keys.update(base_dict.get('__required_keys__', ())) optional_keys.update(base_dict.get('__optional_keys__', ())) readonly_keys.update(base_dict.get('__readonly_keys__', ())) mutable_keys.update(base_dict.get('__mutable_keys__', ())) base_extra_items_type = base_dict.get('__extra_items__', None) if base_extra_items_type is not None: extra_items_type = base_extra_items_type if closed and extra_items_type is None: extra_items_type = Never if closed and "__extra_items__" in own_annotations: annotation_type = own_annotations.pop("__extra_items__") qualifiers = set(_get_typeddict_qualifiers(annotation_type)) if Required in qualifiers: raise TypeError( "Special key __extra_items__ does not support " "Required" ) if NotRequired in qualifiers: raise TypeError( "Special key __extra_items__ does not support " "NotRequired" ) extra_items_type = annotation_type annotations.update(own_annotations) for annotation_key, annotation_type in own_annotations.items(): qualifiers = set(_get_typeddict_qualifiers(annotation_type)) if Required in qualifiers: required_keys.add(annotation_key) elif NotRequired in qualifiers: optional_keys.add(annotation_key) elif total: required_keys.add(annotation_key) else: optional_keys.add(annotation_key) if ReadOnly in qualifiers: mutable_keys.discard(annotation_key) readonly_keys.add(annotation_key) else: mutable_keys.add(annotation_key) readonly_keys.discard(annotation_key) tp_dict.__annotations__ = annotations tp_dict.__required_keys__ = frozenset(required_keys) tp_dict.__optional_keys__ = frozenset(optional_keys) tp_dict.__readonly_keys__ = frozenset(readonly_keys) tp_dict.__mutable_keys__ = frozenset(mutable_keys) if not hasattr(tp_dict, '__total__'): tp_dict.__total__ = total tp_dict.__closed__ = closed tp_dict.__extra_items__ = extra_items_type return tp_dict __call__ = dict # static method def __subclasscheck__(cls, other): # Typed dicts are only for static structural subtyping. raise TypeError('TypedDict does not support instance and class checks') __instancecheck__ = __subclasscheck__ _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {}) @_ensure_subclassable(lambda bases: (_TypedDict,)) def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs): """A simple typed namespace. At runtime it is equivalent to a plain dict. TypedDict creates a dictionary type such that a type checker will expect all instances to have a certain set of keys, where each key is associated with a value of a consistent type. This expectation is not checked at runtime. Usage:: class Point2D(TypedDict): x: int y: int label: str a: Point2D = {'x': 1, 'y': 2, 'label': 'good'} # OK b: Point2D = {'z': 3, 'label': 'bad'} # Fails type check assert Point2D(x=1, y=2, label='first') == dict(x=1, y=2, label='first') The type info can be accessed via the Point2D.__annotations__ dict, and the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets. TypedDict supports an additional equivalent form:: Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str}) By default, all keys must be present in a TypedDict. It is possible to override this by specifying totality:: class Point2D(TypedDict, total=False): x: int y: int This means that a Point2D TypedDict can have any of the keys omitted. A type checker is only expected to support a literal False or True as the value of the total argument. True is the default, and makes all items defined in the class body be required. The Required and NotRequired special forms can also be used to mark individual keys as being required or not required:: class Point2D(TypedDict): x: int # the "x" key must always be present (Required is the default) y: NotRequired[int] # the "y" key can be omitted See PEP 655 for more details on Required and NotRequired. """ if fields is _marker or fields is None: if fields is _marker: deprecated_thing = "Failing to pass a value for the 'fields' parameter" else: deprecated_thing = "Passing `None` as the 'fields' parameter" example = f"`{typename} = TypedDict({typename!r}, {{}})`" deprecation_msg = ( f"{deprecated_thing} is deprecated and will be disallowed in " "Python 3.15. To create a TypedDict class with 0 fields " "using the functional syntax, pass an empty dictionary, e.g. " ) + example + "." warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2) if closed is not False and closed is not True: kwargs["closed"] = closed closed = False fields = kwargs elif kwargs: raise TypeError("TypedDict takes either a dict or keyword arguments," " but not both") if kwargs: if sys.version_info >= (3, 13): raise TypeError("TypedDict takes no keyword arguments") warnings.warn( "The kwargs-based syntax for TypedDict definitions is deprecated " "in Python 3.11, will be removed in Python 3.13, and may not be " "understood by third-party type checkers.", DeprecationWarning, stacklevel=2, ) ns = {'__annotations__': dict(fields)} module = _caller() if module is not None: # Setting correct module is necessary to make typed dict classes pickleable. ns['__module__'] = module td = _TypedDictMeta(typename, (), ns, total=total, closed=closed) td.__orig_bases__ = (TypedDict,) return td if hasattr(typing, "_TypedDictMeta"): _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta) else: _TYPEDDICT_TYPES = (_TypedDictMeta,) def is_typeddict(tp): """Check if an annotation is a TypedDict class For example:: class Film(TypedDict): title: str year: int is_typeddict(Film) # => True is_typeddict(Union[list, str]) # => False """ # On 3.8, this would otherwise return True if hasattr(typing, "TypedDict") and tp is typing.TypedDict: return False return isinstance(tp, _TYPEDDICT_TYPES) if hasattr(typing, "assert_type"): assert_type = typing.assert_type else: def assert_type(val, typ, /): """Assert (to the type checker) that the value is of the given type. When the type checker encounters a call to assert_type(), it emits an error if the value is not of the specified type:: def greet(name: str) -> None: assert_type(name, str) # ok assert_type(name, int) # type checker error At runtime this returns the first argument unchanged and otherwise does nothing. """ return val if hasattr(typing, "ReadOnly"): # 3.13+ get_type_hints = typing.get_type_hints else: # <=3.13 # replaces _strip_annotations() def _strip_extras(t): """Strips Annotated, Required and NotRequired from a given type.""" if isinstance(t, _AnnotatedAlias): return _strip_extras(t.__origin__) if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired, ReadOnly): return _strip_extras(t.__args__[0]) if isinstance(t, typing._GenericAlias): stripped_args = tuple(_strip_extras(a) for a in t.__args__) if stripped_args == t.__args__: return t return t.copy_with(stripped_args) if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias): stripped_args = tuple(_strip_extras(a) for a in t.__args__) if stripped_args == t.__args__: return t return _types.GenericAlias(t.__origin__, stripped_args) if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType): stripped_args = tuple(_strip_extras(a) for a in t.__args__) if stripped_args == t.__args__: return t return functools.reduce(operator.or_, stripped_args) return t def get_type_hints(obj, globalns=None, localns=None, include_extras=False): """Return type hints for an object. This is often the same as obj.__annotations__, but it handles forward references encoded as string literals, adds Optional[t] if a default value equal to None is set and recursively replaces all 'Annotated[T, ...]', 'Required[T]' or 'NotRequired[T]' with 'T' (unless 'include_extras=True'). The argument may be a module, class, method, or function. The annotations are returned as a dictionary. For classes, annotations include also inherited members. TypeError is raised if the argument is not of a type that can contain annotations, and an empty dictionary is returned if no annotations are present. BEWARE -- the behavior of globalns and localns is counterintuitive (unless you are familiar with how eval() and exec() work). The search order is locals first, then globals. - If no dict arguments are passed, an attempt is made to use the globals from obj (or the respective module's globals for classes), and these are also used as the locals. If the object does not appear to have globals, an empty dictionary is used. - If one dict argument is passed, it is used for both globals and locals. - If two dict arguments are passed, they specify globals and locals, respectively. """ if hasattr(typing, "Annotated"): # 3.9+ hint = typing.get_type_hints( obj, globalns=globalns, localns=localns, include_extras=True ) else: # 3.8 hint = typing.get_type_hints(obj, globalns=globalns, localns=localns) if include_extras: return hint return {k: _strip_extras(t) for k, t in hint.items()} # Python 3.9+ has PEP 593 (Annotated) if hasattr(typing, 'Annotated'): Annotated = typing.Annotated # Not exported and not a public API, but needed for get_origin() and get_args() # to work. _AnnotatedAlias = typing._AnnotatedAlias # 3.8 else: class _AnnotatedAlias(typing._GenericAlias, _root=True): """Runtime representation of an annotated type. At its core 'Annotated[t, dec1, dec2, ...]' is an alias for the type 't' with extra annotations. The alias behaves like a normal typing alias, instantiating is the same as instantiating the underlying type, binding it to types is also the same. """ def __init__(self, origin, metadata): if isinstance(origin, _AnnotatedAlias): metadata = origin.__metadata__ + metadata origin = origin.__origin__ super().__init__(origin, origin) self.__metadata__ = metadata def copy_with(self, params): assert len(params) == 1 new_type = params[0] return _AnnotatedAlias(new_type, self.__metadata__) def __repr__(self): return (f"typing_extensions.Annotated[{typing._type_repr(self.__origin__)}, " f"{', '.join(repr(a) for a in self.__metadata__)}]") def __reduce__(self): return operator.getitem, ( Annotated, (self.__origin__, *self.__metadata__) ) def __eq__(self, other): if not isinstance(other, _AnnotatedAlias): return NotImplemented if self.__origin__ != other.__origin__: return False return self.__metadata__ == other.__metadata__ def __hash__(self): return hash((self.__origin__, self.__metadata__)) class Annotated: """Add context specific metadata to a type. Example: Annotated[int, runtime_check.Unsigned] indicates to the hypothetical runtime_check module that this type is an unsigned int. Every other consumer of this type can ignore this metadata and treat this type as int. The first argument to Annotated must be a valid type (and will be in the __origin__ field), the remaining arguments are kept as a tuple in the __extra__ field. Details: - It's an error to call `Annotated` with less than two arguments. - Nested Annotated are flattened:: Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3] - Instantiating an annotated type is equivalent to instantiating the underlying type:: Annotated[C, Ann1](5) == C(5) - Annotated can be used as a generic type alias:: Optimized = Annotated[T, runtime.Optimize()] Optimized[int] == Annotated[int, runtime.Optimize()] OptimizedList = Annotated[List[T], runtime.Optimize()] OptimizedList[int] == Annotated[List[int], runtime.Optimize()] """ __slots__ = () def __new__(cls, *args, **kwargs): raise TypeError("Type Annotated cannot be instantiated.") @typing._tp_cache def __class_getitem__(cls, params): if not isinstance(params, tuple) or len(params) < 2: raise TypeError("Annotated[...] should be used " "with at least two arguments (a type and an " "annotation).") allowed_special_forms = (ClassVar, Final) if get_origin(params[0]) in allowed_special_forms: origin = params[0] else: msg = "Annotated[t, ...]: t must be a type." origin = typing._type_check(params[0], msg) metadata = tuple(params[1:]) return _AnnotatedAlias(origin, metadata) def __init_subclass__(cls, *args, **kwargs): raise TypeError( f"Cannot subclass {cls.__module__}.Annotated" ) # Python 3.8 has get_origin() and get_args() but those implementations aren't # Annotated-aware, so we can't use those. Python 3.9's versions don't support # ParamSpecArgs and ParamSpecKwargs, so only Python 3.10's versions will do. if sys.version_info[:2] >= (3, 10): get_origin = typing.get_origin get_args = typing.get_args # 3.8-3.9 else: try: # 3.9+ from typing import _BaseGenericAlias except ImportError: _BaseGenericAlias = typing._GenericAlias try: # 3.9+ from typing import GenericAlias as _typing_GenericAlias except ImportError: _typing_GenericAlias = typing._GenericAlias def get_origin(tp): """Get the unsubscripted version of a type. This supports generic types, Callable, Tuple, Union, Literal, Final, ClassVar and Annotated. Return None for unsupported types. Examples:: get_origin(Literal[42]) is Literal get_origin(int) is None get_origin(ClassVar[int]) is ClassVar get_origin(Generic) is Generic get_origin(Generic[T]) is Generic get_origin(Union[T, int]) is Union get_origin(List[Tuple[T, T]][int]) == list get_origin(P.args) is P """ if isinstance(tp, _AnnotatedAlias): return Annotated if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias, _BaseGenericAlias, ParamSpecArgs, ParamSpecKwargs)): return tp.__origin__ if tp is typing.Generic: return typing.Generic return None def get_args(tp): """Get type arguments with all substitutions performed. For unions, basic simplifications used by Union constructor are performed. Examples:: get_args(Dict[str, int]) == (str, int) get_args(int) == () get_args(Union[int, Union[T, int], str][int]) == (int, str) get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int]) get_args(Callable[[], T][int]) == ([], int) """ if isinstance(tp, _AnnotatedAlias): return (tp.__origin__, *tp.__metadata__) if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)): if getattr(tp, "_special", False): return () res = tp.__args__ if get_origin(tp) is collections.abc.Callable and res[0] is not Ellipsis: res = (list(res[:-1]), res[-1]) return res return () # 3.10+ if hasattr(typing, 'TypeAlias'): TypeAlias = typing.TypeAlias # 3.9 elif sys.version_info[:2] >= (3, 9): @_ExtensionsSpecialForm def TypeAlias(self, parameters): """Special marker indicating that an assignment should be recognized as a proper type alias definition by type checkers. For example:: Predicate: TypeAlias = Callable[..., bool] It's invalid when used anywhere except as in the example above. """ raise TypeError(f"{self} is not subscriptable") # 3.8 else: TypeAlias = _ExtensionsSpecialForm( 'TypeAlias', doc="""Special marker indicating that an assignment should be recognized as a proper type alias definition by type checkers. For example:: Predicate: TypeAlias = Callable[..., bool] It's invalid when used anywhere except as in the example above.""" ) if hasattr(typing, "NoDefault"): NoDefault = typing.NoDefault else: class NoDefaultTypeMeta(type): def __setattr__(cls, attr, value): # TypeError is consistent with the behavior of NoneType raise TypeError( f"cannot set {attr!r} attribute of immutable type {cls.__name__!r}" ) class NoDefaultType(metaclass=NoDefaultTypeMeta): """The type of the NoDefault singleton.""" __slots__ = () def __new__(cls): return globals().get("NoDefault") or object.__new__(cls) def __repr__(self): return "typing_extensions.NoDefault" def __reduce__(self): return "NoDefault" NoDefault = NoDefaultType() del NoDefaultType, NoDefaultTypeMeta def _set_default(type_param, default): type_param.has_default = lambda: default is not NoDefault type_param.__default__ = default def _set_module(typevarlike): # for pickling: def_mod = _caller(depth=3) if def_mod != 'typing_extensions': typevarlike.__module__ = def_mod class _DefaultMixin: """Mixin for TypeVarLike defaults.""" __slots__ = () __init__ = _set_default # Classes using this metaclass must provide a _backported_typevarlike ClassVar class _TypeVarLikeMeta(type): def __instancecheck__(cls, __instance: Any) -> bool: return isinstance(__instance, cls._backported_typevarlike) if _PEP_696_IMPLEMENTED: from typing import TypeVar else: # Add default and infer_variance parameters from PEP 696 and 695 class TypeVar(metaclass=_TypeVarLikeMeta): """Type variable.""" _backported_typevarlike = typing.TypeVar def __new__(cls, name, *constraints, bound=None, covariant=False, contravariant=False, default=NoDefault, infer_variance=False): if hasattr(typing, "TypeAliasType"): # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar typevar = typing.TypeVar(name, *constraints, bound=bound, covariant=covariant, contravariant=contravariant, infer_variance=infer_variance) else: typevar = typing.TypeVar(name, *constraints, bound=bound, covariant=covariant, contravariant=contravariant) if infer_variance and (covariant or contravariant): raise ValueError("Variance cannot be specified with infer_variance.") typevar.__infer_variance__ = infer_variance _set_default(typevar, default) _set_module(typevar) def _tvar_prepare_subst(alias, args): if ( typevar.has_default() and alias.__parameters__.index(typevar) == len(args) ): args += (typevar.__default__,) return args typevar.__typing_prepare_subst__ = _tvar_prepare_subst return typevar def __init_subclass__(cls) -> None: raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type") # Python 3.10+ has PEP 612 if hasattr(typing, 'ParamSpecArgs'): ParamSpecArgs = typing.ParamSpecArgs ParamSpecKwargs = typing.ParamSpecKwargs # 3.8-3.9 else: class _Immutable: """Mixin to indicate that object should not be copied.""" __slots__ = () def __copy__(self): return self def __deepcopy__(self, memo): return self class ParamSpecArgs(_Immutable): """The args for a ParamSpec object. Given a ParamSpec object P, P.args is an instance of ParamSpecArgs. ParamSpecArgs objects have a reference back to their ParamSpec: P.args.__origin__ is P This type is meant for runtime introspection and has no special meaning to static type checkers. """ def __init__(self, origin): self.__origin__ = origin def __repr__(self): return f"{self.__origin__.__name__}.args" def __eq__(self, other): if not isinstance(other, ParamSpecArgs): return NotImplemented return self.__origin__ == other.__origin__ class ParamSpecKwargs(_Immutable): """The kwargs for a ParamSpec object. Given a ParamSpec object P, P.kwargs is an instance of ParamSpecKwargs. ParamSpecKwargs objects have a reference back to their ParamSpec: P.kwargs.__origin__ is P This type is meant for runtime introspection and has no special meaning to static type checkers. """ def __init__(self, origin): self.__origin__ = origin def __repr__(self): return f"{self.__origin__.__name__}.kwargs" def __eq__(self, other): if not isinstance(other, ParamSpecKwargs): return NotImplemented return self.__origin__ == other.__origin__ if _PEP_696_IMPLEMENTED: from typing import ParamSpec # 3.10+ elif hasattr(typing, 'ParamSpec'): # Add default parameter - PEP 696 class ParamSpec(metaclass=_TypeVarLikeMeta): """Parameter specification.""" _backported_typevarlike = typing.ParamSpec def __new__(cls, name, *, bound=None, covariant=False, contravariant=False, infer_variance=False, default=NoDefault): if hasattr(typing, "TypeAliasType"): # PEP 695 implemented, can pass infer_variance to typing.TypeVar paramspec = typing.ParamSpec(name, bound=bound, covariant=covariant, contravariant=contravariant, infer_variance=infer_variance) else: paramspec = typing.ParamSpec(name, bound=bound, covariant=covariant, contravariant=contravariant) paramspec.__infer_variance__ = infer_variance _set_default(paramspec, default) _set_module(paramspec) def _paramspec_prepare_subst(alias, args): params = alias.__parameters__ i = params.index(paramspec) if i == len(args) and paramspec.has_default(): args = [*args, paramspec.__default__] if i >= len(args): raise TypeError(f"Too few arguments for {alias}") # Special case where Z[[int, str, bool]] == Z[int, str, bool] in PEP 612. if len(params) == 1 and not typing._is_param_expr(args[0]): assert i == 0 args = (args,) # Convert lists to tuples to help other libraries cache the results. elif isinstance(args[i], list): args = (*args[:i], tuple(args[i]), *args[i + 1:]) return args paramspec.__typing_prepare_subst__ = _paramspec_prepare_subst return paramspec def __init_subclass__(cls) -> None: raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type") # 3.8-3.9 else: # Inherits from list as a workaround for Callable checks in Python < 3.9.2. class ParamSpec(list, _DefaultMixin): """Parameter specification variable. Usage:: P = ParamSpec('P') Parameter specification variables exist primarily for the benefit of static type checkers. They are used to forward the parameter types of one callable to another callable, a pattern commonly found in higher order functions and decorators. They are only valid when used in ``Concatenate``, or s the first argument to ``Callable``. In Python 3.10 and higher, they are also supported in user-defined Generics at runtime. See class Generic for more information on generic types. An example for annotating a decorator:: T = TypeVar('T') P = ParamSpec('P') def add_logging(f: Callable[P, T]) -> Callable[P, T]: '''A type-safe decorator to add logging to a function.''' def inner(*args: P.args, **kwargs: P.kwargs) -> T: logging.info(f'{f.__name__} was called') return f(*args, **kwargs) return inner @add_logging def add_two(x: float, y: float) -> float: '''Add two numbers together.''' return x + y Parameter specification variables defined with covariant=True or contravariant=True can be used to declare covariant or contravariant generic types. These keyword arguments are valid, but their actual semantics are yet to be decided. See PEP 612 for details. Parameter specification variables can be introspected. e.g.: P.__name__ == 'T' P.__bound__ == None P.__covariant__ == False P.__contravariant__ == False Note that only parameter specification variables defined in global scope can be pickled. """ # Trick Generic __parameters__. __class__ = typing.TypeVar @property def args(self): return ParamSpecArgs(self) @property def kwargs(self): return ParamSpecKwargs(self) def __init__(self, name, *, bound=None, covariant=False, contravariant=False, infer_variance=False, default=NoDefault): list.__init__(self, [self]) self.__name__ = name self.__covariant__ = bool(covariant) self.__contravariant__ = bool(contravariant) self.__infer_variance__ = bool(infer_variance) if bound: self.__bound__ = typing._type_check(bound, 'Bound must be a type.') else: self.__bound__ = None _DefaultMixin.__init__(self, default) # for pickling: def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod def __repr__(self): if self.__infer_variance__: prefix = '' elif self.__covariant__: prefix = '+' elif self.__contravariant__: prefix = '-' else: prefix = '~' return prefix + self.__name__ def __hash__(self): return object.__hash__(self) def __eq__(self, other): return self is other def __reduce__(self): return self.__name__ # Hack to get typing._type_check to pass. def __call__(self, *args, **kwargs): pass # 3.8-3.9 if not hasattr(typing, 'Concatenate'): # Inherits from list as a workaround for Callable checks in Python < 3.9.2. class _ConcatenateGenericAlias(list): # Trick Generic into looking into this for __parameters__. __class__ = typing._GenericAlias # Flag in 3.8. _special = False def __init__(self, origin, args): super().__init__(args) self.__origin__ = origin self.__args__ = args def __repr__(self): _type_repr = typing._type_repr return (f'{_type_repr(self.__origin__)}' f'[{", ".join(_type_repr(arg) for arg in self.__args__)}]') def __hash__(self): return hash((self.__origin__, self.__args__)) # Hack to get typing._type_check to pass in Generic. def __call__(self, *args, **kwargs): pass @property def __parameters__(self): return tuple( tp for tp in self.__args__ if isinstance(tp, (typing.TypeVar, ParamSpec)) ) # 3.8-3.9 @typing._tp_cache def _concatenate_getitem(self, parameters): if parameters == (): raise TypeError("Cannot take a Concatenate of no types.") if not isinstance(parameters, tuple): parameters = (parameters,) if not isinstance(parameters[-1], ParamSpec): raise TypeError("The last parameter to Concatenate should be a " "ParamSpec variable.") msg = "Concatenate[arg, ...]: each arg must be a type." parameters = tuple(typing._type_check(p, msg) for p in parameters) return _ConcatenateGenericAlias(self, parameters) # 3.10+ if hasattr(typing, 'Concatenate'): Concatenate = typing.Concatenate _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # 3.9 elif sys.version_info[:2] >= (3, 9): @_ExtensionsSpecialForm def Concatenate(self, parameters): """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. """ return _concatenate_getitem(self, parameters) # 3.8 else: class _ConcatenateForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): return _concatenate_getitem(self, parameters) Concatenate = _ConcatenateForm( 'Concatenate', doc="""Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a higher order function which adds, removes or transforms parameters of a callable. For example:: Callable[Concatenate[int, P], int] See PEP 612 for detailed information. """) # 3.10+ if hasattr(typing, 'TypeGuard'): TypeGuard = typing.TypeGuard # 3.9 elif sys.version_info[:2] >= (3, 9): @_ExtensionsSpecialForm def TypeGuard(self, parameters): """Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). """ item = typing._type_check(parameters, f'{self} accepts only a single type.') return typing._GenericAlias(self, (item,)) # 3.8 else: class _TypeGuardForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type') return typing._GenericAlias(self, (item,)) TypeGuard = _TypeGuardForm( 'TypeGuard', doc="""Special typing form used to annotate the return type of a user-defined type guard function. ``TypeGuard`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeGuard[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeGuard`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the type inside ``TypeGuard``. For example:: def is_str(val: Union[str, float]): # "isinstance" type guard if isinstance(val, str): # Type of ``val`` is narrowed to ``str`` ... else: # Else, type of ``val`` is narrowed to ``float``. ... Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower form of ``TypeA`` (it can even be a wider form) and this may lead to type-unsafe results. The main reason is to allow for things like narrowing ``List[object]`` to ``List[str]`` even though the latter is not a subtype of the former, since ``List`` is invariant. The responsibility of writing type-safe type guards is left to the user. ``TypeGuard`` also works with type variables. For more information, see PEP 647 (User-Defined Type Guards). """) # 3.13+ if hasattr(typing, 'TypeIs'): TypeIs = typing.TypeIs # 3.9 elif sys.version_info[:2] >= (3, 9): @_ExtensionsSpecialForm def TypeIs(self, parameters): """Special typing form used to annotate the return type of a user-defined type narrower function. ``TypeIs`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeIs[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeIs`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the intersection of the type inside ``TypeGuard`` and the argument's previously known type. For example:: def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]: return hasattr(val, '__await__') def f(val: Union[int, Awaitable[int]]) -> int: if is_awaitable(val): assert_type(val, Awaitable[int]) else: assert_type(val, int) ``TypeIs`` also works with type variables. For more information, see PEP 742 (Narrowing types with TypeIs). """ item = typing._type_check(parameters, f'{self} accepts only a single type.') return typing._GenericAlias(self, (item,)) # 3.8 else: class _TypeIsForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type') return typing._GenericAlias(self, (item,)) TypeIs = _TypeIsForm( 'TypeIs', doc="""Special typing form used to annotate the return type of a user-defined type narrower function. ``TypeIs`` only accepts a single type argument. At runtime, functions marked this way should return a boolean. ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static type checkers to determine a more precise type of an expression within a program's code flow. Usually type narrowing is done by analyzing conditional code flow and applying the narrowing to a block of code. The conditional expression here is sometimes referred to as a "type guard". Sometimes it would be convenient to use a user-defined boolean function as a type guard. Such a function should use ``TypeIs[...]`` as its return type to alert static type checkers to this intention. Using ``-> TypeIs`` tells the static type checker that for a given function: 1. The return value is a boolean. 2. If the return value is ``True``, the type of its argument is the intersection of the type inside ``TypeGuard`` and the argument's previously known type. For example:: def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]: return hasattr(val, '__await__') def f(val: Union[int, Awaitable[int]]) -> int: if is_awaitable(val): assert_type(val, Awaitable[int]) else: assert_type(val, int) ``TypeIs`` also works with type variables. For more information, see PEP 742 (Narrowing types with TypeIs). """) # Vendored from cpython typing._SpecialFrom class _SpecialForm(typing._Final, _root=True): __slots__ = ('_name', '__doc__', '_getitem') def __init__(self, getitem): self._getitem = getitem self._name = getitem.__name__ self.__doc__ = getitem.__doc__ def __getattr__(self, item): if item in {'__name__', '__qualname__'}: return self._name raise AttributeError(item) def __mro_entries__(self, bases): raise TypeError(f"Cannot subclass {self!r}") def __repr__(self): return f'typing_extensions.{self._name}' def __reduce__(self): return self._name def __call__(self, *args, **kwds): raise TypeError(f"Cannot instantiate {self!r}") def __or__(self, other): return typing.Union[self, other] def __ror__(self, other): return typing.Union[other, self] def __instancecheck__(self, obj): raise TypeError(f"{self} cannot be used with isinstance()") def __subclasscheck__(self, cls): raise TypeError(f"{self} cannot be used with issubclass()") @typing._tp_cache def __getitem__(self, parameters): return self._getitem(self, parameters) if hasattr(typing, "LiteralString"): # 3.11+ LiteralString = typing.LiteralString else: @_SpecialForm def LiteralString(self, params): """Represents an arbitrary literal string. Example:: from typing_extensions import LiteralString def query(sql: LiteralString) -> ...: ... query("SELECT * FROM table") # ok query(f"SELECT * FROM {input()}") # not ok See PEP 675 for details. """ raise TypeError(f"{self} is not subscriptable") if hasattr(typing, "Self"): # 3.11+ Self = typing.Self else: @_SpecialForm def Self(self, params): """Used to spell the type of "self" in classes. Example:: from typing import Self class ReturnsSelf: def parse(self, data: bytes) -> Self: ... return self """ raise TypeError(f"{self} is not subscriptable") if hasattr(typing, "Never"): # 3.11+ Never = typing.Never else: @_SpecialForm def Never(self, params): """The bottom type, a type that has no members. This can be used to define a function that should never be called, or a function that never returns:: from typing_extensions import Never def never_call_me(arg: Never) -> None: pass def int_or_str(arg: int | str) -> None: never_call_me(arg) # type checker error match arg: case int(): print("It's an int") case str(): print("It's a str") case _: never_call_me(arg) # ok, arg is of type Never """ raise TypeError(f"{self} is not subscriptable") if hasattr(typing, 'Required'): # 3.11+ Required = typing.Required NotRequired = typing.NotRequired elif sys.version_info[:2] >= (3, 9): # 3.9-3.10 @_ExtensionsSpecialForm def Required(self, parameters): """A special typing construct to mark a key of a total=False TypedDict as required. For example: class Movie(TypedDict, total=False): title: Required[str] year: int m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) There is no runtime checking that a required key is actually provided when instantiating a related TypedDict. """ item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) @_ExtensionsSpecialForm def NotRequired(self, parameters): """A special typing construct to mark a key of a TypedDict as potentially missing. For example: class Movie(TypedDict): title: str year: NotRequired[int] m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) """ item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) else: # 3.8 class _RequiredForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) Required = _RequiredForm( 'Required', doc="""A special typing construct to mark a key of a total=False TypedDict as required. For example: class Movie(TypedDict, total=False): title: Required[str] year: int m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) There is no runtime checking that a required key is actually provided when instantiating a related TypedDict. """) NotRequired = _RequiredForm( 'NotRequired', doc="""A special typing construct to mark a key of a TypedDict as potentially missing. For example: class Movie(TypedDict): title: str year: NotRequired[int] m = Movie( title='The Matrix', # typechecker error if key is omitted year=1999, ) """) if hasattr(typing, 'ReadOnly'): ReadOnly = typing.ReadOnly elif sys.version_info[:2] >= (3, 9): # 3.9-3.12 @_ExtensionsSpecialForm def ReadOnly(self, parameters): """A special typing construct to mark an item of a TypedDict as read-only. For example: class Movie(TypedDict): title: ReadOnly[str] year: int def mutate_movie(m: Movie) -> None: m["year"] = 1992 # allowed m["title"] = "The Matrix" # typechecker error There is no runtime checking for this property. """ item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) else: # 3.8 class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return typing._GenericAlias(self, (item,)) ReadOnly = _ReadOnlyForm( 'ReadOnly', doc="""A special typing construct to mark a key of a TypedDict as read-only. For example: class Movie(TypedDict): title: ReadOnly[str] year: int def mutate_movie(m: Movie) -> None: m["year"] = 1992 # allowed m["title"] = "The Matrix" # typechecker error There is no runtime checking for this propery. """) _UNPACK_DOC = """\ Type unpack operator. The type unpack operator takes the child types from some container type, such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For example: # For some generic class `Foo`: Foo[Unpack[tuple[int, str]]] # Equivalent to Foo[int, str] Ts = TypeVarTuple('Ts') # Specifies that `Bar` is generic in an arbitrary number of types. # (Think of `Ts` as a tuple of an arbitrary number of individual # `TypeVar`s, which the `Unpack` is 'pulling out' directly into the # `Generic[]`.) class Bar(Generic[Unpack[Ts]]): ... Bar[int] # Valid Bar[int, str] # Also valid From Python 3.11, this can also be done using the `*` operator: Foo[*tuple[int, str]] class Bar(Generic[*Ts]): ... The operator can also be used along with a `TypedDict` to annotate `**kwargs` in a function signature. For instance: class Movie(TypedDict): name: str year: int # This function expects two keyword arguments - *name* of type `str` and # *year* of type `int`. def foo(**kwargs: Unpack[Movie]): ... Note that there is only some runtime checking of this operator. Not everything the runtime allows may be accepted by static type checkers. For more information, see PEP 646 and PEP 692. """ if sys.version_info >= (3, 12): # PEP 692 changed the repr of Unpack[] Unpack = typing.Unpack def _is_unpack(obj): return get_origin(obj) is Unpack elif sys.version_info[:2] >= (3, 9): # 3.9+ class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True): def __init__(self, getitem): super().__init__(getitem) self.__doc__ = _UNPACK_DOC class _UnpackAlias(typing._GenericAlias, _root=True): __class__ = typing.TypeVar @property def __typing_unpacked_tuple_args__(self): assert self.__origin__ is Unpack assert len(self.__args__) == 1 arg, = self.__args__ if isinstance(arg, (typing._GenericAlias, _types.GenericAlias)): if arg.__origin__ is not tuple: raise TypeError("Unpack[...] must be used with a tuple type") return arg.__args__ return None @_UnpackSpecialForm def Unpack(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return _UnpackAlias(self, (item,)) def _is_unpack(obj): return isinstance(obj, _UnpackAlias) else: # 3.8 class _UnpackAlias(typing._GenericAlias, _root=True): __class__ = typing.TypeVar class _UnpackForm(_ExtensionsSpecialForm, _root=True): def __getitem__(self, parameters): item = typing._type_check(parameters, f'{self._name} accepts only a single type.') return _UnpackAlias(self, (item,)) Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC) def _is_unpack(obj): return isinstance(obj, _UnpackAlias) if _PEP_696_IMPLEMENTED: from typing import TypeVarTuple elif hasattr(typing, "TypeVarTuple"): # 3.11+ def _unpack_args(*args): newargs = [] for arg in args: subargs = getattr(arg, '__typing_unpacked_tuple_args__', None) if subargs is not None and not (subargs and subargs[-1] is ...): newargs.extend(subargs) else: newargs.append(arg) return newargs # Add default parameter - PEP 696 class TypeVarTuple(metaclass=_TypeVarLikeMeta): """Type variable tuple.""" _backported_typevarlike = typing.TypeVarTuple def __new__(cls, name, *, default=NoDefault): tvt = typing.TypeVarTuple(name) _set_default(tvt, default) _set_module(tvt) def _typevartuple_prepare_subst(alias, args): params = alias.__parameters__ typevartuple_index = params.index(tvt) for param in params[typevartuple_index + 1:]: if isinstance(param, TypeVarTuple): raise TypeError( f"More than one TypeVarTuple parameter in {alias}" ) alen = len(args) plen = len(params) left = typevartuple_index right = plen - typevartuple_index - 1 var_tuple_index = None fillarg = None for k, arg in enumerate(args): if not isinstance(arg, type): subargs = getattr(arg, '__typing_unpacked_tuple_args__', None) if subargs and len(subargs) == 2 and subargs[-1] is ...: if var_tuple_index is not None: raise TypeError( "More than one unpacked " "arbitrary-length tuple argument" ) var_tuple_index = k fillarg = subargs[0] if var_tuple_index is not None: left = min(left, var_tuple_index) right = min(right, alen - var_tuple_index - 1) elif left + right > alen: raise TypeError(f"Too few arguments for {alias};" f" actual {alen}, expected at least {plen - 1}") if left == alen - right and tvt.has_default(): replacement = _unpack_args(tvt.__default__) else: replacement = args[left: alen - right] return ( *args[:left], *([fillarg] * (typevartuple_index - left)), replacement, *([fillarg] * (plen - right - left - typevartuple_index - 1)), *args[alen - right:], ) tvt.__typing_prepare_subst__ = _typevartuple_prepare_subst return tvt def __init_subclass__(self, *args, **kwds): raise TypeError("Cannot subclass special typing classes") else: # <=3.10 class TypeVarTuple(_DefaultMixin): """Type variable tuple. Usage:: Ts = TypeVarTuple('Ts') In the same way that a normal type variable is a stand-in for a single type such as ``int``, a type variable *tuple* is a stand-in for a *tuple* type such as ``Tuple[int, str]``. Type variable tuples can be used in ``Generic`` declarations. Consider the following example:: class Array(Generic[*Ts]): ... The ``Ts`` type variable tuple here behaves like ``tuple[T1, T2]``, where ``T1`` and ``T2`` are type variables. To use these type variables as type parameters of ``Array``, we must *unpack* the type variable tuple using the star operator: ``*Ts``. The signature of ``Array`` then behaves as if we had simply written ``class Array(Generic[T1, T2]): ...``. In contrast to ``Generic[T1, T2]``, however, ``Generic[*Shape]`` allows us to parameterise the class with an *arbitrary* number of type parameters. Type variable tuples can be used anywhere a normal ``TypeVar`` can. This includes class definitions, as shown above, as well as function signatures and variable annotations:: class Array(Generic[*Ts]): def __init__(self, shape: Tuple[*Ts]): self._shape: Tuple[*Ts] = shape def get_shape(self) -> Tuple[*Ts]: return self._shape shape = (Height(480), Width(640)) x: Array[Height, Width] = Array(shape) y = abs(x) # Inferred type is Array[Height, Width] z = x + x # ... is Array[Height, Width] x.get_shape() # ... is tuple[Height, Width] """ # Trick Generic __parameters__. __class__ = typing.TypeVar def __iter__(self): yield self.__unpacked__ def __init__(self, name, *, default=NoDefault): self.__name__ = name _DefaultMixin.__init__(self, default) # for pickling: def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod self.__unpacked__ = Unpack[self] def __repr__(self): return self.__name__ def __hash__(self): return object.__hash__(self) def __eq__(self, other): return self is other def __reduce__(self): return self.__name__ def __init_subclass__(self, *args, **kwds): if '_root' not in kwds: raise TypeError("Cannot subclass special typing classes") if hasattr(typing, "reveal_type"): # 3.11+ reveal_type = typing.reveal_type else: # <=3.10 def reveal_type(obj: T, /) -> T: """Reveal the inferred type of a variable. When a static type checker encounters a call to ``reveal_type()``, it will emit the inferred type of the argument:: x: int = 1 reveal_type(x) Running a static type checker (e.g., ``mypy``) on this example will produce output similar to 'Revealed type is "builtins.int"'. At runtime, the function prints the runtime type of the argument and returns it unchanged. """ print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr) return obj if hasattr(typing, "_ASSERT_NEVER_REPR_MAX_LENGTH"): # 3.11+ _ASSERT_NEVER_REPR_MAX_LENGTH = typing._ASSERT_NEVER_REPR_MAX_LENGTH else: # <=3.10 _ASSERT_NEVER_REPR_MAX_LENGTH = 100 if hasattr(typing, "assert_never"): # 3.11+ assert_never = typing.assert_never else: # <=3.10 def assert_never(arg: Never, /) -> Never: """Assert to the type checker that a line of code is unreachable. Example:: def int_or_str(arg: int | str) -> None: match arg: case int(): print("It's an int") case str(): print("It's a str") case _: assert_never(arg) If a type checker finds that a call to assert_never() is reachable, it will emit an error. At runtime, this throws an exception when called. """ value = repr(arg) if len(value) > _ASSERT_NEVER_REPR_MAX_LENGTH: value = value[:_ASSERT_NEVER_REPR_MAX_LENGTH] + '...' raise AssertionError(f"Expected code to be unreachable, but got: {value}") if sys.version_info >= (3, 12): # 3.12+ # dataclass_transform exists in 3.11 but lacks the frozen_default parameter dataclass_transform = typing.dataclass_transform else: # <=3.11 def dataclass_transform( *, eq_default: bool = True, order_default: bool = False, kw_only_default: bool = False, frozen_default: bool = False, field_specifiers: typing.Tuple[ typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]], ... ] = (), **kwargs: typing.Any, ) -> typing.Callable[[T], T]: """Decorator that marks a function, class, or metaclass as providing dataclass-like behavior. Example: from typing_extensions import dataclass_transform _T = TypeVar("_T") # Used on a decorator function @dataclass_transform() def create_model(cls: type[_T]) -> type[_T]: ... return cls @create_model class CustomerModel: id: int name: str # Used on a base class @dataclass_transform() class ModelBase: ... class CustomerModel(ModelBase): id: int name: str # Used on a metaclass @dataclass_transform() class ModelMeta(type): ... class ModelBase(metaclass=ModelMeta): ... class CustomerModel(ModelBase): id: int name: str Each of the ``CustomerModel`` classes defined in this example will now behave similarly to a dataclass created with the ``@dataclasses.dataclass`` decorator. For example, the type checker will synthesize an ``__init__`` method. The arguments to this decorator can be used to customize this behavior: - ``eq_default`` indicates whether the ``eq`` parameter is assumed to be True or False if it is omitted by the caller. - ``order_default`` indicates whether the ``order`` parameter is assumed to be True or False if it is omitted by the caller. - ``kw_only_default`` indicates whether the ``kw_only`` parameter is assumed to be True or False if it is omitted by the caller. - ``frozen_default`` indicates whether the ``frozen`` parameter is assumed to be True or False if it is omitted by the caller. - ``field_specifiers`` specifies a static list of supported classes or functions that describe fields, similar to ``dataclasses.field()``. At runtime, this decorator records its arguments in the ``__dataclass_transform__`` attribute on the decorated object. See PEP 681 for details. """ def decorator(cls_or_fn): cls_or_fn.__dataclass_transform__ = { "eq_default": eq_default, "order_default": order_default, "kw_only_default": kw_only_default, "frozen_default": frozen_default, "field_specifiers": field_specifiers, "kwargs": kwargs, } return cls_or_fn return decorator if hasattr(typing, "override"): # 3.12+ override = typing.override else: # <=3.11 _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any]) def override(arg: _F, /) -> _F: """Indicate that a method is intended to override a method in a base class. Usage: class Base: def method(self) -> None: pass class Child(Base): @override def method(self) -> None: super().method() When this decorator is applied to a method, the type checker will validate that it overrides a method with the same name on a base class. This helps prevent bugs that may occur when a base class is changed without an equivalent change to a child class. There is no runtime checking of these properties. The decorator sets the ``__override__`` attribute to ``True`` on the decorated object to allow runtime introspection. See PEP 698 for details. """ try: arg.__override__ = True except (AttributeError, TypeError): # Skip the attribute silently if it is not writable. # AttributeError happens if the object has __slots__ or a # read-only property, TypeError if it's a builtin class. pass return arg if hasattr(warnings, "deprecated"): deprecated = warnings.deprecated else: _T = typing.TypeVar("_T") class deprecated: """Indicate that a class, function or overload is deprecated. When this decorator is applied to an object, the type checker will generate a diagnostic on usage of the deprecated object. Usage: @deprecated("Use B instead") class A: pass @deprecated("Use g instead") def f(): pass @overload @deprecated("int support is deprecated") def g(x: int) -> int: ... @overload def g(x: str) -> int: ... The warning specified by *category* will be emitted at runtime on use of deprecated objects. For functions, that happens on calls; for classes, on instantiation and on creation of subclasses. If the *category* is ``None``, no warning is emitted at runtime. The *stacklevel* determines where the warning is emitted. If it is ``1`` (the default), the warning is emitted at the direct caller of the deprecated object; if it is higher, it is emitted further up the stack. Static type checker behavior is not affected by the *category* and *stacklevel* arguments. The deprecation message passed to the decorator is saved in the ``__deprecated__`` attribute on the decorated object. If applied to an overload, the decorator must be after the ``@overload`` decorator for the attribute to exist on the overload as returned by ``get_overloads()``. See PEP 702 for details. """ def __init__( self, message: str, /, *, category: typing.Optional[typing.Type[Warning]] = DeprecationWarning, stacklevel: int = 1, ) -> None: if not isinstance(message, str): raise TypeError( "Expected an object of type str for 'message', not " f"{type(message).__name__!r}" ) self.message = message self.category = category self.stacklevel = stacklevel def __call__(self, arg: _T, /) -> _T: # Make sure the inner functions created below don't # retain a reference to self. msg = self.message category = self.category stacklevel = self.stacklevel if category is None: arg.__deprecated__ = msg return arg elif isinstance(arg, type): import functools from types import MethodType original_new = arg.__new__ @functools.wraps(original_new) def __new__(cls, *args, **kwargs): if cls is arg: warnings.warn(msg, category=category, stacklevel=stacklevel + 1) if original_new is not object.__new__: return original_new(cls, *args, **kwargs) # Mirrors a similar check in object.__new__. elif cls.__init__ is object.__init__ and (args or kwargs): raise TypeError(f"{cls.__name__}() takes no arguments") else: return original_new(cls) arg.__new__ = staticmethod(__new__) original_init_subclass = arg.__init_subclass__ # We need slightly different behavior if __init_subclass__ # is a bound method (likely if it was implemented in Python) if isinstance(original_init_subclass, MethodType): original_init_subclass = original_init_subclass.__func__ @functools.wraps(original_init_subclass) def __init_subclass__(*args, **kwargs): warnings.warn(msg, category=category, stacklevel=stacklevel + 1) return original_init_subclass(*args, **kwargs) arg.__init_subclass__ = classmethod(__init_subclass__) # Or otherwise, which likely means it's a builtin such as # object's implementation of __init_subclass__. else: @functools.wraps(original_init_subclass) def __init_subclass__(*args, **kwargs): warnings.warn(msg, category=category, stacklevel=stacklevel + 1) return original_init_subclass(*args, **kwargs) arg.__init_subclass__ = __init_subclass__ arg.__deprecated__ = __new__.__deprecated__ = msg __init_subclass__.__deprecated__ = msg return arg elif callable(arg): import functools @functools.wraps(arg) def wrapper(*args, **kwargs): warnings.warn(msg, category=category, stacklevel=stacklevel + 1) return arg(*args, **kwargs) arg.__deprecated__ = wrapper.__deprecated__ = msg return wrapper else: raise TypeError( "@deprecated decorator with non-None category must be applied to " f"a class or callable, not {arg!r}" ) # We have to do some monkey patching to deal with the dual nature of # Unpack/TypeVarTuple: # - We want Unpack to be a kind of TypeVar so it gets accepted in # Generic[Unpack[Ts]] # - We want it to *not* be treated as a TypeVar for the purposes of # counting generic parameters, so that when we subscript a generic, # the runtime doesn't try to substitute the Unpack with the subscripted type. if not hasattr(typing, "TypeVarTuple"): def _check_generic(cls, parameters, elen=_marker): """Check correct count for parameters of a generic cls (internal helper). This gives a nice error message in case of count mismatch. """ if not elen: raise TypeError(f"{cls} is not a generic class") if elen is _marker: if not hasattr(cls, "__parameters__") or not cls.__parameters__: raise TypeError(f"{cls} is not a generic class") elen = len(cls.__parameters__) alen = len(parameters) if alen != elen: expect_val = elen if hasattr(cls, "__parameters__"): parameters = [p for p in cls.__parameters__ if not _is_unpack(p)] num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters) if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples): return # deal with TypeVarLike defaults # required TypeVarLikes cannot appear after a defaulted one. if alen < elen: # since we validate TypeVarLike default in _collect_type_vars # or _collect_parameters we can safely check parameters[alen] if ( getattr(parameters[alen], '__default__', NoDefault) is not NoDefault ): return num_default_tv = sum(getattr(p, '__default__', NoDefault) is not NoDefault for p in parameters) elen -= num_default_tv expect_val = f"at least {elen}" things = "arguments" if sys.version_info >= (3, 10) else "parameters" raise TypeError(f"Too {'many' if alen > elen else 'few'} {things}" f" for {cls}; actual {alen}, expected {expect_val}") else: # Python 3.11+ def _check_generic(cls, parameters, elen): """Check correct count for parameters of a generic cls (internal helper). This gives a nice error message in case of count mismatch. """ if not elen: raise TypeError(f"{cls} is not a generic class") alen = len(parameters) if alen != elen: expect_val = elen if hasattr(cls, "__parameters__"): parameters = [p for p in cls.__parameters__ if not _is_unpack(p)] # deal with TypeVarLike defaults # required TypeVarLikes cannot appear after a defaulted one. if alen < elen: # since we validate TypeVarLike default in _collect_type_vars # or _collect_parameters we can safely check parameters[alen] if ( getattr(parameters[alen], '__default__', NoDefault) is not NoDefault ): return num_default_tv = sum(getattr(p, '__default__', NoDefault) is not NoDefault for p in parameters) elen -= num_default_tv expect_val = f"at least {elen}" raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments" f" for {cls}; actual {alen}, expected {expect_val}") if not _PEP_696_IMPLEMENTED: typing._check_generic = _check_generic def _has_generic_or_protocol_as_origin() -> bool: try: frame = sys._getframe(2) # - Catch AttributeError: not all Python implementations have sys._getframe() # - Catch ValueError: maybe we're called from an unexpected module # and the call stack isn't deep enough except (AttributeError, ValueError): return False # err on the side of leniency else: # If we somehow get invoked from outside typing.py, # also err on the side of leniency if frame.f_globals.get("__name__") != "typing": return False origin = frame.f_locals.get("origin") # Cannot use "in" because origin may be an object with a buggy __eq__ that # throws an error. return origin is typing.Generic or origin is Protocol or origin is typing.Protocol _TYPEVARTUPLE_TYPES = {TypeVarTuple, getattr(typing, "TypeVarTuple", None)} def _is_unpacked_typevartuple(x) -> bool: if get_origin(x) is not Unpack: return False args = get_args(x) return ( bool(args) and len(args) == 1 and type(args[0]) in _TYPEVARTUPLE_TYPES ) # Python 3.11+ _collect_type_vars was renamed to _collect_parameters if hasattr(typing, '_collect_type_vars'): def _collect_type_vars(types, typevar_types=None): """Collect all type variable contained in types in order of first appearance (lexicographic order). For example:: _collect_type_vars((T, List[S, T])) == (T, S) """ if typevar_types is None: typevar_types = typing.TypeVar tvars = [] # A required TypeVarLike cannot appear after a TypeVarLike with a default # if it was a direct call to `Generic[]` or `Protocol[]` enforce_default_ordering = _has_generic_or_protocol_as_origin() default_encountered = False # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple type_var_tuple_encountered = False for t in types: if _is_unpacked_typevartuple(t): type_var_tuple_encountered = True elif isinstance(t, typevar_types) and t not in tvars: if enforce_default_ordering: has_default = getattr(t, '__default__', NoDefault) is not NoDefault if has_default: if type_var_tuple_encountered: raise TypeError('Type parameter with a default' ' follows TypeVarTuple') default_encountered = True elif default_encountered: raise TypeError(f'Type parameter {t!r} without a default' ' follows type parameter with a default') tvars.append(t) if _should_collect_from_parameters(t): tvars.extend([t for t in t.__parameters__ if t not in tvars]) return tuple(tvars) typing._collect_type_vars = _collect_type_vars else: def _collect_parameters(args): """Collect all type variables and parameter specifications in args in order of first appearance (lexicographic order). For example:: assert _collect_parameters((T, Callable[P, T])) == (T, P) """ parameters = [] # A required TypeVarLike cannot appear after a TypeVarLike with default # if it was a direct call to `Generic[]` or `Protocol[]` enforce_default_ordering = _has_generic_or_protocol_as_origin() default_encountered = False # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple type_var_tuple_encountered = False for t in args: if isinstance(t, type): # We don't want __parameters__ descriptor of a bare Python class. pass elif isinstance(t, tuple): # `t` might be a tuple, when `ParamSpec` is substituted with # `[T, int]`, or `[int, *Ts]`, etc. for x in t: for collected in _collect_parameters([x]): if collected not in parameters: parameters.append(collected) elif hasattr(t, '__typing_subst__'): if t not in parameters: if enforce_default_ordering: has_default = ( getattr(t, '__default__', NoDefault) is not NoDefault ) if type_var_tuple_encountered and has_default: raise TypeError('Type parameter with a default' ' follows TypeVarTuple') if has_default: default_encountered = True elif default_encountered: raise TypeError(f'Type parameter {t!r} without a default' ' follows type parameter with a default') parameters.append(t) else: if _is_unpacked_typevartuple(t): type_var_tuple_encountered = True for x in getattr(t, '__parameters__', ()): if x not in parameters: parameters.append(x) return tuple(parameters) if not _PEP_696_IMPLEMENTED: typing._collect_parameters = _collect_parameters # Backport typing.NamedTuple as it exists in Python 3.13. # In 3.11, the ability to define generic `NamedTuple`s was supported. # This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8. # On 3.12, we added __orig_bases__ to call-based NamedTuples # On 3.13, we deprecated kwargs-based NamedTuples if sys.version_info >= (3, 13): NamedTuple = typing.NamedTuple else: def _make_nmtuple(name, types, module, defaults=()): fields = [n for n, t in types] annotations = {n: typing._type_check(t, f"field {n} annotation must be a type") for n, t in types} nm_tpl = collections.namedtuple(name, fields, defaults=defaults, module=module) nm_tpl.__annotations__ = nm_tpl.__new__.__annotations__ = annotations # The `_field_types` attribute was removed in 3.9; # in earlier versions, it is the same as the `__annotations__` attribute if sys.version_info < (3, 9): nm_tpl._field_types = annotations return nm_tpl _prohibited_namedtuple_fields = typing._prohibited _special_namedtuple_fields = frozenset({'__module__', '__name__', '__annotations__'}) class _NamedTupleMeta(type): def __new__(cls, typename, bases, ns): assert _NamedTuple in bases for base in bases: if base is not _NamedTuple and base is not typing.Generic: raise TypeError( 'can only inherit from a NamedTuple type and Generic') bases = tuple(tuple if base is _NamedTuple else base for base in bases) if "__annotations__" in ns: types = ns["__annotations__"] elif "__annotate__" in ns: # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated types = ns["__annotate__"](1) else: types = {} default_names = [] for field_name in types: if field_name in ns: default_names.append(field_name) elif default_names: raise TypeError(f"Non-default namedtuple field {field_name} " f"cannot follow default field" f"{'s' if len(default_names) > 1 else ''} " f"{', '.join(default_names)}") nm_tpl = _make_nmtuple( typename, types.items(), defaults=[ns[n] for n in default_names], module=ns['__module__'] ) nm_tpl.__bases__ = bases if typing.Generic in bases: if hasattr(typing, '_generic_class_getitem'): # 3.12+ nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem) else: class_getitem = typing.Generic.__class_getitem__.__func__ nm_tpl.__class_getitem__ = classmethod(class_getitem) # update from user namespace without overriding special namedtuple attributes for key, val in ns.items(): if key in _prohibited_namedtuple_fields: raise AttributeError("Cannot overwrite NamedTuple attribute " + key) elif key not in _special_namedtuple_fields: if key not in nm_tpl._fields: setattr(nm_tpl, key, ns[key]) try: set_name = type(val).__set_name__ except AttributeError: pass else: try: set_name(val, nm_tpl, key) except BaseException as e: msg = ( f"Error calling __set_name__ on {type(val).__name__!r} " f"instance {key!r} in {typename!r}" ) # BaseException.add_note() existed on py311, # but the __set_name__ machinery didn't start # using add_note() until py312. # Making sure exceptions are raised in the same way # as in "normal" classes seems most important here. if sys.version_info >= (3, 12): e.add_note(msg) raise else: raise RuntimeError(msg) from e if typing.Generic in bases: nm_tpl.__init_subclass__() return nm_tpl _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {}) def _namedtuple_mro_entries(bases): assert NamedTuple in bases return (_NamedTuple,) @_ensure_subclassable(_namedtuple_mro_entries) def NamedTuple(typename, fields=_marker, /, **kwargs): """Typed version of namedtuple. Usage:: class Employee(NamedTuple): name: str id: int This is equivalent to:: Employee = collections.namedtuple('Employee', ['name', 'id']) The resulting class has an extra __annotations__ attribute, giving a dict that maps field names to types. (The field names are also in the _fields attribute, which is part of the namedtuple API.) An alternative equivalent functional syntax is also accepted:: Employee = NamedTuple('Employee', [('name', str), ('id', int)]) """ if fields is _marker: if kwargs: deprecated_thing = "Creating NamedTuple classes using keyword arguments" deprecation_msg = ( "{name} is deprecated and will be disallowed in Python {remove}. " "Use the class-based or functional syntax instead." ) else: deprecated_thing = "Failing to pass a value for the 'fields' parameter" example = f"`{typename} = NamedTuple({typename!r}, [])`" deprecation_msg = ( "{name} is deprecated and will be disallowed in Python {remove}. " "To create a NamedTuple class with 0 fields " "using the functional syntax, " "pass an empty list, e.g. " ) + example + "." elif fields is None: if kwargs: raise TypeError( "Cannot pass `None` as the 'fields' parameter " "and also specify fields using keyword arguments" ) else: deprecated_thing = "Passing `None` as the 'fields' parameter" example = f"`{typename} = NamedTuple({typename!r}, [])`" deprecation_msg = ( "{name} is deprecated and will be disallowed in Python {remove}. " "To create a NamedTuple class with 0 fields " "using the functional syntax, " "pass an empty list, e.g. " ) + example + "." elif kwargs: raise TypeError("Either list of fields or keywords" " can be provided to NamedTuple, not both") if fields is _marker or fields is None: warnings.warn( deprecation_msg.format(name=deprecated_thing, remove="3.15"), DeprecationWarning, stacklevel=2, ) fields = kwargs.items() nt = _make_nmtuple(typename, fields, module=_caller()) nt.__orig_bases__ = (NamedTuple,) return nt if hasattr(collections.abc, "Buffer"): Buffer = collections.abc.Buffer else: class Buffer(abc.ABC): # noqa: B024 """Base class for classes that implement the buffer protocol. The buffer protocol allows Python objects to expose a low-level memory buffer interface. Before Python 3.12, it is not possible to implement the buffer protocol in pure Python code, or even to check whether a class implements the buffer protocol. In Python 3.12 and higher, the ``__buffer__`` method allows access to the buffer protocol from Python code, and the ``collections.abc.Buffer`` ABC allows checking whether a class implements the buffer protocol. To indicate support for the buffer protocol in earlier versions, inherit from this ABC, either in a stub file or at runtime, or use ABC registration. This ABC provides no methods, because there is no Python-accessible methods shared by pre-3.12 buffer classes. It is useful primarily for static checks. """ # As a courtesy, register the most common stdlib buffer classes. Buffer.register(memoryview) Buffer.register(bytearray) Buffer.register(bytes) # Backport of types.get_original_bases, available on 3.12+ in CPython if hasattr(_types, "get_original_bases"): get_original_bases = _types.get_original_bases else: def get_original_bases(cls, /): """Return the class's "original" bases prior to modification by `__mro_entries__`. Examples:: from typing import TypeVar, Generic from typing_extensions import NamedTuple, TypedDict T = TypeVar("T") class Foo(Generic[T]): ... class Bar(Foo[int], float): ... class Baz(list[str]): ... Eggs = NamedTuple("Eggs", [("a", int), ("b", str)]) Spam = TypedDict("Spam", {"a": int, "b": str}) assert get_original_bases(Bar) == (Foo[int], float) assert get_original_bases(Baz) == (list[str],) assert get_original_bases(Eggs) == (NamedTuple,) assert get_original_bases(Spam) == (TypedDict,) assert get_original_bases(int) == (object,) """ try: return cls.__dict__.get("__orig_bases__", cls.__bases__) except AttributeError: raise TypeError( f'Expected an instance of type, not {type(cls).__name__!r}' ) from None # NewType is a class on Python 3.10+, making it pickleable # The error message for subclassing instances of NewType was improved on 3.11+ if sys.version_info >= (3, 11): NewType = typing.NewType else: class NewType: """NewType creates simple unique types with almost zero runtime overhead. NewType(name, tp) is considered a subtype of tp by static type checkers. At runtime, NewType(name, tp) returns a dummy callable that simply returns its argument. Usage:: UserId = NewType('UserId', int) def name_by_id(user_id: UserId) -> str: ... UserId('user') # Fails type check name_by_id(42) # Fails type check name_by_id(UserId(42)) # OK num = UserId(5) + 1 # type: int """ def __call__(self, obj, /): return obj def __init__(self, name, tp): self.__qualname__ = name if '.' in name: name = name.rpartition('.')[-1] self.__name__ = name self.__supertype__ = tp def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod def __mro_entries__(self, bases): # We defined __mro_entries__ to get a better error message # if a user attempts to subclass a NewType instance. bpo-46170 supercls_name = self.__name__ class Dummy: def __init_subclass__(cls): subcls_name = cls.__name__ raise TypeError( f"Cannot subclass an instance of NewType. " f"Perhaps you were looking for: " f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`" ) return (Dummy,) def __repr__(self): return f'{self.__module__}.{self.__qualname__}' def __reduce__(self): return self.__qualname__ if sys.version_info >= (3, 10): # PEP 604 methods # It doesn't make sense to have these methods on Python <3.10 def __or__(self, other): return typing.Union[self, other] def __ror__(self, other): return typing.Union[other, self] if hasattr(typing, "TypeAliasType"): TypeAliasType = typing.TypeAliasType else: def _is_unionable(obj): """Corresponds to is_unionable() in unionobject.c in CPython.""" return obj is None or isinstance(obj, ( type, _types.GenericAlias, _types.UnionType, TypeAliasType, )) class TypeAliasType: """Create named, parameterized type aliases. This provides a backport of the new `type` statement in Python 3.12: type ListOrSet[T] = list[T] | set[T] is equivalent to: T = TypeVar("T") ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,)) The name ListOrSet can then be used as an alias for the type it refers to. The type_params argument should contain all the type parameters used in the value of the type alias. If the alias is not generic, this argument is omitted. Static type checkers should only support type aliases declared using TypeAliasType that follow these rules: - The first argument (the name) must be a string literal. - The TypeAliasType instance must be immediately assigned to a variable of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid, as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)'). """ def __init__(self, name: str, value, *, type_params=()): if not isinstance(name, str): raise TypeError("TypeAliasType name must be a string") self.__value__ = value self.__type_params__ = type_params parameters = [] for type_param in type_params: if isinstance(type_param, TypeVarTuple): parameters.extend(type_param) else: parameters.append(type_param) self.__parameters__ = tuple(parameters) def_mod = _caller() if def_mod != 'typing_extensions': self.__module__ = def_mod # Setting this attribute closes the TypeAliasType from further modification self.__name__ = name def __setattr__(self, name: str, value: object, /) -> None: if hasattr(self, "__name__"): self._raise_attribute_error(name) super().__setattr__(name, value) def __delattr__(self, name: str, /) -> Never: self._raise_attribute_error(name) def _raise_attribute_error(self, name: str) -> Never: # Match the Python 3.12 error messages exactly if name == "__name__": raise AttributeError("readonly attribute") elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}: raise AttributeError( f"attribute '{name}' of 'typing.TypeAliasType' objects " "is not writable" ) else: raise AttributeError( f"'typing.TypeAliasType' object has no attribute '{name}'" ) def __repr__(self) -> str: return self.__name__ def __getitem__(self, parameters): if not isinstance(parameters, tuple): parameters = (parameters,) parameters = [ typing._type_check( item, f'Subscripting {self.__name__} requires a type.' ) for item in parameters ] return typing._GenericAlias(self, tuple(parameters)) def __reduce__(self): return self.__name__ def __init_subclass__(cls, *args, **kwargs): raise TypeError( "type 'typing_extensions.TypeAliasType' is not an acceptable base type" ) # The presence of this method convinces typing._type_check # that TypeAliasTypes are types. def __call__(self): raise TypeError("Type alias is not callable") if sys.version_info >= (3, 10): def __or__(self, right): # For forward compatibility with 3.12, reject Unions # that are not accepted by the built-in Union. if not _is_unionable(right): return NotImplemented return typing.Union[self, right] def __ror__(self, left): if not _is_unionable(left): return NotImplemented return typing.Union[left, self] if hasattr(typing, "is_protocol"): is_protocol = typing.is_protocol get_protocol_members = typing.get_protocol_members else: def is_protocol(tp: type, /) -> bool: """Return True if the given type is a Protocol. Example:: >>> from typing_extensions import Protocol, is_protocol >>> class P(Protocol): ... def a(self) -> str: ... ... b: int >>> is_protocol(P) True >>> is_protocol(int) False """ return ( isinstance(tp, type) and getattr(tp, '_is_protocol', False) and tp is not Protocol and tp is not typing.Protocol ) def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]: """Return the set of members defined in a Protocol. Example:: >>> from typing_extensions import Protocol, get_protocol_members >>> class P(Protocol): ... def a(self) -> str: ... ... b: int >>> get_protocol_members(P) frozenset({'a', 'b'}) Raise a TypeError for arguments that are not Protocols. """ if not is_protocol(tp): raise TypeError(f'{tp!r} is not a Protocol') if hasattr(tp, '__protocol_attrs__'): return frozenset(tp.__protocol_attrs__) return frozenset(_get_protocol_attrs(tp)) if hasattr(typing, "Doc"): Doc = typing.Doc else: class Doc: """Define the documentation of a type annotation using ``Annotated``, to be used in class attributes, function and method parameters, return values, and variables. The value should be a positional-only string literal to allow static tools like editors and documentation generators to use it. This complements docstrings. The string value passed is available in the attribute ``documentation``. Example:: >>> from typing_extensions import Annotated, Doc >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ... """ def __init__(self, documentation: str, /) -> None: self.documentation = documentation def __repr__(self) -> str: return f"Doc({self.documentation!r})" def __hash__(self) -> int: return hash(self.documentation) def __eq__(self, other: object) -> bool: if not isinstance(other, Doc): return NotImplemented return self.documentation == other.documentation _CapsuleType = getattr(_types, "CapsuleType", None) if _CapsuleType is None: try: import _socket except ImportError: pass else: _CAPI = getattr(_socket, "CAPI", None) if _CAPI is not None: _CapsuleType = type(_CAPI) if _CapsuleType is not None: CapsuleType = _CapsuleType __all__.append("CapsuleType") # Aliases for items that have always been in typing. # Explicitly assign these (rather than using `from typing import *` at the top), # so that we get a CI error if one of these is deleted from typing.py # in a future version of Python AbstractSet = typing.AbstractSet AnyStr = typing.AnyStr BinaryIO = typing.BinaryIO Callable = typing.Callable Collection = typing.Collection Container = typing.Container Dict = typing.Dict ForwardRef = typing.ForwardRef FrozenSet = typing.FrozenSet Generic = typing.Generic Hashable = typing.Hashable IO = typing.IO ItemsView = typing.ItemsView Iterable = typing.Iterable Iterator = typing.Iterator KeysView = typing.KeysView List = typing.List Mapping = typing.Mapping MappingView = typing.MappingView Match = typing.Match MutableMapping = typing.MutableMapping MutableSequence = typing.MutableSequence MutableSet = typing.MutableSet Optional = typing.Optional Pattern = typing.Pattern Reversible = typing.Reversible Sequence = typing.Sequence Set = typing.Set Sized = typing.Sized TextIO = typing.TextIO Tuple = typing.Tuple Union = typing.Union ValuesView = typing.ValuesView cast = typing.cast no_type_check = typing.no_type_check no_type_check_decorator = typing.no_type_check_decorator _vendor/jaraco.context-5.3.0.dist-info/RECORD 0000644 00000001201 15030122015 0014336 0 ustar 00 jaraco.context-5.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 jaraco.context-5.3.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 jaraco.context-5.3.0.dist-info/METADATA,sha256=xDtguJej0tN9iEXCUvxEJh2a7xceIRVBEakBLSr__tY,4020 jaraco.context-5.3.0.dist-info/RECORD,, jaraco.context-5.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 jaraco.context-5.3.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 jaraco/__pycache__/context.cpython-312.pyc,, jaraco/context.py,sha256=REoLIxDkO5MfEYowt_WoupNCRoxBS5v7YX2PbW8lIcs,9552 _vendor/jaraco.context-5.3.0.dist-info/METADATA 0000644 00000007664 15030122015 0014563 0 ustar 00 Metadata-Version: 2.1 Name: jaraco.context Version: 5.3.0 Summary: Useful decorators and context managers Home-page: https://github.com/jaraco/jaraco.context Author: Jason R. Coombs Author-email: jaraco@jaraco.com Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Requires-Python: >=3.8 License-File: LICENSE Requires-Dist: backports.tarfile ; python_version < "3.12" Provides-Extra: docs Requires-Dist: sphinx >=3.5 ; extra == 'docs' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' Requires-Dist: rst.linker >=1.9 ; extra == 'docs' Requires-Dist: furo ; extra == 'docs' Requires-Dist: sphinx-lint ; extra == 'docs' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'docs' Provides-Extra: testing Requires-Dist: pytest !=8.1.1,>=6 ; extra == 'testing' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' Requires-Dist: pytest-cov ; extra == 'testing' Requires-Dist: pytest-mypy ; extra == 'testing' Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'testing' Requires-Dist: portend ; extra == 'testing' .. image:: https://img.shields.io/pypi/v/jaraco.context.svg :target: https://pypi.org/project/jaraco.context .. image:: https://img.shields.io/pypi/pyversions/jaraco.context.svg .. image:: https://github.com/jaraco/jaraco.context/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/jaraco.context/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/jaracocontext/badge/?version=latest :target: https://jaracocontext.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/jaraco.context :target: https://tidelift.com/subscription/pkg/pypi-jaraco.context?utm_source=pypi-jaraco.context&utm_medium=readme Highlights ========== See the docs linked from the badge above for the full details, but here are some features that may be of interest. - ``ExceptionTrap`` provides a general-purpose wrapper for trapping exceptions and then acting on the outcome. Includes ``passes`` and ``raises`` decorators to replace the result of a wrapped function by a boolean indicating the outcome of the exception trap. See `this keyring commit <https://github.com/jaraco/keyring/commit/a85a7cbc6c909f8121660ed1f7b487f99a1c2bf7>`_ for an example of it in production. - ``suppress`` simply enables ``contextlib.suppress`` as a decorator. - ``on_interrupt`` is a decorator used by CLI entry points to affect the handling of a ``KeyboardInterrupt``. Inspired by `Lucretiel/autocommand#18 <https://github.com/Lucretiel/autocommand/issues/18>`_. - ``pushd`` is similar to pytest's ``monkeypatch.chdir`` or path's `default context <https://path.readthedocs.io/en/latest/api.html>`_, changes the current working directory for the duration of the context. - ``tarball`` will download a tarball, extract it, change directory, yield, then clean up after. Convenient when working with web assets. - ``null`` is there for those times when one code branch needs a context and the other doesn't; this null context provides symmetry across those branches. For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-jaraco.context?utm_source=pypi-jaraco.context&utm_medium=referral&utm_campaign=github>`_. _vendor/jaraco.context-5.3.0.dist-info/INSTALLER 0000644 00000000004 15030122015 0014715 0 ustar 00 pip _vendor/jaraco.context-5.3.0.dist-info/WHEEL 0000644 00000000134 15030122015 0014230 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.43.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/jaraco.context-5.3.0.dist-info/LICENSE 0000644 00000001777 15030122015 0014464 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/jaraco.context-5.3.0.dist-info/top_level.txt 0000644 00000000007 15030122015 0016172 0 ustar 00 jaraco _vendor/wheel/__pycache__/macosx_libfile.cpython-310.pyc 0000644 00000024342 15030122015 0017167 0 ustar 00 o �h�@ � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z e r1ddlm Z e e ej e f Z dZdZd Zd Zd Zd Zd ZdZdZdZdZdejfdejfdejfdejfdejfdejfdejfgZ edejfg Z dejfdejfgZ dejfdejfdejfd ejfd ejfgZ dejfdejfdej fd ej fd ejfdejfgZ d ejfd ejfgZ! d ejfd ejfd ej"d! fd"ejfd#ejfd$ejfd%ejfd&ejfd'ejfd(ejfdejfg Z# d ejfd ejfd ej"d! fd"ej fd#ej fd$ej fd%ej fd&ejfd'ejfd(ejfdejfg Z$ e!d)ejfd*ejfg Z% e!d+ejfd,ejfd*ejfd-ejfg Z& dMd1d2�Z' dNdOd8d9�Z(dPd<d=�Z)dQd@dA�Z* dNdRdCdD�Z+dSdFdG�Z,dTdKdL�Z-dS )Ua� This module contains function to analyse dynamic library headers to extract system information Currently only for MacOSX Library file on macosx system starts with Mach-O or Fat field. This can be distinguish by first 32 bites and it is called magic number. Proper value of magic number is with suffix _MAGIC. Suffix _CIGAM means reversed bytes order. Both fields can occur in two types: 32 and 64 bytes. FAT field inform that this library contains few version of library (typically for different types version). It contains information where Mach-O headers starts. Each section started with Mach-O header contains one library (So if file starts with this field it contains only one version). After filed Mach-O there are section fields. Each of them starts with two fields: cmd - magic number for this command cmdsize - total size occupied by this section information. In this case only sections LC_VERSION_MIN_MACOSX (for macosx 10.13 and earlier) and LC_BUILD_VERSION (for macosx 10.14 and newer) are interesting, because them contains information about minimal system version. Important remarks: - For fat files this implementation looks for maximum number version. It not check if it is 32 or 64 and do not compare it with currently built package. So it is possible to false report higher version that needed. - All structures signatures are taken form macosx header files. - I think that binary format will be more stable than `otool` output. and if apple introduce some changes both implementation will need to be updated. - The system compile will set the deployment target no lower than 11.0 for arm64 builds. For "Universal 2" builds use the x86_64 deployment target when the arm64 target is 11.0. � )� annotationsN)�BufferedIOBase)� TYPE_CHECKING)�Unionl �:� l �~u} l �:� l �~u l �z�} l �m� l �z�} l �m� �$ �2 i �magic�cputype� cpusubtype�filetype�ncmds� sizeofcmds�flags�reserved� nfat_arch�offset�size�align�cmd�cmdsize�segname� �vmaddr�vmsize�fileoff�filesize�maxprot�initprot�nsects�version�sdk�platform�minos�ntools�x�int�returnc C s0 | d> d@ | d> d@ B | d? d@ B | d? d@ B S )N� l ~ � i � � � � � )r$ r+ r+ �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/macosx_libfile.py�swap32� s � � ��r- �lib_filer �seek� int | None�"tuple[type[ctypes.Structure], int]c C s� |d u r | � � }n| �|� tj�| �t�tj���j}|tt t t fv r5t j dkr-tj}ntj}t|�}ntj}| �|� ||fS )N�little)�tellr/ �ctypes�c_uint32�from_buffer_copy�read�sizeof�value� FAT_CIGAM� FAT_CIGAM_64�MH_CIGAM� MH_CIGAM_64�sys� byteorder�BigEndianStructure�LittleEndianStructurer- � Structure)r. r/ � magic_number� BaseClassr+ r+ r, � get_base_class_and_magic_number s �� rE � struct_class�type[ctypes.Structure]c C s | � |�t�| ���S �N)r6 r7 r4 r8 )rF r. r+ r+ r, � read_data s rI � path_to_lib�strc s� t | d����t�d�\}}|ttttfvr W d � d S |ttfv r�G dd� d|�}t|��}|tkr>G dd� d|�� nG dd� d|�� � �fdd �t|j �D �}g }|D ]-}z"t �|j �}|d urz|j t krut|�d kru|d kruW qW|�|� W qW ty� Y qWw t|�dkr�t|�W d � S W d � d S z t �d�W W d � S ty� Y W d � d S w 1 s�w Y d S ) N�rbr c @ � e Zd ZeZdS )z4extract_macosx_min_system_version.<locals>.FatHeaderN)�__name__� __module__� __qualname__�fat_header_fields�_fields_r+ r+ r+ r, � FatHeader( � rS c @ rM �z2extract_macosx_min_system_version.<locals>.FatArchN)rN rO rP �fat_arch_fieldsrR r+ r+ r+ r, �FatArch. rT rW c @ rM rU )rN rO rP �fat_arch_64_fieldsrR r+ r+ r+ r, rW 3 rT c s g | ]}t � ���qS r+ )rI )�.0�_�rW r. r+ r, � <listcomp>6 s �z5extract_macosx_min_system_version.<locals>.<listcomp>� )� r r )�openrE � FAT_MAGIC� FAT_MAGIC_64�MH_MAGIC� MH_MAGIC_64r; rI �ranger �read_mach_headerr r �CPU_TYPE_ARM64�len�append� ValueError�max) rJ rD rC rS � fat_header� fat_arch_list� versions_list�elr r+ r[ r, �!extract_macosx_min_system_version sR � � � � �/�2 � 4�4�ro �tuple[int, int, int] | Nonec C s t | |�\}}|tkr dnd}G dd� d|�}|dkr$G dd� d|�}nG dd� d|�}t|| �}t|j�D ]J}| �� } t|| �} | �| � | jtkr_G dd � d |�} t| | �} t | j � S | jt krxG d d � d |�} t| | �} t | j � S | �| | j � q6d S ) z� This function parses a Mach-O header and extracts information about the minimal macOS version. :param lib_file: reference to opened library file with pointer �32�64c @ rM )z%read_mach_header.<locals>.SegmentBaseN)rN rO rP �segment_base_fieldsrR r+ r+ r+ r, � SegmentBaseg rT rt c @ rM �z$read_mach_header.<locals>.MachHeaderN)rN rO rP �mach_header_fieldsrR r+ r+ r+ r, � MachHeaderl rT rw c @ rM ru )rN rO rP �mach_header_fields_64rR r+ r+ r+ r, rw q rT c @ rM )z+read_mach_header.<locals>.VersionMinCommandN)rN rO rP �version_min_command_fieldsrR r+ r+ r+ r, �VersionMinCommand{ rT rz c @ rM )z&read_mach_header.<locals>.VersionBuildN)rN rO rP � build_version_command_fieldsrR r+ r+ r+ r, � VersionBuild� rT r| N)rE rb rI rd r r3 r/ r �LC_VERSION_MIN_MACOSX� parse_versionr �LC_BUILD_VERSIONr" r )r. r/ � base_classrC �archrt rw � mach_header�_i�pos� segment_baserz � version_infor| r+ r+ r, re Z s, �re �tuple[int, int, int]c C s* | d@ d? }| d@ d? }| d@ }|||fS )Nl � r r) r( r* r+ )r r$ �y�zr+ r+ r, r~ � s r~ � archive_root�StrPath� platform_tagc sP |� d�\}}}tdd� |� d�D ��}|dd� }|d dkr&|d df}t|�dks.J �d tjv rutd d� tjd � d�D ��}|dd� }|d dkrT|d df}||k rstj�d �d� d d� |D ��d� d d� |D ���� n|}t|�dks}J �|� i }t� | �D ]9\}}} | D ]1} | � d�s�| � d�r�tj � || �} t | �} | dur�| dd� } | d dkr�| d df} | || < q�q�t|�dkr�t|t|�� ��}d� dd� |D ��} � |k �r � fdd�|�� D �}d� |�}t|�dkr�d}nd}d| d | d | }d tjv �r|�d�}n|�d �}tj�|� |d | d | }|S ) z� Calculate proper macosx platform tag basing on files which are included to wheel Example platform tag `macosx-10.14-x86_64` �-c s � � | ]}t |�V qd S rH �r% �rY r$ r+ r+ r, � <genexpr>� � � z0calculate_macosx_platform_tag.<locals>.<genexpr>�.N� r � �MACOSX_DEPLOYMENT_TARGETc s r� rH r� r� r+ r+ r, r� � s � �z�[WARNING] MACOSX_DEPLOYMENT_TARGET is set to a lower value ({}) than the version on which the Python interpreter was compiled ({}), and will be ignored. c s r� rH �rK r� r+ r+ r, r� � r� c s r� rH r� r� r+ r+ r, r� � r� z.dylibz.sorZ c S s g | ]}t |��qS r+ r� r� r+ r+ r, r\ � s z1calculate_macosx_platform_tag.<locals>.<listcomp>c s g | ] \}}|� kr|�qS r+ r+ )rY �k�v�� start_versionr+ r, r\ � s � r] z this filez these filesz}[WARNING] This wheel needs a higher macOS version than {} To silence this warning, set MACOSX_DEPLOYMENT_TARGET to at least z or recreate z( with lower MACOSX_DEPLOYMENT_TARGET: z,is set in MACOSX_DEPLOYMENT_TARGET variable.z8the version your Python interpreter is compiled against.)�split�tuplerg �os�environr> �stderr�write�format�join�walk�endswith�pathro rj �values�items)r� r� �prefix� base_version�suffix� deploy_target� versions_dict�dirpath� _dirnames� filenames�filename�lib_path�min_ver�fin_base_version�problematic_files� files_form� error_messager+ r� r, � calculate_macosx_platform_tag� s� � �� �� ������ �� r� )r$ r% r& r% rH )r. r r/ r0 r& r1 )rF rG r. r )rJ rK )r. r r/ r0 r& rp )r r% r& r� )r� r� r� rK r& rK ).�__doc__� __future__r r4 r� r> �ior �typingr r rK �PathLiker� r` r: ra r; rb r< rc r= r} r rf r5 �c_intrv rx rQ rV �c_uint64rX rs �c_char�segment_command_fields�segment_command_fields_64ry r{ r- rE rI ro re r~ r� r+ r+ r+ r, �<module> s� ( � � � � � � � � < � 2 _vendor/wheel/__pycache__/util.cpython-310.pyc 0000644 00000001333 15030122015 0015157 0 ustar 00 o �h� � @ s> d dl mZ d dlZd dlZe�d�Zd dd�Zd d d �ZdS ) � )� annotationsN�wheel�data�bytes�returnc C s t �| ��d�S )z!urlsafe_b64encode without padding� =)�base64�urlsafe_b64encode�rstrip)r � r �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/util.pyr s r c C s" ddt | �d@ }t�| | �S )z!urlsafe_b64decode without paddingr � � )�lenr �urlsafe_b64decode)r �padr r r r s r )r r r r )� __future__r r �logging� getLogger�logr r r r r r �<module> s _vendor/wheel/__pycache__/__init__.cpython-310.pyc 0000644 00000000372 15030122015 0015743 0 ustar 00 o �h; � @ s d dl mZ dZdS )� )� annotationsz0.45.1N)� __future__r � __version__� r r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/__init__.py�<module> s _vendor/wheel/__pycache__/metadata.cpython-310.pyc 0000644 00000014077 15030122015 0015773 0 ustar 00 o �h � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZmZmZ ddlmZ d3d d �Zejd4dd��Ze�e�d5dd��Zd6dd�Zd7d d �Zd8d d �Z d9d#d$�Z d:d'd(�Z d;d,d-�Z d<d1d2�Z dS )=z2 Tools for converting old- to new-style metadata. � )� annotationsN)�Message)�Parser)� Generator�Iterable�Iterator�Literal� )� Requirement�str�return�bool | Literal['']c C s | o| � d� S )N�#)� startswith)r � r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/metadata.py� _nonblank s r �iterable� Iterable[str]� Iterator[str]c C s t j�tt| ��S )a� Yield valid lines of a string or iterable. >>> list(yield_lines('')) [] >>> list(yield_lines(['foo', 'bar'])) ['foo', 'bar'] >>> list(yield_lines('foo\nbar')) ['foo', 'bar'] >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) ['foo', 'baz #comment'] >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) ['foo', 'bar', 'baz', 'bing'] )� itertools�chain� from_iterable�map� yield_lines)r r r r r s r �textc C s t tttj| �� ��S �N)�filterr r r �strip� splitlines)r r r r �_) s r �s�str | Iterator[str]�3Generator[tuple[str | None, list[str]], None, None]c c sv � d}g }t | �D ]*}|�d�r.|�d�r)|s|r ||fV |dd� �� }g }q td|��|�|� q ||fV dS )ar Split a string or iterable thereof into (section, content) pairs Each ``section`` is a stripped version of the section header ("[section]") and each ``content`` is a list of stripped lines excluding blank lines and comment-only lines. If there are any such lines before the first section header, they're returned in a first ``section`` of ``None``. N�[�]r ���zInvalid section heading)r r �endswithr � ValueError�append)r! �section�content�liner r r �split_sections. s � r- �extrac C s t �dd| ��� S )z�Convert an arbitrary string to a standard 'extra' name Any runs of non-alphanumeric characters are replaced with a single '_', and the result is always lowercased. z[^A-Za-z0-9.-]+r )�re�sub�lower)r. r r r � safe_extraI s r2 �namec C s t �dd| �S )z�Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. z[^A-Za-z0-9.]+�-)r/ r0 )r3 r r r � safe_nameQ s r5 � requirementr c C sL | j rd| j S g }| jD ] }|�|j|j � q |r$dd�t|�� S dS )zFReturn the version specifier for a requirement in PEP 345/566 fashion.z @ � �,� )�url� specifierr) �operator�version�join�sorted)r6 � requires_dist�specr r r �requires_to_requires_distX s rB � requirements� list[str]c c s^ � | D ])}t |�}t|�}d�tdd� |jD ���}|r"d|� d�}t|j�| | V qdS )z=Yield Requires-Dist: strings for parsed requirements strings.r8 c s s � | ]}t |�V qd S r )r2 )�.0�er r r � <genexpr>l s � z'convert_requirements.<locals>.<genexpr>r$ r% N)r rB r> r? �extrasr5 r3 )rC �req�parsed_requirementrA rH r r r �convert_requirementsg s � �rK �extras_require�dict[str | None, list[str]]�Iterator[tuple[str, str]]c c s� � | � � D ]K\}}d}|pd}d|v r|�dd�\}}t|�}|r6d|fV |r.d| d }|d|� d�7 }|r<d | }t|�D ]}tt|| ��}d |fV q@qd S ) a, Convert requirements from a setup()-style dictionary to ('Requires-Dist', 'requirement') and ('Provides-Extra', 'extra') tuples. extras_require is a dictionary of {extra: [requirements]} as passed to setup(), using the empty extra {'': [requirements]} to hold install_requires. r9 �:r �Provides-Extra�(z) and z extra == '�'z ; � Requires-DistN)�items�splitr2 rK r r )rL r. �depends� condition�new_req� canonical_reqr r r �generate_requirementss s& � ��rZ � egg_info_path� pkginfo_pathr c C sF t |dd��}t� �|�}W d � n1 sw Y |�dd� |d= |d= tj�| d�}tj�|�rwt |dd�� }|�� }W d � n1 sJw Y t t |�d d � d �}|D ]\}} t || i�D ]\} } | | f|� � vru| || < qeq[|d } | r�|d � � } d �| d �� t�d �| dd� ��d f�}|�|� |d = |S )zN Convert .egg-info directory with PKG-INFO to the Metadata 2.1 format zutf-8)�encodingNzMetadata-Versionz2.1rP rS z requires.txtc S s | d pdS )Nr r9 r )�xr r r �<lambda>� s z%pkginfo_to_metadata.<locals>.<lambda>)�key� Description� r r )�openr �parse�replace_header�os�pathr> �exists�readr? r- rZ rT r �lstrip�textwrap�dedent� set_payload)r[ r\ �headers�pkg_info� requires_path� requires_file�requires�parsed_requirementsr. �reqsr` �value� description�description_lines�dedented_descriptionr r r �pkginfo_to_metadata� s< � � �� �� ry )r r r r )r r r r )r r r r )r! r" r r# )r. r r r )r3 r r r )r6 r r r )rC rD r r )rL rM r rN )r[ r r\ r r r )!�__doc__� __future__r � functoolsr �os.pathrf r/ rk � email.messager � email.parserr �typingr r r r � vendored.packaging.requirementsr r �singledispatchr �registerr r r- r2 r5 rB rK rZ ry r r r r �<module> s. _vendor/wheel/__pycache__/_setuptools_logging.cpython-310.pyc 0000644 00000002014 15030122015 0020265 0 ustar 00 o �h � @ s4 d dl mZ d dlZd dlZd dd�Zd d d �ZdS )� )� annotationsN�record�logging.LogRecord�return�boolc C s | j tjk S )N)�levelno�logging�WARNING)r � r �_/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py� _not_warning s r �Nonec C sJ t �� } | �t j� t �tj�}|�t� | |f}t jdd|t j d� dS )z� Configure logging to emit warning and above to stderr and everything else to stdout. This behavior is provided for compatibility with distutils.log but may change in the future. z {message}�{)�format�style�handlers�levelN) r � StreamHandler�setLevelr �sys�stdout� addFilterr � basicConfig�DEBUG)� err_handler� out_handlerr r r r � configure s �r )r r r r )r r )� __future__r r r r r r r r r �<module> s _vendor/wheel/__pycache__/bdist_wheel.cpython-310.pyc 0000644 00000001306 15030122015 0016473 0 ustar 00 o �hS � @ sn d dl mZ d dlmZ ededd� er ddlmZ dS z d dlmZ W dS ey6 ddlmZ Y dS w )� )� TYPE_CHECKING)�warnz�The 'wheel' package is no longer the canonical location of the 'bdist_wheel' command, and will be removed in a future release. Please update to setuptools v70.1 or later which contains an integrated version of this command.� )� stacklevel)� bdist_wheelN) �typingr �warningsr �DeprecationWarning� _bdist_wheelr � setuptools.command.bdist_wheel� ImportError� r r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/bdist_wheel.py�<module> s � � _vendor/wheel/__pycache__/__main__.cpython-310.pyc 0000644 00000001210 15030122015 0015714 0 ustar 00 o �h� � @ s< d Z ddlmZ ddlZdd� Zedkr e�e� � dS dS )z9 Wheel command line tool (enable python -m wheel syntax) � )� annotationsNc C sP t dkrdd l} | j�| j�t��}|gtjdd�< dd l}t�|j� � � d S )N� r ) � __package__�os.path�path�dirname�__file__�sys� wheel.cli�exit�cli�main)�osr �wheel� r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/__main__.pyr s r �__main__)�__doc__� __future__r r r �__name__r r r r r �<module> s � _vendor/wheel/__pycache__/_bdist_wheel.cpython-310.pyc 0000644 00000035576 15030122015 0016652 0 ustar 00 o �h�T � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZ ddlmZ ddlmZ ddlmZmZmZmZmZmZ dd lmZm Z ddl Z dd l m Z d d l m Z! d d l"m#Z# d dl$m%Z% d dl&m'Z' d dl&m(Z) d dl*m+Z+ er�ddl,Z,ze-d� W n e.y� d dl m/Z/ e/�0� Y nw dBdd�Z1dCdd�Z2e3e j �4d �d �Z5d Z6dDd d �Z7dEd!d"�Z8dFd%d&�Z9 'dGdHd,d-�Z:dId.d/�Z;dBd0d1�Z<dCd2d3�Z=dJd:d;�Z>dKd>d?�Z?G d@dA� dAe �Z@dS )LzI Create a wheel (.whl) distribution. A wheel is a built archive format. � )� annotationsN)�BytesGenerator� Generator)� EmailPolicy)�iglob)�rmtree)� TYPE_CHECKING�Callable�Iterable�Literal�Sequence�cast)� ZIP_DEFLATED� ZIP_STORED)�Command� )� __version__)�pkginfo_to_metadata)�log)�tags��version)� WheelFilezsetuptools.logging)�_setuptools_logging�name�str�returnc C s t �dd| �S )z�Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. �[^A-Za-z0-9.]+�-)�re�sub�r � r" �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/_bdist_wheel.py� safe_name/ s r$ r c C s@ zt t�| ��W S tjy | �dd�} t�dd| � Y S w )zB Convert an arbitrary string to a standard version string � �.r r )r �_packaging_version�Version�InvalidVersion�replacer r r r" r" r# � safe_version6 s �r+ r& zcp3\d�boolc C s t �d�dkS )N�P� )�struct�calcsizer" r" r" r# �_is_32bit_interpreterG s r1 c C s dt jd � �S )N�pyr )�sys� version_infor" r" r" r# � python_tagK � r5 � archive_root� str | Nonec C s^ t �� }|�d�r| durddlm} || |�}nt� r)|dkr#d}n|dkr)d}|�d d �S ) z0Return our platform name 'win32', 'linux_x86_64'�macosxNr )� calculate_macosx_platform_tag� linux-x86_64z linux-i686� linux-aarch64z linux-armv7lr �_)� sysconfig� get_platform� startswith�macosx_libfiler: r1 r* )r7 �resultr: r" r" r# r? O s r? T�var�fallback�expected�warnc C s: t �| �}|du r|rtjd| � d�tdd� |S ||kS )zfUse a fallback value for determining SOABI flags if the needed config var is unset or unavailable.NzConfig variable 'z+' is unset, Python ABI tag may be incorrect� �� stacklevel)r> �get_config_var�warningsrF �RuntimeWarning)rC rD rE rF �valr" r" r# �get_flagc s �rN c C s� t �d�} t�� }| sO|dv rOttd�rOd}d}d}tdttd�|dkd�r(d }td |dk|dko5tjd k d�r?tjd k r?d }|� t�� � |� |� |� �}|S | re|dkre| � d �red| � d�d }|S | ry|dkry| � d�ry| � d�d }|S | r�|dkr�d� | � d�dd� �}|� dd�� dd�}|S | r�|dkr�d� | � d�dd� �}|� dd�� dd�}|S | r�| � dd�� dd�}|S d}|S )zJReturn the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2).�SOABI)�cp�pp� maxunicode� �Py_DEBUG�gettotalrefcountrP )rF �d� WITH_PYMALLOC)� � �m�cpythonr r r rQ NrG r& r= �graalpyrX ) r> rJ r �interpreter_name�hasattrr3 rN r4 �interpreter_versionr@ �split�joinr* )�soabi�implrV rZ �u�abir" r" r# � get_abi_tagt sH � �� � ���rf c C � t | ��dd�S �Nr r= )r$ r* r! r" r" r# � safer_name� r6 ri c C rg rh )r+ r* r r" r" r# � safer_version� r6 rj �func�Callable[..., object]�path�excinfo�6tuple[type[Exception], Exception, types.TracebackType]�Nonec C s t | ||d � d S )Nr )�remove_readonly_exc)rk rm rn r" r" r# �remove_readonly� s rr �exc� Exceptionc C s t �|tj� | |� d S )N)�os�chmod�stat�S_IWRITE)rk rm rs r" r" r# rq � s rq c @ s� e Zd ZdZeed�Zdddded�� d�fd d d d d ddddd�d� e��fddde � � d�fddg Z g d�Z dd� Z dd � Zed d � �Zd5d!d"�Zd#d$� Zd%e� d�fd6d)d*�Zd7d,d-�Zed8d/d0��Zd9d3d4�ZdS ):� bdist_wheelzcreate a wheel distribution)�stored�deflated)z bdist-dir=�bz1temporary directory for creating the distributionz plat-name=�pz8platform name to embed in generated filenames (default: N�))� keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z dist-dir=rV z-directory to put final built distributions in)� skip-buildNz2skip rebuilding everything (for testing/debugging))�relativeNz7build the archive using relative paths (default: false))zowner=rd z@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group])� universalNz'make a universal wheel (default: false)z compression=z6zipfile compression (one of: {}) (default: 'deflated')z, z python-tag=z3Python implementation compatibility tag (default: 'z'))z build-number=NzqBuild number for this particular version. As specified in PEP-0427, this must start with a digit. [default: None])zpy-limited-api=Nz?Python tag (cp32|cp33|cpNN) for abi3 wheel tag (default: false))r r� r� r� c C sx d | _ d | _d | _d | _d| _d| _d | _d | _d | _d | _ d| _ d | _ d | _ d| _ d| _t� | _d | _d| _d| _d S )N�zipFr{ )� bdist_dir�data_dir� plat_name�plat_tag�format� keep_temp�dist_dir� egginfo_dir� root_is_pure� skip_buildr� �owner�groupr� � compressionr5 � build_number�py_limited_api�plat_name_supplied)�selfr" r" r# �initialize_options� s& z bdist_wheel.initialize_optionsc C sJ | j d u r| �d�j}tj�|d�| _ | j�d�}|�� | j d | _ | j d u| _ z | j | j | _W n tyB td| j� ��d �w d}| jdgt||��R � | j�� pZ| j�� | _| jrot�t| j�sotdt� d���| j�d�}d |v r�t� d � |d d � � }|� � d v r�d | _ | j d ur�| j d d � �!� s�td��d S d S )N�bdist�wheel�egg_infoz.datazUnsupported compression: )r� r� r� zpy-limited-api must match '�'r� z=The [wheel] section is deprecated. Use [bdist_wheel] instead.r )�1�true�yesTz1Build tag (build-number) must start with a digit.)"r� �get_finalized_command� bdist_baseru rm ra � distribution�get_command_obj�ensure_finalized�wheel_dist_namer� r� r� �supported_compressionsr� �KeyError� ValueError�set_undefined_optionsr� �has_ext_modules�has_c_librariesr� r� r �match�PY_LIMITED_API_PATTERN�get_option_dictr �warning�strip�lowerr� r� �isdigit)r� r� r� � need_optionsr� rM r" r" r# �finalize_options s> �� � � �z bdist_wheel.finalize_optionsc C s8 t | j�� �t| j�� �f}| jr|| jf7 }d�|�S )z4Return distribution full name with - replaced with _r )ri r� �get_namerj � get_versionr� ra )r� � componentsr" r" r# r� 5 s � zbdist_wheel.wheel_dist_namer �tuple[str, str, str]c s( | j r tt| j�� n'| jrd� n!| jr | j�d�s | j� nt| j�� t� r1� dv r+d� � dv r1d� � � � � dd�� d d�� d d�� | jrT| j rJd }n| j }|d � f}|S t �� }t �� }|| }| jrp|| �d �rp| j}d}ntt� �� � }||� f}� fdd�t �� D �}||v s�J d|� ���|S )N�anyr9 )r; � linux_x86_64� linux_i686)r< � linux_aarch64� linux_armv7lr r= r& r% zpy2.py3�none�cp3�abi3c s g | ] }|j |j� f�qS r" )� interpreterre )�.0�t�r� r" r# � <listcomp>r s �z'bdist_wheel.get_tag.<locals>.<listcomp>z'would build wheel with unsupported tag )r� r r r� r� r@ r? r� r1 r� r* r� r5 r r] r_ r� rf �sys_tags)r� rc �tag� impl_name�impl_ver�abi_tag�supported_tagsr" r� r# �get_tag@ sF � � � �zbdist_wheel.get_tagc C s� | � d�}d|_d|_| � d�}d|_| js| �d� | j ddd�}| j|_d|_| j|_d|_ | � d �}d|_ d D ]}t |d | t j �| j|�� q:d }t jd krdt j �t j �| jd��}| | _| _t || jrkdnd|� t�d| j� �� | �d� | �� \}}} | j� d|� d|� d| � �} | js�| j} n t j �| j| �|j��} | � dd� t | j � � �� dt | j �!� �� d�} t j �| j| �} | �"| j#| � | �$| � t j �%| j&�s�t �'| j&� t j �| j&| d �}t(|d| j)�� }|�*| � W d � n1 s�w Y t+| j dg ��,ddj-t.j/d d� � |f� | j0�sBt�d | j� �� | j1�sDt.j/d k �r9t2| jt3d � d S t2| jt4d � d S d S d S ) N� build_scripts�pythonT� build_extF�build�install)�reinit_subcommands�install_scripts)�headers�scripts�data�purelib�platlib�install_rS �ntz..�install_purelib�install_platlibzinstalling to r �install_egg_info)�targetr� z .dist-infoz.whl�w� dist_filesry z{}.{}rG z removing )rX � )�onerror)�onexc)5�reinitialize_command� executable�force�inplacer� � run_commandr� �root�compile�warn_dir�no_ep�setattrru rm ra r� r �normpath�install_libbase� install_libr� r �infor� r� r� �_ensure_relative� install_baser� ri r� r� rj r� �egg2distr� �write_wheelfile�existsr� �makedirsr r� � write_files�getattr�appendr� r3 r4 r� �dry_runr rr rq )r� r� r� r� r� �key�basedir_observed�impl_tagr� r� �archive_basenamer7 �distinfo_dirname� distinfo_dir� wheel_path�wfr" r" r# �runz s| � � �� ��� �zbdist_wheel.runz bdist_wheel (�wheelfile_baser � generatorc C s� ddl m} |� }d|d< ||d< t| j��� |d< | jd ur$| j|d< | �� \}}}|�d�D ] }|�d�D ]} |�d�D ] } d �|| | f�|d < q>q7q0t j �|d �} t � d | � �� t | d ��} t| dd��|� W d � d S 1 svw Y d S )Nr )�Messagez1.0z Wheel-Versionr zRoot-Is-Purelib�Buildr& r �Tag�WHEELz creating �wb)� maxheaderlen)� email.messager r r� r� r� r� r` ra ru rm r r� �openr �flatten) r� r r r �msgr� r� r� rc re �plat�wheelfile_path�fr" r" r# r� � s& �� "�zbdist_wheel.write_wheelfilerm c C s6 t j�|�\}}|dd� t jkr||dd � }|S )Nr r )ru rm � splitdrive�sep)r� rm �driver" r" r# r� � s z bdist_wheel._ensure_relative� Iterable[str]c C s t dkr | jjjp dS t� }| j�d�}t dkr#ttt | jjj�}nd|v r0|d d � � }nd}d|v rGt j dt d d � |� |d d � |sR|sRt|t�sRd }|D ]3}t|�D ],}|�d �rkt�d |� d�� qZ||vr�tj�|�r�t�d|� d|� d�� |� |� qZqT|S )N�9 r" �metadata�* � license_filesr � license_filezEThe "license_file" option is deprecated. Use "license_files" instead.rG rH )z LICEN[CS]E*zCOPYING*zNOTICE*zAUTHORS*�~zignoring license file "z" as it looks like a backupzadding license file "z" (matched pattern "z"))�setuptools_major_versionr� r r �setr� r r r r` rK rF �DeprecationWarning�add� isinstance�listr �endswithr �debugru rm �isfiler� )r� �filesr �patterns�patternrm r" r" r# � license_paths� sB � �� �� zbdist_wheel.license_paths� egginfo_path� distinfo_pathc C s� ddd�}||� t j�|�s?ddl}t j�t j�|�d �}|�|�}d |� d �}|r;t j�|d �}|d |� d �7 }t|��t j�|�rPt ||�} t � |� n?t j�|d�} t || �} t j ||dd� d� t j�|d�} t | dd��} | �� �� } W d � n1 s�w Y | s�|| � t j�|d�}tdddd�}t |ddd��}t||d��| � W d � n1 s�w Y | jD ]}t j�|�}t �|t j�||�� q�||� dS ) z:Convert an .egg-info directory into a .dist-info directoryr} r r rp c S sP t j�| �rt j�| �st j�| �rt�| � dS t j�| �r&t �| � dS dS )z-Appropriately delete directory, file or link.N)ru rm r� �islink�isdir�shutilr �unlink)r} r" r" r# �adios# s $ �z#bdist_wheel.egg2dist.<locals>.adiosr Nz *.egg-infozEgg metadata expected at z but not foundz (z) found - possible misnamed archive file?)�PKG-INFOc S s h d�S )N> � SOURCES.txt� not-zip-safe� requires.txtr1 r" )�x�yr" r" r# �<lambda>I s z&bdist_wheel.egg2dist.<locals>.<lambda>)�ignorezdependency_links.txtzutf-8)�encoding�METADATATF)�utf8� mangle_from_�max_line_lengthr� )�policy)r} r r rp )ru rm r� �globra �dirname�basenamer� r% r �mkdirr. �copytreer �readr� r r r r) �copy)r� r* r+ r0 r? �pat�possible�err�alt�pkg_info� pkginfo_path�dependency_links_path�dependency_links_file�dependency_links� pkg_info_path�serialization_policy�out� license_path�filenamer" r" r# r� sP � �� � zbdist_wheel.egg2dist)r r� )r r r r )rm r r r )r r )r* r r+ r )�__name__� __module__� __qualname__� descriptionr r r� r? r� ra r5 � user_options�boolean_optionsr� r� �propertyr� r� r � wheel_versionr� r� r) r� r" r" r" r# ry � sZ ����� ��:+ : [ � ,ry )r r r r )r r r r )r r, )r r )r7 r8 r r )TT) rC r rD r, rE r, rF r, r r, )r r8 )rk rl rm r rn ro r rp )rk rl rm r rs rt r rp )A�__doc__� __future__r ru r r. rw r/ r3 r> rK �email.generatorr r � email.policyr r? r r �typingr r r r r r �zipfiler r � setuptoolsr rS r r[ r r �utilr �vendored.packagingr r r' � wheelfiler �types� __import__� ImportErrorr � configurer$ r+ �intr` r r� r1 r5 r? rN rf ri rj rr rq ry r" r" r" r# �<module> s^ � � ( _vendor/wheel/__pycache__/wheelfile.cpython-310.pyc 0000644 00000014572 15030122015 0016157 0 ustar 00 o �h� � @ s d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl m Z m Z d dl m Z mZmZ d dlmZmZmZ d dlmZ d dlmZmZmZ erod dl mZmZm Z d d l m Z e e ej e f Z!G d d � d ee e�Z"e�#d ej$�Z%d Z&dddd�Z'G dd� de�Z(dS )� )� annotationsN)�StringIO� TextIOWrapper)�IO� TYPE_CHECKING�Literal)� ZIP_DEFLATED�ZipFile�ZipInfo)� WheelError)�log�urlsafe_b64decode�urlsafe_b64encode)�Protocol�Sized�Union)�Bufferc @ s e Zd ZdS )� SizedBufferN)�__name__� __module__� __qualname__� r r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/wheelfile.pyr s r z�^(?P<namever>(?P<name>[^\s-]+?)-(?P<ver>[^\s-]+?))(-(?P<build>\d[^\s-]*))? -(?P<pyver>[^\s-]+?)-(?P<abi>[^\s-]+?)-(?P<plat>\S+)\.whl$i ��� timestamp� float | Nonec C s6 t tj�d| p t�� ��} t| t�} t�| �dd� S )N�SOURCE_DATE_EPOCHr � )�int�os�environ�get�time�max�MINIMUM_TIMESTAMP�gmtime)r r r r �get_zipinfo_datetime$ s r% c @ sf e Zd ZdZejZdefd(d d �Z d)d*dd�Z d+dd�Z d,d-d d �Z d.d/d$d%�Z d&d'� Z d S )0� WheelFilez�A ZipFile derivative class that also reads SHA-256 hashes from .dist-info/RECORD and checks any read files against those. �r�file�StrPath�mode�Literal['r', 'w', 'x', 'a']� compressionr c C s� t j�|�}t�|�| _|�d�r| jd u r td|����tj | |||dd� d� | j� d��| _ | j d | _ i | _i | _|dkr�d | j| j < d | j| j d < d | j| j d < z| �| j �}W n typ td | j � d ��d �w |�V t�t|ddd��D ]B}|\}}} |s�q~|�d�\} }zt�| � W n ty� td| � ��d �w | �� dv r�td| � d���| t|�d��f| j|< q~W d � d S 1 s�w Y d S d S )Nz.whlzBad wheel filename T)r, � allowZip64z {}.dist-info�nameverz/RECORDr' �NNz.jwsz.p7szMissing z file� �utf-8)�newline�encoding�=z Unsupported hash algorithm: > �md5�sha1zWeak hash algorithm (z ) is not permitted by PEP 427�ascii) r �path�basename� WHEEL_INFO_RE�match�parsed_filename�endswithr r �__init__�format�group�dist_info_path� record_path� _file_hashes� _file_sizes�open�KeyError�csv�readerr �split�hashlib�new� ValueError�lowerr �encode) �selfr( r* r, r9 �record�liner8 �hash_sum�size� algorithmr r r r> 3 s^ � � � ��� � ��"��zWheelFile.__init__N� name_or_info� str | ZipInfo�Literal['r', 'w']�pwd� bytes | None�return� IO[bytes]c s� d � ����fdd� }t |t�r|jn|�|dkr+��d�s+�| jvr+td �� d ���t�| |||�� |dkrS��d�sS| j� \}��d urSt� |��� j |�� _ � S ) N�newdata�bytesrZ �Nonec s@ � j }�| � ��| � |r ��� �kr td�� d���d S d S )NzHash mismatch for file '�')�_eof�update�digestr )r\ �eof��ef�ef_name� expected_hash� running_hash�update_crc_origr r � _update_crcs s �z#WheelFile.open.<locals>._update_crcr' �/zNo hash found for file 'r_ )r\ r] rZ r^ ) � isinstancer �filenamer= rC r r rE rJ rK rj )rO rU r* rX rj rT r rd r rE m s �� zWheelFile.open�base_dir�strc C s� t �d| j� d|� d�� g }t�|�D ]G\}}}|�� t|�D ]9}tj�tj� ||��}tj� |�rZtj� ||�� tjj d�}|| jkrGq!|�d�rT|�||f� q!| �||� q!q|�� |D ] \}}| �||� qbd S )Nz creating 'z' and adding 'z' to itrk z .dist-info)r �inform r �walk�sort�sortedr8 �normpath�join�isfile�relpath�replace�seprB r= �append�write) rO rn �deferred�root�dirnames� filenames�namer8 �arcnamer r r � write_files� s& �� �zWheelFile.write_filesrm r� � str | None� compress_type� int | Noner^ c C s� t |d��}t�|�� �}|�� }W d � n1 sw Y t|p$|t|j�d�}t� |j �t� |j �B d> |_ |p>| j |_| �|||� d S )N�rb�� date_time� )rE r �fstat�fileno�readr r% �st_mtime�stat�S_IMODE�st_mode�S_IFMT� external_attrr, r� �writestr)rO rm r� r� �f�st�data�zinfor r r r{ � s �� zWheelFile.write�zinfo_or_arcnamer� �SizedBuffer | strc C s� t |t�rt|t� d�}| j|_dtjB d> |_t |t�r"|� d�}t � | |||� t |t�r2|j n|}t �d|� d�� || jkr_| �|�}|jt|�� ��d�f| j|< t|�| j|< d S d S )Nr� i� r� r1 zadding 'r_ r7 )rl ro r r% r, r� r� �S_IFREGr� rN r r� rm r rp rB �_default_algorithmr� r rb �decoderC �lenrD )rO r� r� r� �fname�hash_r r r r� � s* � �� ��zWheelFile.writestrc s� � j d ur<� jdkr<� jr<t� }tj|dddd�}|�� fdd�� j�� D �� |�t � j �ddf� � � � j |� � � t �� � d S ) N�w�,�"� )� delimiter� quotechar�lineterminatorc 3 s0 � | ]\}\}}||d | � j | fV qdS )r4 N)rD )�.0r� rT r� �rO r r � <genexpr>� s � � �z"WheelFile.close.<locals>.<genexpr>r0 )�fpr* rC r rG �writer� writerows�items�writerowr? rB r� �getvaluer �close)rO r� r� r r� r r� � s ��zWheelFile.close)r( r) r* r+ r, r )r' N)rU rV r* rW rX rY rZ r[ )rn ro r/ )rm ro r� r� r� r� rZ r^ �N)r� rV r� r� r� r� )r r r �__doc__rJ �sha256r� r r> rE r� r{ r� r� r r r r r& , s �= � " � � r& r� )r r ))� __future__r rG rJ �os.pathr �rer� r! �ior r �typingr r r �zipfiler r r � wheel.clir � wheel.utilr r r r r r �typing_extensionsr ro �PathLiker) r �compile�VERBOSEr: r# r% r& r r r r �<module> s0 � _vendor/wheel/vendored/__pycache__/__init__.cpython-310.pyc 0000644 00000000272 15030122015 0017550 0 ustar 00 o �h � @ s d S )N� r r r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/__init__.py�<module> s _vendor/wheel/vendored/vendor.txt 0000644 00000000020 15030122015 0013125 0 ustar 00 packaging==24.0 _vendor/wheel/vendored/packaging/requirements.py 0000644 00000005565 15030122015 0016133 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from typing import Any, Iterator, Optional, Set from ._parser import parse_requirement as _parse_requirement from ._tokenizer import ParserSyntaxError from .markers import Marker, _normalize_extra_values from .specifiers import SpecifierSet from .utils import canonicalize_name class InvalidRequirement(ValueError): """ An invalid requirement was found, users should refer to PEP 508. """ class Requirement: """Parse a requirement. Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. """ # TODO: Can we test whether something is contained within a requirement? # If so how do we do that? Do we need to test against the _name_ of # the thing as well as the version? What about the markers? # TODO: Can we normalize the name and extra name? def __init__(self, requirement_string: str) -> None: try: parsed = _parse_requirement(requirement_string) except ParserSyntaxError as e: raise InvalidRequirement(str(e)) from e self.name: str = parsed.name self.url: Optional[str] = parsed.url or None self.extras: Set[str] = set(parsed.extras or []) self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) self.marker: Optional[Marker] = None if parsed.marker is not None: self.marker = Marker.__new__(Marker) self.marker._markers = _normalize_extra_values(parsed.marker) def _iter_parts(self, name: str) -> Iterator[str]: yield name if self.extras: formatted_extras = ",".join(sorted(self.extras)) yield f"[{formatted_extras}]" if self.specifier: yield str(self.specifier) if self.url: yield f"@ {self.url}" if self.marker: yield " " if self.marker: yield f"; {self.marker}" def __str__(self) -> str: return "".join(self._iter_parts(self.name)) def __repr__(self) -> str: return f"<Requirement('{self}')>" def __hash__(self) -> int: return hash( ( self.__class__.__name__, *self._iter_parts(canonicalize_name(self.name)), ) ) def __eq__(self, other: Any) -> bool: if not isinstance(other, Requirement): return NotImplemented return ( canonicalize_name(self.name) == canonicalize_name(other.name) and self.extras == other.extras and self.specifier == other.specifier and self.url == other.url and self.marker == other.marker ) _vendor/wheel/vendored/packaging/markers.py 0000644 00000020050 15030122015 0015036 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. import operator import os import platform import sys from typing import Any, Callable, Dict, List, Optional, Tuple, Union from ._parser import ( MarkerAtom, MarkerList, Op, Value, Variable, ) from ._parser import ( parse_marker as _parse_marker, ) from ._tokenizer import ParserSyntaxError from .specifiers import InvalidSpecifier, Specifier from .utils import canonicalize_name __all__ = [ "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName", "Marker", "default_environment", ] Operator = Callable[[str, str], bool] class InvalidMarker(ValueError): """ An invalid marker was found, users should refer to PEP 508. """ class UndefinedComparison(ValueError): """ An invalid operation was attempted on a value that doesn't support it. """ class UndefinedEnvironmentName(ValueError): """ A name was attempted to be used that does not exist inside of the environment. """ def _normalize_extra_values(results: Any) -> Any: """ Normalize extra values. """ if isinstance(results[0], tuple): lhs, op, rhs = results[0] if isinstance(lhs, Variable) and lhs.value == "extra": normalized_extra = canonicalize_name(rhs.value) rhs = Value(normalized_extra) elif isinstance(rhs, Variable) and rhs.value == "extra": normalized_extra = canonicalize_name(lhs.value) lhs = Value(normalized_extra) results[0] = lhs, op, rhs return results def _format_marker( marker: Union[List[str], MarkerAtom, str], first: Optional[bool] = True ) -> str: assert isinstance(marker, (list, tuple, str)) # Sometimes we have a structure like [[...]] which is a single item list # where the single item is itself it's own list. In that case we want skip # the rest of this function so that we don't get extraneous () on the # outside. if ( isinstance(marker, list) and len(marker) == 1 and isinstance(marker[0], (list, tuple)) ): return _format_marker(marker[0]) if isinstance(marker, list): inner = (_format_marker(m, first=False) for m in marker) if first: return " ".join(inner) else: return "(" + " ".join(inner) + ")" elif isinstance(marker, tuple): return " ".join([m.serialize() for m in marker]) else: return marker _operators: Dict[str, Operator] = { "in": lambda lhs, rhs: lhs in rhs, "not in": lambda lhs, rhs: lhs not in rhs, "<": operator.lt, "<=": operator.le, "==": operator.eq, "!=": operator.ne, ">=": operator.ge, ">": operator.gt, } def _eval_op(lhs: str, op: Op, rhs: str) -> bool: try: spec = Specifier("".join([op.serialize(), rhs])) except InvalidSpecifier: pass else: return spec.contains(lhs, prereleases=True) oper: Optional[Operator] = _operators.get(op.serialize()) if oper is None: raise UndefinedComparison(f"Undefined {op!r} on {lhs!r} and {rhs!r}.") return oper(lhs, rhs) def _normalize(*values: str, key: str) -> Tuple[str, ...]: # PEP 685 – Comparison of extra names for optional distribution dependencies # https://peps.python.org/pep-0685/ # > When comparing extra names, tools MUST normalize the names being # > compared using the semantics outlined in PEP 503 for names if key == "extra": return tuple(canonicalize_name(v) for v in values) # other environment markers don't have such standards return values def _evaluate_markers(markers: MarkerList, environment: Dict[str, str]) -> bool: groups: List[List[bool]] = [[]] for marker in markers: assert isinstance(marker, (list, tuple, str)) if isinstance(marker, list): groups[-1].append(_evaluate_markers(marker, environment)) elif isinstance(marker, tuple): lhs, op, rhs = marker if isinstance(lhs, Variable): environment_key = lhs.value lhs_value = environment[environment_key] rhs_value = rhs.value else: lhs_value = lhs.value environment_key = rhs.value rhs_value = environment[environment_key] lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key) groups[-1].append(_eval_op(lhs_value, op, rhs_value)) else: assert marker in ["and", "or"] if marker == "or": groups.append([]) return any(all(item) for item in groups) def format_full_version(info: "sys._version_info") -> str: version = "{0.major}.{0.minor}.{0.micro}".format(info) kind = info.releaselevel if kind != "final": version += kind[0] + str(info.serial) return version def default_environment() -> Dict[str, str]: iver = format_full_version(sys.implementation.version) implementation_name = sys.implementation.name return { "implementation_name": implementation_name, "implementation_version": iver, "os_name": os.name, "platform_machine": platform.machine(), "platform_release": platform.release(), "platform_system": platform.system(), "platform_version": platform.version(), "python_full_version": platform.python_version(), "platform_python_implementation": platform.python_implementation(), "python_version": ".".join(platform.python_version_tuple()[:2]), "sys_platform": sys.platform, } class Marker: def __init__(self, marker: str) -> None: # Note: We create a Marker object without calling this constructor in # packaging.requirements.Requirement. If any additional logic is # added here, make sure to mirror/adapt Requirement. try: self._markers = _normalize_extra_values(_parse_marker(marker)) # The attribute `_markers` can be described in terms of a recursive type: # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]] # # For example, the following expression: # python_version > "3.6" or (python_version == "3.6" and os_name == "unix") # # is parsed into: # [ # (<Variable('python_version')>, <Op('>')>, <Value('3.6')>), # 'and', # [ # (<Variable('python_version')>, <Op('==')>, <Value('3.6')>), # 'or', # (<Variable('os_name')>, <Op('==')>, <Value('unix')>) # ] # ] except ParserSyntaxError as e: raise InvalidMarker(str(e)) from e def __str__(self) -> str: return _format_marker(self._markers) def __repr__(self) -> str: return f"<Marker('{self}')>" def __hash__(self) -> int: return hash((self.__class__.__name__, str(self))) def __eq__(self, other: Any) -> bool: if not isinstance(other, Marker): return NotImplemented return str(self) == str(other) def evaluate(self, environment: Optional[Dict[str, str]] = None) -> bool: """Evaluate a marker. Return the boolean from evaluating the given marker against the environment. environment is an optional argument to override all or part of the determined environment. The environment is determined from the current Python process. """ current_environment = default_environment() current_environment["extra"] = "" if environment is not None: current_environment.update(environment) # The API used to allow setting extra to None. We need to handle this # case for backwards compatibility. if current_environment["extra"] is None: current_environment["extra"] = "" return _evaluate_markers(self._markers, current_environment) _vendor/wheel/vendored/packaging/_manylinux.py 0000644 00000022564 15030122015 0015571 0 ustar 00 import collections import contextlib import functools import os import re import sys import warnings from typing import Dict, Generator, Iterator, NamedTuple, Optional, Sequence, Tuple from ._elffile import EIClass, EIData, ELFFile, EMachine EF_ARM_ABIMASK = 0xFF000000 EF_ARM_ABI_VER5 = 0x05000000 EF_ARM_ABI_FLOAT_HARD = 0x00000400 # `os.PathLike` not a generic type until Python 3.9, so sticking with `str` # as the type for `path` until then. @contextlib.contextmanager def _parse_elf(path: str) -> Generator[Optional[ELFFile], None, None]: try: with open(path, "rb") as f: yield ELFFile(f) except (OSError, TypeError, ValueError): yield None def _is_linux_armhf(executable: str) -> bool: # hard-float ABI can be detected from the ELF header of the running # process # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf with _parse_elf(executable) as f: return ( f is not None and f.capacity == EIClass.C32 and f.encoding == EIData.Lsb and f.machine == EMachine.Arm and f.flags & EF_ARM_ABIMASK == EF_ARM_ABI_VER5 and f.flags & EF_ARM_ABI_FLOAT_HARD == EF_ARM_ABI_FLOAT_HARD ) def _is_linux_i686(executable: str) -> bool: with _parse_elf(executable) as f: return ( f is not None and f.capacity == EIClass.C32 and f.encoding == EIData.Lsb and f.machine == EMachine.I386 ) def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool: if "armv7l" in archs: return _is_linux_armhf(executable) if "i686" in archs: return _is_linux_i686(executable) allowed_archs = { "x86_64", "aarch64", "ppc64", "ppc64le", "s390x", "loongarch64", "riscv64", } return any(arch in allowed_archs for arch in archs) # If glibc ever changes its major version, we need to know what the last # minor version was, so we can build the complete list of all versions. # For now, guess what the highest minor version might be, assume it will # be 50 for testing. Once this actually happens, update the dictionary # with the actual value. _LAST_GLIBC_MINOR: Dict[int, int] = collections.defaultdict(lambda: 50) class _GLibCVersion(NamedTuple): major: int minor: int def _glibc_version_string_confstr() -> Optional[str]: """ Primary implementation of glibc_version_string using os.confstr. """ # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely # to be broken or missing. This strategy is used in the standard library # platform module. # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183 try: # Should be a string like "glibc 2.17". version_string: Optional[str] = os.confstr("CS_GNU_LIBC_VERSION") assert version_string is not None _, version = version_string.rsplit() except (AssertionError, AttributeError, OSError, ValueError): # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... return None return version def _glibc_version_string_ctypes() -> Optional[str]: """ Fallback implementation of glibc_version_string using ctypes. """ try: import ctypes except ImportError: return None # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen # manpage says, "If filename is NULL, then the returned handle is for the # main program". This way we can let the linker do the work to figure out # which libc our process is actually using. # # We must also handle the special case where the executable is not a # dynamically linked executable. This can occur when using musl libc, # for example. In this situation, dlopen() will error, leading to an # OSError. Interestingly, at least in the case of musl, there is no # errno set on the OSError. The single string argument used to construct # OSError comes from libc itself and is therefore not portable to # hard code here. In any case, failure to call dlopen() means we # can proceed, so we bail on our attempt. try: process_namespace = ctypes.CDLL(None) except OSError: return None try: gnu_get_libc_version = process_namespace.gnu_get_libc_version except AttributeError: # Symbol doesn't exist -> therefore, we are not linked to # glibc. return None # Call gnu_get_libc_version, which returns a string like "2.5" gnu_get_libc_version.restype = ctypes.c_char_p version_str: str = gnu_get_libc_version() # py2 / py3 compatibility: if not isinstance(version_str, str): version_str = version_str.decode("ascii") return version_str def _glibc_version_string() -> Optional[str]: """Returns glibc version string, or None if not using glibc.""" return _glibc_version_string_confstr() or _glibc_version_string_ctypes() def _parse_glibc_version(version_str: str) -> Tuple[int, int]: """Parse glibc version. We use a regexp instead of str.split because we want to discard any random junk that might come after the minor version -- this might happen in patched/forked versions of glibc (e.g. Linaro's version of glibc uses version strings like "2.20-2014.11"). See gh-3588. """ m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str) if not m: warnings.warn( f"Expected glibc version with 2 components major.minor," f" got: {version_str}", RuntimeWarning, ) return -1, -1 return int(m.group("major")), int(m.group("minor")) @functools.lru_cache def _get_glibc_version() -> Tuple[int, int]: version_str = _glibc_version_string() if version_str is None: return (-1, -1) return _parse_glibc_version(version_str) # From PEP 513, PEP 600 def _is_compatible(arch: str, version: _GLibCVersion) -> bool: sys_glibc = _get_glibc_version() if sys_glibc < version: return False # Check for presence of _manylinux module. try: import _manylinux except ImportError: return True if hasattr(_manylinux, "manylinux_compatible"): result = _manylinux.manylinux_compatible(version[0], version[1], arch) if result is not None: return bool(result) return True if version == _GLibCVersion(2, 5): if hasattr(_manylinux, "manylinux1_compatible"): return bool(_manylinux.manylinux1_compatible) if version == _GLibCVersion(2, 12): if hasattr(_manylinux, "manylinux2010_compatible"): return bool(_manylinux.manylinux2010_compatible) if version == _GLibCVersion(2, 17): if hasattr(_manylinux, "manylinux2014_compatible"): return bool(_manylinux.manylinux2014_compatible) return True _LEGACY_MANYLINUX_MAP = { # CentOS 7 w/ glibc 2.17 (PEP 599) (2, 17): "manylinux2014", # CentOS 6 w/ glibc 2.12 (PEP 571) (2, 12): "manylinux2010", # CentOS 5 w/ glibc 2.5 (PEP 513) (2, 5): "manylinux1", } def platform_tags(archs: Sequence[str]) -> Iterator[str]: """Generate manylinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be manylinux-compatible. :returns: An iterator of compatible manylinux tags. """ if not _have_compatible_abi(sys.executable, archs): return # Oldest glibc to be supported regardless of architecture is (2, 17). too_old_glibc2 = _GLibCVersion(2, 16) if set(archs) & {"x86_64", "i686"}: # On x86/i686 also oldest glibc to be supported is (2, 5). too_old_glibc2 = _GLibCVersion(2, 4) current_glibc = _GLibCVersion(*_get_glibc_version()) glibc_max_list = [current_glibc] # We can assume compatibility across glibc major versions. # https://sourceware.org/bugzilla/show_bug.cgi?id=24636 # # Build a list of maximum glibc versions so that we can # output the canonical list of all glibc from current_glibc # down to too_old_glibc2, including all intermediary versions. for glibc_major in range(current_glibc.major - 1, 1, -1): glibc_minor = _LAST_GLIBC_MINOR[glibc_major] glibc_max_list.append(_GLibCVersion(glibc_major, glibc_minor)) for arch in archs: for glibc_max in glibc_max_list: if glibc_max.major == too_old_glibc2.major: min_minor = too_old_glibc2.minor else: # For other glibc major versions oldest supported is (x, 0). min_minor = -1 for glibc_minor in range(glibc_max.minor, min_minor, -1): glibc_version = _GLibCVersion(glibc_max.major, glibc_minor) tag = "manylinux_{}_{}".format(*glibc_version) if _is_compatible(arch, glibc_version): yield f"{tag}_{arch}" # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags. if glibc_version in _LEGACY_MANYLINUX_MAP: legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version] if _is_compatible(arch, glibc_version): yield f"{legacy_tag}_{arch}" _vendor/wheel/vendored/packaging/LICENSE.BSD 0000644 00000002500 15030122015 0014434 0 ustar 00 Copyright (c) Donald Stufft and individual contributors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. _vendor/wheel/vendored/packaging/_parser.py 0000644 00000024153 15030122015 0015035 0 ustar 00 """Handwritten parser of dependency specifiers. The docstring for each __parse_* function contains EBNF-inspired grammar representing the implementation. """ import ast from typing import Any, List, NamedTuple, Optional, Tuple, Union from ._tokenizer import DEFAULT_RULES, Tokenizer class Node: def __init__(self, value: str) -> None: self.value = value def __str__(self) -> str: return self.value def __repr__(self) -> str: return f"<{self.__class__.__name__}('{self}')>" def serialize(self) -> str: raise NotImplementedError class Variable(Node): def serialize(self) -> str: return str(self) class Value(Node): def serialize(self) -> str: return f'"{self}"' class Op(Node): def serialize(self) -> str: return str(self) MarkerVar = Union[Variable, Value] MarkerItem = Tuple[MarkerVar, Op, MarkerVar] # MarkerAtom = Union[MarkerItem, List["MarkerAtom"]] # MarkerList = List[Union["MarkerList", MarkerAtom, str]] # mypy does not support recursive type definition # https://github.com/python/mypy/issues/731 MarkerAtom = Any MarkerList = List[Any] class ParsedRequirement(NamedTuple): name: str url: str extras: List[str] specifier: str marker: Optional[MarkerList] # -------------------------------------------------------------------------------------- # Recursive descent parser for dependency specifier # -------------------------------------------------------------------------------------- def parse_requirement(source: str) -> ParsedRequirement: return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES)) def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement: """ requirement = WS? IDENTIFIER WS? extras WS? requirement_details """ tokenizer.consume("WS") name_token = tokenizer.expect( "IDENTIFIER", expected="package name at the start of dependency specifier" ) name = name_token.text tokenizer.consume("WS") extras = _parse_extras(tokenizer) tokenizer.consume("WS") url, specifier, marker = _parse_requirement_details(tokenizer) tokenizer.expect("END", expected="end of dependency specifier") return ParsedRequirement(name, url, extras, specifier, marker) def _parse_requirement_details( tokenizer: Tokenizer, ) -> Tuple[str, str, Optional[MarkerList]]: """ requirement_details = AT URL (WS requirement_marker?)? | specifier WS? (requirement_marker)? """ specifier = "" url = "" marker = None if tokenizer.check("AT"): tokenizer.read() tokenizer.consume("WS") url_start = tokenizer.position url = tokenizer.expect("URL", expected="URL after @").text if tokenizer.check("END", peek=True): return (url, specifier, marker) tokenizer.expect("WS", expected="whitespace after URL") # The input might end after whitespace. if tokenizer.check("END", peek=True): return (url, specifier, marker) marker = _parse_requirement_marker( tokenizer, span_start=url_start, after="URL and whitespace" ) else: specifier_start = tokenizer.position specifier = _parse_specifier(tokenizer) tokenizer.consume("WS") if tokenizer.check("END", peek=True): return (url, specifier, marker) marker = _parse_requirement_marker( tokenizer, span_start=specifier_start, after=( "version specifier" if specifier else "name and no valid version specifier" ), ) return (url, specifier, marker) def _parse_requirement_marker( tokenizer: Tokenizer, *, span_start: int, after: str ) -> MarkerList: """ requirement_marker = SEMICOLON marker WS? """ if not tokenizer.check("SEMICOLON"): tokenizer.raise_syntax_error( f"Expected end or semicolon (after {after})", span_start=span_start, ) tokenizer.read() marker = _parse_marker(tokenizer) tokenizer.consume("WS") return marker def _parse_extras(tokenizer: Tokenizer) -> List[str]: """ extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? """ if not tokenizer.check("LEFT_BRACKET", peek=True): return [] with tokenizer.enclosing_tokens( "LEFT_BRACKET", "RIGHT_BRACKET", around="extras", ): tokenizer.consume("WS") extras = _parse_extras_list(tokenizer) tokenizer.consume("WS") return extras def _parse_extras_list(tokenizer: Tokenizer) -> List[str]: """ extras_list = identifier (wsp* ',' wsp* identifier)* """ extras: List[str] = [] if not tokenizer.check("IDENTIFIER"): return extras extras.append(tokenizer.read().text) while True: tokenizer.consume("WS") if tokenizer.check("IDENTIFIER", peek=True): tokenizer.raise_syntax_error("Expected comma between extra names") elif not tokenizer.check("COMMA"): break tokenizer.read() tokenizer.consume("WS") extra_token = tokenizer.expect("IDENTIFIER", expected="extra name after comma") extras.append(extra_token.text) return extras def _parse_specifier(tokenizer: Tokenizer) -> str: """ specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS | WS? version_many WS? """ with tokenizer.enclosing_tokens( "LEFT_PARENTHESIS", "RIGHT_PARENTHESIS", around="version specifier", ): tokenizer.consume("WS") parsed_specifiers = _parse_version_many(tokenizer) tokenizer.consume("WS") return parsed_specifiers def _parse_version_many(tokenizer: Tokenizer) -> str: """ version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? """ parsed_specifiers = "" while tokenizer.check("SPECIFIER"): span_start = tokenizer.position parsed_specifiers += tokenizer.read().text if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True): tokenizer.raise_syntax_error( ".* suffix can only be used with `==` or `!=` operators", span_start=span_start, span_end=tokenizer.position + 1, ) if tokenizer.check("VERSION_LOCAL_LABEL_TRAIL", peek=True): tokenizer.raise_syntax_error( "Local version label can only be used with `==` or `!=` operators", span_start=span_start, span_end=tokenizer.position, ) tokenizer.consume("WS") if not tokenizer.check("COMMA"): break parsed_specifiers += tokenizer.read().text tokenizer.consume("WS") return parsed_specifiers # -------------------------------------------------------------------------------------- # Recursive descent parser for marker expression # -------------------------------------------------------------------------------------- def parse_marker(source: str) -> MarkerList: return _parse_full_marker(Tokenizer(source, rules=DEFAULT_RULES)) def _parse_full_marker(tokenizer: Tokenizer) -> MarkerList: retval = _parse_marker(tokenizer) tokenizer.expect("END", expected="end of marker expression") return retval def _parse_marker(tokenizer: Tokenizer) -> MarkerList: """ marker = marker_atom (BOOLOP marker_atom)+ """ expression = [_parse_marker_atom(tokenizer)] while tokenizer.check("BOOLOP"): token = tokenizer.read() expr_right = _parse_marker_atom(tokenizer) expression.extend((token.text, expr_right)) return expression def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom: """ marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? | WS? marker_item WS? """ tokenizer.consume("WS") if tokenizer.check("LEFT_PARENTHESIS", peek=True): with tokenizer.enclosing_tokens( "LEFT_PARENTHESIS", "RIGHT_PARENTHESIS", around="marker expression", ): tokenizer.consume("WS") marker: MarkerAtom = _parse_marker(tokenizer) tokenizer.consume("WS") else: marker = _parse_marker_item(tokenizer) tokenizer.consume("WS") return marker def _parse_marker_item(tokenizer: Tokenizer) -> MarkerItem: """ marker_item = WS? marker_var WS? marker_op WS? marker_var WS? """ tokenizer.consume("WS") marker_var_left = _parse_marker_var(tokenizer) tokenizer.consume("WS") marker_op = _parse_marker_op(tokenizer) tokenizer.consume("WS") marker_var_right = _parse_marker_var(tokenizer) tokenizer.consume("WS") return (marker_var_left, marker_op, marker_var_right) def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar: """ marker_var = VARIABLE | QUOTED_STRING """ if tokenizer.check("VARIABLE"): return process_env_var(tokenizer.read().text.replace(".", "_")) elif tokenizer.check("QUOTED_STRING"): return process_python_str(tokenizer.read().text) else: tokenizer.raise_syntax_error( message="Expected a marker variable or quoted string" ) def process_env_var(env_var: str) -> Variable: if env_var in ("platform_python_implementation", "python_implementation"): return Variable("platform_python_implementation") else: return Variable(env_var) def process_python_str(python_str: str) -> Value: value = ast.literal_eval(python_str) return Value(str(value)) def _parse_marker_op(tokenizer: Tokenizer) -> Op: """ marker_op = IN | NOT IN | OP """ if tokenizer.check("IN"): tokenizer.read() return Op("in") elif tokenizer.check("NOT"): tokenizer.read() tokenizer.expect("WS", expected="whitespace after 'not'") tokenizer.expect("IN", expected="'in' after 'not'") return Op("not in") elif tokenizer.check("OP"): return Op(tokenizer.read().text) else: return tokenizer.raise_syntax_error( "Expected marker operator, one of " "<=, <, !=, ==, >=, >, ~=, ===, in, not in" ) _vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-310.pyc 0000644 00000021412 15030122015 0021367 0 ustar 00 o �hk( � @ s d Z ddlZddlmZmZmZmZmZmZ ddl m Z m Z G dd� d�Z G dd � d e �Z G d d � d e �ZG d d � d e �Zee ef Zeeeef ZeZee ZG dd� de�Zdedefdd�Zde defdd�Zde deeeee f fdd�Zde dededefdd �Zde dee fd d �Zde dee fd d �Z de defd!d"�Z de defd#d$�Z dedefd%d&�Z de defd'd(�Z de defd)d*�Z!de defd+d,�Z"de defd-d.�Z#de defd/d0�Z$d1ede fd2d3�Z%d4edefd5d6�Z&de defd7d8�Z'dS )9z�Handwritten parser of dependency specifiers. The docstring for each __parse_* function contains EBNF-inspired grammar representing the implementation. � N)�Any�List� NamedTuple�Optional�Tuple�Union� )� DEFAULT_RULES� Tokenizerc @ sH e Zd Zdeddfdd�Zdefdd�Zdefdd �Zdefd d �ZdS ) �Node�value�returnNc C s || _ d S �N�r )�selfr � r �f/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py�__init__ s z Node.__init__c C s | j S r r �r r r r �__str__ s z Node.__str__c C s d| j j� d| � d�S )N�<z('z')>)� __class__�__name__r r r r �__repr__ s z Node.__repr__c C s t �r )�NotImplementedErrorr r r r � serialize s zNode.serialize)r � __module__� __qualname__�strr r r r r r r r r s r c @ � e Zd Zdefdd�ZdS )�Variabler c C � t | �S r �r r r r r r � zVariable.serializeN�r r r r r r r r r r � r c @ r )�Valuer c C s d| � d�S )N�"r r r r r r ! s zValue.serializeNr$ r r r r r& r% r& c @ r )�Opr c C r! r r" r r r r r & r# z Op.serializeNr$ r r r r r( % r% r( c @ s> e Zd ZU eed< eed< ee ed< eed< ee ed< dS )�ParsedRequirement�name�url�extras� specifier�markerN)r r r r �__annotations__r r � MarkerListr r r r r) 4 s r) �sourcer c C � t t| td��S �N)�rules)�_parse_requirementr r �r1 r r r �parse_requirement? � r7 � tokenizerc C sf | � d� | jddd�}|j}| � d� t| �}| � d� t| �\}}}| jddd� t|||||�S )zI requirement = WS? IDENTIFIER WS? extras WS? requirement_details �WS� IDENTIFIERz1package name at the start of dependency specifier��expected�ENDzend of dependency specifier)�consume�expect�text� _parse_extras�_parse_requirement_detailsr) )r9 � name_tokenr* r, r+ r- r. r r r r5 C s � r5 c C s� d}d}d}| � d�rF| �� | �d� | j}| jddd�j}| j dd d �r+|||fS | jdd d� | j dd d �r>|||fS t| |d d �}n#| j}t| �}| �d� | j dd d �r^|||fS t| ||redndd �}|||fS )z~ requirement_details = AT URL (WS requirement_marker?)? | specifier WS? (requirement_marker)? � N�ATr: �URLz URL after @r< r> T��peekzwhitespace after URLzURL and whitespace)� span_start�after�version specifierz#name and no valid version specifier)�check�readr? �positionr@ rA �_parse_requirement_marker�_parse_specifier)r9 r- r+ r. � url_start�specifier_startr r r rC X s: � �� rC rJ rK c C s> | � d�s| jd|� d�|d� | �� t| �}| �d� |S )z3 requirement_marker = SEMICOLON marker WS? � SEMICOLONz!Expected end or semicolon (after �))rJ r: )rM �raise_syntax_errorrN � _parse_markerr? )r9 rJ rK r. r r r rP � s � rP c C sd | j ddd�s g S | jdddd�� | �d� t| �}| �d� W d � |S 1 s+w Y |S ) zG extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? � LEFT_BRACKETTrH � RIGHT_BRACKETr, ��aroundr: N)rM �enclosing_tokensr? �_parse_extras_list)r9 r, r r r rB � s � � � rB c C s� g }| � d�s |S |�| �� j� | �d� | j ddd�r$| �d� n| � d�s, |S | �� | �d� | jddd�}|�|j� q) z> extras_list = identifier (wsp* ',' wsp* identifier)* r; Tr: rH z"Expected comma between extra names�COMMAzextra name after commar< )rM �appendrN rA r? rV r@ )r9 r, � extra_tokenr r r r] � s � �r] c C sR | j dddd�� | �d� t| �}| �d� W d � |S 1 s"w Y |S )zr specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS | WS? version_many WS? �LEFT_PARENTHESIS�RIGHT_PARENTHESISrL rZ r: N)r\ r? �_parse_version_many)r9 �parsed_specifiersr r r rQ � s � � � rQ c C s� d}| � d�rQ| j}|| �� j7 }| j ddd�r#| jd|| jd d� | j d dd�r3| jd || jd� | �d � | � d �s@ |S || �� j7 }| �d � | � d�s|S ) z@ version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? rE � SPECIFIER�VERSION_PREFIX_TRAILTrH z6.* suffix can only be used with `==` or `!=` operatorsr )rJ �span_end�VERSION_LOCAL_LABEL_TRAILz@Local version label can only be used with `==` or `!=` operatorsr: r^ )rM rO rN rA rV r? )r9 rd rJ r r r rc � s0 �� � �rc c C r2 r3 )�_parse_full_markerr r r6 r r r � parse_marker� r8 rj c C s t | �}| jddd� |S )Nr> zend of marker expressionr< )rW r@ )r9 �retvalr r r ri s ri c C sB t | �g}| �d�r | �� }t | �}|�|j|f� | �d�s |S )z4 marker = marker_atom (BOOLOP marker_atom)+ �BOOLOP)�_parse_marker_atomrM rN �extendrA )r9 � expression�token� expr_rightr r r rW s �rW c C s| | � d� | jddd�r3| jdddd�� | � d� t| �}| � d� W d � n1 s-w Y nt| �}| � d� |S ) zw marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? | WS? marker_item WS? r: ra TrH rb zmarker expressionrZ N)r? rM r\ rW �_parse_marker_item)r9 r. r r r rm s � �� rm c C sJ | � d� t| �}| � d� t| �}| � d� t| �}| � d� |||fS )zG marker_item = WS? marker_var WS? marker_op WS? marker_var WS? r: )r? �_parse_marker_var�_parse_marker_op)r9 �marker_var_left� marker_op�marker_var_rightr r r rr * s rr c C sH | � d�rt| �� j�dd��S | � d�r t| �� j�S | jdd� dS )z/ marker_var = VARIABLE | QUOTED_STRING �VARIABLE�.�_� QUOTED_STRINGz+Expected a marker variable or quoted string)�messageN)rM �process_env_varrN rA �replace�process_python_strrV �r9 r r r rs 8 s �rs �env_varc C s | dv rt d�S t | �S )N)� platform_python_implementation�python_implementationr� )r )r� r r r r} F s r} � python_strc C s t �| �}tt|��S r )�ast� literal_evalr& r )r� r r r r r M s r c C sr | � d�r | �� td�S | � d�r(| �� | jddd� | jddd� td�S | � d �r4t| �� j�S | �d �S ) z& marker_op = IN | NOT IN | OP �IN�in�NOTr: zwhitespace after 'not'r< z'in' after 'not'znot in�OPzJExpected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in)rM rN r( r@ rA rV r� r r r rt R s �rt )(�__doc__r� �typingr r r r r r � _tokenizerr r r r r& r( � MarkerVar� MarkerItem� MarkerAtomr0 r) r r7 r5 rC �intrP rB r] rQ rc rj ri rW rm rr rs r} r rt r r r r �<module> sT � �3��� � _vendor/wheel/vendored/packaging/__pycache__/_manylinux.cpython-310.pyc 0000644 00000014433 15030122015 0022124 0 ustar 00 o �ht% � @ s� U d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZm Z m Z m Z m Z m Z mZ ddlmZmZmZmZ dZdZdZejded e e e ddf fd d ��Zd ed efd d�Zd ed efdd�Z d ede e d efdd�Z e � dd� �Z ee e f e!d< G dd� de �Z"d e e fdd�Z#d e e fdd �Z$d e e fd d �Z%d ed ee e f fd d!�Z&ej'd ee e f fd"d#��Z(d$ed%e"d efd&d'�Z)d(d)d*d+�Z*de e d e e fd,d-�Z+dS ).� N)�Dict� Generator�Iterator� NamedTuple�Optional�Sequence�Tuple� )�EIClass�EIData�ELFFile�EMachinel ~ i i �path�returnc c sb � z t | d��}t|�V W d � W d S 1 sw Y W d S tttfy0 d V Y d S w )N�rb)�openr �OSError� TypeError� ValueError)r �f� r �i/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py� _parse_elf s � &� �r � executablec C sv t | ��-}|d uo(|jtjko(|jtjko(|jtj ko(|j t @ t ko(|j t @ t k W d � S 1 s4w Y d S �N)r �capacityr �C32�encodingr �Lsb�machiner �Arm�flags�EF_ARM_ABIMASK�EF_ARM_ABI_VER5�EF_ARM_ABI_FLOAT_HARD�r r r r r �_is_linux_armhf s � � � � �$�r& c C sZ t | �� }|d uo|jtjko|jtjko|jtj k W d � S 1 s&w Y d S r ) r r r r r r r r r �I386r% r r r �_is_linux_i686+ s � � �$�r( �archsc s> d|v rt | �S d|v rt| �S h d�� t� fdd�|D ��S )N�armv7l�i686> �ppc64�s390x�x86_64�aarch64�ppc64le�riscv64� loongarch64c 3 s � | ]}|� v V qd S r r )�.0�arch�� allowed_archsr r � <genexpr>C s � z'_have_compatible_abi.<locals>.<genexpr>)r& r( �any)r r) r r5 r �_have_compatible_abi5 s r9 c C s dS )N�2 r r r r r �<lambda>K s r; �_LAST_GLIBC_MINORc @ s e Zd ZU eed< eed< dS )� _GLibCVersion�major�minorN)�__name__� __module__� __qualname__�int�__annotations__r r r r r= N s r= c C sF zt �d�} | dus J �| �� \}}W |S ttttfy" Y dS w )zJ Primary implementation of glibc_version_string using os.confstr. �CS_GNU_LIBC_VERSIONN)�os�confstr�rsplit�AssertionError�AttributeErrorr r )�version_string�_�versionr r r � _glibc_version_string_confstrS s ��rN c C s� zddl } W n ty Y dS w z| �d�}W n ty" Y dS w z|j}W n ty2 Y dS w | j|_|� }t|t �sD|� d�}|S )zG Fallback implementation of glibc_version_string using ctypes. r N�ascii) �ctypes� ImportError�CDLLr �gnu_get_libc_versionrJ �c_char_p�restype� isinstance�str�decode)rP �process_namespacerS � version_strr r r � _glibc_version_string_ctypesf s( � � � r[ c C s t � pt� S )z9Returns glibc version string, or None if not using glibc.)rN r[ r r r r �_glibc_version_string� s r\ rZ c C sB t �d| �}|st�d| � �t� dS t|�d��t|�d��fS )a3 Parse glibc version. We use a regexp instead of str.split because we want to discard any random junk that might come after the minor version -- this might happen in patched/forked versions of glibc (e.g. Linaro's version of glibc uses version strings like "2.20-2014.11"). See gh-3588. z$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z;Expected glibc version with 2 components major.minor, got: ����r^ r> r? )�re�match�warnings�warn�RuntimeWarningrC �group)rZ �mr r r �_parse_glibc_version� s �� rf c C s t � } | d u r dS t| �S )Nr] )r\ rf )rZ r r r �_get_glibc_version� s rg r4 rM c C s� t � }||k r dS zdd l}W n ty Y dS w t|d�r4|�|d |d | �}|d ur2t|�S dS |tdd�krEt|d�rEt|j�S |tdd �krVt|d �rVt|j�S |tdd �krgt|d �rgt|j �S dS ) NFr T�manylinux_compatibler � � �manylinux1_compatible� �manylinux2010_compatible� �manylinux2014_compatible) rg � _manylinuxrQ �hasattrrh �boolr= rk rm ro )r4 rM � sys_glibcrp �resultr r r �_is_compatible� s. � ru � manylinux2014� manylinux2010� manylinux1))ri rn )ri rl )ri rj c c s � t tj| �s dS tdd�}t| �ddh@ rtdd�}tt� � }|g}t|jd dd�D ]}t| }|� t||�� q,| D ]J}|D ]E}|j|jkrM|j }nd}t|j |d�D ]/}t|j|�} d j | � } t || �rp| � d |� �V | t v r�t | } t || �r�| � d |� �V qVqAq=dS ) a� Generate manylinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be manylinux-compatible. :returns: An iterator of compatible manylinux tags. Nri � r. r+ � r r^ zmanylinux_{}_{}rL )r9 �sysr r= �setrg �ranger> r< �appendr? �formatru �_LEGACY_MANYLINUX_MAP) r) �too_old_glibc2� current_glibc�glibc_max_list� glibc_major� glibc_minorr4 � glibc_max� min_minor� glibc_version�tag� legacy_tagr r r � platform_tags� s: � ����r� ),� collections� contextlib� functoolsrF r_ r{ ra �typingr r r r r r r �_elffiler r r r r" r# r$ �contextmanagerrW r rr r& r( r9 � defaultdictr< rC rD r= rN r[ r\ rf � lru_cacherg ru r� r� r r r r �<module> s> $" , � _vendor/wheel/vendored/packaging/__pycache__/markers.cpython-310.pyc 0000644 00000015402 15030122015 0021402 0 ustar 00 o �h( � @ s� U d dl Z d dlZd dlZd dlZd dlmZmZmZmZm Z m Z m Z ddl m Z mZmZmZmZ ddl mZ ddlmZ ddlmZmZ ddlmZ g d �Zee e ge f Z G d d � d e �Z G d d � d e �Z!G dd� de �Z"dedefdd�Z# d4de ee e e f de e de fdd�Z$dd� dd� e j%e j&e j'e j(e j)e j*d �Z+ee e f e,d < d e d ed e de fd!d"�Z-d#e d$e de e d%f fd&d'�Z.d(ed)ee e f de fd*d+�Z/d,d-de fd.d/�Z0dee e f fd0d1�Z1G d2d3� d3�Z2dS )5� N)�Any�Callable�Dict�List�Optional�Tuple�Union� )� MarkerAtom� MarkerList�Op�Value�Variable)� parse_marker)�ParserSyntaxError)�InvalidSpecifier� Specifier��canonicalize_name)� InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc @ � e Zd ZdZdS )r zE An invalid marker was found, users should refer to PEP 508. N��__name__� __module__� __qualname__�__doc__� r r �f/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.pyr $ � r c @ r )r zP An invalid operation was attempted on a value that doesn't support it. Nr r r r r! r * r" r c @ r )r z\ A name was attempted to be used that does not exist inside of the environment. Nr r r r r! r 0 r" r �results�returnc C s| t | d t�r<| d \}}}t |t�r"|jdkr"t|j�}t|�}nt |t�r5|jdkr5t|j�}t|�}|||f| d< | S )z! Normalize extra values. r �extra)� isinstance�tupler �valuer r )r# �lhs�op�rhs�normalized_extrar r r! �_normalize_extra_values7 s r- T�marker�firstc C s� t | tttf�s J �t | t�r$t| �dkr$t | d ttf�r$t| d �S t | t�r@dd� | D �}|r7d�|�S dd�|� d S t | t�rOd�dd � | D ��S | S ) Nr r c s s � | ] }t |d d�V qdS )F)r/ N)�_format_marker��.0�mr r r! � <genexpr>X s � z!_format_marker.<locals>.<genexpr>� �(�)c S s g | ]}|� � �qS r )� serializer1 r r r! � <listcomp>^ s z"_format_marker.<locals>.<listcomp>)r& �listr' �str�lenr0 �join)r. r/ �innerr r r! r0 G s � � r0 c C s | |v S �Nr �r) r+ r r r! �<lambda>d � rA c C s | |vS r? r r@ r r r! rA e rB )�inznot in�<z<=z==z!=z>=�>� _operatorsr) r* r+ c C sx z t d�|�� |g��}W n ty Y nw |j| dd�S t�|�� �}|d u r7td|�d| �d|�d���|| |�S )N� T)� prereleasesz Undefined z on z and �.)r r= r8 r �containsrF �getr )r) r* r+ �spec�operr r r! �_eval_opo s � rN �values�key.c G s | dkr t dd� |D ��S |S )Nr% c s � � | ]}t |�V qd S r? r )r2 �vr r r! r4 � � � z _normalize.<locals>.<genexpr>)r' )rP rO r r r! � _normalize~ s rT �markers� environmentc C s� g g}| D ]d}t |tttf�sJ �t |t�r!|d �t||�� qt |t�rZ|\}}}t |t�r;|j}|| }|j} n |j}|j}|| } t|| |d�\}} |d �t ||| �� q|dv s`J �|dkri|�g � qt dd� |D ��S )N���)rP )�and�orrY c s rQ r? )�all)r2 �itemr r r! r4 � rS z$_evaluate_markers.<locals>.<genexpr>) r& r: r' r; �append�_evaluate_markersr r( rT rN �any) rU rV �groupsr. r) r* r+ �environment_key� lhs_value� rhs_valuer r r! r] � s* �r] �infozsys._version_infoc C s2 d� | �}| j}|dkr||d t| j� 7 }|S )Nz {0.major}.{0.minor}.{0.micro}�finalr )�format� releaselevelr; �serial)rc �version�kindr r r! �format_full_version� s rj c C s^ t tjj�} tjj}|| tjt�� t�� t� � t�� t� � t� � d� t� � d d� �tjd� S )NrI � ) �implementation_name�implementation_version�os_name�platform_machine�platform_release�platform_system�platform_version�python_full_version� platform_python_implementation�python_version� sys_platform)rj �sys�implementationrh �name�os�platform�machine�release�systemru �python_implementationr= �python_version_tuple)�iverrl r r r! r � s �r c @ sz e Zd Zdeddfdd�Zdefdd�Zdefdd �Zdefd d �Zd e de fd d�Z dde e eef de fdd�ZdS )r r. r$ Nc C s< z t t|��| _W d S ty } ztt|��|�d }~ww r? )r- � _parse_marker�_markersr r r; )�selfr. �er r r! �__init__� s ��zMarker.__init__c C s t | j�S r? )r0 r� �r� r r r! �__str__� s zMarker.__str__c C s d| � d�S )Nz <Marker('z')>r r� r r r! �__repr__� s zMarker.__repr__c C s t | jjt| �f�S r? )�hash� __class__r r; r� r r r! �__hash__� s zMarker.__hash__�otherc C s t |t�stS t| �t|�kS r? )r& r �NotImplementedr; )r� r� r r r! �__eq__� s z Marker.__eq__rV c C s@ t � }d|d< |dur|�|� |d du rd|d< t| j|�S )a$ Evaluate a marker. Return the boolean from evaluating the given marker against the environment. environment is an optional argument to override all or part of the determined environment. The environment is determined from the current Python process. rG r% N)r �updater] r� )r� rV �current_environmentr r r! �evaluate� s zMarker.evaluater? )r r r r; r� r� r� �intr� r �boolr� r r r� r r r r! r � s $r )T)3�operatorrz r{ rw �typingr r r r r r r �_parserr r r r r r r� � _tokenizerr � specifiersr r �utilsr �__all__r; r� �Operator� ValueErrorr r r r- r0 �lt�le�eq�ne�ge�gtrF �__annotations__rN rT r] rj r r r r r r! �<module> sN $ ��� � � _vendor/wheel/vendored/packaging/__pycache__/_elffile.cpython-310.pyc 0000644 00000006366 15030122015 0021514 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlmZmZmZ G dd� de�Z G dd� dej �Z G dd � d ej �Z G d d � d ej �Z G d d � d �ZdS )a; ELF file parser. This provides a class ``ELFFile`` that parses an ELF executable in a similar interface to ``ZipFile``. Only the read interface is implemented. Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html � N)�IO�Optional�Tuplec @ s e Zd ZdS )� ELFInvalidN)�__name__� __module__� __qualname__� r r �g/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.pyr s r c @ � e Zd ZdZdZdS )�EIClass� � N)r r r �C32�C64r r r r r � r c @ r )�EIDatar r N)r r r �Lsb�Msbr r r r r r r c @ s e Zd ZdZdZdZdZdZdS )�EMachine� � �( �> � N)r r r �I386�S390�Arm�X8664�AArc64r r r r r s r c @ sV e Zd ZdZdee ddfdd�Zdedee df fd d �Z e de e fd d ��Z dS ) �ELFFilez. Representation of an ELF executable. �f�returnNc C s || _ z| �d�}W n tjy td��w t|d d� �}|dkr*td|����|d | _|d | _zddd d d �| j| jf \}| _| _ W n t y\ td | j� d | j� d���w z| �|�\ }| _ }}| _ }| _ }| _| _W d S tjy� } ztd�|�d }~ww )N�16Bz unable to parse identification� s ELFzinvalid magic: � )z <HHIIIIIHHHz <IIIIIIII�r r r$ )z >HHIIIIIHHHz >IIIIIIIIr& )z <HHIQQQIHHHz <IIQQQQQQ�r r r% )z >HHIQQQIHHHz >IIQQQQQQr' ))r r )r r )r r )r r zunrecognized capacity (z) or encoding (�)z/unable to parse machine and section information)�_f�_read�struct�errorr �bytes�capacity�encoding�_p_fmt�_p_idx�KeyError�machine�_e_phoff�flags� _e_phentsize�_e_phnum)�selfr! �ident�magic�e_fmt�_�er r r �__init__, sV � � � ��� � ��zELFFile.__init__�fmt.c C s t �|| j�t �|���S )N)r+ �unpackr) �read�calcsize)r8 r? r r r r* Z s z ELFFile._readc C s� t | j�D ]H}| j�| j| j| � z| �| j�}W n tj y% Y qw || j d dkr0q| j�|| j d � t � | j� || j d ���d� S dS )zH The path recorded in the ``PT_INTERP`` section header. r r r r � N)�ranger7 r) �seekr4 r6 r* r0 r+ r, r1 �os�fsdecoderA �strip)r8 �index�datar r r � interpreter] s �&zELFFile.interpreter)r r r �__doc__r r- r> �strr �intr* �propertyr rK r r r r r ' s .r )rL �enumrF r+ �typingr r r � ValueErrorr �IntEnumr r r r r r r r �<module> s _vendor/wheel/vendored/packaging/__pycache__/tags.cpython-310.pyc 0000644 00000032760 15030122015 0020702 0 ustar 00 o �hJ � @ sH U d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZ d dl m Z m Z m Z m Z mZmZmZmZmZmZ ddlmZmZ e �e�Zee Zeeef Z dddd d d �Z e e e f e d < e� d �dkZ!G dd� d�Z"de de e" fdd�Z#dLde de$deee df fdd�Z%de de fdd �Z&d ee de$fd d �Z'd ed!e$de$fd"d#�Z(dLd$ede$dee fd%d&�Z) dMdd'�d ee d ee e d(ee e de$de e" f d)d*�Z*dee fd+d,�Z+ dMdd'�d-ee d ee e d(ee e de$de e" f d.d/�Z,d$ede e fd0d1�Z- dMd ee d-ee d(ee e de e" fd2d3�Z.e!fd4e d5e$de fd6d7�Z/d8e d9e dee fd:d;�Z0 dNd8ee d4ee de e fd<d=�Z1e!fd5e$de e fd>d?�Z2de e fd@dA�Z3de e fdBdC�Z4de fdDdE�Z5dd'�de$de fdFdG�Z6d8ede fdHdI�Z7dd'�de$de e" fdJdK�Z8dS )O� N)�EXTENSION_SUFFIXES) �Dict� FrozenSet�Iterable�Iterator�List�Optional�Sequence�Tuple�Union�cast� )� _manylinux� _musllinux�py�cp�pp�ip�jy)�python�cpython�pypy� ironpython�jython�INTERPRETER_SHORT_NAMES�P� c @ s� e Zd ZdZg d�Zdedededdfdd �Zedefd d ��Zedefd d ��Z edefdd��Z de de fdd�Z defdd�Zdefdd�Zdefdd�ZdS )�Tagz� A representation of the tag triple for a wheel. Instances are considered immutable and thus are hashable. Equality checking is also supported. )� _interpreter�_abi� _platform�_hash� interpreter�abi�platform�returnNc C s8 |� � | _|� � | _|� � | _t| j| j| jf�| _d S �N)�lowerr r r �hashr! )�selfr" r# r$ � r* �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py�__init__7 s z Tag.__init__c C � | j S r& )r �r) r* r* r+ r" B � zTag.interpreterc C r- r& )r r. r* r* r+ r# F r/ zTag.abic C r- r& )r r. r* r* r+ r$ J r/ z Tag.platform�otherc C s> t |t�stS | j|jko | j|jko | j|jko | j|jkS r& )� isinstancer �NotImplementedr! r r r )r) r0 r* r* r+ �__eq__N s � � �z Tag.__eq__c C r- r& )r! r. r* r* r+ �__hash__Y s z Tag.__hash__c C s | j � d| j� d| j� �S )N�-)r r r r. r* r* r+ �__str__\ s z Tag.__str__c C s d| � dt | �� d�S )N�<z @ �>)�idr. r* r* r+ �__repr___ s z Tag.__repr__)�__name__� __module__� __qualname__�__doc__� __slots__�strr, �propertyr" r# r$ �object�boolr3 �intr4 r6 r: r* r* r* r+ r - s r �tagr% c C s` t � }| �d�\}}}|�d�D ]}|�d�D ]}|�d�D ] }|�t|||�� q qqt|�S )z� Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. Returning a set is required due to the possibility that the tag is a compressed tag set. r5 �.)�set�split�addr � frozenset)rE �tags� interpreters�abis� platformsr" r# � platform_r* r* r+ � parse_tagc s ��rP F�name�warnc C s& t �| �}|d u r|rt�d| � |S )Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)� sysconfig�get_config_var�logger�debug)rQ rR �valuer* r* r+ �_get_config_vars s �rX �stringc C s | � dd�� dd�� dd�S )NrF �_r5 � )�replace)rY r* r* r+ �_normalize_string| s r] rM c C s: t | �dkrdS t�d| d �}|sdS |�d�}d|v S )z� Determine if the ABI corresponds to a threaded (`--disable-gil`) build. The threaded builds are indicated by a "t" in the abiflags. r Fz cp\d+(.*)r �t)�len�re�match�group)rM �m�abiflagsr* r* r+ �_is_threaded_cpython� s re �python_version� threadingc C s t | �dkot| �dko| S )z� Determine if the Python version supports abi3. PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) builds do not support abi3. r )� � )r_ �tuple)rf rg r* r* r+ � _abi3_applies� s rk � py_versionc C s t | �} g }t| d d� �}d } } }}td|�}ttd�} dtv } |s.|d u r0| s.| r0d}| dkr;td|�r;d }| d k retd |�} | sJ| d u rLd }| d k rdtd|�} | dksb| d u rdtjdkrdd}n |rq|�d|� |� �� |�dd|� |� |� |� |� �� |S )Nri � �Py_DEBUG�gettotalrefcountz_d.pyd�d)rh � �Py_GIL_DISABLEDr^ )rh � � WITH_PYMALLOCrc )rh rh �Py_UNICODE_SIZEr i�� �ur r ) rj �_version_nodotrX �hasattr�sysr � maxunicode�append�insert) rl rR rM �versionrg rV �pymalloc�ucs4� with_debug� has_refcount�has_ext� with_pymalloc� unicode_sizer* r* r+ � _cpython_abis� s2 �"r� �rR rN c # sL � | s t jdd� } dt| dd� �� �� |du r't| �dkr%t| |�}ng }t|�}dD ]}z|�|� W q- ty? Y q-w t|pEt� �}|D ]}|D ] }t � ||�V qMqIt |�}t | |�}|ro� fdd�|D �E dH � fdd�|D �E dH |r�t | d d dd �D ] } |D ]}d j t| d | f�d �� t � d |�V q�q�dS dS )a Yields the tags for a CPython interpreter. The tags consist of: - cp<python_version>-<abi>-<platform> - cp<python_version>-abi3-<platform> - cp<python_version>-none-<platform> - cp<less than python_version>-abi3-<platform> # Older Python versions down to 3.2. If python_version only specifies a major version then user-provided ABIs and the 'none' ABItag will be used. If 'abi3' or 'none' are specified in 'abis' then they will be yielded at their normal position and not at the beginning. Nri r r )�abi3�nonec 3 � � | ] }t � d |�V qdS )r� N�r ��.0rO �r" r* r+ � <genexpr>� � � z cpython_tags.<locals>.<genexpr>c 3 r� )r� Nr� r� r� r* r+ r� � r� ���z cp{version}r �r} r� )ry � version_inforw r_ r� �list�remove� ValueError� platform_tagsr re rk �range�format) rf rM rN rR � explicit_abir# rO rg �use_abi3� minor_versionr* r� r+ � cpython_tags� sF � �� ���r� c C s� t ddd�} t| t�r| d dkrtd��| �d�}t|�dk r)ttjdd � �S |d }|� d �r<d |�d �d }n8|� d �rI|�d �d }n+|� d�r[d � |�d �dd � �}n|� d�rmd � |�d �dd� �}n|rr|}ng S t |�gS )z1 Return the ABI tag based on EXT_SUFFIX. � EXT_SUFFIXTr� r rF z.invalid sysconfig.get_config_var('EXT_SUFFIX')rh Nri r r r r5 r �graalpy) rX r1 r@ � SystemErrorrH r_ r� ry r� � startswith�joinr] )� ext_suffix�parts�soabir# r* r* r+ � _generic_abi� s& r� r" c c s� � | st � }t|d�}d�||g�} |du rt� }nt|�}t|p#t� �}d|vr.|�d� |D ]}|D ] }t| ||�V q4q0dS )z� Yields the tags for a generic interpreter. The tags consist of: - <interpreter>-<abi>-<platform> The "none" ABI will be added if it was not explicitly provided. r� rm Nr� )�interpreter_name�interpreter_versionr� r� r� r� r{ r )r" rM rN rR � interp_name�interp_versionr# rO r* r* r+ � generic_tags s � ��r� c c s| � t | �dkrdt| dd� �� �V d| d � �V t | �dkr:t| d d dd�D ]}dt| d |f�� �V q+dS dS )z� Yields Python versions in descending order. After the latest version, the major-only version will be yielded, and then all previous versions of that major version. r r Nri r r� )r_ rw r� )rl �minorr* r* r+ �_py_interpreter_range? s � �r� c c sz � | s t jdd� } t|pt� �}t| �D ]}|D ] }t|d|�V qq|r-t|dd�V t| �D ] }t|dd�V q1dS )z� Yields the sequence of tags that are compatible with a specific version of Python. The tags consist of: - py*-none-<platform> - <interpreter>-none-any # ... if `interpreter` is provided. - py*-none-any Nri r� �any)ry r� r� r� r� r )rf r" rN r} rO r* r* r+ �compatible_tagsN s � � �r� �arch�is_32bitc C s |s| S | � d�r dS dS )N�ppc�i386)r� )r� r� r* r* r+ � _mac_archg s r� r} �cpu_archc C s� |g}|dkr| dk r g S |� g d�� n7|dkr'| dk r g S |� g d�� n%|dkr;| dks3| dk r5g S |�d� n|d krL| d krEg S |� d d g� |d v rU|�d� |dv r^|�d� |S )N�x86_64)� r )�intel�fat64�fat32r� )r� r� �fat�ppc64)r� � r� r� )r� � r� r� > �arm64r� � universal2> r� r� r� r� r� � universal)�extendr{ )r} r� �formatsr* r* r+ �_mac_binary_formatsq s, r� c c s� � t �� \}}}| du rFtdttt|�d�dd� ���} | dkrEtjt j dddgd d d itj d d �j }tdttt|�d�dd� ���} n| } |du rQt |�}n|}d | kr}| dk r}t| d dd�D ]}d|f}t||�}|D ] }djd||d�V qpqc| dkr�t| d dd�D ]} | df}t||�}|D ] }dj| d|d�V q�q�| dkr�|dkr�tddd�D ] }d|f}t||�}|D ]}dj|d |d |d�V q�q�dS tddd�D ]}d|f}d}dj|d |d |d�V q�dS dS )aD Yields the platform tags for a macOS system. The `version` parameter is a two-item tuple specifying the macOS version to generate platform tags for. The `arch` parameter is the CPU architecture to generate platform tags for. Both parameters default to the appropriate value for the current system. N� MacVersionrF ri )r� � z-sSz-cz-import platform; print(platform.mac_ver()[0])T�SYSTEM_VERSION_COMPAT�0)�check�env�stdout�text)r� r )� r r r� r� z&macosx_{major}_{minor}_{binary_format})�majorr� � binary_formatr r� r� rh r� )r$ �mac_verr rj �maprD rH � subprocess�runry � executable�PIPEr� r� r� r� r� ) r} r� � version_strrZ r� r� �compat_version�binary_formatsr� � major_versionr* r* r+ � mac_platforms� s� � "�� �" � �� �� ��� ��r� c c s� � t t�� �}|�d�s|V d S | r |dkrd}n|dkr d}|�dd�\}}ddd gi�||g�}t�|�E d H t�|�E d H |D ]}d|� �V qEd S ) N�linux_� linux_x86_64� linux_i686� linux_aarch64� linux_armv8lrZ r �armv8l�armv7l) r] rS � get_platformr� rH �getr r� r )r� �linuxrZ r� �archsr* r* r+ �_linux_platforms� s" � �r� c c s � t t�� �V d S r& )r] rS r� r* r* r* r+ �_generic_platforms� s �r� c C s* t �� dkr t� S t �� dkrt� S t� S )z; Provides the platform tags for this installation. �Darwin�Linux)r$ �systemr� r� r� r* r* r* r+ r� s r� c C s t jj} t�| �p | S )z� Returns the name of the running interpreter. Some implementations have a reserved, two-letter abbreviation which will be returned when appropriate. )ry �implementationrQ r r� )rQ r* r* r+ r� s r� c C s2 t d| d�}|rt|�}|S ttjdd� �}|S )z9 Returns the version of the running interpreter. �py_version_nodotr� Nri )rX r@ rw ry r� )rR r} r* r* r+ r� s �r� c C s d� tt| ��S )Nrm )r� r� r@ r� r* r* r+ rw # s rw c c sl � t � }|dkrt| d�E dH nt� E dH |dkr d}n|dkr*dt| d� }nd}t|d�E dH dS )z� Returns the sequence of tag triples for the running interpreter. The order of the sequence corresponds to priority order for the interpreter, from most to least important. r r� Nr �pp3r� )r� r� r� r� r� )rR r� �interpr* r* r+ �sys_tags' s � r� )F)NNN)NN)9�loggingr$ r` �structr� ry rS �importlib.machineryr �typingr r r r r r r r r r rm r r � getLoggerr; rU rD � PythonVersionr� r r@ �__annotations__�calcsize�_32_BIT_INTERPRETERr rP rC rX r] re rk r� r� r� r� r� r� r� r� r� r� r� r� r� r� rw r� r* r* r* r+ �<module> s� 0 � 6" "��� � �� �<*��� � �� � ��� � � !��� �X _vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-310.pyc 0000644 00000013304 15030122015 0022106 0 ustar 00 o �h� � @ s( U d dl Z d dlZd dlmZ d dlmZmZmZmZm Z m Z ddl m Z eG dd� d��Z G dd � d e�Zi d d �d d �dd�dd�dd�dd�de�dej��dd�dd�d d �d d �d e�d!ej��d"e�e je j ejejB ��d#d$�d%d&�d'd(�d)d*�d+d,d-d.��Zd/ed0< G d1d2� d2�ZdS )3� N)� dataclass)�Dict�Iterator�NoReturn�Optional�Tuple�Union� )� Specifierc @ s& e Zd ZU eed< eed< eed< dS )�Token�name�text�positionN)�__name__� __module__� __qualname__�str�__annotations__�int� r r �i/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.pyr s r c sH e Zd ZdZdededeeef ddf� fdd� Zdefd d �Z� Z S ) �ParserSyntaxErrorz7The provided source text could not be parsed correctly.�message�source�span�returnNc s || _ || _|| _t� �� d S )N)r r r �super�__init__)�selfr r r �� __class__r r r s zParserSyntaxError.__init__c C s> d| j d d| j d | j d d }d�| j| j|g�S )N� r �~r �^z )r �joinr r )r �markerr r r �__str__ s *zParserSyntaxError.__str__) r r r �__doc__r r r r r& � __classcell__r r r r r s �� �� r �LEFT_PARENTHESISz\(�RIGHT_PARENTHESISz\)� LEFT_BRACKETz\[� RIGHT_BRACKETz\]� SEMICOLON�;�COMMA�,� QUOTED_STRINGzk ( ('[^']*') | ("[^"]*") ) �OPz(===|==|~=|!=|<=|>=|<|>)�BOOLOPz \b(or|and)\b�INz\bin\b�NOTz\bnot\b�VARIABLEa� \b( python_version |python_full_version |os[._]name |sys[._]platform |platform_(release|system) |platform[._](version|machine|python_implementation) |python_implementation |implementation_(name|version) |extra )\b � SPECIFIER�ATz\@�URLz[^ \t]+� IDENTIFIERz \b[a-zA-Z0-9][a-zA-Z0-9._-]*\b�VERSION_PREFIX_TRAILz\.\*z \+[a-z0-9]+(?:[-_\.][a-z0-9]+)*z[ \t]+�$)�VERSION_LOCAL_LABEL_TRAIL�WS�END�&Dict[str, Union[str, re.Pattern[str]]]� DEFAULT_RULESc @ s� e Zd ZdZdeddddfdd�Zd eddfd d �Zd d �d ededefdd�Zd edede fdd�Z de fdd�Z ddd�dede e de e defdd�Zejd ed ed eded fd d ��ZdS )!� Tokenizerz�Context-sensitive token parsing. Provides methods to examine the input stream to check whether the next token matches. r �rulesr@ r Nc C s* || _ dd� |�� D �| _d | _d| _d S )Nc S s i | ] \}}|t �|��qS r )�re�compile)�.0r �patternr r r � <dictcomp>f s �z&Tokenizer.__init__.<locals>.<dictcomp>r )r �itemsrC � next_tokenr )r r rC r r r r _ s � zTokenizer.__init__r c C s | � |�r | �� dS dS )z8Move beyond provided token name, if at current position.N)�check�read)r r r r r �consumel s �zTokenizer.consumeF)�peekrN c C sz | j du sJ d|�d| j ����|| jv s J d|����| j| }|�| j| j�}|du r/dS |s;t||d | j�| _ dS )z�Check whether the next token has the provided name. By default, if the check succeeds, the token *must* be read before another check. If `peek` is set to `True`, the token is not loaded and would need to be checked again. NzCannot check for z, already have zUnknown token name: Fr T)rJ rC �matchr r r )r r rN � expressionrO r r r rK q s � zTokenizer.check�expectedc C s" | � |�s | �d|� ���| �� S )zsExpect a certain token name next, failing with a syntax error otherwise. The token is *not* read. z Expected )rK �raise_syntax_errorrL )r r rQ r r r �expect� s zTokenizer.expectc C s0 | j }|dus J �| jt|j�7 _d| _ |S )z%Consume the next token and return it.N)rJ r �lenr )r �tokenr r r rL � s zTokenizer.read)� span_start�span_endr rV rW c C s4 |du r| j n||du r| j n|f}t|| j|d��)z.Raise ParserSyntaxError at the given position.N)r r )r r r )r r rV rW r r r r rR � s ��z Tokenizer.raise_syntax_error� open_token� close_token�aroundc c sh � | � |�r| j}| �� nd }d V |d u rd S | � |�s.| jd|� d|� d|� �|d� | �� d S )NzExpected matching z for z, after )rV )rK r rL rR )r rX rY rZ � open_positionr r r �enclosing_tokens� s � � zTokenizer.enclosing_tokens)r r r r' r r rM �boolrK r rS rL r r r rR � contextlib�contextmanagerr r\ r r r r rB X sD �� � ���� �����rB )r^ rD � dataclassesr �typingr r r r r r � specifiersr r � Exceptionr rE �VERBOSE�_operator_regex_str�_version_regex_str� IGNORECASErA r rB r r r r �<module> sr ������������ ��% ��)�*�+�,�-�3 _vendor/wheel/vendored/packaging/__pycache__/version.cpython-310.pyc 0000644 00000033533 15030122015 0021430 0 ustar 00 o �hj? � @ s� d Z ddlZddlZddlmZmZmZmZmZm Z m Z ddl m Z m Z mZmZ g d�Ze e eef df Ze e ee eef f Ze ee e e eef e ee eef f f df f Ze ee edf eeeef Zeeegef ZG dd � d e�Zd ed d fd d�ZG dd� de�Z G dd� d�Z dZ e Z G dd � d e �Z dee de ee!edf d ee eef fdd�Z"e�#d�Z$dee d ee fdd �Z%d ed e edf d ee eef d ee eef d!ee eef dee d efd"d#�Z&dS )$zB .. testsetup:: from packaging.version import parse, Version � N)�Any�Callable� NamedTuple�Optional� SupportsInt�Tuple�Union� )�Infinity� InfinityType�NegativeInfinity�NegativeInfinityType)�VERSION_PATTERN�parse�Version�InvalidVersion.c @ sn e Zd ZU eed< eedf ed< eeeef ed< eeeef ed< eeeef ed< ee ed< dS ) �_Version�epoch.�release�dev�pre�post�localN) �__name__� __module__� __qualname__�int�__annotations__r r �str� LocalType� r r �f/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.pyr $ s r �version�returnr c C s t | �S )z�Parse the given version string. >>> parse('1.0.dev1') <Version('1.0.dev1')> :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. )r )r" r r r! r - � r c @ s e Zd ZdZdS )r z�Raised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' N)r r r �__doc__r r r r! r 9 s r c @ s� e Zd ZU eedf ed< defdd�Zdd defdd�Z dd defd d �Z de defd d �Z dd defd d�Z dd defdd�Zde defdd�ZdS )� _BaseVersion.�_keyr# c C s t | j�S �N)�hashr' ��selfr r r! �__hash__F s z_BaseVersion.__hash__�otherc C s t |t�stS | j|jk S r( �� isinstancer& �NotImplementedr' �r+ r- r r r! �__lt__L � z_BaseVersion.__lt__c C s t |t�stS | j|jkS r( r. r1 r r r! �__le__R r3 z_BaseVersion.__le__c C s t |t�stS | j|jkS r( r. r1 r r r! �__eq__X r3 z_BaseVersion.__eq__c C s t |t�stS | j|jkS r( r. r1 r r r! �__ge__^ r3 z_BaseVersion.__ge__c C s t |t�stS | j|jkS r( r. r1 r r r! �__gt__d r3 z_BaseVersion.__gt__c C s t |t�stS | j|jkS r( r. r1 r r r! �__ne__j r3 z_BaseVersion.__ne__N)r r r r r r r r, �boolr2 r4 �objectr5 r6 r7 r8 r r r r! r& C s r& a� v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version c @ s� e Zd ZU dZe�de d ejejB �Z e e d< de ddfdd �Z de fd d �Zde fd d �Zedefdd��Zedeedf fdd��Zedeee ef fdd��Zedee fdd��Zedee fdd��Zedee fdd��Zede fdd ��Zede fd d ��Zede fd d ��Z ede fd!d"��Z ede fd#d$��Z edefd%d&��Z edefd'd(��Z!edefd)d*��Z"dS )+r a� This class abstracts handling of a project's versions. A :class:`Version` instance is comparison aware and can be compared and sorted using the standard Python interfaces. >>> v1 = Version("1.0a5") >>> v2 = Version("1.0") >>> v1 <Version('1.0a5')> >>> v2 <Version('1.0')> >>> v1 < v2 True >>> v1 == v2 False >>> v1 > v2 False >>> v1 >= v2 False >>> v1 <= v2 True z^\s*z\s*$r' r" r# Nc C s� | j �|�}|std|� d���t|�d�r t|�d��ndtdd� |�d��d�D ��t|�d �|�d ��t|�d �|�d �pD|�d ��t|�d�|�d��t |�d��d�| _ t | j j | j j | j j| j j| j j| j j�| _dS )aC Initialize a Version object. :param version: The string representation of a version which will be parsed and normalized before use. :raises InvalidVersion: If the ``version`` does not conform to PEP 440 in any way then this exception will be raised. zInvalid version: '�'r r c s � � | ]}t |�V qd S r( )r ��.0�ir r r! � <genexpr>� � � z#Version.__init__.<locals>.<genexpr>r �.�pre_l�pre_n�post_l�post_n1�post_n2�dev_l�dev_nr )r r r r r r N)�_regex�searchr r �groupr �tuple�split�_parse_letter_version�_parse_local_version�_version�_cmpkeyr r r r r r r' )r+ r" �matchr r r! �__init__� s* � � �zVersion.__init__c C s d| � d�S )z�A representation of the Version that shows all internal state. >>> Version('1.0.0') <Version('1.0.0')> z <Version('z')>r r* r r r! �__repr__� s zVersion.__repr__c C s� g }| j dkr|�| j � d�� |�d�dd� | jD ��� | jdur1|�d�dd� | jD ��� | jdur?|�d | j� �� | jdurM|�d | j� �� | jdur[|�d | j� �� d�|�S ) zA string representation of the version that can be rounded-tripped. >>> str(Version("1.0a5")) '1.0a5' r �!rB c s r< r( �r �r> �xr r r! r@ � rA z"Version.__str__.<locals>.<genexpr>N� c s r< r( rW rX r r r! r@ � rA z.postz.dev�+)r �append�joinr r r r r �r+ �partsr r r! �__str__� s zVersion.__str__c C � | j jS )zThe epoch of the version. >>> Version("2.0.0").epoch 0 >>> Version("1!2.0.0").epoch 1 )rQ r r* r r r! r r$ z Version.epoch.c C ra )ad The components of the "release" segment of the version. >>> Version("1.2.3").release (1, 2, 3) >>> Version("2.0.0").release (2, 0, 0) >>> Version("1!2.0.0.post0").release (2, 0, 0) Includes trailing zeroes but not the epoch or any pre-release / development / post-release suffixes. )rQ r r* r r r! r s zVersion.releasec C ra )a The pre-release segment of the version. >>> print(Version("1.2.3").pre) None >>> Version("1.2.3a1").pre ('a', 1) >>> Version("1.2.3b1").pre ('b', 1) >>> Version("1.2.3rc1").pre ('rc', 1) )rQ r r* r r r! r $ s z Version.prec C � | j jr | j jd S dS )z�The post-release number of the version. >>> print(Version("1.2.3").post) None >>> Version("1.2.3.post1").post 1 r N)rQ r r* r r r! r 3 � z Version.postc C rb )z�The development number of the version. >>> print(Version("1.2.3").dev) None >>> Version("1.2.3.dev1").dev 1 r N)rQ r r* r r r! r > rc z Version.devc C s$ | j jrd�dd� | j jD ��S dS )z�The local version segment of the version. >>> print(Version("1.2.3").local) None >>> Version("1.2.3+abc").local 'abc' rB c s r< r( rW rX r r r! r@ S rA z Version.local.<locals>.<genexpr>N)rQ r r] r* r r r! r I s z Version.localc C s t | ��dd�d S )z�The public portion of the version. >>> Version("1.2.3").public '1.2.3' >>> Version("1.2.3+abc").public '1.2.3' >>> Version("1.2.3+abc.dev1").public '1.2.3' r[ r r )r rN r* r r r! �publicW s zVersion.publicc C sF g }| j dkr|�| j � d�� |�d�dd� | jD ��� d�|�S )a] The "base version" of the version. >>> Version("1.2.3").base_version '1.2.3' >>> Version("1.2.3+abc").base_version '1.2.3' >>> Version("1!1.2.3+abc.dev1").base_version '1!1.2.3' The "base version" is the public version of the project without any pre or post release markers. r rV rB c s r< r( rW rX r r r! r@ y rA z'Version.base_version.<locals>.<genexpr>rZ )r r\ r] r r^ r r r! � base_versiond s zVersion.base_versionc C s | j dup | jduS )aT Whether this version is a pre-release. >>> Version("1.2.3").is_prerelease False >>> Version("1.2.3a1").is_prerelease True >>> Version("1.2.3b1").is_prerelease True >>> Version("1.2.3rc1").is_prerelease True >>> Version("1.2.3dev1").is_prerelease True N)r r r* r r r! � is_prerelease} s zVersion.is_prereleasec C � | j duS )z�Whether this version is a post-release. >>> Version("1.2.3").is_postrelease False >>> Version("1.2.3.post1").is_postrelease True N)r r* r r r! �is_postrelease� � zVersion.is_postreleasec C rg )z�Whether this version is a development release. >>> Version("1.2.3").is_devrelease False >>> Version("1.2.3.dev1").is_devrelease True N)r r* r r r! � is_devrelease� ri zVersion.is_devreleasec C s t | j�dkr | jd S dS )zqThe first item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").major 1 r r ��lenr r* r r r! �major� s z Version.majorc C � t | j�dkr | jd S dS )z�The second item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").minor 2 >>> Version("1").minor 0 � r r rk r* r r r! �minor� � z Version.minorc C rn )z�The third item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").micro 3 >>> Version("1").micro 0 � ro r rk r* r r r! �micro� rq z Version.micro)#r r r r% �re�compiler �VERBOSE� IGNORECASErJ �CmpKeyr r rT rU r` �propertyr r r r r r r r r rd re r9 rf rh rj rm rp rs r r r r! r � sF &! �letter�numberc C sv | r-|d u rd}| � � } | dkrd} n| dkrd} n | dv r!d} n| dv r'd } | t|�fS | s9|r9d } | t|�fS d S ) Nr �alpha�a�beta�b)�cr �preview�rc)�rev�rr )�lowerr )rz r{ r r r! rO � s" rO z[\._-]r c C s$ | durt dd� t�| �D ��S dS )zR Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve"). Nc s s( � | ]}|� � s |�� nt|�V qd S r( )�isdigitr� r )r> �partr r r! r@ � s � � �z'_parse_local_version.<locals>.<genexpr>)rM �_local_version_separatorsrN )r r r r! rP � s �rP r r r r r c C s� t ttt�dd� t|�����}|d u r |d u r |d ur t}n |d u r&t}n|}|d u r/t}n|}|d u r8t} n|} |d u rAt} n t dd� |D ��} | |||| | fS )Nc S s | dkS )Nr r )rY r r r! �<lambda> s z_cmpkey.<locals>.<lambda>c s s* � | ]}t |t�r |d fnt|fV qdS )rZ N)r/ r r r= r r r! r@ - s � �z_cmpkey.<locals>.<genexpr>)rM �reversed�list� itertools� dropwhiler r ) r r r r r r �_release�_pre�_post�_dev�_localr r r! rR � s( � �rR )'r% r� rt �typingr r r r r r r � _structuresr r r r �__all__r r r �CmpPrePostDevType� CmpLocalTyperx r9 �VersionComparisonMethodr r � ValueErrorr r& �_VERSION_PATTERNr r �bytesrO ru r� rP rR r r r r! �<module> sr $*�� �� 0 '�� � # � ������ _vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-310.pyc 0000644 00000000304 15030122015 0021470 0 ustar 00 o �h � @ s d S )N� r r r �g/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py�<module> s _vendor/wheel/vendored/packaging/__pycache__/_musllinux.cpython-310.pyc 0000644 00000006422 15030122015 0022137 0 ustar 00 o �hr � @ s, d Z ddlZddlZddlZddlZddlmZmZmZm Z ddl m Z G dd� de�Z de d ee fd d �Zejd e d ee fd d��Zde e d ee fdd�Zedkr�ddlZe�� Ze�d�sgJ d��ede� edeej�� eddd� ee�dde�d d�d ��D ] Zeed d� q�dS dS ) z�PEP 656 support. This module implements logic to detect if the currently running Python is linked against musl, and what musl version is used. � N)�Iterator� NamedTuple�Optional�Sequence� )�ELFFilec @ s e Zd ZU eed< eed< dS )� _MuslVersion�major�minorN)�__name__� __module__� __qualname__�int�__annotations__� r r �i/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.pyr s r �output�returnc C sx dd� dd� | � � D �D �}t|�dk s |d d d� dkr d S t�d |d �}|s,d S tt|�d ��t|�d��d �S ) Nc S s g | ]}|r|�qS r r ��.0�nr r r � <listcomp> s z'_parse_musl_version.<locals>.<listcomp>c s s � | ]}|� � V qd S )N)�stripr r r r � <genexpr> s � z&_parse_musl_version.<locals>.<genexpr>� r � �muslzVersion (\d+)\.(\d+)r )r r )� splitlines�len�re�matchr r �group)r �lines�mr r r �_parse_musl_version s r$ � executablec C s� z t | d�� }t|�j}W d � n1 sw Y W n tttfy) Y dS w |du s2d|vr4dS tj|gtjdd�}t |j �S )a` Detect currently-running musl runtime version. This is done by checking the specified executable's dynamic linking information, and invoking the loader to parse its output for a version string. If the loader is musl, the output would be something like:: musl libc (x86_64) Version 1.2.2 Dynamic Program Loader �rbNr T)�stderr�text) �openr � interpreter�OSError� TypeError� ValueError� subprocess�run�PIPEr$ r' )r% �f�ld�procr r r �_get_musl_version s ��� r4 �archsc c sT � t tj�}|du r dS | D ]}t|jdd�D ]}d|j� d|� d|� �V qqdS )a� Generate musllinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be musllinux-compatible. :returns: An iterator of compatible musllinux tags. N���� musllinux_�_)r4 �sysr% �ranger r )r5 �sys_musl�archr r r r � platform_tags6 s � ��r= �__main__zlinux-z not linuxzplat:zmusl:ztags:� )�endz[.-]r8 �-r6 z ) �__doc__� functoolsr r. r9 �typingr r r r �_elffiler r �strr$ � lru_cacher4 r= r � sysconfig� get_platform�plat� startswith�printr% �sub�split�tr r r r �<module> s. "� _vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-310.pyc 0000644 00000005431 15030122015 0022462 0 ustar 00 o �hu � @ sz d dl mZmZmZmZ ddlmZ ddlm Z ddl m Z m Z ddl mZ ddlmZ G dd � d e�ZG d d � d �Zd S ) � )�Any�Iterator�Optional�Set� )�parse_requirement)�ParserSyntaxError)�Marker�_normalize_extra_values)� SpecifierSet)�canonicalize_namec @ s e Zd ZdZdS )�InvalidRequirementzJ An invalid requirement was found, users should refer to PEP 508. N)�__name__� __module__� __qualname__�__doc__� r r �k/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.pyr s r c @ st e Zd ZdZdeddfdd�Zdedee fdd �Zdefd d �Zdefd d �Z de fdd�Z de de fdd�ZdS )� Requirementz�Parse a requirement. Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. �requirement_string�returnNc C s� zt |�}W n ty } ztt|��|�d }~ww |j| _|jp"d | _t|jp)g �| _t|j �| _ d | _ |j d urIt � t �| _ t |j �| j _d S d S �N)�_parse_requirementr r �str�name�url�set�extrasr � specifier�markerr �__new__r �_markers)�selfr �parsed�er r r �__init__! s �� �zRequirement.__init__r c c sz � |V | j rd�t| j ��}d|� d�V | jr t| j�V | jr/d| j� �V | jr/dV | jr;d| j� �V d S d S )N�,�[�]z@ � z; )r �join�sortedr r r r )r" r �formatted_extrasr r r � _iter_parts0 s � �zRequirement._iter_partsc C s d� | �| j��S )N� )r* r- r �r" r r r �__str__B s zRequirement.__str__c C s d| � d�S )Nz<Requirement('z')>r r/ r r r �__repr__E s zRequirement.__repr__c C s t | jjg| �t| j���R �S r )�hash� __class__r r- r r r/ r r r �__hash__H s ���zRequirement.__hash__�otherc C sR t |t�stS t| j�t|j�ko(| j|jko(| j|jko(| j|jko(| j|jkS r ) � isinstancer �NotImplementedr r r r r r )r" r5 r r r �__eq__P s � � � �zRequirement.__eq__)r r r r r r% r r- r0 r1 �intr4 r �boolr8 r r r r r s r N)�typingr r r r �_parserr r � _tokenizerr �markersr r � specifiersr �utilsr � ValueErrorr r r r r r �<module> s _vendor/wheel/vendored/packaging/__pycache__/utils.cpython-310.pyc 0000644 00000010656 15030122015 0021104 0 ustar 00 o �h� � @ sT d dl Z d dlmZmZmZmZmZ ddlmZm Z ddl m Z m Z eed ee ef f Zede�ZG dd � d e�ZG d d � d e�ZG d d � d e�Ze �de j�Ze �d�Ze �d�Ze �d�Zdd�dededefdd�Z dedefdd�Z dd �d ee ef d edefd d �Z d!edeee eee f fd"d#�Z d!edeee f fd$d%�Z dS )&� N)� FrozenSet�NewType�Tuple�Union�cast� )�Tag� parse_tag)�InvalidVersion�Version� �NormalizedNamec @ � e Zd ZdZdS )� InvalidNamezW An invalid distribution name; users should refer to the packaging user guide. N��__name__� __module__� __qualname__�__doc__r r r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.pyr � r c @ r )�InvalidWheelFilenamezM An invalid wheel filename was found, users should refer to PEP 427. Nr r r r r r r r c @ r )�InvalidSdistFilenamez^ An invalid sdist filename was found, users should refer to the packaging user guide. Nr r r r r r r r z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$z[-_.]+z/^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$z (\d+)(.*)F)�validate�namer �returnc C s6 |rt �| �std| ����t�d| ��� }tt|�S )Nzname is invalid: �-)�_validate_regex�matchr �_canonicalize_regex�sub�lowerr r )r r �valuer r r �canonicalize_name+ s r# c C s t �| �d uS �N)�_normalized_regexr )r r r r �is_normalized_name3 s r& T)�strip_trailing_zero�versionr' c C s t | t�rzt| �}W n ty | Y S w | }g }|jdkr)|�|j� d�� d�dd� |jD ��}|r=t� dd|�}|�|� |j durU|�d�d d� |j D ��� |j durc|�d |j � �� |j durq|�d |j � �� |j dur|�d |j � �� d�|�S ) z� This is very similar to Version.__str__, but has one subtle difference with the way it handles the release segment. r �!�.c s � � | ]}t |�V qd S r$ ��str��.0�xr r r � <genexpr>N � � z'canonicalize_version.<locals>.<genexpr>z(\.0)+$� Nc s r+ r$ r, r. r r r r1 V r2 z.postz.dev�+)� isinstancer- r r �epoch�append�join�release�rer �pre�post�dev�local)r( r' �parsed�parts�release_segmentr r r �canonicalize_version7 s. � rB �filenamec C s< | � d�s td| � ���| d d� } | �d�}|dvr"td| � ���| �d|d �}|d }d |v s<t�d |tj�d u rCtd | � ���t|�}zt|d �}W n t yc } ztd | � ��|�d }~ww |dkr�|d }t �|�}|d u r�td|� d| � d���t t t |�d ��|�d�f�} nd} t|d �} ||| | fS )Nz.whlz3Invalid wheel filename (extension must be '.whl'): ���r )� � z0Invalid wheel filename (wrong number of parts): � r �__z ^[\w\d._]*$zInvalid project name: r z*Invalid wheel filename (invalid version): rF zInvalid build number: z in '�'r ���)�endswithr �count�splitr: r �UNICODEr# r r �_build_tag_regexr �BuildTag�int�groupr ) rC �dashesr@ � name_partr r( �e� build_part� build_match�build�tagsr r r �parse_wheel_filenameg sH � � ���� � rZ c C s� | � d�r| d td� � }n| � d�r | d td� � }ntd| � ���|�d�\}}}|s6td| � ���t|�}z t|�}W ||fS tyW } ztd| � ��|�d }~ww )Nz.tar.gzz.zipz@Invalid sdist filename (extension must be '.tar.gz' or '.zip'): r zInvalid sdist filename: z*Invalid sdist filename (invalid version): )rK �lenr � rpartitionr# r r )rC � file_stemrT �sep� version_partr r( rU r r r �parse_sdist_filename� s0 �� �����r` )!r: �typingr r r r r rY r r r( r r rQ r- rP r � ValueErrorr r r �compile� IGNORECASEr r r% rO �boolr# r& rB rZ r` r r r r �<module> s> � � �� �0� � + _vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-310.pyc 0000644 00000074430 15030122015 0022100 0 ustar 00 o �hb� � @ sT d Z ddlZddlZddlZddlmZmZmZmZm Z m Z m Z m Z ddl mZ ddlmZ e eef Ze ded�Zeeegef Zd ed efd d �ZG d d� de�ZG dd� dejd�ZG dd� de�Ze� d�Z d ed ee fdd�Z dee d efdd�Z ded efdd �Z d ee d ee d e ee ee f fd d �Z!G d!d"� d"e�Z"dS )#z� .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version � N)�Callable�Iterable�Iterator�List�Optional�Tuple�TypeVar�Union� )�canonicalize_version)�Version�UnparsedVersionVar)�bound�version�returnc C s t | t�s t| �} | S �N)� isinstancer )r � r �i/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py�_coerce_version s r c @ s e Zd ZdZdS )�InvalidSpecifiera Raised when attempting to create a :class:`Specifier` with a specifier string that is invalid. >>> Specifier("lolwat") Traceback (most recent call last): ... packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' N)�__name__� __module__� __qualname__�__doc__r r r r r s r c @ s� e Zd Zejdefdd��Zejdefdd��Zejde de fdd��Z e ejde e fd d ���Zejd e dd fd d ��Zejddede e de fdd��Zej ddee de e dee fdd��Zd S )� BaseSpecifierr c C � dS )z� Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr ��selfr r r �__str__+ � zBaseSpecifier.__str__c C r )zF Returns a hash value for this Specifier-like object. Nr r r r r �__hash__2 r zBaseSpecifier.__hash__�otherc C r )z� Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. Nr �r r" r r r �__eq__8 r zBaseSpecifier.__eq__c C r )z�Whether or not pre-releases as a whole are allowed. This can be set to either ``True`` or ``False`` to explicitly enable or disable prereleases or it can be set to ``None`` (the default) to use default semantics. Nr r r r r � prereleasesA r zBaseSpecifier.prereleases�valueNc C r )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r r& r r r r% J r �itemr% c C r )zR Determines if the given item is contained within this specifier. Nr )r r( r% r r r �containsQ r zBaseSpecifier.contains�iterablec C r )z� Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. Nr )r r* r% r r r �filterW r zBaseSpecifier.filterr )r r r �abc�abstractmethod�strr �intr! �object�boolr$ �propertyr r% �setterr) r r r r+ r r r r r * s. ����r )� metaclassc @ s. e Zd ZdZdZdZe�de e d ejej B �Z dddd d d d d d�Z dFde de e ddfdd�Zedefdd��Zejdeddfdd��Zede fdd��Zede fd d ��Zde fd d �Zde fd d!�Zedee e f fd"d#��Zdefd$d%�Zd&edefd'd(�Z d)e de fd*d+�Z d,e de defd-d.�Z d,e de defd/d0�Z!d,e de defd1d2�Z"d,e de defd3d4�Z#d,e de defd5d6�Z$d,e d7e defd8d9�Z%d,e d7e defd:d;�Z&d,e de defd<d=�Z'd>e(e e f defd?d@�Z) dGd>e*de e defdAdB�Z+ dGdCe,e- de e de.e- fdDdE�Z/dS )H� Specifiera? This class abstracts handling of version specifiers. .. tip:: It is generally not required to instantiate this manually. You should instead prefer to work with :class:`SpecifierSet` instead, which can parse comma-separated version specifiers (which is what package metadata contains). z8 (?P<operator>(~=|==|!=|<=|>=|<|>|===)) a� (?P<version> (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. (?<====) # Only match for the identity operator \s* [^\s;)]* # The arbitrary version can be just about anything, # we match everything except for whitespace, a # semi-colon for marker support, and a closing paren # since versions can be enclosed in them. ) | (?: # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. (?<===|!=) # Only match for equals and not equals \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release # You cannot use a wild card and a pre-release, post-release, a dev or # local version together so group them with a | and make them optional. (?: \.\* # Wild card syntax of .* | (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local )? ) | (?: # The compatible operator requires at least two digits in the # release segment. (?<=~=) # Only match for the compatible operator \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) | (?: # All other operators only allow a sub set of what the # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. (?<!==|!=|~=) # We have special cases for these # operators so we want to make sure they # don't match here. \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) z^\s*z\s*$� compatible�equal� not_equal�less_than_equal�greater_than_equal� less_than� greater_than� arbitrary)�~=�==z!=�<=�>=�<�>�===� N�specr% r c C sH | j �|�}|std|� d���|�d��� |�d��� f| _|| _dS )a� Initialize a Specifier instance. :param spec: The string representation of a specifier which will be parsed and normalized before use. :param prereleases: This tells the specifier if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given specifier is invalid (i.e. bad syntax). zInvalid specifier: '�'�operatorr N)�_regex�searchr �group�strip�_spec� _prereleases)r rF r% �matchr r r �__init__� s � zSpecifier.__init__c C sR | j d ur| j S | j\}}|dv r'|dkr |�d�r |d d� }t|�jr'dS dS )N)r? rA r@ r> rD r? �.*���TF)rN rM �endswithr � is_prerelease)r rH r r r r r% � s zSpecifier.prereleasesr& c C � || _ d S r �rN r' r r r r% � c C � | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rM r r r r rH � zSpecifier.operatorc C rX )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r rY r r r r r rZ zSpecifier.versionc C s8 | j dur d| j��nd}d| jj� dt| ��|� d�S )aT A representation of the Specifier that shows all internal state. >>> Specifier('>=1.0.0') <Specifier('>=1.0.0')> >>> Specifier('>=1.0.0', prereleases=False) <Specifier('>=1.0.0', prereleases=False)> >>> Specifier('>=1.0.0', prereleases=True) <Specifier('>=1.0.0', prereleases=True)> N�, prereleases=rE rB �(�)>)rN r% � __class__r r. �r �prer r r �__repr__$ s �� zSpecifier.__repr__c C s dj | j� S )z�A string representation of the Specifier that can be round-tripped. >>> str(Specifier('>=1.0.0')) '>=1.0.0' >>> str(Specifier('>=1.0.0', prereleases=False)) '>=1.0.0' z{}{})�formatrM r r r r r 6 s zSpecifier.__str__c C s* t | jd | jd dkd�}| jd |fS )Nr r r> ��strip_trailing_zero)r rM )r �canonical_versionr r r �_canonical_spec@ s �zSpecifier._canonical_specc C � t | j�S r )�hashrf r r r r r! H � zSpecifier.__hash__r" c C sP t |t�rz | �t|��}W n ty t Y S w t || j�s"tS | j|jkS )a> Whether or not the two Specifier-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") True >>> (Specifier("==1.2.3", prereleases=False) == ... Specifier("==1.2.3", prereleases=True)) True >>> Specifier("==1.2.3") == "==1.2.3" True >>> Specifier("==1.2.3") == Specifier("==1.2.4") False >>> Specifier("==1.2.3") == Specifier("~=1.2.3") False )r r. r^ r �NotImplementedrf r# r r r r$ K s � zSpecifier.__eq__�opc C s t | d| j| � ��}|S )N� _compare_)�getattr� _operators)r rk �operator_callabler r r � _get_operatorh s �zSpecifier._get_operator� prospectivec C sH t tt�tt|���d d� �}|d7 }| �d�||�o#| �d�||�S )N���rQ rA r? )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitrp )r rq rF �prefixr r r �_compare_compatiblen s ��z Specifier._compare_compatiblec C s� |� d�r1t|jdd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS t|�} | js=t|j�}|| kS )NrQ Frc rR )rS r �publicrx � _pad_version�lenr �local) r rq rF �normalized_prospective�normalized_spec� split_spec�split_prospective�padded_prospective�_�shortened_prospective� spec_versionr r r �_compare_equal� s � zSpecifier._compare_equalc C s | � ||� S r )r� �r rq rF r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |j�t |�kS r �r r{ r� r r r �_compare_less_than_equal� � z"Specifier._compare_less_than_equalc C s t |j�t |�kS r r� r� r r r �_compare_greater_than_equal� r� z%Specifier._compare_greater_than_equal�spec_strc C s< t |�}||k s dS |js |jr t |j�t |j�kr dS dS �NFT)r rT � base_version�r rq r� rF r r r �_compare_less_than� s z Specifier._compare_less_thanc C s^ t |�}||ks dS |js |jr t |j�t |j�kr dS |jd ur-t |j�t |j�kr-dS dS r� )r �is_postreleaser� r~ r� r r r �_compare_greater_than� s z Specifier._compare_greater_thanc C s t |��� t |��� kS r )r. �lowerr� r r r �_compare_arbitrary� s z Specifier._compare_arbitraryr( c C � | � |�S )a; Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in Specifier(">=1.2.3") True >>> Version("1.2.3") in Specifier(">=1.2.3") True >>> "1.0.0" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True �r) �r r( r r r � __contains__� � zSpecifier.__contains__c C s< |du r| j }t|�}|jr|sdS | �| j�}||| j�S )al Return whether or not the item is contained in this specifier. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this Specifier. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> Specifier(">=1.2.3").contains("1.2.3") True >>> Specifier(">=1.2.3").contains(Version("1.2.3")) True >>> Specifier(">=1.2.3").contains("1.0.0") False >>> Specifier(">=1.2.3").contains("1.3.0a1") False >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") True >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) True NF)r% r rT rp rH r )r r( r% �normalized_itemro r r r r) s zSpecifier.containsr* c c s� � d}g }d|dur |ndi}|D ]"}t |�}| j|fi |��r3|jr.|s.| js.|�|� qd}|V q|s@|rB|D ] }|V q:dS dS dS )aO Filter items in the given iterable, that match the specifier. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(Specifier().contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) ['1.2.3', '1.3', <Version('1.4')>] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) ['1.5a1'] >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] Fr% NT)r r) rT r% �append)r r* r% �yielded�found_prereleases�kwr �parsed_versionr r r r+ 5 s* � �� ��zSpecifier.filter�rE Nr )0r r r r �_operator_regex_str�_version_regex_str�re�compile�VERBOSE� IGNORECASErI rn r. r r1 rP r2 r% r3 rH r ra r r rf r/ r! r0 r$ �CallableOperatorrp r rz r� r� r� r� r� r� r� r r� �UnparsedVersionr) r r r r+ r r r r r5 a st ^ �� ( ��� �/����r5 z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c C s^ g }| � d�\}}}|�|pd� |�d�D ]}t�|�}|r'|�|�� � q|�|� q|S )a Split version into components. The split components are intended for version comparison. The logic does not attempt to retain the original version string, so joining the components back with :func:`_version_join` may not produce the original version string. �!�0�.)� rpartitionr� �split� _prefix_regexrJ �extend�groups)r �result�epochr� �restr( rO r r r rx v s rx � componentsc C s | ^}}|� dd� |�� �S )z�Join split version components into a version string. This function assumes the input came from :func:`_version_split`, where the first component must be the epoch (either empty or numeric), and all other components numeric. r� r� )�join)r� r� r� r r r rs � s rs �segmentc s t � fdd�dD �� S )Nc 3 s � | ]}� � |�V qd S r )� startswith)�.0ry �r� r r � <genexpr>� s � �z!_is_not_suffix.<locals>.<genexpr>)�dev�a�b�rc�post)�anyr� r r� r rw � s �rw �left�rightc C s� g g }}|� tt�dd� | ��� |� tt�dd� |��� |� | t|d �d � � |� |t|d �d � � |�ddgtdt|d �t|d � � � |�ddgtdt|d �t|d � � � ttj�|��ttj�|��fS )Nc S � | � � S r ��isdigit��xr r r �<lambda>� � z _pad_version.<locals>.<lambda>c S r� r r� r� r r r r� � r� r r r� ) r� rt ru rv r} �insert�max�chain� from_iterable)r� r� � left_split� right_splitr r r r| � s ,,�r| c @ s2 e Zd ZdZ d%dedee ddfdd�Zedee fd d ��Z e j d eddfd d ��Z defd d�Z defdd�Z de fdd�Zded ef dd fdd�Zdedefdd�Zde fdd�Zdee fdd�Zd edefd d �Z d&d edee d ee defd d!�Z d'd"ee dee dee fd#d$�Z dS )(� SpecifierSetz�This class abstracts handling of a set of version specifiers. It can be passed a single specifier (``>=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. rE N� specifiersr% r c C s. dd� |� d�D �}ttt|��| _|| _dS )aN Initialize a SpecifierSet instance. :param specifiers: The string representation of a specifier or a comma-separated list of specifiers which will be parsed and normalized before use. :param prereleases: This tells the SpecifierSet if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given ``specifiers`` are not parseable than this exception will be raised. c S s g | ] }|� � r|� � �qS r )rL �r� �sr r r � <listcomp>� s z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r� � frozenset�mapr5 �_specsrN )r r� r% �split_specifiersr r r rP � s zSpecifierSet.__init__c C s. | j d ur| j S | js d S tdd� | jD ��S )Nc s s � | ]}|j V qd S r �r% r� r r r r� � s � z+SpecifierSet.prereleases.<locals>.<genexpr>)rN r� r� r r r r r% � s zSpecifierSet.prereleasesr& c C rU r rV r' r r r r% � rW c C s. | j dur d| j��nd}dt| ��|� d�S )a A representation of the specifier set that shows all internal state. Note that the ordering of the individual specifiers within the set may not match the input string. >>> SpecifierSet('>=1.0.0,!=2.0.0') <SpecifierSet('!=2.0.0,>=1.0.0')> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)> Nr[ rE z<SpecifierSet(r] )rN r% r. r_ r r r ra � s ��zSpecifierSet.__repr__c C s d� tdd� | jD ���S )an A string representation of the specifier set that can be round-tripped. Note that the ordering of the individual specifiers within the set may not match the input string. >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) '!=1.0.1,>=1.0.0' >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) '!=1.0.1,>=1.0.0' r� c s s � | ]}t |�V qd S r )r. r� r r r r� s � z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r r r r r s zSpecifierSet.__str__c C rg r )rh r� r r r r r! ri zSpecifierSet.__hash__r" c C s� t |t�r t|�}nt |t�stS t� }t| j|jB �|_| jdu r-|jdur-|j|_|S | jdur=|jdu r=| j|_|S | j|jkrI| j|_|S td��)a� Return a SpecifierSet which is a combination of the two sets. :param other: The other object to combine with. >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> NzFCannot combine SpecifierSets with True and False prerelease overrides.)r r. r� rj r� r� rN � ValueError)r r" � specifierr r r �__and__ s$ � ���zSpecifierSet.__and__c C s6 t |ttf�rtt|��}nt |t�stS | j|jkS )a� Whether or not the two SpecifierSet-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") True >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) True >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" True >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") False >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") False )r r. r5 r� rj r� r# r r r r$ 0 s zSpecifierSet.__eq__c C rg )z7Returns the number of specifiers in this specifier set.)r} r� r r r r �__len__J rW zSpecifierSet.__len__c C rg )z� Returns an iterator over all the underlying :class:`Specifier` instances in this specifier set. >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) [<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>] )�iterr� r r r r �__iter__N s zSpecifierSet.__iter__r( c C r� )ar Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") True >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") True >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) True r� r� r r r r� X r� zSpecifierSet.__contains__� installedc s\ t � t�s t� �� �du r| j��s� jrdS |r!� jr!t� j�� t� �fdd�| jD ��S )a� Return whether or not the item is contained in this SpecifierSet. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this SpecifierSet. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") False >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") False >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) True NFc 3 s � | ] }|j � �d �V qdS )r� Nr� r� �r( r% r r r� � s � z(SpecifierSet.contains.<locals>.<genexpr>)r r r% rT r� �allr� )r r( r% r� r r� r r) m s zSpecifierSet.containsr* c C s� |du r| j }| jr | jD ] }|j|t|�d�}q t|�S g }g }|D ]}t|�}|jr6|s6|s5|�|� q#|�|� q#|sH|rH|du rHt|�S t|�S )a. Filter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) ['1.3', <Version('1.4')>] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) [] >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet("").filter(["1.5a1"])) ['1.5a1'] >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] Nr� )r% r� r+ r1 r� r rT r� )r r* r% rF �filteredr� r( r� r r r r+ � s$ , � zSpecifierSet.filterr� )NNr ) r r r r r. r r1 rP r2 r% r3 ra r r/ r! r r� r0 r$ r� r r5 r� r� r� r) r r r+ r r r r r� � sR ��� � ���� �:����r� )#r r, ru r� �typingr r r r r r r r �utilsr r r r. r� r r1 r� r r� r �ABCMetar r5 r� r� rx rs rw r| r� r r r r �<module> s0 ( 7 . _vendor/wheel/vendored/packaging/__pycache__/_structures.cpython-310.pyc 0000644 00000005224 15030122015 0022321 0 ustar 00 o �h� � @ s, G d d� d�Z e � ZG dd� d�Ze� ZdS )c @ s� e Zd Zdefdd�Zdefdd�Zdedefdd�Z dedefd d �Z dedefd d �Z dedefd d�Z dedefdd�Z deddfdd�ZdS )� InfinityType�returnc C � dS )N�Infinity� ��selfr r �j/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py�__repr__ � zInfinityType.__repr__c C � t t| ��S �N��hash�reprr r r r �__hash__ � zInfinityType.__hash__�otherc C r �NFr �r r r r r �__lt__ r zInfinityType.__lt__c C r r r r r r r �__le__ r zInfinityType.__le__c C � t || j�S r �� isinstance� __class__r r r r �__eq__ r zInfinityType.__eq__c C r �NTr r r r r �__gt__ r zInfinityType.__gt__c C r r r r r r r �__ge__ r zInfinityType.__ge__r �NegativeInfinityTypec C � t S r )�NegativeInfinityr r r r �__neg__ r zInfinityType.__neg__N)�__name__� __module__� __qualname__�strr �intr �object�boolr r r r r r" r r r r r � r c @ s� e Zd Zdefdd�Zdefdd�Zdedefdd�Z dedefd d �Z dedefd d �Z dedefd d�Z dedefdd�Z dedefdd�ZdS )r r c C r )Nz -Infinityr r r r r r $ r z NegativeInfinityType.__repr__c C r r r r r r r r ' r z NegativeInfinityType.__hash__r c C r r r r r r r r * r zNegativeInfinityType.__lt__c C r r r r r r r r - r zNegativeInfinityType.__le__c C r r r r r r r r 0 r zNegativeInfinityType.__eq__c C r r r r r r r r 3 r zNegativeInfinityType.__gt__c C r r r r r r r r 6 r zNegativeInfinityType.__ge__r c C r r )r r r r r r" 9 r z NegativeInfinityType.__neg__N)r# r$ r% r& r r' r r( r) r r r r r r r" r r r r r # r* r N)r r r r! r r r r �<module> s _vendor/wheel/vendored/packaging/LICENSE.APACHE 0000644 00000023676 15030122015 0014766 0 ustar 00 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS _vendor/wheel/vendored/packaging/_structures.py 0000644 00000002627 15030122015 0015766 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. class InfinityType: def __repr__(self) -> str: return "Infinity" def __hash__(self) -> int: return hash(repr(self)) def __lt__(self, other: object) -> bool: return False def __le__(self, other: object) -> bool: return False def __eq__(self, other: object) -> bool: return isinstance(other, self.__class__) def __gt__(self, other: object) -> bool: return True def __ge__(self, other: object) -> bool: return True def __neg__(self: object) -> "NegativeInfinityType": return NegativeInfinity Infinity = InfinityType() class NegativeInfinityType: def __repr__(self) -> str: return "-Infinity" def __hash__(self) -> int: return hash(repr(self)) def __lt__(self, other: object) -> bool: return True def __le__(self, other: object) -> bool: return True def __eq__(self, other: object) -> bool: return isinstance(other, self.__class__) def __gt__(self, other: object) -> bool: return False def __ge__(self, other: object) -> bool: return False def __neg__(self: object) -> InfinityType: return Infinity NegativeInfinity = NegativeInfinityType() _vendor/wheel/vendored/packaging/version.py 0000644 00000037552 15030122015 0015076 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. """ .. testsetup:: from packaging.version import parse, Version """ import itertools import re from typing import Any, Callable, NamedTuple, Optional, SupportsInt, Tuple, Union from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType __all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"] LocalType = Tuple[Union[int, str], ...] CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] CmpLocalType = Union[ NegativeInfinityType, Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], ] CmpKey = Tuple[ int, Tuple[int, ...], CmpPrePostDevType, CmpPrePostDevType, CmpPrePostDevType, CmpLocalType, ] VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] class _Version(NamedTuple): epoch: int release: Tuple[int, ...] dev: Optional[Tuple[str, int]] pre: Optional[Tuple[str, int]] post: Optional[Tuple[str, int]] local: Optional[LocalType] def parse(version: str) -> "Version": """Parse the given version string. >>> parse('1.0.dev1') <Version('1.0.dev1')> :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. """ return Version(version) class InvalidVersion(ValueError): """Raised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' """ class _BaseVersion: _key: Tuple[Any, ...] def __hash__(self) -> int: return hash(self._key) # Please keep the duplicated `isinstance` check # in the six comparisons hereunder # unless you find a way to avoid adding overhead function calls. def __lt__(self, other: "_BaseVersion") -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key < other._key def __le__(self, other: "_BaseVersion") -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key <= other._key def __eq__(self, other: object) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key == other._key def __ge__(self, other: "_BaseVersion") -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key >= other._key def __gt__(self, other: "_BaseVersion") -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key > other._key def __ne__(self, other: object) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key != other._key # Deliberately not anchored to the start and end of the string, to make it # easier for 3rd party code to reuse _VERSION_PATTERN = r""" v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version """ VERSION_PATTERN = _VERSION_PATTERN """ A string containing the regular expression used to match a valid version. The pattern is not anchored at either end, and is intended for embedding in larger expressions (for example, matching a version number as part of a file name). The regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE`` flags set. :meta hide-value: """ class Version(_BaseVersion): """This class abstracts handling of a project's versions. A :class:`Version` instance is comparison aware and can be compared and sorted using the standard Python interfaces. >>> v1 = Version("1.0a5") >>> v2 = Version("1.0") >>> v1 <Version('1.0a5')> >>> v2 <Version('1.0')> >>> v1 < v2 True >>> v1 == v2 False >>> v1 > v2 False >>> v1 >= v2 False >>> v1 <= v2 True """ _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE) _key: CmpKey def __init__(self, version: str) -> None: """Initialize a Version object. :param version: The string representation of a version which will be parsed and normalized before use. :raises InvalidVersion: If the ``version`` does not conform to PEP 440 in any way then this exception will be raised. """ # Validate the version and parse it into pieces match = self._regex.search(version) if not match: raise InvalidVersion(f"Invalid version: '{version}'") # Store the parsed out pieces of the version self._version = _Version( epoch=int(match.group("epoch")) if match.group("epoch") else 0, release=tuple(int(i) for i in match.group("release").split(".")), pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")), post=_parse_letter_version( match.group("post_l"), match.group("post_n1") or match.group("post_n2") ), dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")), local=_parse_local_version(match.group("local")), ) # Generate a key which will be used for sorting self._key = _cmpkey( self._version.epoch, self._version.release, self._version.pre, self._version.post, self._version.dev, self._version.local, ) def __repr__(self) -> str: """A representation of the Version that shows all internal state. >>> Version('1.0.0') <Version('1.0.0')> """ return f"<Version('{self}')>" def __str__(self) -> str: """A string representation of the version that can be rounded-tripped. >>> str(Version("1.0a5")) '1.0a5' """ parts = [] # Epoch if self.epoch != 0: parts.append(f"{self.epoch}!") # Release segment parts.append(".".join(str(x) for x in self.release)) # Pre-release if self.pre is not None: parts.append("".join(str(x) for x in self.pre)) # Post-release if self.post is not None: parts.append(f".post{self.post}") # Development release if self.dev is not None: parts.append(f".dev{self.dev}") # Local version segment if self.local is not None: parts.append(f"+{self.local}") return "".join(parts) @property def epoch(self) -> int: """The epoch of the version. >>> Version("2.0.0").epoch 0 >>> Version("1!2.0.0").epoch 1 """ return self._version.epoch @property def release(self) -> Tuple[int, ...]: """The components of the "release" segment of the version. >>> Version("1.2.3").release (1, 2, 3) >>> Version("2.0.0").release (2, 0, 0) >>> Version("1!2.0.0.post0").release (2, 0, 0) Includes trailing zeroes but not the epoch or any pre-release / development / post-release suffixes. """ return self._version.release @property def pre(self) -> Optional[Tuple[str, int]]: """The pre-release segment of the version. >>> print(Version("1.2.3").pre) None >>> Version("1.2.3a1").pre ('a', 1) >>> Version("1.2.3b1").pre ('b', 1) >>> Version("1.2.3rc1").pre ('rc', 1) """ return self._version.pre @property def post(self) -> Optional[int]: """The post-release number of the version. >>> print(Version("1.2.3").post) None >>> Version("1.2.3.post1").post 1 """ return self._version.post[1] if self._version.post else None @property def dev(self) -> Optional[int]: """The development number of the version. >>> print(Version("1.2.3").dev) None >>> Version("1.2.3.dev1").dev 1 """ return self._version.dev[1] if self._version.dev else None @property def local(self) -> Optional[str]: """The local version segment of the version. >>> print(Version("1.2.3").local) None >>> Version("1.2.3+abc").local 'abc' """ if self._version.local: return ".".join(str(x) for x in self._version.local) else: return None @property def public(self) -> str: """The public portion of the version. >>> Version("1.2.3").public '1.2.3' >>> Version("1.2.3+abc").public '1.2.3' >>> Version("1.2.3+abc.dev1").public '1.2.3' """ return str(self).split("+", 1)[0] @property def base_version(self) -> str: """The "base version" of the version. >>> Version("1.2.3").base_version '1.2.3' >>> Version("1.2.3+abc").base_version '1.2.3' >>> Version("1!1.2.3+abc.dev1").base_version '1!1.2.3' The "base version" is the public version of the project without any pre or post release markers. """ parts = [] # Epoch if self.epoch != 0: parts.append(f"{self.epoch}!") # Release segment parts.append(".".join(str(x) for x in self.release)) return "".join(parts) @property def is_prerelease(self) -> bool: """Whether this version is a pre-release. >>> Version("1.2.3").is_prerelease False >>> Version("1.2.3a1").is_prerelease True >>> Version("1.2.3b1").is_prerelease True >>> Version("1.2.3rc1").is_prerelease True >>> Version("1.2.3dev1").is_prerelease True """ return self.dev is not None or self.pre is not None @property def is_postrelease(self) -> bool: """Whether this version is a post-release. >>> Version("1.2.3").is_postrelease False >>> Version("1.2.3.post1").is_postrelease True """ return self.post is not None @property def is_devrelease(self) -> bool: """Whether this version is a development release. >>> Version("1.2.3").is_devrelease False >>> Version("1.2.3.dev1").is_devrelease True """ return self.dev is not None @property def major(self) -> int: """The first item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").major 1 """ return self.release[0] if len(self.release) >= 1 else 0 @property def minor(self) -> int: """The second item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").minor 2 >>> Version("1").minor 0 """ return self.release[1] if len(self.release) >= 2 else 0 @property def micro(self) -> int: """The third item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").micro 3 >>> Version("1").micro 0 """ return self.release[2] if len(self.release) >= 3 else 0 def _parse_letter_version( letter: Optional[str], number: Union[str, bytes, SupportsInt, None] ) -> Optional[Tuple[str, int]]: if letter: # We consider there to be an implicit 0 in a pre-release if there is # not a numeral associated with it. if number is None: number = 0 # We normalize any letters to their lower case form letter = letter.lower() # We consider some words to be alternate spellings of other words and # in those cases we want to normalize the spellings to our preferred # spelling. if letter == "alpha": letter = "a" elif letter == "beta": letter = "b" elif letter in ["c", "pre", "preview"]: letter = "rc" elif letter in ["rev", "r"]: letter = "post" return letter, int(number) if not letter and number: # We assume if we are given a number, but we are not given a letter # then this is using the implicit post release syntax (e.g. 1.0-1) letter = "post" return letter, int(number) return None _local_version_separators = re.compile(r"[\._-]") def _parse_local_version(local: Optional[str]) -> Optional[LocalType]: """ Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve"). """ if local is not None: return tuple( part.lower() if not part.isdigit() else int(part) for part in _local_version_separators.split(local) ) return None def _cmpkey( epoch: int, release: Tuple[int, ...], pre: Optional[Tuple[str, int]], post: Optional[Tuple[str, int]], dev: Optional[Tuple[str, int]], local: Optional[LocalType], ) -> CmpKey: # When we compare a release version, we want to compare it with all of the # trailing zeros removed. So we'll use a reverse the list, drop all the now # leading zeros until we come to something non zero, then take the rest # re-reverse it back into the correct order and make it a tuple and use # that for our sorting key. _release = tuple( reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release)))) ) # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0. # We'll do this by abusing the pre segment, but we _only_ want to do this # if there is not a pre or a post segment. If we have one of those then # the normal sorting rules will handle this case correctly. if pre is None and post is None and dev is not None: _pre: CmpPrePostDevType = NegativeInfinity # Versions without a pre-release (except as noted above) should sort after # those with one. elif pre is None: _pre = Infinity else: _pre = pre # Versions without a post segment should sort before those with one. if post is None: _post: CmpPrePostDevType = NegativeInfinity else: _post = post # Versions without a development segment should sort after those with one. if dev is None: _dev: CmpPrePostDevType = Infinity else: _dev = dev if local is None: # Versions without a local segment should sort before those with one. _local: CmpLocalType = NegativeInfinity else: # Versions with a local segment need that segment parsed to implement # the sorting rules in PEP440. # - Alpha numeric segments sort before numeric segments # - Alpha numeric segments sort lexicographically # - Numeric segments sort numerically # - Shorter versions sort before longer versions when the prefixes # match exactly _local = tuple( (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local ) return epoch, _release, _pre, _post, _dev, _local _vendor/wheel/vendored/packaging/LICENSE 0000644 00000000305 15030122015 0014026 0 ustar 00 This software is made available under the terms of *either* of the licenses found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made under the terms of *both* these licenses. _vendor/wheel/vendored/packaging/_tokenizer.py 0000644 00000012254 15030122015 0015552 0 ustar 00 import contextlib import re from dataclasses import dataclass from typing import Dict, Iterator, NoReturn, Optional, Tuple, Union from .specifiers import Specifier @dataclass class Token: name: str text: str position: int class ParserSyntaxError(Exception): """The provided source text could not be parsed correctly.""" def __init__( self, message: str, *, source: str, span: Tuple[int, int], ) -> None: self.span = span self.message = message self.source = source super().__init__() def __str__(self) -> str: marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^" return "\n ".join([self.message, self.source, marker]) DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = { "LEFT_PARENTHESIS": r"\(", "RIGHT_PARENTHESIS": r"\)", "LEFT_BRACKET": r"\[", "RIGHT_BRACKET": r"\]", "SEMICOLON": r";", "COMMA": r",", "QUOTED_STRING": re.compile( r""" ( ('[^']*') | ("[^"]*") ) """, re.VERBOSE, ), "OP": r"(===|==|~=|!=|<=|>=|<|>)", "BOOLOP": r"\b(or|and)\b", "IN": r"\bin\b", "NOT": r"\bnot\b", "VARIABLE": re.compile( r""" \b( python_version |python_full_version |os[._]name |sys[._]platform |platform_(release|system) |platform[._](version|machine|python_implementation) |python_implementation |implementation_(name|version) |extra )\b """, re.VERBOSE, ), "SPECIFIER": re.compile( Specifier._operator_regex_str + Specifier._version_regex_str, re.VERBOSE | re.IGNORECASE, ), "AT": r"\@", "URL": r"[^ \t]+", "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b", "VERSION_PREFIX_TRAIL": r"\.\*", "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*", "WS": r"[ \t]+", "END": r"$", } class Tokenizer: """Context-sensitive token parsing. Provides methods to examine the input stream to check whether the next token matches. """ def __init__( self, source: str, *, rules: "Dict[str, Union[str, re.Pattern[str]]]", ) -> None: self.source = source self.rules: Dict[str, re.Pattern[str]] = { name: re.compile(pattern) for name, pattern in rules.items() } self.next_token: Optional[Token] = None self.position = 0 def consume(self, name: str) -> None: """Move beyond provided token name, if at current position.""" if self.check(name): self.read() def check(self, name: str, *, peek: bool = False) -> bool: """Check whether the next token has the provided name. By default, if the check succeeds, the token *must* be read before another check. If `peek` is set to `True`, the token is not loaded and would need to be checked again. """ assert ( self.next_token is None ), f"Cannot check for {name!r}, already have {self.next_token!r}" assert name in self.rules, f"Unknown token name: {name!r}" expression = self.rules[name] match = expression.match(self.source, self.position) if match is None: return False if not peek: self.next_token = Token(name, match[0], self.position) return True def expect(self, name: str, *, expected: str) -> Token: """Expect a certain token name next, failing with a syntax error otherwise. The token is *not* read. """ if not self.check(name): raise self.raise_syntax_error(f"Expected {expected}") return self.read() def read(self) -> Token: """Consume the next token and return it.""" token = self.next_token assert token is not None self.position += len(token.text) self.next_token = None return token def raise_syntax_error( self, message: str, *, span_start: Optional[int] = None, span_end: Optional[int] = None, ) -> NoReturn: """Raise ParserSyntaxError at the given position.""" span = ( self.position if span_start is None else span_start, self.position if span_end is None else span_end, ) raise ParserSyntaxError( message, source=self.source, span=span, ) @contextlib.contextmanager def enclosing_tokens( self, open_token: str, close_token: str, *, around: str ) -> Iterator[None]: if self.check(open_token): open_position = self.position self.read() else: open_position = None yield if open_position is None: return if not self.check(close_token): self.raise_syntax_error( f"Expected matching {close_token} for {open_token}, after {around}", span_start=open_position, ) self.read() _vendor/wheel/vendored/packaging/_musllinux.py 0000644 00000005162 15030122015 0015600 0 ustar 00 """PEP 656 support. This module implements logic to detect if the currently running Python is linked against musl, and what musl version is used. """ import functools import re import subprocess import sys from typing import Iterator, NamedTuple, Optional, Sequence from ._elffile import ELFFile class _MuslVersion(NamedTuple): major: int minor: int def _parse_musl_version(output: str) -> Optional[_MuslVersion]: lines = [n for n in (n.strip() for n in output.splitlines()) if n] if len(lines) < 2 or lines[0][:4] != "musl": return None m = re.match(r"Version (\d+)\.(\d+)", lines[1]) if not m: return None return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2))) @functools.lru_cache def _get_musl_version(executable: str) -> Optional[_MuslVersion]: """Detect currently-running musl runtime version. This is done by checking the specified executable's dynamic linking information, and invoking the loader to parse its output for a version string. If the loader is musl, the output would be something like:: musl libc (x86_64) Version 1.2.2 Dynamic Program Loader """ try: with open(executable, "rb") as f: ld = ELFFile(f).interpreter except (OSError, TypeError, ValueError): return None if ld is None or "musl" not in ld: return None proc = subprocess.run([ld], stderr=subprocess.PIPE, text=True) return _parse_musl_version(proc.stderr) def platform_tags(archs: Sequence[str]) -> Iterator[str]: """Generate musllinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be musllinux-compatible. :returns: An iterator of compatible musllinux tags. """ sys_musl = _get_musl_version(sys.executable) if sys_musl is None: # Python not dynamically linked against musl. return for arch in archs: for minor in range(sys_musl.minor, -1, -1): yield f"musllinux_{sys_musl.major}_{minor}_{arch}" if __name__ == "__main__": # pragma: no cover import sysconfig plat = sysconfig.get_platform() assert plat.startswith("linux-"), "not linux" print("plat:", plat) print("musl:", _get_musl_version(sys.executable)) print("tags:", end=" ") for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): print(t, end="\n ") _vendor/wheel/vendored/packaging/_elffile.py 0000644 00000006302 15030122015 0015143 0 ustar 00 """ ELF file parser. This provides a class ``ELFFile`` that parses an ELF executable in a similar interface to ``ZipFile``. Only the read interface is implemented. Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html """ import enum import os import struct from typing import IO, Optional, Tuple class ELFInvalid(ValueError): pass class EIClass(enum.IntEnum): C32 = 1 C64 = 2 class EIData(enum.IntEnum): Lsb = 1 Msb = 2 class EMachine(enum.IntEnum): I386 = 3 S390 = 22 Arm = 40 X8664 = 62 AArc64 = 183 class ELFFile: """ Representation of an ELF executable. """ def __init__(self, f: IO[bytes]) -> None: self._f = f try: ident = self._read("16B") except struct.error: raise ELFInvalid("unable to parse identification") magic = bytes(ident[:4]) if magic != b"\x7fELF": raise ELFInvalid(f"invalid magic: {magic!r}") self.capacity = ident[4] # Format for program header (bitness). self.encoding = ident[5] # Data structure encoding (endianness). try: # e_fmt: Format for program header. # p_fmt: Format for section header. # p_idx: Indexes to find p_type, p_offset, and p_filesz. e_fmt, self._p_fmt, self._p_idx = { (1, 1): ("<HHIIIIIHHH", "<IIIIIIII", (0, 1, 4)), # 32-bit LSB. (1, 2): (">HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)), # 32-bit MSB. (2, 1): ("<HHIQQQIHHH", "<IIQQQQQQ", (0, 2, 5)), # 64-bit LSB. (2, 2): (">HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. }[(self.capacity, self.encoding)] except KeyError: raise ELFInvalid( f"unrecognized capacity ({self.capacity}) or " f"encoding ({self.encoding})" ) try: ( _, self.machine, # Architecture type. _, _, self._e_phoff, # Offset of program header. _, self.flags, # Processor-specific flags. _, self._e_phentsize, # Size of section. self._e_phnum, # Number of sections. ) = self._read(e_fmt) except struct.error as e: raise ELFInvalid("unable to parse machine and section information") from e def _read(self, fmt: str) -> Tuple[int, ...]: return struct.unpack(fmt, self._f.read(struct.calcsize(fmt))) @property def interpreter(self) -> Optional[str]: """ The path recorded in the ``PT_INTERP`` section header. """ for index in range(self._e_phnum): self._f.seek(self._e_phoff + self._e_phentsize * index) try: data = self._read(self._p_fmt) except struct.error: continue if data[self._p_idx[0]] != 3: # Not PT_INTERP. continue self._f.seek(data[self._p_idx[1]]) return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0") return None _vendor/wheel/vendored/packaging/tags.py 0000644 00000045006 15030122015 0014340 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. import logging import platform import re import struct import subprocess import sys import sysconfig from importlib.machinery import EXTENSION_SUFFIXES from typing import ( Dict, FrozenSet, Iterable, Iterator, List, Optional, Sequence, Tuple, Union, cast, ) from . import _manylinux, _musllinux logger = logging.getLogger(__name__) PythonVersion = Sequence[int] MacVersion = Tuple[int, int] INTERPRETER_SHORT_NAMES: Dict[str, str] = { "python": "py", # Generic. "cpython": "cp", "pypy": "pp", "ironpython": "ip", "jython": "jy", } _32_BIT_INTERPRETER = struct.calcsize("P") == 4 class Tag: """ A representation of the tag triple for a wheel. Instances are considered immutable and thus are hashable. Equality checking is also supported. """ __slots__ = ["_interpreter", "_abi", "_platform", "_hash"] def __init__(self, interpreter: str, abi: str, platform: str) -> None: self._interpreter = interpreter.lower() self._abi = abi.lower() self._platform = platform.lower() # The __hash__ of every single element in a Set[Tag] will be evaluated each time # that a set calls its `.disjoint()` method, which may be called hundreds of # times when scanning a page of links for packages with tags matching that # Set[Tag]. Pre-computing the value here produces significant speedups for # downstream consumers. self._hash = hash((self._interpreter, self._abi, self._platform)) @property def interpreter(self) -> str: return self._interpreter @property def abi(self) -> str: return self._abi @property def platform(self) -> str: return self._platform def __eq__(self, other: object) -> bool: if not isinstance(other, Tag): return NotImplemented return ( (self._hash == other._hash) # Short-circuit ASAP for perf reasons. and (self._platform == other._platform) and (self._abi == other._abi) and (self._interpreter == other._interpreter) ) def __hash__(self) -> int: return self._hash def __str__(self) -> str: return f"{self._interpreter}-{self._abi}-{self._platform}" def __repr__(self) -> str: return f"<{self} @ {id(self)}>" def parse_tag(tag: str) -> FrozenSet[Tag]: """ Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. Returning a set is required due to the possibility that the tag is a compressed tag set. """ tags = set() interpreters, abis, platforms = tag.split("-") for interpreter in interpreters.split("."): for abi in abis.split("."): for platform_ in platforms.split("."): tags.add(Tag(interpreter, abi, platform_)) return frozenset(tags) def _get_config_var(name: str, warn: bool = False) -> Union[int, str, None]: value: Union[int, str, None] = sysconfig.get_config_var(name) if value is None and warn: logger.debug( "Config variable '%s' is unset, Python ABI tag may be incorrect", name ) return value def _normalize_string(string: str) -> str: return string.replace(".", "_").replace("-", "_").replace(" ", "_") def _is_threaded_cpython(abis: List[str]) -> bool: """ Determine if the ABI corresponds to a threaded (`--disable-gil`) build. The threaded builds are indicated by a "t" in the abiflags. """ if len(abis) == 0: return False # expect e.g., cp313 m = re.match(r"cp\d+(.*)", abis[0]) if not m: return False abiflags = m.group(1) return "t" in abiflags def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool: """ Determine if the Python version supports abi3. PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) builds do not support abi3. """ return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]: py_version = tuple(py_version) # To allow for version comparison. abis = [] version = _version_nodot(py_version[:2]) threading = debug = pymalloc = ucs4 = "" with_debug = _get_config_var("Py_DEBUG", warn) has_refcount = hasattr(sys, "gettotalrefcount") # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled # extension modules is the best option. # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 has_ext = "_d.pyd" in EXTENSION_SUFFIXES if with_debug or (with_debug is None and (has_refcount or has_ext)): debug = "d" if py_version >= (3, 13) and _get_config_var("Py_GIL_DISABLED", warn): threading = "t" if py_version < (3, 8): with_pymalloc = _get_config_var("WITH_PYMALLOC", warn) if with_pymalloc or with_pymalloc is None: pymalloc = "m" if py_version < (3, 3): unicode_size = _get_config_var("Py_UNICODE_SIZE", warn) if unicode_size == 4 or ( unicode_size is None and sys.maxunicode == 0x10FFFF ): ucs4 = "u" elif debug: # Debug builds can also load "normal" extension modules. # We can also assume no UCS-4 or pymalloc requirement. abis.append(f"cp{version}{threading}") abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}") return abis def cpython_tags( python_version: Optional[PythonVersion] = None, abis: Optional[Iterable[str]] = None, platforms: Optional[Iterable[str]] = None, *, warn: bool = False, ) -> Iterator[Tag]: """ Yields the tags for a CPython interpreter. The tags consist of: - cp<python_version>-<abi>-<platform> - cp<python_version>-abi3-<platform> - cp<python_version>-none-<platform> - cp<less than python_version>-abi3-<platform> # Older Python versions down to 3.2. If python_version only specifies a major version then user-provided ABIs and the 'none' ABItag will be used. If 'abi3' or 'none' are specified in 'abis' then they will be yielded at their normal position and not at the beginning. """ if not python_version: python_version = sys.version_info[:2] interpreter = f"cp{_version_nodot(python_version[:2])}" if abis is None: if len(python_version) > 1: abis = _cpython_abis(python_version, warn) else: abis = [] abis = list(abis) # 'abi3' and 'none' are explicitly handled later. for explicit_abi in ("abi3", "none"): try: abis.remove(explicit_abi) except ValueError: pass platforms = list(platforms or platform_tags()) for abi in abis: for platform_ in platforms: yield Tag(interpreter, abi, platform_) threading = _is_threaded_cpython(abis) use_abi3 = _abi3_applies(python_version, threading) if use_abi3: yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms) yield from (Tag(interpreter, "none", platform_) for platform_ in platforms) if use_abi3: for minor_version in range(python_version[1] - 1, 1, -1): for platform_ in platforms: interpreter = "cp{version}".format( version=_version_nodot((python_version[0], minor_version)) ) yield Tag(interpreter, "abi3", platform_) def _generic_abi() -> List[str]: """ Return the ABI tag based on EXT_SUFFIX. """ # The following are examples of `EXT_SUFFIX`. # We want to keep the parts which are related to the ABI and remove the # parts which are related to the platform: # - linux: '.cpython-310-x86_64-linux-gnu.so' => cp310 # - mac: '.cpython-310-darwin.so' => cp310 # - win: '.cp310-win_amd64.pyd' => cp310 # - win: '.pyd' => cp37 (uses _cpython_abis()) # - pypy: '.pypy38-pp73-x86_64-linux-gnu.so' => pypy38_pp73 # - graalpy: '.graalpy-38-native-x86_64-darwin.dylib' # => graalpy_38_native ext_suffix = _get_config_var("EXT_SUFFIX", warn=True) if not isinstance(ext_suffix, str) or ext_suffix[0] != ".": raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") parts = ext_suffix.split(".") if len(parts) < 3: # CPython3.7 and earlier uses ".pyd" on Windows. return _cpython_abis(sys.version_info[:2]) soabi = parts[1] if soabi.startswith("cpython"): # non-windows abi = "cp" + soabi.split("-")[1] elif soabi.startswith("cp"): # windows abi = soabi.split("-")[0] elif soabi.startswith("pypy"): abi = "-".join(soabi.split("-")[:2]) elif soabi.startswith("graalpy"): abi = "-".join(soabi.split("-")[:3]) elif soabi: # pyston, ironpython, others? abi = soabi else: return [] return [_normalize_string(abi)] def generic_tags( interpreter: Optional[str] = None, abis: Optional[Iterable[str]] = None, platforms: Optional[Iterable[str]] = None, *, warn: bool = False, ) -> Iterator[Tag]: """ Yields the tags for a generic interpreter. The tags consist of: - <interpreter>-<abi>-<platform> The "none" ABI will be added if it was not explicitly provided. """ if not interpreter: interp_name = interpreter_name() interp_version = interpreter_version(warn=warn) interpreter = "".join([interp_name, interp_version]) if abis is None: abis = _generic_abi() else: abis = list(abis) platforms = list(platforms or platform_tags()) if "none" not in abis: abis.append("none") for abi in abis: for platform_ in platforms: yield Tag(interpreter, abi, platform_) def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: """ Yields Python versions in descending order. After the latest version, the major-only version will be yielded, and then all previous versions of that major version. """ if len(py_version) > 1: yield f"py{_version_nodot(py_version[:2])}" yield f"py{py_version[0]}" if len(py_version) > 1: for minor in range(py_version[1] - 1, -1, -1): yield f"py{_version_nodot((py_version[0], minor))}" def compatible_tags( python_version: Optional[PythonVersion] = None, interpreter: Optional[str] = None, platforms: Optional[Iterable[str]] = None, ) -> Iterator[Tag]: """ Yields the sequence of tags that are compatible with a specific version of Python. The tags consist of: - py*-none-<platform> - <interpreter>-none-any # ... if `interpreter` is provided. - py*-none-any """ if not python_version: python_version = sys.version_info[:2] platforms = list(platforms or platform_tags()) for version in _py_interpreter_range(python_version): for platform_ in platforms: yield Tag(version, "none", platform_) if interpreter: yield Tag(interpreter, "none", "any") for version in _py_interpreter_range(python_version): yield Tag(version, "none", "any") def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: if not is_32bit: return arch if arch.startswith("ppc"): return "ppc" return "i386" def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> List[str]: formats = [cpu_arch] if cpu_arch == "x86_64": if version < (10, 4): return [] formats.extend(["intel", "fat64", "fat32"]) elif cpu_arch == "i386": if version < (10, 4): return [] formats.extend(["intel", "fat32", "fat"]) elif cpu_arch == "ppc64": # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? if version > (10, 5) or version < (10, 4): return [] formats.append("fat64") elif cpu_arch == "ppc": if version > (10, 6): return [] formats.extend(["fat32", "fat"]) if cpu_arch in {"arm64", "x86_64"}: formats.append("universal2") if cpu_arch in {"x86_64", "i386", "ppc64", "ppc", "intel"}: formats.append("universal") return formats def mac_platforms( version: Optional[MacVersion] = None, arch: Optional[str] = None ) -> Iterator[str]: """ Yields the platform tags for a macOS system. The `version` parameter is a two-item tuple specifying the macOS version to generate platform tags for. The `arch` parameter is the CPU architecture to generate platform tags for. Both parameters default to the appropriate value for the current system. """ version_str, _, cpu_arch = platform.mac_ver() if version is None: version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2]))) if version == (10, 16): # When built against an older macOS SDK, Python will report macOS 10.16 # instead of the real version. version_str = subprocess.run( [ sys.executable, "-sS", "-c", "import platform; print(platform.mac_ver()[0])", ], check=True, env={"SYSTEM_VERSION_COMPAT": "0"}, stdout=subprocess.PIPE, text=True, ).stdout version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2]))) else: version = version if arch is None: arch = _mac_arch(cpu_arch) else: arch = arch if (10, 0) <= version and version < (11, 0): # Prior to Mac OS 11, each yearly release of Mac OS bumped the # "minor" version number. The major version was always 10. for minor_version in range(version[1], -1, -1): compat_version = 10, minor_version binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield "macosx_{major}_{minor}_{binary_format}".format( major=10, minor=minor_version, binary_format=binary_format ) if version >= (11, 0): # Starting with Mac OS 11, each yearly release bumps the major version # number. The minor versions are now the midyear updates. for major_version in range(version[0], 10, -1): compat_version = major_version, 0 binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield "macosx_{major}_{minor}_{binary_format}".format( major=major_version, minor=0, binary_format=binary_format ) if version >= (11, 0): # Mac OS 11 on x86_64 is compatible with binaries from previous releases. # Arm64 support was introduced in 11.0, so no Arm binaries from previous # releases exist. # # However, the "universal2" binary format can have a # macOS version earlier than 11.0 when the x86_64 part of the binary supports # that version of macOS. if arch == "x86_64": for minor_version in range(16, 3, -1): compat_version = 10, minor_version binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield "macosx_{major}_{minor}_{binary_format}".format( major=compat_version[0], minor=compat_version[1], binary_format=binary_format, ) else: for minor_version in range(16, 3, -1): compat_version = 10, minor_version binary_format = "universal2" yield "macosx_{major}_{minor}_{binary_format}".format( major=compat_version[0], minor=compat_version[1], binary_format=binary_format, ) def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]: linux = _normalize_string(sysconfig.get_platform()) if not linux.startswith("linux_"): # we should never be here, just yield the sysconfig one and return yield linux return if is_32bit: if linux == "linux_x86_64": linux = "linux_i686" elif linux == "linux_aarch64": linux = "linux_armv8l" _, arch = linux.split("_", 1) archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch]) yield from _manylinux.platform_tags(archs) yield from _musllinux.platform_tags(archs) for arch in archs: yield f"linux_{arch}" def _generic_platforms() -> Iterator[str]: yield _normalize_string(sysconfig.get_platform()) def platform_tags() -> Iterator[str]: """ Provides the platform tags for this installation. """ if platform.system() == "Darwin": return mac_platforms() elif platform.system() == "Linux": return _linux_platforms() else: return _generic_platforms() def interpreter_name() -> str: """ Returns the name of the running interpreter. Some implementations have a reserved, two-letter abbreviation which will be returned when appropriate. """ name = sys.implementation.name return INTERPRETER_SHORT_NAMES.get(name) or name def interpreter_version(*, warn: bool = False) -> str: """ Returns the version of the running interpreter. """ version = _get_config_var("py_version_nodot", warn=warn) if version: version = str(version) else: version = _version_nodot(sys.version_info[:2]) return version def _version_nodot(version: PythonVersion) -> str: return "".join(map(str, version)) def sys_tags(*, warn: bool = False) -> Iterator[Tag]: """ Returns the sequence of tag triples for the running interpreter. The order of the sequence corresponds to priority order for the interpreter, from most to least important. """ interp_name = interpreter_name() if interp_name == "cp": yield from cpython_tags(warn=warn) else: yield from generic_tags() if interp_name == "pp": interp = "pp3" elif interp_name == "cp": interp = "cp" + interpreter_version(warn=warn) else: interp = None yield from compatible_tags(interpreter=interp) _vendor/wheel/vendored/packaging/specifiers.py 0000644 00000115542 15030122015 0015541 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. """ .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version """ import abc import itertools import re from typing import Callable, Iterable, Iterator, List, Optional, Tuple, TypeVar, Union from .utils import canonicalize_version from .version import Version UnparsedVersion = Union[Version, str] UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion) CallableOperator = Callable[[Version, str], bool] def _coerce_version(version: UnparsedVersion) -> Version: if not isinstance(version, Version): version = Version(version) return version class InvalidSpecifier(ValueError): """ Raised when attempting to create a :class:`Specifier` with a specifier string that is invalid. >>> Specifier("lolwat") Traceback (most recent call last): ... packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' """ class BaseSpecifier(metaclass=abc.ABCMeta): @abc.abstractmethod def __str__(self) -> str: """ Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. """ @abc.abstractmethod def __hash__(self) -> int: """ Returns a hash value for this Specifier-like object. """ @abc.abstractmethod def __eq__(self, other: object) -> bool: """ Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. """ @property @abc.abstractmethod def prereleases(self) -> Optional[bool]: """Whether or not pre-releases as a whole are allowed. This can be set to either ``True`` or ``False`` to explicitly enable or disable prereleases or it can be set to ``None`` (the default) to use default semantics. """ @prereleases.setter def prereleases(self, value: bool) -> None: """Setter for :attr:`prereleases`. :param value: The value to set. """ @abc.abstractmethod def contains(self, item: str, prereleases: Optional[bool] = None) -> bool: """ Determines if the given item is contained within this specifier. """ @abc.abstractmethod def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None ) -> Iterator[UnparsedVersionVar]: """ Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. """ class Specifier(BaseSpecifier): """This class abstracts handling of version specifiers. .. tip:: It is generally not required to instantiate this manually. You should instead prefer to work with :class:`SpecifierSet` instead, which can parse comma-separated version specifiers (which is what package metadata contains). """ _operator_regex_str = r""" (?P<operator>(~=|==|!=|<=|>=|<|>|===)) """ _version_regex_str = r""" (?P<version> (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. (?<====) # Only match for the identity operator \s* [^\s;)]* # The arbitrary version can be just about anything, # we match everything except for whitespace, a # semi-colon for marker support, and a closing paren # since versions can be enclosed in them. ) | (?: # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. (?<===|!=) # Only match for equals and not equals \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release # You cannot use a wild card and a pre-release, post-release, a dev or # local version together so group them with a | and make them optional. (?: \.\* # Wild card syntax of .* | (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local )? ) | (?: # The compatible operator requires at least two digits in the # release segment. (?<=~=) # Only match for the compatible operator \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) | (?: # All other operators only allow a sub set of what the # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. (?<!==|!=|~=) # We have special cases for these # operators so we want to make sure they # don't match here. \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) """ _regex = re.compile( r"^\s*" + _operator_regex_str + _version_regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE, ) _operators = { "~=": "compatible", "==": "equal", "!=": "not_equal", "<=": "less_than_equal", ">=": "greater_than_equal", "<": "less_than", ">": "greater_than", "===": "arbitrary", } def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None: """Initialize a Specifier instance. :param spec: The string representation of a specifier which will be parsed and normalized before use. :param prereleases: This tells the specifier if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given specifier is invalid (i.e. bad syntax). """ match = self._regex.search(spec) if not match: raise InvalidSpecifier(f"Invalid specifier: '{spec}'") self._spec: Tuple[str, str] = ( match.group("operator").strip(), match.group("version").strip(), ) # Store whether or not this Specifier should accept prereleases self._prereleases = prereleases # https://github.com/python/mypy/pull/13475#pullrequestreview-1079784515 @property # type: ignore[override] def prereleases(self) -> bool: # If there is an explicit prereleases set for this, then we'll just # blindly use that. if self._prereleases is not None: return self._prereleases # Look at all of our specifiers and determine if they are inclusive # operators, and if they are if they are including an explicit # prerelease. operator, version = self._spec if operator in ["==", ">=", "<=", "~=", "==="]: # The == specifier can include a trailing .*, if it does we # want to remove before parsing. if operator == "==" and version.endswith(".*"): version = version[:-2] # Parse the version, and if it is a pre-release than this # specifier allows pre-releases. if Version(version).is_prerelease: return True return False @prereleases.setter def prereleases(self, value: bool) -> None: self._prereleases = value @property def operator(self) -> str: """The operator of this specifier. >>> Specifier("==1.2.3").operator '==' """ return self._spec[0] @property def version(self) -> str: """The version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' """ return self._spec[1] def __repr__(self) -> str: """A representation of the Specifier that shows all internal state. >>> Specifier('>=1.0.0') <Specifier('>=1.0.0')> >>> Specifier('>=1.0.0', prereleases=False) <Specifier('>=1.0.0', prereleases=False)> >>> Specifier('>=1.0.0', prereleases=True) <Specifier('>=1.0.0', prereleases=True)> """ pre = ( f", prereleases={self.prereleases!r}" if self._prereleases is not None else "" ) return f"<{self.__class__.__name__}({str(self)!r}{pre})>" def __str__(self) -> str: """A string representation of the Specifier that can be round-tripped. >>> str(Specifier('>=1.0.0')) '>=1.0.0' >>> str(Specifier('>=1.0.0', prereleases=False)) '>=1.0.0' """ return "{}{}".format(*self._spec) @property def _canonical_spec(self) -> Tuple[str, str]: canonical_version = canonicalize_version( self._spec[1], strip_trailing_zero=(self._spec[0] != "~="), ) return self._spec[0], canonical_version def __hash__(self) -> int: return hash(self._canonical_spec) def __eq__(self, other: object) -> bool: """Whether or not the two Specifier-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") True >>> (Specifier("==1.2.3", prereleases=False) == ... Specifier("==1.2.3", prereleases=True)) True >>> Specifier("==1.2.3") == "==1.2.3" True >>> Specifier("==1.2.3") == Specifier("==1.2.4") False >>> Specifier("==1.2.3") == Specifier("~=1.2.3") False """ if isinstance(other, str): try: other = self.__class__(str(other)) except InvalidSpecifier: return NotImplemented elif not isinstance(other, self.__class__): return NotImplemented return self._canonical_spec == other._canonical_spec def _get_operator(self, op: str) -> CallableOperator: operator_callable: CallableOperator = getattr( self, f"_compare_{self._operators[op]}" ) return operator_callable def _compare_compatible(self, prospective: Version, spec: str) -> bool: # Compatible releases have an equivalent combination of >= and ==. That # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to # implement this in terms of the other specifiers instead of # implementing it ourselves. The only thing we need to do is construct # the other specifiers. # We want everything but the last item in the version, but we want to # ignore suffix segments. prefix = _version_join( list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] ) # Add the prefix notation to the end of our string prefix += ".*" return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( prospective, prefix ) def _compare_equal(self, prospective: Version, spec: str) -> bool: # We need special logic to handle prefix matching if spec.endswith(".*"): # In the case of prefix matching we want to ignore local segment. normalized_prospective = canonicalize_version( prospective.public, strip_trailing_zero=False ) # Get the normalized version string ignoring the trailing .* normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False) # Split the spec out by bangs and dots, and pretend that there is # an implicit dot in between a release segment and a pre-release segment. split_spec = _version_split(normalized_spec) # Split the prospective version out by bangs and dots, and pretend # that there is an implicit dot in between a release segment and # a pre-release segment. split_prospective = _version_split(normalized_prospective) # 0-pad the prospective version before shortening it to get the correct # shortened version. padded_prospective, _ = _pad_version(split_prospective, split_spec) # Shorten the prospective version to be the same length as the spec # so that we can determine if the specifier is a prefix of the # prospective version or not. shortened_prospective = padded_prospective[: len(split_spec)] return shortened_prospective == split_spec else: # Convert our spec string into a Version spec_version = Version(spec) # If the specifier does not have a local segment, then we want to # act as if the prospective version also does not have a local # segment. if not spec_version.local: prospective = Version(prospective.public) return prospective == spec_version def _compare_not_equal(self, prospective: Version, spec: str) -> bool: return not self._compare_equal(prospective, spec) def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool: # NB: Local version identifiers are NOT permitted in the version # specifier, so local version labels can be universally removed from # the prospective version. return Version(prospective.public) <= Version(spec) def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool: # NB: Local version identifiers are NOT permitted in the version # specifier, so local version labels can be universally removed from # the prospective version. return Version(prospective.public) >= Version(spec) def _compare_less_than(self, prospective: Version, spec_str: str) -> bool: # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec_str) # Check to see if the prospective version is less than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective < spec: return False # This special case is here so that, unless the specifier itself # includes is a pre-release version, that we do not accept pre-release # versions for the version mentioned in the specifier (e.g. <3.1 should # not match 3.1.dev0, but should match 3.0.dev0). if not spec.is_prerelease and prospective.is_prerelease: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # less than the spec version *and* it's not a pre-release of the same # version in the spec. return True def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool: # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec_str) # Check to see if the prospective version is greater than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective > spec: return False # This special case is here so that, unless the specifier itself # includes is a post-release version, that we do not accept # post-release versions for the version mentioned in the specifier # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). if not spec.is_postrelease and prospective.is_postrelease: if Version(prospective.base_version) == Version(spec.base_version): return False # Ensure that we do not allow a local version of the version mentioned # in the specifier, which is technically greater than, to match. if prospective.local is not None: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # greater than the spec version *and* it's not a pre-release of the # same version in the spec. return True def _compare_arbitrary(self, prospective: Version, spec: str) -> bool: return str(prospective).lower() == str(spec).lower() def __contains__(self, item: Union[str, Version]) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in Specifier(">=1.2.3") True >>> Version("1.2.3") in Specifier(">=1.2.3") True >>> "1.0.0" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True """ return self.contains(item) def contains( self, item: UnparsedVersion, prereleases: Optional[bool] = None ) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this Specifier. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> Specifier(">=1.2.3").contains("1.2.3") True >>> Specifier(">=1.2.3").contains(Version("1.2.3")) True >>> Specifier(">=1.2.3").contains("1.0.0") False >>> Specifier(">=1.2.3").contains("1.3.0a1") False >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") True >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) True """ # Determine if prereleases are to be allowed or not. if prereleases is None: prereleases = self.prereleases # Normalize item to a Version, this allows us to have a shortcut for # "2.0" in Specifier(">=2") normalized_item = _coerce_version(item) # Determine if we should be supporting prereleases in this specifier # or not, if we do not support prereleases than we can short circuit # logic if this version is a prereleases. if normalized_item.is_prerelease and not prereleases: return False # Actually do the comparison to determine if this item is contained # within this Specifier or not. operator_callable: CallableOperator = self._get_operator(self.operator) return operator_callable(normalized_item, self.version) def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None ) -> Iterator[UnparsedVersionVar]: """Filter items in the given iterable, that match the specifier. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(Specifier().contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) ['1.2.3', '1.3', <Version('1.4')>] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) ['1.5a1'] >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] """ yielded = False found_prereleases = [] kw = {"prereleases": prereleases if prereleases is not None else True} # Attempt to iterate over all the values in the iterable and if any of # them match, yield them. for version in iterable: parsed_version = _coerce_version(version) if self.contains(parsed_version, **kw): # If our version is a prerelease, and we were not set to allow # prereleases, then we'll store it for later in case nothing # else matches this specifier. if parsed_version.is_prerelease and not ( prereleases or self.prereleases ): found_prereleases.append(version) # Either this is not a prerelease, or we should have been # accepting prereleases from the beginning. else: yielded = True yield version # Now that we've iterated over everything, determine if we've yielded # any values, and if we have not and we have any prereleases stored up # then we will go ahead and yield the prereleases. if not yielded and found_prereleases: for version in found_prereleases: yield version _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") def _version_split(version: str) -> List[str]: """Split version into components. The split components are intended for version comparison. The logic does not attempt to retain the original version string, so joining the components back with :func:`_version_join` may not produce the original version string. """ result: List[str] = [] epoch, _, rest = version.rpartition("!") result.append(epoch or "0") for item in rest.split("."): match = _prefix_regex.search(item) if match: result.extend(match.groups()) else: result.append(item) return result def _version_join(components: List[str]) -> str: """Join split version components into a version string. This function assumes the input came from :func:`_version_split`, where the first component must be the epoch (either empty or numeric), and all other components numeric. """ epoch, *rest = components return f"{epoch}!{'.'.join(rest)}" def _is_not_suffix(segment: str) -> bool: return not any( segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post") ) def _pad_version(left: List[str], right: List[str]) -> Tuple[List[str], List[str]]: left_split, right_split = [], [] # Get the release segment of our versions left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) # Get the rest of our versions left_split.append(left[len(left_split[0]) :]) right_split.append(right[len(right_split[0]) :]) # Insert our padding left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) return ( list(itertools.chain.from_iterable(left_split)), list(itertools.chain.from_iterable(right_split)), ) class SpecifierSet(BaseSpecifier): """This class abstracts handling of a set of version specifiers. It can be passed a single specifier (``>=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. """ def __init__( self, specifiers: str = "", prereleases: Optional[bool] = None ) -> None: """Initialize a SpecifierSet instance. :param specifiers: The string representation of a specifier or a comma-separated list of specifiers which will be parsed and normalized before use. :param prereleases: This tells the SpecifierSet if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given ``specifiers`` are not parseable than this exception will be raised. """ # Split on `,` to break each individual specifier into it's own item, and # strip each item to remove leading/trailing whitespace. split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] # Make each individual specifier a Specifier and save in a frozen set for later. self._specs = frozenset(map(Specifier, split_specifiers)) # Store our prereleases value so we can use it later to determine if # we accept prereleases or not. self._prereleases = prereleases @property def prereleases(self) -> Optional[bool]: # If we have been given an explicit prerelease modifier, then we'll # pass that through here. if self._prereleases is not None: return self._prereleases # If we don't have any specifiers, and we don't have a forced value, # then we'll just return None since we don't know if this should have # pre-releases or not. if not self._specs: return None # Otherwise we'll see if any of the given specifiers accept # prereleases, if any of them do we'll return True, otherwise False. return any(s.prereleases for s in self._specs) @prereleases.setter def prereleases(self, value: bool) -> None: self._prereleases = value def __repr__(self) -> str: """A representation of the specifier set that shows all internal state. Note that the ordering of the individual specifiers within the set may not match the input string. >>> SpecifierSet('>=1.0.0,!=2.0.0') <SpecifierSet('!=2.0.0,>=1.0.0')> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)> """ pre = ( f", prereleases={self.prereleases!r}" if self._prereleases is not None else "" ) return f"<SpecifierSet({str(self)!r}{pre})>" def __str__(self) -> str: """A string representation of the specifier set that can be round-tripped. Note that the ordering of the individual specifiers within the set may not match the input string. >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) '!=1.0.1,>=1.0.0' >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) '!=1.0.1,>=1.0.0' """ return ",".join(sorted(str(s) for s in self._specs)) def __hash__(self) -> int: return hash(self._specs) def __and__(self, other: Union["SpecifierSet", str]) -> "SpecifierSet": """Return a SpecifierSet which is a combination of the two sets. :param other: The other object to combine with. >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> """ if isinstance(other, str): other = SpecifierSet(other) elif not isinstance(other, SpecifierSet): return NotImplemented specifier = SpecifierSet() specifier._specs = frozenset(self._specs | other._specs) if self._prereleases is None and other._prereleases is not None: specifier._prereleases = other._prereleases elif self._prereleases is not None and other._prereleases is None: specifier._prereleases = self._prereleases elif self._prereleases == other._prereleases: specifier._prereleases = self._prereleases else: raise ValueError( "Cannot combine SpecifierSets with True and False prerelease " "overrides." ) return specifier def __eq__(self, other: object) -> bool: """Whether or not the two SpecifierSet-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") True >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) True >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" True >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") False >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") False """ if isinstance(other, (str, Specifier)): other = SpecifierSet(str(other)) elif not isinstance(other, SpecifierSet): return NotImplemented return self._specs == other._specs def __len__(self) -> int: """Returns the number of specifiers in this specifier set.""" return len(self._specs) def __iter__(self) -> Iterator[Specifier]: """ Returns an iterator over all the underlying :class:`Specifier` instances in this specifier set. >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) [<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>] """ return iter(self._specs) def __contains__(self, item: UnparsedVersion) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") True >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") True >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) True """ return self.contains(item) def contains( self, item: UnparsedVersion, prereleases: Optional[bool] = None, installed: Optional[bool] = None, ) -> bool: """Return whether or not the item is contained in this SpecifierSet. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this SpecifierSet. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") False >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") False >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) True """ # Ensure that our item is a Version instance. if not isinstance(item, Version): item = Version(item) # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # We can determine if we're going to allow pre-releases by looking to # see if any of the underlying items supports them. If none of them do # and this item is a pre-release then we do not allow it and we can # short circuit that here. # Note: This means that 1.0.dev1 would not be contained in something # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 if not prereleases and item.is_prerelease: return False if installed and item.is_prerelease: item = Version(item.base_version) # We simply dispatch to the underlying specs here to make sure that the # given version is contained within all of them. # Note: This use of all() here means that an empty set of specifiers # will always return True, this is an explicit design decision. return all(s.contains(item, prereleases=prereleases) for s in self._specs) def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None ) -> Iterator[UnparsedVersionVar]: """Filter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) ['1.3', <Version('1.4')>] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) [] >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet("").filter(["1.5a1"])) ['1.5a1'] >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] """ # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # If we have any specifiers, then we want to wrap our iterable in the # filter method for each one, this will act as a logical AND amongst # each specifier. if self._specs: for spec in self._specs: iterable = spec.filter(iterable, prereleases=bool(prereleases)) return iter(iterable) # If we do not have any specifiers, then we need to have a rough filter # which will filter out any pre-releases, unless there are no final # releases. else: filtered: List[UnparsedVersionVar] = [] found_prereleases: List[UnparsedVersionVar] = [] for item in iterable: parsed_version = _coerce_version(item) # Store any item which is a pre-release for later unless we've # already found a final version or we are accepting prereleases if parsed_version.is_prerelease and not prereleases: if not filtered: found_prereleases.append(item) else: filtered.append(item) # If we've found no items except for pre-releases, then we'll go # ahead and use the pre-releases if not filtered and found_prereleases and prereleases is None: return iter(found_prereleases) return iter(filtered) _vendor/wheel/vendored/packaging/__init__.py 0000644 00000000000 15030122015 0015122 0 ustar 00 _vendor/wheel/vendored/packaging/utils.py 0000644 00000012224 15030122015 0014536 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. import re from typing import FrozenSet, NewType, Tuple, Union, cast from .tags import Tag, parse_tag from .version import InvalidVersion, Version BuildTag = Union[Tuple[()], Tuple[int, str]] NormalizedName = NewType("NormalizedName", str) class InvalidName(ValueError): """ An invalid distribution name; users should refer to the packaging user guide. """ class InvalidWheelFilename(ValueError): """ An invalid wheel filename was found, users should refer to PEP 427. """ class InvalidSdistFilename(ValueError): """ An invalid sdist filename was found, users should refer to the packaging user guide. """ # Core metadata spec for `Name` _validate_regex = re.compile( r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE ) _canonicalize_regex = re.compile(r"[-_.]+") _normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$") # PEP 427: The build number must start with a digit. _build_tag_regex = re.compile(r"(\d+)(.*)") def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: if validate and not _validate_regex.match(name): raise InvalidName(f"name is invalid: {name!r}") # This is taken from PEP 503. value = _canonicalize_regex.sub("-", name).lower() return cast(NormalizedName, value) def is_normalized_name(name: str) -> bool: return _normalized_regex.match(name) is not None def canonicalize_version( version: Union[Version, str], *, strip_trailing_zero: bool = True ) -> str: """ This is very similar to Version.__str__, but has one subtle difference with the way it handles the release segment. """ if isinstance(version, str): try: parsed = Version(version) except InvalidVersion: # Legacy versions cannot be normalized return version else: parsed = version parts = [] # Epoch if parsed.epoch != 0: parts.append(f"{parsed.epoch}!") # Release segment release_segment = ".".join(str(x) for x in parsed.release) if strip_trailing_zero: # NB: This strips trailing '.0's to normalize release_segment = re.sub(r"(\.0)+$", "", release_segment) parts.append(release_segment) # Pre-release if parsed.pre is not None: parts.append("".join(str(x) for x in parsed.pre)) # Post-release if parsed.post is not None: parts.append(f".post{parsed.post}") # Development release if parsed.dev is not None: parts.append(f".dev{parsed.dev}") # Local version segment if parsed.local is not None: parts.append(f"+{parsed.local}") return "".join(parts) def parse_wheel_filename( filename: str, ) -> Tuple[NormalizedName, Version, BuildTag, FrozenSet[Tag]]: if not filename.endswith(".whl"): raise InvalidWheelFilename( f"Invalid wheel filename (extension must be '.whl'): {filename}" ) filename = filename[:-4] dashes = filename.count("-") if dashes not in (4, 5): raise InvalidWheelFilename( f"Invalid wheel filename (wrong number of parts): {filename}" ) parts = filename.split("-", dashes - 2) name_part = parts[0] # See PEP 427 for the rules on escaping the project name. if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: raise InvalidWheelFilename(f"Invalid project name: {filename}") name = canonicalize_name(name_part) try: version = Version(parts[1]) except InvalidVersion as e: raise InvalidWheelFilename( f"Invalid wheel filename (invalid version): {filename}" ) from e if dashes == 5: build_part = parts[2] build_match = _build_tag_regex.match(build_part) if build_match is None: raise InvalidWheelFilename( f"Invalid build number: {build_part} in '{filename}'" ) build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) else: build = () tags = parse_tag(parts[-1]) return (name, version, build, tags) def parse_sdist_filename(filename: str) -> Tuple[NormalizedName, Version]: if filename.endswith(".tar.gz"): file_stem = filename[: -len(".tar.gz")] elif filename.endswith(".zip"): file_stem = filename[: -len(".zip")] else: raise InvalidSdistFilename( f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):" f" {filename}" ) # We are requiring a PEP 440 version, which cannot contain dashes, # so we split on the last dash. name_part, sep, version_part = file_stem.rpartition("-") if not sep: raise InvalidSdistFilename(f"Invalid sdist filename: {filename}") name = canonicalize_name(name_part) try: version = Version(version_part) except InvalidVersion as e: raise InvalidSdistFilename( f"Invalid sdist filename (invalid version): {filename}" ) from e return (name, version) _vendor/wheel/vendored/__init__.py 0000644 00000000000 15030122015 0013176 0 ustar 00 _vendor/wheel/_setuptools_logging.py 0000644 00000001415 15030122015 0013732 0 ustar 00 # copied from setuptools.logging, omitting monkeypatching from __future__ import annotations import logging import sys def _not_warning(record: logging.LogRecord) -> bool: return record.levelno < logging.WARNING def configure() -> None: """ Configure logging to emit warning and above to stderr and everything else to stdout. This behavior is provided for compatibility with distutils.log but may change in the future. """ err_handler = logging.StreamHandler() err_handler.setLevel(logging.WARNING) out_handler = logging.StreamHandler(sys.stdout) out_handler.addFilter(_not_warning) handlers = err_handler, out_handler logging.basicConfig( format="{message}", style="{", handlers=handlers, level=logging.DEBUG ) _vendor/wheel/metadata.py 0000644 00000014033 15030122015 0011424 0 ustar 00 """ Tools for converting old- to new-style metadata. """ from __future__ import annotations import functools import itertools import os.path import re import textwrap from email.message import Message from email.parser import Parser from typing import Generator, Iterable, Iterator, Literal from .vendored.packaging.requirements import Requirement def _nonblank(str: str) -> bool | Literal[""]: return str and not str.startswith("#") @functools.singledispatch def yield_lines(iterable: Iterable[str]) -> Iterator[str]: r""" Yield valid lines of a string or iterable. >>> list(yield_lines('')) [] >>> list(yield_lines(['foo', 'bar'])) ['foo', 'bar'] >>> list(yield_lines('foo\nbar')) ['foo', 'bar'] >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) ['foo', 'baz #comment'] >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) ['foo', 'bar', 'baz', 'bing'] """ return itertools.chain.from_iterable(map(yield_lines, iterable)) @yield_lines.register(str) def _(text: str) -> Iterator[str]: return filter(_nonblank, map(str.strip, text.splitlines())) def split_sections( s: str | Iterator[str], ) -> Generator[tuple[str | None, list[str]], None, None]: """Split a string or iterable thereof into (section, content) pairs Each ``section`` is a stripped version of the section header ("[section]") and each ``content`` is a list of stripped lines excluding blank lines and comment-only lines. If there are any such lines before the first section header, they're returned in a first ``section`` of ``None``. """ section = None content: list[str] = [] for line in yield_lines(s): if line.startswith("["): if line.endswith("]"): if section or content: yield section, content section = line[1:-1].strip() content = [] else: raise ValueError("Invalid section heading", line) else: content.append(line) # wrap up last segment yield section, content def safe_extra(extra: str) -> str: """Convert an arbitrary string to a standard 'extra' name Any runs of non-alphanumeric characters are replaced with a single '_', and the result is always lowercased. """ return re.sub("[^A-Za-z0-9.-]+", "_", extra).lower() def safe_name(name: str) -> str: """Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. """ return re.sub("[^A-Za-z0-9.]+", "-", name) def requires_to_requires_dist(requirement: Requirement) -> str: """Return the version specifier for a requirement in PEP 345/566 fashion.""" if requirement.url: return " @ " + requirement.url requires_dist: list[str] = [] for spec in requirement.specifier: requires_dist.append(spec.operator + spec.version) if requires_dist: return " " + ",".join(sorted(requires_dist)) else: return "" def convert_requirements(requirements: list[str]) -> Iterator[str]: """Yield Requires-Dist: strings for parsed requirements strings.""" for req in requirements: parsed_requirement = Requirement(req) spec = requires_to_requires_dist(parsed_requirement) extras = ",".join(sorted(safe_extra(e) for e in parsed_requirement.extras)) if extras: extras = f"[{extras}]" yield safe_name(parsed_requirement.name) + extras + spec def generate_requirements( extras_require: dict[str | None, list[str]], ) -> Iterator[tuple[str, str]]: """ Convert requirements from a setup()-style dictionary to ('Requires-Dist', 'requirement') and ('Provides-Extra', 'extra') tuples. extras_require is a dictionary of {extra: [requirements]} as passed to setup(), using the empty extra {'': [requirements]} to hold install_requires. """ for extra, depends in extras_require.items(): condition = "" extra = extra or "" if ":" in extra: # setuptools extra:condition syntax extra, condition = extra.split(":", 1) extra = safe_extra(extra) if extra: yield "Provides-Extra", extra if condition: condition = "(" + condition + ") and " condition += f"extra == '{extra}'" if condition: condition = " ; " + condition for new_req in convert_requirements(depends): canonical_req = str(Requirement(new_req + condition)) yield "Requires-Dist", canonical_req def pkginfo_to_metadata(egg_info_path: str, pkginfo_path: str) -> Message: """ Convert .egg-info directory with PKG-INFO to the Metadata 2.1 format """ with open(pkginfo_path, encoding="utf-8") as headers: pkg_info = Parser().parse(headers) pkg_info.replace_header("Metadata-Version", "2.1") # Those will be regenerated from `requires.txt`. del pkg_info["Provides-Extra"] del pkg_info["Requires-Dist"] requires_path = os.path.join(egg_info_path, "requires.txt") if os.path.exists(requires_path): with open(requires_path, encoding="utf-8") as requires_file: requires = requires_file.read() parsed_requirements = sorted(split_sections(requires), key=lambda x: x[0] or "") for extra, reqs in parsed_requirements: for key, value in generate_requirements({extra: reqs}): if (key, value) not in pkg_info.items(): pkg_info[key] = value description = pkg_info["Description"] if description: description_lines = pkg_info["Description"].splitlines() dedented_description = "\n".join( # if the first line of long_description is blank, # the first line here will be indented. ( description_lines[0].lstrip(), textwrap.dedent("\n".join(description_lines[1:])), "\n", ) ) pkg_info.set_payload(dedented_description) del pkg_info["Description"] return pkg_info _vendor/wheel/cli/convert.py 0000644 00000030532 15030122015 0012075 0 ustar 00 from __future__ import annotations import os.path import re from abc import ABCMeta, abstractmethod from collections import defaultdict from collections.abc import Iterator from email.message import Message from email.parser import Parser from email.policy import EmailPolicy from glob import iglob from pathlib import Path from textwrap import dedent from zipfile import ZipFile from .. import __version__ from ..metadata import generate_requirements from ..vendored.packaging.tags import parse_tag from ..wheelfile import WheelFile egg_filename_re = re.compile( r""" (?P<name>.+?)-(?P<ver>.+?) (-(?P<pyver>py\d\.\d+) (-(?P<arch>.+?))? )?.egg$""", re.VERBOSE, ) egg_info_re = re.compile( r""" ^(?P<name>.+?)-(?P<ver>.+?) (-(?P<pyver>py\d\.\d+) )?.egg-info/""", re.VERBOSE, ) wininst_re = re.compile( r"\.(?P<platform>win32|win-amd64)(?:-(?P<pyver>py\d\.\d))?\.exe$" ) pyd_re = re.compile(r"\.(?P<abi>[a-z0-9]+)-(?P<platform>win32|win_amd64)\.pyd$") serialization_policy = EmailPolicy( utf8=True, mangle_from_=False, max_line_length=0, ) GENERATOR = f"wheel {__version__}" def convert_requires(requires: str, metadata: Message) -> None: extra: str | None = None requirements: dict[str | None, list[str]] = defaultdict(list) for line in requires.splitlines(): line = line.strip() if not line: continue if line.startswith("[") and line.endswith("]"): extra = line[1:-1] continue requirements[extra].append(line) for key, value in generate_requirements(requirements): metadata.add_header(key, value) def convert_pkg_info(pkginfo: str, metadata: Message): parsed_message = Parser().parsestr(pkginfo) for key, value in parsed_message.items(): key_lower = key.lower() if value == "UNKNOWN": continue if key_lower == "description": description_lines = value.splitlines() value = "\n".join( ( description_lines[0].lstrip(), dedent("\n".join(description_lines[1:])), "\n", ) ) metadata.set_payload(value) elif key_lower == "home-page": metadata.add_header("Project-URL", f"Homepage, {value}") elif key_lower == "download-url": metadata.add_header("Project-URL", f"Download, {value}") else: metadata.add_header(key, value) metadata.replace_header("Metadata-Version", "2.4") def normalize(name: str) -> str: return re.sub(r"[-_.]+", "-", name).lower().replace("-", "_") class ConvertSource(metaclass=ABCMeta): name: str version: str pyver: str = "py2.py3" abi: str = "none" platform: str = "any" metadata: Message @property def dist_info_dir(self) -> str: return f"{self.name}-{self.version}.dist-info" @abstractmethod def generate_contents(self) -> Iterator[tuple[str, bytes]]: pass class EggFileSource(ConvertSource): def __init__(self, path: Path): if not (match := egg_filename_re.match(path.name)): raise ValueError(f"Invalid egg file name: {path.name}") # Binary wheels are assumed to be for CPython self.path = path self.name = normalize(match.group("name")) self.version = match.group("ver") if pyver := match.group("pyver"): self.pyver = pyver.replace(".", "") if arch := match.group("arch"): self.abi = self.pyver.replace("py", "cp") self.platform = normalize(arch) self.metadata = Message() def generate_contents(self) -> Iterator[tuple[str, bytes]]: with ZipFile(self.path, "r") as zip_file: for filename in sorted(zip_file.namelist()): # Skip pure directory entries if filename.endswith("/"): continue # Handle files in the egg-info directory specially, selectively moving # them to the dist-info directory while converting as needed if filename.startswith("EGG-INFO/"): if filename == "EGG-INFO/requires.txt": requires = zip_file.read(filename).decode("utf-8") convert_requires(requires, self.metadata) elif filename == "EGG-INFO/PKG-INFO": pkginfo = zip_file.read(filename).decode("utf-8") convert_pkg_info(pkginfo, self.metadata) elif filename == "EGG-INFO/entry_points.txt": yield ( f"{self.dist_info_dir}/entry_points.txt", zip_file.read(filename), ) continue # For any other file, just pass it through yield filename, zip_file.read(filename) class EggDirectorySource(EggFileSource): def generate_contents(self) -> Iterator[tuple[str, bytes]]: for dirpath, _, filenames in os.walk(self.path): for filename in sorted(filenames): path = Path(dirpath, filename) if path.parent.name == "EGG-INFO": if path.name == "requires.txt": requires = path.read_text("utf-8") convert_requires(requires, self.metadata) elif path.name == "PKG-INFO": pkginfo = path.read_text("utf-8") convert_pkg_info(pkginfo, self.metadata) if name := self.metadata.get("Name"): self.name = normalize(name) if version := self.metadata.get("Version"): self.version = version elif path.name == "entry_points.txt": yield ( f"{self.dist_info_dir}/entry_points.txt", path.read_bytes(), ) continue # For any other file, just pass it through yield str(path.relative_to(self.path)), path.read_bytes() class WininstFileSource(ConvertSource): """ Handles distributions created with ``bdist_wininst``. The egginfo filename has the format:: name-ver(-pyver)(-arch).egg-info The installer filename has the format:: name-ver.arch(-pyver).exe Some things to note: 1. The installer filename is not definitive. An installer can be renamed and work perfectly well as an installer. So more reliable data should be used whenever possible. 2. The egg-info data should be preferred for the name and version, because these come straight from the distutils metadata, and are mandatory. 3. The pyver from the egg-info data should be ignored, as it is constructed from the version of Python used to build the installer, which is irrelevant - the installer filename is correct here (even to the point that when it's not there, any version is implied). 4. The architecture must be taken from the installer filename, as it is not included in the egg-info data. 5. Architecture-neutral installers still have an architecture because the installer format itself (being executable) is architecture-specific. We should therefore ignore the architecture if the content is pure-python. """ def __init__(self, path: Path): self.path = path self.metadata = Message() # Determine the initial architecture and Python version from the file name # (if possible) if match := wininst_re.search(path.name): self.platform = normalize(match.group("platform")) if pyver := match.group("pyver"): self.pyver = pyver.replace(".", "") # Look for an .egg-info directory and any .pyd files for more precise info egg_info_found = pyd_found = False with ZipFile(self.path) as zip_file: for filename in zip_file.namelist(): prefix, filename = filename.split("/", 1) if not egg_info_found and (match := egg_info_re.match(filename)): egg_info_found = True self.name = normalize(match.group("name")) self.version = match.group("ver") if pyver := match.group("pyver"): self.pyver = pyver.replace(".", "") elif not pyd_found and (match := pyd_re.search(filename)): pyd_found = True self.abi = match.group("abi") self.platform = match.group("platform") if egg_info_found and pyd_found: break def generate_contents(self) -> Iterator[tuple[str, bytes]]: dist_info_dir = f"{self.name}-{self.version}.dist-info" data_dir = f"{self.name}-{self.version}.data" with ZipFile(self.path, "r") as zip_file: for filename in sorted(zip_file.namelist()): # Skip pure directory entries if filename.endswith("/"): continue # Handle files in the egg-info directory specially, selectively moving # them to the dist-info directory while converting as needed prefix, target_filename = filename.split("/", 1) if egg_info_re.search(target_filename): basename = target_filename.rsplit("/", 1)[-1] if basename == "requires.txt": requires = zip_file.read(filename).decode("utf-8") convert_requires(requires, self.metadata) elif basename == "PKG-INFO": pkginfo = zip_file.read(filename).decode("utf-8") convert_pkg_info(pkginfo, self.metadata) elif basename == "entry_points.txt": yield ( f"{dist_info_dir}/entry_points.txt", zip_file.read(filename), ) continue elif prefix == "SCRIPTS": target_filename = f"{data_dir}/scripts/{target_filename}" # For any other file, just pass it through yield target_filename, zip_file.read(filename) def convert(files: list[str], dest_dir: str, verbose: bool) -> None: for pat in files: for archive in iglob(pat): path = Path(archive) if path.suffix == ".egg": if path.is_dir(): source: ConvertSource = EggDirectorySource(path) else: source = EggFileSource(path) else: source = WininstFileSource(path) if verbose: print(f"{archive}...", flush=True, end="") dest_path = Path(dest_dir) / ( f"{source.name}-{source.version}-{source.pyver}-{source.abi}" f"-{source.platform}.whl" ) with WheelFile(dest_path, "w") as wheelfile: for name_or_zinfo, contents in source.generate_contents(): wheelfile.writestr(name_or_zinfo, contents) # Write the METADATA file wheelfile.writestr( f"{source.dist_info_dir}/METADATA", source.metadata.as_string(policy=serialization_policy).encode( "utf-8" ), ) # Write the WHEEL file wheel_message = Message() wheel_message.add_header("Wheel-Version", "1.0") wheel_message.add_header("Generator", GENERATOR) wheel_message.add_header( "Root-Is-Purelib", str(source.platform == "any").lower() ) tags = parse_tag(f"{source.pyver}-{source.abi}-{source.platform}") for tag in sorted(tags, key=lambda tag: tag.interpreter): wheel_message.add_header("Tag", str(tag)) wheelfile.writestr( f"{source.dist_info_dir}/WHEEL", wheel_message.as_string(policy=serialization_policy).encode( "utf-8" ), ) if verbose: print("OK") _vendor/wheel/cli/__pycache__/unpack.cpython-310.pyc 0000644 00000002140 15030122015 0016227 0 ustar 00 o �h� � @ s4 d dl mZ d dlmZ ddlmZ ddd d �Zd S )� )� annotations)�Path� )� WheelFile�.�path�str�dest�return�Nonec C s� t | ��;}|j�d�}t|�| }td|� d�ddd� |jD ]}|�||� |jd? d@ }|�|j �� |� q W d � n1 sBw Y td � d S ) z�Unpack a wheel. Wheel content will be unpacked to {dest}/{name}-{ver}, where {name} is the package name and {ver} its version. :param path: The path to the wheel. :param dest: Destination directory (default to current directory). �nameverzUnpacking to: z...� T)�end�flush� i� N�OK) r �parsed_filename�groupr �print�filelist�extract� external_attr�joinpath�filename�chmod)r r �wfr � destination�zinfo� permissions� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/cli/unpack.py�unpack s � � r! N)r )r r r r r r )� __future__r �pathlibr � wheelfiler r! r r r r �<module> s _vendor/wheel/cli/__pycache__/tags.cpython-310.pyc 0000644 00000007433 15030122015 0015716 0 ustar 00 o �h� � @ sl d dl mZ d dlZd dlZd dlZd dlmZ d dlm Z ddl m Z dd d�Z dd dd�Z dS ) � )� annotationsN)�Iterable)� BytesParser� )� WheelFile� original_tags� Iterable[str]�new_tags� str | None�return�set[str]c C sj |du rt | �S |�d�rh | �|dd� �d��S |�d�r.t | �t |dd� �d�� S t |�d��S )z0Add or replace tags. Supports dot-separated tagsN�+� �.�-)�set� startswith�split)r r � r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/cli/tags.py� _compute_tags s r F�wheel�str� python_tags�abi_tags� platform_tags� build_tag�remove�boolc " C sh t | d��S}|jsJ |j� d���|�|jd �}ttjjd��|�}t j � |j�} |j � d�} |j � d�} |j � d��d�} |j � d ��d�} |j � d ��d�}W d � n1 s[w Y |�d g �}|�d �}dd� |D �}dd� |D �}dd� |D �}|t| �kr�d|�d| ��}t|��|t| �kr�d|�d| ��}t|��|t|�kr�d|�d|��}t|��|| kr�d| � d|� d�}t|��|d ur�|} tt| |��}tt| |��}tt||��}| d�|�d�|�d�|�g}| r�|�d| � d�|�d }| |k�r�|d = |d = t�|||�D ]\}}} |� d|� d| � �|d < �q| �r,| |d < t j �t j �|j�| �} t j �t j �|j�|�} t | d��X} t | d��B} | j| _| �� D ]1}!|!� � �ra�qX|!j|jd k�rl�qX|!j|jd k�r| � |!|� � � �qX| � |!| �|!�� �qXW d � n 1 �s�w Y W d � n 1 �s�w Y |�r�t � | � |S ) a? Change the tags on a wheel file. The tags are left unchanged if they are not specified. To specify "none", use ["none"]. To append to the previous tags, a tag should start with a "+". If a tag starts with "-", it will be removed from existing tags. Processing is done left to right. :param wheel: The paths to the wheels :param python_tags: The Python tags to set :param abi_tags: The ABI tags to set :param platform_tags: The platform tags to set :param build_tag: The build tag to set :param remove: Remove the original wheel �rz must be availablez/WHEEL)�policy�namever�build�pyverr �abi�platN�Tag�Buildc S � h | ] }|� d �d �qS )r r �r ��.0�tagr r r � <setcomp>@ � ztags.<locals>.<setcomp>c S r( )r r r) r* r r r r- A r. c S r( )r r r) r* r r r r- B r. zWheel internal tags z != filename tags zIncorrect filename 'z' & *.dist-info/WHEEL 'z' build numbersr r z.whl�wz/RECORD) r �filename�read�dist_info_pathr �emailr �compat32� parsebytes�os�path�basename�parsed_filename�groupr �get_all�getr �AssertionError�sortedr �join�insert� itertools�product�dirname�comment�infolist�is_dir�writestr�as_bytesr )"r r r r r r �f� wheel_info�info�original_wheel_namer! r" �original_python_tags�original_abi_tags�original_plat_tags�tags�existing_build_tag�impls�abivers� platforms�msg�final_python_tags�final_abi_tags�final_plat_tags� final_tags�final_wheel_name�a�b�c�original_wheel_path�final_wheel_path�fin�fout�itemr r r rP s� � ���� � �� � �� rP )r r r r r r )NNNNF)r r r r r r r r r r r r r r )� __future__r � email.policyr3 rA r6 �collections.abcr � email.parserr � wheelfiler r rP r r r r �<module> s � _vendor/wheel/cli/__pycache__/__init__.cpython-310.pyc 0000644 00000010766 15030122015 0016522 0 ustar 00 o �h2 � @ s� d Z ddlmZ ddlZddlZddlZddlmZ G dd� de�Zd d d �Z d d d�Z d dd�Z d dd�Z d dd�Z d dd�ZdZdd� Zd d � ZdS ) z Wheel command-line utility. � )� annotationsN)�ArgumentTypeErrorc @ s e Zd ZdS )� WheelErrorN)�__name__� __module__� __qualname__� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/cli/__init__.pyr s r �args�argparse.Namespace�return�Nonec C s ddl m } || j| j� d S )N� )�unpack)r � wheelfile�dest)r r r r r �unpack_f � r c C �" ddl m } || j| j| j� d S )Nr )�pack)r � directory�dest_dir� build_number)r r r r r �pack_f � r c C r )Nr )�convert)r �filesr �verbose)r r r r r � convert_f r r c s8 ddl m � � �fdd�� jD �}|D ]}t|� qd S )Nr )�tagsc 3 s, � | ]}�|� j � j� j� j� j�V qd S �N)� python_tag�abi_tag� platform_tag�build�remove)�.0�wheel�r r r r � <genexpr>& s � �� �ztags_f.<locals>.<genexpr>)r r' �print)r �names�namer r( r �tags_f# s � �r- c C s ddl m} td|� �� d S )N� )� __version__zwheel )� r/ r* )r r/ r r r � version_f6 r r1 � build_tag�strc C s, | r | d � � s td��d| v rtd��| S )Nr z!build tag must begin with a digit�-z$invalid character ('-') in build tag)�isdigitr )r2 r r r �parse_build_tag< s r6 ay Make a new wheel with given tags. Any tags unspecified will remain the same. Starting the tags with a "+" will append to the existing tags. Starting with a "-" will remove a tag (use --option=-TAG syntax). Multiple tags can be separated by ".". The original file will remain unless --remove is given. The output filename(s) will be displayed on stdout for further processing. c s� t �� � � jdd�} | jddd�}|jddddd � |jd d d� |jtd � | jd dd�}|jddd� |jddtjj dd� |jddd� |jt d � | jddd�}|jdddd� |jddtjj d d� |jd d d d � |jt d � | jd!d"t d#�}|jd$dd%d� |jd&d d'd(� |jd)d*d+d,� |jd-d*d.d,� |jd/d*d0d,� |jd1t d2d3d4� |jtd � | jd5d6d�}|jtd � | jd7d8d�}|j� fd9d:�d � � S );N�commands)�helpr z Unpack wheelz--destz-dzDestination directory�.)r8 �defaultr z Wheel file)�funcr z Repack wheelr z$Root directory of the unpacked wheelz --dest-dirz2Directory to store the wheel (default %(default)s))r: r8 z--build-numberz"Build tag to use in the wheel namer z Convert egg or wininst to wheelr �*zFiles to convert)�nargsr8 z/Directory to store wheels (default %(default)s)z --verbosez-v� store_true)�actionr z"Add or replace the tags on a wheel)r8 � descriptionr' zExisting wheel(s) to retagz--removez8Remove the original files, keeping only the renamed ones)r? r8 z --python-tag�TAGz Specify an interpreter tag(s))�metavarr8 z --abi-tagzSpecify an ABI tag(s)z--platform-tagzSpecify a platform tag(s)z--build�BUILDzSpecify a build tag)�typerB r8 �versionzPrint version and exitr8 zShow this helpc s � � � S r )� print_help)r ��pr r �<lambda>� s zparser.<locals>.<lambda>)�argparse�ArgumentParser�add_subparsers� add_parser� add_argument� set_defaultsr �os�path�curdirr r � TAGS_HELPr6 r- r1 )�s� unpack_parser� repack_parser�convert_parser� tags_parser�version_parser� help_parserr rG r �parserN sn � �� � ����� r[ c C sj t � } | �� }t|d�s| �� dS z|�|� W dS ty4 } zt|tjd� W Y d }~dS d }~ww )Nr; r )�filer ) r[ � parse_args�hasattrrF r; r r* �sys�stderr)rH r �er r r �main� s � ��rb )r r r r )r2 r3 r r3 )�__doc__� __future__r rJ rP r_ r � Exceptionr r r r r- r1 r6 rS r[ rb r r r r �<module> s A _vendor/wheel/cli/__pycache__/pack.cpython-310.pyc 0000644 00000006056 15030122015 0015676 0 ustar 00 o �h � @ sv d dl mZ d dlZd dlZd dlZd dlmZ d dl m Z d dl m Z d dl mZ e�d�Zddd�Zddd�ZdS )� )� annotationsN)�BytesGenerator)� BytesParser)� WheelError)� WheelFilez6^(?P<namever>(?P<name>.+?)-(?P<ver>\d.*?))\.dist-info$� directory�str�dest_dir� build_number� str | None�return�Nonec s� � fdd�t �� �D �}t|�dkrtd� � ���|s"td� � ���|d }t�|��d�}t j�� |d�}t |d ��'}t t j j d ��|�}|�d g �} |�d �} | s[td |� d���W d � n1 sew Y |durp|n| }|dur�|d = |r�||d < |d| 7 }|| kr�t |d��}t|dd��|� W d � n1 s�w Y t| �} t j�||� d| � d��} t| d��} td| � d�ddd� | �� � W d � n1 s�w Y td� dS )aB Repack a previously unpacked wheel directory into a new wheel file. The .dist-info/WHEEL file must contain one or more tags so that the target wheel file name can be determined. :param directory: The unpacked wheel directory :param dest_dir: Destination directory (defaults to the current directory) c s0 g | ]}t j�t j�� |��rt�|�r|�qS � )�os�path�isdir�join� DIST_INFO_RE�match)�.0�fn�r r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/cli/pack.py� <listcomp> s ���zpack.<locals>.<listcomp>� z)Multiple .dist-info directories found in z#No .dist-info directories found in r �namever�WHEEL�rb)�policy�Tag�BuildzNo tags present in z./WHEEL; cannot determine target wheel filenameN�-�wb)� maxheaderlenz.whl�wzRepacking wheel as z...� T)�end�flush�OK)r �listdir�lenr r r �groupr r �openr �emailr �compat32�parse�get_all�getr �flatten�compute_tagliner �print� write_files)r r r �dist_info_dirs� dist_info_dir� name_version�wheel_file_path�f�info�tags�existing_build_number�tagline� wheel_path�wfr r r �pack sJ � �� � � � rA r< � list[str]c C sX t dd� | D ��}t dd� | D ��}t dd� | D ��}d�d�|�d�|�d�|�g�S )zcCompute a tagline from a list of tags. :param tags: A list of tags :return: A tagline c S � h | ] }|� d �d �qS )r! r ��split�r �tagr r r � <setcomp>R � z"compute_tagline.<locals>.<setcomp>c S rC )r! r rD rF r r r rH S rI c S rC )r! � rD rF r r r rH T rI r! �.)�sortedr )r< �impls�abivers� platformsr r r r3 L s "r3 )r r r r r r r r )r< rB r r )� __future__r � email.policyr- �os.pathr �re�email.generatorr � email.parserr � wheel.clir �wheel.wheelfiler �compiler rA r3 r r r r �<module> s = _vendor/wheel/cli/__pycache__/convert.cpython-310.pyc 0000644 00000022660 15030122015 0016437 0 ustar 00 o �hZ1 � @ s~ d dl mZ d dlZd dlZd dlmZmZ d dlm Z d dl m Z d dl m Z d dlmZ d dlmZ d d lmZ d d lmZ d d lmZ d d lmZ d dlmZ d dl m Z d dl m Z d dl m!Z! e�"dej#�Z$e�"dej#�Z%e�"d�Z&e�"d�Z'eddd d�Z(de� �Z)d8d d!�Z*d9d#d$�Z+d:d&d'�Z,G d(d)� d)ed*�Z-G d+d,� d,e-�Z.G d-d.� d.e.�Z/G d/d0� d0e-�Z0d;d6d7�Z1dS )<� )� annotationsN)�ABCMeta�abstractmethod)� defaultdict)�Iterator)�Message)�Parser)� EmailPolicy)�iglob)�Path)�dedent)�ZipFile� )� __version__)�generate_requirements)� parse_tag)� WheelFilez] (?P<name>.+?)-(?P<ver>.+?) (-(?P<pyver>py\d\.\d+) (-(?P<arch>.+?))? )?.egg$zL ^(?P<name>.+?)-(?P<ver>.+?) (-(?P<pyver>py\d\.\d+) )?.egg-info/z>\.(?P<platform>win32|win-amd64)(?:-(?P<pyver>py\d\.\d))?\.exe$z8\.(?P<abi>[a-z0-9]+)-(?P<platform>win32|win_amd64)\.pyd$TF)�utf8� mangle_from_�max_line_lengthzwheel �requires�str�metadatar �return�Nonec C sz d }t t�}| �� D ]!}|�� }|sq |�d�r$|�d�r$|dd� }q || �|� q t|�D ] \}}|�||� q0d S )N�[�]� ���) r �list� splitlines�strip� startswith�endswith�appendr � add_header)r r �extra� requirements�line�key�value� r+ �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/wheel/cli/convert.py�convert_requires0 s �r- �pkginfoc C s� t � �| �}|�� D ]R\}}|�� }|dkrq |dkr:|�� }d�|d �� td�|dd � ��df�}|�|� q |dkrH|� dd|� �� q |d krV|� dd |� �� q |� ||� q |� d d � d S ) N�UNKNOWN� description� r r z home-pagez Project-URLz Homepage, z download-urlz Download, zMetadata-Versionz2.4) r �parsestr�items�lowerr �join�lstripr � set_payloadr% �replace_header)r. r �parsed_messager) r* � key_lower�description_linesr+ r+ r, �convert_pkg_infoB s( �� r< �namec C s t �dd| ��� �dd�S )Nz[-_.]+�-�_)�re�subr4 �replace)r= r+ r+ r, � normalize] s rC c @ sf e Zd ZU ded< ded< dZded< dZded< dZded < d ed < edd d��Ze ddd��Z dS )� ConvertSourcer r= �versionzpy2.py3�pyver�none�abi�any�platformr r r c C s | j � d| j� d�S )Nr> � .dist-info)r= rE ��selfr+ r+ r, � dist_info_diri s zConvertSource.dist_info_dir�Iterator[tuple[str, bytes]]c C s d S �Nr+ rL r+ r+ r, �generate_contentsm s z ConvertSource.generate_contentsN)r r �r rO ) �__name__� __module__� __qualname__�__annotations__rF rH rJ �propertyrN r rQ r+ r+ r+ r, rD a s rD )� metaclassc @ s e Zd Zd dd�Zd dd�Zd S ) � EggFileSource�pathr c C s� t �|j� }std|j� ���|| _t|�d��| _|�d�| _|�d� }rC|�dd�| _ |�d� }rC| j �dd �| _ t|�| _ t � | _ d S ) NzInvalid egg file name: r= �verrF �.� �arch�py�cp)�egg_filename_re�matchr= � ValueErrorrZ rC �grouprE rB rF rH rJ r r )rM rZ rb rF r^ r+ r+ r, �__init__s s zEggFileSource.__init__r rO c c s� � t | jd��\}t|�� �D ]L}|�d�rq|�d�rR|dkr.|�|��d�}t|| j � n#|dkrA|�|��d�}t || j � n|dkrQ| j � d�|�|�fV q||�|�fV qW d � d S 1 sfw Y d S ) N�r�/z EGG-INFO/zEGG-INFO/requires.txt�utf-8zEGG-INFO/PKG-INFOzEGG-INFO/entry_points.txt�/entry_points.txt) r rZ �sorted�namelistr# r" �read�decoder- r r< rN )rM �zip_file�filenamer r. r+ r+ r, rQ � s( � ��"�z EggFileSource.generate_contentsN�rZ r rR )rS rT rU re rQ r+ r+ r+ r, rY r s rY c @ s e Zd Zddd�ZdS )�EggDirectorySourcer rO c c s� � t �| j�D ]o\}}}t|�D ]e}t||�}|jjdkrh|jdkr.|�d�}t|| j � n9|jdkrW|�d�}t || j � | j � d� }rKt |�| _| j � d� } rV| | _ n|jdkrg| j� d�|�� fV qt|�| j��|�� fV qqd S ) NzEGG-INFO� requires.txtrh �PKG-INFO�Name�Version�entry_points.txtri )�os�walkrZ rj r �parentr= � read_textr- r r< �getrC rE rN � read_bytesr � relative_to) rM �dirpathr? � filenamesro rZ r r. r= rE r+ r+ r, rQ � s0 � � � ��z$EggDirectorySource.generate_contentsNrR )rS rT rU rQ r+ r+ r+ r, rq � s rq c @ s$ e Zd ZdZd dd�Zd dd �Zd S ) �WininstFileSourcea� Handles distributions created with ``bdist_wininst``. The egginfo filename has the format:: name-ver(-pyver)(-arch).egg-info The installer filename has the format:: name-ver.arch(-pyver).exe Some things to note: 1. The installer filename is not definitive. An installer can be renamed and work perfectly well as an installer. So more reliable data should be used whenever possible. 2. The egg-info data should be preferred for the name and version, because these come straight from the distutils metadata, and are mandatory. 3. The pyver from the egg-info data should be ignored, as it is constructed from the version of Python used to build the installer, which is irrelevant - the installer filename is correct here (even to the point that when it's not there, any version is implied). 4. The architecture must be taken from the installer filename, as it is not included in the egg-info data. 5. Architecture-neutral installers still have an architecture because the installer format itself (being executable) is architecture-specific. We should therefore ignore the architecture if the content is pure-python. rZ r c C s: || _ t� | _t�|j� }r%t|�d��| _|�d� }r%|� dd�| _ d }}t | j ��e}|� � D ]O}|� dd�\}}|set�|� }red}t|�d ��| _|�d �| _|�d� }rd|� dd�| _ n|s|t�|� }r|d}|�d �| _|�d�| _|r�|r� n q3W d � d S W d � d S 1 s�w Y d S ) NrJ rF r\ r] Frg r Tr= r[ rH )rZ r r � wininst_re�searchr= rC rd rJ rB rF r rk �split� egg_info_rerb rE �pyd_rerH ) rM rZ rb rF �egg_info_found� pyd_foundrn ro �prefixr+ r+ r, re � s8 � ���"�zWininstFileSource.__init__r rO c c s6 � | j � d| j� d�}| j � d| j� d�}t| jd��v}t|�� �D ]f}|�d�r*q"|�dd�\}}t� |�ru|� dd�d }|dkrR|� |�� d �}t || j� n"|d kre|� |�� d �} t| | j� n|d krt|� d �|� |�fV q"|d kr�|� d|� �}||� |�fV q"W d � d S 1 s�w Y d S )Nr> rK z.datarf rg r r rr rh rs rv ri �SCRIPTSz /scripts/)r= rE r rZ rj rk r# r� r� r� �rsplitrl rm r- r r< ) rM rN �data_dirrn ro r� �target_filename�basenamer r. r+ r+ r, rQ � s4 � ��"�z#WininstFileSource.generate_contentsNrp rR )rS rT rU �__doc__re rQ r+ r+ r+ r, r� � s r� �files� list[str]�dest_dir�verbose�boolc C s� | D ]�}t |�D ]�}t|�}|jdkr!|�� r t|�}n t|�}nt|�}|r1t|� d�ddd� t|�|j� d|j � d|j � d|j � d|j � d� }t |d��x}|�� D ] \} } |�| | � qU|�|j� d �|jjtd ��d �� t� } | �d d � | �dt� | �dt|j dk��� � t|j � d|j � d|j � ��} t| dd� d�D ] } | �dt| �� q�|�|j� d�| jtd ��d �� W d � n1 s�w Y |r�td� qqd S )Nz.eggz...Tr] )�flush�endr> z.whl�wz /METADATA)�policyrh z Wheel-Versionz1.0� GeneratorzRoot-Is-PurelibrI c S s | j S rP )� interpreter)�tagr+ r+ r, �<lambda>A s zconvert.<locals>.<lambda>)r) �Tagz/WHEEL�OK) r r �suffix�is_dirrq rY r� �printr= rE rF rH rJ r rQ �writestrrN r � as_string�serialization_policy�encoder r% � GENERATORr r4 r rj )r� r� r� �pat�archiverZ �source� dest_path� wheelfile� name_or_zinfo�contents� wheel_message�tagsr� r+ r+ r, �convert sZ �� �� � �� � ���r� )r r r r r r )r. r r r )r= r r r )r� r� r� r r� r� r r )2� __future__r �os.pathrw r@ �abcr r � collectionsr �collections.abcr � email.messager � email.parserr � email.policyr �globr �pathlibr �textwrapr �zipfiler r] r r r �vendored.packaging.tagsr r� r �compile�VERBOSEra r� r� r� r� r� r- r< rC rD rY rq r� r� r+ r+ r+ r, �<module> sV ��� � - ^ _vendor/wheel/cli/unpack.py 0000644 00000001775 15030122015 0011705 0 ustar 00 from __future__ import annotations from pathlib import Path from ..wheelfile import WheelFile def unpack(path: str, dest: str = ".") -> None: """Unpack a wheel. Wheel content will be unpacked to {dest}/{name}-{ver}, where {name} is the package name and {ver} its version. :param path: The path to the wheel. :param dest: Destination directory (default to current directory). """ with WheelFile(path) as wf: namever = wf.parsed_filename.group("namever") destination = Path(dest) / namever print(f"Unpacking to: {destination}...", end="", flush=True) for zinfo in wf.filelist: wf.extract(zinfo, destination) # Set permissions to the same values as they were set in the archive # We have to do this manually due to # https://github.com/python/cpython/issues/59999 permissions = zinfo.external_attr >> 16 & 0o777 destination.joinpath(zinfo.filename).chmod(permissions) print("OK") _vendor/wheel/cli/pack.py 0000644 00000006037 15030122015 0011336 0 ustar 00 from __future__ import annotations import email.policy import os.path import re from email.generator import BytesGenerator from email.parser import BytesParser from wheel.cli import WheelError from wheel.wheelfile import WheelFile DIST_INFO_RE = re.compile(r"^(?P<namever>(?P<name>.+?)-(?P<ver>\d.*?))\.dist-info$") def pack(directory: str, dest_dir: str, build_number: str | None) -> None: """Repack a previously unpacked wheel directory into a new wheel file. The .dist-info/WHEEL file must contain one or more tags so that the target wheel file name can be determined. :param directory: The unpacked wheel directory :param dest_dir: Destination directory (defaults to the current directory) """ # Find the .dist-info directory dist_info_dirs = [ fn for fn in os.listdir(directory) if os.path.isdir(os.path.join(directory, fn)) and DIST_INFO_RE.match(fn) ] if len(dist_info_dirs) > 1: raise WheelError(f"Multiple .dist-info directories found in {directory}") elif not dist_info_dirs: raise WheelError(f"No .dist-info directories found in {directory}") # Determine the target wheel filename dist_info_dir = dist_info_dirs[0] name_version = DIST_INFO_RE.match(dist_info_dir).group("namever") # Read the tags and the existing build number from .dist-info/WHEEL wheel_file_path = os.path.join(directory, dist_info_dir, "WHEEL") with open(wheel_file_path, "rb") as f: info = BytesParser(policy=email.policy.compat32).parse(f) tags: list[str] = info.get_all("Tag", []) existing_build_number = info.get("Build") if not tags: raise WheelError( f"No tags present in {dist_info_dir}/WHEEL; cannot determine target " f"wheel filename" ) # Set the wheel file name and add/replace/remove the Build tag in .dist-info/WHEEL build_number = build_number if build_number is not None else existing_build_number if build_number is not None: del info["Build"] if build_number: info["Build"] = build_number name_version += "-" + build_number if build_number != existing_build_number: with open(wheel_file_path, "wb") as f: BytesGenerator(f, maxheaderlen=0).flatten(info) # Reassemble the tags for the wheel file tagline = compute_tagline(tags) # Repack the wheel wheel_path = os.path.join(dest_dir, f"{name_version}-{tagline}.whl") with WheelFile(wheel_path, "w") as wf: print(f"Repacking wheel as {wheel_path}...", end="", flush=True) wf.write_files(directory) print("OK") def compute_tagline(tags: list[str]) -> str: """Compute a tagline from a list of tags. :param tags: A list of tags :return: A tagline """ impls = sorted({tag.split("-")[0] for tag in tags}) abivers = sorted({tag.split("-")[1] for tag in tags}) platforms = sorted({tag.split("-")[2] for tag in tags}) return "-".join([".".join(impls), ".".join(abivers), ".".join(platforms)]) _vendor/wheel/cli/tags.py 0000644 00000011230 15030122015 0011345 0 ustar 00 from __future__ import annotations import email.policy import itertools import os from collections.abc import Iterable from email.parser import BytesParser from ..wheelfile import WheelFile def _compute_tags(original_tags: Iterable[str], new_tags: str | None) -> set[str]: """Add or replace tags. Supports dot-separated tags""" if new_tags is None: return set(original_tags) if new_tags.startswith("+"): return {*original_tags, *new_tags[1:].split(".")} if new_tags.startswith("-"): return set(original_tags) - set(new_tags[1:].split(".")) return set(new_tags.split(".")) def tags( wheel: str, python_tags: str | None = None, abi_tags: str | None = None, platform_tags: str | None = None, build_tag: str | None = None, remove: bool = False, ) -> str: """Change the tags on a wheel file. The tags are left unchanged if they are not specified. To specify "none", use ["none"]. To append to the previous tags, a tag should start with a "+". If a tag starts with "-", it will be removed from existing tags. Processing is done left to right. :param wheel: The paths to the wheels :param python_tags: The Python tags to set :param abi_tags: The ABI tags to set :param platform_tags: The platform tags to set :param build_tag: The build tag to set :param remove: Remove the original wheel """ with WheelFile(wheel, "r") as f: assert f.filename, f"{f.filename} must be available" wheel_info = f.read(f.dist_info_path + "/WHEEL") info = BytesParser(policy=email.policy.compat32).parsebytes(wheel_info) original_wheel_name = os.path.basename(f.filename) namever = f.parsed_filename.group("namever") build = f.parsed_filename.group("build") original_python_tags = f.parsed_filename.group("pyver").split(".") original_abi_tags = f.parsed_filename.group("abi").split(".") original_plat_tags = f.parsed_filename.group("plat").split(".") tags: list[str] = info.get_all("Tag", []) existing_build_tag = info.get("Build") impls = {tag.split("-")[0] for tag in tags} abivers = {tag.split("-")[1] for tag in tags} platforms = {tag.split("-")[2] for tag in tags} if impls != set(original_python_tags): msg = f"Wheel internal tags {impls!r} != filename tags {original_python_tags!r}" raise AssertionError(msg) if abivers != set(original_abi_tags): msg = f"Wheel internal tags {abivers!r} != filename tags {original_abi_tags!r}" raise AssertionError(msg) if platforms != set(original_plat_tags): msg = ( f"Wheel internal tags {platforms!r} != filename tags {original_plat_tags!r}" ) raise AssertionError(msg) if existing_build_tag != build: msg = ( f"Incorrect filename '{build}' " f"& *.dist-info/WHEEL '{existing_build_tag}' build numbers" ) raise AssertionError(msg) # Start changing as needed if build_tag is not None: build = build_tag final_python_tags = sorted(_compute_tags(original_python_tags, python_tags)) final_abi_tags = sorted(_compute_tags(original_abi_tags, abi_tags)) final_plat_tags = sorted(_compute_tags(original_plat_tags, platform_tags)) final_tags = [ namever, ".".join(final_python_tags), ".".join(final_abi_tags), ".".join(final_plat_tags), ] if build: final_tags.insert(1, build) final_wheel_name = "-".join(final_tags) + ".whl" if original_wheel_name != final_wheel_name: del info["Tag"], info["Build"] for a, b, c in itertools.product( final_python_tags, final_abi_tags, final_plat_tags ): info["Tag"] = f"{a}-{b}-{c}" if build: info["Build"] = build original_wheel_path = os.path.join( os.path.dirname(f.filename), original_wheel_name ) final_wheel_path = os.path.join(os.path.dirname(f.filename), final_wheel_name) with WheelFile(original_wheel_path, "r") as fin, WheelFile( final_wheel_path, "w" ) as fout: fout.comment = fin.comment # preserve the comment for item in fin.infolist(): if item.is_dir(): continue if item.filename == f.dist_info_path + "/RECORD": continue if item.filename == f.dist_info_path + "/WHEEL": fout.writestr(item, info.as_bytes()) else: fout.writestr(item, fin.read(item)) if remove: os.remove(original_wheel_path) return final_wheel_name _vendor/wheel/cli/__init__.py 0000644 00000010462 15030122015 0012154 0 ustar 00 """ Wheel command-line utility. """ from __future__ import annotations import argparse import os import sys from argparse import ArgumentTypeError class WheelError(Exception): pass def unpack_f(args: argparse.Namespace) -> None: from .unpack import unpack unpack(args.wheelfile, args.dest) def pack_f(args: argparse.Namespace) -> None: from .pack import pack pack(args.directory, args.dest_dir, args.build_number) def convert_f(args: argparse.Namespace) -> None: from .convert import convert convert(args.files, args.dest_dir, args.verbose) def tags_f(args: argparse.Namespace) -> None: from .tags import tags names = ( tags( wheel, args.python_tag, args.abi_tag, args.platform_tag, args.build, args.remove, ) for wheel in args.wheel ) for name in names: print(name) def version_f(args: argparse.Namespace) -> None: from .. import __version__ print(f"wheel {__version__}") def parse_build_tag(build_tag: str) -> str: if build_tag and not build_tag[0].isdigit(): raise ArgumentTypeError("build tag must begin with a digit") elif "-" in build_tag: raise ArgumentTypeError("invalid character ('-') in build tag") return build_tag TAGS_HELP = """\ Make a new wheel with given tags. Any tags unspecified will remain the same. Starting the tags with a "+" will append to the existing tags. Starting with a "-" will remove a tag (use --option=-TAG syntax). Multiple tags can be separated by ".". The original file will remain unless --remove is given. The output filename(s) will be displayed on stdout for further processing. """ def parser(): p = argparse.ArgumentParser() s = p.add_subparsers(help="commands") unpack_parser = s.add_parser("unpack", help="Unpack wheel") unpack_parser.add_argument( "--dest", "-d", help="Destination directory", default="." ) unpack_parser.add_argument("wheelfile", help="Wheel file") unpack_parser.set_defaults(func=unpack_f) repack_parser = s.add_parser("pack", help="Repack wheel") repack_parser.add_argument("directory", help="Root directory of the unpacked wheel") repack_parser.add_argument( "--dest-dir", "-d", default=os.path.curdir, help="Directory to store the wheel (default %(default)s)", ) repack_parser.add_argument( "--build-number", help="Build tag to use in the wheel name" ) repack_parser.set_defaults(func=pack_f) convert_parser = s.add_parser("convert", help="Convert egg or wininst to wheel") convert_parser.add_argument("files", nargs="*", help="Files to convert") convert_parser.add_argument( "--dest-dir", "-d", default=os.path.curdir, help="Directory to store wheels (default %(default)s)", ) convert_parser.add_argument("--verbose", "-v", action="store_true") convert_parser.set_defaults(func=convert_f) tags_parser = s.add_parser( "tags", help="Add or replace the tags on a wheel", description=TAGS_HELP ) tags_parser.add_argument("wheel", nargs="*", help="Existing wheel(s) to retag") tags_parser.add_argument( "--remove", action="store_true", help="Remove the original files, keeping only the renamed ones", ) tags_parser.add_argument( "--python-tag", metavar="TAG", help="Specify an interpreter tag(s)" ) tags_parser.add_argument("--abi-tag", metavar="TAG", help="Specify an ABI tag(s)") tags_parser.add_argument( "--platform-tag", metavar="TAG", help="Specify a platform tag(s)" ) tags_parser.add_argument( "--build", type=parse_build_tag, metavar="BUILD", help="Specify a build tag" ) tags_parser.set_defaults(func=tags_f) version_parser = s.add_parser("version", help="Print version and exit") version_parser.set_defaults(func=version_f) help_parser = s.add_parser("help", help="Show this help") help_parser.set_defaults(func=lambda args: p.print_help()) return p def main(): p = parser() args = p.parse_args() if not hasattr(args, "func"): p.print_help() else: try: args.func(args) return 0 except WheelError as e: print(e, file=sys.stderr) return 1 _vendor/wheel/__main__.py 0000644 00000000707 15030122015 0011367 0 ustar 00 """ Wheel command line tool (enable python -m wheel syntax) """ from __future__ import annotations import sys def main(): # needed for console script if __package__ == "": # To be able to run 'python wheel-0.9.whl/wheel': import os.path path = os.path.dirname(os.path.dirname(__file__)) sys.path[0:0] = [path] import wheel.cli sys.exit(wheel.cli.main()) if __name__ == "__main__": sys.exit(main()) _vendor/wheel/wheelfile.py 0000644 00000020333 15030122015 0011610 0 ustar 00 from __future__ import annotations import csv import hashlib import os.path import re import stat import time from io import StringIO, TextIOWrapper from typing import IO, TYPE_CHECKING, Literal from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo from wheel.cli import WheelError from wheel.util import log, urlsafe_b64decode, urlsafe_b64encode if TYPE_CHECKING: from typing import Protocol, Sized, Union from typing_extensions import Buffer StrPath = Union[str, os.PathLike[str]] class SizedBuffer(Sized, Buffer, Protocol): ... # Non-greedy matching of an optional build number may be too clever (more # invalid wheel filenames will match). Separate regex for .dist-info? WHEEL_INFO_RE = re.compile( r"""^(?P<namever>(?P<name>[^\s-]+?)-(?P<ver>[^\s-]+?))(-(?P<build>\d[^\s-]*))? -(?P<pyver>[^\s-]+?)-(?P<abi>[^\s-]+?)-(?P<plat>\S+)\.whl$""", re.VERBOSE, ) MINIMUM_TIMESTAMP = 315532800 # 1980-01-01 00:00:00 UTC def get_zipinfo_datetime(timestamp: float | None = None): # Some applications need reproducible .whl files, but they can't do this without # forcing the timestamp of the individual ZipInfo objects. See issue #143. timestamp = int(os.environ.get("SOURCE_DATE_EPOCH", timestamp or time.time())) timestamp = max(timestamp, MINIMUM_TIMESTAMP) return time.gmtime(timestamp)[0:6] class WheelFile(ZipFile): """A ZipFile derivative class that also reads SHA-256 hashes from .dist-info/RECORD and checks any read files against those. """ _default_algorithm = hashlib.sha256 def __init__( self, file: StrPath, mode: Literal["r", "w", "x", "a"] = "r", compression: int = ZIP_DEFLATED, ): basename = os.path.basename(file) self.parsed_filename = WHEEL_INFO_RE.match(basename) if not basename.endswith(".whl") or self.parsed_filename is None: raise WheelError(f"Bad wheel filename {basename!r}") ZipFile.__init__(self, file, mode, compression=compression, allowZip64=True) self.dist_info_path = "{}.dist-info".format( self.parsed_filename.group("namever") ) self.record_path = self.dist_info_path + "/RECORD" self._file_hashes: dict[str, tuple[None, None] | tuple[int, bytes]] = {} self._file_sizes = {} if mode == "r": # Ignore RECORD and any embedded wheel signatures self._file_hashes[self.record_path] = None, None self._file_hashes[self.record_path + ".jws"] = None, None self._file_hashes[self.record_path + ".p7s"] = None, None # Fill in the expected hashes by reading them from RECORD try: record = self.open(self.record_path) except KeyError: raise WheelError(f"Missing {self.record_path} file") from None with record: for line in csv.reader( TextIOWrapper(record, newline="", encoding="utf-8") ): path, hash_sum, size = line if not hash_sum: continue algorithm, hash_sum = hash_sum.split("=") try: hashlib.new(algorithm) except ValueError: raise WheelError( f"Unsupported hash algorithm: {algorithm}" ) from None if algorithm.lower() in {"md5", "sha1"}: raise WheelError( f"Weak hash algorithm ({algorithm}) is not permitted by " f"PEP 427" ) self._file_hashes[path] = ( algorithm, urlsafe_b64decode(hash_sum.encode("ascii")), ) def open( self, name_or_info: str | ZipInfo, mode: Literal["r", "w"] = "r", pwd: bytes | None = None, ) -> IO[bytes]: def _update_crc(newdata: bytes) -> None: eof = ef._eof update_crc_orig(newdata) running_hash.update(newdata) if eof and running_hash.digest() != expected_hash: raise WheelError(f"Hash mismatch for file '{ef_name}'") ef_name = ( name_or_info.filename if isinstance(name_or_info, ZipInfo) else name_or_info ) if ( mode == "r" and not ef_name.endswith("/") and ef_name not in self._file_hashes ): raise WheelError(f"No hash found for file '{ef_name}'") ef = ZipFile.open(self, name_or_info, mode, pwd) if mode == "r" and not ef_name.endswith("/"): algorithm, expected_hash = self._file_hashes[ef_name] if expected_hash is not None: # Monkey patch the _update_crc method to also check for the hash from # RECORD running_hash = hashlib.new(algorithm) update_crc_orig, ef._update_crc = ef._update_crc, _update_crc return ef def write_files(self, base_dir: str): log.info(f"creating '{self.filename}' and adding '{base_dir}' to it") deferred: list[tuple[str, str]] = [] for root, dirnames, filenames in os.walk(base_dir): # Sort the directory names so that `os.walk` will walk them in a # defined order on the next iteration. dirnames.sort() for name in sorted(filenames): path = os.path.normpath(os.path.join(root, name)) if os.path.isfile(path): arcname = os.path.relpath(path, base_dir).replace(os.path.sep, "/") if arcname == self.record_path: pass elif root.endswith(".dist-info"): deferred.append((path, arcname)) else: self.write(path, arcname) deferred.sort() for path, arcname in deferred: self.write(path, arcname) def write( self, filename: str, arcname: str | None = None, compress_type: int | None = None, ) -> None: with open(filename, "rb") as f: st = os.fstat(f.fileno()) data = f.read() zinfo = ZipInfo( arcname or filename, date_time=get_zipinfo_datetime(st.st_mtime) ) zinfo.external_attr = (stat.S_IMODE(st.st_mode) | stat.S_IFMT(st.st_mode)) << 16 zinfo.compress_type = compress_type or self.compression self.writestr(zinfo, data, compress_type) def writestr( self, zinfo_or_arcname: str | ZipInfo, data: SizedBuffer | str, compress_type: int | None = None, ): if isinstance(zinfo_or_arcname, str): zinfo_or_arcname = ZipInfo( zinfo_or_arcname, date_time=get_zipinfo_datetime() ) zinfo_or_arcname.compress_type = self.compression zinfo_or_arcname.external_attr = (0o664 | stat.S_IFREG) << 16 if isinstance(data, str): data = data.encode("utf-8") ZipFile.writestr(self, zinfo_or_arcname, data, compress_type) fname = ( zinfo_or_arcname.filename if isinstance(zinfo_or_arcname, ZipInfo) else zinfo_or_arcname ) log.info(f"adding '{fname}'") if fname != self.record_path: hash_ = self._default_algorithm(data) self._file_hashes[fname] = ( hash_.name, urlsafe_b64encode(hash_.digest()).decode("ascii"), ) self._file_sizes[fname] = len(data) def close(self): # Write RECORD if self.fp is not None and self.mode == "w" and self._file_hashes: data = StringIO() writer = csv.writer(data, delimiter=",", quotechar='"', lineterminator="\n") writer.writerows( ( (fname, algorithm + "=" + hash_, self._file_sizes[fname]) for fname, (algorithm, hash_) in self._file_hashes.items() ) ) writer.writerow((format(self.record_path), "", "")) self.writestr(self.record_path, data.getvalue()) ZipFile.close(self) _vendor/wheel/util.py 0000644 00000000647 15030122015 0010627 0 ustar 00 from __future__ import annotations import base64 import logging log = logging.getLogger("wheel") def urlsafe_b64encode(data: bytes) -> bytes: """urlsafe_b64encode without padding""" return base64.urlsafe_b64encode(data).rstrip(b"=") def urlsafe_b64decode(data: bytes) -> bytes: """urlsafe_b64decode without padding""" pad = b"=" * (4 - (len(data) & 3)) return base64.urlsafe_b64decode(data + pad) _vendor/wheel/macosx_libfile.py 0000644 00000040274 15030122015 0012632 0 ustar 00 """ This module contains function to analyse dynamic library headers to extract system information Currently only for MacOSX Library file on macosx system starts with Mach-O or Fat field. This can be distinguish by first 32 bites and it is called magic number. Proper value of magic number is with suffix _MAGIC. Suffix _CIGAM means reversed bytes order. Both fields can occur in two types: 32 and 64 bytes. FAT field inform that this library contains few version of library (typically for different types version). It contains information where Mach-O headers starts. Each section started with Mach-O header contains one library (So if file starts with this field it contains only one version). After filed Mach-O there are section fields. Each of them starts with two fields: cmd - magic number for this command cmdsize - total size occupied by this section information. In this case only sections LC_VERSION_MIN_MACOSX (for macosx 10.13 and earlier) and LC_BUILD_VERSION (for macosx 10.14 and newer) are interesting, because them contains information about minimal system version. Important remarks: - For fat files this implementation looks for maximum number version. It not check if it is 32 or 64 and do not compare it with currently built package. So it is possible to false report higher version that needed. - All structures signatures are taken form macosx header files. - I think that binary format will be more stable than `otool` output. and if apple introduce some changes both implementation will need to be updated. - The system compile will set the deployment target no lower than 11.0 for arm64 builds. For "Universal 2" builds use the x86_64 deployment target when the arm64 target is 11.0. """ from __future__ import annotations import ctypes import os import sys from io import BufferedIOBase from typing import TYPE_CHECKING if TYPE_CHECKING: from typing import Union StrPath = Union[str, os.PathLike[str]] """here the needed const and struct from mach-o header files""" FAT_MAGIC = 0xCAFEBABE FAT_CIGAM = 0xBEBAFECA FAT_MAGIC_64 = 0xCAFEBABF FAT_CIGAM_64 = 0xBFBAFECA MH_MAGIC = 0xFEEDFACE MH_CIGAM = 0xCEFAEDFE MH_MAGIC_64 = 0xFEEDFACF MH_CIGAM_64 = 0xCFFAEDFE LC_VERSION_MIN_MACOSX = 0x24 LC_BUILD_VERSION = 0x32 CPU_TYPE_ARM64 = 0x0100000C mach_header_fields = [ ("magic", ctypes.c_uint32), ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int), ("filetype", ctypes.c_uint32), ("ncmds", ctypes.c_uint32), ("sizeofcmds", ctypes.c_uint32), ("flags", ctypes.c_uint32), ] """ struct mach_header { uint32_t magic; /* mach magic number identifier */ cpu_type_t cputype; /* cpu specifier */ cpu_subtype_t cpusubtype; /* machine specifier */ uint32_t filetype; /* type of file */ uint32_t ncmds; /* number of load commands */ uint32_t sizeofcmds; /* the size of all the load commands */ uint32_t flags; /* flags */ }; typedef integer_t cpu_type_t; typedef integer_t cpu_subtype_t; """ mach_header_fields_64 = mach_header_fields + [("reserved", ctypes.c_uint32)] """ struct mach_header_64 { uint32_t magic; /* mach magic number identifier */ cpu_type_t cputype; /* cpu specifier */ cpu_subtype_t cpusubtype; /* machine specifier */ uint32_t filetype; /* type of file */ uint32_t ncmds; /* number of load commands */ uint32_t sizeofcmds; /* the size of all the load commands */ uint32_t flags; /* flags */ uint32_t reserved; /* reserved */ }; """ fat_header_fields = [("magic", ctypes.c_uint32), ("nfat_arch", ctypes.c_uint32)] """ struct fat_header { uint32_t magic; /* FAT_MAGIC or FAT_MAGIC_64 */ uint32_t nfat_arch; /* number of structs that follow */ }; """ fat_arch_fields = [ ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int), ("offset", ctypes.c_uint32), ("size", ctypes.c_uint32), ("align", ctypes.c_uint32), ] """ struct fat_arch { cpu_type_t cputype; /* cpu specifier (int) */ cpu_subtype_t cpusubtype; /* machine specifier (int) */ uint32_t offset; /* file offset to this object file */ uint32_t size; /* size of this object file */ uint32_t align; /* alignment as a power of 2 */ }; """ fat_arch_64_fields = [ ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int), ("offset", ctypes.c_uint64), ("size", ctypes.c_uint64), ("align", ctypes.c_uint32), ("reserved", ctypes.c_uint32), ] """ struct fat_arch_64 { cpu_type_t cputype; /* cpu specifier (int) */ cpu_subtype_t cpusubtype; /* machine specifier (int) */ uint64_t offset; /* file offset to this object file */ uint64_t size; /* size of this object file */ uint32_t align; /* alignment as a power of 2 */ uint32_t reserved; /* reserved */ }; """ segment_base_fields = [("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32)] """base for reading segment info""" segment_command_fields = [ ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32), ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint32), ("vmsize", ctypes.c_uint32), ("fileoff", ctypes.c_uint32), ("filesize", ctypes.c_uint32), ("maxprot", ctypes.c_int), ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32), ("flags", ctypes.c_uint32), ] """ struct segment_command { /* for 32-bit architectures */ uint32_t cmd; /* LC_SEGMENT */ uint32_t cmdsize; /* includes sizeof section structs */ char segname[16]; /* segment name */ uint32_t vmaddr; /* memory address of this segment */ uint32_t vmsize; /* memory size of this segment */ uint32_t fileoff; /* file offset of this segment */ uint32_t filesize; /* amount to map from the file */ vm_prot_t maxprot; /* maximum VM protection */ vm_prot_t initprot; /* initial VM protection */ uint32_t nsects; /* number of sections in segment */ uint32_t flags; /* flags */ }; typedef int vm_prot_t; """ segment_command_fields_64 = [ ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32), ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint64), ("vmsize", ctypes.c_uint64), ("fileoff", ctypes.c_uint64), ("filesize", ctypes.c_uint64), ("maxprot", ctypes.c_int), ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32), ("flags", ctypes.c_uint32), ] """ struct segment_command_64 { /* for 64-bit architectures */ uint32_t cmd; /* LC_SEGMENT_64 */ uint32_t cmdsize; /* includes sizeof section_64 structs */ char segname[16]; /* segment name */ uint64_t vmaddr; /* memory address of this segment */ uint64_t vmsize; /* memory size of this segment */ uint64_t fileoff; /* file offset of this segment */ uint64_t filesize; /* amount to map from the file */ vm_prot_t maxprot; /* maximum VM protection */ vm_prot_t initprot; /* initial VM protection */ uint32_t nsects; /* number of sections in segment */ uint32_t flags; /* flags */ }; """ version_min_command_fields = segment_base_fields + [ ("version", ctypes.c_uint32), ("sdk", ctypes.c_uint32), ] """ struct version_min_command { uint32_t cmd; /* LC_VERSION_MIN_MACOSX or LC_VERSION_MIN_IPHONEOS or LC_VERSION_MIN_WATCHOS or LC_VERSION_MIN_TVOS */ uint32_t cmdsize; /* sizeof(struct min_version_command) */ uint32_t version; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ uint32_t sdk; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ }; """ build_version_command_fields = segment_base_fields + [ ("platform", ctypes.c_uint32), ("minos", ctypes.c_uint32), ("sdk", ctypes.c_uint32), ("ntools", ctypes.c_uint32), ] """ struct build_version_command { uint32_t cmd; /* LC_BUILD_VERSION */ uint32_t cmdsize; /* sizeof(struct build_version_command) plus */ /* ntools * sizeof(struct build_tool_version) */ uint32_t platform; /* platform */ uint32_t minos; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ uint32_t sdk; /* X.Y.Z is encoded in nibbles xxxx.yy.zz */ uint32_t ntools; /* number of tool entries following this */ }; """ def swap32(x: int) -> int: return ( ((x << 24) & 0xFF000000) | ((x << 8) & 0x00FF0000) | ((x >> 8) & 0x0000FF00) | ((x >> 24) & 0x000000FF) ) def get_base_class_and_magic_number( lib_file: BufferedIOBase, seek: int | None = None, ) -> tuple[type[ctypes.Structure], int]: if seek is None: seek = lib_file.tell() else: lib_file.seek(seek) magic_number = ctypes.c_uint32.from_buffer_copy( lib_file.read(ctypes.sizeof(ctypes.c_uint32)) ).value # Handle wrong byte order if magic_number in [FAT_CIGAM, FAT_CIGAM_64, MH_CIGAM, MH_CIGAM_64]: if sys.byteorder == "little": BaseClass = ctypes.BigEndianStructure else: BaseClass = ctypes.LittleEndianStructure magic_number = swap32(magic_number) else: BaseClass = ctypes.Structure lib_file.seek(seek) return BaseClass, magic_number def read_data(struct_class: type[ctypes.Structure], lib_file: BufferedIOBase): return struct_class.from_buffer_copy(lib_file.read(ctypes.sizeof(struct_class))) def extract_macosx_min_system_version(path_to_lib: str): with open(path_to_lib, "rb") as lib_file: BaseClass, magic_number = get_base_class_and_magic_number(lib_file, 0) if magic_number not in [FAT_MAGIC, FAT_MAGIC_64, MH_MAGIC, MH_MAGIC_64]: return if magic_number in [FAT_MAGIC, FAT_CIGAM_64]: class FatHeader(BaseClass): _fields_ = fat_header_fields fat_header = read_data(FatHeader, lib_file) if magic_number == FAT_MAGIC: class FatArch(BaseClass): _fields_ = fat_arch_fields else: class FatArch(BaseClass): _fields_ = fat_arch_64_fields fat_arch_list = [ read_data(FatArch, lib_file) for _ in range(fat_header.nfat_arch) ] versions_list: list[tuple[int, int, int]] = [] for el in fat_arch_list: try: version = read_mach_header(lib_file, el.offset) if version is not None: if el.cputype == CPU_TYPE_ARM64 and len(fat_arch_list) != 1: # Xcode will not set the deployment target below 11.0.0 # for the arm64 architecture. Ignore the arm64 deployment # in fat binaries when the target is 11.0.0, that way # the other architectures can select a lower deployment # target. # This is safe because there is no arm64 variant for # macOS 10.15 or earlier. if version == (11, 0, 0): continue versions_list.append(version) except ValueError: pass if len(versions_list) > 0: return max(versions_list) else: return None else: try: return read_mach_header(lib_file, 0) except ValueError: """when some error during read library files""" return None def read_mach_header( lib_file: BufferedIOBase, seek: int | None = None, ) -> tuple[int, int, int] | None: """ This function parses a Mach-O header and extracts information about the minimal macOS version. :param lib_file: reference to opened library file with pointer """ base_class, magic_number = get_base_class_and_magic_number(lib_file, seek) arch = "32" if magic_number == MH_MAGIC else "64" class SegmentBase(base_class): _fields_ = segment_base_fields if arch == "32": class MachHeader(base_class): _fields_ = mach_header_fields else: class MachHeader(base_class): _fields_ = mach_header_fields_64 mach_header = read_data(MachHeader, lib_file) for _i in range(mach_header.ncmds): pos = lib_file.tell() segment_base = read_data(SegmentBase, lib_file) lib_file.seek(pos) if segment_base.cmd == LC_VERSION_MIN_MACOSX: class VersionMinCommand(base_class): _fields_ = version_min_command_fields version_info = read_data(VersionMinCommand, lib_file) return parse_version(version_info.version) elif segment_base.cmd == LC_BUILD_VERSION: class VersionBuild(base_class): _fields_ = build_version_command_fields version_info = read_data(VersionBuild, lib_file) return parse_version(version_info.minos) else: lib_file.seek(pos + segment_base.cmdsize) continue def parse_version(version: int) -> tuple[int, int, int]: x = (version & 0xFFFF0000) >> 16 y = (version & 0x0000FF00) >> 8 z = version & 0x000000FF return x, y, z def calculate_macosx_platform_tag(archive_root: StrPath, platform_tag: str) -> str: """ Calculate proper macosx platform tag basing on files which are included to wheel Example platform tag `macosx-10.14-x86_64` """ prefix, base_version, suffix = platform_tag.split("-") base_version = tuple(int(x) for x in base_version.split(".")) base_version = base_version[:2] if base_version[0] > 10: base_version = (base_version[0], 0) assert len(base_version) == 2 if "MACOSX_DEPLOYMENT_TARGET" in os.environ: deploy_target = tuple( int(x) for x in os.environ["MACOSX_DEPLOYMENT_TARGET"].split(".") ) deploy_target = deploy_target[:2] if deploy_target[0] > 10: deploy_target = (deploy_target[0], 0) if deploy_target < base_version: sys.stderr.write( "[WARNING] MACOSX_DEPLOYMENT_TARGET is set to a lower value ({}) than " "the version on which the Python interpreter was compiled ({}), and " "will be ignored.\n".format( ".".join(str(x) for x in deploy_target), ".".join(str(x) for x in base_version), ) ) else: base_version = deploy_target assert len(base_version) == 2 start_version = base_version versions_dict: dict[str, tuple[int, int]] = {} for dirpath, _dirnames, filenames in os.walk(archive_root): for filename in filenames: if filename.endswith(".dylib") or filename.endswith(".so"): lib_path = os.path.join(dirpath, filename) min_ver = extract_macosx_min_system_version(lib_path) if min_ver is not None: min_ver = min_ver[0:2] if min_ver[0] > 10: min_ver = (min_ver[0], 0) versions_dict[lib_path] = min_ver if len(versions_dict) > 0: base_version = max(base_version, max(versions_dict.values())) # macosx platform tag do not support minor bugfix release fin_base_version = "_".join([str(x) for x in base_version]) if start_version < base_version: problematic_files = [k for k, v in versions_dict.items() if v > start_version] problematic_files = "\n".join(problematic_files) if len(problematic_files) == 1: files_form = "this file" else: files_form = "these files" error_message = ( "[WARNING] This wheel needs a higher macOS version than {} " "To silence this warning, set MACOSX_DEPLOYMENT_TARGET to at least " + fin_base_version + " or recreate " + files_form + " with lower " "MACOSX_DEPLOYMENT_TARGET: \n" + problematic_files ) if "MACOSX_DEPLOYMENT_TARGET" in os.environ: error_message = error_message.format( "is set in MACOSX_DEPLOYMENT_TARGET variable." ) else: error_message = error_message.format( "the version your Python interpreter is compiled against." ) sys.stderr.write(error_message) platform_tag = prefix + "_" + fin_base_version + "_" + suffix return platform_tag _vendor/wheel/bdist_wheel.py 0000644 00000002123 15030122015 0012132 0 ustar 00 from typing import TYPE_CHECKING from warnings import warn warn( "The 'wheel' package is no longer the canonical location of the 'bdist_wheel' " "command, and will be removed in a future release. Please update to setuptools " "v70.1 or later which contains an integrated version of this command.", DeprecationWarning, stacklevel=1, ) if TYPE_CHECKING: from ._bdist_wheel import bdist_wheel as bdist_wheel else: try: # Better integration/compatibility with setuptools: # in the case new fixes or PEPs are implemented in setuptools # there is no need to backport them to the deprecated code base. # This is useful in the case of old packages in the ecosystem # that are still used but have low maintenance. from setuptools.command.bdist_wheel import bdist_wheel except ImportError: # Only used in the case of old setuptools versions. # If the user wants to get the latest fixes/PEPs, # they are encouraged to address the deprecation warning. from ._bdist_wheel import bdist_wheel as bdist_wheel _vendor/wheel/_bdist_wheel.py 0000644 00000052276 15030122015 0012307 0 ustar 00 """ Create a wheel (.whl) distribution. A wheel is a built archive format. """ from __future__ import annotations import os import re import shutil import stat import struct import sys import sysconfig import warnings from email.generator import BytesGenerator, Generator from email.policy import EmailPolicy from glob import iglob from shutil import rmtree from typing import TYPE_CHECKING, Callable, Iterable, Literal, Sequence, cast from zipfile import ZIP_DEFLATED, ZIP_STORED import setuptools from setuptools import Command from . import __version__ as wheel_version from .metadata import pkginfo_to_metadata from .util import log from .vendored.packaging import tags from .vendored.packaging import version as _packaging_version from .wheelfile import WheelFile if TYPE_CHECKING: import types # ensure Python logging is configured try: __import__("setuptools.logging") except ImportError: # setuptools < ?? from . import _setuptools_logging _setuptools_logging.configure() def safe_name(name: str) -> str: """Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. """ return re.sub("[^A-Za-z0-9.]+", "-", name) def safe_version(version: str) -> str: """ Convert an arbitrary string to a standard version string """ try: # normalize the version return str(_packaging_version.Version(version)) except _packaging_version.InvalidVersion: version = version.replace(" ", ".") return re.sub("[^A-Za-z0-9.]+", "-", version) setuptools_major_version = int(setuptools.__version__.split(".")[0]) PY_LIMITED_API_PATTERN = r"cp3\d" def _is_32bit_interpreter() -> bool: return struct.calcsize("P") == 4 def python_tag() -> str: return f"py{sys.version_info[0]}" def get_platform(archive_root: str | None) -> str: """Return our platform name 'win32', 'linux_x86_64'""" result = sysconfig.get_platform() if result.startswith("macosx") and archive_root is not None: from .macosx_libfile import calculate_macosx_platform_tag result = calculate_macosx_platform_tag(archive_root, result) elif _is_32bit_interpreter(): if result == "linux-x86_64": # pip pull request #3497 result = "linux-i686" elif result == "linux-aarch64": # packaging pull request #234 # TODO armv8l, packaging pull request #690 => this did not land # in pip/packaging yet result = "linux-armv7l" return result.replace("-", "_") def get_flag( var: str, fallback: bool, expected: bool = True, warn: bool = True ) -> bool: """Use a fallback value for determining SOABI flags if the needed config var is unset or unavailable.""" val = sysconfig.get_config_var(var) if val is None: if warn: warnings.warn( f"Config variable '{var}' is unset, Python ABI tag may be incorrect", RuntimeWarning, stacklevel=2, ) return fallback return val == expected def get_abi_tag() -> str | None: """Return the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2).""" soabi: str = sysconfig.get_config_var("SOABI") impl = tags.interpreter_name() if not soabi and impl in ("cp", "pp") and hasattr(sys, "maxunicode"): d = "" m = "" u = "" if get_flag("Py_DEBUG", hasattr(sys, "gettotalrefcount"), warn=(impl == "cp")): d = "d" if get_flag( "WITH_PYMALLOC", impl == "cp", warn=(impl == "cp" and sys.version_info < (3, 8)), ) and sys.version_info < (3, 8): m = "m" abi = f"{impl}{tags.interpreter_version()}{d}{m}{u}" elif soabi and impl == "cp" and soabi.startswith("cpython"): # non-Windows abi = "cp" + soabi.split("-")[1] elif soabi and impl == "cp" and soabi.startswith("cp"): # Windows abi = soabi.split("-")[0] elif soabi and impl == "pp": # we want something like pypy36-pp73 abi = "-".join(soabi.split("-")[:2]) abi = abi.replace(".", "_").replace("-", "_") elif soabi and impl == "graalpy": abi = "-".join(soabi.split("-")[:3]) abi = abi.replace(".", "_").replace("-", "_") elif soabi: abi = soabi.replace(".", "_").replace("-", "_") else: abi = None return abi def safer_name(name: str) -> str: return safe_name(name).replace("-", "_") def safer_version(version: str) -> str: return safe_version(version).replace("-", "_") def remove_readonly( func: Callable[..., object], path: str, excinfo: tuple[type[Exception], Exception, types.TracebackType], ) -> None: remove_readonly_exc(func, path, excinfo[1]) def remove_readonly_exc(func: Callable[..., object], path: str, exc: Exception) -> None: os.chmod(path, stat.S_IWRITE) func(path) class bdist_wheel(Command): description = "create a wheel distribution" supported_compressions = { "stored": ZIP_STORED, "deflated": ZIP_DEFLATED, } user_options = [ ("bdist-dir=", "b", "temporary directory for creating the distribution"), ( "plat-name=", "p", "platform name to embed in generated filenames " f"(default: {get_platform(None)})", ), ( "keep-temp", "k", "keep the pseudo-installation tree around after " "creating the distribution archive", ), ("dist-dir=", "d", "directory to put final built distributions in"), ("skip-build", None, "skip rebuilding everything (for testing/debugging)"), ( "relative", None, "build the archive using relative paths (default: false)", ), ( "owner=", "u", "Owner name used when creating a tar file [default: current user]", ), ( "group=", "g", "Group name used when creating a tar file [default: current group]", ), ("universal", None, "make a universal wheel (default: false)"), ( "compression=", None, "zipfile compression (one of: {}) (default: 'deflated')".format( ", ".join(supported_compressions) ), ), ( "python-tag=", None, f"Python implementation compatibility tag (default: '{python_tag()}')", ), ( "build-number=", None, "Build number for this particular version. " "As specified in PEP-0427, this must start with a digit. " "[default: None]", ), ( "py-limited-api=", None, "Python tag (cp32|cp33|cpNN) for abi3 wheel tag (default: false)", ), ] boolean_options = ["keep-temp", "skip-build", "relative", "universal"] def initialize_options(self): self.bdist_dir: str = None self.data_dir = None self.plat_name: str | None = None self.plat_tag = None self.format = "zip" self.keep_temp = False self.dist_dir: str | None = None self.egginfo_dir = None self.root_is_pure: bool | None = None self.skip_build = None self.relative = False self.owner = None self.group = None self.universal: bool = False self.compression: str | int = "deflated" self.python_tag: str = python_tag() self.build_number: str | None = None self.py_limited_api: str | Literal[False] = False self.plat_name_supplied = False def finalize_options(self): if self.bdist_dir is None: bdist_base = self.get_finalized_command("bdist").bdist_base self.bdist_dir = os.path.join(bdist_base, "wheel") egg_info = self.distribution.get_command_obj("egg_info") egg_info.ensure_finalized() # needed for correct `wheel_dist_name` self.data_dir = self.wheel_dist_name + ".data" self.plat_name_supplied = self.plat_name is not None try: self.compression = self.supported_compressions[self.compression] except KeyError: raise ValueError(f"Unsupported compression: {self.compression}") from None need_options = ("dist_dir", "plat_name", "skip_build") self.set_undefined_options("bdist", *zip(need_options, need_options)) self.root_is_pure = not ( self.distribution.has_ext_modules() or self.distribution.has_c_libraries() ) if self.py_limited_api and not re.match( PY_LIMITED_API_PATTERN, self.py_limited_api ): raise ValueError(f"py-limited-api must match '{PY_LIMITED_API_PATTERN}'") # Support legacy [wheel] section for setting universal wheel = self.distribution.get_option_dict("wheel") if "universal" in wheel: # please don't define this in your global configs log.warning( "The [wheel] section is deprecated. Use [bdist_wheel] instead.", ) val = wheel["universal"][1].strip() if val.lower() in ("1", "true", "yes"): self.universal = True if self.build_number is not None and not self.build_number[:1].isdigit(): raise ValueError("Build tag (build-number) must start with a digit.") @property def wheel_dist_name(self): """Return distribution full name with - replaced with _""" components = ( safer_name(self.distribution.get_name()), safer_version(self.distribution.get_version()), ) if self.build_number: components += (self.build_number,) return "-".join(components) def get_tag(self) -> tuple[str, str, str]: # bdist sets self.plat_name if unset, we should only use it for purepy # wheels if the user supplied it. if self.plat_name_supplied: plat_name = cast(str, self.plat_name) elif self.root_is_pure: plat_name = "any" else: # macosx contains system version in platform name so need special handle if self.plat_name and not self.plat_name.startswith("macosx"): plat_name = self.plat_name else: # on macosx always limit the platform name to comply with any # c-extension modules in bdist_dir, since the user can specify # a higher MACOSX_DEPLOYMENT_TARGET via tools like CMake # on other platforms, and on macosx if there are no c-extension # modules, use the default platform name. plat_name = get_platform(self.bdist_dir) if _is_32bit_interpreter(): if plat_name in ("linux-x86_64", "linux_x86_64"): plat_name = "linux_i686" if plat_name in ("linux-aarch64", "linux_aarch64"): # TODO armv8l, packaging pull request #690 => this did not land # in pip/packaging yet plat_name = "linux_armv7l" plat_name = ( plat_name.lower().replace("-", "_").replace(".", "_").replace(" ", "_") ) if self.root_is_pure: if self.universal: impl = "py2.py3" else: impl = self.python_tag tag = (impl, "none", plat_name) else: impl_name = tags.interpreter_name() impl_ver = tags.interpreter_version() impl = impl_name + impl_ver # We don't work on CPython 3.1, 3.0. if self.py_limited_api and (impl_name + impl_ver).startswith("cp3"): impl = self.py_limited_api abi_tag = "abi3" else: abi_tag = str(get_abi_tag()).lower() tag = (impl, abi_tag, plat_name) # issue gh-374: allow overriding plat_name supported_tags = [ (t.interpreter, t.abi, plat_name) for t in tags.sys_tags() ] assert ( tag in supported_tags ), f"would build wheel with unsupported tag {tag}" return tag def run(self): build_scripts = self.reinitialize_command("build_scripts") build_scripts.executable = "python" build_scripts.force = True build_ext = self.reinitialize_command("build_ext") build_ext.inplace = False if not self.skip_build: self.run_command("build") install = self.reinitialize_command("install", reinit_subcommands=True) install.root = self.bdist_dir install.compile = False install.skip_build = self.skip_build install.warn_dir = False # A wheel without setuptools scripts is more cross-platform. # Use the (undocumented) `no_ep` option to setuptools' # install_scripts command to avoid creating entry point scripts. install_scripts = self.reinitialize_command("install_scripts") install_scripts.no_ep = True # Use a custom scheme for the archive, because we have to decide # at installation time which scheme to use. for key in ("headers", "scripts", "data", "purelib", "platlib"): setattr(install, "install_" + key, os.path.join(self.data_dir, key)) basedir_observed = "" if os.name == "nt": # win32 barfs if any of these are ''; could be '.'? # (distutils.command.install:change_roots bug) basedir_observed = os.path.normpath(os.path.join(self.data_dir, "..")) self.install_libbase = self.install_lib = basedir_observed setattr( install, "install_purelib" if self.root_is_pure else "install_platlib", basedir_observed, ) log.info(f"installing to {self.bdist_dir}") self.run_command("install") impl_tag, abi_tag, plat_tag = self.get_tag() archive_basename = f"{self.wheel_dist_name}-{impl_tag}-{abi_tag}-{plat_tag}" if not self.relative: archive_root = self.bdist_dir else: archive_root = os.path.join( self.bdist_dir, self._ensure_relative(install.install_base) ) self.set_undefined_options("install_egg_info", ("target", "egginfo_dir")) distinfo_dirname = ( f"{safer_name(self.distribution.get_name())}-" f"{safer_version(self.distribution.get_version())}.dist-info" ) distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname) self.egg2dist(self.egginfo_dir, distinfo_dir) self.write_wheelfile(distinfo_dir) # Make the archive if not os.path.exists(self.dist_dir): os.makedirs(self.dist_dir) wheel_path = os.path.join(self.dist_dir, archive_basename + ".whl") with WheelFile(wheel_path, "w", self.compression) as wf: wf.write_files(archive_root) # Add to 'Distribution.dist_files' so that the "upload" command works getattr(self.distribution, "dist_files", []).append( ( "bdist_wheel", "{}.{}".format(*sys.version_info[:2]), # like 3.7 wheel_path, ) ) if not self.keep_temp: log.info(f"removing {self.bdist_dir}") if not self.dry_run: if sys.version_info < (3, 12): rmtree(self.bdist_dir, onerror=remove_readonly) else: rmtree(self.bdist_dir, onexc=remove_readonly_exc) def write_wheelfile( self, wheelfile_base: str, generator: str = f"bdist_wheel ({wheel_version})" ): from email.message import Message msg = Message() msg["Wheel-Version"] = "1.0" # of the spec msg["Generator"] = generator msg["Root-Is-Purelib"] = str(self.root_is_pure).lower() if self.build_number is not None: msg["Build"] = self.build_number # Doesn't work for bdist_wininst impl_tag, abi_tag, plat_tag = self.get_tag() for impl in impl_tag.split("."): for abi in abi_tag.split("."): for plat in plat_tag.split("."): msg["Tag"] = "-".join((impl, abi, plat)) wheelfile_path = os.path.join(wheelfile_base, "WHEEL") log.info(f"creating {wheelfile_path}") with open(wheelfile_path, "wb") as f: BytesGenerator(f, maxheaderlen=0).flatten(msg) def _ensure_relative(self, path: str) -> str: # copied from dir_util, deleted drive, path = os.path.splitdrive(path) if path[0:1] == os.sep: path = drive + path[1:] return path @property def license_paths(self) -> Iterable[str]: if setuptools_major_version >= 57: # Setuptools has resolved any patterns to actual file names return self.distribution.metadata.license_files or () files: set[str] = set() metadata = self.distribution.get_option_dict("metadata") if setuptools_major_version >= 42: # Setuptools recognizes the license_files option but does not do globbing patterns = cast(Sequence[str], self.distribution.metadata.license_files) else: # Prior to those, wheel is entirely responsible for handling license files if "license_files" in metadata: patterns = metadata["license_files"][1].split() else: patterns = () if "license_file" in metadata: warnings.warn( 'The "license_file" option is deprecated. Use "license_files" instead.', DeprecationWarning, stacklevel=2, ) files.add(metadata["license_file"][1]) if not files and not patterns and not isinstance(patterns, list): patterns = ("LICEN[CS]E*", "COPYING*", "NOTICE*", "AUTHORS*") for pattern in patterns: for path in iglob(pattern): if path.endswith("~"): log.debug( f'ignoring license file "{path}" as it looks like a backup' ) continue if path not in files and os.path.isfile(path): log.info( f'adding license file "{path}" (matched pattern "{pattern}")' ) files.add(path) return files def egg2dist(self, egginfo_path: str, distinfo_path: str): """Convert an .egg-info directory into a .dist-info directory""" def adios(p: str) -> None: """Appropriately delete directory, file or link.""" if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p): shutil.rmtree(p) elif os.path.exists(p): os.unlink(p) adios(distinfo_path) if not os.path.exists(egginfo_path): # There is no egg-info. This is probably because the egg-info # file/directory is not named matching the distribution name used # to name the archive file. Check for this case and report # accordingly. import glob pat = os.path.join(os.path.dirname(egginfo_path), "*.egg-info") possible = glob.glob(pat) err = f"Egg metadata expected at {egginfo_path} but not found" if possible: alt = os.path.basename(possible[0]) err += f" ({alt} found - possible misnamed archive file?)" raise ValueError(err) if os.path.isfile(egginfo_path): # .egg-info is a single file pkg_info = pkginfo_to_metadata(egginfo_path, egginfo_path) os.mkdir(distinfo_path) else: # .egg-info is a directory pkginfo_path = os.path.join(egginfo_path, "PKG-INFO") pkg_info = pkginfo_to_metadata(egginfo_path, pkginfo_path) # ignore common egg metadata that is useless to wheel shutil.copytree( egginfo_path, distinfo_path, ignore=lambda x, y: { "PKG-INFO", "requires.txt", "SOURCES.txt", "not-zip-safe", }, ) # delete dependency_links if it is only whitespace dependency_links_path = os.path.join(distinfo_path, "dependency_links.txt") with open(dependency_links_path, encoding="utf-8") as dependency_links_file: dependency_links = dependency_links_file.read().strip() if not dependency_links: adios(dependency_links_path) pkg_info_path = os.path.join(distinfo_path, "METADATA") serialization_policy = EmailPolicy( utf8=True, mangle_from_=False, max_line_length=0, ) with open(pkg_info_path, "w", encoding="utf-8") as out: Generator(out, policy=serialization_policy).flatten(pkg_info) for license_path in self.license_paths: filename = os.path.basename(license_path) shutil.copy(license_path, os.path.join(distinfo_path, filename)) adios(egginfo_path) _vendor/wheel/__init__.py 0000644 00000000073 15030122015 0011402 0 ustar 00 from __future__ import annotations __version__ = "0.45.1" _vendor/packaging/requirements.py 0000644 00000005603 15030122015 0013212 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import annotations from typing import Any, Iterator from ._parser import parse_requirement as _parse_requirement from ._tokenizer import ParserSyntaxError from .markers import Marker, _normalize_extra_values from .specifiers import SpecifierSet from .utils import canonicalize_name class InvalidRequirement(ValueError): """ An invalid requirement was found, users should refer to PEP 508. """ class Requirement: """Parse a requirement. Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. """ # TODO: Can we test whether something is contained within a requirement? # If so how do we do that? Do we need to test against the _name_ of # the thing as well as the version? What about the markers? # TODO: Can we normalize the name and extra name? def __init__(self, requirement_string: str) -> None: try: parsed = _parse_requirement(requirement_string) except ParserSyntaxError as e: raise InvalidRequirement(str(e)) from e self.name: str = parsed.name self.url: str | None = parsed.url or None self.extras: set[str] = set(parsed.extras or []) self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) self.marker: Marker | None = None if parsed.marker is not None: self.marker = Marker.__new__(Marker) self.marker._markers = _normalize_extra_values(parsed.marker) def _iter_parts(self, name: str) -> Iterator[str]: yield name if self.extras: formatted_extras = ",".join(sorted(self.extras)) yield f"[{formatted_extras}]" if self.specifier: yield str(self.specifier) if self.url: yield f"@ {self.url}" if self.marker: yield " " if self.marker: yield f"; {self.marker}" def __str__(self) -> str: return "".join(self._iter_parts(self.name)) def __repr__(self) -> str: return f"<Requirement('{self}')>" def __hash__(self) -> int: return hash( ( self.__class__.__name__, *self._iter_parts(canonicalize_name(self.name)), ) ) def __eq__(self, other: Any) -> bool: if not isinstance(other, Requirement): return NotImplemented return ( canonicalize_name(self.name) == canonicalize_name(other.name) and self.extras == other.extras and self.specifier == other.specifier and self.url == other.url and self.marker == other.marker ) _vendor/packaging/markers.py 0000644 00000024501 15030122015 0012131 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import annotations import operator import os import platform import sys from typing import Any, Callable, TypedDict, cast from ._parser import MarkerAtom, MarkerList, Op, Value, Variable from ._parser import parse_marker as _parse_marker from ._tokenizer import ParserSyntaxError from .specifiers import InvalidSpecifier, Specifier from .utils import canonicalize_name __all__ = [ "InvalidMarker", "Marker", "UndefinedComparison", "UndefinedEnvironmentName", "default_environment", ] Operator = Callable[[str, str], bool] class InvalidMarker(ValueError): """ An invalid marker was found, users should refer to PEP 508. """ class UndefinedComparison(ValueError): """ An invalid operation was attempted on a value that doesn't support it. """ class UndefinedEnvironmentName(ValueError): """ A name was attempted to be used that does not exist inside of the environment. """ class Environment(TypedDict): implementation_name: str """The implementation's identifier, e.g. ``'cpython'``.""" implementation_version: str """ The implementation's version, e.g. ``'3.13.0a2'`` for CPython 3.13.0a2, or ``'7.3.13'`` for PyPy3.10 v7.3.13. """ os_name: str """ The value of :py:data:`os.name`. The name of the operating system dependent module imported, e.g. ``'posix'``. """ platform_machine: str """ Returns the machine type, e.g. ``'i386'``. An empty string if the value cannot be determined. """ platform_release: str """ The system's release, e.g. ``'2.2.0'`` or ``'NT'``. An empty string if the value cannot be determined. """ platform_system: str """ The system/OS name, e.g. ``'Linux'``, ``'Windows'`` or ``'Java'``. An empty string if the value cannot be determined. """ platform_version: str """ The system's release version, e.g. ``'#3 on degas'``. An empty string if the value cannot be determined. """ python_full_version: str """ The Python version as string ``'major.minor.patchlevel'``. Note that unlike the Python :py:data:`sys.version`, this value will always include the patchlevel (it defaults to 0). """ platform_python_implementation: str """ A string identifying the Python implementation, e.g. ``'CPython'``. """ python_version: str """The Python version as string ``'major.minor'``.""" sys_platform: str """ This string contains a platform identifier that can be used to append platform-specific components to :py:data:`sys.path`, for instance. For Unix systems, except on Linux and AIX, this is the lowercased OS name as returned by ``uname -s`` with the first part of the version as returned by ``uname -r`` appended, e.g. ``'sunos5'`` or ``'freebsd8'``, at the time when Python was built. """ def _normalize_extra_values(results: Any) -> Any: """ Normalize extra values. """ if isinstance(results[0], tuple): lhs, op, rhs = results[0] if isinstance(lhs, Variable) and lhs.value == "extra": normalized_extra = canonicalize_name(rhs.value) rhs = Value(normalized_extra) elif isinstance(rhs, Variable) and rhs.value == "extra": normalized_extra = canonicalize_name(lhs.value) lhs = Value(normalized_extra) results[0] = lhs, op, rhs return results def _format_marker( marker: list[str] | MarkerAtom | str, first: bool | None = True ) -> str: assert isinstance(marker, (list, tuple, str)) # Sometimes we have a structure like [[...]] which is a single item list # where the single item is itself it's own list. In that case we want skip # the rest of this function so that we don't get extraneous () on the # outside. if ( isinstance(marker, list) and len(marker) == 1 and isinstance(marker[0], (list, tuple)) ): return _format_marker(marker[0]) if isinstance(marker, list): inner = (_format_marker(m, first=False) for m in marker) if first: return " ".join(inner) else: return "(" + " ".join(inner) + ")" elif isinstance(marker, tuple): return " ".join([m.serialize() for m in marker]) else: return marker _operators: dict[str, Operator] = { "in": lambda lhs, rhs: lhs in rhs, "not in": lambda lhs, rhs: lhs not in rhs, "<": operator.lt, "<=": operator.le, "==": operator.eq, "!=": operator.ne, ">=": operator.ge, ">": operator.gt, } def _eval_op(lhs: str, op: Op, rhs: str) -> bool: try: spec = Specifier("".join([op.serialize(), rhs])) except InvalidSpecifier: pass else: return spec.contains(lhs, prereleases=True) oper: Operator | None = _operators.get(op.serialize()) if oper is None: raise UndefinedComparison(f"Undefined {op!r} on {lhs!r} and {rhs!r}.") return oper(lhs, rhs) def _normalize(*values: str, key: str) -> tuple[str, ...]: # PEP 685 – Comparison of extra names for optional distribution dependencies # https://peps.python.org/pep-0685/ # > When comparing extra names, tools MUST normalize the names being # > compared using the semantics outlined in PEP 503 for names if key == "extra": return tuple(canonicalize_name(v) for v in values) # other environment markers don't have such standards return values def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool: groups: list[list[bool]] = [[]] for marker in markers: assert isinstance(marker, (list, tuple, str)) if isinstance(marker, list): groups[-1].append(_evaluate_markers(marker, environment)) elif isinstance(marker, tuple): lhs, op, rhs = marker if isinstance(lhs, Variable): environment_key = lhs.value lhs_value = environment[environment_key] rhs_value = rhs.value else: lhs_value = lhs.value environment_key = rhs.value rhs_value = environment[environment_key] lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key) groups[-1].append(_eval_op(lhs_value, op, rhs_value)) else: assert marker in ["and", "or"] if marker == "or": groups.append([]) return any(all(item) for item in groups) def format_full_version(info: sys._version_info) -> str: version = f"{info.major}.{info.minor}.{info.micro}" kind = info.releaselevel if kind != "final": version += kind[0] + str(info.serial) return version def default_environment() -> Environment: iver = format_full_version(sys.implementation.version) implementation_name = sys.implementation.name return { "implementation_name": implementation_name, "implementation_version": iver, "os_name": os.name, "platform_machine": platform.machine(), "platform_release": platform.release(), "platform_system": platform.system(), "platform_version": platform.version(), "python_full_version": platform.python_version(), "platform_python_implementation": platform.python_implementation(), "python_version": ".".join(platform.python_version_tuple()[:2]), "sys_platform": sys.platform, } class Marker: def __init__(self, marker: str) -> None: # Note: We create a Marker object without calling this constructor in # packaging.requirements.Requirement. If any additional logic is # added here, make sure to mirror/adapt Requirement. try: self._markers = _normalize_extra_values(_parse_marker(marker)) # The attribute `_markers` can be described in terms of a recursive type: # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]] # # For example, the following expression: # python_version > "3.6" or (python_version == "3.6" and os_name == "unix") # # is parsed into: # [ # (<Variable('python_version')>, <Op('>')>, <Value('3.6')>), # 'and', # [ # (<Variable('python_version')>, <Op('==')>, <Value('3.6')>), # 'or', # (<Variable('os_name')>, <Op('==')>, <Value('unix')>) # ] # ] except ParserSyntaxError as e: raise InvalidMarker(str(e)) from e def __str__(self) -> str: return _format_marker(self._markers) def __repr__(self) -> str: return f"<Marker('{self}')>" def __hash__(self) -> int: return hash((self.__class__.__name__, str(self))) def __eq__(self, other: Any) -> bool: if not isinstance(other, Marker): return NotImplemented return str(self) == str(other) def evaluate(self, environment: dict[str, str] | None = None) -> bool: """Evaluate a marker. Return the boolean from evaluating the given marker against the environment. environment is an optional argument to override all or part of the determined environment. The environment is determined from the current Python process. """ current_environment = cast("dict[str, str]", default_environment()) current_environment["extra"] = "" if environment is not None: current_environment.update(environment) # The API used to allow setting extra to None. We need to handle this # case for backwards compatibility. if current_environment["extra"] is None: current_environment["extra"] = "" return _evaluate_markers( self._markers, _repair_python_full_version(current_environment) ) def _repair_python_full_version(env: dict[str, str]) -> dict[str, str]: """ Work around platform.python_version() returning something that is not PEP 440 compliant for non-tagged Python builds. """ if env["python_full_version"].endswith("+"): env["python_full_version"] += "local" return env _vendor/packaging/_manylinux.py 0000644 00000022614 15030122015 0012653 0 ustar 00 from __future__ import annotations import collections import contextlib import functools import os import re import sys import warnings from typing import Generator, Iterator, NamedTuple, Sequence from ._elffile import EIClass, EIData, ELFFile, EMachine EF_ARM_ABIMASK = 0xFF000000 EF_ARM_ABI_VER5 = 0x05000000 EF_ARM_ABI_FLOAT_HARD = 0x00000400 # `os.PathLike` not a generic type until Python 3.9, so sticking with `str` # as the type for `path` until then. @contextlib.contextmanager def _parse_elf(path: str) -> Generator[ELFFile | None, None, None]: try: with open(path, "rb") as f: yield ELFFile(f) except (OSError, TypeError, ValueError): yield None def _is_linux_armhf(executable: str) -> bool: # hard-float ABI can be detected from the ELF header of the running # process # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf with _parse_elf(executable) as f: return ( f is not None and f.capacity == EIClass.C32 and f.encoding == EIData.Lsb and f.machine == EMachine.Arm and f.flags & EF_ARM_ABIMASK == EF_ARM_ABI_VER5 and f.flags & EF_ARM_ABI_FLOAT_HARD == EF_ARM_ABI_FLOAT_HARD ) def _is_linux_i686(executable: str) -> bool: with _parse_elf(executable) as f: return ( f is not None and f.capacity == EIClass.C32 and f.encoding == EIData.Lsb and f.machine == EMachine.I386 ) def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool: if "armv7l" in archs: return _is_linux_armhf(executable) if "i686" in archs: return _is_linux_i686(executable) allowed_archs = { "x86_64", "aarch64", "ppc64", "ppc64le", "s390x", "loongarch64", "riscv64", } return any(arch in allowed_archs for arch in archs) # If glibc ever changes its major version, we need to know what the last # minor version was, so we can build the complete list of all versions. # For now, guess what the highest minor version might be, assume it will # be 50 for testing. Once this actually happens, update the dictionary # with the actual value. _LAST_GLIBC_MINOR: dict[int, int] = collections.defaultdict(lambda: 50) class _GLibCVersion(NamedTuple): major: int minor: int def _glibc_version_string_confstr() -> str | None: """ Primary implementation of glibc_version_string using os.confstr. """ # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely # to be broken or missing. This strategy is used in the standard library # platform module. # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183 try: # Should be a string like "glibc 2.17". version_string: str | None = os.confstr("CS_GNU_LIBC_VERSION") assert version_string is not None _, version = version_string.rsplit() except (AssertionError, AttributeError, OSError, ValueError): # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)... return None return version def _glibc_version_string_ctypes() -> str | None: """ Fallback implementation of glibc_version_string using ctypes. """ try: import ctypes except ImportError: return None # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen # manpage says, "If filename is NULL, then the returned handle is for the # main program". This way we can let the linker do the work to figure out # which libc our process is actually using. # # We must also handle the special case where the executable is not a # dynamically linked executable. This can occur when using musl libc, # for example. In this situation, dlopen() will error, leading to an # OSError. Interestingly, at least in the case of musl, there is no # errno set on the OSError. The single string argument used to construct # OSError comes from libc itself and is therefore not portable to # hard code here. In any case, failure to call dlopen() means we # can proceed, so we bail on our attempt. try: process_namespace = ctypes.CDLL(None) except OSError: return None try: gnu_get_libc_version = process_namespace.gnu_get_libc_version except AttributeError: # Symbol doesn't exist -> therefore, we are not linked to # glibc. return None # Call gnu_get_libc_version, which returns a string like "2.5" gnu_get_libc_version.restype = ctypes.c_char_p version_str: str = gnu_get_libc_version() # py2 / py3 compatibility: if not isinstance(version_str, str): version_str = version_str.decode("ascii") return version_str def _glibc_version_string() -> str | None: """Returns glibc version string, or None if not using glibc.""" return _glibc_version_string_confstr() or _glibc_version_string_ctypes() def _parse_glibc_version(version_str: str) -> tuple[int, int]: """Parse glibc version. We use a regexp instead of str.split because we want to discard any random junk that might come after the minor version -- this might happen in patched/forked versions of glibc (e.g. Linaro's version of glibc uses version strings like "2.20-2014.11"). See gh-3588. """ m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str) if not m: warnings.warn( f"Expected glibc version with 2 components major.minor," f" got: {version_str}", RuntimeWarning, stacklevel=2, ) return -1, -1 return int(m.group("major")), int(m.group("minor")) @functools.lru_cache def _get_glibc_version() -> tuple[int, int]: version_str = _glibc_version_string() if version_str is None: return (-1, -1) return _parse_glibc_version(version_str) # From PEP 513, PEP 600 def _is_compatible(arch: str, version: _GLibCVersion) -> bool: sys_glibc = _get_glibc_version() if sys_glibc < version: return False # Check for presence of _manylinux module. try: import _manylinux except ImportError: return True if hasattr(_manylinux, "manylinux_compatible"): result = _manylinux.manylinux_compatible(version[0], version[1], arch) if result is not None: return bool(result) return True if version == _GLibCVersion(2, 5): if hasattr(_manylinux, "manylinux1_compatible"): return bool(_manylinux.manylinux1_compatible) if version == _GLibCVersion(2, 12): if hasattr(_manylinux, "manylinux2010_compatible"): return bool(_manylinux.manylinux2010_compatible) if version == _GLibCVersion(2, 17): if hasattr(_manylinux, "manylinux2014_compatible"): return bool(_manylinux.manylinux2014_compatible) return True _LEGACY_MANYLINUX_MAP = { # CentOS 7 w/ glibc 2.17 (PEP 599) (2, 17): "manylinux2014", # CentOS 6 w/ glibc 2.12 (PEP 571) (2, 12): "manylinux2010", # CentOS 5 w/ glibc 2.5 (PEP 513) (2, 5): "manylinux1", } def platform_tags(archs: Sequence[str]) -> Iterator[str]: """Generate manylinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be manylinux-compatible. :returns: An iterator of compatible manylinux tags. """ if not _have_compatible_abi(sys.executable, archs): return # Oldest glibc to be supported regardless of architecture is (2, 17). too_old_glibc2 = _GLibCVersion(2, 16) if set(archs) & {"x86_64", "i686"}: # On x86/i686 also oldest glibc to be supported is (2, 5). too_old_glibc2 = _GLibCVersion(2, 4) current_glibc = _GLibCVersion(*_get_glibc_version()) glibc_max_list = [current_glibc] # We can assume compatibility across glibc major versions. # https://sourceware.org/bugzilla/show_bug.cgi?id=24636 # # Build a list of maximum glibc versions so that we can # output the canonical list of all glibc from current_glibc # down to too_old_glibc2, including all intermediary versions. for glibc_major in range(current_glibc.major - 1, 1, -1): glibc_minor = _LAST_GLIBC_MINOR[glibc_major] glibc_max_list.append(_GLibCVersion(glibc_major, glibc_minor)) for arch in archs: for glibc_max in glibc_max_list: if glibc_max.major == too_old_glibc2.major: min_minor = too_old_glibc2.minor else: # For other glibc major versions oldest supported is (x, 0). min_minor = -1 for glibc_minor in range(glibc_max.minor, min_minor, -1): glibc_version = _GLibCVersion(glibc_max.major, glibc_minor) tag = "manylinux_{}_{}".format(*glibc_version) if _is_compatible(arch, glibc_version): yield f"{tag}_{arch}" # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags. if glibc_version in _LEGACY_MANYLINUX_MAP: legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version] if _is_compatible(arch, glibc_version): yield f"{legacy_tag}_{arch}" _vendor/packaging/_parser.py 0000644 00000023774 15030122015 0012133 0 ustar 00 """Handwritten parser of dependency specifiers. The docstring for each __parse_* function contains EBNF-inspired grammar representing the implementation. """ from __future__ import annotations import ast from typing import NamedTuple, Sequence, Tuple, Union from ._tokenizer import DEFAULT_RULES, Tokenizer class Node: def __init__(self, value: str) -> None: self.value = value def __str__(self) -> str: return self.value def __repr__(self) -> str: return f"<{self.__class__.__name__}('{self}')>" def serialize(self) -> str: raise NotImplementedError class Variable(Node): def serialize(self) -> str: return str(self) class Value(Node): def serialize(self) -> str: return f'"{self}"' class Op(Node): def serialize(self) -> str: return str(self) MarkerVar = Union[Variable, Value] MarkerItem = Tuple[MarkerVar, Op, MarkerVar] MarkerAtom = Union[MarkerItem, Sequence["MarkerAtom"]] MarkerList = Sequence[Union["MarkerList", MarkerAtom, str]] class ParsedRequirement(NamedTuple): name: str url: str extras: list[str] specifier: str marker: MarkerList | None # -------------------------------------------------------------------------------------- # Recursive descent parser for dependency specifier # -------------------------------------------------------------------------------------- def parse_requirement(source: str) -> ParsedRequirement: return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES)) def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement: """ requirement = WS? IDENTIFIER WS? extras WS? requirement_details """ tokenizer.consume("WS") name_token = tokenizer.expect( "IDENTIFIER", expected="package name at the start of dependency specifier" ) name = name_token.text tokenizer.consume("WS") extras = _parse_extras(tokenizer) tokenizer.consume("WS") url, specifier, marker = _parse_requirement_details(tokenizer) tokenizer.expect("END", expected="end of dependency specifier") return ParsedRequirement(name, url, extras, specifier, marker) def _parse_requirement_details( tokenizer: Tokenizer, ) -> tuple[str, str, MarkerList | None]: """ requirement_details = AT URL (WS requirement_marker?)? | specifier WS? (requirement_marker)? """ specifier = "" url = "" marker = None if tokenizer.check("AT"): tokenizer.read() tokenizer.consume("WS") url_start = tokenizer.position url = tokenizer.expect("URL", expected="URL after @").text if tokenizer.check("END", peek=True): return (url, specifier, marker) tokenizer.expect("WS", expected="whitespace after URL") # The input might end after whitespace. if tokenizer.check("END", peek=True): return (url, specifier, marker) marker = _parse_requirement_marker( tokenizer, span_start=url_start, after="URL and whitespace" ) else: specifier_start = tokenizer.position specifier = _parse_specifier(tokenizer) tokenizer.consume("WS") if tokenizer.check("END", peek=True): return (url, specifier, marker) marker = _parse_requirement_marker( tokenizer, span_start=specifier_start, after=( "version specifier" if specifier else "name and no valid version specifier" ), ) return (url, specifier, marker) def _parse_requirement_marker( tokenizer: Tokenizer, *, span_start: int, after: str ) -> MarkerList: """ requirement_marker = SEMICOLON marker WS? """ if not tokenizer.check("SEMICOLON"): tokenizer.raise_syntax_error( f"Expected end or semicolon (after {after})", span_start=span_start, ) tokenizer.read() marker = _parse_marker(tokenizer) tokenizer.consume("WS") return marker def _parse_extras(tokenizer: Tokenizer) -> list[str]: """ extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? """ if not tokenizer.check("LEFT_BRACKET", peek=True): return [] with tokenizer.enclosing_tokens( "LEFT_BRACKET", "RIGHT_BRACKET", around="extras", ): tokenizer.consume("WS") extras = _parse_extras_list(tokenizer) tokenizer.consume("WS") return extras def _parse_extras_list(tokenizer: Tokenizer) -> list[str]: """ extras_list = identifier (wsp* ',' wsp* identifier)* """ extras: list[str] = [] if not tokenizer.check("IDENTIFIER"): return extras extras.append(tokenizer.read().text) while True: tokenizer.consume("WS") if tokenizer.check("IDENTIFIER", peek=True): tokenizer.raise_syntax_error("Expected comma between extra names") elif not tokenizer.check("COMMA"): break tokenizer.read() tokenizer.consume("WS") extra_token = tokenizer.expect("IDENTIFIER", expected="extra name after comma") extras.append(extra_token.text) return extras def _parse_specifier(tokenizer: Tokenizer) -> str: """ specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS | WS? version_many WS? """ with tokenizer.enclosing_tokens( "LEFT_PARENTHESIS", "RIGHT_PARENTHESIS", around="version specifier", ): tokenizer.consume("WS") parsed_specifiers = _parse_version_many(tokenizer) tokenizer.consume("WS") return parsed_specifiers def _parse_version_many(tokenizer: Tokenizer) -> str: """ version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? """ parsed_specifiers = "" while tokenizer.check("SPECIFIER"): span_start = tokenizer.position parsed_specifiers += tokenizer.read().text if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True): tokenizer.raise_syntax_error( ".* suffix can only be used with `==` or `!=` operators", span_start=span_start, span_end=tokenizer.position + 1, ) if tokenizer.check("VERSION_LOCAL_LABEL_TRAIL", peek=True): tokenizer.raise_syntax_error( "Local version label can only be used with `==` or `!=` operators", span_start=span_start, span_end=tokenizer.position, ) tokenizer.consume("WS") if not tokenizer.check("COMMA"): break parsed_specifiers += tokenizer.read().text tokenizer.consume("WS") return parsed_specifiers # -------------------------------------------------------------------------------------- # Recursive descent parser for marker expression # -------------------------------------------------------------------------------------- def parse_marker(source: str) -> MarkerList: return _parse_full_marker(Tokenizer(source, rules=DEFAULT_RULES)) def _parse_full_marker(tokenizer: Tokenizer) -> MarkerList: retval = _parse_marker(tokenizer) tokenizer.expect("END", expected="end of marker expression") return retval def _parse_marker(tokenizer: Tokenizer) -> MarkerList: """ marker = marker_atom (BOOLOP marker_atom)+ """ expression = [_parse_marker_atom(tokenizer)] while tokenizer.check("BOOLOP"): token = tokenizer.read() expr_right = _parse_marker_atom(tokenizer) expression.extend((token.text, expr_right)) return expression def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom: """ marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? | WS? marker_item WS? """ tokenizer.consume("WS") if tokenizer.check("LEFT_PARENTHESIS", peek=True): with tokenizer.enclosing_tokens( "LEFT_PARENTHESIS", "RIGHT_PARENTHESIS", around="marker expression", ): tokenizer.consume("WS") marker: MarkerAtom = _parse_marker(tokenizer) tokenizer.consume("WS") else: marker = _parse_marker_item(tokenizer) tokenizer.consume("WS") return marker def _parse_marker_item(tokenizer: Tokenizer) -> MarkerItem: """ marker_item = WS? marker_var WS? marker_op WS? marker_var WS? """ tokenizer.consume("WS") marker_var_left = _parse_marker_var(tokenizer) tokenizer.consume("WS") marker_op = _parse_marker_op(tokenizer) tokenizer.consume("WS") marker_var_right = _parse_marker_var(tokenizer) tokenizer.consume("WS") return (marker_var_left, marker_op, marker_var_right) def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar: """ marker_var = VARIABLE | QUOTED_STRING """ if tokenizer.check("VARIABLE"): return process_env_var(tokenizer.read().text.replace(".", "_")) elif tokenizer.check("QUOTED_STRING"): return process_python_str(tokenizer.read().text) else: tokenizer.raise_syntax_error( message="Expected a marker variable or quoted string" ) def process_env_var(env_var: str) -> Variable: if env_var in ("platform_python_implementation", "python_implementation"): return Variable("platform_python_implementation") else: return Variable(env_var) def process_python_str(python_str: str) -> Value: value = ast.literal_eval(python_str) return Value(str(value)) def _parse_marker_op(tokenizer: Tokenizer) -> Op: """ marker_op = IN | NOT IN | OP """ if tokenizer.check("IN"): tokenizer.read() return Op("in") elif tokenizer.check("NOT"): tokenizer.read() tokenizer.expect("WS", expected="whitespace after 'not'") tokenizer.expect("IN", expected="'in' after 'not'") return Op("not in") elif tokenizer.check("OP"): return Op(tokenizer.read().text) else: return tokenizer.raise_syntax_error( "Expected marker operator, one of " "<=, <, !=, ==, >=, >, ~=, ===, in, not in" ) _vendor/packaging/__pycache__/_parser.cpython-310.pyc 0000644 00000022043 15030122015 0016456 0 ustar 00 o �h�' � @ sx d Z ddlmZ ddlZddlmZmZmZmZ ddl m Z m Z G dd� d�Z G d d � d e �Z G d d � d e �ZG d d� de �Zee ef Zeeeef Zeeed f Zeedeef ZG dd� de�ZdCdd�ZdDdd�ZdEd d �ZdFd"d#�ZdGd%d&�ZdGd'd(�ZdHd)d*�Z dHd+d,�Z dId-d.�Z dJd/d0�Z dJd1d2�Z dKd3d4�Z!dLd6d7�Z"dMd9d:�Z#dNd<d=�Z$dOd?d@�Z%dPdAdB�Z&dS )Qz�Handwritten parser of dependency specifiers. The docstring for each __parse_* function contains EBNF-inspired grammar representing the implementation. � )� annotationsN)� NamedTuple�Sequence�Tuple�Union� )� DEFAULT_RULES� Tokenizerc @ s4 e Zd Zddd�Zddd�Zdd d �Zdd d �Zd S )�Node�value�str�return�Nonec C s || _ d S �N�r )�selfr � r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_parser.py�__init__ s z Node.__init__c C s | j S r r �r r r r �__str__ s z Node.__str__c C s d| j j� d| � d�S )N�<z('z')>)� __class__�__name__r r r r �__repr__ s z Node.__repr__c C s t �r )�NotImplementedErrorr r r r � serialize s zNode.serializeN)r r r r �r r )r � __module__� __qualname__r r r r r r r r r s r c @ � e Zd Zddd�ZdS )�Variabler r c C � t | �S r �r r r r r r � zVariable.serializeNr �r r r r r r r r r! � r! c @ r )�Valuer r c C s d| � d�S )N�"r r r r r r # s zValue.serializeNr r% r r r r r' " r& r' c @ r )�Opr r c C r" r r# r r r r r ( r$ z Op.serializeNr r% r r r r r) ' r& r) � MarkerAtom� MarkerListc @ s6 e Zd ZU ded< ded< ded< ded< ded< d S ) �ParsedRequirementr �name�url� list[str]�extras� specifierzMarkerList | None�markerN)r r r �__annotations__r r r r r, 2 s r, �sourcer r c C � t t| td��S �N)�rules)�_parse_requirementr r �r4 r r r �parse_requirement= � r: � tokenizerr c C sf | � d� | jddd�}|j}| � d� t| �}| � d� t| �\}}}| jddd� t|||||�S )zI requirement = WS? IDENTIFIER WS? extras WS? requirement_details �WS� IDENTIFIERz1package name at the start of dependency specifier��expected�ENDzend of dependency specifier)�consume�expect�text� _parse_extras�_parse_requirement_detailsr, )r< � name_tokenr- r0 r. r1 r2 r r r r8 A s � r8 �"tuple[str, str, MarkerList | None]c C s� d}d}d}| � d�rF| �� | �d� | j}| jddd�j}| j dd d �r+|||fS | jdd d� | j dd d �r>|||fS t| |d d �}n#| j}t| �}| �d� | j dd d �r^|||fS t| ||redndd �}|||fS )z~ requirement_details = AT URL (WS requirement_marker?)? | specifier WS? (requirement_marker)? � N�ATr= �URLz URL after @r? rA T��peekzwhitespace after URLzURL and whitespace)� span_start�after�version specifierz#name and no valid version specifier)�check�readrB �positionrC rD �_parse_requirement_marker�_parse_specifier)r< r1 r. r2 � url_start�specifier_startr r r rF V s: � �� rF rN �intrO c C s> | � d�s| jd|� d�|d� | �� t| �}| �d� |S )z3 requirement_marker = SEMICOLON marker WS? � SEMICOLONz!Expected end or semicolon (after �))rN r= )rQ �raise_syntax_errorrR � _parse_markerrB )r< rN rO r2 r r r rT � s � rT r/ c C sd | j ddd�s g S | jdddd�� | �d� t| �}| �d� W d � |S 1 s+w Y |S ) zG extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)? � LEFT_BRACKETTrL � RIGHT_BRACKETr0 ��aroundr= N)rQ �enclosing_tokensrB �_parse_extras_list)r< r0 r r r rE � s � � � rE c C s� g }| � d�s |S |�| �� j� | �d� | j ddd�r$| �d� n| � d�s, |S | �� | �d� | jddd�}|�|j� q) z> extras_list = identifier (wsp* ',' wsp* identifier)* r> Tr= rL z"Expected comma between extra names�COMMAzextra name after commar? )rQ �appendrR rD rB r[ rC )r< r0 � extra_tokenr r r rb � s � �rb c C sR | j dddd�� | �d� t| �}| �d� W d � |S 1 s"w Y |S )zr specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS | WS? version_many WS? �LEFT_PARENTHESIS�RIGHT_PARENTHESISrP r_ r= N)ra rB �_parse_version_many)r< �parsed_specifiersr r r rU � s � � � rU c C s� d}| � d�rQ| j}|| �� j7 }| j ddd�r#| jd|| jd d� | j d dd�r3| jd || jd� | �d � | � d �s@ |S || �� j7 }| �d � | � d�s|S ) z@ version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)? rI � SPECIFIER�VERSION_PREFIX_TRAILTrL z6.* suffix can only be used with `==` or `!=` operatorsr )rN �span_end�VERSION_LOCAL_LABEL_TRAILz@Local version label can only be used with `==` or `!=` operatorsr= rc )rQ rS rR rD r[ rB )r< ri rN r r r rh � s0 �� � �rh c C r5 r6 )�_parse_full_markerr r r9 r r r � parse_marker� r; ro c C s t | �}| jddd� |S )NrA zend of marker expressionr? )r\ rC )r< �retvalr r r rn s rn c C sB t | �g}| �d�r | �� }t | �}|�|j|f� | �d�s |S )z4 marker = marker_atom (BOOLOP marker_atom)+ �BOOLOP)�_parse_marker_atomrQ rR �extendrD )r< � expression�token� expr_rightr r r r\ s �r\ c C s| | � d� | jddd�r3| jdddd�� | � d� t| �}| � d� W d � n1 s-w Y nt| �}| � d� |S ) zw marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS? | WS? marker_item WS? r= rf TrL rg zmarker expressionr_ N)rB rQ ra r\ �_parse_marker_item)r< r2 r r r rr s � �� rr � MarkerItemc C sJ | � d� t| �}| � d� t| �}| � d� t| �}| � d� |||fS )zG marker_item = WS? marker_var WS? marker_op WS? marker_var WS? r= )rB �_parse_marker_var�_parse_marker_op)r< �marker_var_left� marker_op�marker_var_rightr r r rw ( s rw � MarkerVarc C sH | � d�rt| �� j�dd��S | � d�r t| �� j�S | jdd� dS )z/ marker_var = VARIABLE | QUOTED_STRING �VARIABLE�.�_� QUOTED_STRINGz+Expected a marker variable or quoted string)�messageN)rQ �process_env_varrR rD �replace�process_python_strr[ �r< r r r ry 6 s �ry �env_varc C s | dv rt d�S t | �S )N)� platform_python_implementation�python_implementationr� )r! )r� r r r r� D s r� � python_strc C s t �| �}tt|��S r )�ast� literal_evalr' r )r� r r r r r� K s r� c C sr | � d�r | �� td�S | � d�r(| �� | jddd� | jddd� td�S | � d �r4t| �� j�S | �d �S ) z& marker_op = IN | NOT IN | OP �IN�in�NOTr= zwhitespace after 'not'r? z'in' after 'not'znot in�OPzJExpected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in)rQ rR r) rC rD r[ r� r r r rz P s �rz )r4 r r r, )r< r r r, )r< r r rH )r< r rN rX rO r r r+ )r< r r r/ )r< r r r )r4 r r r+ )r< r r r+ )r< r r r* )r< r r rx )r< r r r~ )r� r r r! )r� r r r' )r< r r r) )'�__doc__� __future__r r� �typingr r r r � _tokenizerr r r r! r' r) r~ rx r* r r+ r, r: r8 rF rT rE rb rU rh ro rn r\ rr rw ry r� r� rz r r r r �<module> s> 3 _vendor/packaging/__pycache__/_manylinux.cpython-310.pyc 0000644 00000014660 15030122015 0017214 0 ustar 00 o �h�% � @ s2 U d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z m Z m Z m Z ddlmZmZmZmZ dZdZdZejd7d d��Zd8dd�Zd8dd�Zd9dd�Ze�dd� �Z de d < G d d � d e �Z d:d d!�Z d:d"d#�Z d:d$d%�Z!d;d(d)�Z"ej#d<d*d+��Z$d=d.d/�Z%d0d1d2d3�Z&d>d5d6�Z'dS )?� )� annotationsN)� Generator�Iterator� NamedTuple�Sequence� )�EIClass�EIData�ELFFile�EMachinel ~ i i �path�str�return�%Generator[ELFFile | None, None, None]c c sb � z t | d��}t|�V W d � W d S 1 sw Y W d S tttfy0 d V Y d S w )N�rb)�openr �OSError� TypeError� ValueError)r �f� r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_manylinux.py� _parse_elf s � &� �r � executable�boolc C sv t | ��-}|d uo(|jtjko(|jtjko(|jtj ko(|j t @ t ko(|j t @ t k W d � S 1 s4w Y d S �N)r �capacityr �C32�encodingr �Lsb�machiner �Arm�flags�EF_ARM_ABIMASK�EF_ARM_ABI_VER5�EF_ARM_ABI_FLOAT_HARD�r r r r r �_is_linux_armhf s � � � � �$�r' c C sZ t | �� }|d uo|jtjko|jtjko|jtj k W d � S 1 s&w Y d S r ) r r r r r r r r r �I386r& r r r �_is_linux_i686- s � � �$�r) �archs� Sequence[str]c s> d|v rt | �S d|v rt| �S h d�� t� fdd�|D ��S )N�armv7l�i686> �ppc64�s390x�x86_64�aarch64�ppc64le�riscv64� loongarch64c 3 s � | ]}|� v V qd S r r )�.0�arch�� allowed_archsr r � <genexpr>E s � z'_have_compatible_abi.<locals>.<genexpr>)r' r) �any)r r* r r7 r �_have_compatible_abi7 s r; c C s dS )N�2 r r r r r �<lambda>M s r= zdict[int, int]�_LAST_GLIBC_MINORc @ s e Zd ZU ded< ded< dS )� _GLibCVersion�int�major�minorN)�__name__� __module__� __qualname__�__annotations__r r r r r? P s r? � str | Nonec C sF zt �d�} | dus J �| �� \}}W |S ttttfy" Y dS w )zJ Primary implementation of glibc_version_string using os.confstr. �CS_GNU_LIBC_VERSIONN)�os�confstr�rsplit�AssertionError�AttributeErrorr r )�version_string�_�versionr r r � _glibc_version_string_confstrU s ��rQ c C s� zddl } W n ty Y dS w z| �d�}W n ty" Y dS w z|j}W n ty2 Y dS w | j|_|� }t|t �sD|� d�}|S )zG Fallback implementation of glibc_version_string using ctypes. r N�ascii) �ctypes� ImportError�CDLLr �gnu_get_libc_versionrM �c_char_p�restype� isinstancer �decode)rS �process_namespacerV � version_strr r r � _glibc_version_string_ctypesh s( � � � r] c C s t � pt� S )z9Returns glibc version string, or None if not using glibc.)rQ r] r r r r �_glibc_version_string� s r^ r\ �tuple[int, int]c C sF t �d| �}|stjd| � �tdd� dS t|�d��t|�d��fS )a3 Parse glibc version. We use a regexp instead of str.split because we want to discard any random junk that might come after the minor version -- this might happen in patched/forked versions of glibc (e.g. Linaro's version of glibc uses version strings like "2.20-2014.11"). See gh-3588. z$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z;Expected glibc version with 2 components major.minor, got: � )� stacklevel����rc rA rB )�re�match�warnings�warn�RuntimeWarningr@ �group)r\ �mr r r �_parse_glibc_version� s �� rk c C s t � } | d u r dS t| �S )Nrb )r^ rk )r\ r r r �_get_glibc_version� s rl r6 rP c C s� t � }||k r dS zdd l}W n ty Y dS w t|d�r4|�|d |d | �}|d ur2t|�S dS |tdd�krEt|d�rEt|j�S |tdd �krVt|d �rVt|j�S |tdd �krgt|d �rgt|j �S dS ) NFr T�manylinux_compatibler r` � �manylinux1_compatible� �manylinux2010_compatible� �manylinux2014_compatible) rl � _manylinuxrT �hasattrrm r r? ro rq rs )r6 rP � sys_glibcrt �resultr r r �_is_compatible� s. � rx � manylinux2014� manylinux2010� manylinux1))r` rr )r` rp )r` rn � Iterator[str]c c s � t tj| �s dS tdd�}t| �ddh@ rtdd�}tt� � }|g}t|jd dd�D ]}t| }|� t||�� q,| D ]J}|D ]E}|j|jkrM|j }nd}t|j |d�D ]/}t|j|�} d j | � } t || �rp| � d |� �V | t v r�t | } t || �r�| � d |� �V qVqAq=dS ) a� Generate manylinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be manylinux-compatible. :returns: An iterator of compatible manylinux tags. Nr` � r0 r- � r rc zmanylinux_{}_{}rO )r; �sysr r? �setrl �rangerA r> �appendrB �formatrx �_LEGACY_MANYLINUX_MAP) r* �too_old_glibc2� current_glibc�glibc_max_list� glibc_major� glibc_minorr6 � glibc_max� min_minor� glibc_version�tag� legacy_tagr r r � platform_tags� s: � ����r� )r r r r )r r r r )r r r* r+ r r )r rG )r\ r r r_ )r r_ )r6 r rP r? r r )r* r+ r r| )(� __future__r � collections� contextlib� functoolsrI rd r rf �typingr r r r �_elffiler r r r r# r$ r% �contextmanagerr r' r) r; � defaultdictr> rF r? rQ r] r^ rk � lru_cacherl rx r� r� r r r r �<module> s@ , � _vendor/packaging/__pycache__/markers.cpython-310.pyc 0000644 00000017300 15030122015 0016467 0 ustar 00 o �hA) � @ s� U d dl mZ d dlZd dlZd dlZd dlZd dlmZmZm Z m Z ddl m Z m Z mZmZmZ ddl mZ ddlmZ ddlmZmZ dd lmZ g d �Zeeege f Z G d d � d e �Z G d d� de �Z G dd� de �Z!G dd� de �Z"dCdd�Z# dDdEd d �Z$d d!� d"d!� ej%ej&ej'ej(ej)ej*d#�Z+d$e,d%< dFd+d,�Z-dGd0d1�Z.dHd6d7�Z/dId:d;�Z0dJd<d=�Z1G d>d?� d?�Z2dKdAdB�Z3dS )L� )� annotationsN)�Any�Callable� TypedDict�cast� )� MarkerAtom� MarkerList�Op�Value�Variable)� parse_marker)�ParserSyntaxError)�InvalidSpecifier� Specifier��canonicalize_name)� InvalidMarker�Marker�UndefinedComparison�UndefinedEnvironmentName�default_environmentc @ � e Zd ZdZdS )r zE An invalid marker was found, users should refer to PEP 508. N��__name__� __module__� __qualname__�__doc__� r r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/markers.pyr � r c @ r )r zP An invalid operation was attempted on a value that doesn't support it. Nr r r r r r $ r r c @ r )r z\ A name was attempted to be used that does not exist inside of the environment. Nr r r r r r * r r c @ sz e Zd ZU ded< ded< ded< ded< ded< ded< ded< ded < ded < ded < ded < d S )� Environment�str�implementation_name�implementation_version�os_name�platform_machine�platform_release�platform_system�platform_version�python_full_version� platform_python_implementation�python_version� sys_platformN)r r r �__annotations__r r r r r! 1 s. r! �resultsr �returnc C s| t | d t�r<| d \}}}t |t�r"|jdkr"t|j�}t|�}nt |t�r5|jdkr5t|j�}t|�}|||f| d< | S )z! Normalize extra values. r �extra)� isinstance�tupler �valuer r )r/ �lhs�op�rhs�normalized_extrar r r �_normalize_extra_valuesy s r9 T�marker� list[str] | MarkerAtom | str�first� bool | Noner" c C s� t | tttf�s J �t | t�r$t| �dkr$t | d ttf�r$t| d �S t | t�r@dd� | D �}|r7d�|�S dd�|� d S t | t�rOd�dd � | D ��S | S ) Nr r c s s � | ] }t |d d�V qdS )F)r< N)�_format_marker��.0�mr r r � <genexpr>� s � z!_format_marker.<locals>.<genexpr>� �(�)c S s g | ]}|� � �qS r )� serializer? r r r � <listcomp>� s z"_format_marker.<locals>.<listcomp>)r2 �listr3 r" �lenr> �join)r: r< �innerr r r r> � s � � r> c C s | |v S �Nr �r5 r7 r r r �<lambda>� � rN c C s | |vS rL r rM r r r rN � rO )�inznot in�<z<=z==z!=z>=�>zdict[str, Operator]� _operatorsr5 r6 r r7 �boolc C sx z t d�|�� |g��}W n ty Y nw |j| dd�S t�|�� �}|d u r7td|�d| �d|�d���|| |�S )N� T)� prereleasesz Undefined z on z and �.)r rJ rF r �containsrS �getr )r5 r6 r7 �spec�operr r r �_eval_op� s � r\ �values�key�tuple[str, ...]c G s | dkr t dd� |D ��S |S )Nr1 c s � � | ]}t |�V qd S rL r )r@ �vr r r rB � � � z _normalize.<locals>.<genexpr>)r3 )r^ r] r r r � _normalize� s rc �markersr � environment�dict[str, str]c C s� g g}| D ]d}t |tttf�sJ �t |t�r!|d �t||�� qt |t�rZ|\}}}t |t�r;|j}|| }|j} n |j}|j}|| } t|| |d�\}} |d �t ||| �� q|dv s`J �|dkri|�g � qt dd� |D ��S )N���)r^ )�and�orri c s r` rL )�all)r@ �itemr r r rB � rb z$_evaluate_markers.<locals>.<genexpr>) r2 rH r3 r" �append�_evaluate_markersr r4 rc r\ �any) rd re �groupsr: r5 r6 r7 �environment_key� lhs_value� rhs_valuer r r rm � s* �rm �info�sys._version_infoc C sB | j � d| j� d| j� �}| j}|dkr ||d t| j� 7 }|S )NrW �finalr )�major�minor�micro� releaselevelr" �serial)rs �version�kindr r r �format_full_version� s r} c C s^ t tjj�} tjj}|| tjt�� t�� t� � t�� t� � t� � d� t� � d d� �tjd� S )NrW � ) r# r$ r% r& r' r( r) r* r+ r, r- )r} �sys�implementationr{ �name�os�platform�machine�release�systemr, �python_implementationrJ �python_version_tuple)�iverr# r r r r � s �r c @ sJ e Zd Zddd�Zddd�Zdd d �Zdd d �Zddd�Zd d dd�ZdS ) r r: r" r0 �Nonec C s< z t t|��| _W d S ty } ztt|��|�d }~ww rL )r9 � _parse_marker�_markersr r r" )�selfr: �er r r �__init__ s ��zMarker.__init__c C s t | j�S rL )r> r� �r� r r r �__str__ s zMarker.__str__c C s d| � d�S )Nz <Marker('z')>r r� r r r �__repr__! s zMarker.__repr__�intc C s t | jjt| �f�S rL )�hash� __class__r r" r� r r r �__hash__$ s zMarker.__hash__�otherr rT c C s t |t�stS t| �t|�kS rL )r2 r �NotImplementedr" )r� r� r r r �__eq__' s z Marker.__eq__Nre �dict[str, str] | Nonec C sJ t dt� �}d|d< |dur |�|� |d du r d|d< t| jt|��S )a$ Evaluate a marker. Return the boolean from evaluating the given marker against the environment. environment is an optional argument to override all or part of the determined environment. The environment is determined from the current Python process. rf rU r1 N)r r �updaterm r� �_repair_python_full_version)r� re �current_environmentr r r �evaluate- s �zMarker.evaluate)r: r" r0 r� )r0 r" )r0 r� )r� r r0 rT rL )re r� r0 rT ) r r r r� r� r� r� r� r� r r r r r s r �envc C s" | d � d�r| d d7 < | S )z� Work around platform.python_version() returning something that is not PEP 440 compliant for non-tagged Python builds. r* �+�local)�endswith)r� r r r r� D s r� )r/ r r0 r )T)r: r; r< r= r0 r" )r5 r" r6 r r7 r" r0 rT )r] r" r^ r" r0 r_ )rd r re rf r0 rT )rs rt r0 r" )r0 r! )r� rf r0 rf )4� __future__r �operatorr� r� r �typingr r r r �_parserr r r r r r r� � _tokenizerr � specifiersr r �utilsr �__all__r" rT �Operator� ValueErrorr r r r! r9 r> �lt�le�eq�ne�ge�gtrS r. r\ rc rm r} r r r� r r r r �<module> sH H � � @ _vendor/packaging/__pycache__/_elffile.cpython-310.pyc 0000644 00000006472 15030122015 0016600 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlZddlZddlZddlmZ G dd� de�Z G dd� dej �Z G d d � d ej �Z G d d � d ej �Z G d d� d�ZdS )a; ELF file parser. This provides a class ``ELFFile`` that parses an ELF executable in a similar interface to ``ZipFile``. Only the read interface is implemented. Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html � )� annotationsN)�IOc @ s e Zd ZdS )� ELFInvalidN)�__name__� __module__� __qualname__� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_elffile.pyr s r c @ � e Zd ZdZdZdS )�EIClass� � N)r r r �C32�C64r r r r r � r c @ r )�EIDatar r N)r r r �Lsb�Msbr r r r r r r c @ s e Zd ZdZdZdZdZdZdS )�EMachine� � �( �> � N)r r r �I386�S390�Arm�X8664�AArc64r r r r r ! s r c @ s2 e Zd ZdZddd�Zdd d �Zeddd��ZdS )�ELFFilez. Representation of an ELF executable. �f� IO[bytes]�return�Nonec C s& || _ z| �d�}W n tjy } ztd�|�d }~ww t|d d� �}|dkr0td|����|d | _|d | _zddd d d �| j| jf \}| _| _ W n t yh } ztd | j� d | j� d��|�d }~ww z| �|�\ }| _ }}| _ }| _ }| _| _W d S tjy� } ztd�|�d }~ww )N�16Bz unable to parse identification� s ELFzinvalid magic: � )z <HHIIIIIHHHz <IIIIIIII�r r r% )z >HHIIIIIHHHz >IIIIIIIIr' )z <HHIQQQIHHHz <IIQQQQQQ�r r r& )z >HHIQQQIHHHz >IIQQQQQQr( ))r r )r r )r r )r r zunrecognized capacity (z) or encoding (�)z/unable to parse machine and section information)�_f�_read�struct�errorr �bytes�capacity�encoding�_p_fmt�_p_idx�KeyError�machine�_e_phoff�flags� _e_phentsize�_e_phnum)�selfr �ident�e�magic�e_fmt�_r r r �__init__. s^ �� � � ����� � ��zELFFile.__init__�fmt�str�tuple[int, ...]c C s t �|| j�t �|���S )N)r, �unpackr* �read�calcsize)r9 r@ r r r r+ \ s z ELFFile._read� str | Nonec C s� t | j�D ]H}| j�| j| j| � z| �| j�}W n tj y% Y qw || j d dkr0q| j�|| j d � t � | j� || j d ���d� S dS )zH The path recorded in the ``PT_INTERP`` section header. r r r r � N)�ranger8 r* �seekr5 r7 r+ r1 r, r- r2 �os�fsdecoderD �strip)r9 �index�datar r r � interpreter_ s �&zELFFile.interpreterN)r r! r" r# )r@ rA r" rB )r" rF )r r r �__doc__r? r+ �propertyrO r r r r r ) s .r )rP � __future__r �enumrJ r, �typingr � ValueErrorr �IntEnumr r r r r r r r �<module> s _vendor/packaging/__pycache__/tags.cpython-310.pyc 0000644 00000035545 15030122015 0015774 0 ustar 00 o �hR � @ s� U d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z d dl m Z m Z mZmZmZ ddlmZmZ e�e�Zee Zeeef Zddd d d d �Zd ed< e� d�dkZ G dd� d�Z d^dd�Z d_d`d d �Z dad!d"�Z!dbd%d&�Z"dcd*d+�Z#d_ddd-d.�Z$ dedd/�dfd4d5�Z%dgd6d7�Z& dedd/�dhd:d;�Z'did=d>�Z( dedjd?d@�Z)e fdkdCdD�Z*dldHdI�Z+ dmdndKdL�Z, dmdodNdO�Z-e fdpdPdQ�Z.dqdRdS�Z/dqdTdU�Z0drdVdW�Z1dd/�dsdXdY�Z2dtdZd[�Z3dd/�dud\d]�Z4dS )v� )� annotationsN)�EXTENSION_SUFFIXES)�Iterable�Iterator�Sequence�Tuple�cast� )� _manylinux� _musllinux�py�cp�pp�ip�jy)�python�cpython�pypy� ironpython�jythonzdict[str, str]�INTERPRETER_SHORT_NAMES�P� c @ st e Zd ZdZg d�Zd d d �Zed d d ��Zed d d��Zed dd��Z d dd�Z d!dd�Z d dd�Z d dd �Z d S )"�Tagz� A representation of the tag triple for a wheel. Instances are considered immutable and thus are hashable. Equality checking is also supported. )�_abi�_hash� _interpreter� _platform� interpreter�str�abi�platform�return�Nonec C s8 |� � | _|� � | _|� � | _t| j| j| jf�| _d S �N)�lowerr r r �hashr )�selfr r r! � r( �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/tags.py�__init__4 s z Tag.__init__c C � | j S r$ )r �r' r( r( r) r ? � zTag.interpreterc C r+ r$ )r r, r( r( r) r C r- zTag.abic C r+ r$ )r r, r( r( r) r! G r- z Tag.platform�other�object�boolc C s> t |t�stS | j|jko | j|jko | j|jko | j|jkS r$ )� isinstancer �NotImplementedr r r r )r' r. r( r( r) �__eq__K s � � �z Tag.__eq__�intc C r+ r$ )r r, r( r( r) �__hash__V s z Tag.__hash__c C s | j � d| j� d| j� �S )N�-)r r r r, r( r( r) �__str__Y s z Tag.__str__c C s d| � dt | �� d�S )N�<z @ �>)�idr, r( r( r) �__repr__\ s z Tag.__repr__N)r r r r r! r r" r# �r" r )r. r/ r" r0 )r" r4 )�__name__� __module__� __qualname__�__doc__� __slots__r* �propertyr r r! r3 r5 r7 r; r( r( r( r) r * s r �tagr r" �frozenset[Tag]c C s` t � }| �d�\}}}|�d�D ]}|�d�D ]}|�d�D ] }|�t|||�� q qqt|�S )z� Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. Returning a set is required due to the possibility that the tag is a compressed tag set. r6 �.)�set�split�addr � frozenset)rC �tags� interpreters�abis� platformsr r � platform_r( r( r) � parse_tag` s ��rO F�name�warnr0 �int | str | Nonec C s& t �| �}|d u r|rt�d| � |S )Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)� sysconfig�get_config_var�logger�debug)rP rQ �valuer( r( r) �_get_config_varp s �rX �stringc C s | � dd�� dd�� dd�S )NrE �_r6 � )�replace)rY r( r( r) �_normalize_stringy s r] rL � list[str]c C s: t | �dkrdS t�d| d �}|sdS |�d�}d|v S )z� Determine if the ABI corresponds to a threaded (`--disable-gil`) build. The threaded builds are indicated by a "t" in the abiflags. r Fz cp\d+(.*)r �t)�len�re�match�group)rL �m�abiflagsr( r( r) �_is_threaded_cpython} s rf �python_version� PythonVersion� threadingc C s t | �dkot| �dko| S )z� Determine if the Python version supports abi3. PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) builds do not support abi3. r )� � )r` �tuple)rg ri r( r( r) � _abi3_applies� s rm � py_versionc C s t | �} g }t| d d� �}d } } }}td|�}ttd�} dtv } |s.|d u r0| s.| r0d}| dkr;td|�r;d }| d k retd |�} | sJ| d u rLd }| d k rdtd|�} | dksb| d u rdtjdkrdd}n |rq|�d|� |� �� |�dd|� |� |� |� |� �� |S )Nrk � �Py_DEBUG�gettotalrefcountz_d.pyd�d)rj � �Py_GIL_DISABLEDr_ )rj � � WITH_PYMALLOCrd )rj rj �Py_UNICODE_SIZEr i�� �ur r ) rl �_version_nodotrX �hasattr�sysr � maxunicode�append�insert) rn rQ rL �versionri rV �pymalloc�ucs4� with_debug� has_refcount�has_ext� with_pymalloc� unicode_sizer( r( r) � _cpython_abis� s2 �"r� �rQ �PythonVersion | None�Iterable[str] | NonerM � Iterator[Tag]c # sN � | s t jdd� } dt| dd� �� �� |du r't| �dkr%t| |�}ng }t|�}dD ]}z|�|� W q- ty? Y q-w t|pEt� �}|D ]}|D ] }t � ||�V qMqIt |�}t | |�}|ro� fdd�|D �E dH � fdd�|D �E dH |r�t | d d dd �D ] } |D ]}t| d | f�} d| � �� t � d |�V q�q�dS dS ) a Yields the tags for a CPython interpreter. The tags consist of: - cp<python_version>-<abi>-<platform> - cp<python_version>-abi3-<platform> - cp<python_version>-none-<platform> - cp<less than python_version>-abi3-<platform> # Older Python versions down to 3.2. If python_version only specifies a major version then user-provided ABIs and the 'none' ABItag will be used. If 'abi3' or 'none' are specified in 'abis' then they will be yielded at their normal position and not at the beginning. Nrk r r )�abi3�nonec 3 � � | ] }t � d |�V qdS )r� N�r ��.0rN �r r( r) � <genexpr>� � � z cpython_tags.<locals>.<genexpr>c 3 r� )r� Nr� r� r� r( r) r� � r� ���r r� ) r{ � version_infory r` r� �list�remove� ValueError� platform_tagsr rf rm �range) rg rL rM rQ � explicit_abir rN ri �use_abi3� minor_versionr r( r� r) � cpython_tags� sD � �� ��r� c C s� t ddd�} t| t�r| d dkrtd��| �d�}t|�dk r)ttjdd � �S |d }|� d �r<d |�d �d }n8|� d �rI|�d �d }n+|� d�r[d � |�d �dd � �}n|� d�rmd � |�d �dd� �}n|rr|}ng S t |�gS )z1 Return the ABI tag based on EXT_SUFFIX. � EXT_SUFFIXTr� r rE z.invalid sysconfig.get_config_var('EXT_SUFFIX')rj Nrk r r r r6 r �graalpy) rX r1 r � SystemErrorrG r` r� r{ r� � startswith�joinr] )� ext_suffix�parts�soabir r( r( r) � _generic_abi� s& r� r � str | Nonec c s� � | st � }t|d�}d�||g�} |du rt� }nt|�}t|p#t� �}d|vr.|�d� |D ]}|D ] }t| ||�V q4q0dS )z� Yields the tags for a generic interpreter. The tags consist of: - <interpreter>-<abi>-<platform> The "none" ABI will be added if it was not explicitly provided. r� ro Nr� )�interpreter_name�interpreter_versionr� r� r� r� r} r )r rL rM rQ � interp_name�interp_versionr rN r( r( r) � generic_tags s � ��r� � Iterator[str]c c s| � t | �dkrdt| dd� �� �V d| d � �V t | �dkr:t| d d dd�D ]}dt| d |f�� �V q+dS dS )z� Yields Python versions in descending order. After the latest version, the major-only version will be yielded, and then all previous versions of that major version. r r Nrk r r� )r` ry r� )rn �minorr( r( r) �_py_interpreter_range; s � �r� c c sz � | s t jdd� } t|pt� �}t| �D ]}|D ] }t|d|�V qq|r-t|dd�V t| �D ] }t|dd�V q1dS )z� Yields the sequence of tags that are compatible with a specific version of Python. The tags consist of: - py*-none-<platform> - <interpreter>-none-any # ... if `interpreter` is provided. - py*-none-any Nrk r� �any)r{ r� r� r� r� r )rg r rM r rN r( r( r) �compatible_tagsJ s � � �r� �arch�is_32bitc C s |s| S | � d�r dS dS )N�ppc�i386)r� )r� r� r( r( r) � _mac_archc s r� r � AppleVersion�cpu_archc C s� |g}|dkr| dk r g S |� g d�� n7|dkr'| dk r g S |� g d�� n%|dkr;| dks3| dk r5g S |�d� n|d krL| d krEg S |� d d g� |d v rU|�d� |dv r^|�d� |S )N�x86_64)� r )�intel�fat64�fat32r� )r� r� �fat�ppc64)r� � r� r� )r� � r� r� > �arm64r� � universal2> r� r� r� r� r� � universal)�extendr} )r r� �formatsr( r( r) �_mac_binary_formatsm s, r� �AppleVersion | Nonec c s� � t �� \}}}| du rFtdttt|�d�dd� ���} | dkrEtjt j dddgd d d itj d d �j }tdttt|�d�dd� ���} n| } |du rQt |�}n|}d | kr�| dk r�d}t| d dd�D ] }||f}t||�}|D ]} d|� d|� d| � �V qrqe| dkr�d}t| d dd�D ] }||f}t||�}|D ]} d|� d|� d| � �V q�q�| dkr�d}|dkr�tddd�D ] }||f}t||�}|D ]} d|� d|� d| � �V q�q�dS tddd�D ]}||f}d} d|� d|� d| � �V q�dS dS )aD Yields the platform tags for a macOS system. The `version` parameter is a two-item tuple specifying the macOS version to generate platform tags for. The `arch` parameter is the CPU architecture to generate platform tags for. Both parameters default to the appropriate value for the current system. Nr� rE rk )r� � z-sSz-cz-import platform; print(platform.mac_ver()[0])T�SYSTEM_VERSION_COMPAT�0)�check�env�stdout�text)r� r )� r r� r r� �macosx_rZ r r� r� rj r� )r! �mac_verr rl �mapr4 rG � subprocess�runr{ � executable�PIPEr� r� r� r� ) r r� � version_strrZ r� � major_versionr� �compat_version�binary_formats� binary_formatr( r( r) � mac_platforms� sp � "�� �" � � � ���r� � multiarchc c s� � | du r t �� \}}}}tdttt|�d�dd� ���} |du r&tjj }|� dd�}d}| d d k r6dS |j | d | d |d �V t | d d d d �D ] }|j | d ||d �V qMt | d d d d �D ]}t dd d �D ] }|j |||d �V qmqedS )a� Yields the platform tags for an iOS system. :param version: A two-item tuple specifying the iOS version to generate platform tags for. Defaults to the current iOS version. :param multiarch: The CPU architecture+ABI to generate platform tags for - (the value used by `sys.implementation._multiarch` e.g., `arm64_iphoneos` or `x84_64_iphonesimulator`). Defaults to the current multiarch value. Nr� rE rk r6 rZ z ios_{major}_{minor}_{multiarch}r � r )�majorr� r� r� r� � ) r! �ios_verr rl r� r4 rG r{ �implementation� _multiarchr\ �formatr� )r r� rZ �release�ios_platform_templater� r� r( r( r) � ios_platforms� s0 � " � � ���r� c c s� � t t�� �}|�d�s|V d S | r |dkrd}n|dkr d}|�dd�\}}ddd gi�||g�}t�|�E d H t�|�E d H |D ]}d|� �V qEd S ) N�linux_� linux_x86_64� linux_i686� linux_aarch64� linux_armv8lrZ r �armv8l�armv7l) r] rS � get_platformr� rG �getr r� r )r� �linuxrZ r� �archsr( r( r) �_linux_platforms s" � �r� c c s � t t�� �V d S r$ )r] rS r� r( r( r( r) �_generic_platforms( s �r� c C s< t �� dkr t� S t �� dkrt� S t �� dkrt� S t� S )z; Provides the platform tags for this installation. �Darwin�iOS�Linux)r! �systemr� r� r� r� r( r( r( r) r� , s r� c C s t jj} t�| �p | S )z� Returns the name of the running interpreter. Some implementations have a reserved, two-letter abbreviation which will be returned when appropriate. )r{ r� rP r r� )rP r( r( r) r� : s r� c C s2 t d| d�}|rt|�}|S ttjdd� �}|S )z9 Returns the version of the running interpreter. �py_version_nodotr� Nrk )rX r ry r{ r� )rQ r r( r( r) r� E s �r� c C s d� tt| ��S )Nro )r� r� r )r r( r( r) ry Q s ry c c sl � t � }|dkrt| d�E dH nt� E dH |dkr d}n|dkr*dt| d� }nd}t|d�E dH dS )z� Returns the sequence of tag triples for the running interpreter. The order of the sequence corresponds to priority order for the interpreter, from most to least important. r r� Nr �pp3r� )r� r� r� r� r� )rQ r� �interpr( r( r) �sys_tagsU s � r� )rC r r" rD )F)rP r rQ r0 r" rR )rY r r" r )rL r^ r" r0 )rg rh ri r0 r" r0 )rn rh rQ r0 r" r^ )NNN) rg r� rL r� rM r� rQ r0 r" r� )r" r^ ) r r� rL r� rM r� rQ r0 r" r� )rn rh r" r� )rg r� r r� rM r� r" r� )r� r r� r0 r" r )r r� r� r r" r^ )NN)r r� r� r� r" r� )r r� r� r� r" r� )r� r0 r" r� )r" r� r< )rQ r0 r" r )r rh r" r )rQ r0 r" r� )5� __future__r �loggingr! ra �structr� r{ rS �importlib.machineryr �typingr r r r r ro r r � getLoggerr= rU r4 rh r� r �__annotations__�calcsize�_32_BIT_INTERPRETERr rO rX r] rf rm r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� ry r� r( r( r( r) �<module> sv � 6 "�� ;*�� � ! �P �9 _vendor/packaging/__pycache__/_tokenizer.cpython-310.pyc 0000644 00000013421 15030122015 0017174 0 ustar 00 o �h� � @ s$ U d dl mZ d dlZd dlZd dlmZ d dlmZmZ ddl m Z eG dd� d��Z G d d � d e �Z i d d �d d�dd�dd�dd�dd�de�dej��dd�dd �d d �d d �d!e�d"ej��d#e�e je j ejejB ��d$d%�d&d'�d(d)�d*d+�d,d-d.d/��Zd0ed1< G d2d3� d3�ZdS )4� )� annotationsN)� dataclass)�Iterator�NoReturn� )� Specifierc @ s& e Zd ZU ded< ded< ded< dS )�Token�str�name�text�int�positionN)�__name__� __module__� __qualname__�__annotations__� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_tokenizer.pyr s r c s, e Zd ZdZd � fd d � Zdd d �Z� ZS )�ParserSyntaxErrorz7The provided source text could not be parsed correctly.�messager �source�span�tuple[int, int]�return�Nonec s || _ || _|| _t� �� d S )N)r r r �super�__init__)�selfr r r �� __class__r r r s zParserSyntaxError.__init__c C s> d| j d d| j d | j d d }d�| j| j|g�S )N� r �~r �^z )r �joinr r )r �markerr r r �__str__" s *zParserSyntaxError.__str__)r r r r r r r r )r r )r r r �__doc__r r% � __classcell__r r r r r s r �LEFT_PARENTHESISz\(�RIGHT_PARENTHESISz\)� LEFT_BRACKETz\[� RIGHT_BRACKETz\]� SEMICOLON�;�COMMA�,� QUOTED_STRINGzk ( ('[^']*') | ("[^"]*") ) �OPz(===|==|~=|!=|<=|>=|<|>)�BOOLOPz \b(or|and)\b�INz\bin\b�NOTz\bnot\b�VARIABLEa� \b( python_version |python_full_version |os[._]name |sys[._]platform |platform_(release|system) |platform[._](version|machine|python_implementation) |python_implementation |implementation_(name|version) |extra )\b � SPECIFIER�ATz\@�URLz[^ \t]+� IDENTIFIERz \b[a-zA-Z0-9][a-zA-Z0-9._-]*\b�VERSION_PREFIX_TRAILz\.\*z \+[a-z0-9]+(?:[-_\.][a-z0-9]+)*z[ \t]+�$)�VERSION_LOCAL_LABEL_TRAIL�WS�END� dict[str, str | re.Pattern[str]]� DEFAULT_RULESc @ sj e Zd ZdZd(dd �Zd)d d �Zd d�d*dd�Zd+dd�Zd,dd�Zddd�d-d d!�Z e j d.d&d'��Z dS )/� Tokenizerz�Context-sensitive token parsing. Provides methods to examine the input stream to check whether the next token matches. r r �rulesr? r r c C s* || _ dd� |�� D �| _d | _d| _d S )Nc S s i | ] \}}|t �|��qS r )�re�compile)�.0r �patternr r r � <dictcomp>h s �z&Tokenizer.__init__.<locals>.<dictcomp>r )r �itemsrB � next_tokenr )r r rB r r r r a s � zTokenizer.__init__r c C s | � |�r | �� dS dS )z8Move beyond provided token name, if at current position.N)�check�read)r r r r r �consumen s �zTokenizer.consumeF)�peekrM �boolc C sz | j du sJ d|�d| j ����|| jv s J d|����| j| }|�| j| j�}|du r/dS |s;t||d | j�| _ dS )z�Check whether the next token has the provided name. By default, if the check succeeds, the token *must* be read before another check. If `peek` is set to `True`, the token is not loaded and would need to be checked again. NzCannot check for z, already have zUnknown token name: Fr T)rI rB �matchr r r )r r rM � expressionrO r r r rJ s s � zTokenizer.check�expectedr c C s" | � |�s | �d|� ���| �� S )zsExpect a certain token name next, failing with a syntax error otherwise. The token is *not* read. z Expected )rJ �raise_syntax_errorrK )r r rQ r r r �expect� s zTokenizer.expectc C s0 | j }|dus J �| jt|j�7 _d| _ |S )z%Consume the next token and return it.N)rI r �lenr )r �tokenr r r rK � s zTokenizer.readN)� span_start�span_endr rV � int | NonerW r c C s4 |du r| j n||du r| j n|f}t|| j|d��)z.Raise ParserSyntaxError at the given position.N)r r )r r r )r r rV rW r r r r rR � s ��z Tokenizer.raise_syntax_error� open_token� close_token�around�Iterator[None]c c sh � | � |�r| j}| �� nd }d V |d u rd S | � |�s.| jd|� d|� d|� �|d� | �� d S )NzExpected matching z for z, after )rV )rJ r rK rR )r rY rZ r[ � open_positionr r r �enclosing_tokens� s � � zTokenizer.enclosing_tokens)r r rB r? r r )r r r r )r r rM rN r rN )r r rQ r r r )r r )r r rV rX rW rX r r )rY r rZ r r[ r r r\ ) r r r r& r rL rJ rS rK rR � contextlib�contextmanagerr^ r r r r rA Z s �rA )� __future__r r_ rC � dataclassesr �typingr r � specifiersr r � Exceptionr rD �VERBOSE�_operator_regex_str�_version_regex_str� IGNORECASEr@ r rA r r r r �<module> st ������������ ��% ��)�*�+�,�-�3 _vendor/packaging/__pycache__/version.cpython-310.pyc 0000644 00000035264 15030122015 0016521 0 ustar 00 o �h$A � @ sx d Z ddlmZ ddlZddlZddlmZmZmZm Z m Z m Z ddl m Z mZmZmZ g d�Ze e eef df Ze eee eef f Ze ee e e eef e ee eef f f df f Ze ee edf eeeef Zeeegef ZG d d � d e�Zd/dd�ZG dd� de �Z G dd� d�Z dZ e Z G dd� de �Z!G dd� de!�Z"d0d d �Z#e�$d �Z%d1d#d$�Z&d2d-d.�Z'dS )3zB .. testsetup:: from packaging.version import parse, Version � )� annotationsN)�Any�Callable� NamedTuple� SupportsInt�Tuple�Union� )�Infinity� InfinityType�NegativeInfinity�NegativeInfinityType)�VERSION_PATTERN�InvalidVersion�Version�parse.c @ s> e Zd ZU ded< ded< ded< ded< ded< d ed < d S ) �_Version�int�epoch�tuple[int, ...]�release�tuple[str, int] | None�dev�pre�post�LocalType | None�localN)�__name__� __module__� __qualname__�__annotations__� r! r! �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/version.pyr & s r �version�str�returnr c C s t | �S )z�Parse the given version string. >>> parse('1.0.dev1') <Version('1.0.dev1')> :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. )r )r# r! r! r" r / � r c @ s e Zd ZdZdS )r z�Raised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' N)r r r �__doc__r! r! r! r" r ; s r c @ s\ e Zd ZU ded< ddd�Zdd d �Zdd d �Zddd�Zddd�Zddd�Z ddd�Z dS )� _BaseVersionztuple[Any, ...]�_keyr% r c C s t | j�S �N)�hashr) ��selfr! r! r" �__hash__H s z_BaseVersion.__hash__�other�boolc C s t |t�stS | j|jk S r* �� isinstancer( �NotImplementedr) �r- r/ r! r! r" �__lt__N � z_BaseVersion.__lt__c C s t |t�stS | j|jkS r* r1 r4 r! r! r" �__le__T r6 z_BaseVersion.__le__�objectc C s t |t�stS | j|jkS r* r1 r4 r! r! r" �__eq__Z r6 z_BaseVersion.__eq__c C s t |t�stS | j|jkS r* r1 r4 r! r! r" �__ge__` r6 z_BaseVersion.__ge__c C s t |t�stS | j|jkS r* r1 r4 r! r! r" �__gt__f r6 z_BaseVersion.__gt__c C s t |t�stS | j|jkS r* r1 r4 r! r! r" �__ne__l r6 z_BaseVersion.__ne__N�r% r )r/ r( r% r0 )r/ r8 r% r0 ) r r r r r. r5 r7 r9 r: r; r< r! r! r! r" r( E s r( a� v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version c @ s e Zd ZU dZe�de d ejejB �Z de d< d3d d �Z d4d d �Z d4dd�Z ed5dd��Zed6dd��Zed7dd��Zed8dd��Zed8d d ��Zed9d d ��Zed4d!d"��Zed4d#d$��Zed:d&d'��Zed:d(d)��Zed:d*d+��Zed5d,d-��Zed5d.d/��Zed5d0d1��Z d2S );r a� This class abstracts handling of a project's versions. A :class:`Version` instance is comparison aware and can be compared and sorted using the standard Python interfaces. >>> v1 = Version("1.0a5") >>> v2 = Version("1.0") >>> v1 <Version('1.0a5')> >>> v2 <Version('1.0')> >>> v1 < v2 True >>> v1 == v2 False >>> v1 > v2 False >>> v1 >= v2 False >>> v1 <= v2 True z^\s*z\s*$�CmpKeyr) r# r$ r% �Nonec C s� | j �|�}|std|����t|�d�r t|�d��ndtdd� |�d��d�D ��t|�d�|�d ��t|�d �|�d �pC|�d ��t|�d �|�d��t |�d��d�| _ t | j j | j j | j j| j j| j j| j j�| _dS )aC Initialize a Version object. :param version: The string representation of a version which will be parsed and normalized before use. :raises InvalidVersion: If the ``version`` does not conform to PEP 440 in any way then this exception will be raised. zInvalid version: r r c s � � | ]}t |�V qd S r* )r ��.0�ir! r! r" � <genexpr>� � � z#Version.__init__.<locals>.<genexpr>r �.�pre_l�pre_n�post_l�post_n1�post_n2�dev_l�dev_nr )r r r r r r N)�_regex�searchr r �groupr �tuple�split�_parse_letter_version�_parse_local_version�_version�_cmpkeyr r r r r r r) )r- r# �matchr! r! r" �__init__� s* � � �zVersion.__init__c C s d| � d�S )z�A representation of the Version that shows all internal state. >>> Version('1.0.0') <Version('1.0.0')> z <Version('z')>r! r, r! r! r" �__repr__� s zVersion.__repr__c C s� g }| j dkr|�| j � d�� |�d�dd� | jD ��� | jdur1|�d�dd� | jD ��� | jdur?|�d | j� �� | jdurM|�d | j� �� | jdur[|�d | j� �� d�|�S ) z}A string representation of the version that can be round-tripped. >>> str(Version("1.0a5")) '1.0a5' r �!rF c s r@ r* �r$ �rB �xr! r! r" rD � rE z"Version.__str__.<locals>.<genexpr>N� c s r@ r* r[ r\ r! r! r" rD � rE z.postz.dev�+)r �append�joinr r r r r �r- �partsr! r! r" �__str__� s zVersion.__str__r c C � | j jS )zThe epoch of the version. >>> Version("2.0.0").epoch 0 >>> Version("1!2.0.0").epoch 1 )rU r r, r! r! r" r r& z Version.epochr c C re )ad The components of the "release" segment of the version. >>> Version("1.2.3").release (1, 2, 3) >>> Version("2.0.0").release (2, 0, 0) >>> Version("1!2.0.0.post0").release (2, 0, 0) Includes trailing zeroes but not the epoch or any pre-release / development / post-release suffixes. )rU r r, r! r! r" r s zVersion.releaser c C re )a The pre-release segment of the version. >>> print(Version("1.2.3").pre) None >>> Version("1.2.3a1").pre ('a', 1) >>> Version("1.2.3b1").pre ('b', 1) >>> Version("1.2.3rc1").pre ('rc', 1) )rU r r, r! r! r" r & s z Version.pre� int | Nonec C � | j jr | j jd S dS )z�The post-release number of the version. >>> print(Version("1.2.3").post) None >>> Version("1.2.3.post1").post 1 r N)rU r r, r! r! r" r 5 � z Version.postc C rg )z�The development number of the version. >>> print(Version("1.2.3").dev) None >>> Version("1.2.3.dev1").dev 1 r N)rU r r, r! r! r" r @ rh z Version.dev� str | Nonec C s$ | j jrd�dd� | j jD ��S dS )z�The local version segment of the version. >>> print(Version("1.2.3").local) None >>> Version("1.2.3+abc").local 'abc' rF c s r@ r* r[ r\ r! r! r" rD U rE z Version.local.<locals>.<genexpr>N)rU r ra r, r! r! r" r K s z Version.localc C s t | ��dd�d S )z�The public portion of the version. >>> Version("1.2.3").public '1.2.3' >>> Version("1.2.3+abc").public '1.2.3' >>> Version("1!1.2.3dev1+abc").public '1!1.2.3.dev1' r_ r r )r$ rR r, r! r! r" �publicY s zVersion.publicc C sF g }| j dkr|�| j � d�� |�d�dd� | jD ��� d�|�S )a\ The "base version" of the version. >>> Version("1.2.3").base_version '1.2.3' >>> Version("1.2.3+abc").base_version '1.2.3' >>> Version("1!1.2.3dev1+abc").base_version '1!1.2.3' The "base version" is the public version of the project without any pre or post release markers. r rZ rF c s r@ r* r[ r\ r! r! r" rD { rE z'Version.base_version.<locals>.<genexpr>r^ )r r` ra r rb r! r! r" � base_versionf s zVersion.base_versionr0 c C s | j dup | jduS )aT Whether this version is a pre-release. >>> Version("1.2.3").is_prerelease False >>> Version("1.2.3a1").is_prerelease True >>> Version("1.2.3b1").is_prerelease True >>> Version("1.2.3rc1").is_prerelease True >>> Version("1.2.3dev1").is_prerelease True N)r r r, r! r! r" � is_prerelease s zVersion.is_prereleasec C � | j duS )z�Whether this version is a post-release. >>> Version("1.2.3").is_postrelease False >>> Version("1.2.3.post1").is_postrelease True N)r r, r! r! r" �is_postrelease� � zVersion.is_postreleasec C rm )z�Whether this version is a development release. >>> Version("1.2.3").is_devrelease False >>> Version("1.2.3.dev1").is_devrelease True N)r r, r! r! r" � is_devrelease� ro zVersion.is_devreleasec C s t | j�dkr | jd S dS )zqThe first item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").major 1 r r ��lenr r, r! r! r" �major� s z Version.majorc C � t | j�dkr | jd S dS )z�The second item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").minor 2 >>> Version("1").minor 0 � r r rq r, r! r! r" �minor� � z Version.minorc C rt )z�The third item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").micro 3 >>> Version("1").micro 0 � ru r rq r, r! r! r" �micro� rw z Version.microN)r# r$ r% r? )r% r$ r= �r% r )r% r )r% rf )r% ri )r% r0 ) r r r r' �re�compiler �VERBOSE� IGNORECASErN r rX rY rd �propertyr r r r r r rj rk rl rn rp rs rv ry r! r! r! r" r � sF & ! c s" e Zd Zed� fdd� �Z� ZS )�_TrimmedReleaser% r c s6 t � j}dd� t|�D �}t|dd�}|d|d � S )z� Release segment without any trailing zeros. >>> _TrimmedRelease('1.0.0').release (1,) >>> _TrimmedRelease('0.0').release (0,) c s s � | ] \}}|r|V qd S r* r! )rB �index�valr! r! r" rD � s � z*_TrimmedRelease.release.<locals>.<genexpr>r )�defaultNr )�superr � enumerate�max)r- �rel�nonzeros� last_nonzero�� __class__r! r" r � s z_TrimmedRelease.releaserz )r r r r r � __classcell__r! r! r� r" r� � s r� �letterri �number� str | bytes | SupportsInt | Noner c C sz | r-|d u rd}| � � } | dkrd} n| dkrd} n | dv r!d} n| dv r'd } | t|�fS | r1J �|r;d } | t|�fS d S ) Nr �alpha�a�beta�b)�cr �preview�rc)�rev�rr )�lowerr )r� r� r! r! r" rS � s$ rS z[\._-]r r c C s$ | durt dd� t�| �D ��S dS )zR Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve"). Nc s s( � | ]}|� � s |�� nt|�V qd S r* )�isdigitr� r )rB �partr! r! r" rD s � � �z'_parse_local_version.<locals>.<genexpr>)rQ �_local_version_separatorsrR )r r! r! r" rT � s �rT r r r r r r r r> c C s� t ttt�dd� t|�����}|d u r |d u r |d ur t}n |d u r&t}n|}|d u r/t}n|}|d u r8t} n|} |d u rAt} n t dd� |D ��} | |||| | fS )Nc S s | dkS )Nr r! )r] r! r! r" �<lambda> s z_cmpkey.<locals>.<lambda>c s s* � | ]}t |t�r |d fnt|fV qdS )r^ N)r2 r r rA r! r! r" rD B s � �z_cmpkey.<locals>.<genexpr>)rQ �reversed�list� itertools� dropwhiler r ) r r r r r r �_release�_pre�_post�_dev�_localr! r! r" rV s( � �rV )r# r$ r% r )r� ri r� r� r% r )r ri r% r )r r r r r r r r r r r r r% r> )(r' � __future__r r� r{ �typingr r r r r r � _structuresr r r r �__all__r r$ � LocalType�CmpPrePostDevType� CmpLocalTyper> r0 �VersionComparisonMethodr r � ValueErrorr r( �_VERSION_PATTERNr r r� rS r| r� rT rV r! r! r! r" �<module> sN *�� �� 0 ' % _vendor/packaging/__pycache__/__init__.cpython-310.pyc 0000644 00000000777 15030122015 0016574 0 ustar 00 o �h� � @ s* d Z dZdZdZdZdZdZde� �ZdS ) � packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz24.2z)Donald Stufft and individual contributorszdonald@stufft.iozBSD-2-Clause or Apache-2.0z2014 N)� __title__� __summary__�__uri__� __version__� __author__� __email__� __license__� __copyright__� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/__init__.py�<module> s _vendor/packaging/__pycache__/_musllinux.cpython-310.pyc 0000644 00000006553 15030122015 0017232 0 ustar 00 o �h� � @ s d Z ddlmZ ddlZddlZddlZddlZddlmZm Z m Z ddl m Z G dd� de �Z d$d d�Zejd%dd��Zd&dd�Zedkr�ddlZe�� Ze�d�sWJ d��ede� edeej�� ed d d � ee�d d e�d!d�d" ��D ] Zeed#d � qydS dS )'z�PEP 656 support. This module implements logic to detect if the currently running Python is linked against musl, and what musl version is used. � )� annotationsN)�Iterator� NamedTuple�Sequence� )�ELFFilec @ s e Zd ZU ded< ded< dS )� _MuslVersion�int�major�minorN)�__name__� __module__� __qualname__�__annotations__� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_musllinux.pyr s r �output�str�return�_MuslVersion | Nonec C sx dd� dd� | � � D �D �}t|�dk s |d d d� dkr d S t�d |d �}|s,d S tt|�d ��t|�d��d �S ) Nc S s g | ]}|r|�qS r r ��.0�nr r r � <listcomp> s z'_parse_musl_version.<locals>.<listcomp>c s s � | ]}|� � V qd S )N)�stripr r r r � <genexpr> s � z&_parse_musl_version.<locals>.<genexpr>� r � �muslzVersion (\d+)\.(\d+)r )r r )� splitlines�len�re�matchr r �group)r �lines�mr r r �_parse_musl_version s r& � executablec C s� z t | d�� }t|�j}W d � n1 sw Y W n tttfy) Y dS w |du s2d|vr4dS tj|gtjdd�}t |j �S )a` Detect currently-running musl runtime version. This is done by checking the specified executable's dynamic linking information, and invoking the loader to parse its output for a version string. If the loader is musl, the output would be something like:: musl libc (x86_64) Version 1.2.2 Dynamic Program Loader �rbNr T)�stderr�text) �openr � interpreter�OSError� TypeError� ValueError� subprocess�run�PIPEr& r) )r' �f�ld�procr r r �_get_musl_version! s ��� r6 �archs� Sequence[str]� Iterator[str]c c sT � t tj�}|du r dS | D ]}t|jdd�D ]}d|j� d|� d|� �V qqdS )a� Generate musllinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be musllinux-compatible. :returns: An iterator of compatible musllinux tags. N���� musllinux_�_)r6 �sysr' �ranger r )r7 �sys_musl�archr r r r � platform_tags8 s � ��rA �__main__zlinux-z not linuxzplat:zmusl:ztags:� )�endz[.-]r< �-r: z )r r r r )r' r r r )r7 r8 r r9 ) �__doc__� __future__r � functoolsr! r0 r= �typingr r r �_elffiler r r& � lru_cacher6 rA r � sysconfig� get_platform�plat� startswith�printr' �sub�split�tr r r r �<module> s0 "� _vendor/packaging/__pycache__/metadata.cpython-310.pyc 0000644 00000044460 15030122015 0016612 0 ustar 00 o �hʇ � @ s d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl m Z m Z m Z mZmZmZ ddlmZmZmZmZ ddlmZ ddlmZ e �d�Ze jd kr[e Z nG d d � d e �Z G d d � d e �Z G dd� dedd�Z h d�Z!h d�Z"dhZ#dVdd�Z$dWd d �Z%dXd"d#�Z&i d$d$�d%d&�d'd(�d)d)�d*d+�d,d-�d.d.�d/d0�d1d1�d2d2�d3d4�d5d6�d7d7�d8d9�d:d;�d<d<�d=d=�d>d?dd@dAdBdCdDdEdFdGdHdIdJ� �Z'dKdL� e'�(� D �Z)dYdNdO�Z*e+� Z,g dP�Z-edP Z.e/g dQ��Z0G dRdS� dSe e �Z1G dTdU� dU�Z2dS )Z� )� annotationsN)�Any�Callable�Generic�Literal� TypedDict�cast� )�licenses� requirements� specifiers�utils)�version)�NormalizedLicenseExpression�T)� � c @ s6 e Zd ZU dZded< ded< d dd �Zdd d �Zd S )�ExceptionGroupz�A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11. If :external:exc:`ExceptionGroup` is already defined by Python itself, that version is used instead. �str�message�list[Exception]� exceptions�return�Nonec C s || _ || _d S �N)r r )�selfr r � r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/metadata.py�__init__) s zExceptionGroup.__init__c C s | j j� d| j�d| j�d�S )N�(z, �))� __class__�__name__r r )r r r r �__repr__- s zExceptionGroup.__repr__N)r r r r r r )r r )r" � __module__� __qualname__�__doc__�__annotations__r r# r r r r r s r c s. e Zd ZU dZded< d � fdd� Z� ZS ) �InvalidMetadataz'A metadata field contains invalid data.r �fieldr r r c s || _ t� �|� d S r )r) �superr )r r) r �r! r r r 7 s zInvalidMetadata.__init__)r) r r r r r )r" r$ r% r& r' r � __classcell__r r r+ r r( 1 s r( c @ s e Zd ZU dZded< ded< ded< ded< ded< ded < ded < ded < ded < ded < ded< ded< ded< ded< ded< ded< ded< ded< ded< ded< ded< ded< ded< ded< d ed < ded < ded < ded < ded!< ded"< d#S )$� RawMetadataa� A dictionary of raw core metadata. Each field in core metadata maps to a key of this dictionary (when data is provided). The key is lower-case and underscores are used instead of dashes compared to the equivalent core metadata field. Any core metadata field that can be specified multiple times or can hold multiple values in a single field have a key with a plural name. See :class:`Metadata` whose attributes match the keys of this dictionary. Core metadata fields that can be specified multiple times are stored as a list or dict depending on which is appropriate for the field. Any fields which hold multiple values in a single field are stored as a list. r �metadata_version�namer � list[str]� platforms�summary� description�keywords� home_page�author� author_email�license�supported_platforms� download_url� classifiers�requires�provides� obsoletes� maintainer�maintainer_email� requires_dist� provides_dist�obsoletes_dist�requires_python�requires_external�dict[str, str]� project_urls�description_content_type�provides_extra�dynamic�license_expression� license_filesN)r" r$ r% r& r' r r r r r- @ s@ r- F)�total> r/ r6 r8 r2 r r5 r? r3 r7 r: rD r@ r. rK rH > rJ r= r< r> r1 r; rL rB rA rC rI rE r9 rG �datar r r0 c C s dd� | � d�D �S )zCSplit a string of comma-separated keywords into a list of keywords.c S � g | ]}|� � �qS r ��strip)�.0�kr r r � <listcomp>� � z#_parse_keywords.<locals>.<listcomp>�,)�split)rN r r r �_parse_keywords� s rX rF c C sf i }| D ],}dd� |� dd�D �}|�dgtddt|� � � |\}}||v r,td��|||< q|S ) z?Parse a list of label/URL string pairings separated by a comma.c S rO r rP )rR �pr r r rT � rU z'_parse_project_urls.<locals>.<listcomp>rV r � r � z duplicate labels in project urls)rW �extend�max�len�KeyError)rN �urls�pair�parts�label�urlr r r �_parse_project_urls� s re �msg�email.message.Message�source� bytes | strc C sp t |t�r| �� }t |t�sJ �|S | jdd�}t |t�s J �z|�dd�W S ty7 } ztd�|�d}~ww )z Get the body of the message.T��decode�utf8�strictz payload in an invalid encodingN)� isinstancer � get_payload�bytesrk �UnicodeDecodeError� ValueError)rf rh �payload�bpayload�excr r r � _get_payload� s ��rv r6 z author-emailr7 � classifierr; r3 zdescription-content-typerH z download-urlr: rJ z home-pager5 r4 r8 zlicense-expressionrK z license-filerL r? zmaintainer-emailr@ �metadata-versionr. r/ r> rC r1 r= rB rI r< rA rE rD r2 r9 r ) zobsoletes-dist�platformz project-urlr= z provides-distzprovides-extrar< z requires-distzrequires-externalzrequires-pythonr2 zsupported-platformr c C s i | ]\}}||�qS r r )rR �email�rawr r r � <dictcomp> s r| �(tuple[RawMetadata, dict[str, list[str]]]c C s� i }i }t | t�rtjjtjjd��| �}n tjjtjjd�� | �}t |� � �D ]�}|� � }|� |�p4g }g }d}|D ]Q}t |tjjtf�sHJ �t |tjj�r�g } tj�|�D ]#\} } z| �dd� W n typ d} d}Y nw d} | �| | f� qW|�ttj�| ��� q;|�|� q;|s�|||< q(t�|�} | du r�|||< q(| tv r�t|�dkr�|d || < q(| tv r�||| < q(| d kr�t|�dkr�t|d �|| < q(| d kr�zt|�|| < W q( t y� |||< Y q(w |||< q(zt || �} W n t �y |� d g ��|j t | t!�d �� Y n.w | �r=d |v �r,t"t|�#d ��}|� d g ��$|| g� nd |v �r9|d �| � n| |d < t"t%|�|fS )a Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``). This function returns a two-item tuple of dicts. The first dict is of recognized fields from the core metadata specification. Fields that can be parsed and translated into Python's built-in types are converted appropriately. All other fields are left as-is. Fields that are allowed to appear multiple times are stored as lists. The second dict contains all other fields from the metadata. This includes any unrecognized fields. It also includes any fields which are expected to be parsed into a built-in type but were not formatted appropriately. Finally, any fields that are expected to appear only once but are repeated are included in this dict. )�policyTrl rm �latin1FNr r r4 rG r3 rj )&rn r rz �parser�Parserr~ �compat32�parsestr� BytesParser� parsebytes� frozenset�keys�lower�get_all�header�Header� decode_headerrk rq �append� make_header�_EMAIL_TO_RAW_MAPPING�get�_STRING_FIELDSr^ � _LIST_FIELDSrX re r_ rv rr � setdefaultro rp r �popr\ r- )rN r{ �unparsed�parsedr/ �headers�value�valid_encoding�h�chunks�bin�encoding�raw_namers �description_headerr r r � parse_email s| � � �� � r� )�1.0�1.1�1.2�2.1�2.2z2.3�2.4)r. r/ r c @ s� e Zd ZU dZded< ded< ded< dd�d:d d �Zd;dd�Zd<dd�Z d=d>dd �Zd?d d �Z d@d d!�Z dAd#d$�Z d@d%d&�Z d@d'd(�Z dBd*d+�ZdCd-d.�ZdDd0d1�ZdEd3d4�ZdFd6d7�ZdBd8d9�ZdS )G� _Validatorav Validate a metadata field. All _process_*() methods correspond to a core metadata field. The method is called with the field's raw value. If the raw value is valid it is returned in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field). If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause as appropriate). r r/ r� �_MetadataVersion�addedr� �r� r r c C s || _ d S r r� )r r� r r r r � s z_Validator.__init__�_owner�Metadatac C s || _ t| | _d S r )r/ �_RAW_TO_EMAIL_MAPPINGr� )r r� r/ r r r � __set_name__� s z_Validator.__set_name__�instance�type[Metadata]r c C s� |j }|j�| j�}| jtv s|d ur,z t| d| j� ��}W n ty' Y nw ||�}||| j< z|j| j= W n tyA Y nw tt |�S )N� _process_) �__dict__�_rawr� r/ �_REQUIRED_ATTRS�getattr�AttributeErrorr_ r r )r r� r� �cacher� � converterr r r �__get__� s � � z_Validator.__get__Nrf �cause�Exception | Noner( c C s& t | j|�dt| j�i��}||_|S )Nr) )r( r� � format_map�repr� __cause__)r rf r� ru r r r �_invalid_metadata s �z _Validator._invalid_metadatar� c C s" |t vr | �|�d���tt|�S )Nz is not a valid metadata version)�_VALID_METADATA_VERSIONSr� r r� �r r� r r r �_process_metadata_version s z$_Validator._process_metadata_versionc C sT |s| � d��z tj|dd� W |S tjy) } z | j |�d�|d�|�d }~ww )N�{field} is a required fieldT��validate� is invalid for {field}�r� )r� r �canonicalize_name� InvalidName�r r� ru r r r � _process_name s � ����z_Validator._process_name�version_module.Versionc C sL |s| � d��zt�|�W S tjy% } z | j |�d�|d�|�d }~ww )Nr� r� r� )r� �version_module�parse�InvalidVersionr� r r r �_process_version( s ����z_Validator._process_versionc C s d|v r | � d��|S )z%Check the field contains no newlines.� z {field} must be a single line)r� r� r r r �_process_summary2 s z_Validator._process_summaryc C s� h d�}t j�� }||d< |�� �� |d j}}||vs#||�� vr0| �dt|�� d|����|�dd�}|dkrD| �dt|�� ���dd h}|�d d�}|d krc||vrc| �d t|�� d|����|S ) N> � text/plain� text/x-rst� text/markdownz content-typez{field} must be one of �, not �charsetzUTF-8z0{field} can only specify the UTF-8 charset, not �GFM� CommonMark�variantr� z(valid Markdown variants for {field} are ) rz r � EmailMessage�get_content_typer� �paramsr� �listr� ) r r� � content_typesr � content_type� parametersr� �markdown_variantsr� r r r �!_process_description_content_type8 s0 �� � ��z,_Validator._process_description_content_typer0 c C sR t tj|�D ]}|dv r| �|�d���|tvr | �|�d���qtt tj|��S )N> r/ r rx z" is not allowed as a dynamic fieldz is not a valid dynamic field)�mapr r� r� r� r� )r r� � dynamic_fieldr r r �_process_dynamicX s ���z_Validator._process_dynamic�list[utils.NormalizedName]c C sZ g }z|D ] }|� tj|dd�� qW |S tjy, } z | j|�d�|d�|�d }~ww )NTr� r� r� )r� r r� r� r� )r r� �normalized_namesr/ ru r r r �_process_provides_extrad s �� ����z"_Validator._process_provides_extra�specifiers.SpecifierSetc C s> zt �|�W S t jy } z | j|�d�|d�|�d }~ww �Nr� r� )r � SpecifierSet�InvalidSpecifierr� r� r r r �_process_requires_pythons s ����z#_Validator._process_requires_python� list[requirements.Requirement]c C sV g }z|D ] }|� t�|�� qW |S tjy* } z | j|�d�|d�|�d }~ww r� )r� r � Requirement�InvalidRequirementr� )r r� �reqs�reqru r r r �_process_requires_dist{ s �� ����z!_Validator._process_requires_dist�"NormalizedLicenseExpression | Nonec C s< zt �|�W S ty } z | j|�d�|d�|�d }~ww r� )r � canonicalize_license_expressionrr r� r� r r r �_process_license_expression� s ����z&_Validator._process_license_expressionc C s� g }|D ]F}d|v r| � |�d���d|v r | � |�d���t�|��� s,t�|��� r4| � |�d���t�|��� |krE| � |�d���|�|� q|S )Nz..zD is invalid for {field}, parent directory indicators are not allowed�*z/ is invalid for {field}, paths must be resolvedz/ is invalid for {field}, paths must be relativez5 is invalid for {field}, paths must use '/' delimiter)r� �pathlib� PurePosixPath� is_absolute�PureWindowsPath�as_posixr� )r r� �paths�pathr r r �_process_license_files� s. �� � ��� z!_Validator._process_license_files)r� r� r r )r� r� r/ r r r )r� r� r� r� r r r )rf r r� r� r r( )r� r r r� )r� r r r )r� r r r� )r� r0 r r0 )r� r0 r r� )r� r r r� )r� r0 r r� )r� r r r� )r" r$ r% r& r' r r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r� � s, � � r� c @ sl e Zd ZU dZded< edd�d>d d ��Zedd�d?d d��Ze� Z ded< e� Z ded< e� Z ded< edd�Z ded< e� Z ded< edd�Zded< e� Zd ed < e� Zd ed < ed d�Zd ed < e� Zded!< e� Zd ed"< edd�Zd ed#< e� Zd ed$< e� Zd ed%< ed&d�Zd ed'< ed&d�Zd ed(< e� Zd ed)< ed*d�Zd+ed,< ed*d�Zded-< edd�Z ded.< ed&d�Z d/ed0< ed&d�Z d1ed2< ed&d�Z ded3< ed&d�Z d4ed5< ed d�Z!d6ed7< ed&d�Z"ded8< ed&d�Z#ded9< edd�Z$ded:< edd�Z%ded;< edd�Z&ded<< d=S )@r� aJ Representation of distribution metadata. Compared to :class:`RawMetadata`, this class provides objects representing metadata fields instead of only using built-in types. Any invalid metadata will cause :exc:`InvalidMetadata` to be raised (with a :py:attr:`~BaseException.__cause__` attribute as appropriate). r- r� Tr� rN r� �boolr c C sV | � }|� � |_|r�g }z |j}t�|�}W n ty/ } z |�|� d}W Y d}~nd}~ww t|j�tB }|dh8 }|D ]c} zJ|r�z| j | j } W n t yb t| d| ���} |�| � Y W q>w t�| �} | |kr�t | } t| | � d| � d|� ��} |�| � W q>t || � W q> ty� } z |�| � W Y d} ~ q>d} ~ ww |r�td|��|S )z�Create an instance from :class:`RawMetadata`. If *validate* is true, all metadata will be validated. All exceptions related to validation will be gathered and raised as an :class:`ExceptionGroup`. Nr. �unrecognized field: z introduced in metadata version r� zinvalid metadata)�copyr� r. r� �indexr( r� r� r� r� r� r_ r� r� r )�clsrN r� �insr r. � metadata_age�metadata_version_exc�fields_to_check�key�field_metadata_versionru � field_ager) r r r �from_raw� s^ �� ����� �� zMetadata.from_rawri c C s� t |�\}}|r-g }|D ]}|tv r|�d�}nd|��}|�t||�� q |r-td|��z| j||d�W S tyH } ztd|j�d�d}~ww )z�Parse metadata from email headers. If *validate* is true, the metadata will be validated. All exceptions related to validation will be gathered and raised as an :class:`ExceptionGroup`. z has invalid datar r� r� z invalid or unparsed metadataN)r� r� r� r( r r r ) r rN r� r{ r� r � unparsed_keyr � exc_groupr r r � from_email� s( ����zMetadata.from_emailz _Validator[_MetadataVersion]r. z_Validator[str]r/ z"_Validator[version_module.Version]r r� r� z _Validator[list[str] | None]rJ r1 r� r9 z_Validator[str | None]r2 r3 r� rH r4 r5 r: r6 r7 r� r? r@ r8 r� z._Validator[NormalizedLicenseExpression | None]rK rL r; z1_Validator[list[requirements.Requirement] | None]rA z*_Validator[specifiers.SpecifierSet | None]rD rE z!_Validator[dict[str, str] | None]rG z-_Validator[list[utils.NormalizedName] | None]rI rB rC r< r= r> N)rN r- r� r r r� )rN ri r� r r r� )'r" r$ r% r& r' � classmethodr r r� r. r/ r rJ r1 r9 r2 r3 rH r4 r5 r: r6 r7 r? r@ r8 rK rL r; rA rD rE rG rI rB rC r< r= r> r r r r r� � s� 8�����r� )rN r r r0 )rN r0 r rF )rf rg rh ri r r )rN ri r r} )3� __future__r �email.feedparserrz � email.header� email.message� email.parser� email.policyr� �sys�typingr r r r r r rZ r r r r r r� r �TypeVarr � version_infor � Exceptionrr r( r- r� r� � _DICT_FIELDSrX re rv r� �itemsr� r� �object� _NOT_FOUNDr� r� r� r� r� r� r r r r �<module> s� H� ( �������� � � � � ������ 1 Y _vendor/packaging/__pycache__/requirements.cpython-310.pyc 0000644 00000005531 15030122015 0017551 0 ustar 00 o �h� � @ s~ d dl mZ d dlmZmZ ddlmZ ddlm Z ddl m Z m Z ddl mZ ddlmZ G d d � d e�ZG d d � d �Zd S )� )� annotations)�Any�Iterator� )�parse_requirement)�ParserSyntaxError)�Marker�_normalize_extra_values)� SpecifierSet)�canonicalize_namec @ s e Zd ZdZdS )�InvalidRequirementzJ An invalid requirement was found, users should refer to PEP 508. N)�__name__� __module__� __qualname__�__doc__� r r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/requirements.pyr s r c @ sL e Zd ZdZddd�Zdd d �Zdd d �Zddd�Zd dd�Zd dd�Z dS ) � Requirementz�Parse a requirement. Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. �requirement_string�str�return�Nonec C s� zt |�}W n ty } ztt|��|�d }~ww |j| _|jp"d | _t|jp)g �| _t|j �| _ d | _ |j d urIt � t �| _ t |j �| j _d S d S �N)�_parse_requirementr r r �name�url�set�extrasr � specifier�markerr �__new__r �_markers)�selfr �parsed�er r r �__init__" s �� �zRequirement.__init__r � Iterator[str]c c sz � |V | j rd�t| j ��}d|� d�V | jr t| j�V | jr/d| j� �V | jr/dV | jr;d| j� �V d S d S )N�,�[�]z@ � z; )r �join�sortedr r r r )r" r �formatted_extrasr r r � _iter_parts1 s � �zRequirement._iter_partsc C s d� | �| j��S )N� )r+ r. r �r" r r r �__str__C s zRequirement.__str__c C s d| � d�S )Nz<Requirement('z')>r r0 r r r �__repr__F s zRequirement.__repr__�intc C s t | jjg| �t| j���R �S r )�hash� __class__r r. r r r0 r r r �__hash__I s ���zRequirement.__hash__�otherr �boolc C sR t |t�stS t| j�t|j�ko(| j|jko(| j|jko(| j|jko(| j|jkS r ) � isinstancer �NotImplementedr r r r r r )r" r7 r r r �__eq__Q s � � � �zRequirement.__eq__N)r r r r )r r r r& )r r )r r3 )r7 r r r8 ) r r r r r% r. r1 r2 r6 r; r r r r r s r N)� __future__r �typingr r �_parserr r � _tokenizerr �markersr r � specifiersr �utilsr � ValueErrorr r r r r r �<module> s _vendor/packaging/__pycache__/utils.cpython-310.pyc 0000644 00000011037 15030122015 0016164 0 ustar 00 o �h� � @ s4 d dl mZ d dlZd dlZd dlmZmZmZmZ ddl m Z m Z ddl m Z mZmZ eed eeef f Zede�ZG d d � d e�ZG d d � d e�ZG d d� de�Ze�dej�Ze�d�Ze�d�Z e�d�Z dd�d.dd�Z d/d d �Z ej d d �d0d#d$��Z!e!j"d d �d1d%d&��Z#d2d)d*�Z$d3d,d-�Z%dS )4� )� annotationsN)�NewType�Tuple�Union�cast� )�Tag� parse_tag)�InvalidVersion�Version�_TrimmedRelease� �NormalizedNamec @ � e Zd ZdZdS )� InvalidNamezW An invalid distribution name; users should refer to the packaging user guide. N��__name__� __module__� __qualname__�__doc__r r r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/utils.pyr � r c @ r )�InvalidWheelFilenamezM An invalid wheel filename was found, users should refer to PEP 427. Nr r r r r r r r c @ r )�InvalidSdistFilenamez^ An invalid sdist filename was found, users should refer to the packaging user guide. Nr r r r r r r r z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$z[-_.]+z/^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$z (\d+)(.*)F)�validate�name�strr �bool�returnc C s6 |rt �| �std| ����t�d| ��� }tt|�S )Nzname is invalid: �-)�_validate_regex�matchr �_canonicalize_regex�sub�lowerr r )r r �valuer r r �canonicalize_name. s r& c C s t �| �d uS )N)�_normalized_regexr! )r r r r �is_normalized_name6 s r( T��strip_trailing_zero�version� Version | strr* c C s t |r tt | ���S | �S )a� Return a canonical form of a version as a string. >>> canonicalize_version('1.0.1') '1.0.1' Per PEP 625, versions may have multiple canonical forms, differing only by trailing zeros. >>> canonicalize_version('1.0.0') '1' >>> canonicalize_version('1.0.0', strip_trailing_zero=False) '1.0.0' Invalid versions are returned unaltered. >>> canonicalize_version('foo bar baz') 'foo bar baz' )r r )r+ r* r r r �canonicalize_version: s r- c C s0 zt | �}W n ty | Y S w t||d�S )Nr) )r r r- )r+ r* �parsedr r r �_T s � r/ �filename�8tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]c C s: | � d�s td| ����| d d� } | �d�}|dvr"td| ����| �d|d �}|d }d |v s<t�d |tj�d u rCtd | ����t|�}zt|d �}W n t yc } ztd | ���|�d }~ww |dkr�|d }t �|�}|d u rtd|� d| ����t t t |�d ��|�d�f�} nd} t|d �} ||| | fS )Nz.whlz3Invalid wheel filename (extension must be '.whl'): ���r )� � z0Invalid wheel filename (wrong number of parts): � r �__z ^[\w\d._]*$zInvalid project name: r z*Invalid wheel filename (invalid version): r4 zInvalid build number: z in r ���)�endswithr �count�split�rer! �UNICODEr& r r �_build_tag_regexr �BuildTag�int�groupr ) r0 �dashes�parts� name_partr r+ �e� build_part� build_match�build�tagsr r r �parse_wheel_filename^ sH � � ���� � rI � tuple[NormalizedName, Version]c C s� | � d�r| d td� � }n| � d�r | d td� � }ntd| ����|�d�\}}}|s6td| ����t|�}z t|�}W ||fS tyW } ztd| ���|�d }~ww )Nz.tar.gzz.zipz@Invalid sdist filename (extension must be '.tar.gz' or '.zip'): r zInvalid sdist filename: z*Invalid sdist filename (invalid version): )r8 �lenr � rpartitionr& r r )r0 � file_stemrC �sep� version_partr r+ rD r r r �parse_sdist_filename� s0 �� �����rP )r r r r r r )r r r r )r+ r, r* r r r )r+ r r* r r r )r0 r r r1 )r0 r r rJ )&� __future__r � functoolsr; �typingr r r r rH r r r+ r r r r? r r> r � ValueErrorr r r �compile� IGNORECASEr r" r' r= r& r( �singledispatchr- �registerr/ rI rP r r r r �<module> s4 � � + _vendor/packaging/__pycache__/specifiers.cpython-310.pyc 0000644 00000075223 15030122015 0017167 0 ustar 00 o �h�� � @ s d Z ddlmZ ddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZ e eef Ze ded �Zeeegef Zd*dd�ZG dd� de�ZG dd� dejd�ZG dd� de�Ze�d�Z d+dd�Z d,d d �Z d-d!d"�Z d.d&d'�Z G d(d)� d)e�Z!dS )/z� .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version � )� annotationsN)�Callable�Iterable�Iterator�TypeVar�Union� )�canonicalize_version)�Version�UnparsedVersionVar)�bound�version�UnparsedVersion�returnr c C s t | t�s t| �} | S �N)� isinstancer )r � r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/specifiers.py�_coerce_version s r c @ s e Zd ZdZdS )�InvalidSpecifiera Raised when attempting to create a :class:`Specifier` with a specifier string that is invalid. >>> Specifier("lolwat") Traceback (most recent call last): ... packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' N)�__name__� __module__� __qualname__�__doc__r r r r r s r c @ s� e Zd Zejd dd��Zejd dd��Zejd d d ��Zeejd dd���Z e j d!dd��Z ejd"d#dd��Z ej d"d$dd ��Z dS )%� BaseSpecifierr �strc C � dS )z� Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. Nr ��selfr r r �__str__- � zBaseSpecifier.__str__�intc C r )zF Returns a hash value for this Specifier-like object. Nr r r r r �__hash__4 r zBaseSpecifier.__hash__�other�object�boolc C r )z� Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. Nr �r r# r r r �__eq__: r zBaseSpecifier.__eq__� bool | Nonec C r )z�Whether or not pre-releases as a whole are allowed. This can be set to either ``True`` or ``False`` to explicitly enable or disable prereleases or it can be set to ``None`` (the default) to use default semantics. Nr r r r r � prereleasesC r zBaseSpecifier.prereleases�value�Nonec C r )zQSetter for :attr:`prereleases`. :param value: The value to set. Nr �r r* r r r r) L r N�itemr) c C r )zR Determines if the given item is contained within this specifier. Nr )r r- r) r r r �containsS r zBaseSpecifier.contains�iterable� Iterable[UnparsedVersionVar]� Iterator[UnparsedVersionVar]c C r )z� Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. Nr )r r/ r) r r r �filterY r zBaseSpecifier.filter�r r �r r! �r# r$ r r% �r r( �r* r% r r+ r )r- r r) r( r r% �r/ r0 r) r( r r1 ) r r r �abc�abstractmethodr r" r' �propertyr) �setterr. r2 r r r r r , s" �r )� metaclassc @ sH e Zd ZdZdZdZe�de e d ejej B �Z dddd d d d d d�Z dSdTdd�Z e dUdd��ZejdVd d��Ze dWd d ��Ze dWd d!��ZdWd"d#�ZdWd$d%�Ze dXd'd(��ZdYd*d+�ZdZd.d/�Zd[d2d3�Zd\d6d7�Zd\d8d9�Zd\d:d;�Zd\d<d=�Zd\d>d?�Z d]dAdB�Z d]dCdD�Z d\dEdF�Z d^dIdJ�Z d_d`dLdM�Z! d_dadQdR�Z"dS )b� Specifiera? This class abstracts handling of version specifiers. .. tip:: It is generally not required to instantiate this manually. You should instead prefer to work with :class:`SpecifierSet` instead, which can parse comma-separated version specifiers (which is what package metadata contains). z8 (?P<operator>(~=|==|!=|<=|>=|<|>|===)) a� (?P<version> (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. (?<====) # Only match for the identity operator \s* [^\s;)]* # The arbitrary version can be just about anything, # we match everything except for whitespace, a # semi-colon for marker support, and a closing paren # since versions can be enclosed in them. ) | (?: # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. (?<===|!=) # Only match for equals and not equals \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release # You cannot use a wild card and a pre-release, post-release, a dev or # local version together so group them with a | and make them optional. (?: \.\* # Wild card syntax of .* | (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local )? ) | (?: # The compatible operator requires at least two digits in the # release segment. (?<=~=) # Only match for the compatible operator \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) | (?: # All other operators only allow a sub set of what the # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. (?<!==|!=|~=) # We have special cases for these # operators so we want to make sure they # don't match here. \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) z^\s*z\s*$� compatible�equal� not_equal�less_than_equal�greater_than_equal� less_than� greater_than� arbitrary)�~=�==z!=�<=�>=�<�>�===� N�specr r) r( r r+ c C sF | j �|�}|std|����|�d��� |�d��� f| _|| _dS )a� Initialize a Specifier instance. :param spec: The string representation of a specifier which will be parsed and normalized before use. :param prereleases: This tells the specifier if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given specifier is invalid (i.e. bad syntax). zInvalid specifier: �operatorr N)�_regex�searchr �group�strip�_spec� _prereleases)r rO r) �matchr r r �__init__� s � zSpecifier.__init__r% c C sR | j d ur| j S | j\}}|dv r'|dkr |�d�r |d d� }t|�jr'dS dS )N)rH rJ rI rG rM rL rK rH �.*���TF)rV rU �endswithr � is_prerelease)r rP r r r r r) � s zSpecifier.prereleasesr* c C � || _ d S r �rV r, r r r r) � c C � | j d S )z`The operator of this specifier. >>> Specifier("==1.2.3").operator '==' r �rU r r r r rP � zSpecifier.operatorc C r` )zaThe version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' r ra r r r r r rb zSpecifier.versionc C s8 | j dur d| j��nd}d| jj� dt| ��|� d�S )aT A representation of the Specifier that shows all internal state. >>> Specifier('>=1.0.0') <Specifier('>=1.0.0')> >>> Specifier('>=1.0.0', prereleases=False) <Specifier('>=1.0.0', prereleases=False)> >>> Specifier('>=1.0.0', prereleases=True) <Specifier('>=1.0.0', prereleases=True)> N�, prereleases=rN rK �(�)>)rV r) � __class__r r �r �prer r r �__repr__& s �� zSpecifier.__repr__c C s dj | j� S )z�A string representation of the Specifier that can be round-tripped. >>> str(Specifier('>=1.0.0')) '>=1.0.0' >>> str(Specifier('>=1.0.0', prereleases=False)) '>=1.0.0' z{}{})�formatrU r r r r r 8 s zSpecifier.__str__�tuple[str, str]c C s* t | jd | jd dkd�}| jd |fS )Nr r rG ��strip_trailing_zero)r rU )r �canonical_versionr r r �_canonical_specB s �zSpecifier._canonical_specr! c C � t | j�S r )�hashro r r r r r" J � zSpecifier.__hash__r# r$ c C sP t |t�rz | �t|��}W n ty t Y S w t || j�s"tS | j|jkS )a> Whether or not the two Specifier-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") True >>> (Specifier("==1.2.3", prereleases=False) == ... Specifier("==1.2.3", prereleases=True)) True >>> Specifier("==1.2.3") == "==1.2.3" True >>> Specifier("==1.2.3") == Specifier("==1.2.4") False >>> Specifier("==1.2.3") == Specifier("~=1.2.3") False )r r rf r �NotImplementedro r& r r r r' M s � zSpecifier.__eq__�op�CallableOperatorc C s t | d| j| � ��}|S )N� _compare_)�getattr� _operators)r rt �operator_callabler r r � _get_operatorj s �zSpecifier._get_operator� prospectiver c C sH t tt�tt|���d d� �}|d7 }| �d�||�o#| �d�||�S )N���rY rJ rH )� _version_join�list� itertools� takewhile�_is_not_suffix�_version_splitrz )r r{ rO �prefixr r r �_compare_compatiblep s ��z Specifier._compare_compatiblec C s� |� d�r1t|jdd�}t|d d� dd�}t|�}t|�}t||�\}}|d t|�� } | |kS t|�} | js=t|j�}|| kS )NrY Frl rZ )r[ r �publicr� � _pad_version�lenr �local) r r{ rO �normalized_prospective�normalized_spec� split_spec�split_prospective�padded_prospective�_�shortened_prospective� spec_versionr r r �_compare_equal� s � zSpecifier._compare_equalc C s | � ||� S r )r� �r r{ rO r r r �_compare_not_equal� s z Specifier._compare_not_equalc C s t |j�t |�kS r �r r� r� r r r �_compare_less_than_equal� � z"Specifier._compare_less_than_equalc C s t |j�t |�kS r r� r� r r r �_compare_greater_than_equal� r� z%Specifier._compare_greater_than_equal�spec_strc C s< t |�}||k s dS |js |jr t |j�t |j�kr dS dS �NFT)r r\ � base_version�r r{ r� rO r r r �_compare_less_than� s z Specifier._compare_less_thanc C s^ t |�}||ks dS |js |jr t |j�t |j�kr dS |jd ur-t |j�t |j�kr-dS dS r� )r �is_postreleaser� r� r� r r r �_compare_greater_than� s z Specifier._compare_greater_thanc C s t |��� t |��� kS r )r �lowerr� r r r �_compare_arbitrary� s z Specifier._compare_arbitraryr- � str | Versionc C � | � |�S )a; Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in Specifier(">=1.2.3") True >>> Version("1.2.3") in Specifier(">=1.2.3") True >>> "1.0.0" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True �r. �r r- r r r � __contains__� � zSpecifier.__contains__r c C s< |du r| j }t|�}|jr|sdS | �| j�}||| j�S )al Return whether or not the item is contained in this specifier. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this Specifier. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> Specifier(">=1.2.3").contains("1.2.3") True >>> Specifier(">=1.2.3").contains(Version("1.2.3")) True >>> Specifier(">=1.2.3").contains("1.0.0") False >>> Specifier(">=1.2.3").contains("1.3.0a1") False >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") True >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) True NF)r) r r\ rz rP r )r r- r) �normalized_itemry r r r r. s zSpecifier.containsr/ r0 r1 c c s� � d}g }d|dur |ndi}|D ]"}t |�}| j|fi |��r3|jr.|s.| js.|�|� qd}|V q|s@|rB|D ] }|V q:dS dS dS )aO Filter items in the given iterable, that match the specifier. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(Specifier().contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) ['1.2.3', '1.3', <Version('1.4')>] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) ['1.5a1'] >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] Fr) NT)r r. r\ r) �append)r r/ r) �yielded�found_prereleases�kwr �parsed_versionr r r r2 5 s* � �� ��zSpecifier.filter�rN N)rO r r) r( r r+ )r r% r7 r3 )r rk r4 r5 )rt r r ru )r{ r rO r r r% )r{ r r� r r r% )r- r� r r% r )r- r r) r( r r% r8 )#r r r r �_operator_regex_str�_version_regex_str�re�compile�VERBOSE� IGNORECASErQ rx rX r; r) r< rP r ri r ro r" r' rz r� r� r� r� r� r� r� r� r� r. r2 r r r r r> c sZ ^ �� ( -�r> z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$r � list[str]c C s^ g }| � d�\}}}|�|pd� |�d�D ]}t�|�}|r'|�|�� � q|�|� q|S )a Split version into components. The split components are intended for version comparison. The logic does not attempt to retain the original version string, so joining the components back with :func:`_version_join` may not produce the original version string. �!�0�.)� rpartitionr� �split� _prefix_regexrR �extend�groups)r �result�epochr� �restr- rW r r r r� v s r� � componentsc C s | ^}}|� dd� |�� �S )z�Join split version components into a version string. This function assumes the input came from :func:`_version_split`, where the first component must be the epoch (either empty or numeric), and all other components numeric. r� r� )�join)r� r� r� r r r r} � s r} �segmentr% c s t � fdd�dD �� S )Nc 3 s � | ]}� � |�V qd S r )� startswith)�.0r� �r� r r � <genexpr>� s � �z!_is_not_suffix.<locals>.<genexpr>)�dev�a�b�rc�post)�anyr� r r� r r� � s �r� �left�right�tuple[list[str], list[str]]c C s� g g }}|� tt�dd� | ��� |� tt�dd� |��� |� | t|d �d � � |� |t|d �d � � |�ddgtdt|d �t|d � � � |�ddgtdt|d �t|d � � � ttj�|��ttj�|��fS )Nc S � | � � S r ��isdigit��xr r r �<lambda>� � z _pad_version.<locals>.<lambda>c S r� r r� r� r r r r� � r� r r r� ) r� r~ r r� r� �insert�max�chain� from_iterable)r� r� � left_split� right_splitr r r r� � s ,,�r� c @ s� e Zd ZdZ d1d2d d �Zed3d d ��Zejd4dd ��Zd5dd�Zd5dd�Z d6dd�Z d7dd �Z d8d d �Z d6d d!�Z d9d#d$�Zd:d'd(�Z d;d<d*d+�Z d=d>d/d0�ZdS )?� SpecifierSetz�This class abstracts handling of a set of version specifiers. It can be passed a single specifier (``>=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. rN N� specifiers�str | Iterable[Specifier]r) r( r r+ c C sD t |t�rdd� |�d�D �}ttt|��| _nt|�| _|| _dS )a� Initialize a SpecifierSet instance. :param specifiers: The string representation of a specifier or a comma-separated list of specifiers which will be parsed and normalized before use. May also be an iterable of ``Specifier`` instances, which will be used as is. :param prereleases: This tells the SpecifierSet if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given ``specifiers`` are not parseable than this exception will be raised. c S s g | ] }|� � r|� � �qS r )rT �r� �sr r r � <listcomp>� s z)SpecifierSet.__init__.<locals>.<listcomp>�,N)r r r� � frozenset�mapr> �_specsrV )r r� r) �split_specifiersr r r rX � s zSpecifierSet.__init__c C s. | j d ur| j S | js d S tdd� | jD ��S )Nc s s � | ]}|j V qd S r �r) r� r r r r� � s � z+SpecifierSet.prereleases.<locals>.<genexpr>)rV r� r� r r r r r) � s zSpecifierSet.prereleasesr* r% c C r] r r^ r, r r r r) � r_ r c C s. | j dur d| j��nd}dt| ��|� d�S )a A representation of the specifier set that shows all internal state. Note that the ordering of the individual specifiers within the set may not match the input string. >>> SpecifierSet('>=1.0.0,!=2.0.0') <SpecifierSet('!=2.0.0,>=1.0.0')> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)> Nrc rN z<SpecifierSet(re )rV r) r rg r r r ri � s ��zSpecifierSet.__repr__c C s d� tdd� | jD ���S )an A string representation of the specifier set that can be round-tripped. Note that the ordering of the individual specifiers within the set may not match the input string. >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) '!=1.0.1,>=1.0.0' >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) '!=1.0.1,>=1.0.0' r� c s s � | ]}t |�V qd S r )r r� r r r r� s � z'SpecifierSet.__str__.<locals>.<genexpr>)r� �sortedr� r r r r r s zSpecifierSet.__str__r! c C rp r )rq r� r r r r r" rr zSpecifierSet.__hash__r# �SpecifierSet | strc C s� t |t�r t|�}nt |t�stS t� }t| j|jB �|_| jdu r-|jdur-|j|_|S | jdur=|jdu r=| j|_|S | j|jkrI| j|_|S td��)a� Return a SpecifierSet which is a combination of the two sets. :param other: The other object to combine with. >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> NzFCannot combine SpecifierSets with True and False prerelease overrides.)r r r� rs r� r� rV � ValueError)r r# � specifierr r r �__and__ s$ � ���zSpecifierSet.__and__r$ c C s6 t |ttf�rtt|��}nt |t�stS | j|jkS )a� Whether or not the two SpecifierSet-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") True >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) True >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" True >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") False >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") False )r r r> r� rs r� r& r r r r' 9 s zSpecifierSet.__eq__c C rp )z7Returns the number of specifiers in this specifier set.)r� r� r r r r �__len__S r_ zSpecifierSet.__len__�Iterator[Specifier]c C rp )z� Returns an iterator over all the underlying :class:`Specifier` instances in this specifier set. >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) [<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>] )�iterr� r r r r �__iter__W s zSpecifierSet.__iter__r- r c C r� )ar Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") True >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") True >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) True r� r� r r r r� a r� zSpecifierSet.__contains__� installedc s\ t � t�s t� �� �du r| j��s� jrdS |r!� jr!t� j�� t� �fdd�| jD ��S )a� Return whether or not the item is contained in this SpecifierSet. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this SpecifierSet. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") False >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") False >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) True NFc 3 s � | ] }|j � �d �V qdS )r� Nr� r� �r- r) r r r� � s � z(SpecifierSet.contains.<locals>.<genexpr>)r r r) r\ r� �allr� )r r- r) r� r r� r r. v s zSpecifierSet.containsr/ r0 r1 c C s� |du r| j }| jr | jD ] }|j|t|�d�}q t|�S g }g }|D ]}t|�}|jr6|s6|s5|�|� q#|�|� q#|sH|rH|du rHt|�S t|�S )a. Filter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) ['1.3', <Version('1.4')>] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) [] >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet("").filter(["1.5a1"])) ['1.5a1'] >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] Nr� )r) r� r2 r% r� r r\ r� )r r/ r) rO �filteredr� r- r� r r r r2 � s$ , � zSpecifierSet.filterr� )r� r� r) r( r r+ r6 r7 r3 r4 )r# r� r r� r5 )r r� )r- r r r% )NN)r- r r) r( r� r( r r% r r8 )r r r r rX r; r) r< ri r r" r� r' r� r� r� r. r2 r r r r r� � s, �& �:�r� )r r r r )r r r r� )r� r� r r )r� r r r% )r� r� r� r� r r� )"r � __future__r r9 r r� �typingr r r r r �utilsr r r r r r r% ru r r� r �ABCMetar r> r� r� r� r} r� r� r� r r r r �<module> s2 7 _vendor/packaging/__pycache__/_structures.cpython-310.pyc 0000644 00000005205 15030122015 0017406 0 ustar 00 o �h� � @ s, G d d� d�Z e � ZG dd� d�Ze� ZdS )c @ s� e Zd Zdefdd�Zdefdd�Zdedefdd�Z dedefd d �Z dedefd d �Z dedefd d�Z dedefdd�Z deddfdd�ZdS )� InfinityType�returnc C � dS )N�Infinity� ��selfr r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/_structures.py�__repr__ � zInfinityType.__repr__c C � t t| ��S �N��hash�reprr r r r �__hash__ � zInfinityType.__hash__�otherc C r �NFr �r r r r r �__lt__ r zInfinityType.__lt__c C r r r r r r r �__le__ r zInfinityType.__le__c C � t || j�S r �� isinstance� __class__r r r r �__eq__ r zInfinityType.__eq__c C r �NTr r r r r �__gt__ r zInfinityType.__gt__c C r r r r r r r �__ge__ r zInfinityType.__ge__r �NegativeInfinityTypec C � t S r )�NegativeInfinityr r r r �__neg__ r zInfinityType.__neg__N)�__name__� __module__� __qualname__�strr �intr �object�boolr r r r r r" r r r r r � r c @ s� e Zd Zdefdd�Zdefdd�Zdedefdd�Z dedefd d �Z dedefd d �Z dedefd d�Z dedefdd�Z dedefdd�ZdS )r r c C r )Nz -Infinityr r r r r r $ r z NegativeInfinityType.__repr__c C r r r r r r r r ' r z NegativeInfinityType.__hash__r c C r r r r r r r r * r zNegativeInfinityType.__lt__c C r r r r r r r r - r zNegativeInfinityType.__le__c C r r r r r r r r 0 r zNegativeInfinityType.__eq__c C r r r r r r r r 3 r zNegativeInfinityType.__gt__c C r r r r r r r r 6 r zNegativeInfinityType.__ge__r c C r r )r r r r r r" 9 r z NegativeInfinityType.__neg__N)r# r$ r% r& r r' r r( r) r r r r r r r" r r r r r # r* r N)r r r r! r r r r �<module> s _vendor/packaging/licenses/__pycache__/__init__.cpython-310.pyc 0000644 00000005046 15030122015 0020373 0 ustar 00 o �hS � @ sn d dl mZ d dlZd dlmZmZ d dlmZmZ g d�Z e� d�Z ede �Z G dd � d e�Zdd d�ZdS )� )� annotationsN)�NewType�cast)� EXCEPTIONS�LICENSES)�NormalizedLicenseExpression�InvalidLicenseExpression� canonicalize_license_expressionz^[A-Za-z0-9.-]*$r c @ s e Zd ZdZdS )r z�Raised when a license-expression string is invalid >>> canonicalize_license_expression("invalid") Traceback (most recent call last): ... packaging.licenses.InvalidLicenseExpression: Invalid license expression: 'invalid' N)�__name__� __module__� __qualname__�__doc__� r r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/licenses/__init__.pyr 2 s r �raw_license_expression�str�returnc s& | s d| ��}t |��| �dd��dd�}d� � fdd�|�� D �}|�� }|�� }g }|D ]0}|d vr:|�d � q.|d krD|�d � q.|dkrY|rY|d dvrYd| ��}t |��|�|� q.d�|�}z t|t� t� �}W n t yy d}Y nw |dur�d| ��}t |�d �g } |D ]t}|d v r�| �|� � � q�| r�| d dkr�|t vr�d|��}t |��| �t | d � q�|� d�r�|d d � } d} n|} d} | � d�r�t�| �s�d| ��}t |��| �|| | � q�| tvr�d| ��}t |��| �t| d | � q�d�| �} tt| �dd��dd��S ) Nz Invalid license expression: �(z ( �)z ) � LicenseRef-c s8 i | ]}|� � �� � � �r|� � d |t� �d� �qS )r N)�lower� startswith�len)�.0�ref��licenseref_prefixr r � <dictcomp>G s ��z3canonicalize_license_expression.<locals>.<dictcomp>> �or�and�withr r �Falser r ���> r r � TF�WITHzUnknown license exception: �id�+� z licenseref-zInvalid licenseref: zUnknown license: z( z ))r �replace�splitr �append�join�eval�globals�locals� Exception�upperr �endswithr �license_ref_allowed�matchr r r ) r �message�license_expression� license_refs�tokens� python_tokens�token�python_expression�invalid�normalized_tokens� final_token�suffix�normalized_expressionr r r r < st � � �r )r r r r )� __future__r �re�typingr r �packaging.licenses._spdxr r �__all__�compiler2 r r � ValueErrorr r r r r r �<module> s _vendor/packaging/licenses/__pycache__/_spdx.cpython-310.pyc 0000644 00000120012 15030122015 0017740 0 ustar 00 o �h� � @ s - U d dl mZ d dlmZ G dd� de�ZG dd� de�ZdZi dd d d ��d d d d ��ddd d ��ddd d ��ddd d ��ddd d ��ddd d ��ddd d ��ddd d ��d d d d ��d d d d ��d d!d d ��d"d#d d ��d$d%d d ��d&d'd d ��d(d)d d ��d*d+d,d ��i d-d.d d ��d/d0d d ��d1d2d,d ��d3d4d d ��d5d6d d ��d7d8d d ��d9d:d d ��d;d<d d ��d=d>d d ��d?d@d d ��dAdBd d ��dCdDd d ��dEdFd d ��dGdHd d ��dIdJd d ��dKdLd d ��dMdNd d ���i dOdPd d ��dQdRd d ��dSdTd d ��dUdVd d ��dWdXd d ��dYdZd d ��d[d\d d ��d]d^d d ��d_d`d d ��dadbd d ��dcddd d ��dedfd d ��dgdhd d ��didjd d ��dkdld d ��dmdnd d ��dodpd d ���i dqdrd d ��dsdtd d ��dudvd d ��dwdxd d ��dydzd d ��d{d|d d ��d}d}d d ��d~dd d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d,d ���i d�d�d,d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ���i d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d,d ��d�d�d d ���i d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ���i d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ��d�d�d d ���d �dd d ���d�dd d ���d�dd d ���d�dd d ���d�d d d ���d �d d d ���d �d d d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���i �d�dd d ���d�dd d ���d �d d d ���d �d d d ���d �d!d d ���d"�d#d d ���d$�d%d d ���d&�d'd d ���d(�d)d d ���d*�d+d d ���d,�d-d d ���d.�d/d d ���d0�d1d d ���d2�d3d d ���d4�d5d d ���d6�d7d d ���d8�d9d d ���i �d:�d;d d ���d<�d=d d ���d>�d?d d ���d@�dAd d ���dB�dCd d ���dD�dEd d ���dF�dGd d ���dH�dId d ���dJ�dKd d ���dL�dMd d ���dN�dOd d ���dP�dQd d ���dR�dSd d ���dT�dUd d ���dV�dWd d ���dX�dYd d ���dZ�d[d d ���i �d\�d]d d ���d^�d_d d ���d`�dad d ���db�dcd d ���dd�ded d ���df�dgd d ���dh�did d ���dj�dkd d ���dl�dmd d ���dn�dod d ���dp�dpd d ���dq�dqd d ���dr�dsd d ���dt�dud d ���dv�dwd d ���dx�dyd d ���dz�d{d d ���i �d|�d}d d ���d~�dd d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���i �d��d�d,d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���dÐd�d d ���dŐd�d d ���dǐd�d d ���dɐd�d d ���dːd�d d ���d͐d�d d ���dΐd�d d ���dАd�d d ���dҐd�d d ���dԐd�d d ���dd�d d ���dؐd�d d ���i �dڐd�d d ���dܐd�d d ���dސd�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d��d�d d ���d��d�d d ���d��d�d,d ���i �d��d�d d ���d��d�d d ���d��d d d ���d�dd d ���d�dd d ���d�dd d ���d�dd,d ���d �d d d ���d �d d d ���d �dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd,d ���d�dd d ���d�dd d ���d�d d d ���i �d �d d d ���d �d d d ���d!�d"d d ���d#�d$d d ���d%�d&d d ���d'�d(d d ���d)�d*d d ���d+�d,d d ���d-�d-d d ���d.�d/d,d ���d0�d1d,d ���d2�d3d d ���d4�d5d d ���d6�d7d,d ���d8�d9d,d ���d:�d;d d ���d<�d=d d ���i �d>�d?d,d ���d@�dAd,d ���dB�dCd,d ���dD�dEd,d ���dF�dGd,d ���dH�dId,d ���dJ�dKd,d ���dL�dMd d ���dN�dOd d ���dP�dQd,d ���dR�dSd,d ���dT�dUd d ���dV�dWd d ���dX�dXd d ���dY�dZd d ���d[�d\d d ���d]�d]d d ���i �d^�d_d d ���d`�dad d ���db�dcd d ���dd�ded d ���df�dgd d ���dh�did d ���dj�dkd d ���dl�dmd d ���dn�dod d ���dp�dqd d ���dr�dsd d ���dt�dud d ���dv�dwd d ���dx�dyd d ���dz�d{d d ���d|�d}d d ���d~�dd d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���dd�d d ���i �dĐd�d d ���dƐd�d d ���dȐd�d d ���dʐd�d d ���d̐d�d d ���dΐd�d d ���dАd�d d ���dҐd�d d ���dԐd�d,d ���dd�d,d ���dؐd�d d ���dڐd�d d ���dܐd�d,d ���dސd�d,d ���d�d�d d ���d�d�d d ���d�d�d,d ���i �d�d�d,d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d d d ���d�dd d ���d�dd d ���i �d�dd d ���d�dd d ���d �d d d ���d �d d d ���d �dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d �d d d ���d �d d d ���d �d!d d ���d"�d"d d ���d#�d#d d ���i �d$�d%d d ���d&�d'd d ���d(�d)d d ���d*�d*d d ���d+�d,d d ���d-�d.d d ���d/�d0d d ���d1�d2d d ���d3�d4d d ���d5�d6d d ���d7�d8d d ���d9�d:d d ���d;�d<d d ���d=�d>d d ���d?�d@d d ���dA�dBd d ���dC�dDd d ���i �dE�dFd d ���dG�dHd d ���dI�dJd d ���dK�dLd d ���dM�dNd d ���dO�dOd d ���dP�dPd d ���dQ�dRd d ���dS�dTd d ���dU�dVd d ���dW�dXd d ���dY�dYd d ���dZ�d[d d ���d\�d]d d ���d^�d_d d ���d`�dad d ���db�dcd d ���i �dd�ded d ���df�dgd d ���dh�did d ���dj�dkd d ���dl�dmd d ���dn�dod d ���dp�dqd d ���dr�dsd d ���dt�dud d ���dv�dwd d ���dx�dyd d ���dz�d{d,d ���d|�d}d d ���d~�dd d ���d��d�d d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d,d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���dd�d d ���dĐd�d d ���dƐd�d d ���dȐd�d d ���i �dʐd�d d ���d̐d�d d ���dΐd�d d ���dАd�d d ���dҐd�d d ���dԐd�d d ���dd�d d ���dؐd�d d ���dڐd�d d ���dܐd�d d ���dސd�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���i �d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d �dd d ���d�dd d ���d�dd d ���d�dd d ���d�d d d ���d �d d d ���d �d d d ���i �d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d �d d d ���d �d d d ���d �d!d d ���d"�d#d d ���d$�d%d d ���d&�d&d d ���d'�d'd d ���d(�d)d d ���d*�d+d d ���i �d,�d,d d ���d-�d.d d ���d/�d0d d ���d1�d2d d ���d3�d3d d ���d4�d5d d ���d6�d7d d ���d8�d9d d ���d:�d;d d ���d<�d=d d ���d>�d?d d ���d@�dAd d ���dB�dCd d ���dD�dEd d ���dF�dGd d ���dH�dId d ���dJ�dKd d ���i �dL�dMd d ���dN�dOd d ���dP�dQd d ���dR�dSd d ���dT�dUd d ���dV�dWd d ���dX�dYd d ���dZ�d[d d ���d\�d]d d ���d^�d_d d ���d`�dad d ���db�dcd d ���dd�ded d ���df�dgd d ���dh�did d ���dj�dkd d ���dl�dmd d ���i �dn�dod d ���dp�dqd d ���dr�drd d ���ds�dtd d ���du�dvd d ���dw�dxd d ���dy�dzd d ���d{�d|d d ���d}�d~d d ���d�dd d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d,d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���i �d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���dÐd�d d ���dŐd�d d ���dǐd�d d ���dɐd�d d ���dːd�d d ���d͐d�d d ���i �dϐd�d d ���dѐd�d d ���dӐd�d d ���dՐd�d d ���dאd�d d ���dِd�d d ���dڐd�d d ���dܐd�d d ���dސd�d d ���d�d�d d ���d�d�d,d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���d�d�d d ���i �d�d�d d ���d�d�d d ���d�d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d �dd d ���d�dd d ���d�dd d ���d�dd d ���d�d d d ���d �d d d ���d �d d d ����d d d ��dd d ��dd d ��d��Z�de�d< i �d�dd d ���d�dd d ���d�dd d ���d�dd d ���d�dd d ���d �d d d ���d �d d d ���d �d!d d ���d"�d#d d ���d$�d%d d ���d&�d'd d ���d(�d)d d ���d*�d+d d ���d,�d-d d ���d.�d/d d ���d0�d1d d ���d2�d2d d ��i �d3�d4d d ���d5�d6d d ���d7�d7d d ���d8�d9d d ���d:�d:d d ���d;�d<d d ���d=�d>d d ���d?�d@d d ���dA�dBd d ���dC�dDd d ���dE�dFd d ���dG�dHd d ���dI�dId d ���dJ�dKd d ���dL�dMd d ���dN�dOd d ���dP�dQd d ���i �dR�dSd d ���dT�dUd d ���dV�dVd d ���dW�dXd d ���dY�dZd d ���d[�d\d d ���d]�d^d d ���d_�d`d d ���da�dbd d ���dc�ddd d ���de�dfd d ���dg�dgd d ���dh�did,d ���dj�dkd d ���dl�dmd d ���dn�dod d ���dp�dpd d ���i �dq�drd d ���ds�dtd d ���du�dvd d ���dw�dxd d ���dy�dzd d ���d{�d|d d ���d}�d}d d ���d~�dd d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ���d��d�d d ����d�d d ��d�d d ��d�d d ��d�d d ��d���Z �d�e�d�< �d�S (� � )� annotations)� TypedDictc @ � e Zd ZU ded< ded< dS )� SPDXLicense�str�id�bool� deprecatedN��__name__� __module__� __qualname__�__annotations__� r r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_vendor/packaging/licenses/_spdx.pyr � r c @ r )� SPDXExceptionr r r r Nr r r r r r r r z3.25.0�0bsd�0BSDF)r r z 3d-slicer-1.0z 3D-Slicer-1.0�aal�AAL�abstyles�Abstylesz adacore-docz AdaCore-docz adobe-2006z Adobe-2006zadobe-display-postscriptzAdobe-Display-PostScriptz adobe-glyphz Adobe-Glyphz adobe-utopiaz Adobe-Utopia�adsl�ADSLzafl-1.1zAFL-1.1zafl-1.2zAFL-1.2zafl-2.0zAFL-2.0zafl-2.1zAFL-2.1zafl-3.0zAFL-3.0�afmparse�Afmparsezagpl-1.0zAGPL-1.0Tz agpl-1.0-onlyz AGPL-1.0-onlyzagpl-1.0-or-laterzAGPL-1.0-or-laterzagpl-3.0zAGPL-3.0z agpl-3.0-onlyz AGPL-3.0-onlyzagpl-3.0-or-laterzAGPL-3.0-or-later�aladdin�Aladdinz amd-newlibz AMD-newlib�amdplpa�AMDPLPA�aml�AMLz aml-glslangz AML-glslang�ampas�AMPASzantlr-pdzANTLR-PDzantlr-pd-fallbackzANTLR-PD-fallbackzany-osizany-OSIz apache-1.0z Apache-1.0z apache-1.1z Apache-1.1z apache-2.0z Apache-2.0�apafml�APAFMLzapl-1.0zAPL-1.0zapp-s2pzApp-s2pzapsl-1.0zAPSL-1.0zapsl-1.1zAPSL-1.1zapsl-1.2zAPSL-1.2zapsl-2.0zAPSL-2.0z arphic-1999z Arphic-1999z artistic-1.0z Artistic-1.0zartistic-1.0-cl8zArtistic-1.0-cl8zartistic-1.0-perlzArtistic-1.0-Perlz artistic-2.0z Artistic-2.0zaswf-digital-assets-1.0zASWF-Digital-Assets-1.0zaswf-digital-assets-1.1zASWF-Digital-Assets-1.1�baekmuk�Baekmuk�bahyph�Bahyph�barr�Barrzbcrypt-solar-designerzbcrypt-Solar-Designer�beerware�Beerwarezbitstream-charterzBitstream-Charterzbitstream-verazBitstream-Verazbittorrent-1.0zBitTorrent-1.0zbittorrent-1.1zBitTorrent-1.1�blessingz blueoak-1.0.0z BlueOak-1.0.0zboehm-gczBoehm-GC�borceux�Borceuxzbrian-gladman-2-clausezBrian-Gladman-2-Clausezbrian-gladman-3-clausezBrian-Gladman-3-Clausez bsd-1-clausez BSD-1-Clausez bsd-2-clausez BSD-2-Clausezbsd-2-clause-darwinzBSD-2-Clause-Darwinzbsd-2-clause-first-lineszBSD-2-Clause-first-lineszbsd-2-clause-freebsdzBSD-2-Clause-FreeBSDzbsd-2-clause-netbsdzBSD-2-Clause-NetBSDzbsd-2-clause-patentzBSD-2-Clause-Patentzbsd-2-clause-viewszBSD-2-Clause-Viewsz bsd-3-clausez BSD-3-Clausezbsd-3-clause-acpicazBSD-3-Clause-acpicazbsd-3-clause-attributionzBSD-3-Clause-Attributionzbsd-3-clause-clearzBSD-3-Clause-Clearzbsd-3-clause-flexzBSD-3-Clause-flexzbsd-3-clause-hpzBSD-3-Clause-HPzbsd-3-clause-lbnlzBSD-3-Clause-LBNLzbsd-3-clause-modificationzBSD-3-Clause-Modificationz bsd-3-clause-no-military-licensez BSD-3-Clause-No-Military-Licensez bsd-3-clause-no-nuclear-licensez BSD-3-Clause-No-Nuclear-Licensez$bsd-3-clause-no-nuclear-license-2014z$BSD-3-Clause-No-Nuclear-License-2014z bsd-3-clause-no-nuclear-warrantyz BSD-3-Clause-No-Nuclear-Warrantyzbsd-3-clause-open-mpizBSD-3-Clause-Open-MPIzbsd-3-clause-sunzBSD-3-Clause-Sunz bsd-4-clausez BSD-4-Clausezbsd-4-clause-shortenedzBSD-4-Clause-Shortenedzbsd-4-clause-uczBSD-4-Clause-UCz bsd-4.3renoz BSD-4.3RENOz bsd-4.3tahoez BSD-4.3TAHOEz bsd-advertising-acknowledgementz BSD-Advertising-Acknowledgementz bsd-attribution-hpnd-disclaimerz BSD-Attribution-HPND-disclaimerzbsd-inferno-nettverkzBSD-Inferno-Nettverkzbsd-protectionzBSD-Protectionzbsd-source-beginning-filezBSD-Source-beginning-filezbsd-source-codezBSD-Source-Codez bsd-systemicsz BSD-Systemicszbsd-systemics-w3workszBSD-Systemics-W3Workszbsl-1.0zBSL-1.0zbusl-1.1zBUSL-1.1z bzip2-1.0.5z bzip2-1.0.6z c-uda-1.0z C-UDA-1.0zcal-1.0zCAL-1.0z cal-1.0-combined-work-exceptionz CAL-1.0-Combined-Work-Exception�caldera�Calderazcaldera-no-preamblezCaldera-no-preamble�catharon�Catharonz catosl-1.1z CATOSL-1.1z cc-by-1.0z CC-BY-1.0z cc-by-2.0z CC-BY-2.0z cc-by-2.5z CC-BY-2.5z cc-by-2.5-auz CC-BY-2.5-AUz cc-by-3.0z CC-BY-3.0z cc-by-3.0-atz CC-BY-3.0-ATz cc-by-3.0-auz CC-BY-3.0-AUz cc-by-3.0-dez CC-BY-3.0-DEz cc-by-3.0-igoz CC-BY-3.0-IGOz cc-by-3.0-nlz CC-BY-3.0-NLz cc-by-3.0-usz CC-BY-3.0-USz cc-by-4.0z CC-BY-4.0z cc-by-nc-1.0z CC-BY-NC-1.0z cc-by-nc-2.0z CC-BY-NC-2.0z cc-by-nc-2.5z CC-BY-NC-2.5z cc-by-nc-3.0z CC-BY-NC-3.0zcc-by-nc-3.0-dezCC-BY-NC-3.0-DEz cc-by-nc-4.0z CC-BY-NC-4.0zcc-by-nc-nd-1.0zCC-BY-NC-ND-1.0zcc-by-nc-nd-2.0zCC-BY-NC-ND-2.0zcc-by-nc-nd-2.5zCC-BY-NC-ND-2.5zcc-by-nc-nd-3.0zCC-BY-NC-ND-3.0zcc-by-nc-nd-3.0-dezCC-BY-NC-ND-3.0-DEzcc-by-nc-nd-3.0-igozCC-BY-NC-ND-3.0-IGOzcc-by-nc-nd-4.0zCC-BY-NC-ND-4.0zcc-by-nc-sa-1.0zCC-BY-NC-SA-1.0zcc-by-nc-sa-2.0zCC-BY-NC-SA-2.0zcc-by-nc-sa-2.0-dezCC-BY-NC-SA-2.0-DEzcc-by-nc-sa-2.0-frzCC-BY-NC-SA-2.0-FRzcc-by-nc-sa-2.0-ukzCC-BY-NC-SA-2.0-UKzcc-by-nc-sa-2.5zCC-BY-NC-SA-2.5zcc-by-nc-sa-3.0zCC-BY-NC-SA-3.0zcc-by-nc-sa-3.0-dezCC-BY-NC-SA-3.0-DEzcc-by-nc-sa-3.0-igozCC-BY-NC-SA-3.0-IGOzcc-by-nc-sa-4.0zCC-BY-NC-SA-4.0z cc-by-nd-1.0z CC-BY-ND-1.0z cc-by-nd-2.0z CC-BY-ND-2.0z cc-by-nd-2.5z CC-BY-ND-2.5z cc-by-nd-3.0z CC-BY-ND-3.0zcc-by-nd-3.0-dezCC-BY-ND-3.0-DEz cc-by-nd-4.0z CC-BY-ND-4.0z cc-by-sa-1.0z CC-BY-SA-1.0z cc-by-sa-2.0z CC-BY-SA-2.0zcc-by-sa-2.0-ukzCC-BY-SA-2.0-UKzcc-by-sa-2.1-jpzCC-BY-SA-2.1-JPz cc-by-sa-2.5z CC-BY-SA-2.5z cc-by-sa-3.0z CC-BY-SA-3.0zcc-by-sa-3.0-atzCC-BY-SA-3.0-ATzcc-by-sa-3.0-dezCC-BY-SA-3.0-DEzcc-by-sa-3.0-igozCC-BY-SA-3.0-IGOz cc-by-sa-4.0z CC-BY-SA-4.0zcc-pddczCC-PDDCzcc0-1.0zCC0-1.0zcddl-1.0zCDDL-1.0zcddl-1.1zCDDL-1.1zcdl-1.0zCDL-1.0zcdla-permissive-1.0zCDLA-Permissive-1.0zcdla-permissive-2.0zCDLA-Permissive-2.0zcdla-sharing-1.0zCDLA-Sharing-1.0z cecill-1.0z CECILL-1.0z cecill-1.1z CECILL-1.1z cecill-2.0z CECILL-2.0z cecill-2.1z CECILL-2.1zcecill-bzCECILL-Bzcecill-czCECILL-Cz cern-ohl-1.1z CERN-OHL-1.1z cern-ohl-1.2z CERN-OHL-1.2zcern-ohl-p-2.0zCERN-OHL-P-2.0zcern-ohl-s-2.0zCERN-OHL-S-2.0zcern-ohl-w-2.0zCERN-OHL-W-2.0�cfitsio�CFITSIOz check-cvs�checkmk� clartistic� ClArtistic�clips�Clipszcmu-machzCMU-Machzcmu-mach-nodoczCMU-Mach-nodocz cnri-jythonz CNRI-Jythonz cnri-pythonz CNRI-Pythonzcnri-python-gpl-compatiblezCNRI-Python-GPL-Compatiblezcoil-1.0zCOIL-1.0zcommunity-spec-1.0zCommunity-Spec-1.0z condor-1.1z Condor-1.1zcopyleft-next-0.3.0zcopyleft-next-0.3.1zcornell-lossless-jpegzCornell-Lossless-JPEGzcpal-1.0zCPAL-1.0zcpl-1.0zCPL-1.0z cpol-1.02z CPOL-1.02�cronyx�Cronyx� crossword� Crossword�crystalstacker�CrystalStackerz cua-opl-1.0z CUA-OPL-1.0�cube�Cube�curlzcve-touz d-fsl-1.0z D-FSL-1.0z dec-3-clausez DEC-3-Clause�diffmarkz dl-de-by-2.0z DL-DE-BY-2.0zdl-de-zero-2.0zDL-DE-ZERO-2.0�doc�DOCzdocbook-schemazDocBook-Schemaz docbook-xmlz DocBook-XML�dotseqn�Dotseqnzdrl-1.0zDRL-1.0zdrl-1.1zDRL-1.1�dsdp�DSDP�dtoa�dvipdfmzecl-1.0zECL-1.0zecl-2.0zECL-2.0zecos-2.0zeCos-2.0zefl-1.0zEFL-1.0zefl-2.0zEFL-2.0�egenix�eGenixz elastic-2.0z Elastic-2.0�entessa�Entessa�epics�EPICSzepl-1.0zEPL-1.0zepl-2.0zEPL-2.0z erlpl-1.1z ErlPL-1.1z etalab-2.0� eudatagrid� EUDatagridzeupl-1.0zEUPL-1.0zeupl-1.1zEUPL-1.1zeupl-1.2zEUPL-1.2�eurosym�Eurosym�fair�Fair�fbm�FBMzfdk-aaczFDK-AACzferguson-twofishzFerguson-Twofishz frameworx-1.0z Frameworx-1.0z freebsd-docz FreeBSD-DOC� freeimage� FreeImage�fsfap�FSFAPz fsfap-no-warranty-disclaimerz FSFAP-no-warranty-disclaimer�fsful�FSFUL�fsfullr�FSFULLR� fsfullrwd� FSFULLRWD�ftl�FTL�furuseth�Furuseth�fwlwzgcr-docszGCR-docs�gd�GDzgfdl-1.1zGFDL-1.1zgfdl-1.1-invariants-onlyzGFDL-1.1-invariants-onlyz gfdl-1.1-invariants-or-laterz GFDL-1.1-invariants-or-laterzgfdl-1.1-no-invariants-onlyzGFDL-1.1-no-invariants-onlyz gfdl-1.1-no-invariants-or-laterz GFDL-1.1-no-invariants-or-laterz gfdl-1.1-onlyz GFDL-1.1-onlyzgfdl-1.1-or-laterzGFDL-1.1-or-laterzgfdl-1.2zGFDL-1.2zgfdl-1.2-invariants-onlyzGFDL-1.2-invariants-onlyz gfdl-1.2-invariants-or-laterz GFDL-1.2-invariants-or-laterzgfdl-1.2-no-invariants-onlyzGFDL-1.2-no-invariants-onlyz gfdl-1.2-no-invariants-or-laterz GFDL-1.2-no-invariants-or-laterz gfdl-1.2-onlyz GFDL-1.2-onlyzgfdl-1.2-or-laterzGFDL-1.2-or-laterzgfdl-1.3zGFDL-1.3zgfdl-1.3-invariants-onlyzGFDL-1.3-invariants-onlyz gfdl-1.3-invariants-or-laterz GFDL-1.3-invariants-or-laterzgfdl-1.3-no-invariants-onlyzGFDL-1.3-no-invariants-onlyz gfdl-1.3-no-invariants-or-laterz GFDL-1.3-no-invariants-or-laterz gfdl-1.3-onlyz GFDL-1.3-onlyzgfdl-1.3-or-laterzGFDL-1.3-or-later�giftware�Giftware�gl2ps�GL2PS�glide�Glide�glulxe�Glulxe�glwtpl�GLWTPL�gnuplotzgpl-1.0zGPL-1.0zgpl-1.0+zGPL-1.0+z gpl-1.0-onlyz GPL-1.0-onlyzgpl-1.0-or-laterzGPL-1.0-or-laterzgpl-2.0zGPL-2.0zgpl-2.0+zGPL-2.0+z gpl-2.0-onlyz GPL-2.0-onlyzgpl-2.0-or-laterzGPL-2.0-or-laterz gpl-2.0-with-autoconf-exceptionz GPL-2.0-with-autoconf-exceptionz gpl-2.0-with-bison-exceptionz GPL-2.0-with-bison-exceptionz gpl-2.0-with-classpath-exceptionz GPL-2.0-with-classpath-exceptionzgpl-2.0-with-font-exceptionzGPL-2.0-with-font-exceptionzgpl-2.0-with-gcc-exceptionzGPL-2.0-with-GCC-exceptionzgpl-3.0zGPL-3.0zgpl-3.0+zGPL-3.0+z gpl-3.0-onlyz GPL-3.0-onlyzgpl-3.0-or-laterzGPL-3.0-or-laterz gpl-3.0-with-autoconf-exceptionz GPL-3.0-with-autoconf-exceptionzgpl-3.0-with-gcc-exceptionzGPL-3.0-with-GCC-exceptionz graphics-gemsz Graphics-Gemsz gsoap-1.3bz gSOAP-1.3b�gtkbook�gutmann�Gutmann� haskellreport� HaskellReport�hdparm�hidapi�HIDAPIzhippocratic-2.1zHippocratic-2.1zhp-1986zHP-1986zhp-1989zHP-1989�hpnd�HPNDzhpnd-deczHPND-DECzhpnd-doczHPND-docz hpnd-doc-sellz HPND-doc-sellzhpnd-export-uszHPND-export-USz hpnd-export-us-acknowledgementz HPND-export-US-acknowledgementzhpnd-export-us-modifyzHPND-export-US-modifyzhpnd-export2-uszHPND-export2-USzhpnd-fenneberg-livingstonzHPND-Fenneberg-Livingstonzhpnd-inria-imagzHPND-INRIA-IMAGz hpnd-intelz HPND-Intelzhpnd-kevlin-henneyzHPND-Kevlin-Henneyzhpnd-markus-kuhnzHPND-Markus-Kuhnz hpnd-merchantability-variantz HPND-merchantability-variantzhpnd-mit-disclaimerzHPND-MIT-disclaimerz hpnd-netrekz HPND-Netrekz hpnd-pbmplusz HPND-Pbmplusz hpnd-sell-mit-disclaimer-xserverz HPND-sell-MIT-disclaimer-xserverzhpnd-sell-regexprzHPND-sell-regexprzhpnd-sell-variantzHPND-sell-variantz hpnd-sell-variant-mit-disclaimerz HPND-sell-variant-MIT-disclaimerz$hpnd-sell-variant-mit-disclaimer-revz$HPND-sell-variant-MIT-disclaimer-revzhpnd-uczHPND-UCzhpnd-uc-export-uszHPND-UC-export-US�htmltidy�HTMLTIDYzibm-pibszIBM-pibs�icu�ICUziec-code-components-eulazIEC-Code-Components-EULA�ijg�IJGz ijg-shortz IJG-short� imagemagick� ImageMagick�imatix�iMatix�imlib2�Imlib2zinfo-zipzInfo-ZIPz inner-net-2.0z Inner-Net-2.0�intel�Intelz intel-acpiz Intel-ACPIz interbase-1.0z Interbase-1.0�ipa�IPAzipl-1.0zIPL-1.0�isc�ISCz isc-veillardz ISC-Veillard�jam�Jamz jasper-2.0z JasPer-2.0z jpl-imagez JPL-image�jpnic�JPNIC�json�JSON�kastrup�Kastrup�kazlib�Kazlibz knuth-ctanz Knuth-CTANzlal-1.2zLAL-1.2zlal-1.3zLAL-1.3�latex2e�Latex2ezlatex2e-translated-noticezLatex2e-translated-notice� leptonica� Leptonicazlgpl-2.0zLGPL-2.0z lgpl-2.0+z LGPL-2.0+z lgpl-2.0-onlyz LGPL-2.0-onlyzlgpl-2.0-or-laterzLGPL-2.0-or-laterzlgpl-2.1zLGPL-2.1z lgpl-2.1+z LGPL-2.1+z lgpl-2.1-onlyz LGPL-2.1-onlyzlgpl-2.1-or-laterzLGPL-2.1-or-laterzlgpl-3.0zLGPL-3.0z lgpl-3.0+z LGPL-3.0+z lgpl-3.0-onlyz LGPL-3.0-onlyzlgpl-3.0-or-laterzLGPL-3.0-or-later�lgpllr�LGPLLR�libpng�Libpngz libpng-2.0zlibselinux-1.0�libtiffzlibutil-david-nugentzlibutil-David-Nugentz liliq-p-1.1z LiLiQ-P-1.1z liliq-r-1.1z LiLiQ-R-1.1zliliq-rplus-1.1zLiLiQ-Rplus-1.1zlinux-man-pages-1-parazLinux-man-pages-1-parazlinux-man-pages-copyleftzLinux-man-pages-copyleftz linux-man-pages-copyleft-2-paraz Linux-man-pages-copyleft-2-paraz linux-man-pages-copyleft-varz Linux-man-pages-copyleft-varz linux-openibz Linux-OpenIB�loop�LOOPz lpd-documentz LPD-documentzlpl-1.0zLPL-1.0zlpl-1.02zLPL-1.02zlppl-1.0zLPPL-1.0zlppl-1.1zLPPL-1.1zlppl-1.2zLPPL-1.2z lppl-1.3az LPPL-1.3az lppl-1.3cz LPPL-1.3c�lsofzlucida-bitmap-fontszLucida-Bitmap-Fontszlzma-sdk-9.11-to-9.20zLZMA-SDK-9.11-to-9.20z lzma-sdk-9.22z LZMA-SDK-9.22zmackerras-3-clausezMackerras-3-Clausez!mackerras-3-clause-acknowledgmentz!Mackerras-3-Clause-acknowledgment�magaz�mailprio� makeindex� MakeIndexzmartin-birgmeierzMartin-Birgmeierzmcphee-slideshowzMcPhee-slideshow�metamail�minpack�Minpack�miros�MirOS�mit�MITzmit-0zMIT-0zmit-advertisingzMIT-advertisingzmit-cmuzMIT-CMUzmit-ennazMIT-ennazmit-fehzMIT-fehz mit-festivalz MIT-Festivalzmit-khronos-oldzMIT-Khronos-oldzmit-modern-variantzMIT-Modern-Variantzmit-open-groupzMIT-open-groupz mit-testregexz MIT-testregexzmit-wuzMIT-Wu�mitnfa�MITNFA�mmixware�MMIXware�motosoto�Motosotozmpeg-ssgzMPEG-SSGzmpi-permissive�mpich2zmpl-1.0zMPL-1.0zmpl-1.1zMPL-1.1zmpl-2.0zMPL-2.0z mpl-2.0-no-copyleft-exceptionz MPL-2.0-no-copyleft-exception�mpluszms-lplzMS-LPLzms-plzMS-PLzms-rlzMS-RL�mtll�MTLLz mulanpsl-1.0z MulanPSL-1.0z mulanpsl-2.0z MulanPSL-2.0�multics�Multics�mup�Mupz naist-2003z NAIST-2003znasa-1.3zNASA-1.3�naumen�Naumenznbpl-1.0zNBPL-1.0zncbi-pdzNCBI-PDz ncgl-uk-2.0z NCGL-UK-2.0�ncl�NCL�ncsa�NCSAznet-snmpzNet-SNMP�netcdf�NetCDF�newsletr�Newsletr�ngpl�NGPLz nicta-1.0z NICTA-1.0znist-pdzNIST-PDznist-pd-fallbackzNIST-PD-fallbackz nist-softwarez NIST-Softwareznlod-1.0zNLOD-1.0znlod-2.0zNLOD-2.0�nlpl�NLPL�nokia�Nokia�nosl�NOSL�noweb�Nowebznpl-1.0zNPL-1.0znpl-1.1zNPL-1.1z nposl-3.0z NPOSL-3.0�nrl�NRL�ntp�NTPzntp-0zNTP-0�nunit�Nunitz o-uda-1.0z O-UDA-1.0�oar�OARzocct-plzOCCT-PLzoclc-2.0zOCLC-2.0zodbl-1.0zODbL-1.0z odc-by-1.0z ODC-By-1.0�offis�OFFISzofl-1.0zOFL-1.0zofl-1.0-no-rfnzOFL-1.0-no-RFNz ofl-1.0-rfnz OFL-1.0-RFNzofl-1.1zOFL-1.1zofl-1.1-no-rfnzOFL-1.1-no-RFNz ofl-1.1-rfnz OFL-1.1-RFNzogc-1.0zOGC-1.0zogdl-taiwan-1.0zOGDL-Taiwan-1.0zogl-canada-2.0zOGL-Canada-2.0z ogl-uk-1.0z OGL-UK-1.0z ogl-uk-2.0z OGL-UK-2.0z ogl-uk-3.0z OGL-UK-3.0�ogtsl�OGTSLz oldap-1.1z OLDAP-1.1z oldap-1.2z OLDAP-1.2z oldap-1.3z OLDAP-1.3z oldap-1.4z OLDAP-1.4z oldap-2.0z OLDAP-2.0z oldap-2.0.1z OLDAP-2.0.1z oldap-2.1z OLDAP-2.1z oldap-2.2z OLDAP-2.2z oldap-2.2.1z OLDAP-2.2.1z oldap-2.2.2z OLDAP-2.2.2z oldap-2.3z OLDAP-2.3z oldap-2.4z OLDAP-2.4z oldap-2.5z OLDAP-2.5z oldap-2.6z OLDAP-2.6z oldap-2.7z OLDAP-2.7z oldap-2.8z OLDAP-2.8zolfl-1.3zOLFL-1.3�oml�OMLz openpbs-2.3z OpenPBS-2.3�openssl�OpenSSLzopenssl-standalonezOpenSSL-standalone� openvision� OpenVisionzopl-1.0zOPL-1.0z opl-uk-3.0z OPL-UK-3.0z opubl-1.0z OPUBL-1.0z oset-pl-2.1z OSET-PL-2.1zosl-1.0zOSL-1.0zosl-1.1zOSL-1.1zosl-2.0zOSL-2.0zosl-2.1zOSL-2.1zosl-3.0zOSL-3.0�padl�PADLz parity-6.0.0z Parity-6.0.0z parity-7.0.0z Parity-7.0.0zpddl-1.0zPDDL-1.0zphp-3.0zPHP-3.0zphp-3.01zPHP-3.01�pixar�Pixar�pkgconf�plexus�Plexus� pnmstitchz polyform-noncommercial-1.0.0z PolyForm-Noncommercial-1.0.0z polyform-small-business-1.0.0z PolyForm-Small-Business-1.0.0� postgresql� PostgreSQL�ppl�PPLzpsf-2.0zPSF-2.0�psfrag�psutilsz python-2.0z Python-2.0z python-2.0.1z Python-2.0.1z python-ldap�qhull�Qhullzqpl-1.0zQPL-1.0zqpl-1.0-inria-2004zQPL-1.0-INRIA-2004�radvd�rdisc�Rdiscz rhecos-1.1z RHeCos-1.1zrpl-1.1zRPL-1.1zrpl-1.5zRPL-1.5zrpsl-1.0zRPSL-1.0zrsa-mdzRSA-MD�rscpl�RSCPL�ruby�Rubyzruby-ptyzRuby-ptyzsax-pdzSAX-PDz sax-pd-2.0z SAX-PD-2.0�saxpath�Saxpath�scea�SCEA� schemereport� SchemeReport�sendmail�Sendmailz sendmail-8.23z Sendmail-8.23z sgi-b-1.0z SGI-B-1.0z sgi-b-1.1z SGI-B-1.1z sgi-b-2.0z SGI-B-2.0z sgi-openglz SGI-OpenGL�sgp4�SGP4zshl-0.5zSHL-0.5zshl-0.51zSHL-0.51z simpl-2.0z SimPL-2.0�sissl�SISSLz sissl-1.2z SISSL-1.2�sl�SL� sleepycat� Sleepycat�smlnj�SMLNJ�smppl�SMPPL�snia�SNIA�snprintf� softsurfer� softSurfer�soundex�Soundexz spencer-86z Spencer-86z spencer-94z Spencer-94z spencer-99z Spencer-99zspl-1.0zSPL-1.0z ssh-keyscanz ssh-opensshz SSH-OpenSSHz ssh-shortz SSH-shortzssleay-standalonezSSLeay-standalonezsspl-1.0zSSPL-1.0z standardml-njz StandardML-NJzsugarcrm-1.1.3zSugarCRM-1.1.3zsun-pppzSun-PPPz sun-ppp-2000z Sun-PPP-2000�sunpro�SunPro�swl�SWL�swrule�symlinks�Symlinksz tapr-ohl-1.0z TAPR-OHL-1.0�tcl�TCLz tcp-wrappersz TCP-wrappers� termreadkey� TermReadKeyz tgppl-1.0z TGPPL-1.0�threeparttable�tmate�TMatez torque-1.1z TORQUE-1.1�tosl�TOSL�tpdl�TPDLztpl-1.0zTPL-1.0�ttwl�TTWL�ttyp0�TTYP0z tu-berlin-1.0z TU-Berlin-1.0z tu-berlin-2.0z TU-Berlin-2.0zubuntu-font-1.0zUbuntu-font-1.0�ucar�UCARzucl-1.0zUCL-1.0�ulemz umich-meritz UMich-Meritz unicode-3.0z Unicode-3.0zunicode-dfs-2015zUnicode-DFS-2015zunicode-dfs-2016zUnicode-DFS-2016z unicode-touz Unicode-TOU� unixcrypt� UnixCrypt� unlicense� Unlicensezupl-1.0zUPL-1.0zurt-rlezURT-RLE�vim�Vim�vostrom�VOSTROMzvsl-1.0zVSL-1.0�w3c�W3Cz w3c-19980720z W3C-19980720z w3c-20150513z W3C-20150513�w3mz watcom-1.0z Watcom-1.0zwidget-workshopzWidget-Workshop�wsuipa�Wsuipa�wtfpl�WTFPL� wxwindows� wxWindows�x11�X11z$x11-distribute-modifications-variantz$X11-distribute-modifications-variantz x11-swappedz X11-swappedz xdebug-1.03z Xdebug-1.03�xerox�Xerox�xfig�Xfigz xfree86-1.1z XFree86-1.1�xinetdzxkeyboard-config-zinovievzxkeyboard-config-Zinoviev�xlock�xnet�Xnet�xpp�xskat�XSkat�xzoomzypl-1.0zYPL-1.0zypl-1.1zYPL-1.1�zed�Zed�zeeff�Zeeffzzend-2.0zZend-2.0z zimbra-1.3z Zimbra-1.3z zimbra-1.4z Zimbra-1.4�zlib�Zlibzzlib-acknowledgementzZPL-1.1zZPL-2.0zZPL-2.1)zzpl-1.1zzpl-2.0zzpl-2.1zdict[str, SPDXLicense]�LICENSESz 389-exceptionzasterisk-exceptionzAsterisk-exceptionz$asterisk-linking-protocols-exceptionz$Asterisk-linking-protocols-exceptionzautoconf-exception-2.0zAutoconf-exception-2.0zautoconf-exception-3.0zAutoconf-exception-3.0zautoconf-exception-genericzAutoconf-exception-genericz autoconf-exception-generic-3.0z Autoconf-exception-generic-3.0zautoconf-exception-macrozAutoconf-exception-macrozbison-exception-1.24zBison-exception-1.24zbison-exception-2.2zBison-exception-2.2zbootloader-exceptionzBootloader-exceptionzclasspath-exception-2.0zClasspath-exception-2.0zclisp-exception-2.0zCLISP-exception-2.0z cryptsetup-openssl-exceptionz cryptsetup-OpenSSL-exceptionzdigirule-foss-exceptionzDigiRule-FOSS-exceptionzecos-exception-2.0zeCos-exception-2.0z erlang-otp-linking-exceptionzfawkes-runtime-exceptionzFawkes-Runtime-exceptionzfltk-exceptionzFLTK-exceptionz fmt-exceptionzfont-exception-2.0zFont-exception-2.0zfreertos-exception-2.0zgcc-exception-2.0zGCC-exception-2.0zgcc-exception-2.0-notezGCC-exception-2.0-notezgcc-exception-3.1zGCC-exception-3.1zgmsh-exceptionzGmsh-exceptionzgnat-exceptionzGNAT-exceptionzgnome-examples-exceptionzGNOME-examples-exceptionzgnu-compiler-exceptionzGNU-compiler-exceptionzgnu-javamail-exceptionzgpl-3.0-interface-exceptionzGPL-3.0-interface-exceptionzgpl-3.0-linking-exceptionzGPL-3.0-linking-exceptionz gpl-3.0-linking-source-exceptionz GPL-3.0-linking-source-exceptionz gpl-cc-1.0z GPL-CC-1.0zgstreamer-exception-2005zGStreamer-exception-2005zgstreamer-exception-2008zGStreamer-exception-2008zi2p-gpl-java-exceptionzkicad-libraries-exceptionzKiCad-libraries-exceptionzlgpl-3.0-linking-exceptionzLGPL-3.0-linking-exceptionzlibpri-openh323-exceptionzlibpri-OpenH323-exceptionzlibtool-exceptionzLibtool-exceptionzlinux-syscall-notezLinux-syscall-note�llgpl�LLGPLzllvm-exceptionzLLVM-exceptionzlzma-exceptionzLZMA-exceptionz mif-exceptionznokia-qt-exception-1.1zNokia-Qt-exception-1.1z ocaml-lgpl-linking-exceptionz OCaml-LGPL-linking-exceptionzocct-exception-1.0zOCCT-exception-1.0z openjdk-assembly-exception-1.0z OpenJDK-assembly-exception-1.0zopenvpn-openssl-exceptionzpcre2-exceptionzPCRE2-exceptionz!ps-or-pdf-font-exception-20170817z!PS-or-PDF-font-exception-20170817z qpl-1.0-inria-2004-exceptionz QPL-1.0-INRIA-2004-exceptionzqt-gpl-exception-1.0zQt-GPL-exception-1.0zqt-lgpl-exception-1.1zQt-LGPL-exception-1.1zqwt-exception-1.0zQwt-exception-1.0zromic-exceptionzrrdtool-floss-exception-2.0zRRDtool-FLOSS-exception-2.0zsane-exceptionzSANE-exceptionzshl-2.0zSHL-2.0zshl-2.1zSHL-2.1zstunnel-exceptionz swi-exceptionz SWI-exceptionzswift-exceptionzSwift-exceptionztexinfo-exceptionzTexinfo-exceptionzu-boot-exception-2.0zubdl-exceptionzUBDL-exceptionz Universal-FOSS-exception-1.0�vsftpd-openssl-exceptionzWxWindows-exception-3.1�x11vnc-openssl-exception)z universal-foss-exception-1.0r] zwxwindows-exception-3.1r^ zdict[str, SPDXException]� EXCEPTIONSN) � __future__r �typingr r r �VERSIONrZ r r_ r r r r �<module> s�! � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � !� "� #� $� %� &� '� (� )� *� +� ,� -� .� /� 0� 1� 2� 3� 4� 5� 6� 7� 8� 9� :� ;� <� =� >� ?� @� A� B� C� D� E� F� G� H� I� J� K� L� M� N� O� P� Q� R� S� T� U� V� W� X� Y� Z� [� \� ]� ^� _� `� a� b� c� d� e� f� g� h� i� j� k� l� m� n� o� p� q� r� s� t� u� v� w� x� y� z� {� |�}�~�� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� �� ! �� " �� # �� $ �� % �� & �� ' �� ( �� ) �� * �� + �� , �� - �� . �� / �� 0 �� 1 �� 2 �� 3 �� 4 �� 5 �� 6 �� 7 �� 8 �� 9 �� : �� ; �� < �� = �� > �� ? �� @ �� A �� B �� C �� D �� E �� F �� G �� H �� I �� J �� K �� L �� M �� N �� O �� P �� Q �� R �� S �� T �� U �� V �� W �� X �� Y �� Z �� [ �� \ �� ] �� ^ �� _ �� ` �� a �� b �� c �� d �� e �� f �� g �� h �� i �� j �� k �� l �� m �� n �� o �� p �� q �� r �� s �� t �� u �� v �� w �� x �� y �� z �� { �� | �� } �� ~ �� �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� � �� ! � �� " � �� # � �� $ � �� % � �� & � �� ' � �� ( � �� ) � �� * � �� + � �� , � �� - � �� . � �� / � �� 0 � �� 1 � �� 2 � �� 3 � �� 4 � �� 5 � �� 6 � �� 7 � �� 8 � �� 9 � �� : � �� ; � �� < � �� = � �� > � �� ? � �� @ � �� A � �� B � �� C � �� D � �� E � �� F � �� G � �� H � �� I � �� J � �� K � �� L � �� M � �� N � �� O � �� P � �� Q � �� R � �� S � �� T � �� U � �� V � �� W � �� X � �� Y � �� Z � �� [ � �� \ � �� ] � �� ^ � �� _ � �� ` � �� a � �� b � �� c � �� d � �� e � �� f � �� g � �� h � �� i � �� j � �� k � �� l � �� m � �� n � �� o � �� p � �� q � �� r � �� s � �� t � �� u � �� v � �� w � �� x � �� y � �� z � �� { � �� | � �� } � �� ~ � �� � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� � � �� ! � � �� " � � �� # � � �� $ � � �� % � � �� & � � �� ' � � �� ( � � �� ) � � �� * � � �� + � � �� , � � �� - � � �� . � � �� / � � �� 0 � � �� 1 � � �� 2 � � �� 3 � � �� 4 � � �� 5 � � �� 6 � � �� 7 � � �� 8 � � �� 9 � � �� : � � �� ; � � �� < � � �� = � � �� > � � �� ? � � �� @ � � �� A � � �� B � � �� C � � �� D � � �� E � � �� F � � �� G � � �� H � � �� I � � �� J � � �� K � � �� L � � �� M � � �� N � � �� O � � �� P � � �� Q � � �� R � � �� S � � �� T � � �� U � � �� V � � �� W � � �� X � � �� Y � � �� Z � � �� [ � � �� \ � � �� ] � � �� ^ � � �� _ � � �� ` � � �� a � � �� b � � �� c � � �� d � � �� e � � �� f � � �� g � � �� h � � �� i � � �� j � � �� k � � �� l � � �� m � � �� n � � �� o � � �� p � � �� q � � �� r � � �� s � � �� t � � �� u � � �� v � � �� w � � �� x � � �� y � � �� z � � �� { � � �� | � � �� } � � �� ~ � � �� � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� � � � �� ! � � � �� " � � � �� # � � � �� $ � � � �� % � � � �� & � � � �� ' � � � �� ( � � � �� ) � � � �� * � � � �� + � � � �� , � � � �� - � � � �� . � � � �� / � � � �� 0 � � � �� 1 � � � �� 2 � � � �� 3 � � � �� 4 � � � �� 5 � � � �� 6 � � � �� 7 � � � �� 8 � � � �� 9 � � � �� : � � � �� ; � � � �� < � � � �� = � � � �� > � � � �� ? � � � �� @ � � � �� A � � � �� B � � � �� C � � � �� D � � � �� E � � � �� F � � � �� G � � � �� H � � � �� I � � � �� J � � � �� K � � � �� L � � � �� M � � � �� N � � � �� O � � � �� P � � � �� Q � � � �� R � � � �� S � � � �� T � � � �� U � � � �� V � � � �� W � � � �� X � � � �� Y � � � �� Z � � � �� [ � � � �� \ � � � �� ] � � � �� ^ � � � �� _ � � � �� ` � � � �� a � � � �� b � � � �� c � � � �� d � � � �� e � � � �� f � � � �� g � � � �� h � � � �� i � � � �� j � � � �� k � � � �� l � � � �� m � � � �� n � � � �� o � � � �� p � � � �� q � � � �� r � � � �� s � � � �� t � � � �� u � � � �� v � � � �� w � � � �� x � � � �� y � � � �� z � � � �� { � � � �� | � � � �� } � � � �� ~ � � � �� � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� � � � � �� "�������� � � � � ��������������� � � � � �!�"�#�$�%�&�'�(�)�*�+�,�-�.�/�0�1�2�3�4�5�6�7�8�9�:�;�<�=�>�?�@�A�B�C�D� E � _vendor/packaging/licenses/_spdx.py 0000644 00000136416 15030122015 0013420 0 ustar 00 from __future__ import annotations from typing import TypedDict class SPDXLicense(TypedDict): id: str deprecated: bool class SPDXException(TypedDict): id: str deprecated: bool VERSION = '3.25.0' LICENSES: dict[str, SPDXLicense] = { '0bsd': {'id': '0BSD', 'deprecated': False}, '3d-slicer-1.0': {'id': '3D-Slicer-1.0', 'deprecated': False}, 'aal': {'id': 'AAL', 'deprecated': False}, 'abstyles': {'id': 'Abstyles', 'deprecated': False}, 'adacore-doc': {'id': 'AdaCore-doc', 'deprecated': False}, 'adobe-2006': {'id': 'Adobe-2006', 'deprecated': False}, 'adobe-display-postscript': {'id': 'Adobe-Display-PostScript', 'deprecated': False}, 'adobe-glyph': {'id': 'Adobe-Glyph', 'deprecated': False}, 'adobe-utopia': {'id': 'Adobe-Utopia', 'deprecated': False}, 'adsl': {'id': 'ADSL', 'deprecated': False}, 'afl-1.1': {'id': 'AFL-1.1', 'deprecated': False}, 'afl-1.2': {'id': 'AFL-1.2', 'deprecated': False}, 'afl-2.0': {'id': 'AFL-2.0', 'deprecated': False}, 'afl-2.1': {'id': 'AFL-2.1', 'deprecated': False}, 'afl-3.0': {'id': 'AFL-3.0', 'deprecated': False}, 'afmparse': {'id': 'Afmparse', 'deprecated': False}, 'agpl-1.0': {'id': 'AGPL-1.0', 'deprecated': True}, 'agpl-1.0-only': {'id': 'AGPL-1.0-only', 'deprecated': False}, 'agpl-1.0-or-later': {'id': 'AGPL-1.0-or-later', 'deprecated': False}, 'agpl-3.0': {'id': 'AGPL-3.0', 'deprecated': True}, 'agpl-3.0-only': {'id': 'AGPL-3.0-only', 'deprecated': False}, 'agpl-3.0-or-later': {'id': 'AGPL-3.0-or-later', 'deprecated': False}, 'aladdin': {'id': 'Aladdin', 'deprecated': False}, 'amd-newlib': {'id': 'AMD-newlib', 'deprecated': False}, 'amdplpa': {'id': 'AMDPLPA', 'deprecated': False}, 'aml': {'id': 'AML', 'deprecated': False}, 'aml-glslang': {'id': 'AML-glslang', 'deprecated': False}, 'ampas': {'id': 'AMPAS', 'deprecated': False}, 'antlr-pd': {'id': 'ANTLR-PD', 'deprecated': False}, 'antlr-pd-fallback': {'id': 'ANTLR-PD-fallback', 'deprecated': False}, 'any-osi': {'id': 'any-OSI', 'deprecated': False}, 'apache-1.0': {'id': 'Apache-1.0', 'deprecated': False}, 'apache-1.1': {'id': 'Apache-1.1', 'deprecated': False}, 'apache-2.0': {'id': 'Apache-2.0', 'deprecated': False}, 'apafml': {'id': 'APAFML', 'deprecated': False}, 'apl-1.0': {'id': 'APL-1.0', 'deprecated': False}, 'app-s2p': {'id': 'App-s2p', 'deprecated': False}, 'apsl-1.0': {'id': 'APSL-1.0', 'deprecated': False}, 'apsl-1.1': {'id': 'APSL-1.1', 'deprecated': False}, 'apsl-1.2': {'id': 'APSL-1.2', 'deprecated': False}, 'apsl-2.0': {'id': 'APSL-2.0', 'deprecated': False}, 'arphic-1999': {'id': 'Arphic-1999', 'deprecated': False}, 'artistic-1.0': {'id': 'Artistic-1.0', 'deprecated': False}, 'artistic-1.0-cl8': {'id': 'Artistic-1.0-cl8', 'deprecated': False}, 'artistic-1.0-perl': {'id': 'Artistic-1.0-Perl', 'deprecated': False}, 'artistic-2.0': {'id': 'Artistic-2.0', 'deprecated': False}, 'aswf-digital-assets-1.0': {'id': 'ASWF-Digital-Assets-1.0', 'deprecated': False}, 'aswf-digital-assets-1.1': {'id': 'ASWF-Digital-Assets-1.1', 'deprecated': False}, 'baekmuk': {'id': 'Baekmuk', 'deprecated': False}, 'bahyph': {'id': 'Bahyph', 'deprecated': False}, 'barr': {'id': 'Barr', 'deprecated': False}, 'bcrypt-solar-designer': {'id': 'bcrypt-Solar-Designer', 'deprecated': False}, 'beerware': {'id': 'Beerware', 'deprecated': False}, 'bitstream-charter': {'id': 'Bitstream-Charter', 'deprecated': False}, 'bitstream-vera': {'id': 'Bitstream-Vera', 'deprecated': False}, 'bittorrent-1.0': {'id': 'BitTorrent-1.0', 'deprecated': False}, 'bittorrent-1.1': {'id': 'BitTorrent-1.1', 'deprecated': False}, 'blessing': {'id': 'blessing', 'deprecated': False}, 'blueoak-1.0.0': {'id': 'BlueOak-1.0.0', 'deprecated': False}, 'boehm-gc': {'id': 'Boehm-GC', 'deprecated': False}, 'borceux': {'id': 'Borceux', 'deprecated': False}, 'brian-gladman-2-clause': {'id': 'Brian-Gladman-2-Clause', 'deprecated': False}, 'brian-gladman-3-clause': {'id': 'Brian-Gladman-3-Clause', 'deprecated': False}, 'bsd-1-clause': {'id': 'BSD-1-Clause', 'deprecated': False}, 'bsd-2-clause': {'id': 'BSD-2-Clause', 'deprecated': False}, 'bsd-2-clause-darwin': {'id': 'BSD-2-Clause-Darwin', 'deprecated': False}, 'bsd-2-clause-first-lines': {'id': 'BSD-2-Clause-first-lines', 'deprecated': False}, 'bsd-2-clause-freebsd': {'id': 'BSD-2-Clause-FreeBSD', 'deprecated': True}, 'bsd-2-clause-netbsd': {'id': 'BSD-2-Clause-NetBSD', 'deprecated': True}, 'bsd-2-clause-patent': {'id': 'BSD-2-Clause-Patent', 'deprecated': False}, 'bsd-2-clause-views': {'id': 'BSD-2-Clause-Views', 'deprecated': False}, 'bsd-3-clause': {'id': 'BSD-3-Clause', 'deprecated': False}, 'bsd-3-clause-acpica': {'id': 'BSD-3-Clause-acpica', 'deprecated': False}, 'bsd-3-clause-attribution': {'id': 'BSD-3-Clause-Attribution', 'deprecated': False}, 'bsd-3-clause-clear': {'id': 'BSD-3-Clause-Clear', 'deprecated': False}, 'bsd-3-clause-flex': {'id': 'BSD-3-Clause-flex', 'deprecated': False}, 'bsd-3-clause-hp': {'id': 'BSD-3-Clause-HP', 'deprecated': False}, 'bsd-3-clause-lbnl': {'id': 'BSD-3-Clause-LBNL', 'deprecated': False}, 'bsd-3-clause-modification': {'id': 'BSD-3-Clause-Modification', 'deprecated': False}, 'bsd-3-clause-no-military-license': {'id': 'BSD-3-Clause-No-Military-License', 'deprecated': False}, 'bsd-3-clause-no-nuclear-license': {'id': 'BSD-3-Clause-No-Nuclear-License', 'deprecated': False}, 'bsd-3-clause-no-nuclear-license-2014': {'id': 'BSD-3-Clause-No-Nuclear-License-2014', 'deprecated': False}, 'bsd-3-clause-no-nuclear-warranty': {'id': 'BSD-3-Clause-No-Nuclear-Warranty', 'deprecated': False}, 'bsd-3-clause-open-mpi': {'id': 'BSD-3-Clause-Open-MPI', 'deprecated': False}, 'bsd-3-clause-sun': {'id': 'BSD-3-Clause-Sun', 'deprecated': False}, 'bsd-4-clause': {'id': 'BSD-4-Clause', 'deprecated': False}, 'bsd-4-clause-shortened': {'id': 'BSD-4-Clause-Shortened', 'deprecated': False}, 'bsd-4-clause-uc': {'id': 'BSD-4-Clause-UC', 'deprecated': False}, 'bsd-4.3reno': {'id': 'BSD-4.3RENO', 'deprecated': False}, 'bsd-4.3tahoe': {'id': 'BSD-4.3TAHOE', 'deprecated': False}, 'bsd-advertising-acknowledgement': {'id': 'BSD-Advertising-Acknowledgement', 'deprecated': False}, 'bsd-attribution-hpnd-disclaimer': {'id': 'BSD-Attribution-HPND-disclaimer', 'deprecated': False}, 'bsd-inferno-nettverk': {'id': 'BSD-Inferno-Nettverk', 'deprecated': False}, 'bsd-protection': {'id': 'BSD-Protection', 'deprecated': False}, 'bsd-source-beginning-file': {'id': 'BSD-Source-beginning-file', 'deprecated': False}, 'bsd-source-code': {'id': 'BSD-Source-Code', 'deprecated': False}, 'bsd-systemics': {'id': 'BSD-Systemics', 'deprecated': False}, 'bsd-systemics-w3works': {'id': 'BSD-Systemics-W3Works', 'deprecated': False}, 'bsl-1.0': {'id': 'BSL-1.0', 'deprecated': False}, 'busl-1.1': {'id': 'BUSL-1.1', 'deprecated': False}, 'bzip2-1.0.5': {'id': 'bzip2-1.0.5', 'deprecated': True}, 'bzip2-1.0.6': {'id': 'bzip2-1.0.6', 'deprecated': False}, 'c-uda-1.0': {'id': 'C-UDA-1.0', 'deprecated': False}, 'cal-1.0': {'id': 'CAL-1.0', 'deprecated': False}, 'cal-1.0-combined-work-exception': {'id': 'CAL-1.0-Combined-Work-Exception', 'deprecated': False}, 'caldera': {'id': 'Caldera', 'deprecated': False}, 'caldera-no-preamble': {'id': 'Caldera-no-preamble', 'deprecated': False}, 'catharon': {'id': 'Catharon', 'deprecated': False}, 'catosl-1.1': {'id': 'CATOSL-1.1', 'deprecated': False}, 'cc-by-1.0': {'id': 'CC-BY-1.0', 'deprecated': False}, 'cc-by-2.0': {'id': 'CC-BY-2.0', 'deprecated': False}, 'cc-by-2.5': {'id': 'CC-BY-2.5', 'deprecated': False}, 'cc-by-2.5-au': {'id': 'CC-BY-2.5-AU', 'deprecated': False}, 'cc-by-3.0': {'id': 'CC-BY-3.0', 'deprecated': False}, 'cc-by-3.0-at': {'id': 'CC-BY-3.0-AT', 'deprecated': False}, 'cc-by-3.0-au': {'id': 'CC-BY-3.0-AU', 'deprecated': False}, 'cc-by-3.0-de': {'id': 'CC-BY-3.0-DE', 'deprecated': False}, 'cc-by-3.0-igo': {'id': 'CC-BY-3.0-IGO', 'deprecated': False}, 'cc-by-3.0-nl': {'id': 'CC-BY-3.0-NL', 'deprecated': False}, 'cc-by-3.0-us': {'id': 'CC-BY-3.0-US', 'deprecated': False}, 'cc-by-4.0': {'id': 'CC-BY-4.0', 'deprecated': False}, 'cc-by-nc-1.0': {'id': 'CC-BY-NC-1.0', 'deprecated': False}, 'cc-by-nc-2.0': {'id': 'CC-BY-NC-2.0', 'deprecated': False}, 'cc-by-nc-2.5': {'id': 'CC-BY-NC-2.5', 'deprecated': False}, 'cc-by-nc-3.0': {'id': 'CC-BY-NC-3.0', 'deprecated': False}, 'cc-by-nc-3.0-de': {'id': 'CC-BY-NC-3.0-DE', 'deprecated': False}, 'cc-by-nc-4.0': {'id': 'CC-BY-NC-4.0', 'deprecated': False}, 'cc-by-nc-nd-1.0': {'id': 'CC-BY-NC-ND-1.0', 'deprecated': False}, 'cc-by-nc-nd-2.0': {'id': 'CC-BY-NC-ND-2.0', 'deprecated': False}, 'cc-by-nc-nd-2.5': {'id': 'CC-BY-NC-ND-2.5', 'deprecated': False}, 'cc-by-nc-nd-3.0': {'id': 'CC-BY-NC-ND-3.0', 'deprecated': False}, 'cc-by-nc-nd-3.0-de': {'id': 'CC-BY-NC-ND-3.0-DE', 'deprecated': False}, 'cc-by-nc-nd-3.0-igo': {'id': 'CC-BY-NC-ND-3.0-IGO', 'deprecated': False}, 'cc-by-nc-nd-4.0': {'id': 'CC-BY-NC-ND-4.0', 'deprecated': False}, 'cc-by-nc-sa-1.0': {'id': 'CC-BY-NC-SA-1.0', 'deprecated': False}, 'cc-by-nc-sa-2.0': {'id': 'CC-BY-NC-SA-2.0', 'deprecated': False}, 'cc-by-nc-sa-2.0-de': {'id': 'CC-BY-NC-SA-2.0-DE', 'deprecated': False}, 'cc-by-nc-sa-2.0-fr': {'id': 'CC-BY-NC-SA-2.0-FR', 'deprecated': False}, 'cc-by-nc-sa-2.0-uk': {'id': 'CC-BY-NC-SA-2.0-UK', 'deprecated': False}, 'cc-by-nc-sa-2.5': {'id': 'CC-BY-NC-SA-2.5', 'deprecated': False}, 'cc-by-nc-sa-3.0': {'id': 'CC-BY-NC-SA-3.0', 'deprecated': False}, 'cc-by-nc-sa-3.0-de': {'id': 'CC-BY-NC-SA-3.0-DE', 'deprecated': False}, 'cc-by-nc-sa-3.0-igo': {'id': 'CC-BY-NC-SA-3.0-IGO', 'deprecated': False}, 'cc-by-nc-sa-4.0': {'id': 'CC-BY-NC-SA-4.0', 'deprecated': False}, 'cc-by-nd-1.0': {'id': 'CC-BY-ND-1.0', 'deprecated': False}, 'cc-by-nd-2.0': {'id': 'CC-BY-ND-2.0', 'deprecated': False}, 'cc-by-nd-2.5': {'id': 'CC-BY-ND-2.5', 'deprecated': False}, 'cc-by-nd-3.0': {'id': 'CC-BY-ND-3.0', 'deprecated': False}, 'cc-by-nd-3.0-de': {'id': 'CC-BY-ND-3.0-DE', 'deprecated': False}, 'cc-by-nd-4.0': {'id': 'CC-BY-ND-4.0', 'deprecated': False}, 'cc-by-sa-1.0': {'id': 'CC-BY-SA-1.0', 'deprecated': False}, 'cc-by-sa-2.0': {'id': 'CC-BY-SA-2.0', 'deprecated': False}, 'cc-by-sa-2.0-uk': {'id': 'CC-BY-SA-2.0-UK', 'deprecated': False}, 'cc-by-sa-2.1-jp': {'id': 'CC-BY-SA-2.1-JP', 'deprecated': False}, 'cc-by-sa-2.5': {'id': 'CC-BY-SA-2.5', 'deprecated': False}, 'cc-by-sa-3.0': {'id': 'CC-BY-SA-3.0', 'deprecated': False}, 'cc-by-sa-3.0-at': {'id': 'CC-BY-SA-3.0-AT', 'deprecated': False}, 'cc-by-sa-3.0-de': {'id': 'CC-BY-SA-3.0-DE', 'deprecated': False}, 'cc-by-sa-3.0-igo': {'id': 'CC-BY-SA-3.0-IGO', 'deprecated': False}, 'cc-by-sa-4.0': {'id': 'CC-BY-SA-4.0', 'deprecated': False}, 'cc-pddc': {'id': 'CC-PDDC', 'deprecated': False}, 'cc0-1.0': {'id': 'CC0-1.0', 'deprecated': False}, 'cddl-1.0': {'id': 'CDDL-1.0', 'deprecated': False}, 'cddl-1.1': {'id': 'CDDL-1.1', 'deprecated': False}, 'cdl-1.0': {'id': 'CDL-1.0', 'deprecated': False}, 'cdla-permissive-1.0': {'id': 'CDLA-Permissive-1.0', 'deprecated': False}, 'cdla-permissive-2.0': {'id': 'CDLA-Permissive-2.0', 'deprecated': False}, 'cdla-sharing-1.0': {'id': 'CDLA-Sharing-1.0', 'deprecated': False}, 'cecill-1.0': {'id': 'CECILL-1.0', 'deprecated': False}, 'cecill-1.1': {'id': 'CECILL-1.1', 'deprecated': False}, 'cecill-2.0': {'id': 'CECILL-2.0', 'deprecated': False}, 'cecill-2.1': {'id': 'CECILL-2.1', 'deprecated': False}, 'cecill-b': {'id': 'CECILL-B', 'deprecated': False}, 'cecill-c': {'id': 'CECILL-C', 'deprecated': False}, 'cern-ohl-1.1': {'id': 'CERN-OHL-1.1', 'deprecated': False}, 'cern-ohl-1.2': {'id': 'CERN-OHL-1.2', 'deprecated': False}, 'cern-ohl-p-2.0': {'id': 'CERN-OHL-P-2.0', 'deprecated': False}, 'cern-ohl-s-2.0': {'id': 'CERN-OHL-S-2.0', 'deprecated': False}, 'cern-ohl-w-2.0': {'id': 'CERN-OHL-W-2.0', 'deprecated': False}, 'cfitsio': {'id': 'CFITSIO', 'deprecated': False}, 'check-cvs': {'id': 'check-cvs', 'deprecated': False}, 'checkmk': {'id': 'checkmk', 'deprecated': False}, 'clartistic': {'id': 'ClArtistic', 'deprecated': False}, 'clips': {'id': 'Clips', 'deprecated': False}, 'cmu-mach': {'id': 'CMU-Mach', 'deprecated': False}, 'cmu-mach-nodoc': {'id': 'CMU-Mach-nodoc', 'deprecated': False}, 'cnri-jython': {'id': 'CNRI-Jython', 'deprecated': False}, 'cnri-python': {'id': 'CNRI-Python', 'deprecated': False}, 'cnri-python-gpl-compatible': {'id': 'CNRI-Python-GPL-Compatible', 'deprecated': False}, 'coil-1.0': {'id': 'COIL-1.0', 'deprecated': False}, 'community-spec-1.0': {'id': 'Community-Spec-1.0', 'deprecated': False}, 'condor-1.1': {'id': 'Condor-1.1', 'deprecated': False}, 'copyleft-next-0.3.0': {'id': 'copyleft-next-0.3.0', 'deprecated': False}, 'copyleft-next-0.3.1': {'id': 'copyleft-next-0.3.1', 'deprecated': False}, 'cornell-lossless-jpeg': {'id': 'Cornell-Lossless-JPEG', 'deprecated': False}, 'cpal-1.0': {'id': 'CPAL-1.0', 'deprecated': False}, 'cpl-1.0': {'id': 'CPL-1.0', 'deprecated': False}, 'cpol-1.02': {'id': 'CPOL-1.02', 'deprecated': False}, 'cronyx': {'id': 'Cronyx', 'deprecated': False}, 'crossword': {'id': 'Crossword', 'deprecated': False}, 'crystalstacker': {'id': 'CrystalStacker', 'deprecated': False}, 'cua-opl-1.0': {'id': 'CUA-OPL-1.0', 'deprecated': False}, 'cube': {'id': 'Cube', 'deprecated': False}, 'curl': {'id': 'curl', 'deprecated': False}, 'cve-tou': {'id': 'cve-tou', 'deprecated': False}, 'd-fsl-1.0': {'id': 'D-FSL-1.0', 'deprecated': False}, 'dec-3-clause': {'id': 'DEC-3-Clause', 'deprecated': False}, 'diffmark': {'id': 'diffmark', 'deprecated': False}, 'dl-de-by-2.0': {'id': 'DL-DE-BY-2.0', 'deprecated': False}, 'dl-de-zero-2.0': {'id': 'DL-DE-ZERO-2.0', 'deprecated': False}, 'doc': {'id': 'DOC', 'deprecated': False}, 'docbook-schema': {'id': 'DocBook-Schema', 'deprecated': False}, 'docbook-xml': {'id': 'DocBook-XML', 'deprecated': False}, 'dotseqn': {'id': 'Dotseqn', 'deprecated': False}, 'drl-1.0': {'id': 'DRL-1.0', 'deprecated': False}, 'drl-1.1': {'id': 'DRL-1.1', 'deprecated': False}, 'dsdp': {'id': 'DSDP', 'deprecated': False}, 'dtoa': {'id': 'dtoa', 'deprecated': False}, 'dvipdfm': {'id': 'dvipdfm', 'deprecated': False}, 'ecl-1.0': {'id': 'ECL-1.0', 'deprecated': False}, 'ecl-2.0': {'id': 'ECL-2.0', 'deprecated': False}, 'ecos-2.0': {'id': 'eCos-2.0', 'deprecated': True}, 'efl-1.0': {'id': 'EFL-1.0', 'deprecated': False}, 'efl-2.0': {'id': 'EFL-2.0', 'deprecated': False}, 'egenix': {'id': 'eGenix', 'deprecated': False}, 'elastic-2.0': {'id': 'Elastic-2.0', 'deprecated': False}, 'entessa': {'id': 'Entessa', 'deprecated': False}, 'epics': {'id': 'EPICS', 'deprecated': False}, 'epl-1.0': {'id': 'EPL-1.0', 'deprecated': False}, 'epl-2.0': {'id': 'EPL-2.0', 'deprecated': False}, 'erlpl-1.1': {'id': 'ErlPL-1.1', 'deprecated': False}, 'etalab-2.0': {'id': 'etalab-2.0', 'deprecated': False}, 'eudatagrid': {'id': 'EUDatagrid', 'deprecated': False}, 'eupl-1.0': {'id': 'EUPL-1.0', 'deprecated': False}, 'eupl-1.1': {'id': 'EUPL-1.1', 'deprecated': False}, 'eupl-1.2': {'id': 'EUPL-1.2', 'deprecated': False}, 'eurosym': {'id': 'Eurosym', 'deprecated': False}, 'fair': {'id': 'Fair', 'deprecated': False}, 'fbm': {'id': 'FBM', 'deprecated': False}, 'fdk-aac': {'id': 'FDK-AAC', 'deprecated': False}, 'ferguson-twofish': {'id': 'Ferguson-Twofish', 'deprecated': False}, 'frameworx-1.0': {'id': 'Frameworx-1.0', 'deprecated': False}, 'freebsd-doc': {'id': 'FreeBSD-DOC', 'deprecated': False}, 'freeimage': {'id': 'FreeImage', 'deprecated': False}, 'fsfap': {'id': 'FSFAP', 'deprecated': False}, 'fsfap-no-warranty-disclaimer': {'id': 'FSFAP-no-warranty-disclaimer', 'deprecated': False}, 'fsful': {'id': 'FSFUL', 'deprecated': False}, 'fsfullr': {'id': 'FSFULLR', 'deprecated': False}, 'fsfullrwd': {'id': 'FSFULLRWD', 'deprecated': False}, 'ftl': {'id': 'FTL', 'deprecated': False}, 'furuseth': {'id': 'Furuseth', 'deprecated': False}, 'fwlw': {'id': 'fwlw', 'deprecated': False}, 'gcr-docs': {'id': 'GCR-docs', 'deprecated': False}, 'gd': {'id': 'GD', 'deprecated': False}, 'gfdl-1.1': {'id': 'GFDL-1.1', 'deprecated': True}, 'gfdl-1.1-invariants-only': {'id': 'GFDL-1.1-invariants-only', 'deprecated': False}, 'gfdl-1.1-invariants-or-later': {'id': 'GFDL-1.1-invariants-or-later', 'deprecated': False}, 'gfdl-1.1-no-invariants-only': {'id': 'GFDL-1.1-no-invariants-only', 'deprecated': False}, 'gfdl-1.1-no-invariants-or-later': {'id': 'GFDL-1.1-no-invariants-or-later', 'deprecated': False}, 'gfdl-1.1-only': {'id': 'GFDL-1.1-only', 'deprecated': False}, 'gfdl-1.1-or-later': {'id': 'GFDL-1.1-or-later', 'deprecated': False}, 'gfdl-1.2': {'id': 'GFDL-1.2', 'deprecated': True}, 'gfdl-1.2-invariants-only': {'id': 'GFDL-1.2-invariants-only', 'deprecated': False}, 'gfdl-1.2-invariants-or-later': {'id': 'GFDL-1.2-invariants-or-later', 'deprecated': False}, 'gfdl-1.2-no-invariants-only': {'id': 'GFDL-1.2-no-invariants-only', 'deprecated': False}, 'gfdl-1.2-no-invariants-or-later': {'id': 'GFDL-1.2-no-invariants-or-later', 'deprecated': False}, 'gfdl-1.2-only': {'id': 'GFDL-1.2-only', 'deprecated': False}, 'gfdl-1.2-or-later': {'id': 'GFDL-1.2-or-later', 'deprecated': False}, 'gfdl-1.3': {'id': 'GFDL-1.3', 'deprecated': True}, 'gfdl-1.3-invariants-only': {'id': 'GFDL-1.3-invariants-only', 'deprecated': False}, 'gfdl-1.3-invariants-or-later': {'id': 'GFDL-1.3-invariants-or-later', 'deprecated': False}, 'gfdl-1.3-no-invariants-only': {'id': 'GFDL-1.3-no-invariants-only', 'deprecated': False}, 'gfdl-1.3-no-invariants-or-later': {'id': 'GFDL-1.3-no-invariants-or-later', 'deprecated': False}, 'gfdl-1.3-only': {'id': 'GFDL-1.3-only', 'deprecated': False}, 'gfdl-1.3-or-later': {'id': 'GFDL-1.3-or-later', 'deprecated': False}, 'giftware': {'id': 'Giftware', 'deprecated': False}, 'gl2ps': {'id': 'GL2PS', 'deprecated': False}, 'glide': {'id': 'Glide', 'deprecated': False}, 'glulxe': {'id': 'Glulxe', 'deprecated': False}, 'glwtpl': {'id': 'GLWTPL', 'deprecated': False}, 'gnuplot': {'id': 'gnuplot', 'deprecated': False}, 'gpl-1.0': {'id': 'GPL-1.0', 'deprecated': True}, 'gpl-1.0+': {'id': 'GPL-1.0+', 'deprecated': True}, 'gpl-1.0-only': {'id': 'GPL-1.0-only', 'deprecated': False}, 'gpl-1.0-or-later': {'id': 'GPL-1.0-or-later', 'deprecated': False}, 'gpl-2.0': {'id': 'GPL-2.0', 'deprecated': True}, 'gpl-2.0+': {'id': 'GPL-2.0+', 'deprecated': True}, 'gpl-2.0-only': {'id': 'GPL-2.0-only', 'deprecated': False}, 'gpl-2.0-or-later': {'id': 'GPL-2.0-or-later', 'deprecated': False}, 'gpl-2.0-with-autoconf-exception': {'id': 'GPL-2.0-with-autoconf-exception', 'deprecated': True}, 'gpl-2.0-with-bison-exception': {'id': 'GPL-2.0-with-bison-exception', 'deprecated': True}, 'gpl-2.0-with-classpath-exception': {'id': 'GPL-2.0-with-classpath-exception', 'deprecated': True}, 'gpl-2.0-with-font-exception': {'id': 'GPL-2.0-with-font-exception', 'deprecated': True}, 'gpl-2.0-with-gcc-exception': {'id': 'GPL-2.0-with-GCC-exception', 'deprecated': True}, 'gpl-3.0': {'id': 'GPL-3.0', 'deprecated': True}, 'gpl-3.0+': {'id': 'GPL-3.0+', 'deprecated': True}, 'gpl-3.0-only': {'id': 'GPL-3.0-only', 'deprecated': False}, 'gpl-3.0-or-later': {'id': 'GPL-3.0-or-later', 'deprecated': False}, 'gpl-3.0-with-autoconf-exception': {'id': 'GPL-3.0-with-autoconf-exception', 'deprecated': True}, 'gpl-3.0-with-gcc-exception': {'id': 'GPL-3.0-with-GCC-exception', 'deprecated': True}, 'graphics-gems': {'id': 'Graphics-Gems', 'deprecated': False}, 'gsoap-1.3b': {'id': 'gSOAP-1.3b', 'deprecated': False}, 'gtkbook': {'id': 'gtkbook', 'deprecated': False}, 'gutmann': {'id': 'Gutmann', 'deprecated': False}, 'haskellreport': {'id': 'HaskellReport', 'deprecated': False}, 'hdparm': {'id': 'hdparm', 'deprecated': False}, 'hidapi': {'id': 'HIDAPI', 'deprecated': False}, 'hippocratic-2.1': {'id': 'Hippocratic-2.1', 'deprecated': False}, 'hp-1986': {'id': 'HP-1986', 'deprecated': False}, 'hp-1989': {'id': 'HP-1989', 'deprecated': False}, 'hpnd': {'id': 'HPND', 'deprecated': False}, 'hpnd-dec': {'id': 'HPND-DEC', 'deprecated': False}, 'hpnd-doc': {'id': 'HPND-doc', 'deprecated': False}, 'hpnd-doc-sell': {'id': 'HPND-doc-sell', 'deprecated': False}, 'hpnd-export-us': {'id': 'HPND-export-US', 'deprecated': False}, 'hpnd-export-us-acknowledgement': {'id': 'HPND-export-US-acknowledgement', 'deprecated': False}, 'hpnd-export-us-modify': {'id': 'HPND-export-US-modify', 'deprecated': False}, 'hpnd-export2-us': {'id': 'HPND-export2-US', 'deprecated': False}, 'hpnd-fenneberg-livingston': {'id': 'HPND-Fenneberg-Livingston', 'deprecated': False}, 'hpnd-inria-imag': {'id': 'HPND-INRIA-IMAG', 'deprecated': False}, 'hpnd-intel': {'id': 'HPND-Intel', 'deprecated': False}, 'hpnd-kevlin-henney': {'id': 'HPND-Kevlin-Henney', 'deprecated': False}, 'hpnd-markus-kuhn': {'id': 'HPND-Markus-Kuhn', 'deprecated': False}, 'hpnd-merchantability-variant': {'id': 'HPND-merchantability-variant', 'deprecated': False}, 'hpnd-mit-disclaimer': {'id': 'HPND-MIT-disclaimer', 'deprecated': False}, 'hpnd-netrek': {'id': 'HPND-Netrek', 'deprecated': False}, 'hpnd-pbmplus': {'id': 'HPND-Pbmplus', 'deprecated': False}, 'hpnd-sell-mit-disclaimer-xserver': {'id': 'HPND-sell-MIT-disclaimer-xserver', 'deprecated': False}, 'hpnd-sell-regexpr': {'id': 'HPND-sell-regexpr', 'deprecated': False}, 'hpnd-sell-variant': {'id': 'HPND-sell-variant', 'deprecated': False}, 'hpnd-sell-variant-mit-disclaimer': {'id': 'HPND-sell-variant-MIT-disclaimer', 'deprecated': False}, 'hpnd-sell-variant-mit-disclaimer-rev': {'id': 'HPND-sell-variant-MIT-disclaimer-rev', 'deprecated': False}, 'hpnd-uc': {'id': 'HPND-UC', 'deprecated': False}, 'hpnd-uc-export-us': {'id': 'HPND-UC-export-US', 'deprecated': False}, 'htmltidy': {'id': 'HTMLTIDY', 'deprecated': False}, 'ibm-pibs': {'id': 'IBM-pibs', 'deprecated': False}, 'icu': {'id': 'ICU', 'deprecated': False}, 'iec-code-components-eula': {'id': 'IEC-Code-Components-EULA', 'deprecated': False}, 'ijg': {'id': 'IJG', 'deprecated': False}, 'ijg-short': {'id': 'IJG-short', 'deprecated': False}, 'imagemagick': {'id': 'ImageMagick', 'deprecated': False}, 'imatix': {'id': 'iMatix', 'deprecated': False}, 'imlib2': {'id': 'Imlib2', 'deprecated': False}, 'info-zip': {'id': 'Info-ZIP', 'deprecated': False}, 'inner-net-2.0': {'id': 'Inner-Net-2.0', 'deprecated': False}, 'intel': {'id': 'Intel', 'deprecated': False}, 'intel-acpi': {'id': 'Intel-ACPI', 'deprecated': False}, 'interbase-1.0': {'id': 'Interbase-1.0', 'deprecated': False}, 'ipa': {'id': 'IPA', 'deprecated': False}, 'ipl-1.0': {'id': 'IPL-1.0', 'deprecated': False}, 'isc': {'id': 'ISC', 'deprecated': False}, 'isc-veillard': {'id': 'ISC-Veillard', 'deprecated': False}, 'jam': {'id': 'Jam', 'deprecated': False}, 'jasper-2.0': {'id': 'JasPer-2.0', 'deprecated': False}, 'jpl-image': {'id': 'JPL-image', 'deprecated': False}, 'jpnic': {'id': 'JPNIC', 'deprecated': False}, 'json': {'id': 'JSON', 'deprecated': False}, 'kastrup': {'id': 'Kastrup', 'deprecated': False}, 'kazlib': {'id': 'Kazlib', 'deprecated': False}, 'knuth-ctan': {'id': 'Knuth-CTAN', 'deprecated': False}, 'lal-1.2': {'id': 'LAL-1.2', 'deprecated': False}, 'lal-1.3': {'id': 'LAL-1.3', 'deprecated': False}, 'latex2e': {'id': 'Latex2e', 'deprecated': False}, 'latex2e-translated-notice': {'id': 'Latex2e-translated-notice', 'deprecated': False}, 'leptonica': {'id': 'Leptonica', 'deprecated': False}, 'lgpl-2.0': {'id': 'LGPL-2.0', 'deprecated': True}, 'lgpl-2.0+': {'id': 'LGPL-2.0+', 'deprecated': True}, 'lgpl-2.0-only': {'id': 'LGPL-2.0-only', 'deprecated': False}, 'lgpl-2.0-or-later': {'id': 'LGPL-2.0-or-later', 'deprecated': False}, 'lgpl-2.1': {'id': 'LGPL-2.1', 'deprecated': True}, 'lgpl-2.1+': {'id': 'LGPL-2.1+', 'deprecated': True}, 'lgpl-2.1-only': {'id': 'LGPL-2.1-only', 'deprecated': False}, 'lgpl-2.1-or-later': {'id': 'LGPL-2.1-or-later', 'deprecated': False}, 'lgpl-3.0': {'id': 'LGPL-3.0', 'deprecated': True}, 'lgpl-3.0+': {'id': 'LGPL-3.0+', 'deprecated': True}, 'lgpl-3.0-only': {'id': 'LGPL-3.0-only', 'deprecated': False}, 'lgpl-3.0-or-later': {'id': 'LGPL-3.0-or-later', 'deprecated': False}, 'lgpllr': {'id': 'LGPLLR', 'deprecated': False}, 'libpng': {'id': 'Libpng', 'deprecated': False}, 'libpng-2.0': {'id': 'libpng-2.0', 'deprecated': False}, 'libselinux-1.0': {'id': 'libselinux-1.0', 'deprecated': False}, 'libtiff': {'id': 'libtiff', 'deprecated': False}, 'libutil-david-nugent': {'id': 'libutil-David-Nugent', 'deprecated': False}, 'liliq-p-1.1': {'id': 'LiLiQ-P-1.1', 'deprecated': False}, 'liliq-r-1.1': {'id': 'LiLiQ-R-1.1', 'deprecated': False}, 'liliq-rplus-1.1': {'id': 'LiLiQ-Rplus-1.1', 'deprecated': False}, 'linux-man-pages-1-para': {'id': 'Linux-man-pages-1-para', 'deprecated': False}, 'linux-man-pages-copyleft': {'id': 'Linux-man-pages-copyleft', 'deprecated': False}, 'linux-man-pages-copyleft-2-para': {'id': 'Linux-man-pages-copyleft-2-para', 'deprecated': False}, 'linux-man-pages-copyleft-var': {'id': 'Linux-man-pages-copyleft-var', 'deprecated': False}, 'linux-openib': {'id': 'Linux-OpenIB', 'deprecated': False}, 'loop': {'id': 'LOOP', 'deprecated': False}, 'lpd-document': {'id': 'LPD-document', 'deprecated': False}, 'lpl-1.0': {'id': 'LPL-1.0', 'deprecated': False}, 'lpl-1.02': {'id': 'LPL-1.02', 'deprecated': False}, 'lppl-1.0': {'id': 'LPPL-1.0', 'deprecated': False}, 'lppl-1.1': {'id': 'LPPL-1.1', 'deprecated': False}, 'lppl-1.2': {'id': 'LPPL-1.2', 'deprecated': False}, 'lppl-1.3a': {'id': 'LPPL-1.3a', 'deprecated': False}, 'lppl-1.3c': {'id': 'LPPL-1.3c', 'deprecated': False}, 'lsof': {'id': 'lsof', 'deprecated': False}, 'lucida-bitmap-fonts': {'id': 'Lucida-Bitmap-Fonts', 'deprecated': False}, 'lzma-sdk-9.11-to-9.20': {'id': 'LZMA-SDK-9.11-to-9.20', 'deprecated': False}, 'lzma-sdk-9.22': {'id': 'LZMA-SDK-9.22', 'deprecated': False}, 'mackerras-3-clause': {'id': 'Mackerras-3-Clause', 'deprecated': False}, 'mackerras-3-clause-acknowledgment': {'id': 'Mackerras-3-Clause-acknowledgment', 'deprecated': False}, 'magaz': {'id': 'magaz', 'deprecated': False}, 'mailprio': {'id': 'mailprio', 'deprecated': False}, 'makeindex': {'id': 'MakeIndex', 'deprecated': False}, 'martin-birgmeier': {'id': 'Martin-Birgmeier', 'deprecated': False}, 'mcphee-slideshow': {'id': 'McPhee-slideshow', 'deprecated': False}, 'metamail': {'id': 'metamail', 'deprecated': False}, 'minpack': {'id': 'Minpack', 'deprecated': False}, 'miros': {'id': 'MirOS', 'deprecated': False}, 'mit': {'id': 'MIT', 'deprecated': False}, 'mit-0': {'id': 'MIT-0', 'deprecated': False}, 'mit-advertising': {'id': 'MIT-advertising', 'deprecated': False}, 'mit-cmu': {'id': 'MIT-CMU', 'deprecated': False}, 'mit-enna': {'id': 'MIT-enna', 'deprecated': False}, 'mit-feh': {'id': 'MIT-feh', 'deprecated': False}, 'mit-festival': {'id': 'MIT-Festival', 'deprecated': False}, 'mit-khronos-old': {'id': 'MIT-Khronos-old', 'deprecated': False}, 'mit-modern-variant': {'id': 'MIT-Modern-Variant', 'deprecated': False}, 'mit-open-group': {'id': 'MIT-open-group', 'deprecated': False}, 'mit-testregex': {'id': 'MIT-testregex', 'deprecated': False}, 'mit-wu': {'id': 'MIT-Wu', 'deprecated': False}, 'mitnfa': {'id': 'MITNFA', 'deprecated': False}, 'mmixware': {'id': 'MMIXware', 'deprecated': False}, 'motosoto': {'id': 'Motosoto', 'deprecated': False}, 'mpeg-ssg': {'id': 'MPEG-SSG', 'deprecated': False}, 'mpi-permissive': {'id': 'mpi-permissive', 'deprecated': False}, 'mpich2': {'id': 'mpich2', 'deprecated': False}, 'mpl-1.0': {'id': 'MPL-1.0', 'deprecated': False}, 'mpl-1.1': {'id': 'MPL-1.1', 'deprecated': False}, 'mpl-2.0': {'id': 'MPL-2.0', 'deprecated': False}, 'mpl-2.0-no-copyleft-exception': {'id': 'MPL-2.0-no-copyleft-exception', 'deprecated': False}, 'mplus': {'id': 'mplus', 'deprecated': False}, 'ms-lpl': {'id': 'MS-LPL', 'deprecated': False}, 'ms-pl': {'id': 'MS-PL', 'deprecated': False}, 'ms-rl': {'id': 'MS-RL', 'deprecated': False}, 'mtll': {'id': 'MTLL', 'deprecated': False}, 'mulanpsl-1.0': {'id': 'MulanPSL-1.0', 'deprecated': False}, 'mulanpsl-2.0': {'id': 'MulanPSL-2.0', 'deprecated': False}, 'multics': {'id': 'Multics', 'deprecated': False}, 'mup': {'id': 'Mup', 'deprecated': False}, 'naist-2003': {'id': 'NAIST-2003', 'deprecated': False}, 'nasa-1.3': {'id': 'NASA-1.3', 'deprecated': False}, 'naumen': {'id': 'Naumen', 'deprecated': False}, 'nbpl-1.0': {'id': 'NBPL-1.0', 'deprecated': False}, 'ncbi-pd': {'id': 'NCBI-PD', 'deprecated': False}, 'ncgl-uk-2.0': {'id': 'NCGL-UK-2.0', 'deprecated': False}, 'ncl': {'id': 'NCL', 'deprecated': False}, 'ncsa': {'id': 'NCSA', 'deprecated': False}, 'net-snmp': {'id': 'Net-SNMP', 'deprecated': True}, 'netcdf': {'id': 'NetCDF', 'deprecated': False}, 'newsletr': {'id': 'Newsletr', 'deprecated': False}, 'ngpl': {'id': 'NGPL', 'deprecated': False}, 'nicta-1.0': {'id': 'NICTA-1.0', 'deprecated': False}, 'nist-pd': {'id': 'NIST-PD', 'deprecated': False}, 'nist-pd-fallback': {'id': 'NIST-PD-fallback', 'deprecated': False}, 'nist-software': {'id': 'NIST-Software', 'deprecated': False}, 'nlod-1.0': {'id': 'NLOD-1.0', 'deprecated': False}, 'nlod-2.0': {'id': 'NLOD-2.0', 'deprecated': False}, 'nlpl': {'id': 'NLPL', 'deprecated': False}, 'nokia': {'id': 'Nokia', 'deprecated': False}, 'nosl': {'id': 'NOSL', 'deprecated': False}, 'noweb': {'id': 'Noweb', 'deprecated': False}, 'npl-1.0': {'id': 'NPL-1.0', 'deprecated': False}, 'npl-1.1': {'id': 'NPL-1.1', 'deprecated': False}, 'nposl-3.0': {'id': 'NPOSL-3.0', 'deprecated': False}, 'nrl': {'id': 'NRL', 'deprecated': False}, 'ntp': {'id': 'NTP', 'deprecated': False}, 'ntp-0': {'id': 'NTP-0', 'deprecated': False}, 'nunit': {'id': 'Nunit', 'deprecated': True}, 'o-uda-1.0': {'id': 'O-UDA-1.0', 'deprecated': False}, 'oar': {'id': 'OAR', 'deprecated': False}, 'occt-pl': {'id': 'OCCT-PL', 'deprecated': False}, 'oclc-2.0': {'id': 'OCLC-2.0', 'deprecated': False}, 'odbl-1.0': {'id': 'ODbL-1.0', 'deprecated': False}, 'odc-by-1.0': {'id': 'ODC-By-1.0', 'deprecated': False}, 'offis': {'id': 'OFFIS', 'deprecated': False}, 'ofl-1.0': {'id': 'OFL-1.0', 'deprecated': False}, 'ofl-1.0-no-rfn': {'id': 'OFL-1.0-no-RFN', 'deprecated': False}, 'ofl-1.0-rfn': {'id': 'OFL-1.0-RFN', 'deprecated': False}, 'ofl-1.1': {'id': 'OFL-1.1', 'deprecated': False}, 'ofl-1.1-no-rfn': {'id': 'OFL-1.1-no-RFN', 'deprecated': False}, 'ofl-1.1-rfn': {'id': 'OFL-1.1-RFN', 'deprecated': False}, 'ogc-1.0': {'id': 'OGC-1.0', 'deprecated': False}, 'ogdl-taiwan-1.0': {'id': 'OGDL-Taiwan-1.0', 'deprecated': False}, 'ogl-canada-2.0': {'id': 'OGL-Canada-2.0', 'deprecated': False}, 'ogl-uk-1.0': {'id': 'OGL-UK-1.0', 'deprecated': False}, 'ogl-uk-2.0': {'id': 'OGL-UK-2.0', 'deprecated': False}, 'ogl-uk-3.0': {'id': 'OGL-UK-3.0', 'deprecated': False}, 'ogtsl': {'id': 'OGTSL', 'deprecated': False}, 'oldap-1.1': {'id': 'OLDAP-1.1', 'deprecated': False}, 'oldap-1.2': {'id': 'OLDAP-1.2', 'deprecated': False}, 'oldap-1.3': {'id': 'OLDAP-1.3', 'deprecated': False}, 'oldap-1.4': {'id': 'OLDAP-1.4', 'deprecated': False}, 'oldap-2.0': {'id': 'OLDAP-2.0', 'deprecated': False}, 'oldap-2.0.1': {'id': 'OLDAP-2.0.1', 'deprecated': False}, 'oldap-2.1': {'id': 'OLDAP-2.1', 'deprecated': False}, 'oldap-2.2': {'id': 'OLDAP-2.2', 'deprecated': False}, 'oldap-2.2.1': {'id': 'OLDAP-2.2.1', 'deprecated': False}, 'oldap-2.2.2': {'id': 'OLDAP-2.2.2', 'deprecated': False}, 'oldap-2.3': {'id': 'OLDAP-2.3', 'deprecated': False}, 'oldap-2.4': {'id': 'OLDAP-2.4', 'deprecated': False}, 'oldap-2.5': {'id': 'OLDAP-2.5', 'deprecated': False}, 'oldap-2.6': {'id': 'OLDAP-2.6', 'deprecated': False}, 'oldap-2.7': {'id': 'OLDAP-2.7', 'deprecated': False}, 'oldap-2.8': {'id': 'OLDAP-2.8', 'deprecated': False}, 'olfl-1.3': {'id': 'OLFL-1.3', 'deprecated': False}, 'oml': {'id': 'OML', 'deprecated': False}, 'openpbs-2.3': {'id': 'OpenPBS-2.3', 'deprecated': False}, 'openssl': {'id': 'OpenSSL', 'deprecated': False}, 'openssl-standalone': {'id': 'OpenSSL-standalone', 'deprecated': False}, 'openvision': {'id': 'OpenVision', 'deprecated': False}, 'opl-1.0': {'id': 'OPL-1.0', 'deprecated': False}, 'opl-uk-3.0': {'id': 'OPL-UK-3.0', 'deprecated': False}, 'opubl-1.0': {'id': 'OPUBL-1.0', 'deprecated': False}, 'oset-pl-2.1': {'id': 'OSET-PL-2.1', 'deprecated': False}, 'osl-1.0': {'id': 'OSL-1.0', 'deprecated': False}, 'osl-1.1': {'id': 'OSL-1.1', 'deprecated': False}, 'osl-2.0': {'id': 'OSL-2.0', 'deprecated': False}, 'osl-2.1': {'id': 'OSL-2.1', 'deprecated': False}, 'osl-3.0': {'id': 'OSL-3.0', 'deprecated': False}, 'padl': {'id': 'PADL', 'deprecated': False}, 'parity-6.0.0': {'id': 'Parity-6.0.0', 'deprecated': False}, 'parity-7.0.0': {'id': 'Parity-7.0.0', 'deprecated': False}, 'pddl-1.0': {'id': 'PDDL-1.0', 'deprecated': False}, 'php-3.0': {'id': 'PHP-3.0', 'deprecated': False}, 'php-3.01': {'id': 'PHP-3.01', 'deprecated': False}, 'pixar': {'id': 'Pixar', 'deprecated': False}, 'pkgconf': {'id': 'pkgconf', 'deprecated': False}, 'plexus': {'id': 'Plexus', 'deprecated': False}, 'pnmstitch': {'id': 'pnmstitch', 'deprecated': False}, 'polyform-noncommercial-1.0.0': {'id': 'PolyForm-Noncommercial-1.0.0', 'deprecated': False}, 'polyform-small-business-1.0.0': {'id': 'PolyForm-Small-Business-1.0.0', 'deprecated': False}, 'postgresql': {'id': 'PostgreSQL', 'deprecated': False}, 'ppl': {'id': 'PPL', 'deprecated': False}, 'psf-2.0': {'id': 'PSF-2.0', 'deprecated': False}, 'psfrag': {'id': 'psfrag', 'deprecated': False}, 'psutils': {'id': 'psutils', 'deprecated': False}, 'python-2.0': {'id': 'Python-2.0', 'deprecated': False}, 'python-2.0.1': {'id': 'Python-2.0.1', 'deprecated': False}, 'python-ldap': {'id': 'python-ldap', 'deprecated': False}, 'qhull': {'id': 'Qhull', 'deprecated': False}, 'qpl-1.0': {'id': 'QPL-1.0', 'deprecated': False}, 'qpl-1.0-inria-2004': {'id': 'QPL-1.0-INRIA-2004', 'deprecated': False}, 'radvd': {'id': 'radvd', 'deprecated': False}, 'rdisc': {'id': 'Rdisc', 'deprecated': False}, 'rhecos-1.1': {'id': 'RHeCos-1.1', 'deprecated': False}, 'rpl-1.1': {'id': 'RPL-1.1', 'deprecated': False}, 'rpl-1.5': {'id': 'RPL-1.5', 'deprecated': False}, 'rpsl-1.0': {'id': 'RPSL-1.0', 'deprecated': False}, 'rsa-md': {'id': 'RSA-MD', 'deprecated': False}, 'rscpl': {'id': 'RSCPL', 'deprecated': False}, 'ruby': {'id': 'Ruby', 'deprecated': False}, 'ruby-pty': {'id': 'Ruby-pty', 'deprecated': False}, 'sax-pd': {'id': 'SAX-PD', 'deprecated': False}, 'sax-pd-2.0': {'id': 'SAX-PD-2.0', 'deprecated': False}, 'saxpath': {'id': 'Saxpath', 'deprecated': False}, 'scea': {'id': 'SCEA', 'deprecated': False}, 'schemereport': {'id': 'SchemeReport', 'deprecated': False}, 'sendmail': {'id': 'Sendmail', 'deprecated': False}, 'sendmail-8.23': {'id': 'Sendmail-8.23', 'deprecated': False}, 'sgi-b-1.0': {'id': 'SGI-B-1.0', 'deprecated': False}, 'sgi-b-1.1': {'id': 'SGI-B-1.1', 'deprecated': False}, 'sgi-b-2.0': {'id': 'SGI-B-2.0', 'deprecated': False}, 'sgi-opengl': {'id': 'SGI-OpenGL', 'deprecated': False}, 'sgp4': {'id': 'SGP4', 'deprecated': False}, 'shl-0.5': {'id': 'SHL-0.5', 'deprecated': False}, 'shl-0.51': {'id': 'SHL-0.51', 'deprecated': False}, 'simpl-2.0': {'id': 'SimPL-2.0', 'deprecated': False}, 'sissl': {'id': 'SISSL', 'deprecated': False}, 'sissl-1.2': {'id': 'SISSL-1.2', 'deprecated': False}, 'sl': {'id': 'SL', 'deprecated': False}, 'sleepycat': {'id': 'Sleepycat', 'deprecated': False}, 'smlnj': {'id': 'SMLNJ', 'deprecated': False}, 'smppl': {'id': 'SMPPL', 'deprecated': False}, 'snia': {'id': 'SNIA', 'deprecated': False}, 'snprintf': {'id': 'snprintf', 'deprecated': False}, 'softsurfer': {'id': 'softSurfer', 'deprecated': False}, 'soundex': {'id': 'Soundex', 'deprecated': False}, 'spencer-86': {'id': 'Spencer-86', 'deprecated': False}, 'spencer-94': {'id': 'Spencer-94', 'deprecated': False}, 'spencer-99': {'id': 'Spencer-99', 'deprecated': False}, 'spl-1.0': {'id': 'SPL-1.0', 'deprecated': False}, 'ssh-keyscan': {'id': 'ssh-keyscan', 'deprecated': False}, 'ssh-openssh': {'id': 'SSH-OpenSSH', 'deprecated': False}, 'ssh-short': {'id': 'SSH-short', 'deprecated': False}, 'ssleay-standalone': {'id': 'SSLeay-standalone', 'deprecated': False}, 'sspl-1.0': {'id': 'SSPL-1.0', 'deprecated': False}, 'standardml-nj': {'id': 'StandardML-NJ', 'deprecated': True}, 'sugarcrm-1.1.3': {'id': 'SugarCRM-1.1.3', 'deprecated': False}, 'sun-ppp': {'id': 'Sun-PPP', 'deprecated': False}, 'sun-ppp-2000': {'id': 'Sun-PPP-2000', 'deprecated': False}, 'sunpro': {'id': 'SunPro', 'deprecated': False}, 'swl': {'id': 'SWL', 'deprecated': False}, 'swrule': {'id': 'swrule', 'deprecated': False}, 'symlinks': {'id': 'Symlinks', 'deprecated': False}, 'tapr-ohl-1.0': {'id': 'TAPR-OHL-1.0', 'deprecated': False}, 'tcl': {'id': 'TCL', 'deprecated': False}, 'tcp-wrappers': {'id': 'TCP-wrappers', 'deprecated': False}, 'termreadkey': {'id': 'TermReadKey', 'deprecated': False}, 'tgppl-1.0': {'id': 'TGPPL-1.0', 'deprecated': False}, 'threeparttable': {'id': 'threeparttable', 'deprecated': False}, 'tmate': {'id': 'TMate', 'deprecated': False}, 'torque-1.1': {'id': 'TORQUE-1.1', 'deprecated': False}, 'tosl': {'id': 'TOSL', 'deprecated': False}, 'tpdl': {'id': 'TPDL', 'deprecated': False}, 'tpl-1.0': {'id': 'TPL-1.0', 'deprecated': False}, 'ttwl': {'id': 'TTWL', 'deprecated': False}, 'ttyp0': {'id': 'TTYP0', 'deprecated': False}, 'tu-berlin-1.0': {'id': 'TU-Berlin-1.0', 'deprecated': False}, 'tu-berlin-2.0': {'id': 'TU-Berlin-2.0', 'deprecated': False}, 'ubuntu-font-1.0': {'id': 'Ubuntu-font-1.0', 'deprecated': False}, 'ucar': {'id': 'UCAR', 'deprecated': False}, 'ucl-1.0': {'id': 'UCL-1.0', 'deprecated': False}, 'ulem': {'id': 'ulem', 'deprecated': False}, 'umich-merit': {'id': 'UMich-Merit', 'deprecated': False}, 'unicode-3.0': {'id': 'Unicode-3.0', 'deprecated': False}, 'unicode-dfs-2015': {'id': 'Unicode-DFS-2015', 'deprecated': False}, 'unicode-dfs-2016': {'id': 'Unicode-DFS-2016', 'deprecated': False}, 'unicode-tou': {'id': 'Unicode-TOU', 'deprecated': False}, 'unixcrypt': {'id': 'UnixCrypt', 'deprecated': False}, 'unlicense': {'id': 'Unlicense', 'deprecated': False}, 'upl-1.0': {'id': 'UPL-1.0', 'deprecated': False}, 'urt-rle': {'id': 'URT-RLE', 'deprecated': False}, 'vim': {'id': 'Vim', 'deprecated': False}, 'vostrom': {'id': 'VOSTROM', 'deprecated': False}, 'vsl-1.0': {'id': 'VSL-1.0', 'deprecated': False}, 'w3c': {'id': 'W3C', 'deprecated': False}, 'w3c-19980720': {'id': 'W3C-19980720', 'deprecated': False}, 'w3c-20150513': {'id': 'W3C-20150513', 'deprecated': False}, 'w3m': {'id': 'w3m', 'deprecated': False}, 'watcom-1.0': {'id': 'Watcom-1.0', 'deprecated': False}, 'widget-workshop': {'id': 'Widget-Workshop', 'deprecated': False}, 'wsuipa': {'id': 'Wsuipa', 'deprecated': False}, 'wtfpl': {'id': 'WTFPL', 'deprecated': False}, 'wxwindows': {'id': 'wxWindows', 'deprecated': True}, 'x11': {'id': 'X11', 'deprecated': False}, 'x11-distribute-modifications-variant': {'id': 'X11-distribute-modifications-variant', 'deprecated': False}, 'x11-swapped': {'id': 'X11-swapped', 'deprecated': False}, 'xdebug-1.03': {'id': 'Xdebug-1.03', 'deprecated': False}, 'xerox': {'id': 'Xerox', 'deprecated': False}, 'xfig': {'id': 'Xfig', 'deprecated': False}, 'xfree86-1.1': {'id': 'XFree86-1.1', 'deprecated': False}, 'xinetd': {'id': 'xinetd', 'deprecated': False}, 'xkeyboard-config-zinoviev': {'id': 'xkeyboard-config-Zinoviev', 'deprecated': False}, 'xlock': {'id': 'xlock', 'deprecated': False}, 'xnet': {'id': 'Xnet', 'deprecated': False}, 'xpp': {'id': 'xpp', 'deprecated': False}, 'xskat': {'id': 'XSkat', 'deprecated': False}, 'xzoom': {'id': 'xzoom', 'deprecated': False}, 'ypl-1.0': {'id': 'YPL-1.0', 'deprecated': False}, 'ypl-1.1': {'id': 'YPL-1.1', 'deprecated': False}, 'zed': {'id': 'Zed', 'deprecated': False}, 'zeeff': {'id': 'Zeeff', 'deprecated': False}, 'zend-2.0': {'id': 'Zend-2.0', 'deprecated': False}, 'zimbra-1.3': {'id': 'Zimbra-1.3', 'deprecated': False}, 'zimbra-1.4': {'id': 'Zimbra-1.4', 'deprecated': False}, 'zlib': {'id': 'Zlib', 'deprecated': False}, 'zlib-acknowledgement': {'id': 'zlib-acknowledgement', 'deprecated': False}, 'zpl-1.1': {'id': 'ZPL-1.1', 'deprecated': False}, 'zpl-2.0': {'id': 'ZPL-2.0', 'deprecated': False}, 'zpl-2.1': {'id': 'ZPL-2.1', 'deprecated': False}, } EXCEPTIONS: dict[str, SPDXException] = { '389-exception': {'id': '389-exception', 'deprecated': False}, 'asterisk-exception': {'id': 'Asterisk-exception', 'deprecated': False}, 'asterisk-linking-protocols-exception': {'id': 'Asterisk-linking-protocols-exception', 'deprecated': False}, 'autoconf-exception-2.0': {'id': 'Autoconf-exception-2.0', 'deprecated': False}, 'autoconf-exception-3.0': {'id': 'Autoconf-exception-3.0', 'deprecated': False}, 'autoconf-exception-generic': {'id': 'Autoconf-exception-generic', 'deprecated': False}, 'autoconf-exception-generic-3.0': {'id': 'Autoconf-exception-generic-3.0', 'deprecated': False}, 'autoconf-exception-macro': {'id': 'Autoconf-exception-macro', 'deprecated': False}, 'bison-exception-1.24': {'id': 'Bison-exception-1.24', 'deprecated': False}, 'bison-exception-2.2': {'id': 'Bison-exception-2.2', 'deprecated': False}, 'bootloader-exception': {'id': 'Bootloader-exception', 'deprecated': False}, 'classpath-exception-2.0': {'id': 'Classpath-exception-2.0', 'deprecated': False}, 'clisp-exception-2.0': {'id': 'CLISP-exception-2.0', 'deprecated': False}, 'cryptsetup-openssl-exception': {'id': 'cryptsetup-OpenSSL-exception', 'deprecated': False}, 'digirule-foss-exception': {'id': 'DigiRule-FOSS-exception', 'deprecated': False}, 'ecos-exception-2.0': {'id': 'eCos-exception-2.0', 'deprecated': False}, 'erlang-otp-linking-exception': {'id': 'erlang-otp-linking-exception', 'deprecated': False}, 'fawkes-runtime-exception': {'id': 'Fawkes-Runtime-exception', 'deprecated': False}, 'fltk-exception': {'id': 'FLTK-exception', 'deprecated': False}, 'fmt-exception': {'id': 'fmt-exception', 'deprecated': False}, 'font-exception-2.0': {'id': 'Font-exception-2.0', 'deprecated': False}, 'freertos-exception-2.0': {'id': 'freertos-exception-2.0', 'deprecated': False}, 'gcc-exception-2.0': {'id': 'GCC-exception-2.0', 'deprecated': False}, 'gcc-exception-2.0-note': {'id': 'GCC-exception-2.0-note', 'deprecated': False}, 'gcc-exception-3.1': {'id': 'GCC-exception-3.1', 'deprecated': False}, 'gmsh-exception': {'id': 'Gmsh-exception', 'deprecated': False}, 'gnat-exception': {'id': 'GNAT-exception', 'deprecated': False}, 'gnome-examples-exception': {'id': 'GNOME-examples-exception', 'deprecated': False}, 'gnu-compiler-exception': {'id': 'GNU-compiler-exception', 'deprecated': False}, 'gnu-javamail-exception': {'id': 'gnu-javamail-exception', 'deprecated': False}, 'gpl-3.0-interface-exception': {'id': 'GPL-3.0-interface-exception', 'deprecated': False}, 'gpl-3.0-linking-exception': {'id': 'GPL-3.0-linking-exception', 'deprecated': False}, 'gpl-3.0-linking-source-exception': {'id': 'GPL-3.0-linking-source-exception', 'deprecated': False}, 'gpl-cc-1.0': {'id': 'GPL-CC-1.0', 'deprecated': False}, 'gstreamer-exception-2005': {'id': 'GStreamer-exception-2005', 'deprecated': False}, 'gstreamer-exception-2008': {'id': 'GStreamer-exception-2008', 'deprecated': False}, 'i2p-gpl-java-exception': {'id': 'i2p-gpl-java-exception', 'deprecated': False}, 'kicad-libraries-exception': {'id': 'KiCad-libraries-exception', 'deprecated': False}, 'lgpl-3.0-linking-exception': {'id': 'LGPL-3.0-linking-exception', 'deprecated': False}, 'libpri-openh323-exception': {'id': 'libpri-OpenH323-exception', 'deprecated': False}, 'libtool-exception': {'id': 'Libtool-exception', 'deprecated': False}, 'linux-syscall-note': {'id': 'Linux-syscall-note', 'deprecated': False}, 'llgpl': {'id': 'LLGPL', 'deprecated': False}, 'llvm-exception': {'id': 'LLVM-exception', 'deprecated': False}, 'lzma-exception': {'id': 'LZMA-exception', 'deprecated': False}, 'mif-exception': {'id': 'mif-exception', 'deprecated': False}, 'nokia-qt-exception-1.1': {'id': 'Nokia-Qt-exception-1.1', 'deprecated': True}, 'ocaml-lgpl-linking-exception': {'id': 'OCaml-LGPL-linking-exception', 'deprecated': False}, 'occt-exception-1.0': {'id': 'OCCT-exception-1.0', 'deprecated': False}, 'openjdk-assembly-exception-1.0': {'id': 'OpenJDK-assembly-exception-1.0', 'deprecated': False}, 'openvpn-openssl-exception': {'id': 'openvpn-openssl-exception', 'deprecated': False}, 'pcre2-exception': {'id': 'PCRE2-exception', 'deprecated': False}, 'ps-or-pdf-font-exception-20170817': {'id': 'PS-or-PDF-font-exception-20170817', 'deprecated': False}, 'qpl-1.0-inria-2004-exception': {'id': 'QPL-1.0-INRIA-2004-exception', 'deprecated': False}, 'qt-gpl-exception-1.0': {'id': 'Qt-GPL-exception-1.0', 'deprecated': False}, 'qt-lgpl-exception-1.1': {'id': 'Qt-LGPL-exception-1.1', 'deprecated': False}, 'qwt-exception-1.0': {'id': 'Qwt-exception-1.0', 'deprecated': False}, 'romic-exception': {'id': 'romic-exception', 'deprecated': False}, 'rrdtool-floss-exception-2.0': {'id': 'RRDtool-FLOSS-exception-2.0', 'deprecated': False}, 'sane-exception': {'id': 'SANE-exception', 'deprecated': False}, 'shl-2.0': {'id': 'SHL-2.0', 'deprecated': False}, 'shl-2.1': {'id': 'SHL-2.1', 'deprecated': False}, 'stunnel-exception': {'id': 'stunnel-exception', 'deprecated': False}, 'swi-exception': {'id': 'SWI-exception', 'deprecated': False}, 'swift-exception': {'id': 'Swift-exception', 'deprecated': False}, 'texinfo-exception': {'id': 'Texinfo-exception', 'deprecated': False}, 'u-boot-exception-2.0': {'id': 'u-boot-exception-2.0', 'deprecated': False}, 'ubdl-exception': {'id': 'UBDL-exception', 'deprecated': False}, 'universal-foss-exception-1.0': {'id': 'Universal-FOSS-exception-1.0', 'deprecated': False}, 'vsftpd-openssl-exception': {'id': 'vsftpd-openssl-exception', 'deprecated': False}, 'wxwindows-exception-3.1': {'id': 'WxWindows-exception-3.1', 'deprecated': False}, 'x11vnc-openssl-exception': {'id': 'x11vnc-openssl-exception', 'deprecated': False}, } _vendor/packaging/licenses/__init__.py 0000644 00000013123 15030122015 0014027 0 ustar 00 ####################################################################################### # # Adapted from: # https://github.com/pypa/hatch/blob/5352e44/backend/src/hatchling/licenses/parse.py # # MIT License # # Copyright (c) 2017-present Ofek Lev <oss@ofek.dev> # # Permission is hereby granted, free of charge, to any person obtaining a copy of this # software and associated documentation files (the "Software"), to deal in the Software # without restriction, including without limitation the rights to use, copy, modify, # merge, publish, distribute, sublicense, and/or sell copies of the Software, and to # permit persons to whom the Software is furnished to do so, subject to the following # conditions: # # The above copyright notice and this permission notice shall be included in all copies # or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, # INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A # PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT # HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF # CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE # OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # # # With additional allowance of arbitrary `LicenseRef-` identifiers, not just # `LicenseRef-Public-Domain` and `LicenseRef-Proprietary`. # ####################################################################################### from __future__ import annotations import re from typing import NewType, cast from packaging.licenses._spdx import EXCEPTIONS, LICENSES __all__ = [ "NormalizedLicenseExpression", "InvalidLicenseExpression", "canonicalize_license_expression", ] license_ref_allowed = re.compile("^[A-Za-z0-9.-]*$") NormalizedLicenseExpression = NewType("NormalizedLicenseExpression", str) class InvalidLicenseExpression(ValueError): """Raised when a license-expression string is invalid >>> canonicalize_license_expression("invalid") Traceback (most recent call last): ... packaging.licenses.InvalidLicenseExpression: Invalid license expression: 'invalid' """ def canonicalize_license_expression( raw_license_expression: str, ) -> NormalizedLicenseExpression: if not raw_license_expression: message = f"Invalid license expression: {raw_license_expression!r}" raise InvalidLicenseExpression(message) # Pad any parentheses so tokenization can be achieved by merely splitting on # whitespace. license_expression = raw_license_expression.replace("(", " ( ").replace(")", " ) ") licenseref_prefix = "LicenseRef-" license_refs = { ref.lower(): "LicenseRef-" + ref[len(licenseref_prefix) :] for ref in license_expression.split() if ref.lower().startswith(licenseref_prefix.lower()) } # Normalize to lower case so we can look up licenses/exceptions # and so boolean operators are Python-compatible. license_expression = license_expression.lower() tokens = license_expression.split() # Rather than implementing boolean logic, we create an expression that Python can # parse. Everything that is not involved with the grammar itself is treated as # `False` and the expression should evaluate as such. python_tokens = [] for token in tokens: if token not in {"or", "and", "with", "(", ")"}: python_tokens.append("False") elif token == "with": python_tokens.append("or") elif token == "(" and python_tokens and python_tokens[-1] not in {"or", "and"}: message = f"Invalid license expression: {raw_license_expression!r}" raise InvalidLicenseExpression(message) else: python_tokens.append(token) python_expression = " ".join(python_tokens) try: invalid = eval(python_expression, globals(), locals()) except Exception: invalid = True if invalid is not False: message = f"Invalid license expression: {raw_license_expression!r}" raise InvalidLicenseExpression(message) from None # Take a final pass to check for unknown licenses/exceptions. normalized_tokens = [] for token in tokens: if token in {"or", "and", "with", "(", ")"}: normalized_tokens.append(token.upper()) continue if normalized_tokens and normalized_tokens[-1] == "WITH": if token not in EXCEPTIONS: message = f"Unknown license exception: {token!r}" raise InvalidLicenseExpression(message) normalized_tokens.append(EXCEPTIONS[token]["id"]) else: if token.endswith("+"): final_token = token[:-1] suffix = "+" else: final_token = token suffix = "" if final_token.startswith("licenseref-"): if not license_ref_allowed.match(final_token): message = f"Invalid licenseref: {final_token!r}" raise InvalidLicenseExpression(message) normalized_tokens.append(license_refs[final_token] + suffix) else: if final_token not in LICENSES: message = f"Unknown license: {final_token!r}" raise InvalidLicenseExpression(message) normalized_tokens.append(LICENSES[final_token]["id"] + suffix) normalized_expression = " ".join(normalized_tokens) return cast( NormalizedLicenseExpression, normalized_expression.replace("( ", "(").replace(" )", ")"), ) _vendor/packaging/py.typed 0000644 00000000000 15030122015 0011576 0 ustar 00 _vendor/packaging/_structures.py 0000644 00000002627 15030122015 0013054 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. class InfinityType: def __repr__(self) -> str: return "Infinity" def __hash__(self) -> int: return hash(repr(self)) def __lt__(self, other: object) -> bool: return False def __le__(self, other: object) -> bool: return False def __eq__(self, other: object) -> bool: return isinstance(other, self.__class__) def __gt__(self, other: object) -> bool: return True def __ge__(self, other: object) -> bool: return True def __neg__(self: object) -> "NegativeInfinityType": return NegativeInfinity Infinity = InfinityType() class NegativeInfinityType: def __repr__(self) -> str: return "-Infinity" def __hash__(self) -> int: return hash(repr(self)) def __lt__(self, other: object) -> bool: return True def __le__(self, other: object) -> bool: return True def __eq__(self, other: object) -> bool: return isinstance(other, self.__class__) def __gt__(self, other: object) -> bool: return False def __ge__(self, other: object) -> bool: return False def __neg__(self: object) -> InfinityType: return Infinity NegativeInfinity = NegativeInfinityType() _vendor/packaging/version.py 0000644 00000040444 15030122015 0012156 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. """ .. testsetup:: from packaging.version import parse, Version """ from __future__ import annotations import itertools import re from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType __all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "parse"] LocalType = Tuple[Union[int, str], ...] CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] CmpLocalType = Union[ NegativeInfinityType, Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], ] CmpKey = Tuple[ int, Tuple[int, ...], CmpPrePostDevType, CmpPrePostDevType, CmpPrePostDevType, CmpLocalType, ] VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] class _Version(NamedTuple): epoch: int release: tuple[int, ...] dev: tuple[str, int] | None pre: tuple[str, int] | None post: tuple[str, int] | None local: LocalType | None def parse(version: str) -> Version: """Parse the given version string. >>> parse('1.0.dev1') <Version('1.0.dev1')> :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. """ return Version(version) class InvalidVersion(ValueError): """Raised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' """ class _BaseVersion: _key: tuple[Any, ...] def __hash__(self) -> int: return hash(self._key) # Please keep the duplicated `isinstance` check # in the six comparisons hereunder # unless you find a way to avoid adding overhead function calls. def __lt__(self, other: _BaseVersion) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key < other._key def __le__(self, other: _BaseVersion) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key <= other._key def __eq__(self, other: object) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key == other._key def __ge__(self, other: _BaseVersion) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key >= other._key def __gt__(self, other: _BaseVersion) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key > other._key def __ne__(self, other: object) -> bool: if not isinstance(other, _BaseVersion): return NotImplemented return self._key != other._key # Deliberately not anchored to the start and end of the string, to make it # easier for 3rd party code to reuse _VERSION_PATTERN = r""" v? (?: (?:(?P<epoch>[0-9]+)!)? # epoch (?P<release>[0-9]+(?:\.[0-9]+)*) # release segment (?P<pre> # pre-release [-_\.]? (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc) [-_\.]? (?P<pre_n>[0-9]+)? )? (?P<post> # post release (?:-(?P<post_n1>[0-9]+)) | (?: [-_\.]? (?P<post_l>post|rev|r) [-_\.]? (?P<post_n2>[0-9]+)? ) )? (?P<dev> # dev release [-_\.]? (?P<dev_l>dev) [-_\.]? (?P<dev_n>[0-9]+)? )? ) (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version """ VERSION_PATTERN = _VERSION_PATTERN """ A string containing the regular expression used to match a valid version. The pattern is not anchored at either end, and is intended for embedding in larger expressions (for example, matching a version number as part of a file name). The regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE`` flags set. :meta hide-value: """ class Version(_BaseVersion): """This class abstracts handling of a project's versions. A :class:`Version` instance is comparison aware and can be compared and sorted using the standard Python interfaces. >>> v1 = Version("1.0a5") >>> v2 = Version("1.0") >>> v1 <Version('1.0a5')> >>> v2 <Version('1.0')> >>> v1 < v2 True >>> v1 == v2 False >>> v1 > v2 False >>> v1 >= v2 False >>> v1 <= v2 True """ _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE) _key: CmpKey def __init__(self, version: str) -> None: """Initialize a Version object. :param version: The string representation of a version which will be parsed and normalized before use. :raises InvalidVersion: If the ``version`` does not conform to PEP 440 in any way then this exception will be raised. """ # Validate the version and parse it into pieces match = self._regex.search(version) if not match: raise InvalidVersion(f"Invalid version: {version!r}") # Store the parsed out pieces of the version self._version = _Version( epoch=int(match.group("epoch")) if match.group("epoch") else 0, release=tuple(int(i) for i in match.group("release").split(".")), pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")), post=_parse_letter_version( match.group("post_l"), match.group("post_n1") or match.group("post_n2") ), dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")), local=_parse_local_version(match.group("local")), ) # Generate a key which will be used for sorting self._key = _cmpkey( self._version.epoch, self._version.release, self._version.pre, self._version.post, self._version.dev, self._version.local, ) def __repr__(self) -> str: """A representation of the Version that shows all internal state. >>> Version('1.0.0') <Version('1.0.0')> """ return f"<Version('{self}')>" def __str__(self) -> str: """A string representation of the version that can be round-tripped. >>> str(Version("1.0a5")) '1.0a5' """ parts = [] # Epoch if self.epoch != 0: parts.append(f"{self.epoch}!") # Release segment parts.append(".".join(str(x) for x in self.release)) # Pre-release if self.pre is not None: parts.append("".join(str(x) for x in self.pre)) # Post-release if self.post is not None: parts.append(f".post{self.post}") # Development release if self.dev is not None: parts.append(f".dev{self.dev}") # Local version segment if self.local is not None: parts.append(f"+{self.local}") return "".join(parts) @property def epoch(self) -> int: """The epoch of the version. >>> Version("2.0.0").epoch 0 >>> Version("1!2.0.0").epoch 1 """ return self._version.epoch @property def release(self) -> tuple[int, ...]: """The components of the "release" segment of the version. >>> Version("1.2.3").release (1, 2, 3) >>> Version("2.0.0").release (2, 0, 0) >>> Version("1!2.0.0.post0").release (2, 0, 0) Includes trailing zeroes but not the epoch or any pre-release / development / post-release suffixes. """ return self._version.release @property def pre(self) -> tuple[str, int] | None: """The pre-release segment of the version. >>> print(Version("1.2.3").pre) None >>> Version("1.2.3a1").pre ('a', 1) >>> Version("1.2.3b1").pre ('b', 1) >>> Version("1.2.3rc1").pre ('rc', 1) """ return self._version.pre @property def post(self) -> int | None: """The post-release number of the version. >>> print(Version("1.2.3").post) None >>> Version("1.2.3.post1").post 1 """ return self._version.post[1] if self._version.post else None @property def dev(self) -> int | None: """The development number of the version. >>> print(Version("1.2.3").dev) None >>> Version("1.2.3.dev1").dev 1 """ return self._version.dev[1] if self._version.dev else None @property def local(self) -> str | None: """The local version segment of the version. >>> print(Version("1.2.3").local) None >>> Version("1.2.3+abc").local 'abc' """ if self._version.local: return ".".join(str(x) for x in self._version.local) else: return None @property def public(self) -> str: """The public portion of the version. >>> Version("1.2.3").public '1.2.3' >>> Version("1.2.3+abc").public '1.2.3' >>> Version("1!1.2.3dev1+abc").public '1!1.2.3.dev1' """ return str(self).split("+", 1)[0] @property def base_version(self) -> str: """The "base version" of the version. >>> Version("1.2.3").base_version '1.2.3' >>> Version("1.2.3+abc").base_version '1.2.3' >>> Version("1!1.2.3dev1+abc").base_version '1!1.2.3' The "base version" is the public version of the project without any pre or post release markers. """ parts = [] # Epoch if self.epoch != 0: parts.append(f"{self.epoch}!") # Release segment parts.append(".".join(str(x) for x in self.release)) return "".join(parts) @property def is_prerelease(self) -> bool: """Whether this version is a pre-release. >>> Version("1.2.3").is_prerelease False >>> Version("1.2.3a1").is_prerelease True >>> Version("1.2.3b1").is_prerelease True >>> Version("1.2.3rc1").is_prerelease True >>> Version("1.2.3dev1").is_prerelease True """ return self.dev is not None or self.pre is not None @property def is_postrelease(self) -> bool: """Whether this version is a post-release. >>> Version("1.2.3").is_postrelease False >>> Version("1.2.3.post1").is_postrelease True """ return self.post is not None @property def is_devrelease(self) -> bool: """Whether this version is a development release. >>> Version("1.2.3").is_devrelease False >>> Version("1.2.3.dev1").is_devrelease True """ return self.dev is not None @property def major(self) -> int: """The first item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").major 1 """ return self.release[0] if len(self.release) >= 1 else 0 @property def minor(self) -> int: """The second item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").minor 2 >>> Version("1").minor 0 """ return self.release[1] if len(self.release) >= 2 else 0 @property def micro(self) -> int: """The third item of :attr:`release` or ``0`` if unavailable. >>> Version("1.2.3").micro 3 >>> Version("1").micro 0 """ return self.release[2] if len(self.release) >= 3 else 0 class _TrimmedRelease(Version): @property def release(self) -> tuple[int, ...]: """ Release segment without any trailing zeros. >>> _TrimmedRelease('1.0.0').release (1,) >>> _TrimmedRelease('0.0').release (0,) """ rel = super().release nonzeros = (index for index, val in enumerate(rel) if val) last_nonzero = max(nonzeros, default=0) return rel[: last_nonzero + 1] def _parse_letter_version( letter: str | None, number: str | bytes | SupportsInt | None ) -> tuple[str, int] | None: if letter: # We consider there to be an implicit 0 in a pre-release if there is # not a numeral associated with it. if number is None: number = 0 # We normalize any letters to their lower case form letter = letter.lower() # We consider some words to be alternate spellings of other words and # in those cases we want to normalize the spellings to our preferred # spelling. if letter == "alpha": letter = "a" elif letter == "beta": letter = "b" elif letter in ["c", "pre", "preview"]: letter = "rc" elif letter in ["rev", "r"]: letter = "post" return letter, int(number) assert not letter if number: # We assume if we are given a number, but we are not given a letter # then this is using the implicit post release syntax (e.g. 1.0-1) letter = "post" return letter, int(number) return None _local_version_separators = re.compile(r"[\._-]") def _parse_local_version(local: str | None) -> LocalType | None: """ Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve"). """ if local is not None: return tuple( part.lower() if not part.isdigit() else int(part) for part in _local_version_separators.split(local) ) return None def _cmpkey( epoch: int, release: tuple[int, ...], pre: tuple[str, int] | None, post: tuple[str, int] | None, dev: tuple[str, int] | None, local: LocalType | None, ) -> CmpKey: # When we compare a release version, we want to compare it with all of the # trailing zeros removed. So we'll use a reverse the list, drop all the now # leading zeros until we come to something non zero, then take the rest # re-reverse it back into the correct order and make it a tuple and use # that for our sorting key. _release = tuple( reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release)))) ) # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0. # We'll do this by abusing the pre segment, but we _only_ want to do this # if there is not a pre or a post segment. If we have one of those then # the normal sorting rules will handle this case correctly. if pre is None and post is None and dev is not None: _pre: CmpPrePostDevType = NegativeInfinity # Versions without a pre-release (except as noted above) should sort after # those with one. elif pre is None: _pre = Infinity else: _pre = pre # Versions without a post segment should sort before those with one. if post is None: _post: CmpPrePostDevType = NegativeInfinity else: _post = post # Versions without a development segment should sort after those with one. if dev is None: _dev: CmpPrePostDevType = Infinity else: _dev = dev if local is None: # Versions without a local segment should sort before those with one. _local: CmpLocalType = NegativeInfinity else: # Versions with a local segment need that segment parsed to implement # the sorting rules in PEP440. # - Alpha numeric segments sort before numeric segments # - Alpha numeric segments sort lexicographically # - Numeric segments sort numerically # - Shorter versions sort before longer versions when the prefixes # match exactly _local = tuple( (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local ) return epoch, _release, _pre, _post, _dev, _local _vendor/packaging/metadata.py 0000644 00000103712 15030122015 0012247 0 ustar 00 from __future__ import annotations import email.feedparser import email.header import email.message import email.parser import email.policy import pathlib import sys import typing from typing import ( Any, Callable, Generic, Literal, TypedDict, cast, ) from . import licenses, requirements, specifiers, utils from . import version as version_module from .licenses import NormalizedLicenseExpression T = typing.TypeVar("T") if sys.version_info >= (3, 11): # pragma: no cover ExceptionGroup = ExceptionGroup else: # pragma: no cover class ExceptionGroup(Exception): """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11. If :external:exc:`ExceptionGroup` is already defined by Python itself, that version is used instead. """ message: str exceptions: list[Exception] def __init__(self, message: str, exceptions: list[Exception]) -> None: self.message = message self.exceptions = exceptions def __repr__(self) -> str: return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})" class InvalidMetadata(ValueError): """A metadata field contains invalid data.""" field: str """The name of the field that contains invalid data.""" def __init__(self, field: str, message: str) -> None: self.field = field super().__init__(message) # The RawMetadata class attempts to make as few assumptions about the underlying # serialization formats as possible. The idea is that as long as a serialization # formats offer some very basic primitives in *some* way then we can support # serializing to and from that format. class RawMetadata(TypedDict, total=False): """A dictionary of raw core metadata. Each field in core metadata maps to a key of this dictionary (when data is provided). The key is lower-case and underscores are used instead of dashes compared to the equivalent core metadata field. Any core metadata field that can be specified multiple times or can hold multiple values in a single field have a key with a plural name. See :class:`Metadata` whose attributes match the keys of this dictionary. Core metadata fields that can be specified multiple times are stored as a list or dict depending on which is appropriate for the field. Any fields which hold multiple values in a single field are stored as a list. """ # Metadata 1.0 - PEP 241 metadata_version: str name: str version: str platforms: list[str] summary: str description: str keywords: list[str] home_page: str author: str author_email: str license: str # Metadata 1.1 - PEP 314 supported_platforms: list[str] download_url: str classifiers: list[str] requires: list[str] provides: list[str] obsoletes: list[str] # Metadata 1.2 - PEP 345 maintainer: str maintainer_email: str requires_dist: list[str] provides_dist: list[str] obsoletes_dist: list[str] requires_python: str requires_external: list[str] project_urls: dict[str, str] # Metadata 2.0 # PEP 426 attempted to completely revamp the metadata format # but got stuck without ever being able to build consensus on # it and ultimately ended up withdrawn. # # However, a number of tools had started emitting METADATA with # `2.0` Metadata-Version, so for historical reasons, this version # was skipped. # Metadata 2.1 - PEP 566 description_content_type: str provides_extra: list[str] # Metadata 2.2 - PEP 643 dynamic: list[str] # Metadata 2.3 - PEP 685 # No new fields were added in PEP 685, just some edge case were # tightened up to provide better interoptability. # Metadata 2.4 - PEP 639 license_expression: str license_files: list[str] _STRING_FIELDS = { "author", "author_email", "description", "description_content_type", "download_url", "home_page", "license", "license_expression", "maintainer", "maintainer_email", "metadata_version", "name", "requires_python", "summary", "version", } _LIST_FIELDS = { "classifiers", "dynamic", "license_files", "obsoletes", "obsoletes_dist", "platforms", "provides", "provides_dist", "provides_extra", "requires", "requires_dist", "requires_external", "supported_platforms", } _DICT_FIELDS = { "project_urls", } def _parse_keywords(data: str) -> list[str]: """Split a string of comma-separated keywords into a list of keywords.""" return [k.strip() for k in data.split(",")] def _parse_project_urls(data: list[str]) -> dict[str, str]: """Parse a list of label/URL string pairings separated by a comma.""" urls = {} for pair in data: # Our logic is slightly tricky here as we want to try and do # *something* reasonable with malformed data. # # The main thing that we have to worry about, is data that does # not have a ',' at all to split the label from the Value. There # isn't a singular right answer here, and we will fail validation # later on (if the caller is validating) so it doesn't *really* # matter, but since the missing value has to be an empty str # and our return value is dict[str, str], if we let the key # be the missing value, then they'd have multiple '' values that # overwrite each other in a accumulating dict. # # The other potentional issue is that it's possible to have the # same label multiple times in the metadata, with no solid "right" # answer with what to do in that case. As such, we'll do the only # thing we can, which is treat the field as unparseable and add it # to our list of unparsed fields. parts = [p.strip() for p in pair.split(",", 1)] parts.extend([""] * (max(0, 2 - len(parts)))) # Ensure 2 items # TODO: The spec doesn't say anything about if the keys should be # considered case sensitive or not... logically they should # be case-preserving and case-insensitive, but doing that # would open up more cases where we might have duplicate # entries. label, url = parts if label in urls: # The label already exists in our set of urls, so this field # is unparseable, and we can just add the whole thing to our # unparseable data and stop processing it. raise KeyError("duplicate labels in project urls") urls[label] = url return urls def _get_payload(msg: email.message.Message, source: bytes | str) -> str: """Get the body of the message.""" # If our source is a str, then our caller has managed encodings for us, # and we don't need to deal with it. if isinstance(source, str): payload = msg.get_payload() assert isinstance(payload, str) return payload # If our source is a bytes, then we're managing the encoding and we need # to deal with it. else: bpayload = msg.get_payload(decode=True) assert isinstance(bpayload, bytes) try: return bpayload.decode("utf8", "strict") except UnicodeDecodeError as exc: raise ValueError("payload in an invalid encoding") from exc # The various parse_FORMAT functions here are intended to be as lenient as # possible in their parsing, while still returning a correctly typed # RawMetadata. # # To aid in this, we also generally want to do as little touching of the # data as possible, except where there are possibly some historic holdovers # that make valid data awkward to work with. # # While this is a lower level, intermediate format than our ``Metadata`` # class, some light touch ups can make a massive difference in usability. # Map METADATA fields to RawMetadata. _EMAIL_TO_RAW_MAPPING = { "author": "author", "author-email": "author_email", "classifier": "classifiers", "description": "description", "description-content-type": "description_content_type", "download-url": "download_url", "dynamic": "dynamic", "home-page": "home_page", "keywords": "keywords", "license": "license", "license-expression": "license_expression", "license-file": "license_files", "maintainer": "maintainer", "maintainer-email": "maintainer_email", "metadata-version": "metadata_version", "name": "name", "obsoletes": "obsoletes", "obsoletes-dist": "obsoletes_dist", "platform": "platforms", "project-url": "project_urls", "provides": "provides", "provides-dist": "provides_dist", "provides-extra": "provides_extra", "requires": "requires", "requires-dist": "requires_dist", "requires-external": "requires_external", "requires-python": "requires_python", "summary": "summary", "supported-platform": "supported_platforms", "version": "version", } _RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()} def parse_email(data: bytes | str) -> tuple[RawMetadata, dict[str, list[str]]]: """Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``). This function returns a two-item tuple of dicts. The first dict is of recognized fields from the core metadata specification. Fields that can be parsed and translated into Python's built-in types are converted appropriately. All other fields are left as-is. Fields that are allowed to appear multiple times are stored as lists. The second dict contains all other fields from the metadata. This includes any unrecognized fields. It also includes any fields which are expected to be parsed into a built-in type but were not formatted appropriately. Finally, any fields that are expected to appear only once but are repeated are included in this dict. """ raw: dict[str, str | list[str] | dict[str, str]] = {} unparsed: dict[str, list[str]] = {} if isinstance(data, str): parsed = email.parser.Parser(policy=email.policy.compat32).parsestr(data) else: parsed = email.parser.BytesParser(policy=email.policy.compat32).parsebytes(data) # We have to wrap parsed.keys() in a set, because in the case of multiple # values for a key (a list), the key will appear multiple times in the # list of keys, but we're avoiding that by using get_all(). for name in frozenset(parsed.keys()): # Header names in RFC are case insensitive, so we'll normalize to all # lower case to make comparisons easier. name = name.lower() # We use get_all() here, even for fields that aren't multiple use, # because otherwise someone could have e.g. two Name fields, and we # would just silently ignore it rather than doing something about it. headers = parsed.get_all(name) or [] # The way the email module works when parsing bytes is that it # unconditionally decodes the bytes as ascii using the surrogateescape # handler. When you pull that data back out (such as with get_all() ), # it looks to see if the str has any surrogate escapes, and if it does # it wraps it in a Header object instead of returning the string. # # As such, we'll look for those Header objects, and fix up the encoding. value = [] # Flag if we have run into any issues processing the headers, thus # signalling that the data belongs in 'unparsed'. valid_encoding = True for h in headers: # It's unclear if this can return more types than just a Header or # a str, so we'll just assert here to make sure. assert isinstance(h, (email.header.Header, str)) # If it's a header object, we need to do our little dance to get # the real data out of it. In cases where there is invalid data # we're going to end up with mojibake, but there's no obvious, good # way around that without reimplementing parts of the Header object # ourselves. # # That should be fine since, if mojibacked happens, this key is # going into the unparsed dict anyways. if isinstance(h, email.header.Header): # The Header object stores it's data as chunks, and each chunk # can be independently encoded, so we'll need to check each # of them. chunks: list[tuple[bytes, str | None]] = [] for bin, encoding in email.header.decode_header(h): try: bin.decode("utf8", "strict") except UnicodeDecodeError: # Enable mojibake. encoding = "latin1" valid_encoding = False else: encoding = "utf8" chunks.append((bin, encoding)) # Turn our chunks back into a Header object, then let that # Header object do the right thing to turn them into a # string for us. value.append(str(email.header.make_header(chunks))) # This is already a string, so just add it. else: value.append(h) # We've processed all of our values to get them into a list of str, # but we may have mojibake data, in which case this is an unparsed # field. if not valid_encoding: unparsed[name] = value continue raw_name = _EMAIL_TO_RAW_MAPPING.get(name) if raw_name is None: # This is a bit of a weird situation, we've encountered a key that # we don't know what it means, so we don't know whether it's meant # to be a list or not. # # Since we can't really tell one way or another, we'll just leave it # as a list, even though it may be a single item list, because that's # what makes the most sense for email headers. unparsed[name] = value continue # If this is one of our string fields, then we'll check to see if our # value is a list of a single item. If it is then we'll assume that # it was emitted as a single string, and unwrap the str from inside # the list. # # If it's any other kind of data, then we haven't the faintest clue # what we should parse it as, and we have to just add it to our list # of unparsed stuff. if raw_name in _STRING_FIELDS and len(value) == 1: raw[raw_name] = value[0] # If this is one of our list of string fields, then we can just assign # the value, since email *only* has strings, and our get_all() call # above ensures that this is a list. elif raw_name in _LIST_FIELDS: raw[raw_name] = value # Special Case: Keywords # The keywords field is implemented in the metadata spec as a str, # but it conceptually is a list of strings, and is serialized using # ", ".join(keywords), so we'll do some light data massaging to turn # this into what it logically is. elif raw_name == "keywords" and len(value) == 1: raw[raw_name] = _parse_keywords(value[0]) # Special Case: Project-URL # The project urls is implemented in the metadata spec as a list of # specially-formatted strings that represent a key and a value, which # is fundamentally a mapping, however the email format doesn't support # mappings in a sane way, so it was crammed into a list of strings # instead. # # We will do a little light data massaging to turn this into a map as # it logically should be. elif raw_name == "project_urls": try: raw[raw_name] = _parse_project_urls(value) except KeyError: unparsed[name] = value # Nothing that we've done has managed to parse this, so it'll just # throw it in our unparseable data and move on. else: unparsed[name] = value # We need to support getting the Description from the message payload in # addition to getting it from the the headers. This does mean, though, there # is the possibility of it being set both ways, in which case we put both # in 'unparsed' since we don't know which is right. try: payload = _get_payload(parsed, data) except ValueError: unparsed.setdefault("description", []).append( parsed.get_payload(decode=isinstance(data, bytes)) # type: ignore[call-overload] ) else: if payload: # Check to see if we've already got a description, if so then both # it, and this body move to unparseable. if "description" in raw: description_header = cast(str, raw.pop("description")) unparsed.setdefault("description", []).extend( [description_header, payload] ) elif "description" in unparsed: unparsed["description"].append(payload) else: raw["description"] = payload # We need to cast our `raw` to a metadata, because a TypedDict only support # literal key names, but we're computing our key names on purpose, but the # way this function is implemented, our `TypedDict` can only have valid key # names. return cast(RawMetadata, raw), unparsed _NOT_FOUND = object() # Keep the two values in sync. _VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"] _MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"] _REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"]) class _Validator(Generic[T]): """Validate a metadata field. All _process_*() methods correspond to a core metadata field. The method is called with the field's raw value. If the raw value is valid it is returned in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field). If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause as appropriate). """ name: str raw_name: str added: _MetadataVersion def __init__( self, *, added: _MetadataVersion = "1.0", ) -> None: self.added = added def __set_name__(self, _owner: Metadata, name: str) -> None: self.name = name self.raw_name = _RAW_TO_EMAIL_MAPPING[name] def __get__(self, instance: Metadata, _owner: type[Metadata]) -> T: # With Python 3.8, the caching can be replaced with functools.cached_property(). # No need to check the cache as attribute lookup will resolve into the # instance's __dict__ before __get__ is called. cache = instance.__dict__ value = instance._raw.get(self.name) # To make the _process_* methods easier, we'll check if the value is None # and if this field is NOT a required attribute, and if both of those # things are true, we'll skip the the converter. This will mean that the # converters never have to deal with the None union. if self.name in _REQUIRED_ATTRS or value is not None: try: converter: Callable[[Any], T] = getattr(self, f"_process_{self.name}") except AttributeError: pass else: value = converter(value) cache[self.name] = value try: del instance._raw[self.name] # type: ignore[misc] except KeyError: pass return cast(T, value) def _invalid_metadata( self, msg: str, cause: Exception | None = None ) -> InvalidMetadata: exc = InvalidMetadata( self.raw_name, msg.format_map({"field": repr(self.raw_name)}) ) exc.__cause__ = cause return exc def _process_metadata_version(self, value: str) -> _MetadataVersion: # Implicitly makes Metadata-Version required. if value not in _VALID_METADATA_VERSIONS: raise self._invalid_metadata(f"{value!r} is not a valid metadata version") return cast(_MetadataVersion, value) def _process_name(self, value: str) -> str: if not value: raise self._invalid_metadata("{field} is a required field") # Validate the name as a side-effect. try: utils.canonicalize_name(value, validate=True) except utils.InvalidName as exc: raise self._invalid_metadata( f"{value!r} is invalid for {{field}}", cause=exc ) from exc else: return value def _process_version(self, value: str) -> version_module.Version: if not value: raise self._invalid_metadata("{field} is a required field") try: return version_module.parse(value) except version_module.InvalidVersion as exc: raise self._invalid_metadata( f"{value!r} is invalid for {{field}}", cause=exc ) from exc def _process_summary(self, value: str) -> str: """Check the field contains no newlines.""" if "\n" in value: raise self._invalid_metadata("{field} must be a single line") return value def _process_description_content_type(self, value: str) -> str: content_types = {"text/plain", "text/x-rst", "text/markdown"} message = email.message.EmailMessage() message["content-type"] = value content_type, parameters = ( # Defaults to `text/plain` if parsing failed. message.get_content_type().lower(), message["content-type"].params, ) # Check if content-type is valid or defaulted to `text/plain` and thus was # not parseable. if content_type not in content_types or content_type not in value.lower(): raise self._invalid_metadata( f"{{field}} must be one of {list(content_types)}, not {value!r}" ) charset = parameters.get("charset", "UTF-8") if charset != "UTF-8": raise self._invalid_metadata( f"{{field}} can only specify the UTF-8 charset, not {list(charset)}" ) markdown_variants = {"GFM", "CommonMark"} variant = parameters.get("variant", "GFM") # Use an acceptable default. if content_type == "text/markdown" and variant not in markdown_variants: raise self._invalid_metadata( f"valid Markdown variants for {{field}} are {list(markdown_variants)}, " f"not {variant!r}", ) return value def _process_dynamic(self, value: list[str]) -> list[str]: for dynamic_field in map(str.lower, value): if dynamic_field in {"name", "version", "metadata-version"}: raise self._invalid_metadata( f"{dynamic_field!r} is not allowed as a dynamic field" ) elif dynamic_field not in _EMAIL_TO_RAW_MAPPING: raise self._invalid_metadata( f"{dynamic_field!r} is not a valid dynamic field" ) return list(map(str.lower, value)) def _process_provides_extra( self, value: list[str], ) -> list[utils.NormalizedName]: normalized_names = [] try: for name in value: normalized_names.append(utils.canonicalize_name(name, validate=True)) except utils.InvalidName as exc: raise self._invalid_metadata( f"{name!r} is invalid for {{field}}", cause=exc ) from exc else: return normalized_names def _process_requires_python(self, value: str) -> specifiers.SpecifierSet: try: return specifiers.SpecifierSet(value) except specifiers.InvalidSpecifier as exc: raise self._invalid_metadata( f"{value!r} is invalid for {{field}}", cause=exc ) from exc def _process_requires_dist( self, value: list[str], ) -> list[requirements.Requirement]: reqs = [] try: for req in value: reqs.append(requirements.Requirement(req)) except requirements.InvalidRequirement as exc: raise self._invalid_metadata( f"{req!r} is invalid for {{field}}", cause=exc ) from exc else: return reqs def _process_license_expression( self, value: str ) -> NormalizedLicenseExpression | None: try: return licenses.canonicalize_license_expression(value) except ValueError as exc: raise self._invalid_metadata( f"{value!r} is invalid for {{field}}", cause=exc ) from exc def _process_license_files(self, value: list[str]) -> list[str]: paths = [] for path in value: if ".." in path: raise self._invalid_metadata( f"{path!r} is invalid for {{field}}, " "parent directory indicators are not allowed" ) if "*" in path: raise self._invalid_metadata( f"{path!r} is invalid for {{field}}, paths must be resolved" ) if ( pathlib.PurePosixPath(path).is_absolute() or pathlib.PureWindowsPath(path).is_absolute() ): raise self._invalid_metadata( f"{path!r} is invalid for {{field}}, paths must be relative" ) if pathlib.PureWindowsPath(path).as_posix() != path: raise self._invalid_metadata( f"{path!r} is invalid for {{field}}, " "paths must use '/' delimiter" ) paths.append(path) return paths class Metadata: """Representation of distribution metadata. Compared to :class:`RawMetadata`, this class provides objects representing metadata fields instead of only using built-in types. Any invalid metadata will cause :exc:`InvalidMetadata` to be raised (with a :py:attr:`~BaseException.__cause__` attribute as appropriate). """ _raw: RawMetadata @classmethod def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> Metadata: """Create an instance from :class:`RawMetadata`. If *validate* is true, all metadata will be validated. All exceptions related to validation will be gathered and raised as an :class:`ExceptionGroup`. """ ins = cls() ins._raw = data.copy() # Mutations occur due to caching enriched values. if validate: exceptions: list[Exception] = [] try: metadata_version = ins.metadata_version metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version) except InvalidMetadata as metadata_version_exc: exceptions.append(metadata_version_exc) metadata_version = None # Make sure to check for the fields that are present, the required # fields (so their absence can be reported). fields_to_check = frozenset(ins._raw) | _REQUIRED_ATTRS # Remove fields that have already been checked. fields_to_check -= {"metadata_version"} for key in fields_to_check: try: if metadata_version: # Can't use getattr() as that triggers descriptor protocol which # will fail due to no value for the instance argument. try: field_metadata_version = cls.__dict__[key].added except KeyError: exc = InvalidMetadata(key, f"unrecognized field: {key!r}") exceptions.append(exc) continue field_age = _VALID_METADATA_VERSIONS.index( field_metadata_version ) if field_age > metadata_age: field = _RAW_TO_EMAIL_MAPPING[key] exc = InvalidMetadata( field, f"{field} introduced in metadata version " f"{field_metadata_version}, not {metadata_version}", ) exceptions.append(exc) continue getattr(ins, key) except InvalidMetadata as exc: exceptions.append(exc) if exceptions: raise ExceptionGroup("invalid metadata", exceptions) return ins @classmethod def from_email(cls, data: bytes | str, *, validate: bool = True) -> Metadata: """Parse metadata from email headers. If *validate* is true, the metadata will be validated. All exceptions related to validation will be gathered and raised as an :class:`ExceptionGroup`. """ raw, unparsed = parse_email(data) if validate: exceptions: list[Exception] = [] for unparsed_key in unparsed: if unparsed_key in _EMAIL_TO_RAW_MAPPING: message = f"{unparsed_key!r} has invalid data" else: message = f"unrecognized field: {unparsed_key!r}" exceptions.append(InvalidMetadata(unparsed_key, message)) if exceptions: raise ExceptionGroup("unparsed", exceptions) try: return cls.from_raw(raw, validate=validate) except ExceptionGroup as exc_group: raise ExceptionGroup( "invalid or unparsed metadata", exc_group.exceptions ) from None metadata_version: _Validator[_MetadataVersion] = _Validator() """:external:ref:`core-metadata-metadata-version` (required; validated to be a valid metadata version)""" # `name` is not normalized/typed to NormalizedName so as to provide access to # the original/raw name. name: _Validator[str] = _Validator() """:external:ref:`core-metadata-name` (required; validated using :func:`~packaging.utils.canonicalize_name` and its *validate* parameter)""" version: _Validator[version_module.Version] = _Validator() """:external:ref:`core-metadata-version` (required)""" dynamic: _Validator[list[str] | None] = _Validator( added="2.2", ) """:external:ref:`core-metadata-dynamic` (validated against core metadata field names and lowercased)""" platforms: _Validator[list[str] | None] = _Validator() """:external:ref:`core-metadata-platform`""" supported_platforms: _Validator[list[str] | None] = _Validator(added="1.1") """:external:ref:`core-metadata-supported-platform`""" summary: _Validator[str | None] = _Validator() """:external:ref:`core-metadata-summary` (validated to contain no newlines)""" description: _Validator[str | None] = _Validator() # TODO 2.1: can be in body """:external:ref:`core-metadata-description`""" description_content_type: _Validator[str | None] = _Validator(added="2.1") """:external:ref:`core-metadata-description-content-type` (validated)""" keywords: _Validator[list[str] | None] = _Validator() """:external:ref:`core-metadata-keywords`""" home_page: _Validator[str | None] = _Validator() """:external:ref:`core-metadata-home-page`""" download_url: _Validator[str | None] = _Validator(added="1.1") """:external:ref:`core-metadata-download-url`""" author: _Validator[str | None] = _Validator() """:external:ref:`core-metadata-author`""" author_email: _Validator[str | None] = _Validator() """:external:ref:`core-metadata-author-email`""" maintainer: _Validator[str | None] = _Validator(added="1.2") """:external:ref:`core-metadata-maintainer`""" maintainer_email: _Validator[str | None] = _Validator(added="1.2") """:external:ref:`core-metadata-maintainer-email`""" license: _Validator[str | None] = _Validator() """:external:ref:`core-metadata-license`""" license_expression: _Validator[NormalizedLicenseExpression | None] = _Validator( added="2.4" ) """:external:ref:`core-metadata-license-expression`""" license_files: _Validator[list[str] | None] = _Validator(added="2.4") """:external:ref:`core-metadata-license-file`""" classifiers: _Validator[list[str] | None] = _Validator(added="1.1") """:external:ref:`core-metadata-classifier`""" requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator( added="1.2" ) """:external:ref:`core-metadata-requires-dist`""" requires_python: _Validator[specifiers.SpecifierSet | None] = _Validator( added="1.2" ) """:external:ref:`core-metadata-requires-python`""" # Because `Requires-External` allows for non-PEP 440 version specifiers, we # don't do any processing on the values. requires_external: _Validator[list[str] | None] = _Validator(added="1.2") """:external:ref:`core-metadata-requires-external`""" project_urls: _Validator[dict[str, str] | None] = _Validator(added="1.2") """:external:ref:`core-metadata-project-url`""" # PEP 685 lets us raise an error if an extra doesn't pass `Name` validation # regardless of metadata version. provides_extra: _Validator[list[utils.NormalizedName] | None] = _Validator( added="2.1", ) """:external:ref:`core-metadata-provides-extra`""" provides_dist: _Validator[list[str] | None] = _Validator(added="1.2") """:external:ref:`core-metadata-provides-dist`""" obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2") """:external:ref:`core-metadata-obsoletes-dist`""" requires: _Validator[list[str] | None] = _Validator(added="1.1") """``Requires`` (deprecated)""" provides: _Validator[list[str] | None] = _Validator(added="1.1") """``Provides`` (deprecated)""" obsoletes: _Validator[list[str] | None] = _Validator(added="1.1") """``Obsoletes`` (deprecated)""" _vendor/packaging/_tokenizer.py 0000644 00000012231 15030122015 0012633 0 ustar 00 from __future__ import annotations import contextlib import re from dataclasses import dataclass from typing import Iterator, NoReturn from .specifiers import Specifier @dataclass class Token: name: str text: str position: int class ParserSyntaxError(Exception): """The provided source text could not be parsed correctly.""" def __init__( self, message: str, *, source: str, span: tuple[int, int], ) -> None: self.span = span self.message = message self.source = source super().__init__() def __str__(self) -> str: marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^" return "\n ".join([self.message, self.source, marker]) DEFAULT_RULES: dict[str, str | re.Pattern[str]] = { "LEFT_PARENTHESIS": r"\(", "RIGHT_PARENTHESIS": r"\)", "LEFT_BRACKET": r"\[", "RIGHT_BRACKET": r"\]", "SEMICOLON": r";", "COMMA": r",", "QUOTED_STRING": re.compile( r""" ( ('[^']*') | ("[^"]*") ) """, re.VERBOSE, ), "OP": r"(===|==|~=|!=|<=|>=|<|>)", "BOOLOP": r"\b(or|and)\b", "IN": r"\bin\b", "NOT": r"\bnot\b", "VARIABLE": re.compile( r""" \b( python_version |python_full_version |os[._]name |sys[._]platform |platform_(release|system) |platform[._](version|machine|python_implementation) |python_implementation |implementation_(name|version) |extra )\b """, re.VERBOSE, ), "SPECIFIER": re.compile( Specifier._operator_regex_str + Specifier._version_regex_str, re.VERBOSE | re.IGNORECASE, ), "AT": r"\@", "URL": r"[^ \t]+", "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b", "VERSION_PREFIX_TRAIL": r"\.\*", "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*", "WS": r"[ \t]+", "END": r"$", } class Tokenizer: """Context-sensitive token parsing. Provides methods to examine the input stream to check whether the next token matches. """ def __init__( self, source: str, *, rules: dict[str, str | re.Pattern[str]], ) -> None: self.source = source self.rules: dict[str, re.Pattern[str]] = { name: re.compile(pattern) for name, pattern in rules.items() } self.next_token: Token | None = None self.position = 0 def consume(self, name: str) -> None: """Move beyond provided token name, if at current position.""" if self.check(name): self.read() def check(self, name: str, *, peek: bool = False) -> bool: """Check whether the next token has the provided name. By default, if the check succeeds, the token *must* be read before another check. If `peek` is set to `True`, the token is not loaded and would need to be checked again. """ assert ( self.next_token is None ), f"Cannot check for {name!r}, already have {self.next_token!r}" assert name in self.rules, f"Unknown token name: {name!r}" expression = self.rules[name] match = expression.match(self.source, self.position) if match is None: return False if not peek: self.next_token = Token(name, match[0], self.position) return True def expect(self, name: str, *, expected: str) -> Token: """Expect a certain token name next, failing with a syntax error otherwise. The token is *not* read. """ if not self.check(name): raise self.raise_syntax_error(f"Expected {expected}") return self.read() def read(self) -> Token: """Consume the next token and return it.""" token = self.next_token assert token is not None self.position += len(token.text) self.next_token = None return token def raise_syntax_error( self, message: str, *, span_start: int | None = None, span_end: int | None = None, ) -> NoReturn: """Raise ParserSyntaxError at the given position.""" span = ( self.position if span_start is None else span_start, self.position if span_end is None else span_end, ) raise ParserSyntaxError( message, source=self.source, span=span, ) @contextlib.contextmanager def enclosing_tokens( self, open_token: str, close_token: str, *, around: str ) -> Iterator[None]: if self.check(open_token): open_position = self.position self.read() else: open_position = None yield if open_position is None: return if not self.check(close_token): self.raise_syntax_error( f"Expected matching {close_token} for {open_token}, after {around}", span_start=open_position, ) self.read() _vendor/packaging/_musllinux.py 0000644 00000005206 15030122015 0012665 0 ustar 00 """PEP 656 support. This module implements logic to detect if the currently running Python is linked against musl, and what musl version is used. """ from __future__ import annotations import functools import re import subprocess import sys from typing import Iterator, NamedTuple, Sequence from ._elffile import ELFFile class _MuslVersion(NamedTuple): major: int minor: int def _parse_musl_version(output: str) -> _MuslVersion | None: lines = [n for n in (n.strip() for n in output.splitlines()) if n] if len(lines) < 2 or lines[0][:4] != "musl": return None m = re.match(r"Version (\d+)\.(\d+)", lines[1]) if not m: return None return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2))) @functools.lru_cache def _get_musl_version(executable: str) -> _MuslVersion | None: """Detect currently-running musl runtime version. This is done by checking the specified executable's dynamic linking information, and invoking the loader to parse its output for a version string. If the loader is musl, the output would be something like:: musl libc (x86_64) Version 1.2.2 Dynamic Program Loader """ try: with open(executable, "rb") as f: ld = ELFFile(f).interpreter except (OSError, TypeError, ValueError): return None if ld is None or "musl" not in ld: return None proc = subprocess.run([ld], stderr=subprocess.PIPE, text=True) return _parse_musl_version(proc.stderr) def platform_tags(archs: Sequence[str]) -> Iterator[str]: """Generate musllinux tags compatible to the current platform. :param archs: Sequence of compatible architectures. The first one shall be the closest to the actual architecture and be the part of platform tag after the ``linux_`` prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a prerequisite for the current platform to be musllinux-compatible. :returns: An iterator of compatible musllinux tags. """ sys_musl = _get_musl_version(sys.executable) if sys_musl is None: # Python not dynamically linked against musl. return for arch in archs: for minor in range(sys_musl.minor, -1, -1): yield f"musllinux_{sys_musl.major}_{minor}_{arch}" if __name__ == "__main__": # pragma: no cover import sysconfig plat = sysconfig.get_platform() assert plat.startswith("linux-"), "not linux" print("plat:", plat) print("musl:", _get_musl_version(sys.executable)) print("tags:", end=" ") for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): print(t, end="\n ") _vendor/packaging/_elffile.py 0000644 00000006352 15030122015 0012236 0 ustar 00 """ ELF file parser. This provides a class ``ELFFile`` that parses an ELF executable in a similar interface to ``ZipFile``. Only the read interface is implemented. Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html """ from __future__ import annotations import enum import os import struct from typing import IO class ELFInvalid(ValueError): pass class EIClass(enum.IntEnum): C32 = 1 C64 = 2 class EIData(enum.IntEnum): Lsb = 1 Msb = 2 class EMachine(enum.IntEnum): I386 = 3 S390 = 22 Arm = 40 X8664 = 62 AArc64 = 183 class ELFFile: """ Representation of an ELF executable. """ def __init__(self, f: IO[bytes]) -> None: self._f = f try: ident = self._read("16B") except struct.error as e: raise ELFInvalid("unable to parse identification") from e magic = bytes(ident[:4]) if magic != b"\x7fELF": raise ELFInvalid(f"invalid magic: {magic!r}") self.capacity = ident[4] # Format for program header (bitness). self.encoding = ident[5] # Data structure encoding (endianness). try: # e_fmt: Format for program header. # p_fmt: Format for section header. # p_idx: Indexes to find p_type, p_offset, and p_filesz. e_fmt, self._p_fmt, self._p_idx = { (1, 1): ("<HHIIIIIHHH", "<IIIIIIII", (0, 1, 4)), # 32-bit LSB. (1, 2): (">HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)), # 32-bit MSB. (2, 1): ("<HHIQQQIHHH", "<IIQQQQQQ", (0, 2, 5)), # 64-bit LSB. (2, 2): (">HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)), # 64-bit MSB. }[(self.capacity, self.encoding)] except KeyError as e: raise ELFInvalid( f"unrecognized capacity ({self.capacity}) or " f"encoding ({self.encoding})" ) from e try: ( _, self.machine, # Architecture type. _, _, self._e_phoff, # Offset of program header. _, self.flags, # Processor-specific flags. _, self._e_phentsize, # Size of section. self._e_phnum, # Number of sections. ) = self._read(e_fmt) except struct.error as e: raise ELFInvalid("unable to parse machine and section information") from e def _read(self, fmt: str) -> tuple[int, ...]: return struct.unpack(fmt, self._f.read(struct.calcsize(fmt))) @property def interpreter(self) -> str | None: """ The path recorded in the ``PT_INTERP`` section header. """ for index in range(self._e_phnum): self._f.seek(self._e_phoff + self._e_phentsize * index) try: data = self._read(self._p_fmt) except struct.error: continue if data[self._p_idx[0]] != 3: # Not PT_INTERP. continue self._f.seek(data[self._p_idx[1]]) return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0") return None _vendor/packaging/tags.py 0000644 00000051026 15030122015 0011425 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import annotations import logging import platform import re import struct import subprocess import sys import sysconfig from importlib.machinery import EXTENSION_SUFFIXES from typing import ( Iterable, Iterator, Sequence, Tuple, cast, ) from . import _manylinux, _musllinux logger = logging.getLogger(__name__) PythonVersion = Sequence[int] AppleVersion = Tuple[int, int] INTERPRETER_SHORT_NAMES: dict[str, str] = { "python": "py", # Generic. "cpython": "cp", "pypy": "pp", "ironpython": "ip", "jython": "jy", } _32_BIT_INTERPRETER = struct.calcsize("P") == 4 class Tag: """ A representation of the tag triple for a wheel. Instances are considered immutable and thus are hashable. Equality checking is also supported. """ __slots__ = ["_abi", "_hash", "_interpreter", "_platform"] def __init__(self, interpreter: str, abi: str, platform: str) -> None: self._interpreter = interpreter.lower() self._abi = abi.lower() self._platform = platform.lower() # The __hash__ of every single element in a Set[Tag] will be evaluated each time # that a set calls its `.disjoint()` method, which may be called hundreds of # times when scanning a page of links for packages with tags matching that # Set[Tag]. Pre-computing the value here produces significant speedups for # downstream consumers. self._hash = hash((self._interpreter, self._abi, self._platform)) @property def interpreter(self) -> str: return self._interpreter @property def abi(self) -> str: return self._abi @property def platform(self) -> str: return self._platform def __eq__(self, other: object) -> bool: if not isinstance(other, Tag): return NotImplemented return ( (self._hash == other._hash) # Short-circuit ASAP for perf reasons. and (self._platform == other._platform) and (self._abi == other._abi) and (self._interpreter == other._interpreter) ) def __hash__(self) -> int: return self._hash def __str__(self) -> str: return f"{self._interpreter}-{self._abi}-{self._platform}" def __repr__(self) -> str: return f"<{self} @ {id(self)}>" def parse_tag(tag: str) -> frozenset[Tag]: """ Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. Returning a set is required due to the possibility that the tag is a compressed tag set. """ tags = set() interpreters, abis, platforms = tag.split("-") for interpreter in interpreters.split("."): for abi in abis.split("."): for platform_ in platforms.split("."): tags.add(Tag(interpreter, abi, platform_)) return frozenset(tags) def _get_config_var(name: str, warn: bool = False) -> int | str | None: value: int | str | None = sysconfig.get_config_var(name) if value is None and warn: logger.debug( "Config variable '%s' is unset, Python ABI tag may be incorrect", name ) return value def _normalize_string(string: str) -> str: return string.replace(".", "_").replace("-", "_").replace(" ", "_") def _is_threaded_cpython(abis: list[str]) -> bool: """ Determine if the ABI corresponds to a threaded (`--disable-gil`) build. The threaded builds are indicated by a "t" in the abiflags. """ if len(abis) == 0: return False # expect e.g., cp313 m = re.match(r"cp\d+(.*)", abis[0]) if not m: return False abiflags = m.group(1) return "t" in abiflags def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool: """ Determine if the Python version supports abi3. PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) builds do not support abi3. """ return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> list[str]: py_version = tuple(py_version) # To allow for version comparison. abis = [] version = _version_nodot(py_version[:2]) threading = debug = pymalloc = ucs4 = "" with_debug = _get_config_var("Py_DEBUG", warn) has_refcount = hasattr(sys, "gettotalrefcount") # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled # extension modules is the best option. # https://github.com/pypa/pip/issues/3383#issuecomment-173267692 has_ext = "_d.pyd" in EXTENSION_SUFFIXES if with_debug or (with_debug is None and (has_refcount or has_ext)): debug = "d" if py_version >= (3, 13) and _get_config_var("Py_GIL_DISABLED", warn): threading = "t" if py_version < (3, 8): with_pymalloc = _get_config_var("WITH_PYMALLOC", warn) if with_pymalloc or with_pymalloc is None: pymalloc = "m" if py_version < (3, 3): unicode_size = _get_config_var("Py_UNICODE_SIZE", warn) if unicode_size == 4 or ( unicode_size is None and sys.maxunicode == 0x10FFFF ): ucs4 = "u" elif debug: # Debug builds can also load "normal" extension modules. # We can also assume no UCS-4 or pymalloc requirement. abis.append(f"cp{version}{threading}") abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}") return abis def cpython_tags( python_version: PythonVersion | None = None, abis: Iterable[str] | None = None, platforms: Iterable[str] | None = None, *, warn: bool = False, ) -> Iterator[Tag]: """ Yields the tags for a CPython interpreter. The tags consist of: - cp<python_version>-<abi>-<platform> - cp<python_version>-abi3-<platform> - cp<python_version>-none-<platform> - cp<less than python_version>-abi3-<platform> # Older Python versions down to 3.2. If python_version only specifies a major version then user-provided ABIs and the 'none' ABItag will be used. If 'abi3' or 'none' are specified in 'abis' then they will be yielded at their normal position and not at the beginning. """ if not python_version: python_version = sys.version_info[:2] interpreter = f"cp{_version_nodot(python_version[:2])}" if abis is None: if len(python_version) > 1: abis = _cpython_abis(python_version, warn) else: abis = [] abis = list(abis) # 'abi3' and 'none' are explicitly handled later. for explicit_abi in ("abi3", "none"): try: abis.remove(explicit_abi) except ValueError: pass platforms = list(platforms or platform_tags()) for abi in abis: for platform_ in platforms: yield Tag(interpreter, abi, platform_) threading = _is_threaded_cpython(abis) use_abi3 = _abi3_applies(python_version, threading) if use_abi3: yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms) yield from (Tag(interpreter, "none", platform_) for platform_ in platforms) if use_abi3: for minor_version in range(python_version[1] - 1, 1, -1): for platform_ in platforms: version = _version_nodot((python_version[0], minor_version)) interpreter = f"cp{version}" yield Tag(interpreter, "abi3", platform_) def _generic_abi() -> list[str]: """ Return the ABI tag based on EXT_SUFFIX. """ # The following are examples of `EXT_SUFFIX`. # We want to keep the parts which are related to the ABI and remove the # parts which are related to the platform: # - linux: '.cpython-310-x86_64-linux-gnu.so' => cp310 # - mac: '.cpython-310-darwin.so' => cp310 # - win: '.cp310-win_amd64.pyd' => cp310 # - win: '.pyd' => cp37 (uses _cpython_abis()) # - pypy: '.pypy38-pp73-x86_64-linux-gnu.so' => pypy38_pp73 # - graalpy: '.graalpy-38-native-x86_64-darwin.dylib' # => graalpy_38_native ext_suffix = _get_config_var("EXT_SUFFIX", warn=True) if not isinstance(ext_suffix, str) or ext_suffix[0] != ".": raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") parts = ext_suffix.split(".") if len(parts) < 3: # CPython3.7 and earlier uses ".pyd" on Windows. return _cpython_abis(sys.version_info[:2]) soabi = parts[1] if soabi.startswith("cpython"): # non-windows abi = "cp" + soabi.split("-")[1] elif soabi.startswith("cp"): # windows abi = soabi.split("-")[0] elif soabi.startswith("pypy"): abi = "-".join(soabi.split("-")[:2]) elif soabi.startswith("graalpy"): abi = "-".join(soabi.split("-")[:3]) elif soabi: # pyston, ironpython, others? abi = soabi else: return [] return [_normalize_string(abi)] def generic_tags( interpreter: str | None = None, abis: Iterable[str] | None = None, platforms: Iterable[str] | None = None, *, warn: bool = False, ) -> Iterator[Tag]: """ Yields the tags for a generic interpreter. The tags consist of: - <interpreter>-<abi>-<platform> The "none" ABI will be added if it was not explicitly provided. """ if not interpreter: interp_name = interpreter_name() interp_version = interpreter_version(warn=warn) interpreter = "".join([interp_name, interp_version]) if abis is None: abis = _generic_abi() else: abis = list(abis) platforms = list(platforms or platform_tags()) if "none" not in abis: abis.append("none") for abi in abis: for platform_ in platforms: yield Tag(interpreter, abi, platform_) def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: """ Yields Python versions in descending order. After the latest version, the major-only version will be yielded, and then all previous versions of that major version. """ if len(py_version) > 1: yield f"py{_version_nodot(py_version[:2])}" yield f"py{py_version[0]}" if len(py_version) > 1: for minor in range(py_version[1] - 1, -1, -1): yield f"py{_version_nodot((py_version[0], minor))}" def compatible_tags( python_version: PythonVersion | None = None, interpreter: str | None = None, platforms: Iterable[str] | None = None, ) -> Iterator[Tag]: """ Yields the sequence of tags that are compatible with a specific version of Python. The tags consist of: - py*-none-<platform> - <interpreter>-none-any # ... if `interpreter` is provided. - py*-none-any """ if not python_version: python_version = sys.version_info[:2] platforms = list(platforms or platform_tags()) for version in _py_interpreter_range(python_version): for platform_ in platforms: yield Tag(version, "none", platform_) if interpreter: yield Tag(interpreter, "none", "any") for version in _py_interpreter_range(python_version): yield Tag(version, "none", "any") def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: if not is_32bit: return arch if arch.startswith("ppc"): return "ppc" return "i386" def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]: formats = [cpu_arch] if cpu_arch == "x86_64": if version < (10, 4): return [] formats.extend(["intel", "fat64", "fat32"]) elif cpu_arch == "i386": if version < (10, 4): return [] formats.extend(["intel", "fat32", "fat"]) elif cpu_arch == "ppc64": # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? if version > (10, 5) or version < (10, 4): return [] formats.append("fat64") elif cpu_arch == "ppc": if version > (10, 6): return [] formats.extend(["fat32", "fat"]) if cpu_arch in {"arm64", "x86_64"}: formats.append("universal2") if cpu_arch in {"x86_64", "i386", "ppc64", "ppc", "intel"}: formats.append("universal") return formats def mac_platforms( version: AppleVersion | None = None, arch: str | None = None ) -> Iterator[str]: """ Yields the platform tags for a macOS system. The `version` parameter is a two-item tuple specifying the macOS version to generate platform tags for. The `arch` parameter is the CPU architecture to generate platform tags for. Both parameters default to the appropriate value for the current system. """ version_str, _, cpu_arch = platform.mac_ver() if version is None: version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) if version == (10, 16): # When built against an older macOS SDK, Python will report macOS 10.16 # instead of the real version. version_str = subprocess.run( [ sys.executable, "-sS", "-c", "import platform; print(platform.mac_ver()[0])", ], check=True, env={"SYSTEM_VERSION_COMPAT": "0"}, stdout=subprocess.PIPE, text=True, ).stdout version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) else: version = version if arch is None: arch = _mac_arch(cpu_arch) else: arch = arch if (10, 0) <= version and version < (11, 0): # Prior to Mac OS 11, each yearly release of Mac OS bumped the # "minor" version number. The major version was always 10. major_version = 10 for minor_version in range(version[1], -1, -1): compat_version = major_version, minor_version binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield f"macosx_{major_version}_{minor_version}_{binary_format}" if version >= (11, 0): # Starting with Mac OS 11, each yearly release bumps the major version # number. The minor versions are now the midyear updates. minor_version = 0 for major_version in range(version[0], 10, -1): compat_version = major_version, minor_version binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield f"macosx_{major_version}_{minor_version}_{binary_format}" if version >= (11, 0): # Mac OS 11 on x86_64 is compatible with binaries from previous releases. # Arm64 support was introduced in 11.0, so no Arm binaries from previous # releases exist. # # However, the "universal2" binary format can have a # macOS version earlier than 11.0 when the x86_64 part of the binary supports # that version of macOS. major_version = 10 if arch == "x86_64": for minor_version in range(16, 3, -1): compat_version = major_version, minor_version binary_formats = _mac_binary_formats(compat_version, arch) for binary_format in binary_formats: yield f"macosx_{major_version}_{minor_version}_{binary_format}" else: for minor_version in range(16, 3, -1): compat_version = major_version, minor_version binary_format = "universal2" yield f"macosx_{major_version}_{minor_version}_{binary_format}" def ios_platforms( version: AppleVersion | None = None, multiarch: str | None = None ) -> Iterator[str]: """ Yields the platform tags for an iOS system. :param version: A two-item tuple specifying the iOS version to generate platform tags for. Defaults to the current iOS version. :param multiarch: The CPU architecture+ABI to generate platform tags for - (the value used by `sys.implementation._multiarch` e.g., `arm64_iphoneos` or `x84_64_iphonesimulator`). Defaults to the current multiarch value. """ if version is None: # if iOS is the current platform, ios_ver *must* be defined. However, # it won't exist for CPython versions before 3.13, which causes a mypy # error. _, release, _, _ = platform.ios_ver() # type: ignore[attr-defined, unused-ignore] version = cast("AppleVersion", tuple(map(int, release.split(".")[:2]))) if multiarch is None: multiarch = sys.implementation._multiarch multiarch = multiarch.replace("-", "_") ios_platform_template = "ios_{major}_{minor}_{multiarch}" # Consider any iOS major.minor version from the version requested, down to # 12.0. 12.0 is the first iOS version that is known to have enough features # to support CPython. Consider every possible minor release up to X.9. There # highest the minor has ever gone is 8 (14.8 and 15.8) but having some extra # candidates that won't ever match doesn't really hurt, and it saves us from # having to keep an explicit list of known iOS versions in the code. Return # the results descending order of version number. # If the requested major version is less than 12, there won't be any matches. if version[0] < 12: return # Consider the actual X.Y version that was requested. yield ios_platform_template.format( major=version[0], minor=version[1], multiarch=multiarch ) # Consider every minor version from X.0 to the minor version prior to the # version requested by the platform. for minor in range(version[1] - 1, -1, -1): yield ios_platform_template.format( major=version[0], minor=minor, multiarch=multiarch ) for major in range(version[0] - 1, 11, -1): for minor in range(9, -1, -1): yield ios_platform_template.format( major=major, minor=minor, multiarch=multiarch ) def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]: linux = _normalize_string(sysconfig.get_platform()) if not linux.startswith("linux_"): # we should never be here, just yield the sysconfig one and return yield linux return if is_32bit: if linux == "linux_x86_64": linux = "linux_i686" elif linux == "linux_aarch64": linux = "linux_armv8l" _, arch = linux.split("_", 1) archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch]) yield from _manylinux.platform_tags(archs) yield from _musllinux.platform_tags(archs) for arch in archs: yield f"linux_{arch}" def _generic_platforms() -> Iterator[str]: yield _normalize_string(sysconfig.get_platform()) def platform_tags() -> Iterator[str]: """ Provides the platform tags for this installation. """ if platform.system() == "Darwin": return mac_platforms() elif platform.system() == "iOS": return ios_platforms() elif platform.system() == "Linux": return _linux_platforms() else: return _generic_platforms() def interpreter_name() -> str: """ Returns the name of the running interpreter. Some implementations have a reserved, two-letter abbreviation which will be returned when appropriate. """ name = sys.implementation.name return INTERPRETER_SHORT_NAMES.get(name) or name def interpreter_version(*, warn: bool = False) -> str: """ Returns the version of the running interpreter. """ version = _get_config_var("py_version_nodot", warn=warn) if version: version = str(version) else: version = _version_nodot(sys.version_info[:2]) return version def _version_nodot(version: PythonVersion) -> str: return "".join(map(str, version)) def sys_tags(*, warn: bool = False) -> Iterator[Tag]: """ Returns the sequence of tag triples for the running interpreter. The order of the sequence corresponds to priority order for the interpreter, from most to least important. """ interp_name = interpreter_name() if interp_name == "cp": yield from cpython_tags(warn=warn) else: yield from generic_tags() if interp_name == "pp": interp = "pp3" elif interp_name == "cp": interp = "cp" + interpreter_version(warn=warn) else: interp = None yield from compatible_tags(interpreter=interp) _vendor/packaging/specifiers.py 0000644 00000116212 15030122015 0012622 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. """ .. testsetup:: from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier from packaging.version import Version """ from __future__ import annotations import abc import itertools import re from typing import Callable, Iterable, Iterator, TypeVar, Union from .utils import canonicalize_version from .version import Version UnparsedVersion = Union[Version, str] UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion) CallableOperator = Callable[[Version, str], bool] def _coerce_version(version: UnparsedVersion) -> Version: if not isinstance(version, Version): version = Version(version) return version class InvalidSpecifier(ValueError): """ Raised when attempting to create a :class:`Specifier` with a specifier string that is invalid. >>> Specifier("lolwat") Traceback (most recent call last): ... packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat' """ class BaseSpecifier(metaclass=abc.ABCMeta): @abc.abstractmethod def __str__(self) -> str: """ Returns the str representation of this Specifier-like object. This should be representative of the Specifier itself. """ @abc.abstractmethod def __hash__(self) -> int: """ Returns a hash value for this Specifier-like object. """ @abc.abstractmethod def __eq__(self, other: object) -> bool: """ Returns a boolean representing whether or not the two Specifier-like objects are equal. :param other: The other object to check against. """ @property @abc.abstractmethod def prereleases(self) -> bool | None: """Whether or not pre-releases as a whole are allowed. This can be set to either ``True`` or ``False`` to explicitly enable or disable prereleases or it can be set to ``None`` (the default) to use default semantics. """ @prereleases.setter def prereleases(self, value: bool) -> None: """Setter for :attr:`prereleases`. :param value: The value to set. """ @abc.abstractmethod def contains(self, item: str, prereleases: bool | None = None) -> bool: """ Determines if the given item is contained within this specifier. """ @abc.abstractmethod def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None ) -> Iterator[UnparsedVersionVar]: """ Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. """ class Specifier(BaseSpecifier): """This class abstracts handling of version specifiers. .. tip:: It is generally not required to instantiate this manually. You should instead prefer to work with :class:`SpecifierSet` instead, which can parse comma-separated version specifiers (which is what package metadata contains). """ _operator_regex_str = r""" (?P<operator>(~=|==|!=|<=|>=|<|>|===)) """ _version_regex_str = r""" (?P<version> (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. (?<====) # Only match for the identity operator \s* [^\s;)]* # The arbitrary version can be just about anything, # we match everything except for whitespace, a # semi-colon for marker support, and a closing paren # since versions can be enclosed in them. ) | (?: # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. (?<===|!=) # Only match for equals and not equals \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release # You cannot use a wild card and a pre-release, post-release, a dev or # local version together so group them with a | and make them optional. (?: \.\* # Wild card syntax of .* | (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local )? ) | (?: # The compatible operator requires at least two digits in the # release segment. (?<=~=) # Only match for the compatible operator \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *) (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) | (?: # All other operators only allow a sub set of what the # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. (?<!==|!=|~=) # We have special cases for these # operators so we want to make sure they # don't match here. \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release (?: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? (?: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) """ _regex = re.compile( r"^\s*" + _operator_regex_str + _version_regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE, ) _operators = { "~=": "compatible", "==": "equal", "!=": "not_equal", "<=": "less_than_equal", ">=": "greater_than_equal", "<": "less_than", ">": "greater_than", "===": "arbitrary", } def __init__(self, spec: str = "", prereleases: bool | None = None) -> None: """Initialize a Specifier instance. :param spec: The string representation of a specifier which will be parsed and normalized before use. :param prereleases: This tells the specifier if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given specifier is invalid (i.e. bad syntax). """ match = self._regex.search(spec) if not match: raise InvalidSpecifier(f"Invalid specifier: {spec!r}") self._spec: tuple[str, str] = ( match.group("operator").strip(), match.group("version").strip(), ) # Store whether or not this Specifier should accept prereleases self._prereleases = prereleases # https://github.com/python/mypy/pull/13475#pullrequestreview-1079784515 @property # type: ignore[override] def prereleases(self) -> bool: # If there is an explicit prereleases set for this, then we'll just # blindly use that. if self._prereleases is not None: return self._prereleases # Look at all of our specifiers and determine if they are inclusive # operators, and if they are if they are including an explicit # prerelease. operator, version = self._spec if operator in ["==", ">=", "<=", "~=", "===", ">", "<"]: # The == specifier can include a trailing .*, if it does we # want to remove before parsing. if operator == "==" and version.endswith(".*"): version = version[:-2] # Parse the version, and if it is a pre-release than this # specifier allows pre-releases. if Version(version).is_prerelease: return True return False @prereleases.setter def prereleases(self, value: bool) -> None: self._prereleases = value @property def operator(self) -> str: """The operator of this specifier. >>> Specifier("==1.2.3").operator '==' """ return self._spec[0] @property def version(self) -> str: """The version of this specifier. >>> Specifier("==1.2.3").version '1.2.3' """ return self._spec[1] def __repr__(self) -> str: """A representation of the Specifier that shows all internal state. >>> Specifier('>=1.0.0') <Specifier('>=1.0.0')> >>> Specifier('>=1.0.0', prereleases=False) <Specifier('>=1.0.0', prereleases=False)> >>> Specifier('>=1.0.0', prereleases=True) <Specifier('>=1.0.0', prereleases=True)> """ pre = ( f", prereleases={self.prereleases!r}" if self._prereleases is not None else "" ) return f"<{self.__class__.__name__}({str(self)!r}{pre})>" def __str__(self) -> str: """A string representation of the Specifier that can be round-tripped. >>> str(Specifier('>=1.0.0')) '>=1.0.0' >>> str(Specifier('>=1.0.0', prereleases=False)) '>=1.0.0' """ return "{}{}".format(*self._spec) @property def _canonical_spec(self) -> tuple[str, str]: canonical_version = canonicalize_version( self._spec[1], strip_trailing_zero=(self._spec[0] != "~="), ) return self._spec[0], canonical_version def __hash__(self) -> int: return hash(self._canonical_spec) def __eq__(self, other: object) -> bool: """Whether or not the two Specifier-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0") True >>> (Specifier("==1.2.3", prereleases=False) == ... Specifier("==1.2.3", prereleases=True)) True >>> Specifier("==1.2.3") == "==1.2.3" True >>> Specifier("==1.2.3") == Specifier("==1.2.4") False >>> Specifier("==1.2.3") == Specifier("~=1.2.3") False """ if isinstance(other, str): try: other = self.__class__(str(other)) except InvalidSpecifier: return NotImplemented elif not isinstance(other, self.__class__): return NotImplemented return self._canonical_spec == other._canonical_spec def _get_operator(self, op: str) -> CallableOperator: operator_callable: CallableOperator = getattr( self, f"_compare_{self._operators[op]}" ) return operator_callable def _compare_compatible(self, prospective: Version, spec: str) -> bool: # Compatible releases have an equivalent combination of >= and ==. That # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to # implement this in terms of the other specifiers instead of # implementing it ourselves. The only thing we need to do is construct # the other specifiers. # We want everything but the last item in the version, but we want to # ignore suffix segments. prefix = _version_join( list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] ) # Add the prefix notation to the end of our string prefix += ".*" return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( prospective, prefix ) def _compare_equal(self, prospective: Version, spec: str) -> bool: # We need special logic to handle prefix matching if spec.endswith(".*"): # In the case of prefix matching we want to ignore local segment. normalized_prospective = canonicalize_version( prospective.public, strip_trailing_zero=False ) # Get the normalized version string ignoring the trailing .* normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False) # Split the spec out by bangs and dots, and pretend that there is # an implicit dot in between a release segment and a pre-release segment. split_spec = _version_split(normalized_spec) # Split the prospective version out by bangs and dots, and pretend # that there is an implicit dot in between a release segment and # a pre-release segment. split_prospective = _version_split(normalized_prospective) # 0-pad the prospective version before shortening it to get the correct # shortened version. padded_prospective, _ = _pad_version(split_prospective, split_spec) # Shorten the prospective version to be the same length as the spec # so that we can determine if the specifier is a prefix of the # prospective version or not. shortened_prospective = padded_prospective[: len(split_spec)] return shortened_prospective == split_spec else: # Convert our spec string into a Version spec_version = Version(spec) # If the specifier does not have a local segment, then we want to # act as if the prospective version also does not have a local # segment. if not spec_version.local: prospective = Version(prospective.public) return prospective == spec_version def _compare_not_equal(self, prospective: Version, spec: str) -> bool: return not self._compare_equal(prospective, spec) def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool: # NB: Local version identifiers are NOT permitted in the version # specifier, so local version labels can be universally removed from # the prospective version. return Version(prospective.public) <= Version(spec) def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool: # NB: Local version identifiers are NOT permitted in the version # specifier, so local version labels can be universally removed from # the prospective version. return Version(prospective.public) >= Version(spec) def _compare_less_than(self, prospective: Version, spec_str: str) -> bool: # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec_str) # Check to see if the prospective version is less than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective < spec: return False # This special case is here so that, unless the specifier itself # includes is a pre-release version, that we do not accept pre-release # versions for the version mentioned in the specifier (e.g. <3.1 should # not match 3.1.dev0, but should match 3.0.dev0). if not spec.is_prerelease and prospective.is_prerelease: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # less than the spec version *and* it's not a pre-release of the same # version in the spec. return True def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool: # Convert our spec to a Version instance, since we'll want to work with # it as a version. spec = Version(spec_str) # Check to see if the prospective version is greater than the spec # version. If it's not we can short circuit and just return False now # instead of doing extra unneeded work. if not prospective > spec: return False # This special case is here so that, unless the specifier itself # includes is a post-release version, that we do not accept # post-release versions for the version mentioned in the specifier # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). if not spec.is_postrelease and prospective.is_postrelease: if Version(prospective.base_version) == Version(spec.base_version): return False # Ensure that we do not allow a local version of the version mentioned # in the specifier, which is technically greater than, to match. if prospective.local is not None: if Version(prospective.base_version) == Version(spec.base_version): return False # If we've gotten to here, it means that prospective version is both # greater than the spec version *and* it's not a pre-release of the # same version in the spec. return True def _compare_arbitrary(self, prospective: Version, spec: str) -> bool: return str(prospective).lower() == str(spec).lower() def __contains__(self, item: str | Version) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in Specifier(">=1.2.3") True >>> Version("1.2.3") in Specifier(">=1.2.3") True >>> "1.0.0" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3") False >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True) True """ return self.contains(item) def contains(self, item: UnparsedVersion, prereleases: bool | None = None) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this Specifier. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> Specifier(">=1.2.3").contains("1.2.3") True >>> Specifier(">=1.2.3").contains(Version("1.2.3")) True >>> Specifier(">=1.2.3").contains("1.0.0") False >>> Specifier(">=1.2.3").contains("1.3.0a1") False >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1") True >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True) True """ # Determine if prereleases are to be allowed or not. if prereleases is None: prereleases = self.prereleases # Normalize item to a Version, this allows us to have a shortcut for # "2.0" in Specifier(">=2") normalized_item = _coerce_version(item) # Determine if we should be supporting prereleases in this specifier # or not, if we do not support prereleases than we can short circuit # logic if this version is a prereleases. if normalized_item.is_prerelease and not prereleases: return False # Actually do the comparison to determine if this item is contained # within this Specifier or not. operator_callable: CallableOperator = self._get_operator(self.operator) return operator_callable(normalized_item, self.version) def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None ) -> Iterator[UnparsedVersionVar]: """Filter items in the given iterable, that match the specifier. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(Specifier().contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")])) ['1.2.3', '1.3', <Version('1.4')>] >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"])) ['1.5a1'] >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] """ yielded = False found_prereleases = [] kw = {"prereleases": prereleases if prereleases is not None else True} # Attempt to iterate over all the values in the iterable and if any of # them match, yield them. for version in iterable: parsed_version = _coerce_version(version) if self.contains(parsed_version, **kw): # If our version is a prerelease, and we were not set to allow # prereleases, then we'll store it for later in case nothing # else matches this specifier. if parsed_version.is_prerelease and not ( prereleases or self.prereleases ): found_prereleases.append(version) # Either this is not a prerelease, or we should have been # accepting prereleases from the beginning. else: yielded = True yield version # Now that we've iterated over everything, determine if we've yielded # any values, and if we have not and we have any prereleases stored up # then we will go ahead and yield the prereleases. if not yielded and found_prereleases: for version in found_prereleases: yield version _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$") def _version_split(version: str) -> list[str]: """Split version into components. The split components are intended for version comparison. The logic does not attempt to retain the original version string, so joining the components back with :func:`_version_join` may not produce the original version string. """ result: list[str] = [] epoch, _, rest = version.rpartition("!") result.append(epoch or "0") for item in rest.split("."): match = _prefix_regex.search(item) if match: result.extend(match.groups()) else: result.append(item) return result def _version_join(components: list[str]) -> str: """Join split version components into a version string. This function assumes the input came from :func:`_version_split`, where the first component must be the epoch (either empty or numeric), and all other components numeric. """ epoch, *rest = components return f"{epoch}!{'.'.join(rest)}" def _is_not_suffix(segment: str) -> bool: return not any( segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post") ) def _pad_version(left: list[str], right: list[str]) -> tuple[list[str], list[str]]: left_split, right_split = [], [] # Get the release segment of our versions left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) # Get the rest of our versions left_split.append(left[len(left_split[0]) :]) right_split.append(right[len(right_split[0]) :]) # Insert our padding left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) return ( list(itertools.chain.from_iterable(left_split)), list(itertools.chain.from_iterable(right_split)), ) class SpecifierSet(BaseSpecifier): """This class abstracts handling of a set of version specifiers. It can be passed a single specifier (``>=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. """ def __init__( self, specifiers: str | Iterable[Specifier] = "", prereleases: bool | None = None, ) -> None: """Initialize a SpecifierSet instance. :param specifiers: The string representation of a specifier or a comma-separated list of specifiers which will be parsed and normalized before use. May also be an iterable of ``Specifier`` instances, which will be used as is. :param prereleases: This tells the SpecifierSet if it should accept prerelease versions if applicable or not. The default of ``None`` will autodetect it from the given specifiers. :raises InvalidSpecifier: If the given ``specifiers`` are not parseable than this exception will be raised. """ if isinstance(specifiers, str): # Split on `,` to break each individual specifier into its own item, and # strip each item to remove leading/trailing whitespace. split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] # Make each individual specifier a Specifier and save in a frozen set # for later. self._specs = frozenset(map(Specifier, split_specifiers)) else: # Save the supplied specifiers in a frozen set. self._specs = frozenset(specifiers) # Store our prereleases value so we can use it later to determine if # we accept prereleases or not. self._prereleases = prereleases @property def prereleases(self) -> bool | None: # If we have been given an explicit prerelease modifier, then we'll # pass that through here. if self._prereleases is not None: return self._prereleases # If we don't have any specifiers, and we don't have a forced value, # then we'll just return None since we don't know if this should have # pre-releases or not. if not self._specs: return None # Otherwise we'll see if any of the given specifiers accept # prereleases, if any of them do we'll return True, otherwise False. return any(s.prereleases for s in self._specs) @prereleases.setter def prereleases(self, value: bool) -> None: self._prereleases = value def __repr__(self) -> str: """A representation of the specifier set that shows all internal state. Note that the ordering of the individual specifiers within the set may not match the input string. >>> SpecifierSet('>=1.0.0,!=2.0.0') <SpecifierSet('!=2.0.0,>=1.0.0')> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)> >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True) <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)> """ pre = ( f", prereleases={self.prereleases!r}" if self._prereleases is not None else "" ) return f"<SpecifierSet({str(self)!r}{pre})>" def __str__(self) -> str: """A string representation of the specifier set that can be round-tripped. Note that the ordering of the individual specifiers within the set may not match the input string. >>> str(SpecifierSet(">=1.0.0,!=1.0.1")) '!=1.0.1,>=1.0.0' >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) '!=1.0.1,>=1.0.0' """ return ",".join(sorted(str(s) for s in self._specs)) def __hash__(self) -> int: return hash(self._specs) def __and__(self, other: SpecifierSet | str) -> SpecifierSet: """Return a SpecifierSet which is a combination of the two sets. :param other: The other object to combine with. >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1' <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1') <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')> """ if isinstance(other, str): other = SpecifierSet(other) elif not isinstance(other, SpecifierSet): return NotImplemented specifier = SpecifierSet() specifier._specs = frozenset(self._specs | other._specs) if self._prereleases is None and other._prereleases is not None: specifier._prereleases = other._prereleases elif self._prereleases is not None and other._prereleases is None: specifier._prereleases = self._prereleases elif self._prereleases == other._prereleases: specifier._prereleases = self._prereleases else: raise ValueError( "Cannot combine SpecifierSets with True and False prerelease " "overrides." ) return specifier def __eq__(self, other: object) -> bool: """Whether or not the two SpecifierSet-like objects are equal. :param other: The other object to check against. The value of :attr:`prereleases` is ignored. >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1") True >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) == ... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)) True >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1" True >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0") False >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2") False """ if isinstance(other, (str, Specifier)): other = SpecifierSet(str(other)) elif not isinstance(other, SpecifierSet): return NotImplemented return self._specs == other._specs def __len__(self) -> int: """Returns the number of specifiers in this specifier set.""" return len(self._specs) def __iter__(self) -> Iterator[Specifier]: """ Returns an iterator over all the underlying :class:`Specifier` instances in this specifier set. >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) [<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>] """ return iter(self._specs) def __contains__(self, item: UnparsedVersion) -> bool: """Return whether or not the item is contained in this specifier. :param item: The item to check for. This is used for the ``in`` operator and behaves the same as :meth:`contains` with no ``prereleases`` argument passed. >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1") True >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1") True >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1") False >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True) True """ return self.contains(item) def contains( self, item: UnparsedVersion, prereleases: bool | None = None, installed: bool | None = None, ) -> bool: """Return whether or not the item is contained in this SpecifierSet. :param item: The item to check for, which can be a version string or a :class:`Version` instance. :param prereleases: Whether or not to match prereleases with this SpecifierSet. If set to ``None`` (the default), it uses :attr:`prereleases` to determine whether or not prereleases are allowed. >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3")) True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1") False >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1") False >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1") True >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) True """ # Ensure that our item is a Version instance. if not isinstance(item, Version): item = Version(item) # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # We can determine if we're going to allow pre-releases by looking to # see if any of the underlying items supports them. If none of them do # and this item is a pre-release then we do not allow it and we can # short circuit that here. # Note: This means that 1.0.dev1 would not be contained in something # like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0 if not prereleases and item.is_prerelease: return False if installed and item.is_prerelease: item = Version(item.base_version) # We simply dispatch to the underlying specs here to make sure that the # given version is contained within all of them. # Note: This use of all() here means that an empty set of specifiers # will always return True, this is an explicit design decision. return all(s.contains(item, prereleases=prereleases) for s in self._specs) def filter( self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None ) -> Iterator[UnparsedVersionVar]: """Filter items in the given iterable, that match the specifiers in this set. :param iterable: An iterable that can contain version strings and :class:`Version` instances. The items in the iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will be intelligently decide whether to allow prereleases or not (based on the :attr:`prereleases` attribute, and whether the only versions matching are prereleases). This method is smarter than just ``filter(SpecifierSet(...).contains, [...])`` because it implements the rule from :pep:`440` that a prerelease item SHOULD be accepted if no other versions match the given specifier. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")])) ['1.3', <Version('1.4')>] >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"])) [] >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. >>> list(SpecifierSet("").filter(["1.3", "1.5a1"])) ['1.3'] >>> list(SpecifierSet("").filter(["1.5a1"])) ['1.5a1'] >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] """ # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the # SpecifierSet thinks for whether or not we should support prereleases. if prereleases is None: prereleases = self.prereleases # If we have any specifiers, then we want to wrap our iterable in the # filter method for each one, this will act as a logical AND amongst # each specifier. if self._specs: for spec in self._specs: iterable = spec.filter(iterable, prereleases=bool(prereleases)) return iter(iterable) # If we do not have any specifiers, then we need to have a rough filter # which will filter out any pre-releases, unless there are no final # releases. else: filtered: list[UnparsedVersionVar] = [] found_prereleases: list[UnparsedVersionVar] = [] for item in iterable: parsed_version = _coerce_version(item) # Store any item which is a pre-release for later unless we've # already found a final version or we are accepting prereleases if parsed_version.is_prerelease and not prereleases: if not filtered: found_prereleases.append(item) else: filtered.append(item) # If we've found no items except for pre-releases, then we'll go # ahead and use the pre-releases if not filtered and found_prereleases and prereleases is None: return iter(found_prereleases) return iter(filtered) _vendor/packaging/__init__.py 0000644 00000000756 15030122015 0012232 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. __title__ = "packaging" __summary__ = "Core utilities for Python packages" __uri__ = "https://github.com/pypa/packaging" __version__ = "24.2" __author__ = "Donald Stufft and individual contributors" __email__ = "donald@stufft.io" __license__ = "BSD-2-Clause or Apache-2.0" __copyright__ = f"2014 {__author__}" _vendor/packaging/utils.py 0000644 00000011672 15030122015 0011632 0 ustar 00 # This file is dual licensed under the terms of the Apache License, Version # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. from __future__ import annotations import functools import re from typing import NewType, Tuple, Union, cast from .tags import Tag, parse_tag from .version import InvalidVersion, Version, _TrimmedRelease BuildTag = Union[Tuple[()], Tuple[int, str]] NormalizedName = NewType("NormalizedName", str) class InvalidName(ValueError): """ An invalid distribution name; users should refer to the packaging user guide. """ class InvalidWheelFilename(ValueError): """ An invalid wheel filename was found, users should refer to PEP 427. """ class InvalidSdistFilename(ValueError): """ An invalid sdist filename was found, users should refer to the packaging user guide. """ # Core metadata spec for `Name` _validate_regex = re.compile( r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE ) _canonicalize_regex = re.compile(r"[-_.]+") _normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$") # PEP 427: The build number must start with a digit. _build_tag_regex = re.compile(r"(\d+)(.*)") def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: if validate and not _validate_regex.match(name): raise InvalidName(f"name is invalid: {name!r}") # This is taken from PEP 503. value = _canonicalize_regex.sub("-", name).lower() return cast(NormalizedName, value) def is_normalized_name(name: str) -> bool: return _normalized_regex.match(name) is not None @functools.singledispatch def canonicalize_version( version: Version | str, *, strip_trailing_zero: bool = True ) -> str: """ Return a canonical form of a version as a string. >>> canonicalize_version('1.0.1') '1.0.1' Per PEP 625, versions may have multiple canonical forms, differing only by trailing zeros. >>> canonicalize_version('1.0.0') '1' >>> canonicalize_version('1.0.0', strip_trailing_zero=False) '1.0.0' Invalid versions are returned unaltered. >>> canonicalize_version('foo bar baz') 'foo bar baz' """ return str(_TrimmedRelease(str(version)) if strip_trailing_zero else version) @canonicalize_version.register def _(version: str, *, strip_trailing_zero: bool = True) -> str: try: parsed = Version(version) except InvalidVersion: # Legacy versions cannot be normalized return version return canonicalize_version(parsed, strip_trailing_zero=strip_trailing_zero) def parse_wheel_filename( filename: str, ) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]: if not filename.endswith(".whl"): raise InvalidWheelFilename( f"Invalid wheel filename (extension must be '.whl'): {filename!r}" ) filename = filename[:-4] dashes = filename.count("-") if dashes not in (4, 5): raise InvalidWheelFilename( f"Invalid wheel filename (wrong number of parts): {filename!r}" ) parts = filename.split("-", dashes - 2) name_part = parts[0] # See PEP 427 for the rules on escaping the project name. if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: raise InvalidWheelFilename(f"Invalid project name: {filename!r}") name = canonicalize_name(name_part) try: version = Version(parts[1]) except InvalidVersion as e: raise InvalidWheelFilename( f"Invalid wheel filename (invalid version): {filename!r}" ) from e if dashes == 5: build_part = parts[2] build_match = _build_tag_regex.match(build_part) if build_match is None: raise InvalidWheelFilename( f"Invalid build number: {build_part} in {filename!r}" ) build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) else: build = () tags = parse_tag(parts[-1]) return (name, version, build, tags) def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: if filename.endswith(".tar.gz"): file_stem = filename[: -len(".tar.gz")] elif filename.endswith(".zip"): file_stem = filename[: -len(".zip")] else: raise InvalidSdistFilename( f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):" f" {filename!r}" ) # We are requiring a PEP 440 version, which cannot contain dashes, # so we split on the last dash. name_part, sep, version_part = file_stem.rpartition("-") if not sep: raise InvalidSdistFilename(f"Invalid sdist filename: {filename!r}") name = canonicalize_name(name_part) try: version = Version(version_part) except InvalidVersion as e: raise InvalidSdistFilename( f"Invalid sdist filename (invalid version): {filename!r}" ) from e return (name, version) _vendor/inflect-7.3.1.dist-info/RECORD 0000644 00000001657 15030122015 0013062 0 ustar 00 inflect-7.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 inflect-7.3.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 inflect-7.3.1.dist-info/METADATA,sha256=ZgMNY0WAZRs-U8wZiV2SMfjSKqBrMngXyDMs_CAwMwg,21079 inflect-7.3.1.dist-info/RECORD,, inflect-7.3.1.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91 inflect-7.3.1.dist-info/top_level.txt,sha256=m52ujdp10CqT6jh1XQxZT6kEntcnv-7Tl7UiGNTzWZA,8 inflect/__init__.py,sha256=Jxy1HJXZiZ85kHeLAhkmvz6EMTdFqBe-duvt34R6IOc,103796 inflect/__pycache__/__init__.cpython-312.pyc,, inflect/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 inflect/compat/__pycache__/__init__.cpython-312.pyc,, inflect/compat/__pycache__/py38.cpython-312.pyc,, inflect/compat/py38.py,sha256=oObVfVnWX9_OpnOuEJn1mFbJxVhwyR5epbiTNXDDaso,160 inflect/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 _vendor/inflect-7.3.1.dist-info/METADATA 0000644 00000051127 15030122015 0013261 0 ustar 00 Metadata-Version: 2.1 Name: inflect Version: 7.3.1 Summary: Correctly generate plurals, singular nouns, ordinals, indefinite articles Author-email: Paul Dyson <pwdyson@yahoo.com> Maintainer-email: "Jason R. Coombs" <jaraco@jaraco.com> Project-URL: Source, https://github.com/jaraco/inflect Keywords: plural,inflect,participle Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Natural Language :: English Classifier: Operating System :: OS Independent Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: Text Processing :: Linguistic Requires-Python: >=3.8 Description-Content-Type: text/x-rst License-File: LICENSE Requires-Dist: more-itertools >=8.5.0 Requires-Dist: typeguard >=4.0.1 Requires-Dist: typing-extensions ; python_version < "3.9" Provides-Extra: doc Requires-Dist: sphinx >=3.5 ; extra == 'doc' Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' Requires-Dist: rst.linker >=1.9 ; extra == 'doc' Requires-Dist: furo ; extra == 'doc' Requires-Dist: sphinx-lint ; extra == 'doc' Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' Provides-Extra: test Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' Requires-Dist: pytest-cov ; extra == 'test' Requires-Dist: pytest-mypy ; extra == 'test' Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' Requires-Dist: pygments ; extra == 'test' .. image:: https://img.shields.io/pypi/v/inflect.svg :target: https://pypi.org/project/inflect .. image:: https://img.shields.io/pypi/pyversions/inflect.svg .. image:: https://github.com/jaraco/inflect/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/inflect/actions?query=workflow%3A%22tests%22 :alt: tests .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff .. image:: https://readthedocs.org/projects/inflect/badge/?version=latest :target: https://inflect.readthedocs.io/en/latest/?badge=latest .. image:: https://img.shields.io/badge/skeleton-2024-informational :target: https://blog.jaraco.com/skeleton .. image:: https://tidelift.com/badges/package/pypi/inflect :target: https://tidelift.com/subscription/pkg/pypi-inflect?utm_source=pypi-inflect&utm_medium=readme NAME ==== inflect.py - Correctly generate plurals, singular nouns, ordinals, indefinite articles; convert numbers to words. SYNOPSIS ======== .. code-block:: python import inflect p = inflect.engine() # METHODS: # plural plural_noun plural_verb plural_adj singular_noun no num # compare compare_nouns compare_nouns compare_adjs # a an # present_participle # ordinal number_to_words # join # inflect classical gender # defnoun defverb defadj defa defan # UNCONDITIONALLY FORM THE PLURAL print("The plural of ", word, " is ", p.plural(word)) # CONDITIONALLY FORM THE PLURAL print("I saw", cat_count, p.plural("cat", cat_count)) # FORM PLURALS FOR SPECIFIC PARTS OF SPEECH print( p.plural_noun("I", N1), p.plural_verb("saw", N1), p.plural_adj("my", N2), p.plural_noun("saw", N2), ) # FORM THE SINGULAR OF PLURAL NOUNS print("The singular of ", word, " is ", p.singular_noun(word)) # SELECT THE GENDER OF SINGULAR PRONOUNS print(p.singular_noun("they")) # 'it' p.gender("feminine") print(p.singular_noun("they")) # 'she' # DEAL WITH "0/1/N" -> "no/1/N" TRANSLATION: print("There ", p.plural_verb("was", errors), p.no(" error", errors)) # USE DEFAULT COUNTS: print( p.num(N1, ""), p.plural("I"), p.plural_verb(" saw"), p.num(N2), p.plural_noun(" saw"), ) print("There ", p.num(errors, ""), p.plural_verb("was"), p.no(" error")) # COMPARE TWO WORDS "NUMBER-INSENSITIVELY": if p.compare(word1, word2): print("same") if p.compare_nouns(word1, word2): print("same noun") if p.compare_verbs(word1, word2): print("same verb") if p.compare_adjs(word1, word2): print("same adj.") # ADD CORRECT "a" OR "an" FOR A GIVEN WORD: print("Did you want ", p.a(thing), " or ", p.an(idea)) # CONVERT NUMERALS INTO ORDINALS (i.e. 1->1st, 2->2nd, 3->3rd, etc.) print("It was", p.ordinal(position), " from the left\n") # CONVERT NUMERALS TO WORDS (i.e. 1->"one", 101->"one hundred and one", etc.) # RETURNS A SINGLE STRING... words = p.number_to_words(1234) # "one thousand, two hundred and thirty-four" words = p.number_to_words(p.ordinal(1234)) # "one thousand, two hundred and thirty-fourth" # GET BACK A LIST OF STRINGS, ONE FOR EACH "CHUNK"... words = p.number_to_words(1234, wantlist=True) # ("one thousand","two hundred and thirty-four") # OPTIONAL PARAMETERS CHANGE TRANSLATION: words = p.number_to_words(12345, group=1) # "one, two, three, four, five" words = p.number_to_words(12345, group=2) # "twelve, thirty-four, five" words = p.number_to_words(12345, group=3) # "one twenty-three, forty-five" words = p.number_to_words(1234, andword="") # "one thousand, two hundred thirty-four" words = p.number_to_words(1234, andword=", plus") # "one thousand, two hundred, plus thirty-four" # TODO: I get no comma before plus: check perl words = p.number_to_words(555_1202, group=1, zero="oh") # "five, five, five, one, two, oh, two" words = p.number_to_words(555_1202, group=1, one="unity") # "five, five, five, unity, two, oh, two" words = p.number_to_words(123.456, group=1, decimal="mark") # "one two three mark four five six" # TODO: DOCBUG: perl gives commas here as do I # LITERAL STYLE ONLY NAMES NUMBERS LESS THAN A CERTAIN THRESHOLD... words = p.number_to_words(9, threshold=10) # "nine" words = p.number_to_words(10, threshold=10) # "ten" words = p.number_to_words(11, threshold=10) # "11" words = p.number_to_words(1000, threshold=10) # "1,000" # JOIN WORDS INTO A LIST: mylist = p.join(("apple", "banana", "carrot")) # "apple, banana, and carrot" mylist = p.join(("apple", "banana")) # "apple and banana" mylist = p.join(("apple", "banana", "carrot"), final_sep="") # "apple, banana and carrot" # REQUIRE "CLASSICAL" PLURALS (EG: "focus"->"foci", "cherub"->"cherubim") p.classical() # USE ALL CLASSICAL PLURALS p.classical(all=True) # USE ALL CLASSICAL PLURALS p.classical(all=False) # SWITCH OFF CLASSICAL MODE p.classical(zero=True) # "no error" INSTEAD OF "no errors" p.classical(zero=False) # "no errors" INSTEAD OF "no error" p.classical(herd=True) # "2 buffalo" INSTEAD OF "2 buffalos" p.classical(herd=False) # "2 buffalos" INSTEAD OF "2 buffalo" p.classical(persons=True) # "2 chairpersons" INSTEAD OF "2 chairpeople" p.classical(persons=False) # "2 chairpeople" INSTEAD OF "2 chairpersons" p.classical(ancient=True) # "2 formulae" INSTEAD OF "2 formulas" p.classical(ancient=False) # "2 formulas" INSTEAD OF "2 formulae" # INTERPOLATE "plural()", "plural_noun()", "plural_verb()", "plural_adj()", "singular_noun()", # a()", "an()", "num()" AND "ordinal()" WITHIN STRINGS: print(p.inflect("The plural of {0} is plural('{0}')".format(word))) print(p.inflect("The singular of {0} is singular_noun('{0}')".format(word))) print(p.inflect("I saw {0} plural('cat',{0})".format(cat_count))) print( p.inflect( "plural('I',{0}) " "plural_verb('saw',{0}) " "plural('a',{1}) " "plural_noun('saw',{1})".format(N1, N2) ) ) print( p.inflect( "num({0}, False)plural('I') " "plural_verb('saw') " "num({1}, False)plural('a') " "plural_noun('saw')".format(N1, N2) ) ) print(p.inflect("I saw num({0}) plural('cat')\nnum()".format(cat_count))) print(p.inflect("There plural_verb('was',{0}) no('error',{0})".format(errors))) print(p.inflect("There num({0}, False)plural_verb('was') no('error')".format(errors))) print(p.inflect("Did you want a('{0}') or an('{1}')".format(thing, idea))) print(p.inflect("It was ordinal('{0}') from the left".format(position))) # ADD USER-DEFINED INFLECTIONS (OVERRIDING INBUILT RULES): p.defnoun("VAX", "VAXen") # SINGULAR => PLURAL p.defverb( "will", # 1ST PERSON SINGULAR "shall", # 1ST PERSON PLURAL "will", # 2ND PERSON SINGULAR "will", # 2ND PERSON PLURAL "will", # 3RD PERSON SINGULAR "will", # 3RD PERSON PLURAL ) p.defadj("hir", "their") # SINGULAR => PLURAL p.defa("h") # "AY HALWAYS SEZ 'HAITCH'!" p.defan("horrendous.*") # "AN HORRENDOUS AFFECTATION" DESCRIPTION =========== The methods of the class ``engine`` in module ``inflect.py`` provide plural inflections, singular noun inflections, "a"/"an" selection for English words, and manipulation of numbers as words. Plural forms of all nouns, most verbs, and some adjectives are provided. Where appropriate, "classical" variants (for example: "brother" -> "brethren", "dogma" -> "dogmata", etc.) are also provided. Single forms of nouns are also provided. The gender of singular pronouns can be chosen (for example "they" -> "it" or "she" or "he" or "they"). Pronunciation-based "a"/"an" selection is provided for all English words, and most initialisms. It is also possible to inflect numerals (1,2,3) to ordinals (1st, 2nd, 3rd) and to English words ("one", "two", "three"). In generating these inflections, ``inflect.py`` follows the Oxford English Dictionary and the guidelines in Fowler's Modern English Usage, preferring the former where the two disagree. The module is built around standard British spelling, but is designed to cope with common American variants as well. Slang, jargon, and other English dialects are *not* explicitly catered for. Where two or more inflected forms exist for a single word (typically a "classical" form and a "modern" form), ``inflect.py`` prefers the more common form (typically the "modern" one), unless "classical" processing has been specified (see `MODERN VS CLASSICAL INFLECTIONS`). FORMING PLURALS AND SINGULARS ============================= Inflecting Plurals and Singulars -------------------------------- All of the ``plural...`` plural inflection methods take the word to be inflected as their first argument and return the corresponding inflection. Note that all such methods expect the *singular* form of the word. The results of passing a plural form are undefined (and unlikely to be correct). Similarly, the ``si...`` singular inflection method expects the *plural* form of the word. The ``plural...`` methods also take an optional second argument, which indicates the grammatical "number" of the word (or of another word with which the word being inflected must agree). If the "number" argument is supplied and is not ``1`` (or ``"one"`` or ``"a"``, or some other adjective that implies the singular), the plural form of the word is returned. If the "number" argument *does* indicate singularity, the (uninflected) word itself is returned. If the number argument is omitted, the plural form is returned unconditionally. The ``si...`` method takes a second argument in a similar fashion. If it is some form of the number ``1``, or is omitted, the singular form is returned. Otherwise the plural is returned unaltered. The various methods of ``inflect.engine`` are: ``plural_noun(word, count=None)`` The method ``plural_noun()`` takes a *singular* English noun or pronoun and returns its plural. Pronouns in the nominative ("I" -> "we") and accusative ("me" -> "us") cases are handled, as are possessive pronouns ("mine" -> "ours"). ``plural_verb(word, count=None)`` The method ``plural_verb()`` takes the *singular* form of a conjugated verb (that is, one which is already in the correct "person" and "mood") and returns the corresponding plural conjugation. ``plural_adj(word, count=None)`` The method ``plural_adj()`` takes the *singular* form of certain types of adjectives and returns the corresponding plural form. Adjectives that are correctly handled include: "numerical" adjectives ("a" -> "some"), demonstrative adjectives ("this" -> "these", "that" -> "those"), and possessives ("my" -> "our", "cat's" -> "cats'", "child's" -> "childrens'", etc.) ``plural(word, count=None)`` The method ``plural()`` takes a *singular* English noun, pronoun, verb, or adjective and returns its plural form. Where a word has more than one inflection depending on its part of speech (for example, the noun "thought" inflects to "thoughts", the verb "thought" to "thought"), the (singular) noun sense is preferred to the (singular) verb sense. Hence ``plural("knife")`` will return "knives" ("knife" having been treated as a singular noun), whereas ``plural("knifes")`` will return "knife" ("knifes" having been treated as a 3rd person singular verb). The inherent ambiguity of such cases suggests that, where the part of speech is known, ``plural_noun``, ``plural_verb``, and ``plural_adj`` should be used in preference to ``plural``. ``singular_noun(word, count=None)`` The method ``singular_noun()`` takes a *plural* English noun or pronoun and returns its singular. Pronouns in the nominative ("we" -> "I") and accusative ("us" -> "me") cases are handled, as are possessive pronouns ("ours" -> "mine"). When third person singular pronouns are returned they take the neuter gender by default ("they" -> "it"), not ("they"-> "she") nor ("they" -> "he"). This can be changed with ``gender()``. Note that all these methods ignore any whitespace surrounding the word being inflected, but preserve that whitespace when the result is returned. For example, ``plural(" cat ")`` returns " cats ". ``gender(genderletter)`` The third person plural pronoun takes the same form for the female, male and neuter (e.g. "they"). The singular however, depends upon gender (e.g. "she", "he", "it" and "they" -- "they" being the gender neutral form.) By default ``singular_noun`` returns the neuter form, however, the gender can be selected with the ``gender`` method. Pass the first letter of the gender to ``gender`` to return the f(eminine), m(asculine), n(euter) or t(hey) form of the singular. e.g. gender('f') followed by singular_noun('themselves') returns 'herself'. Numbered plurals ---------------- The ``plural...`` methods return only the inflected word, not the count that was used to inflect it. Thus, in order to produce "I saw 3 ducks", it is necessary to use: .. code-block:: python print("I saw", N, p.plural_noun(animal, N)) Since the usual purpose of producing a plural is to make it agree with a preceding count, inflect.py provides a method (``no(word, count)``) which, given a word and a(n optional) count, returns the count followed by the correctly inflected word. Hence the previous example can be rewritten: .. code-block:: python print("I saw ", p.no(animal, N)) In addition, if the count is zero (or some other term which implies zero, such as ``"zero"``, ``"nil"``, etc.) the count is replaced by the word "no". Hence, if ``N`` had the value zero, the previous example would print (the somewhat more elegant):: I saw no animals rather than:: I saw 0 animals Note that the name of the method is a pun: the method returns either a number (a *No.*) or a ``"no"``, in front of the inflected word. Reducing the number of counts required -------------------------------------- In some contexts, the need to supply an explicit count to the various ``plural...`` methods makes for tiresome repetition. For example: .. code-block:: python print( plural_adj("This", errors), plural_noun(" error", errors), plural_verb(" was", errors), " fatal.", ) inflect.py therefore provides a method (``num(count=None, show=None)``) which may be used to set a persistent "default number" value. If such a value is set, it is subsequently used whenever an optional second "number" argument is omitted. The default value thus set can subsequently be removed by calling ``num()`` with no arguments. Hence we could rewrite the previous example: .. code-block:: python p.num(errors) print(p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal.") p.num() Normally, ``num()`` returns its first argument, so that it may also be "inlined" in contexts like: .. code-block:: python print(p.num(errors), p.plural_noun(" error"), p.plural_verb(" was"), " detected.") if severity > 1: print( p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal." ) However, in certain contexts (see `INTERPOLATING INFLECTIONS IN STRINGS`) it is preferable that ``num()`` return an empty string. Hence ``num()`` provides an optional second argument. If that argument is supplied (that is, if it is defined) and evaluates to false, ``num`` returns an empty string instead of its first argument. For example: .. code-block:: python print(p.num(errors, 0), p.no("error"), p.plural_verb(" was"), " detected.") if severity > 1: print( p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal." ) Number-insensitive equality --------------------------- inflect.py also provides a solution to the problem of comparing words of differing plurality through the methods ``compare(word1, word2)``, ``compare_nouns(word1, word2)``, ``compare_verbs(word1, word2)``, and ``compare_adjs(word1, word2)``. Each of these methods takes two strings, and compares them using the corresponding plural-inflection method (``plural()``, ``plural_noun()``, ``plural_verb()``, and ``plural_adj()`` respectively). The comparison returns true if: - the strings are equal, or - one string is equal to a plural form of the other, or - the strings are two different plural forms of the one word. Hence all of the following return true: .. code-block:: python p.compare("index", "index") # RETURNS "eq" p.compare("index", "indexes") # RETURNS "s:p" p.compare("index", "indices") # RETURNS "s:p" p.compare("indexes", "index") # RETURNS "p:s" p.compare("indices", "index") # RETURNS "p:s" p.compare("indices", "indexes") # RETURNS "p:p" p.compare("indexes", "indices") # RETURNS "p:p" p.compare("indices", "indices") # RETURNS "eq" As indicated by the comments in the previous example, the actual value returned by the various ``compare`` methods encodes which of the three equality rules succeeded: "eq" is returned if the strings were identical, "s:p" if the strings were singular and plural respectively, "p:s" for plural and singular, and "p:p" for two distinct plurals. Inequality is indicated by returning an empty string. It should be noted that two distinct singular words which happen to take the same plural form are *not* considered equal, nor are cases where one (singular) word's plural is the other (plural) word's singular. Hence all of the following return false: .. code-block:: python p.compare("base", "basis") # ALTHOUGH BOTH -> "bases" p.compare("syrinx", "syringe") # ALTHOUGH BOTH -> "syringes" p.compare("she", "he") # ALTHOUGH BOTH -> "they" p.compare("opus", "operas") # ALTHOUGH "opus" -> "opera" -> "operas" p.compare("taxi", "taxes") # ALTHOUGH "taxi" -> "taxis" -> "taxes" Note too that, although the comparison is "number-insensitive" it is *not* case-insensitive (that is, ``plural("time","Times")`` returns false. To obtain both number and case insensitivity, use the ``lower()`` method on both strings (that is, ``plural("time".lower(), "Times".lower())`` returns true). Related Functionality ===================== Shout out to these libraries that provide related functionality: * `WordSet <https://jaracotext.readthedocs.io/en/latest/#jaraco.text.WordSet>`_ parses identifiers like variable names into sets of words suitable for re-assembling in another form. * `word2number <https://pypi.org/project/word2number/>`_ converts words to a number. For Enterprise ============== Available as part of the Tidelift Subscription. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. `Learn more <https://tidelift.com/subscription/pkg/pypi-PROJECT?utm_source=pypi-PROJECT&utm_medium=referral&utm_campaign=github>`_. _vendor/inflect-7.3.1.dist-info/INSTALLER 0000644 00000000004 15030122015 0013422 0 ustar 00 pip _vendor/inflect-7.3.1.dist-info/WHEEL 0000644 00000000133 15030122015 0012734 0 ustar 00 Wheel-Version: 1.0 Generator: setuptools (70.2.0) Root-Is-Purelib: true Tag: py3-none-any _vendor/inflect-7.3.1.dist-info/LICENSE 0000644 00000001777 15030122015 0013171 0 ustar 00 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. _vendor/inflect-7.3.1.dist-info/top_level.txt 0000644 00000000010 15030122015 0014671 0 ustar 00 inflect _vendor/autocommand-2.2.2.dist-info/RECORD 0000644 00000002434 15030122015 0013732 0 ustar 00 autocommand-2.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 autocommand-2.2.2.dist-info/LICENSE,sha256=reeNBJgtaZctREqOFKlPh6IzTdOFXMgDSOqOJAqg3y0,7634 autocommand-2.2.2.dist-info/METADATA,sha256=OADZuR3O6iBlpu1ieTgzYul6w4uOVrk0P0BO5TGGAJk,15006 autocommand-2.2.2.dist-info/RECORD,, autocommand-2.2.2.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92 autocommand-2.2.2.dist-info/top_level.txt,sha256=AzfhgKKS8EdAwWUTSF8mgeVQbXOY9kokHB6kSqwwqu0,12 autocommand/__init__.py,sha256=zko5Rnvolvb-UXjCx_2ArPTGBWwUK5QY4LIQIKYR7As,1037 autocommand/__pycache__/__init__.cpython-312.pyc,, autocommand/__pycache__/autoasync.cpython-312.pyc,, autocommand/__pycache__/autocommand.cpython-312.pyc,, autocommand/__pycache__/automain.cpython-312.pyc,, autocommand/__pycache__/autoparse.cpython-312.pyc,, autocommand/__pycache__/errors.cpython-312.pyc,, autocommand/autoasync.py,sha256=AMdyrxNS4pqWJfP_xuoOcImOHWD-qT7x06wmKN1Vp-U,5680 autocommand/autocommand.py,sha256=hmkEmQ72HtL55gnURVjDOnsfYlGd5lLXbvT4KG496Qw,2505 autocommand/automain.py,sha256=A2b8i754Mxc_DjU9WFr6vqYDWlhz0cn8miu8d8EsxV8,2076 autocommand/autoparse.py,sha256=WVWmZJPcbzUKXP40raQw_0HD8qPJ2V9VG1eFFmmnFxw,11642 autocommand/errors.py,sha256=7aa3roh9Herd6nIKpQHNWEslWE8oq7GiHYVUuRqORnA,886 _vendor/autocommand-2.2.2.dist-info/METADATA 0000644 00000035236 15030122015 0014142 0 ustar 00 Metadata-Version: 2.1 Name: autocommand Version: 2.2.2 Summary: A library to create a command-line program from a function Home-page: https://github.com/Lucretiel/autocommand Author: Nathan West License: LGPLv3 Project-URL: Homepage, https://github.com/Lucretiel/autocommand Project-URL: Bug Tracker, https://github.com/Lucretiel/autocommand/issues Platform: any Classifier: Development Status :: 6 - Mature Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3) Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Topic :: Software Development Classifier: Topic :: Software Development :: Libraries Classifier: Topic :: Software Development :: Libraries :: Python Modules Requires-Python: >=3.7 Description-Content-Type: text/markdown License-File: LICENSE [](https://badge.fury.io/py/autocommand) # autocommand A library to automatically generate and run simple argparse parsers from function signatures. ## Installation Autocommand is installed via pip: ``` $ pip install autocommand ``` ## Usage Autocommand turns a function into a command-line program. It converts the function's parameter signature into command-line arguments, and automatically runs the function if the module was called as `__main__`. In effect, it lets your create a smart main function. ```python from autocommand import autocommand # This program takes exactly one argument and echos it. @autocommand(__name__) def echo(thing): print(thing) ``` ``` $ python echo.py hello hello $ python echo.py -h usage: echo [-h] thing positional arguments: thing optional arguments: -h, --help show this help message and exit $ python echo.py hello world # too many arguments usage: echo.py [-h] thing echo.py: error: unrecognized arguments: world ``` As you can see, autocommand converts the signature of the function into an argument spec. When you run the file as a program, autocommand collects the command-line arguments and turns them into function arguments. The function is executed with these arguments, and then the program exits with the return value of the function, via `sys.exit`. Autocommand also automatically creates a usage message, which can be invoked with `-h` or `--help`, and automatically prints an error message when provided with invalid arguments. ### Types You can use a type annotation to give an argument a type. Any type (or in fact any callable) that returns an object when given a string argument can be used, though there are a few special cases that are described later. ```python @autocommand(__name__) def net_client(host, port: int): ... ``` Autocommand will catch `TypeErrors` raised by the type during argument parsing, so you can supply a callable and do some basic argument validation as well. ### Trailing Arguments You can add a `*args` parameter to your function to give it trailing arguments. The command will collect 0 or more trailing arguments and supply them to `args` as a tuple. If a type annotation is supplied, the type is applied to each argument. ```python # Write the contents of each file, one by one @autocommand(__name__) def cat(*files): for filename in files: with open(filename) as file: for line in file: print(line.rstrip()) ``` ``` $ python cat.py -h usage: ipython [-h] [file [file ...]] positional arguments: file optional arguments: -h, --help show this help message and exit ``` ### Options To create `--option` switches, just assign a default. Autocommand will automatically create `--long` and `-s`hort switches. ```python @autocommand(__name__) def do_with_config(argument, config='~/foo.conf'): pass ``` ``` $ python example.py -h usage: example.py [-h] [-c CONFIG] argument positional arguments: argument optional arguments: -h, --help show this help message and exit -c CONFIG, --config CONFIG ``` The option's type is automatically deduced from the default, unless one is explicitly given in an annotation: ```python @autocommand(__name__) def http_connect(host, port=80): print('{}:{}'.format(host, port)) ``` ``` $ python http.py -h usage: http.py [-h] [-p PORT] host positional arguments: host optional arguments: -h, --help show this help message and exit -p PORT, --port PORT $ python http.py localhost localhost:80 $ python http.py localhost -p 8080 localhost:8080 $ python http.py localhost -p blah usage: http.py [-h] [-p PORT] host http.py: error: argument -p/--port: invalid int value: 'blah' ``` #### None If an option is given a default value of `None`, it reads in a value as normal, but supplies `None` if the option isn't provided. #### Switches If an argument is given a default value of `True` or `False`, or given an explicit `bool` type, it becomes an option switch. ```python @autocommand(__name__) def example(verbose=False, quiet=False): pass ``` ``` $ python example.py -h usage: example.py [-h] [-v] [-q] optional arguments: -h, --help show this help message and exit -v, --verbose -q, --quiet ``` Autocommand attempts to do the "correct thing" in these cases- if the default is `True`, then supplying the switch makes the argument `False`; if the type is `bool` and the default is some other `True` value, then supplying the switch makes the argument `False`, while not supplying the switch makes the argument the default value. Autocommand also supports the creation of switch inverters. Pass `add_nos=True` to `autocommand` to enable this. ``` @autocommand(__name__, add_nos=True) def example(verbose=False): pass ``` ``` $ python example.py -h usage: ipython [-h] [-v] [--no-verbose] optional arguments: -h, --help show this help message and exit -v, --verbose --no-verbose ``` Using the `--no-` version of a switch will pass the opposite value in as a function argument. If multiple switches are present, the last one takes precedence. #### Files If the default value is a file object, such as `sys.stdout`, then autocommand just looks for a string, for a file path. It doesn't do any special checking on the string, though (such as checking if the file exists); it's better to let the client decide how to handle errors in this case. Instead, it provides a special context manager called `smart_open`, which behaves exactly like `open` if a filename or other openable type is provided, but also lets you use already open files: ```python from autocommand import autocommand, smart_open import sys # Write the contents of stdin, or a file, to stdout @autocommand(__name__) def write_out(infile=sys.stdin): with smart_open(infile) as f: for line in f: print(line.rstrip()) # If a file was opened, it is closed here. If it was just stdin, it is untouched. ``` ``` $ echo "Hello World!" | python write_out.py | tee hello.txt Hello World! $ python write_out.py --infile hello.txt Hello World! ``` ### Descriptions and docstrings The `autocommand` decorator accepts `description` and `epilog` kwargs, corresponding to the `description <https://docs.python.org/3/library/argparse.html#description>`_ and `epilog <https://docs.python.org/3/library/argparse.html#epilog>`_ of the `ArgumentParser`. If no description is given, but the decorated function has a docstring, then it is taken as the `description` for the `ArgumentParser`. You can also provide both the description and epilog in the docstring by splitting it into two sections with 4 or more - characters. ```python @autocommand(__name__) def copy(infile=sys.stdin, outfile=sys.stdout): ''' Copy an the contents of a file (or stdin) to another file (or stdout) ---------- Some extra documentation in the epilog ''' with smart_open(infile) as istr: with smart_open(outfile, 'w') as ostr: for line in istr: ostr.write(line) ``` ``` $ python copy.py -h usage: copy.py [-h] [-i INFILE] [-o OUTFILE] Copy an the contents of a file (or stdin) to another file (or stdout) optional arguments: -h, --help show this help message and exit -i INFILE, --infile INFILE -o OUTFILE, --outfile OUTFILE Some extra documentation in the epilog $ echo "Hello World" | python copy.py --outfile hello.txt $ python copy.py --infile hello.txt --outfile hello2.txt $ python copy.py --infile hello2.txt Hello World ``` ### Parameter descriptions You can also attach description text to individual parameters in the annotation. To attach both a type and a description, supply them both in any order in a tuple ```python @autocommand(__name__) def copy_net( infile: 'The name of the file to send', host: 'The host to send the file to', port: (int, 'The port to connect to')): ''' Copy a file over raw TCP to a remote destination. ''' # Left as an exercise to the reader ``` ### Decorators and wrappers Autocommand automatically follows wrapper chains created by `@functools.wraps`. This means that you can apply other wrapping decorators to your main function, and autocommand will still correctly detect the signature. ```python from functools import wraps from autocommand import autocommand def print_yielded(func): ''' Convert a generator into a function that prints all yielded elements ''' @wraps(func) def wrapper(*args, **kwargs): for thing in func(*args, **kwargs): print(thing) return wrapper @autocommand(__name__, description= 'Print all the values from START to STOP, inclusive, in steps of STEP', epilog= 'STOP and STEP default to 1') @print_yielded def seq(stop, start=1, step=1): for i in range(start, stop + 1, step): yield i ``` ``` $ seq.py -h usage: seq.py [-h] [-s START] [-S STEP] stop Print all the values from START to STOP, inclusive, in steps of STEP positional arguments: stop optional arguments: -h, --help show this help message and exit -s START, --start START -S STEP, --step STEP STOP and STEP default to 1 ``` Even though autocommand is being applied to the `wrapper` returned by `print_yielded`, it still retreives the signature of the underlying `seq` function to create the argument parsing. ### Custom Parser While autocommand's automatic parser generator is a powerful convenience, it doesn't cover all of the different features that argparse provides. If you need these features, you can provide your own parser as a kwarg to `autocommand`: ```python from argparse import ArgumentParser from autocommand import autocommand parser = ArgumentParser() # autocommand can't do optional positonal parameters parser.add_argument('arg', nargs='?') # or mutually exclusive options group = parser.add_mutually_exclusive_group() group.add_argument('-v', '--verbose', action='store_true') group.add_argument('-q', '--quiet', action='store_true') @autocommand(__name__, parser=parser) def main(arg, verbose, quiet): print(arg, verbose, quiet) ``` ``` $ python parser.py -h usage: write_file.py [-h] [-v | -q] [arg] positional arguments: arg optional arguments: -h, --help show this help message and exit -v, --verbose -q, --quiet $ python parser.py None False False $ python parser.py hello hello False False $ python parser.py -v None True False $ python parser.py -q None False True $ python parser.py -vq usage: parser.py [-h] [-v | -q] [arg] parser.py: error: argument -q/--quiet: not allowed with argument -v/--verbose ``` Any parser should work fine, so long as each of the parser's arguments has a corresponding parameter in the decorated main function. The order of parameters doesn't matter, as long as they are all present. Note that when using a custom parser, autocommand doesn't modify the parser or the retrieved arguments. This means that no description/epilog will be added, and the function's type annotations and defaults (if present) will be ignored. ## Testing and Library use The decorated function is only called and exited from if the first argument to `autocommand` is `'__main__'` or `True`. If it is neither of these values, or no argument is given, then a new main function is created by the decorator. This function has the signature `main(argv=None)`, and is intended to be called with arguments as if via `main(sys.argv[1:])`. The function has the attributes `parser` and `main`, which are the generated `ArgumentParser` and the original main function that was decorated. This is to facilitate testing and library use of your main. Calling the function triggers a `parse_args()` with the supplied arguments, and returns the result of the main function. Note that, while it returns instead of calling `sys.exit`, the `parse_args()` function will raise a `SystemExit` in the event of a parsing error or `-h/--help` argument. ```python @autocommand() def test_prog(arg1, arg2: int, quiet=False, verbose=False): if not quiet: print(arg1, arg2) if verbose: print("LOUD NOISES") return 0 print(test_prog(['-v', 'hello', '80'])) ``` ``` $ python test_prog.py hello 80 LOUD NOISES 0 ``` If the function is called with no arguments, `sys.argv[1:]` is used. This is to allow the autocommand function to be used as a setuptools entry point. ## Exceptions and limitations - There are a few possible exceptions that `autocommand` can raise. All of them derive from `autocommand.AutocommandError`. - If an invalid annotation is given (that is, it isn't a `type`, `str`, `(type, str)`, or `(str, type)`, an `AnnotationError` is raised. The `type` may be any callable, as described in the `Types`_ section. - If the function has a `**kwargs` parameter, a `KWargError` is raised. - If, somehow, the function has a positional-only parameter, a `PositionalArgError` is raised. This means that the argument doesn't have a name, which is currently not possible with a plain `def` or `lambda`, though many built-in functions have this kind of parameter. - There are a few argparse features that are not supported by autocommand. - It isn't possible to have an optional positional argument (as opposed to a `--option`). POSIX thinks this is bad form anyway. - It isn't possible to have mutually exclusive arguments or options - It isn't possible to have subcommands or subparsers, though I'm working on a few solutions involving classes or nested function definitions to allow this. ## Development Autocommand cannot be important from the project root; this is to enforce separation of concerns and prevent accidental importing of `setup.py` or tests. To develop, install the project in editable mode: ``` $ python setup.py develop ``` This will create a link to the source files in the deployment directory, so that any source changes are reflected when it is imported. _vendor/autocommand-2.2.2.dist-info/INSTALLER 0000644 00000000004 15030122015 0014300 0 ustar 00 pip _vendor/autocommand-2.2.2.dist-info/WHEEL 0000644 00000000134 15030122015 0013613 0 ustar 00 Wheel-Version: 1.0 Generator: bdist_wheel (0.38.4) Root-Is-Purelib: true Tag: py3-none-any _vendor/autocommand-2.2.2.dist-info/LICENSE 0000644 00000016722 15030122015 0014043 0 ustar 00 GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library. _vendor/autocommand-2.2.2.dist-info/top_level.txt 0000644 00000000014 15030122015 0015553 0 ustar 00 autocommand glob.py 0000644 00000013656 15030122015 0006041 0 ustar 00 """ Filename globbing utility. Mostly a copy of `glob` from Python 3.5. Changes include: * `yield from` and PEP3102 `*` removed. * Hidden files are not ignored. """ from __future__ import annotations import fnmatch import os import re from collections.abc import Iterable, Iterator from typing import TYPE_CHECKING, AnyStr, overload if TYPE_CHECKING: from _typeshed import BytesPath, StrOrBytesPath, StrPath __all__ = ["glob", "iglob", "escape"] def glob(pathname: AnyStr, recursive: bool = False) -> list[AnyStr]: """Return a list of paths matching a pathname pattern. The pattern may contain simple shell-style wildcards a la fnmatch. However, unlike fnmatch, filenames starting with a dot are special cases that are not matched by '*' and '?' patterns. If recursive is true, the pattern '**' will match any files and zero or more directories and subdirectories. """ return list(iglob(pathname, recursive=recursive)) def iglob(pathname: AnyStr, recursive: bool = False) -> Iterator[AnyStr]: """Return an iterator which yields the paths matching a pathname pattern. The pattern may contain simple shell-style wildcards a la fnmatch. However, unlike fnmatch, filenames starting with a dot are special cases that are not matched by '*' and '?' patterns. If recursive is true, the pattern '**' will match any files and zero or more directories and subdirectories. """ it = _iglob(pathname, recursive) if recursive and _isrecursive(pathname): s = next(it) # skip empty string assert not s return it def _iglob(pathname: AnyStr, recursive: bool) -> Iterator[AnyStr]: dirname, basename = os.path.split(pathname) glob_in_dir = glob2 if recursive and _isrecursive(basename) else glob1 if not has_magic(pathname): if basename: if os.path.lexists(pathname): yield pathname else: # Patterns ending with a slash should match only directories if os.path.isdir(dirname): yield pathname return if not dirname: yield from glob_in_dir(dirname, basename) return # `os.path.split()` returns the argument itself as a dirname if it is a # drive or UNC path. Prevent an infinite recursion if a drive or UNC path # contains magic characters (i.e. r'\\?\C:'). if dirname != pathname and has_magic(dirname): dirs: Iterable[AnyStr] = _iglob(dirname, recursive) else: dirs = [dirname] if not has_magic(basename): glob_in_dir = glob0 for dirname in dirs: for name in glob_in_dir(dirname, basename): yield os.path.join(dirname, name) # These 2 helper functions non-recursively glob inside a literal directory. # They return a list of basenames. `glob1` accepts a pattern while `glob0` # takes a literal basename (so it only has to check for its existence). @overload def glob1(dirname: StrPath, pattern: str) -> list[str]: ... @overload def glob1(dirname: BytesPath, pattern: bytes) -> list[bytes]: ... def glob1(dirname: StrOrBytesPath, pattern: str | bytes) -> list[str] | list[bytes]: if not dirname: if isinstance(pattern, bytes): dirname = os.curdir.encode('ASCII') else: dirname = os.curdir try: names = os.listdir(dirname) except OSError: return [] # mypy false-positives: str or bytes type possibility is always kept in sync return fnmatch.filter(names, pattern) # type: ignore[type-var, return-value] def glob0(dirname, basename): if not basename: # `os.path.split()` returns an empty basename for paths ending with a # directory separator. 'q*x/' should match only directories. if os.path.isdir(dirname): return [basename] else: if os.path.lexists(os.path.join(dirname, basename)): return [basename] return [] # This helper function recursively yields relative pathnames inside a literal # directory. @overload def glob2(dirname: StrPath, pattern: str) -> Iterator[str]: ... @overload def glob2(dirname: BytesPath, pattern: bytes) -> Iterator[bytes]: ... def glob2(dirname: StrOrBytesPath, pattern: str | bytes) -> Iterator[str | bytes]: assert _isrecursive(pattern) yield pattern[:0] yield from _rlistdir(dirname) # Recursively yields relative pathnames inside a literal directory. @overload def _rlistdir(dirname: StrPath) -> Iterator[str]: ... @overload def _rlistdir(dirname: BytesPath) -> Iterator[bytes]: ... def _rlistdir(dirname: StrOrBytesPath) -> Iterator[str | bytes]: if not dirname: if isinstance(dirname, bytes): dirname = os.curdir.encode('ASCII') else: dirname = os.curdir try: names = os.listdir(dirname) except OSError: return for x in names: yield x # mypy false-positives: str or bytes type possibility is always kept in sync path = os.path.join(dirname, x) if dirname else x # type: ignore[arg-type] for y in _rlistdir(path): yield os.path.join(x, y) # type: ignore[arg-type] magic_check = re.compile('([*?[])') magic_check_bytes = re.compile(b'([*?[])') def has_magic(s: str | bytes) -> bool: if isinstance(s, bytes): return magic_check_bytes.search(s) is not None else: return magic_check.search(s) is not None def _isrecursive(pattern: str | bytes) -> bool: if isinstance(pattern, bytes): return pattern == b'**' else: return pattern == '**' def escape(pathname): """Escape all special characters.""" # Escaping is done by wrapping any of "*?[" between square brackets. # Metacharacters do not work in the drive part and shouldn't be escaped. drive, pathname = os.path.splitdrive(pathname) if isinstance(pathname, bytes): pathname = magic_check_bytes.sub(rb'[\1]', pathname) else: pathname = magic_check.sub(r'[\1]', pathname) return drive + pathname script (dev).tmpl 0000644 00000000332 15030122015 0007611 0 ustar 00 # EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r __requires__ = %(spec)r __import__('pkg_resources').require(%(spec)r) __file__ = %(dev_path)r with open(__file__) as f: exec(compile(f.read(), __file__, 'exec')) launch.py 0000644 00000001464 15030122015 0006362 0 ustar 00 """ Launch the Python script on the command line after setuptools is bootstrapped via import. """ # Note that setuptools gets imported implicitly by the # invocation of this script using python -m setuptools.launch import sys import tokenize def run() -> None: """ Run the script in sys.argv[1] as if it had been invoked naturally. """ __builtins__ script_name = sys.argv[1] namespace = dict( __file__=script_name, __name__='__main__', __doc__=None, ) sys.argv[:] = sys.argv[1:] open_ = getattr(tokenize, 'open', open) with open_(script_name) as fid: script = fid.read() norm_script = script.replace('\\r\\n', '\\n') code = compile(norm_script, script_name, 'exec') exec(code, namespace) if __name__ == '__main__': run() _static.py 0000644 00000011367 15030122015 0006541 0 ustar 00 from functools import wraps from typing import TypeVar import packaging.specifiers from .warnings import SetuptoolsDeprecationWarning class Static: """ Wrapper for built-in object types that are allow setuptools to identify static core metadata (in opposition to ``Dynamic``, as defined :pep:`643`). The trick is to mark values with :class:`Static` when they come from ``pyproject.toml`` or ``setup.cfg``, so if any plugin overwrite the value with a built-in, setuptools will be able to recognise the change. We inherit from built-in classes, so that we don't need to change the existing code base to deal with the new types. We also should strive for immutability objects to avoid changes after the initial parsing. """ _mutated_: bool = False # TODO: Remove after deprecation warning is solved def _prevent_modification(target: type, method: str, copying: str) -> None: """ Because setuptools is very flexible we cannot fully prevent plugins and user customizations from modifying static values that were parsed from config files. But we can attempt to block "in-place" mutations and identify when they were done. """ fn = getattr(target, method, None) if fn is None: return @wraps(fn) def _replacement(self: Static, *args, **kwargs): # TODO: After deprecation period raise NotImplementedError instead of warning # which obviated the existence and checks of the `_mutated_` attribute. self._mutated_ = True SetuptoolsDeprecationWarning.emit( "Direct modification of value will be disallowed", f""" In an effort to implement PEP 643, direct/in-place changes of static values that come from configuration files are deprecated. If you need to modify this value, please first create a copy with {copying} and make sure conform to all relevant standards when overriding setuptools functionality (https://packaging.python.org/en/latest/specifications/). """, due_date=(2025, 10, 10), # Initially introduced in 2024-09-06 ) return fn(self, *args, **kwargs) _replacement.__doc__ = "" # otherwise doctest may fail. setattr(target, method, _replacement) class Str(str, Static): pass class Tuple(tuple, Static): pass class List(list, Static): """ :meta private: >>> x = List([1, 2, 3]) >>> is_static(x) True >>> x += [0] # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): SetuptoolsDeprecationWarning: Direct modification ... >>> is_static(x) # no longer static after modification False >>> y = list(x) >>> y.clear() >>> y [] >>> y == x False >>> is_static(List(y)) True """ # Make `List` immutable-ish # (certain places of setuptools/distutils issue a warn if we use tuple instead of list) for _method in ( '__delitem__', '__iadd__', '__setitem__', 'append', 'clear', 'extend', 'insert', 'remove', 'reverse', 'pop', ): _prevent_modification(List, _method, "`list(value)`") class Dict(dict, Static): """ :meta private: >>> x = Dict({'a': 1, 'b': 2}) >>> is_static(x) True >>> x['c'] = 0 # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): SetuptoolsDeprecationWarning: Direct modification ... >>> x._mutated_ True >>> is_static(x) # no longer static after modification False >>> y = dict(x) >>> y.popitem() ('b', 2) >>> y == x False >>> is_static(Dict(y)) True """ # Make `Dict` immutable-ish (we cannot inherit from types.MappingProxyType): for _method in ( '__delitem__', '__ior__', '__setitem__', 'clear', 'pop', 'popitem', 'setdefault', 'update', ): _prevent_modification(Dict, _method, "`dict(value)`") class SpecifierSet(packaging.specifiers.SpecifierSet, Static): """Not exactly a built-in type but useful for ``requires-python``""" T = TypeVar("T") def noop(value: T) -> T: """ >>> noop(42) 42 """ return value _CONVERSIONS = {str: Str, tuple: Tuple, list: List, dict: Dict} def attempt_conversion(value: T) -> T: """ >>> is_static(attempt_conversion("hello")) True >>> is_static(object()) False """ return _CONVERSIONS.get(type(value), noop)(value) # type: ignore[call-overload] def is_static(value: object) -> bool: """ >>> is_static(a := Dict({'a': 1})) True >>> is_static(dict(a)) False >>> is_static(b := List([1, 2, 3])) True >>> is_static(list(b)) False """ return isinstance(value, Static) and not value._mutated_ EMPTY_LIST = List() EMPTY_DICT = Dict() _normalization.py 0000644 00000013300 15030122015 0010125 0 ustar 00 """ Helpers for normalization as expected in wheel/sdist/module file names and core metadata """ import re from typing import TYPE_CHECKING import packaging # https://packaging.python.org/en/latest/specifications/core-metadata/#name _VALID_NAME = re.compile(r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.I) _UNSAFE_NAME_CHARS = re.compile(r"[^A-Z0-9._-]+", re.I) _NON_ALPHANUMERIC = re.compile(r"[^A-Z0-9]+", re.I) _PEP440_FALLBACK = re.compile(r"^v?(?P<safe>(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I) def safe_identifier(name: str) -> str: """Make a string safe to be used as Python identifier. >>> safe_identifier("12abc") '_12abc' >>> safe_identifier("__editable__.myns.pkg-78.9.3_local") '__editable___myns_pkg_78_9_3_local' """ safe = re.sub(r'\W|^(?=\d)', '_', name) assert safe.isidentifier() return safe def safe_name(component: str) -> str: """Escape a component used as a project name according to Core Metadata. >>> safe_name("hello world") 'hello-world' >>> safe_name("hello?world") 'hello-world' >>> safe_name("hello_world") 'hello_world' """ # See pkg_resources.safe_name return _UNSAFE_NAME_CHARS.sub("-", component) def safe_version(version: str) -> str: """Convert an arbitrary string into a valid version string. Can still raise an ``InvalidVersion`` exception. To avoid exceptions use ``best_effort_version``. >>> safe_version("1988 12 25") '1988.12.25' >>> safe_version("v0.2.1") '0.2.1' >>> safe_version("v0.2?beta") '0.2b0' >>> safe_version("v0.2 beta") '0.2b0' >>> safe_version("ubuntu lts") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts' """ v = version.replace(' ', '.') try: return str(packaging.version.Version(v)) except packaging.version.InvalidVersion: attempt = _UNSAFE_NAME_CHARS.sub("-", v) return str(packaging.version.Version(attempt)) def best_effort_version(version: str) -> str: """Convert an arbitrary string into a version-like string. Fallback when ``safe_version`` is not safe enough. >>> best_effort_version("v0.2 beta") '0.2b0' >>> best_effort_version("ubuntu lts") '0.dev0+sanitized.ubuntu.lts' >>> best_effort_version("0.23ubuntu1") '0.23.dev0+sanitized.ubuntu1' >>> best_effort_version("0.23-") '0.23.dev0+sanitized' >>> best_effort_version("0.-_") '0.dev0+sanitized' >>> best_effort_version("42.+?1") '42.dev0+sanitized.1' """ # See pkg_resources._forgiving_version try: return safe_version(version) except packaging.version.InvalidVersion: v = version.replace(' ', '.') match = _PEP440_FALLBACK.search(v) if match: safe = match["safe"] rest = v[len(safe) :] else: safe = "0" rest = version safe_rest = _NON_ALPHANUMERIC.sub(".", rest).strip(".") local = f"sanitized.{safe_rest}".strip(".") return safe_version(f"{safe}.dev0+{local}") def safe_extra(extra: str) -> str: """Normalize extra name according to PEP 685 >>> safe_extra("_FrIeNdLy-._.-bArD") 'friendly-bard' >>> safe_extra("FrIeNdLy-._.-bArD__._-") 'friendly-bard' """ return _NON_ALPHANUMERIC.sub("-", extra).strip("-").lower() def filename_component(value: str) -> str: """Normalize each component of a filename (e.g. distribution/version part of wheel) Note: ``value`` needs to be already normalized. >>> filename_component("my-pkg") 'my_pkg' """ return value.replace("-", "_").strip("_") def filename_component_broken(value: str) -> str: """ Produce the incorrect filename component for compatibility. See pypa/setuptools#4167 for detailed analysis. TODO: replace this with filename_component after pip 24 is nearly-ubiquitous. >>> filename_component_broken('foo_bar-baz') 'foo-bar-baz' """ return value.replace('_', '-') def safer_name(value: str) -> str: """Like ``safe_name`` but can be used as filename component for wheel""" # See bdist_wheel.safer_name return ( # Per https://packaging.python.org/en/latest/specifications/name-normalization/#name-normalization re.sub(r"[-_.]+", "-", safe_name(value)) .lower() # Per https://packaging.python.org/en/latest/specifications/binary-distribution-format/#escaping-and-unicode .replace("-", "_") ) def safer_best_effort_version(value: str) -> str: """Like ``best_effort_version`` but can be used as filename component for wheel""" # See bdist_wheel.safer_verion # TODO: Replace with only safe_version in the future (no need for best effort) return filename_component(best_effort_version(value)) def _missing_canonicalize_license_expression(expression: str) -> str: """ Defer import error to affect only users that actually use it https://github.com/pypa/setuptools/issues/4894 >>> _missing_canonicalize_license_expression("a OR b") Traceback (most recent call last): ... ImportError: ...Cannot import `packaging.licenses`... """ raise ImportError( "Cannot import `packaging.licenses`." """ Setuptools>=77.0.0 requires "packaging>=24.2" to work properly. Please make sure you have a suitable version installed. """ ) try: from packaging.licenses import ( canonicalize_license_expression as _canonicalize_license_expression, ) except ImportError: # pragma: nocover if not TYPE_CHECKING: # XXX: pyright is still upset even with # pyright: ignore[reportAssignmentType] _canonicalize_license_expression = _missing_canonicalize_license_expression __pycache__/wheel.cpython-310.pyc 0000644 00000017150 15030122015 0012552 0 ustar 00 o �h�! � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZ ddlZddlmZ ddlmZmZ dd lmZ dd lmZ e�d ej�j Z d Z ej d d� �Z ddd�Z!ej"dd� �Z#G dd� d�Z$dS )zWheels support.� N��sys_tags)�canonicalize_name)�Version)�_unpack_zipfile_obj)� _egg_basename�write_requirements� )�_read_utf8_with_fallback)� get_platformz�^(?P<project_name>.+?)-(?P<version>\d.*?) ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?) )\.whl$z8__import__('pkg_resources').declare_namespace(__name__) c C s dd� t � D �S )Nc S s h | ] }|j |j|jf�qS � )� interpreter�abi�platform��.0�tr r �C/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/wheel.py� <setcomp>' s z&_get_supported_tags.<locals>.<setcomp>r r r r r �_get_supported_tags" s r �returnc C s� t �| �D ]Q\}}}t j�|| �}|D ]}t j�||�}t j�|||�}t �||� qttt|���D ]"\} } t j�|| �}t j�||| �}t j� |�sUt �||� || = q3qt j| dd�D ]\}}}|rgJ �t � |� q^dS )zDMove everything under `src_dir` to `dst_dir`, and delete the former.T)�topdownN) �os�walk�path�relpath�join�renames�reversed�list� enumerate�exists�rmdir) �src_dir�dst_dir�dirpath�dirnames� filenames�subdir�f�src�dst�n�dr r r �unpack* s$ �� �r. c c s> � ddl m} | �| j�}z dV W | �|� dS | �|� w )z* Temporarily disable info traces. r )�logN)� distutilsr/ � set_threshold�WARN)r/ �savedr r r �disable_info_traces@ s � r4 c @ sl e Zd Zddd�Zdd� Zdd� Zd d � Zd d � Zdd d�Zdd� Z e dd� �Z e dd� �Z e dd� �Z dS )�Wheelr Nc C sR t tj�|��}|d u rtd|����|| _|�� �� D ] \}}t| ||� q d S )Nzinvalid wheel name: ) � WHEEL_NAMEr r �basename� ValueError�filename� groupdict�items�setattr)�selfr9 �match�k�vr r r �__init__O s �zWheel.__init__c C s& t �| j�d�| j�d�| j�d��S )z>List tags (py_version, abi, platform) supported by this wheel.�.)� itertools�product� py_version�splitr r �r= r r r �tagsW s �z Wheel.tagsc C s t dd� | �� D �d�S )z2Is the wheel compatible with the current platform?c s s � | ] }|t � v rd V qdS )TN)r r r r r � <genexpr>a s � z&Wheel.is_compatible.<locals>.<genexpr>F)�nextrH rG r r r � is_compatible_ s zWheel.is_compatiblec C s& t | j| j| jdkr d nt� d�d S )N�any)r z.egg)r � project_name�versionr r rG r r r �egg_namec s ���zWheel.egg_namec C sF |� � D ]}t�|�}|�d�r t|��t| j��r | S qtd��)Nz .dist-infoz.unsupported wheel format. .dist-info not found)�namelist� posixpath�dirname�endswithr � startswithrM r8 )r= �zf�memberrR r r r � get_dist_infom s ��zWheel.get_dist_infoc C s> t �| j��}| �||� W d � dS 1 sw Y dS )z"Install wheel as an egg directory.N)�zipfile�ZipFiler9 �_install_as_egg)r= �destination_eggdirrU r r r �install_as_eggw s "�zWheel.install_as_eggc C s` | j � d| j� �}| �|�}|� d�}tj�|d�}| �||||� | �||� | �||� d S )N�-z.data�EGG-INFO) rM rN rW r r r �_convert_metadata�_move_data_entries�_fix_namespace_packages)r= r[ rU � dist_basename� dist_info� dist_data�egg_infor r r rZ | s zWheel._install_as_eggc sJ dd l }��fdd�}|d�}t|�d��}td�| ko#td�k n }|s/td|� ���t�|� tj�|���|jj |�|� |��d �� d d � �t t �� � � ���� ��fd d �� jD �} t��|� t�tj�|d�tj�|d�� tjt�| d�d�} t� � t| �d�d tj�|d�� W d � d S 1 s�w Y d S )Nr c sT �� t�� | ���}|�� �d�}tj�� �|�W d � S 1 s#w Y d S )N�utf-8) �openrQ r �read�decode�email�parser�Parser�parsestr)�name�fp�value)rc rU r r � get_metadata� s $�z-Wheel._convert_metadata.<locals>.get_metadata�WHEELz Wheel-Versionz1.0z2.0dev0z"unsupported wheel format version: )�metadatac S s d | _ t| �S �N)�marker�str)�reqr r r �raw_req� s z(Wheel._convert_metadata.<locals>.raw_reqc s. i | ]}|�fd d�t �� �|f��D ��qS )c s g | ]}|� vr|�qS r r )r rw )�install_requiresr r � <listcomp>� s �z6Wheel._convert_metadata.<locals>.<dictcomp>.<listcomp>)�map�requires)r �extra)�distry rx r r � <dictcomp>� s ���z+Wheel._convert_metadata.<locals>.<dictcomp>�METADATAzPKG-INFO)ry �extras_require)�attrsre z requires.txt)� pkg_resources� parse_version�getr8 r r r r � Distribution� from_location� PathMetadatar r{ r| �extras�rename� setuptools�dictr4 r �get_command_obj) rU r[ rc re r� rq �wheel_metadata� wheel_version�wheel_v1r� � setup_distr )r~ rc ry rx rU r r_ � sJ � � ��� �"�zWheel._convert_metadatac s� t j�| � �� t j�� d�}t j�|�rNt j�| dd�}t �|� t �|�D ]"}|�d�r8t �t j�||�� q&t �t j�||�t j�||�� q&t � |� t t jj� fdd�dD ��D ]}t || � q\t j�� �rqt � � � dS dS )z,Move data entries to their correct location.�scriptsr^ z.pycc 3 s � | ] }t j�� |�V qd S rt )r r r )r r- �rd r r rI � s � � �z+Wheel._move_data_entries.<locals>.<genexpr>)�data�headers�purelib�platlibN) r r r r! �mkdir�listdirrS �unlinkr� r" �filterr. )r[ rd �dist_data_scripts�egg_info_scripts�entryr( r r� r r` � s. � �� �zWheel._move_data_entriesc C s� t j�| d�}t j�|�rYt|��� }|D ]E}t jj|g|�d��R � }t j�|d�}t j�|�s6t �|� t j�|�sXt|ddd�� }|�t � W d � n1 sSw Y qd S d S )Nznamespace_packages.txtrB z __init__.py�wrf )�encoding) r r r r! r rF r� rg �write�NAMESPACE_PACKAGE_INIT)re r[ �namespace_packages�mod�mod_dir�mod_initro r r r ra � s ���z Wheel._fix_namespace_packages�r N)�__name__� __module__� __qualname__rA rH rK rO rW r\ rZ � staticmethodr_ r` ra r r r r r5 N s : r5 r� )%�__doc__� contextlibrj � functoolsrC r rQ �rerX �packaging.tagsr �packaging.utilsr �packaging.versionr r� r� �setuptools.archive_utilr �setuptools.command.egg_infor r � unicode_utilsr �distutils.utilr �compile�VERBOSEr> r6 r� �cacher r. �contextmanagerr4 r5 r r r r �<module> s< �� __pycache__/windows_support.cpython-310.pyc 0000644 00000002010 15030122015 0014721 0 ustar 00 o �h� � @ s* d dl Z dd� Zededdfdd��ZdS )� Nc C s t �� dkr dd� S | S )N�Windowsc _ s d S )N� )�args�kwargsr r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/windows_support.py�<lambda> s z windows_only.<locals>.<lambda>)�platform�system)�funcr r r � windows_only s r �path�returnc C sT ddl }ddl}|jjj}|jj|jjf|_|jj |_ d}|| |�}|s(|� � �dS )z� Set the hidden attribute on a file or directory. From https://stackoverflow.com/questions/19622133/ `path` must be text. r N� ) �ctypes�ctypes.wintypes�windll�kernel32�SetFileAttributesW�wintypes�LPWSTR�DWORD�argtypes�BOOL�restype�WinError)r r �SetFileAttributes�FILE_ATTRIBUTE_HIDDEN�retr r r � hide_file s �r )r r �strr r r r r �<module> s __pycache__/_imp.cpython-310.pyc 0000644 00000004044 15030122015 0012370 0 ustar 00 o �h� � @ sl d Z ddlZddlZddlZddlZddlmZ dZdZdZ dZ dZ d d � Z dd d �Z dd d�Zdd� ZdS )zX Re-implementation of find_module and get_frozen_object from the deprecated imp module. � N)�module_from_spec� � � � � c C s( t |t�r tj�� jntjj}|| |�S �N)� isinstance�list� importlib� machinery� PathFinder� find_spec�util)�module�paths�finder� r �B/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_imp.pyr s �� r c C sJ t | |�}|du rtd| � ���|js t|d�r tj�d|j�}d}d}t|jt �}|j dks9|rBt |jtj j �rBt}d}d }}n[|j dksQ|rZt |jtj j�rZt}d}d }}nC|jr�|j }tj�|�d }|tj jv rpd nd }|tj jv r�t}t�|�}n |tj jv r�t}t|d �}n|tj jv r�t}nd}d }}|||||ffS ) z7Just like 'imp.find_module()', but with package supportN� Can't find �submodule_search_locationsz __init__.py����frozen� zbuilt-inr �r�rb) r � ImportError� has_location�hasattrr r �spec_from_loader�loaderr �type�origin� issubclassr �FrozenImporter� PY_FROZEN�BuiltinImporter� C_BUILTIN�os�path�splitext�SOURCE_SUFFIXES� PY_SOURCE�tokenize�open�BYTECODE_SUFFIXES� PY_COMPILED�EXTENSION_SUFFIXES� C_EXTENSION) r r �spec�kind�file�staticr) �suffix�moder r r � find_module sP �� �� �r9 c C s( t | |�}|std| � ���|j�| �S �Nr )r r r �get_code)r r r3 r r r �get_frozen_objectL s r< c C s$ t | |�}|std| � ���t|�S r: )r r r )r r �infor3 r r r � get_moduleS s r> r )�__doc__�importlib.machineryr �importlib.utilr( r- r r, r0 r2 r' r% r r9 r< r> r r r r �<module> s 0 __pycache__/msvc.cpython-310.pyc 0000644 00000107217 15030122015 0012422 0 ustar 00 o �h�� � @ s U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlZe r=ddlmZmZ e sPe�� dkrPddlZddlmZ nG d d � d �Ze� Zd ed < G d d� d�ZG dd� d�ZG dd� d�ZG dd� de �ZG dd� d�Z dS )zo Environment info about Microsoft Compilers. >>> getfixture('windows_only') >>> ei = EnvironmentInfo('amd64') � )� annotationsN)� TYPE_CHECKING� TypedDict)�unique_everseen)� LiteralString� NotRequired�Windows)�environc @ s e Zd ZdZdZdZdZdS )�winregN)�__name__� __module__� __qualname__� HKEY_USERS�HKEY_CURRENT_USER�HKEY_LOCAL_MACHINE�HKEY_CLASSES_ROOT� r r �B/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/msvc.pyr s r zdict[str, str]r c @ sh e Zd ZdZe�dd��� Zddd�Ze dd � �Z d d � Z d d � Z dddd�Z dddd�Zddd�ZdS )� PlatformInfoz� Current and Target Architectures information. Parameters ---------- arch: str Target architecture. �processor_architecture� �return�Nonec C s |� � �dd�| _d S )N�x64�amd64)�lower�replace�arch)�selfr r r r �__init__5 s zPlatformInfo.__init__c C s | j | j �d�d d� S )zs Return Target CPU architecture. Return ------ str Target CPU �_� N)r �find�r r r r � target_cpu8 s zPlatformInfo.target_cpuc C � | j dkS )z� Return True if target CPU is x86 32 bits.. Return ------ bool CPU is x86 32 bits �x86�r$ r# r r r � target_is_x86D � zPlatformInfo.target_is_x86c C r% )z� Return True if current CPU is x86 32 bits.. Return ------ bool CPU is x86 32 bits r& �� current_cpur# r r r �current_is_x86O r) zPlatformInfo.current_is_x86F�strc C �0 | j dkr |r dS | j dkr|rdS d| j � �S )uk Current platform specific subfolder. Parameters ---------- hidex86: bool return '' and not '' if architecture is x86. x64: bool return 'd' and not 'md64' if architecture is amd64. Return ------ str subfolder: ' arget', or '' (see hidex86 parameter) r& r r �\x64�\r* �r �hidex86r r r r � current_dirZ � ���� �zPlatformInfo.current_dirc C r. )ar Target platform specific subfolder. Parameters ---------- hidex86: bool return '' and not '\x86' if architecture is x86. x64: bool return '\x64' and not '\amd64' if architecture is amd64. Return ------ str subfolder: '\current', or '' (see hidex86 parameter) r& r r r/ r0 r' r1 r r r � target_dirr r4 zPlatformInfo.target_dirc C s4 |rdn| j }| j|krdS | �� �dd|� d��S )ap Cross platform specific subfolder. Parameters ---------- forcex86: bool Use 'x86' as current architecture even if current architecture is not x86. Return ------ str subfolder: '' if target architecture is current architecture, '\current_target' if not. r& r r0 r )r+ r$ r5 r )r �forcex86�currentr r r � cross_dir� s ���zPlatformInfo.cross_dirN�r r )FF�r r- �F)r r r �__doc__r �getr r+ r �propertyr$ r( r, r3 r5 r8 r r r r r ) s r c @ s� e Zd ZdZejejejejfZ d dd�Z e d dd��Z e d d � �Z e d d � �Ze d d� �Ze d dd��Ze d dd��Ze dd� �Ze dd� �Ze d dd��Zd!dd�Zd d � Zd S )"� RegistryInfoz� Microsoft Visual Studio related registry information. Parameters ---------- platform_info: PlatformInfo "PlatformInfo" instance. r r c C s || _ d S �N)�pi)r � platform_infor r r r � s zRegistryInfo.__init__r- c C � dS )z� Microsoft Visual Studio root registry key. Return ------ str Registry key � VisualStudior r# r r r � visualstudio� � zRegistryInfo.visualstudioc C � t j�| jd�S )z Microsoft Visual Studio SxS registry key. Return ------ str Registry key �SxS)�os�path�joinrE r# r r r �sxs� � zRegistryInfo.sxsc C rG )z| Microsoft Visual C++ VC7 registry key. Return ------ str Registry key �VC7�rI rJ rK rL r# r r r �vc� rM zRegistryInfo.vcc C rG )z Microsoft Visual Studio VS7 registry key. Return ------ str Registry key �VS7rO r# r r r �vs� rM zRegistryInfo.vsc C rC )z� Microsoft Visual C++ for Python registry key. Return ------ str Registry key zDevDiv\VCForPythonr r# r r r � vc_for_python� rF zRegistryInfo.vc_for_pythonc C rC )zq Microsoft SDK registry key. Return ------ str Registry key zMicrosoft SDKsr r# r r r � microsoft_sdk� rF zRegistryInfo.microsoft_sdkc C rG )z� Microsoft Windows/Platform SDK registry key. Return ------ str Registry key r �rI rJ rK rT r# r r r � windows_sdk� rM zRegistryInfo.windows_sdkc C rG )z� Microsoft .NET Framework SDK registry key. Return ------ str Registry key �NETFXSDKrU r# r r r � netfx_sdk rM zRegistryInfo.netfx_sdkc C rC )z� Microsoft Windows Kits Roots registry key. Return ------ str Registry key z Windows Kits\Installed Rootsr r# r r r �windows_kits_roots rF z RegistryInfo.windows_kits_rootsFc C s( | j �� s|r dnd}tj�d|d|�S )a Return key in Microsoft software registry. Parameters ---------- key: str Registry key path where look. x86: str Force x86 software registry. Return ------ str Registry key r � Wow6432Node�Software� Microsoft)rA r, rI rJ rK )r �keyr& �node64r r r � microsoft" s zRegistryInfo.microsoftc C s� t j}t j}t j}| j}| jD ]f}d}z ||||�d|�}W n' tyE | j�� sAz ||||d�d|�}W n ty@ Y Y qw Y qY nw z'zt � ||�d W W |rZ||� S S tye Y nw W |rm||� q|ru||� w w dS )a Look for values in registry in Microsoft software registry. Parameters ---------- key: str Registry key path where look. name: str Value name to find. Return ------ str value Nr T) r �KEY_READ�OpenKey�CloseKeyr_ �HKEYS�OSErrorrA r, � QueryValueEx) r r] �name�key_read�openkey�closekey�ms�hkey�bkeyr r r �lookup5 sD ���� ���� �zRegistryInfo.lookupNr9 r: r; )r r r r< r r r r r rc r r> rE rL rP rR rS rT rV rX rY r_ rm r r r r r? � s8 � r? c @ sJ e Zd ZdZe�dd�Ze�dd�Ze�de�Zd=d>d d �Z d d � Z d d� Z d?dd�Z e dd� �Zedd� �Zedd� �Zdd� Zdd� Zed@d d ��Zed d � �ZedAd"d#��Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zed,d-� �Zed.d/� �Z ed0d1� �Z ed2d3� �Z edBd5d6��Z edBd7d8��Z dBd9d:�Z!e dCd;d<��Z"dS )D� SystemInfoz� Microsoft Windows and Visual Studio related system information. Parameters ---------- registry_info: RegistryInfo "RegistryInfo" instance. vc_ver: float Required Microsoft Visual C++ version. �WinDirr � ProgramFileszProgramFiles(x86)Nr r c C s2 || _ | j j| _| �� | _|p| �� | _| _d S r@ )�rirA �find_programdata_vs_vers�known_vs_paths� _find_latest_available_vs_ver�vs_ver�vc_ver)r � registry_inforv r r r r q s zSystemInfo.__init__c C s> | � � }|s| jstj�d��t|�}|�| j� t|�d S )zm Find the latest VC version Return ------ float version z%No Microsoft Visual C++ version found���)�find_reg_vs_versrs � distutils�errors�DistutilsPlatformError�set�update�sorted)r � reg_vc_vers�vc_versr r r rt z s � z(SystemInfo._find_latest_available_vs_verc C s^ | j j}| j j| j j| j jf}g }t�| j j|�D ]�\}}z t� |||�dtj �}W n t y3 Y qw |�l t� |�\}}} t |�D ]*} t�t�� tt�|| �d �} | |vr^|�| � W d � n1 shw Y qCt |�D ](} t�t�� tt�|| ��} | |vr�|�| � W d � n1 s�w Y qrW d � n1 s�w Y qt|�S )z� Find Microsoft Visual Studio versions available in registry. Return ------ list of float Versions r N)rq r_ rP rS rR � itertools�productrc r ra r` rd � QueryInfoKey�range� contextlib�suppress� ValueError�float� EnumValue�append�EnumKeyr ) r rj �vckeys�vs_versrk r] rl �subkeys�valuesr �i�verr r r ry � s> � � �� � ��� �� zSystemInfo.find_reg_vs_vers�dict[float, str]c C s� i }d}zt �|�}W n ty | Y S w |D ]J}z=t j�||d�}t|ddd�� }t�|�}W d � n1 s;w Y |d }t �t j�|d�� ||| �|d �< W q tt fyc Y qw |S ) z� Find Visual studio 2017+ versions from information in "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances". Return ------ dict float version as key, path as value. z9C:\ProgramData\Microsoft\VisualStudio\Packages\_Instancesz state.json�rtzutf-8)�encodingN�installationPath� VC\Tools\MSVC�installationVersion) rI �listdirrd rJ rK �open�json�load�_as_float_version�KeyError) r � vs_versions� instances_dir� hashed_namesrf � state_path� state_file�state�vs_pathr r r rr � s* � ���z#SystemInfo.find_programdata_vs_versc C s t d�| �d�dd� ��S )z� Return a string version as a simplified float version (major.minor) Parameters ---------- version: str Version. Return ------ float version �.N� )r� rK �split)�versionr r r r� � s z SystemInfo._as_float_versionc C s6 t j�| jd| jd���}| j�| jj| jd��p|S )zp Microsoft Visual Studio directory. Return ------ str path �Microsoft Visual Studio �0.1f)rI rJ rK �ProgramFilesx86ru rq rm rR )r �defaultr r r � VSInstallDir� s � zSystemInfo.VSInstallDirc C s0 | � � p| �� }tj�|�sd}tj�|��|S )zm Microsoft Visual C++ directory. Return ------ str path z(Microsoft Visual C++ directory not found)� _guess_vc�_guess_vc_legacyrI rJ �isdirrz r{ r| )r rJ �msgr r r � VCInstallDir� s zSystemInfo.VCInstallDirc C s� | j dkrdS z| j| j }W n ty | j}Y nw tj�|d�}zt�|�d }| �|�| _ tj�||�W S t t fyD Y dS w )zl Locate Visual C++ for VS2017+. Return ------ str path � ,@r r� rx ) ru rs r� r� rI rJ rK r� r� rv rd � IndexError)r �vs_dir�guess_vcrv r r r r� s � �zSystemInfo._guess_vcc C st t j�| jd| jd�d��}t j�| jj| jd��}| j�|d�}|r*t j�|d�n|}| j�| jj| jd��p9|S )z{ Locate Visual C++ for versions prior to 2017. Return ------ str path r� r� z\VC� installdir�VC) rI rJ rK r� ru rq rS rm rP )r r� �reg_path� python_vc� default_vcr r r r� * s � zSystemInfo._guess_vc_legacy�tuple[LiteralString, ...]c C sJ | j dkrdS | j dkrdS | j dkrdS | j dkr dS | j d kr#d S d S ) z� Microsoft Windows SDK versions for specified MSVC++ version. Return ------ tuple of str versions � "@)z7.0z6.1z6.0a� $@)z7.1z7.0a� &@)z8.0z8.0a� (@)�8.1z8.1ar� )z10.0r� r �ru r# r r r �WindowsSdkVersion@ s z SystemInfo.WindowsSdkVersionc C � | � tj�| jd��S )zt Microsoft Windows SDK last version. Return ------ str version �lib)�_use_last_dir_namerI rJ rK � WindowsSdkDirr# r r r �WindowsSdkLastVersionV � z SystemInfo.WindowsSdkLastVersion� str | Nonec C s< d}| j D ]}tj�| jjd|� ��}| j�|d�}|r nq|r'tj�|�sCtj�| jj| j d��}| j�|d�}|rCtj�|d�}|rKtj�|�so| j D ] }|d|� d�� }d |� �}tj�| j |�}tj�|�rn|}qN|rwtj�|�s�| j D ]}d |� �}tj�| j |�}tj�|�r�|}qz|s�tj�| j d �}|S ) zn Microsoft Windows SDK directory. Return ------ str path r �v�installationfolderr� r� �WinSDKNr� z Microsoft SDKs\Windows Kits\zMicrosoft SDKs\Windows\v� PlatformSDK) r� rI rJ rK rq rV rm r� rS rv �rfindrp r� )r �sdkdirr� �locrJ � install_base�intver�dr r r r� b s< � � �zSystemInfo.WindowsSdkDirc C s� | j dkr d}d}nd}| j dkrdnd}| jjd|d��d d �}d |� d |� �}g }| j d krC| jD ]}|tj�| jj ||�g7 }q3| j D ]}|tj�| jj d|� d�|�g7 }qF|D ]}| j� |d�}|rk| S q\dS )zy Microsoft Windows SDK executable directory. Return ------ str path r� �# r �( r� TF)r r2 r0 �-z WinSDK-NetFx�Toolsr� r� �Ar� N) ru rA r3 r �NetFxSdkVersionrI rJ rK rq rX r� rV rm ) r �netfxverr r2 �fx�regpathsr� rJ �execpathr r r �WindowsSDKExecutablePath� s& $�z#SystemInfo.WindowsSDKExecutablePathc C s. t j�| jj| jd�d��}| j�|d�pdS )zl Microsoft Visual F# directory. Return ------ str path r� z \Setup\F#� productdirr )rI rJ rK rq rE ru rm )r rJ r r r �FSharpInstallDir� s zSystemInfo.FSharpInstallDirc C sH | j dkrdnd}|D ]}| j�| jjd|� ��}|r!|p d S q dS )zt Microsoft Universal CRT SDK directory. Return ------ str path r� )�10�81r �kitsrootr N)ru rq rm rY )r �versr� r� r r r �UniversalCRTSdkDir� s �z SystemInfo.UniversalCRTSdkDirc C r� )z� Microsoft Universal C Runtime SDK last version. Return ------ str version r� )r� rI rJ rK r� r# r r r �UniversalCRTSdkLastVersion� r� z%SystemInfo.UniversalCRTSdkLastVersionc C s | j dkrdS dS )z� Microsoft .NET Framework SDK versions. Return ------ tuple of str versions r� ) z4.7.2z4.7.1z4.7z4.6.2z4.6.1z4.6z4.5.2z4.5.1z4.5r r� r# r r r r� � s ���zSystemInfo.NetFxSdkVersionc C s> d}| j D ]}tj�| jj|�}| j�|d�}|r |S q|S )zu Microsoft .NET Framework SDK directory. Return ------ str path r �kitsinstallationfolder)r� rI rJ rK rq rX rm )r r� r� r� r r r � NetFxSdkDir� s �zSystemInfo.NetFxSdkDirc C �& t j�| jd�}| j�| jjd�p|S )zw Microsoft .NET Framework 32bit directory. Return ------ str path zMicrosoft.NET\Framework�frameworkdir32�rI rJ rK ro rq rm rP �r �guess_fwr r r �FrameworkDir32 � zSystemInfo.FrameworkDir32c C r� )zw Microsoft .NET Framework 64bit directory. Return ------ str path zMicrosoft.NET\Framework64�frameworkdir64r� r� r r r �FrameworkDir64 r� zSystemInfo.FrameworkDir64�tuple[str, ...]c C � | � d�S )z� Microsoft .NET Framework 32bit versions. Return ------ tuple of str versions � ��_find_dot_net_versionsr# r r r �FrameworkVersion32# � z SystemInfo.FrameworkVersion32c C r� )z� Microsoft .NET Framework 64bit versions. Return ------ tuple of str versions �@ r� r# r r r �FrameworkVersion64/ r� z SystemInfo.FrameworkVersion64c C s� | j �| j jd|� ��}t| d|� ��}|p | �|d�p d}| jdkr'|dfS | jdkr>|�� dd � d kr:d d fS |d fS | jd krEdS | jdkrLdS dS )z� Find Microsoft .NET Framework versions. Parameters ---------- bits: int Platform number of bits: 32 or 64. Return ------ tuple of str versions � frameworkver� FrameworkDirr� r r� zv4.0r� Nr� �v4z v4.0.30319�v3.5r� )r � v2.0.50727g @)zv3.0r r )rq rm rP �getattrr� ru r )r �bits�reg_ver� dot_net_dirr� r r r r� ; s $ z!SystemInfo._find_dot_net_versionsc s, � �fdd�t t�� ��D �}t|d�pdS )a) Return name of the last dir in path or '' if no dir found. Parameters ---------- path: str Use dirs in this path prefix: str Use only dirs starting by this prefix Return ------ str name c 3 s4 � | ]}t j�t j�� |��r|���r|V qd S r@ )rI rJ r� rK � startswith)�.0�dir_name�rJ �prefixr r � <genexpr>j s � �� �z0SystemInfo._use_last_dir_name.<locals>.<genexpr>Nr )�reversedrI r� �next)rJ r � matching_dirsr r r r� Y s �z SystemInfo._use_last_dir_namer@ r9 )r r� )r r� �r r� )r r� )r )#r r r r< r r= ro rp r� r rt ry rr � staticmethodr� r> r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r rn _ s\ * * $ rn c @ s6 e Zd ZU ded< ded< ded< ded< ded< dS ) �_EnvironmentDictr- �includer� �libpathrJ zNotRequired[str | None]�py_vcruntime_redistN)r r r �__annotations__r r r r r s s r c @ sZ e Zd ZdZdCdDdd�Zedd � �Zed d � �Zed d � �Zedd� �Z edd� �Z edd� �Z edd� �Z edd� �Z edd� �Zedd� �Zed d � �Zd d � Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zed,d-� �Zed.d/� �Zed0d1� �Zed2d3� �Zed4d5� �Z ed6d7� �Z edEd9d:��Z dFdGd?d@�Z dAdB� Z dS )H�EnvironmentInfoaY Return environment variables for specified Microsoft Visual C++ version and platform : Lib, Include, Path and libpath. This function is compatible with Microsoft Visual C++ 9.0 to 14.X. Script created by analysing Microsoft environment configuration files like "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ... Parameters ---------- arch: str Target architecture. vc_ver: float Required Microsoft Visual C++ version. If not set, autodetect the last version. vc_min_ver: float Minimum Microsoft Visual C++ version. Nr r r c C sB t |�| _t| j�| _t| j|�| _| j|k r d}tj� |��d S )Nz.No suitable Microsoft Visual C++ version found) r rA r? rq rn �sirv rz r{ r| )r r rv � vc_min_ver�errr r r r � s �zEnvironmentInfo.__init__c C � | j jS )zk Microsoft Visual Studio. Return ------ float version )r ru r# r r r ru � � zEnvironmentInfo.vs_verc C r )zp Microsoft Visual C++ version. Return ------ float version )r rv r# r r r rv � r zEnvironmentInfo.vc_verc sX ddg}� j dkr#� jjddd�}|dg7 }|dg7 }|d|� �g7 }� fdd �|D �S ) zu Microsoft Visual Studio Tools. Return ------ list of str paths z Common7\IDEz Common7\Toolsr� T�r2 r z1Common7\IDE\CommonExtensions\Microsoft\TestWindowz Team Tools\Performance Toolsc � g | ] }t j�� jj|��qS r �rI rJ rK r r� �r rJ r# r r � <listcomp>� � z+EnvironmentInfo.VSTools.<locals>.<listcomp>)ru rA r3 )r �paths� arch_subdirr r# r �VSTools� s zEnvironmentInfo.VSToolsc C s$ t j�| jjd�t j�| jjd�gS )z� Microsoft Visual C++ & Microsoft Foundation Class Includes. Return ------ list of str paths �IncludezATLMFC\Include�rI rJ rK r r� r# r r r � VCIncludes� s �zEnvironmentInfo.VCIncludesc sh � j dkr � jjdd�}n� jjdd�}d|� �d|� �g}� j dkr+|d|� �g7 }� fd d �|D �S ) z� Microsoft Visual C++ & Microsoft Foundation Class Libraries. Return ------ list of str paths � .@T�r �r2 �Libz ATLMFC\Libr� z Lib\storec r r r& r r# r r r � r! z/EnvironmentInfo.VCLibraries.<locals>.<listcomp>)ru rA r5 )r r# r" r r# r � VCLibraries� s zEnvironmentInfo.VCLibrariesc C �" | j dk rg S tj�| jjd�gS )z� Microsoft Visual C++ store references Libraries. Return ------ list of str paths r� zLib\store\references)ru rI rJ rK r r� r# r r r � VCStoreRefs� s zEnvironmentInfo.VCStoreRefsc C s8 | j }tj�|jd�g}| jdkrdnd}| j�|�}|r+|tj�|jd|� ��g7 }| jdkrGd| jjdd�� �}|tj�|j|�g7 }|S | jdkr�| jj � d d �� � }tj�d d |� d ��}|tj�|j|| jj dd� �g7 }| jj | jj kr�|tj�|j|| jjdd� �g7 }|S |tj�|jd�g7 }|S )a� Microsoft Visual C++ Tools. Return ------ list of str paths When host CPU is ARM, the tools should be found for ARM. >>> getfixture('windows_only') >>> mp = getfixture('monkeypatch') >>> mp.setattr(PlatformInfo, 'current_cpu', 'arm64') >>> ei = EnvironmentInfo(arch='irrelevant') >>> paths = ei.VCTools >>> any('HostARM64' in path for path in paths) True � VCPackagesr� TF�Binr� r* r( r r �bin�Hostz%sr) )r rI rJ rK r� ru rA r8 r3 r+ r �upperr5 r$ )r r �toolsr6 r# rJ �host_id�host_dirr r r �VCTools� s2 � ��� �zEnvironmentInfo.VCToolsc C st | j dkr| jjddd�}tj�| jjd|� ��gS | jjdd�}tj�| jjd�}| j}tj�||� d|� ��gS )zw Microsoft Windows SDK Libraries. Return ------ list of str paths r� Tr r+ r) r� �um) ru rA r5 rI rJ rK r r� � _sdk_subdir)r r# r� �libverr r r � OSLibraries- s zEnvironmentInfo.OSLibrariesc C s~ t j�| jjd�}| jdkr|t j�|d�gS | jdkr | j}nd}t j�||� d��t j�||� d��t j�||� d��gS ) zu Microsoft Windows SDK Include. Return ------ list of str paths r r� �glr� r �sharedr8 �winrt)rI rJ rK r r� ru r9 )r r �sdkverr r r � OSIncludesA s �zEnvironmentInfo.OSIncludesc C s� t j�| jjd�}g }| jdkr|| j7 }| jdkr$|t j�|d�g7 }| jdkr[||t j�| jjd�t j�|dd�t j�|d d�t j�|d d�t j�| jjd d | jd �ddd�g7 }|S )z} Microsoft Windows SDK Libraries Paths. Return ------ list of str paths � Referencesr� r� zCommonConfiguration\Neutralr� � UnionMetadataz'Windows.Foundation.UniversalApiContractz1.0.0.0z%Windows.Foundation.FoundationContractz,Windows.Networking.Connectivity.WwanContract� ExtensionSDKszMicrosoft.VCLibsr� �CommonConfiguration�neutral)rI rJ rK r r� ru r; )r �refr r r r � OSLibpath[ s4 ���zEnvironmentInfo.OSLibpathc C s t | �� �S )zs Microsoft Windows SDK Tools. Return ------ list of str paths )�list� _sdk_toolsr# r r r �SdkTools� s zEnvironmentInfo.SdkToolsc c s � | j dk r| j dkr dnd}tj�| jj|�V | j�� s4| jjdd�}d|� �}tj�| jj|�V | j dv rY| j� � rAd}n| jjddd �}d |� �}tj�| jj|�V n%| j dkr~tj�| jjd�}| jjdd�}| jj }tj�||� |� ��V | jj r�| jj V d S d S ) z� Microsoft Windows SDK Tools paths generator. Return ------ generator of str paths r( r� r0 zBin\x86Tr) )r� r� r r zBin\NETFX 4.0 ToolsN) ru rI rJ rK r r� rA r, r3 r( r� r� )r �bin_dirr# rJ r? r r r rI � s, � �zEnvironmentInfo._sdk_toolsc C � | j j}|r |� d�S dS )zu Microsoft Windows SDK version subdir. Return ------ str subdir r0 r )r r� �r �ucrtverr r r r9 � � zEnvironmentInfo._sdk_subdirc C s" | j dkrg S tj�| jjd�gS )zs Microsoft Windows SDK Setup. Return ------ list of str paths r� �Setup)ru rI rJ rK r r� r# r r r �SdkSetup� � zEnvironmentInfo.SdkSetupc s� | j }| j� | jdkrd}|�� o|�� }n|�� p |�� }|jdkp)|jdk}g }|r:|� fdd�� jD �7 }|rH|� fdd�� jD �7 }|S )zv Microsoft .NET Framework Tools. Return ------ list of str paths r� Tr c � g | ] }t j�� j|��qS r )rI rJ rK r� �r r� �r r r r � � �z+EnvironmentInfo.FxTools.<locals>.<listcomp>c rS r )rI rJ rK r� rT rU r r r � rV ) rA r ru r( r, r+ r$ r� r� )r rA � include32� include64r4 r rU r �FxTools� s" � �zEnvironmentInfo.FxToolsc C s> | j dk s | jjs g S | jjdd�}tj�| jjd|� ��gS )z~ Microsoft .Net Framework SDK Libraries. Return ------ list of str paths r� Tr) zlib\um)ru r r� rA r5 rI rJ rK )r r# r r r �NetFxSDKLibraries� s z!EnvironmentInfo.NetFxSDKLibrariesc C s* | j dk s | jjs g S tj�| jjd�gS )z} Microsoft .Net Framework SDK Includes. Return ------ list of str paths r� z include\um)ru r r� rI rJ rK r# r r r �NetFxSDKIncludes� s z EnvironmentInfo.NetFxSDKIncludesc C s t j�| jjd�gS )z� Microsoft Visual Studio Team System Database. Return ------ list of str paths z VSTSDB\Deployr r# r r r �VsTDb s zEnvironmentInfo.VsTDbc C s� | j dk rg S | j dk r| jj}| jjdd�}n| jj}d}d| j d�d|� �}tj�||�g}| j dkr@|tj�||d �g7 }|S ) zn Microsoft Build Engine. Return ------ list of str paths r� r( Tr* r zMSBuild\r� z\bin�Roslyn) ru r r� rA r3 r� rI rJ rK )r � base_pathr# rJ �buildr r r �MSBuild s zEnvironmentInfo.MSBuildc C r- )zt Microsoft HTML Help Workshop. Return ------ list of str paths r� zHTML Help Workshop)ru rI rJ rK r r� r# r r r �HTMLHelpWorkshop4 rR z EnvironmentInfo.HTMLHelpWorkshopc C sN | j dk rg S | jjdd�}tj�| jjd�}| j}tj�||� d|� ��gS )z� Microsoft Universal C Runtime SDK Libraries. Return ------ list of str paths r� Tr) r� �ucrt) ru rA r5 rI rJ rK r r� � _ucrt_subdir)r r# r� rN r r r � UCRTLibrariesC s z EnvironmentInfo.UCRTLibrariesc C s8 | j dk rg S tj�| jjd�}tj�|| j� d��gS )z� Microsoft Universal C Runtime SDK Include. Return ------ list of str paths r� r rb )ru rI rJ rK r r� rc )r r r r r � UCRTIncludesU s z EnvironmentInfo.UCRTIncludesc C rL )z� Microsoft Universal C Runtime SDK version subdir. Return ------ str subdir r0 r )r r� rM r r r rc e rO z EnvironmentInfo._ucrt_subdirc C s$ d| j kr dkr g S | jjgS )zk Microsoft Visual F#. Return ------ list of str paths r� r� )ru r r� r# r r r �FSharpr s � zEnvironmentInfo.FSharpr� c s� d| j � d��| jjdd��d�� g }| jj}tj�|� dd��}tj� |�r>tj� |t� |�d �}||tj� |d �g7 }|tj� |d �g7 }d | j d � d �d t | j�d � d �f}� �fdd�t�||�D �}tttjj|�d�S )z{ Microsoft Visual C++ runtime redistributable dll. Returns the first suitable path found or None. � vcruntimez0.dllTr) r0 z\Toolsz\Redistrx �onecore�redistz Microsoft.VC� z.CRTc 3 s& � | ]\}}t j�|� |��V qd S r@ )rI rJ rK )r r �crt_dir�r# rg r r r � s � � �z2EnvironmentInfo.VCRuntimeRedist.<locals>.<genexpr>N)rv rA r5 �stripr r� rI rJ �dirnamer r� rK r� �intru r� r� r �filter�isfile)r �prefixes� tools_path� redist_path�crt_dirs�candidate_pathsr rl r �VCRuntimeRedist� s � �z EnvironmentInfo.VCRuntimeRedistT�exists�boolr c C s� t | �d| j| j| j| jg|�| �d| j| j| j| j | j g|�| �d| j| j| j | j g|�| �d| j | j| j| j| j| j| j| j| jg |�d�}| jdkrU| jrU| j|d< |S )z� Return environment dict. Parameters ---------- exists: bool It True, only return existing paths. Return ------ dict environment r r� r rJ )r r� r rJ � r )r � _build_pathsr' r@ re r[ r, r; rY rd rZ r. rG r7 r$ r\ rJ rQ r` ra rf ru rw )r rx �envr r r � return_env� sV �� �� �� ��+ zEnvironmentInfo.return_envc C sx t j�|�}t�|d��tj�}t �||�}|r!tt tj j |��n|}|s2|� � � d�}t j�|��t|�} tj�| �S )aC Given an environment variable name and specified paths, return a pathsep-separated string of paths containing unique, extant, directories from those paths and from the environment variable. Raise an error if no paths are resolved. Parameters ---------- name: str Environment variable name spec_path_lists: list of str Paths exists: bool It True, only return existing paths. Return ------ str Pathsep-separated paths r z environment variable is empty)r� �chain� from_iterabler r= r� rI �pathseprH rp rJ r� r3 rz r{ r| r rK ) r rf �spec_path_listsrx � spec_paths� env_pathsr" � extant_pathsr� � unique_pathsr r r r{ � s z EnvironmentInfo._build_paths)Nr r9 r )T)rx ry r r )!r r r r< r r> ru rv r$ r' r, r. r7 r; r@ rG rJ rI r9 rQ rY rZ r[ r\ r` ra rd re rc rf rw r} r{ r r r r r { sl 2 ' # " =r ) r< � __future__r r� r� r� rI �os.path�platform�typingr r �more_itertoolsr �distutils.errorsrz �typing_extensionsr r �systemr r �dictr r r? rn r r r r r r �<module> s8 y > __pycache__/extension.cpython-310.pyc 0000644 00000014232 15030122015 0013460 0 ustar 00 o �h � @ s� d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z d dl Z d dl Z d dl Z dd� ZeZer;d d l mZ ne e jj�ZG d d � d e�ZG d d � d e�ZdS )� )� annotationsN)� TYPE_CHECKING)�StrPath� )� get_unpatchedc C s0 d} z t | dgd�j W dS ty Y dS w )z0 Return True if Cython can be imported. zCython.Distutils.build_ext� build_ext)�fromlistFT)� __import__r � Exception)� cython_impl� r �G/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/extension.py� _have_cython s ��r )� Extensionc sR e Zd ZU dZded< ded< ded< ded< dd �d� fdd�Zdd� Z� ZS )r a� Describes a single extension module. This means that all source files will be compiled into a single binary file ``<module path>.<suffix>`` (with ``<module path>`` derived from ``name`` and ``<suffix>`` defined by one of the values in ``importlib.machinery.EXTENSION_SUFFIXES``). In the case ``.pyx`` files are passed as ``sources and`` ``Cython`` is **not** installed in the build environment, ``setuptools`` may also try to look for the equivalent ``.cpp`` or ``.c`` files. :arg str name: the full name of the extension, including any packages -- ie. *not* a filename or pathname, but Python dotted name :arg list[str|os.PathLike[str]] sources: list of source filenames, relative to the distribution root (where the setup script lives), in Unix form (slash-separated) for portability. Source files may be C, C++, SWIG (.i), platform-specific resource files, or whatever else is recognized by the "build_ext" command as source for a Python extension. :keyword list[str] include_dirs: list of directories to search for C/C++ header files (in Unix form for portability) :keyword list[tuple[str, str|None]] define_macros: list of macros to define; each macro is defined using a 2-tuple: the first item corresponding to the name of the macro and the second item either a string with its value or None to define it without a particular value (equivalent of "#define FOO" in source or -DFOO on Unix C compiler command line) :keyword list[str] undef_macros: list of macros to undefine explicitly :keyword list[str] library_dirs: list of directories to search for C/C++ libraries at link time :keyword list[str] libraries: list of library names (not filenames or paths) to link against :keyword list[str] runtime_library_dirs: list of directories to search for C/C++ libraries at run time (for shared extensions, this is when the extension is loaded). Setting this will cause an exception during build on Windows platforms. :keyword list[str] extra_objects: list of extra files to link with (eg. object files not implied by 'sources', static library that must be explicitly specified, binary resource files, etc.) :keyword list[str] extra_compile_args: any extra platform- and compiler-specific information to use when compiling the source files in 'sources'. For platforms and compilers where "command line" makes sense, this is typically a list of command-line arguments, but for other platforms it could be anything. :keyword list[str] extra_link_args: any extra platform- and compiler-specific information to use when linking object files together to create the extension (or to create a new static Python interpreter). Similar interpretation as for 'extra_compile_args'. :keyword list[str] export_symbols: list of symbols to be exported from a shared extension. Not used on all platforms, and not generally necessary for Python extensions, which typically export exactly one symbol: "init" + extension_name. :keyword list[str] swig_opts: any extra options to pass to SWIG if a source file has the .i extension. :keyword list[str] depends: list of files that the extension depends on :keyword str language: extension language (i.e. "c", "c++", "objc"). Will be detected from the source extensions if not provided. :keyword bool optional: specifies that a build failure in the extension should not abort the build process, but simply not install the failing extension. :keyword bool py_limited_api: opt-in flag for the usage of :doc:`Python's limited API <python:c-api/stable>`. :raises setuptools.errors.PlatformError: if ``runtime_library_dirs`` is specified on Windows. (since v63) �str� _full_name�bool�_links_to_dynamic� _needs_stub� _file_nameF)�py_limited_api�name�sources� list[StrPath]r �return�Nonec s& || _ t� j||g|�R i |�� d S )N)r �super�__init__)�selfr r r �args�kw�� __class__r r r � s �� �zExtension.__init__c C sN t � rdS | jp d}|�� dkrdnd}t�tjd|�}tt|| j ��| _ dS )z� Replace sources with .pyx extensions to sources with the target language extension. This mechanism allows language authors to supply pre-converted sources but to prefer the .pyx sources. N� zc++z.cppz.cz.pyx$) r �language�lower� functools�partial�re�sub�list�mapr )r �lang� target_extr) r r r � _convert_pyx_sources_to_lang� s z&Extension._convert_pyx_sources_to_lang)r r r r r r r r )�__name__� __module__� __qualname__�__doc__�__annotations__r r. � __classcell__r r r! r r & s c�r c @ s e Zd ZdZdS )�Libraryz=Just like a regular Extension, but built as a library insteadN)r/ r0 r1 r2 r r r r r5 � s r5 )� __future__r r& r( �typingr �setuptools._pathr �monkeyr �distutils.core� distutils�distutils.errors�distutils.extensionr � have_pyrexr � _Extension�corer5 r r r r �<module> s" __pycache__/version.cpython-310.pyc 0000644 00000000476 15030122015 0013136 0 ustar 00 o �h� � @ s: d dl mZ z e�d�p dZW dS ey dZY dS w )� )�metadata� setuptoolsz0.dev0+unknownN)� _importlibr �version� __version__� Exception� r r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/version.py�<module> s � __pycache__/__init__.cpython-310.pyc 0000644 00000025505 15030122015 0013210 0 ustar 00 o �h�( � @ s� d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m Z ddl m Z m Z mZ ej�ej�ej�ej�e��dd� Zejveg � ej�d d� ddlZd d lmZmZ d d l m Z d d l m Z m Z d dl!m"Z" d dl#m$Z$ d dl%m&Z& d dl'm(Z( ddl)Z*ddl+m,Z, g d�Z-e ddd�Z.dZ/e j0Z1e j0Z2dd� Z3d(dd �Z4d d � Z5e*j6j5j e5_ e r�dd l)m7Z8 ne�9e*j6j7�Z8G d d!� d!e8�Z7d"d#� Z:ej;fd$d%�Z<G d&d'� d'e=�Z>e�?� dS ))z@Extensions to the 'distutils' for large or complex distributions� )� annotationsN)�abstractmethod)�Mapping)� TYPE_CHECKING�TypeVar�overload� setuptools�_vendor� backports� )�logging�monkey)�Require)� PackageFinder�PEP420PackageFinder)� Distribution)� Extension)� __version__)� SetuptoolsDeprecationWarning)�DistutilsOptionError)�setupr �Commandr r r � find_packages�find_namespace_packages� _CommandT�_Command)�boundc C s> G dd� dt jj�}|| �}|jdd� |jr t|� d S d S )Nc s8 e Zd ZdZd � fdd� Zd� fd d � Zd d � Z� ZS )z4_install_setup_requires.<locals>.MinimalDistributionzl A minimal version of a distribution for supporting the fetch_build_eggs interface. �attrs�Mapping[str, object]�return�Nonec s< d}� fdd�t |�t � �@ D �}t� �|� | j�� d S )N)�dependency_links�setup_requiresc s i | ]}|� | �qS � r# )�.0�k�r r# �F/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/__init__.py� <dictcomp>A s zQ_install_setup_requires.<locals>.MinimalDistribution.__init__.<locals>.<dictcomp>)�set�super�__init__� set_defaults�_disable)�selfr �_incl�filtered�� __class__r& r' r+ ? s z=_install_setup_requires.<locals>.MinimalDistribution.__init__Nc s6 z t � �|�\}}W |dfS ty |df Y S w )zAIgnore ``pyproject.toml``, they are not related to setup_requiresr# )r* � _split_standard_project_metadata� Exception)r. � filenames�cfg�_tomlr1 r# r' �_get_project_config_filesF s � �zN_install_setup_requires.<locals>.MinimalDistribution._get_project_config_filesc S s dS )zl Disable finalize_options to avoid building the working set. Ref #2158. Nr# �r. r# r# r' �finalize_optionsN s zE_install_setup_requires.<locals>.MinimalDistribution.finalize_options)r r r r �N)�__name__� __module__� __qualname__�__doc__r+ r8 r: � __classcell__r# r# r1 r' �MinimalDistribution9 s rA T)�ignore_option_errors)� distutils�corer �parse_config_filesr" �_fetch_build_eggs)r rA �distr# r# r' �_install_setup_requires6 s �rH rG r c C sf z | � | j� W d S ty2 } z d}d|jjv r-t|d�r$|�|� � | �d|� d�� � d }~ww )Na� It is possible a package already installed in your system contains an version that is invalid according to PEP 440. You can try `pip install --use-pep517` as a workaround for this problem, or rely on a new virtual environment. If the problem refers to a package that is not installed yet, please contact that package's maintainers or distributors. �InvalidVersion�add_note� )�fetch_build_eggsr" r4 r2 r< �hasattrrJ �announce)rG �ex�msgr# r# r' rF \ s ���rF c K s" t �� t| � tjjdi | ��S )Nr# )r � configurerH rC rD r r& r# r# r' r q s r )r c s� e Zd ZU dZdZded< d!� fdd � Zd"d d �Zd#dd�Ze d$d%dd��Z e d$d&dd��Z d$d'dd�Z e d(dd ��Z e d(d d ��Z e d(d d ��Z� ZS ))r a# Setuptools internal actions are organized using a *command design pattern*. This means that each action (or group of closely related actions) executed during the build should be implemented as a ``Command`` subclass. These commands are abstractions and do not necessarily correspond to a command that can (or should) be executed via a terminal, in a CLI fashion (although historically they would). When creating a new command from scratch, custom defined classes **SHOULD** inherit from ``setuptools.Command`` and implement a few mandatory methods. Between these mandatory methods, are listed: :meth:`initialize_options`, :meth:`finalize_options` and :meth:`run`. A useful analogy for command classes is to think of them as subroutines with local variables called "options". The options are "declared" in :meth:`initialize_options` and "defined" (given their final values, aka "finalized") in :meth:`finalize_options`, both of which must be defined by every command class. The "body" of the subroutine, (where it does all the work) is the :meth:`run` method. Between :meth:`initialize_options` and :meth:`finalize_options`, ``setuptools`` may set the values for options/attributes based on user's input (or circumstance), which means that the implementation should be careful to not overwrite values in :meth:`finalize_options` unless necessary. Please note that other commands (or other parts of setuptools) may also overwrite the values of the command's options/attributes multiple times during the build process. Therefore it is important to consistently implement :meth:`initialize_options` and :meth:`finalize_options`. For example, all derived attributes (or attributes that depend on the value of other attributes) **SHOULD** be recomputed in :meth:`finalize_options`. When overwriting existing commands, custom defined classes **MUST** abide by the same APIs implemented by the original class. They also **SHOULD** inherit from the original class. Fr � distributionrG r r c s t � �|� t| ��|� dS )zj Construct the command for dist, updating vars(self) with any keyword parameters. N)r* r+ �vars�update)r. rG �kwr1 r# r' r+ � s zCommand.__init__Nc C sL t | |�}|d u rt| ||� |S t|t�s$td|� d|� d|� d���|S )N�'z ' must be a z (got `z`))�getattr�setattr� isinstance�strr )r. �option�what�default�valr# r# r' �_ensure_stringlike� s zCommand._ensure_stringliker[ rZ c C sx t | |�}|du r dS t|t�r t| |t�d|�� dS t|t�r+tdd� |D ��}nd}|s:td|� d|�d���dS ) a� Ensure that 'option' is a list of strings. If 'option' is currently a string, we split it either on /,\s*/ or /\s+/, so "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become ["foo", "bar", "baz"]. .. TODO: This method seems to be similar to the one in ``distutils.cmd`` Probably it is just here for backward compatibility with old Python versions? :meta private: Nz,\s*|\s+c s s � | ]}t |t�V qd S r; )rY rZ )r$ �vr# r# r' � <genexpr>� s � z-Command.ensure_string_list.<locals>.<genexpr>FrV z!' must be a list of strings (got �)) rW rY rZ rX �re�split�list�allr )r. r[ r^ �okr# r# r' �ensure_string_list� s ��zCommand.ensure_string_list�command�reinit_subcommands�boolr c K � d S r; r# �r. ri rj rU r# r# r' �reinitialize_command� � z Command.reinitialize_commandr c K rl r; r# rm r# r# r' rn � ro �str | _Commandc K s t �| ||�}t|��|� |S r; )r rn rS rT )r. ri rj rU �cmdr# r# r' rn � s c C � t �)z� Set or (reset) all options/attributes/caches used by the command to their default values. Note that these values may be overwritten during the build. ��NotImplementedErrorr9 r# r# r' �initialize_options� � zCommand.initialize_optionsc C rr )z� Set final values for all options/attributes used by the command. Most of the time, each option/attribute/cache should only be set if it does not have any value yet (e.g. ``if self.attr is None: self.attr = val``). rs r9 r# r# r' r: � rv zCommand.finalize_optionsc C rr )z� Execute the actions intended by the command. (Side effects **SHOULD** only take place when :meth:`run` is executed, for example, creating new files or writing to the terminal output). rs r9 r# r# r' �run� rv z Command.run)rG r r r r; )r[ rZ r r )F)ri rZ rj rk r r )ri r rj rk r r )ri rp rj rk r r )r r )r< r= r> r? �command_consumes_arguments�__annotations__r+ r_ rh r rn r ru r: rw r@ r# r# r1 r' r � s* % �� � r c C s& dd� t j| dd�D �}tt jj|�S )z% Find all files under 'path' c s s. � | ]\}}}|D ] }t j�||�V q qd S r; )�os�path�join)r$ �base�dirs�files�filer# r# r' ra s � � � �z#_find_all_simple.<locals>.<genexpr>T)� followlinks)rz �walk�filterr{ �isfile)r{ �resultsr# r# r' �_find_all_simple s �r� c C s6 t | �}| tjkrtjtjj| d�}t||�}t|�S )z� Find all files under 'dir' and return the list of full filenames. Unless dir is '.', return full filenames with dir prepended. )�start) r� rz �curdir� functools�partialr{ �relpath�mapre )�dirr �make_relr# r# r' �findall s r� c @ s e Zd ZdZdS )�sicz;Treat this string as-is (https://en.wikipedia.org/wiki/Sic)N)r< r= r> r? r# r# r# r' r� s r� )rG r )@r? � __future__r r� rz rc �sys�abcr �collections.abcr �typingr r r r{ �extendr| �dirname�__file__� vendor_path�modules�pop�_distutils_hack.override�_distutils_hack� r r �dependsr � discoveryr r rG r � extensionr �versionr �warningsr �distutils.corerC �distutils.errorsr �__all__r �bootstrap_install_from�findr r rH rF r rD r r � get_unpatchedr� r� r� rZ r� � patch_allr# r# r# r' �<module> sN 8 & __pycache__/archive_util.cpython-310.pyc 0000644 00000014070 15030122015 0014122 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m Z g d�Z G dd� de �Z d d � Z e df dd d �Ze fddd�Ze fddd�Ze fdd�Zdd� Zdd� Ze fd efdd�ZeeefZdS )z/Utilities for extracting common archive formats� N� )�ensure_directory)�DistutilsError)�unpack_archive�unpack_zipfile�unpack_tarfile�default_filter�UnrecognizedFormat�extraction_drivers�unpack_directoryc @ s e Zd ZdZdS )r z#Couldn't recognize the archive typeN)�__name__� __module__� __qualname__�__doc__� r r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/archive_util.pyr s r c C s |S )z@The default progress/filter callback; returns True for all filesr )�src�dstr r r r s r �returnc C sB |pt D ]}z || ||� W dS ty Y qw td| � ���)a� Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat`` `progress_filter` is a function taking two arguments: a source path internal to the archive ('/'-separated), and a filesystem path where it will be extracted. The callback must return the desired extract path (which may be the same as the one passed in), or else ``None`` to skip that file or directory. The callback can thus be used to report on the progress of the extraction, as well as to filter the items extracted or alter their extraction paths. `drivers`, if supplied, must be a non-empty sequence of functions with the same signature as this function (minus the `drivers` argument), that raise ``UnrecognizedFormat`` if they do not support extracting the designated archive type. The `drivers` are tried in sequence until one is found that does not raise an error, or until all are exhausted (in which case ``UnrecognizedFormat`` is raised). If you do not supply a sequence of drivers, the module's ``extraction_drivers`` constant will be used, which means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that order. Nz Not a recognized archive type: )r r )�filename� extract_dir�progress_filter�drivers�driverr r r r " s ��r c C s� t j�| �s t| � d���| d|fi}t �| �D ]Q\}}}|| \}}|D ]} || d t j�|| �f|t j�|| �< q%|D ]*} t j�|| �} ||| | �} | sQq>t| � t j�|| �} t�| | � t� | | � q>qdS )z� "Unpack" a directory, using the same interface as for archives Raises ``UnrecognizedFormat`` if `filename` is not a directory z is not a directory� �/N) �os�path�isdirr �walk�joinr �shutil�copyfile�copystat) r r r �paths�base�dirs�filesr r �d�f�targetr r r r D s& � * ��r c C sT t �| �s t| � d���t �| ��}t|||� W d � dS 1 s#w Y dS )z�Unpack zip `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined by ``zipfile.is_zipfile()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. z is not a zip fileN)�zipfile� is_zipfiler �ZipFile�_unpack_zipfile_obj)r r r �zr r r r _ s "�r c C s� | � � D ]b}|j}|�d�sd|�d�v rqtjj|g|�d��R � }|||�}|s+q|�d�r5t|� n$t|� | � |j�}t |d�� }|� |� W d � n1 sTw Y |j d? }|rft� ||� qdS )z�Internal/private API used by other parts of setuptools. Similar to ``unpack_zipfile``, but receives an already opened :obj:`zipfile.ZipFile` object instead of a filename. r �..�wbN� )�infolistr � startswith�splitr r r �endswithr �read�open�write� external_attr�chmod) � zipfile_objr r �info�namer* �datar) �unix_attributesr r r r. n s( � ��r. c C s� |dur5|� � s |�� r5|j}|�� r$t�|j�}t�||�}t�|�}| �|�}|dur5|� � s |�� s |duo@|� � p@|� � }|rE|S t d��)z;Resolve any links and extract link targets as normal files.NzGot unknown file type) �islnk�issym�linkname� posixpath�dirnamer> r �normpath� _getmember�isfiler � LookupError)�tar_obj�tar_member_obj�linkpathr% �is_file_or_dirr r r �_resolve_tar_file_or_dir� s, �� ��� �rN c c s� � dd� | _ t�| ��U | D ]I}|j}|�d�s d|�d�v r qtjj|g|�d��R � }zt | |�}W n t y= Y qw |||�}|sFq|� tj �rR|dd� }||fV qW d � dS 1 scw Y dS )z1Emit member-destination pairs from a tar archive.c W s d S )Nr )�argsr r r �<lambda>� s z _iter_open_tar.<locals>.<lambda>r r0 N���) �chown� contextlib�closingr> r4 r5 r r r rN rI r6 �sep)rJ r r �memberr> � prelim_dst� final_dstr r r �_iter_open_tar� s* � � �"�rY c C sx zt �| �}W n t jy } zt| � d��|�d}~ww t|||�D ]\}}z|�||� W q# t jy9 Y q#w dS )z�Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined by ``tarfile.open()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. z- is not a compressed or uncompressed tar fileNT)�tarfiler8 �TarErrorr rY �_extract_member� ExtractError)r r r �tarobj�erV rX r r r r � s* ���� ��r )r N)r rS r rD r! rZ r+ �_pathr �distutils.errorsr �__all__r r r r r r. rN rY �boolr r r r r r �<module> s. � �" __pycache__/launch.cpython-310.pyc 0000644 00000001616 15030122015 0012720 0 ustar 00 o �h4 � @ s4 d Z ddlZddlZddd�Zedkre� dS dS )z[ Launch the Python script on the command line after setuptools is bootstrapped via import. � N�returnc C s� t tjd } t| ddd�}tjdd� tjdd�< ttdt�}|| �� }|�� }W d � n1 s3w Y |�dd�}t || d�}t ||� dS ) zP Run the script in sys.argv[1] as if it had been invoked naturally. � �__main__N)�__file__�__name__�__doc__�openz\r\nz\n�exec) � __builtins__�sys�argv�dict�getattr�tokenizer �read�replace�compiler )� script_name� namespace�open_�fid�script� norm_script�code� r �D/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/launch.py�run s � � r r )r N)r r r r r r r r r �<module> s � __pycache__/monkey.cpython-310.pyc 0000644 00000007073 15030122015 0012753 0 ustar 00 o �h� � @ s� U d Z ddlmZ ddlZddlZddlZddlZddlmZm Z m Z ddl Z ed�Z edeej�Zg Zded< d d � Ze d!d d��Ze d"dd��Zd#dd�Zd$dd�Zdd� Zdd � Zd d � Zd d � ZdS )%z Monkey patching of distutils. � )� annotationsN)�TypeVar�cast�overload�_T� _UnpatchTz list[str]�__all__c C s" t �� dkr | f| j S t�| �S )am Returns the bases classes for cls sorted by the MRO. Works around an issue on Jython where inspect.getmro will not return all base classes if multiple classes share the same name. Instead, this function will return a tuple containing the class itself, and the contents of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024. �Jython)�platform�python_implementation� __bases__�inspect�getmro)�cls� r �D/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/monkey.py�_get_mro s r �item�returnc C � d S �Nr �r r r r � get_unpatched( � r �object�Nonec C r r r r r r r r * r �"type | types.FunctionType | object� type | types.FunctionType | Nonec C s* t | t�r t| �S t | tj�rt| �S d S r )� isinstance�type�get_unpatched_class�types� FunctionType�get_unpatched_functionr r r r r , s r �type[_T]c C s< dd� t | �D �}t|�}|j�d�s d| ��}t|��|S )z�Protect against re-patching the distutils if reloaded Also ensures that no other distutils extension monkeypatched the distutils first. c s s* � | ]}|j �d �sttt |�V qdS )� setuptoolsN)� __module__� startswithr r r )�.0r r r r � <genexpr>< s � � �z&get_unpatched_class.<locals>.<genexpr>� distutilsz&distutils has already been patched by )r �nextr& r' �AssertionError)r �external_bases�base�msgr r r r 6 s � r c C sr dd l } | jtj_t� tjtjtjfD ]}| jj|_q| jj tj_ | jj tj_ dt j v r7| jj t j d _ d S d S )Nr zdistutils.command.build_ext) r% �Commandr* �core� _patch_distribution_metadata�dist�cmd� Distribution� extension� Extension�sys�modules)r% �moduler r r � patch_allH s ���r; c C s6 ddl m} dD ]}t| |�}ttjj||� q d S )N� )�_core_metadata)�write_pkg_info�write_pkg_file� read_pkg_file�get_metadata_version� get_fullname)� r= �getattr�setattrr* r3 �DistributionMetadata)r= �attr�new_valr r r r2 ] s �r2 c C s* t ||�}t| ��d|� t||| � dS )z� Patch func_name in target_mod with replacement Important - original must be resolved by name to avoid patching an already patched function. � unpatchedN)rD �vars� setdefaultrE )� replacement� target_mod� func_name�originalr r r � patch_funcl s rP c C s | j S r )rI )� candidater r r r# } s r# )r r r r )r r r r )r r r r )r r$ r r$ )�__doc__� __future__r r r r8 r! �typingr r r �distutils.filelistr* r r r" r r �__annotations__r r r r; r2 rP r# r r r r �<module> s. __pycache__/warnings.cpython-310.pyc 0000644 00000007616 15030122015 0013304 0 ustar 00 o �h� � @ s� U d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z ddl m Z e r1ddl mZ eeeef Zd ed < d Zd � d d � �ZG dd� de�ZG dd� de�ZG dd� de�Zdd� ZdS )z�Provide basic warnings used by setuptools modules. Using custom classes (other than ``UserWarning``) allow users to set ``PYTHONWARNINGS`` filters to run tests and prepare for upcoming changes in setuptools. � )� annotationsN)�date)�cleandoc)�indent)� TYPE_CHECKING)� TypeAliasr �_DueDatez zP********************************************************************************z {details} c @ sB e Zd ZdZe dddd��Ze dddd��ZdS )�SetuptoolsWarningz/Base class in ``setuptools`` warning hierarchy.N� �summary� str | None�details�due_date�_DueDate | None�see_docs�see_url� stacklevel�int�return�Nonec K s� |p t | dd�p d}|pt | dd�pd} |pt | dd�}|p#t | dd�} | o*d| � �} |p2t | dd�}|r9t|� nd} | �|| | |pC| |�} | rU| t�� k rUt� rU| | ��tj| | |d d � dS ) �6Private: reserved for ``setuptools`` internal use only�_SUMMARYN� �_DETAILS� _DUE_DATE� _SEE_DOCSz%https://setuptools.pypa.io/en/latest/�_SEE_URL� )r )�getattrr �_format�today�_should_enforce�warnings�warn)�clsr r r r r r �kwargs�summary_�details_�docs_ref�docs_url�due�text� r, �F/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/warnings.py�emit s zSetuptoolsWarning.emit�str� date | None� format_args� dict | Nonec C s� t �� }t|��|p i �}t|��|pi �|r"||kr"d|d�d�nd|r+||k r+dnd|r4d|� d�ndg}dd � |D �}|rUttjd �|�d �t�} d �|d | d g�S |S )r z By z%Y-%b-%dzi, you need to update your project and remove deprecated calls or your builds will no longer be supported.Nzy This deprecation is overdue, please update your project and remove deprecated calls to avoid build errors in the future.z See z for details.c S s g | ]}|r|�qS r, r, )�.0�xr, r, r- � <listcomp>R s z-SetuptoolsWarning._format.<locals>.<listcomp>� )r z!! z !!) r r r � format_mapr � _TEMPLATE�format�join�_INDENT) r$ r r r r r1 r �possible_parts�parts�bodyr, r, r- r 6 s( �����zSetuptoolsWarning._format)NNNNNr )r r r r r r r r r r r r r r )NNN) r r/ r r/ r r0 r r r1 r2 r r/ )�__name__� __module__� __qualname__�__doc__� classmethodr. r r, r, r, r- r s ��r c @ � e Zd ZdZdS )�InformationOnlya Currently there is no clear way of displaying messages to the users that use the setuptools backend directly via ``pip``. The only thing that might work is a warning, although it is not the most appropriate tool for the job... See pypa/packaging-problems#558. N�r? r@ rA rB r, r, r, r- rE Y � rE c @ rD )� SetuptoolsDeprecationWarningz� Base class for warning deprecations in ``setuptools`` This class is not derived from ``DeprecationWarning``, and as such is visible by default. NrF r, r, r, r- rH c rG rH c C s t �dd��� } | dv S )N� SETUPTOOLS_ENFORCE_DEPRECATION�false)�true�on�ok�1)�os�getenv�lower)�enforcer, r, r- r! l s r! )rB � __future__r rO r" �datetimer �inspectr �textwrapr �typingr �typing_extensionsr �tupler r �__annotations__r; r8 � UserWarningr rE rH r! r, r, r, r- �<module> s" @ __pycache__/_reqs.cpython-310.pyc 0000644 00000003150 15030122015 0012552 0 ustar 00 o �h� � @ s� U d dl mZ d dlmZmZ d dlmZ d dlmZm Z m Z m Z m Z d dl mZ d dlmZ er7d dlmZ e d�Ze eee f Zd ed < e� e�Zd ed < ddd�Ze ddd��Ze d dd��Zefd dd�ZdS ) � )� annotations)�Iterable�Iterator)� lru_cache)� TYPE_CHECKING�Callable�TypeVar�Union�overloadN)� Requirement)� TypeAlias�_Tr � _StrOrIterz Callable[[str], Requirement]� parse_req�strs�return� Iterator[str]c C s t �tt jt �| ���S )z� Yield requirement strings for each specification in `strs`. `strs` must be a string, or a (possibly-nested) iterable thereof. )�text�join_continuation�map� drop_comment� yield_lines�r � r �C/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_reqs.py� parse_strings s r �Iterator[Requirement]c C � d S �Nr r r r r �parse" � r �parser�Callable[[str], _T]� Iterator[_T]c C r r r �r r! r r r r $ r c C s t |t| ��S )zW Replacement for ``pkg_resources.parse_requirements`` that uses ``packaging``. )r r r$ r r r r & s )r r r r )r r r r )r r r! r" r r# )� __future__r �collections.abcr r � functoolsr �typingr r r r r � jaraco.textr �packaging.requirementsr �typing_extensionsr r �strr �__annotations__r r r r r r r �<module> s" __pycache__/package_index.cpython-310.pyc 0000644 00000103512 15030122015 0014226 0 ustar 00 o �hk� � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddl Z ddl m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z, dd l-m.Z. d d l/m0Z0m1Z1 dd l2m3Z3 dd l4m5Z5 e �6d�Z7e �6de j8�Z9e �6d�Z:e �6de j8�j;Z<d�=� Z>g d�Z?dZ@de jA� dejBjC� dejBjD� �ZEdd� ZFdd� ZGd d � ZHdFd d �ZIdFd d!�ZJdFd"d#�ZKde#dfd$d%�ZLd&d'� ZMe �6d(e j8�ZN eMd)d*� �ZOG d+d,� d,�ZPG d-d.� d.eP�ZQG d/d0� d0e%�ZRe �6d1�jSZTd2d3� ZUd4d5� ZVdGd6d7�ZWd8d9� ZXG d:d;� d;e�ZYG d<d=� d=ejZ�Z[ej\j]fd>d?�Z^d@dA� Z_eWe@�e^�Z^dBdC� Z`dDdE� ZadS )Hz$PyPI and direct package downloading.� )� annotationsN)� translate��wraps)� NamedTuple��unique_everseen)� BINARY_DIST� CHECKOUT_DIST� DEVELOP_DIST�EGG_DIST� SOURCE_DIST� Distribution� Environment� Requirement�find_distributions�normalize_path� parse_version� safe_name� safe_version� to_filename)�Wheel� )� _cfg_read_utf8_with_fallback�_read_utf8_with_fallback)�log)�DistutilsErrorz^egg=([-A-Za-z0-9_.+!]+)$zhref\s*=\s*['"]?([^'"> ]+)z�<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)href="[^?]+\?:action=show_md5&digest=([0-9a-f]{32})">md5</a>\)z([-+.a-z0-9]{2,}):z .tar.gz .tar.bz2 .tar .zip .tgz)� PackageIndex�distros_for_url�parse_bdist_wininst�interpret_distro_name� z setuptools/z Python-urllib/�.c C s6 zt �| �W S ty } ztd| ���|�d }~ww )Nz/Not a URL, existing file, or requirement spec: )r �parse� ValueErrorr )�spec�e� r' �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/package_index.py�parse_requirement_argH s ����r) c C s� | � � }d\}}}|�d�rS|�d�r | dd� }d}n7|�dd�r1| d d � }| dd� }d}n"|�d �r?| dd � }d }n|�dd�rS| d d � }| dd� }d }|||fS )z=Return (base,pyversion) or (None,None) for possible .exe name)NNN�.exez .win32.exeNi�����win32z .win32-pyi�i�������z.win-amd64.exei�z win-amd64z .win-amd64-pyi��)�lower�endswith� startswith)�namer- �base�py_ver�platr' r' r( r Q s$ r c C sx t j�| �}|\}}}}}}t j�|�d�d �}|dkr,|dkr,t j�|�d�d �}d|v r8|�dd�\}}||fS )N�/���zsourceforge.net�download����#r )�urllibr# �urlparse�unquote�split) �url�parts�_scheme�server�path� _parameters�_query�fragmentr1 r' r' r( �egg_info_for_urli s rE c c sZ � t | �\}}t| ||�E dH |r)t�|�}|r+t| |�d�|td�E dH dS dS dS )zEYield egg or source distribution objects that might be found at a URLNr )� precedence)rE �distros_for_location� EGG_FRAGMENT�matchr �groupr )r= �metadatar1 rD rI r' r' r( r t s � ��r c C s� |� d�r |dd� }|� d�r d|v r t�| ||�gS |� d�r<d|v r<t|�}|�� s/g S t| |j|jtd d�gS |� d �rUt|�\}}}|durUt | |||t |�S t D ]}|� |�ro|dt |� � }t | ||� S qWg S ) z:Yield egg or source distribution objects based on basenamez.egg.zipNr, �.egg�-z.whlr )�location� project_name�versionrF r* ) r. r � from_locationr � is_compatiblerO rP r r r r � EXTENSIONS�len)rN �basenamerK �wheel�win_baser2 �platform�extr' r' r( rG � s6 �� � �rG c C s t t| �tj�| �|�S )zEYield possible egg or source distribution objects based on a filename)rG r �osrA rU )�filenamerK r' r' r( �distros_for_filename� s �r\ c c s� � |� d�}|stdd� |dd� D ��rdS tt|��D ]}|| dd� �� r+ nq t|�}t| |d�|d|� �d�||d� �|||d�V dS )z�Generate the interpretation of a source distro name Note: if `location` is a filesystem filename, you should call ``pkg_resources.normalize_path()`` on it before passing it to this routine! rM c s s � | ] }t �d |�V qdS )z py\d\.\d$N)�rerI )�.0�pr' r' r( � <genexpr>� s � z(interpret_distro_name.<locals>.<genexpr>� Nr )� py_versionrF rX )r< �any�rangerT �isdigitr �join)rN rU rK rb rF rX r> r_ r' r' r( r � s$ � � �r c s t � �� fdd��}|S )zs Wrap a function returning an iterable such that the resulting iterable only ever yields unique items. c s t � | i |���S �Nr )�args�kwargs��funcr' r( �wrapper� s z unique_values.<locals>.wrapperr )rk rl r' rj r( � unique_values� s rm z3<([^>]*\srel\s{0,10}=\s{0,10}['"]?([^'" >]+)[^>]*)>c c s� � t �|�D ]2}|�� \}}tttj|�� �d���}d|v s#d|v r8t �|�D ]}t j � | t |�d���V q(qdD ] }|�|�}|dkr[t �||�}|r[t j � | t |�d���V q;dS )zEFind rel="homepage" and rel="download" links in `page`, yielding URLs�,�homepager6 r )z <th>Home Pagez<th>Download URLr5 N)�REL�finditer�groups�set�map�str�stripr- r< �HREFr9 r# �urljoin� htmldecoderJ �find�search)r= �pagerI �tag�rel�rels�posr' r' r( �find_external_links� s � � ��r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �ContentCheckerzP A null content checker that defines the interface for checking content c C � dS )z3 Feed a block of data to the hash. Nr' ��self�blockr' r' r( �feed� � zContentChecker.feedc C r� )zC Check the hash. Return False if validation fails. Tr' �r� r' r' r( �is_valid� r� zContentChecker.is_validc C r� )zu Call reporter with information about the checker (hash name) substituted into the template. Nr' )r� �reporter�templater' r' r( �report s zContentChecker.reportN)�__name__� __module__� __qualname__�__doc__r� r� r� r' r' r' r( r� � s r� c @ sD e Zd Ze�d�Zddd�Zedd� �Zdd � Z d d � Z d d � Z dS )� HashCheckerzK(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)=(?P<expected>[a-f0-9]+)�return�Nonec C s || _ t�|�| _|| _d S rg )� hash_name�hashlib�new�hash�expected)r� r� r� r' r' r( �__init__ s zHashChecker.__init__c C sB t j�|�d }|s t� S | j�|�}|st� S | di |�� ��S )z5Construct a (possibly null) ContentChecker from a URLr5 Nr' )r9 r# r: r� �patternr{ � groupdict)�clsr= rD rI r' r' r( �from_url s zHashChecker.from_urlc C s | j �|� d S rg )r� �updater� r' r' r( r� ! � zHashChecker.feedc C s | j �� | jkS rg )r� � hexdigestr� r� r' r' r( r� $ r� zHashChecker.is_validc C s || j }||�S rg )r� )r� r� r� �msgr' r' r( r� ' s zHashChecker.reportN�r� r� ) r� r� r� r] �compiler� r� � classmethodr� r� r� r� r' r' r' r( r� s � r� c s� e Zd ZdZ d`da� fd d � Z� fdd�Zdbdcdd�Zdbdddd�Zdbdedd�Zdfdd�Z dfd d �Z d d � Z d d!� Z dfd"d#�Z dgdfd$d%�Zdfd&d'�Zdg� fd(d)� Zdfd*d+�Zdfd,d-�Zd.d/� Zdfd0d1�Zd2d3� Z dhdid8d9�Z djdkd;d<�Zd=d>� Zd?Zd@dA� ZdfdBdC�ZdgdDdE�Z e dFdG� �Z e dHdI� �Z dJdK� Z!e dLdM� �Z"dNdO� Z#dPdQ� Z$dfdRdS�Z%dTdU� Z&dVdW� Z'e dXdY� �Z(dfdZd[�Z)dfd\d]�Z*dfd^d_�Z+� Z,S )lr z;A distribution index that scans web pages for download URLs�https://pypi.org/simple/��*NT� index_urlru � verify_ssl�boolr� r� c sl t � j|i |�� |dd |�d� � | _i | _i | _i | _t�d� t t |���j | _ g | _tjj| _d S )Nr4 �|)�superr� r. r� � scanned_urls� fetched_urls� package_pagesr] r� rf rt r rI �allows�to_scanr9 �request�urlopen�opener)r� r� �hosts� ca_bundler� rh �kw�� __class__r' r( r� / s zPackageIndex.__init__c s0 zt |j� W n ty Y d S w t� �|�S rg )r rP � Exceptionr� �add)r� �distr� r' r( r� A s � zPackageIndex.addF�retrievec C s� || j v r |s dS d| j |< t|�s| �|� dS tt|��}|r.| �|�s(dS | �d|� |s7|r7|| jv rAtt| j |�� dS | �|�sMd| j|< dS | � d|� d| j|< d}| � ||| �}|du rhdS t |t jj�r}|jdkr}| � d|j� �� d| j|j< d|j�d d ��� vr�|�� dS |j}|�� }t |t�s�t |t jj�r�d }n|j�d �p�d }|�|d �}|�� t� |�D ]} t j � |t | � d���} | �!| � q�|�"| j#�r�t$|dd�dkr�| �%||�}dS dS dS )z<Evaluate a URL as a possible download, and maybe retrieve itNTzFound link: %sz Reading %sz<Download error on %s: %%s -- Some packages may not be found!i� zAuthentication error: �html� content-type� zlatin-1�charset�ignorer �code� )&r� � URL_SCHEME�process_filename�listr �url_ok�debugr� rt r� �info�open_url� isinstancer9 �error� HTTPErrorr� r� r= �headers�getr- �close�readru � get_param�decoderw rq r# rx ry rJ � process_urlr/ r� �getattr� process_index) r� r= r� �dists�tmpl�fr1 r| r� rI �linkr' r' r( r� J sV �zPackageIndex.process_url�nestedc C s� t j�|�s| �d|� d S t j�|�r/|s/t j�|�}t �|�D ] }| �t j�||�d� q!t |�}|rE| � d|� t t | j |�� d S d S )Nz Not found: %sTz Found: %s)rZ rA �exists�warn�isdir�realpath�listdirr� rf r\ r� r� rt r� )r� �fnr� rA �itemr� r' r' r( r� s �z PackageIndex.process_filename�fatalc C s` t |�}|o|�d��� dk}|s | �tj�|�d �r dS d}|r(t|| ��| �||� dS )Nr �fileTz� Note: Bypassing %s (disallowed host; see https://setuptools.pypa.io/en/latest/deprecated/easy_install.html#restricting-downloads-with-allow-hosts for details). F) r� rJ r- r� r9 r# r: r r� )r� r= r� �s�is_filer� r' r' r( r� � s � zPackageIndex.url_okc C s2 t tjj|�}dd� |D �}tt�| j|�� d S )Nc s s2 � | ]}t �|�D ] }|�d �r ||fV q qdS )z .egg-linkN)rZ r� r. )r^ rA �entryr' r' r( r` � s � �� �z.PackageIndex.scan_egg_links.<locals>.<genexpr>)�filterrZ rA r� r� � itertools�starmap� scan_egg_link)r� � search_path�dirs� egg_linksr' r' r( �scan_egg_links� s �zPackageIndex.scan_egg_linksc C s� t tj�||��}ttd ttj|� � ���}t |�dkr d S |\}}t tj�||��D ]}tjj|g|�R � |_ t |_| �|� q+d S )Nra )r rZ rA rf r� r� rt ru rv � splitlinesrT r rN r rF r� )r� rA r� �content�lines�egg_path� _setup_pathr� r' r' r( r� � s �zPackageIndex.scan_egg_linkc C s� d}|� | j�s |S tttjj|t| j�d � �d���}t|�dks)d|d v r+|S t |d �}t |d �}d| j � |� � i �|< t|�t|�fS )N�NNr4 ra r8 r r T)r/ r� r� rt r9 r# r; rT r< r r r� � setdefaultr- r )r� r� �NO_MATCH_SENTINELr> �pkg�verr' r' r( �_scan� s & zPackageIndex._scanc C s� t �|�D ] }z| �tj�|t|�d���� W q ty! Y qw | �|�\}}|s-dS t ||�D ]&}t |�\}}|� d�rS|sS|rN|d|� d|� �7 }n| � |� | � |� q2t�dd� |�S )z#Process the contents of a PyPI pager r� �.pyz#egg=rM c S s dj | �ddd�� S )Nz<a href="{}#md5={}">{}</a>r � ra )�formatrJ )�mr' r' r( �<lambda>� � z,PackageIndex.process_index.<locals>.<lambda>)rw rq r� r9 r# rx ry rJ r$ r� rE r. �need_version_info�scan_url�PYPI_MD5�sub) r� r= r| rI r� r� �new_urlr1 �fragr' r' r( r� � s& " � �zPackageIndex.process_indexc C s | � d|� d S )NzPPage at %s links to .py file(s) without version info; an index scan is required.)�scan_all�r� r= r' r' r( r � s �z PackageIndex.need_version_infoc G s< | j | jvr|r| j|g|�R � | �d� | �| j � d S )Nz6Scanning index of all packages (this may take a while))r� r� r� r� r �r� r� rh r' r' r( r � s zPackageIndex.scan_allc C sz | � | j|j d � | j�|j�s | � | j|j d � | j�|j�s)| �|� t| j�|jd��D ]}| � |� q3d S )Nr4 r' ) r r� � unsafe_namer� r� �keyrO �not_found_in_indexr� )r� � requirementr= r' r' r( � find_packages� s �zPackageIndex.find_packagesc sN | � � | �|� | |j D ]}||v r| S | �d||� qt� �||�S )Nz%s does not match %s)�prescanr r r� r� �obtain)r� r � installerr� r� r' r( r s zPackageIndex.obtainc C sR |� | jd|� �� |�� s'|�� t�|� t|jj� dtj � |�� d���dS )z- checker is a ContentChecker zValidating %s checksum for z validation failed for z ; possible download problem?N) r� r� r� r� rZ �unlinkr r� r0 rA rU )r� �checkerr[ �tfpr' r' r( � check_hash s ��zPackageIndex.check_hashc C sN |D ]"}| j du st|�r|�d�stt|��r | �|� q| j �|� qdS )z;Add `urls` to the list that will be prescanned for searchesN�file:)r� r� r/ r� r r �append)r� �urlsr= r' r' r( �add_find_links s �� � �zPackageIndex.add_find_linksc C s" | j r tt| j| j �� d| _ dS )z7Scan urls scheduled for prescanning (e.g. --find-links)N)r� r� rt r r� r' r' r( r ( s zPackageIndex.prescanc C s< | |j r | jd}}n| jd}}|||j� | �� d S )Nz#Couldn't retrieve index page for %rz3Couldn't find index page for %r (maybe misspelled?))r r� r� r r )r� r �methr� r' r' r( r . s z PackageIndex.not_found_in_indexc C sv t |t�s1t|�}|r%| �||�}t|�\}}|�d�r#| �|||�}|S tj� |�r-|S t |�}t | � ||�dd�S )a Locate and/or download `spec` to `tmpdir`, returning a local path `spec` may be a ``Requirement`` object, or a string containing a URL, an existing local filename, or a project/version requirement spec (i.e. the string form of a ``Requirement`` object). If it is the URL of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is automatically created alongside the downloaded file. If `spec` is a ``Requirement`` object or a string containing a project/version requirement spec, this method returns the location of a matching distribution (possibly after downloading it to `tmpdir`). If `spec` is a locally existing file or directory name, it is simply returned unchanged. If `spec` is a URL, it is downloaded to a subpath of `tmpdir`, and the local filename is returned. Various errors may be raised if a problem occurs during downloading. r� rN N) r� r r� � _download_urlrE r. � gen_setuprZ rA r� r) r� �fetch_distribution)r� r% �tmpdir�scheme�foundr1 rD r' r' r( r6 6 s zPackageIndex.download� force_scan�source� develop_ok�Distribution | Nonec s� �� d|� t� �d}d d � ����fdd� }|r&��� ��|� ||�}|s1|dur1|||�}|du rB�jdur>��� ||�}|du rQ|sQ��|� ||�}|du rb��d�r\dp]d |� dS �� d |� |j|jd �S )a| Obtain a distribution suitable for fulfilling `requirement` `requirement` must be a ``pkg_resources.Requirement`` instance. If necessary, or if the `force_scan` flag is set, the requirement is searched for in the (online) package index as well as the locally installed packages. If a distribution matching `requirement` is found, the returned distribution's ``location`` is the value you would have gotten from calling the ``download()`` method with the matching distribution's URL or filename. If no matching distribution is found, ``None`` is returned. If the `source` flag is set, only source distributions and source checkout links will be considered. Unless the `develop_ok` flag is set, development and system eggs (i.e., those using the ``.egg-info`` format) will be ignored. zSearching for %sN�env�Environment | Nonec s� |d u r�}|| j D ]<}|jtkr$� s$|�vr#��d|� ��|� q || v o/|jtkp/� }|rG��|j��}||_t j � |j�rG| S q d S )Nz&Skipping development or system egg: %s) r rF r r� r� r r6 rN �download_locationrZ rA r� )�reqr' r� �test�loc�r% r� �skippedr$ r r' r( rz v s& � �z-PackageIndex.fetch_distribution.<locals>.findz:No local packages or working download links found for %s%sza source distribution of r� zBest match: %s)rN rg )r' r( )r� rs r r r� r� �cloner) ) r� r r r# r$ r% � local_indexr� rz r' r- r( r X s4 � z PackageIndex.fetch_distribution� str | Nonec C s" | � ||||�}|dur|jS dS )a3 Obtain a file suitable for fulfilling `requirement` DEPRECATED; use the ``fetch_distribution()`` method now instead. For backward compatibility, this routine is identical but returns the ``location`` of the downloaded distribution instead of a distribution object. N)r rN )r� r r r# r$ r� r' r' r( �fetch� s zPackageIndex.fetchc C s" t �|�}|rdd� t||�d�d �D �pg }t|�dkr�tj�|�}tj�|�|krGtj� ||�}tj� |�r?tj� ||�sGt � ||� |}ttj� |d�ddd��$}|�d|d j�d |d j�d tj�|�d �d �� W d � |S 1 szw Y |S |r�td |�d|����td��)Nc S s g | ]}|j r|�qS r' )rP )r^ �dr' r' r( � <listcomp>� s ��z*PackageIndex.gen_setup.<locals>.<listcomp>r zsetup.py�wzutf-8)�encodingz(from setuptools import setup setup(name=r z , version=z, py_modules=[z]) z9Can't unambiguously interpret project/version identifier zI; any dashes in the name or version should be escaped using underscores. zpCan't process plain .py files without an '#egg=name-version' suffix to enable automatic setup script generation.)rH rI r rJ rT rZ rA rU �dirnamerf r� �samefile�shutil�copy2�open�writerO rP �splitextr ) r� r[ rD r rI r� rU �dstr� r' r' r( r � sL ��� ���� �����zPackageIndex.gen_setupi c C s: | � d|� d }z�t�|�}| �|�}t|tjj�r)td|� d|j � d|j � ���|� � }d}| j }d}d|v rM|� d�} t tt| ��}| �|||||� t|d ��1} |�|�} | rs|�| � | �| � |d 7 }| �|||||� nnqT| �||| � W d � n1 s�w Y |W |r�|�� S S |r�|�� w w ) NzDownloading %szCan't download �: � r r5 zcontent-lengthzContent-Length�wbTr )r� r� r� r� r� r9 r� r� r r� r� � dl_blocksize�get_all�maxrt �int� reporthookr; r� r� r< r r� ) r� r= r[ �fpr r� �blocknum�bs�size�sizesr r� r' r' r( � _download_to� sB � � � �zPackageIndex._download_toc C s d S rg r' )r� r= r[ rH �blksizerJ r' r' r( rF � zPackageIndex.reporthookc C s� |� d�r t|�S zt|| j�W S ttjjfyE } z%d�dd� |j D ��}|r0| � ||� n t |� d|� ��|�W Y d }~d S d }~w t j jyZ } z|W Y d }~S d }~w t j jy� } z |rm| � ||j� n t d|� d|j� ��|�W Y d }~d S d }~w tjjy� } z |r�| � ||j� n t |� d|j� ��|�W Y d }~d S d }~w tjjtfy� } z|r�| � ||� n t d|� d|� ��|�W Y d }~d S d }~ww )Nr r@ c S s g | ]}t |��qS r' )ru )r^ �argr' r' r( r4 r z)PackageIndex.open_url.<locals>.<listcomp>zDownload error for r? z7 returned a bad status line. The server might be down, )r/ � local_open�open_with_authr� r$ �http�client� InvalidURLrf rh r� r r9 r� r� �URLError�reason� BadStatusLine�line� HTTPException�OSError)r� r= �warning�vr� r' r' r( r� sN �������������zPackageIndex.open_urlc C s d� d�}t�|d| �S )a� Replace unsafe path directives with underscores. >>> san = PackageIndex._sanitize >>> san('/home/user/.ssh/authorized_keys') '_home_user_.ssh_authorized_keys' >>> san('..\\foo\\bing') '__foo_bing' >>> san('D:bar') 'D_bar' >>> san('C:\\bar') 'C__bar' >>> san('foo..bar') 'foo..bar' >>> san('D:../foo') 'D___foo' r� )�:z[/\\]z6(?:(?<=([/\\]|:))\.\.(?=[/\\]|$))|(?:^\.\.(?=[/\\]|$))�_)rf r] r )r0 r� r' r' r( � _sanitize* s zPackageIndex._sanitizec C s6 t |�\}}| �|p d�}t�dd|�}tj�||�S )aK >>> import pathlib >>> du = PackageIndex._resolve_download_filename >>> root = getfixture('tmp_path') >>> url = 'https://files.pythonhosted.org/packages/a9/5a/0db.../setuptools-78.1.0.tar.gz' >>> str(pathlib.Path(du(url, root)).relative_to(root)) 'setuptools-78.1.0.tar.gz' �__downloaded__z \.egg\.zip$rL )rE r_ r] r rZ rA rf )r� r= r r0 � _fragmentr' r' r( �_resolve_download_filenameG s �z'PackageIndex._resolve_download_filenamec C s$ | � ||�}| �||�p| �||�S )z2 Determine the download filename. )rb � _download_vcs�_download_other)r� r= r r[ r' r' r( r ^ s zPackageIndex._download_urlc C sL t j�| �j}|�d�\}}}tddgdgt|� �}tt|h|@ �d�S )a >>> rvcs = PackageIndex._resolve_vcs >>> rvcs('git+http://foo/bar') 'git' >>> rvcs('hg+https://foo/bar') 'hg' >>> rvcs('git:myhost') 'git' >>> rvcs('hg:myhost') >>> rvcs('http://foo/bar') �+�svn�git�hgN) r9 r# �urlsplitr! � partitionrs r� �next�iter)r= r! �pre�sep�_post�allowedr' r' r( � _resolve_vcse s zPackageIndex._resolve_vcsc C s� | � |�}|s d S |dkrtd|� ���|�d�\}}}| �|�\}}| �d|� d|� d|� �� t�|dd||g� t|d |d d|g|d |d d d |dgd�}|d urb| �d|� �� t�|| � |S )Nrf z/Invalid config, SVN download is not supported: r8 zDoing z clone from z to r/ z--quietz-C�checkoutz--cwd�upz-rz-q)rg rh z Checking out )rq r rj �_vcs_split_rev_from_urlr� � subprocess� check_call�dict)r� r= � spec_filename�vcsr[ r^ �rev� co_commandsr' r' r( rc x s& � �zPackageIndex._download_vcsc C sD t j�|�j}|dkrt j�t j�|�j�S | �|d� | � ||�S )Nr� T) r9 r# ri r! r� � url2pathnamer: rA r� �_attempt_download)r� r= r[ r! r' r' r( rd � s z PackageIndex._download_otherc C s | � |d� d S )NT)r� r r' r' r( r � r� zPackageIndex.scan_urlc C s2 | � ||�}d|�dd��� v r| �|||�S |S )Nr� r� r� )rL r� r- �_invalid_download_html)r� r= r[ r� r' r' r( r} � s z PackageIndex._attempt_downloadc C s t �|� td|� ���)Nz Unexpected HTML page found at )rZ r r )r� r= r� r[ r' r' r( r~ � s z#PackageIndex._invalid_download_htmlc C st t j�| �}|j�dd�d }|j�d�\}}}|�d�\}}}|r&||fn|df\}} |j||dd�� � } | | fS ) a� Given a possible VCS URL, return a clean URL and resolved revision if any. >>> vsrfu = PackageIndex._vcs_split_rev_from_url >>> vsrfu('git+https://github.com/pypa/setuptools@v69.0.0#egg-info=setuptools') ('https://github.com/pypa/setuptools', 'v69.0.0') >>> vsrfu('git+https://github.com/pypa/setuptools#egg-info=setuptools') ('https://github.com/pypa/setuptools', None) >>> vsrfu('http://foo/bar') ('http://foo/bar', None) re r r5 r8 �@Nr� )r! rA rD ) r9 r# ri r! r< rA rj � rpartition�_replace�geturl) r= r> � clean_scheme�no_fragment_pathr^ rm rn �post� clean_pathrz �resolvedr' r' r( rt � s ��z$PackageIndex._vcs_split_rev_from_urlc G � t j|g|�R � d S rg )r r� r r' r' r( r� � � zPackageIndex.debugc G r� rg )r r� r r' r' r( r� � r� zPackageIndex.infoc G r� rg )r r� r r' r' r( r� � r� zPackageIndex.warn)r� r� NT)r� ru r� r� r� r� )F)r� r� r� r� )r� r� r� r� )r� r� r� r� r� rg )FFFN)r# r� r$ r� r% r� r� r& )FF)r# r� r$ r� r� r1 )-r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r6 r r2 r rB rL rF r� � staticmethodr_ r� rb r rq rc rd r r} r~ rt r� r� r� � __classcell__r' r' r� r( r , sj � 5 & �S �) " r z!&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?c C s | � d�}t�|�S )Nr )rJ r� �unescape)rI �whatr' r' r( � decode_entity� s r� c C s t t| �S )a Decode HTML entities in the given text. >>> htmldecode( ... 'https://../package_name-0.1.2.tar.gz' ... '?tokena=A&tokenb=B">package_name-0.1.2.tar.gz') 'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz' )� entity_subr� )�textr' r' r( ry � s ry c s � fdd�}|S )Nc s � �fdd�}|S )Nc s: t �� }t ��� z � | i |��W t �|� S t �|� w rg )�socket�getdefaulttimeout�setdefaulttimeout)rh ri � old_timeout)rk �timeoutr' r( �_socket_timeout� s z@socket_timeout.<locals>._socket_timeout.<locals>._socket_timeoutr' )rk r� �r� rj r( r� � s z'socket_timeout.<locals>._socket_timeoutr' )r� r� r' r� r( �socket_timeout� s r� c C s2 t j�| �}|�� }t�|�}|�� }|�dd�S )a9 Encode auth from a URL suitable for an HTTP header. >>> str(_encode_auth('username%3Apassword')) 'dXNlcm5hbWU6cGFzc3dvcmQ=' Long auth strings should not cause a newline to be inserted. >>> long_auth = 'username:' + 'password'*10 >>> chr(10) in str(_encode_auth(long_auth)) False � r� )r9 r# r; �encode�base64� b64encoder� �replace)�auth�auth_s� auth_bytes� encoded_bytes�encodedr' r' r( � _encode_auth� s r� c @ s, e Zd ZU dZded< ded< d dd�ZdS ) � Credentialz� A username/password pair. Displayed separated by `:`. >>> str(Credential('username', 'password')) 'username:password' ru �username�passwordr� c C s | j � d| j� �S )Nr] )r� r� r� r' r' r( �__str__ s zCredential.__str__N)r� ru )r� r� r� r� �__annotations__r� r' r' r' r( r� s r� c s8 e Zd Z� fdd�Zedd� �Zdd� Zdd� Z� ZS ) � PyPIConfigc sP t �g d�d�}t� �|� tj�tj�d�d�}tj�|�r&t | |� dS dS )z% Load from ~/.pypirc )r� r� � repositoryr� �~z.pypircN) rw �fromkeysr� r� rZ rA rf � expanduserr� r )r� �defaults�rcr� r' r( r� s �zPyPIConfig.__init__c s& � fdd�� � � D �}tt� j|��S )Nc s g | ] }� � |d ��� r|�qS )r� )r� rv )r^ �sectionr� r' r( r4 ) s ��z2PyPIConfig.creds_by_repository.<locals>.<listcomp>)�sectionsrw rt �_get_repo_cred)r� �sections_with_repositoriesr' r� r( �creds_by_repository' s �z PyPIConfig.creds_by_repositoryc C s6 | � |d��� }|t| � |d��� | � |d��� �fS )Nr� r� r� )r� rv r� )r� r� �repor' r' r( r� 1 s �zPyPIConfig._get_repo_credc C s* | j �� D ] \}}|�|�r| S qdS )z� If the URL indicated appears to be a repository defined in this config, return the credential for that repository. N)r� �itemsr/ )r� r= r� �credr' r' r( �find_credential8 s �zPyPIConfig.find_credential) r� r� r� r� �propertyr� r� r� r� r' r' r� r( r� s r� c C s> t j�| �}|\}}}}}}|�d�rtj�d��|dv r$t|�\} } nd\} } | sDt� � | �} | rDt | �} | j | f} t j dg| �R � | rgdt| � } || ||||f} t j�| �}t j�|�}|�d| � nt j�| �}|�dt� ||�}| r�t j�|j�\}}}}}}||kr�|| kr�||||||f} t j�| �|_|S ) z4Open a urllib2 request, handling HTTP authenticationr] znonnumeric port: '')rR �httpsr� z*Authenticating as %s for %s (from .pypirc)zBasic � Authorizationz User-Agent)r9 r# r: r. rR rS rT � _splituserr� r� ru r� r r� r� � urlunparser� �Request� add_header� user_agentr= )r= r� �parsedr! �netlocrA �params�queryr r� �addressr� r� r> r r� rG �s2�h2�path2�param2�query2�frag2r' r' r( rQ C s8 rQ c C s$ | � d�\}}} |r|| fS d| fS )zNsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.r N)r� )�host�user�delimr' r' r( r� s s r� c C s | S rg r' )r= r' r' r( � fix_sf_url~ rN r� c C s t j�| �\}}}}}}t j�|�}tj�|�r t j�| �S |� d�rktj� |�rkg }t� |�D ])} tj� || �} | dkrCt | �} n#tj� | �rM| d7 } |�d| � d| � d�� q0d} | j| d� |�d�} d \} }nd \} }} d d i}t�| �}t j�| | |||�S ) z7Read a local path, with special support for directoriesr4 z index.htmlz <a href="z">z</a>zB<html><head><title>{url}</title></head><body>{files}</body></html>r� )r= �files)�� �OK)r� zPath not foundz Not foundr� z text/html)r9 r# r: r� r| rZ rA �isfiler� r. r� r� rf r r r� �io�StringIOr� r� )r= r? �_serverrA �_paramrC �_fragr[ r� r� �filepath�bodyr� �status�messager� � body_streamr' r' r( rP � s* rP rg )r! )br� � __future__r r� � configparserr� r� � http.clientrR r� r� rZ r] r9 r� ru �sys� urllib.errorr9 � urllib.parse�urllib.request�fnmatchr � functoolsr �typingr �more_itertoolsr � setuptools� pkg_resourcesr r r r r r r r r r r r r r �setuptools.wheelr � unicode_utilsr r � distutilsr �distutils.errorsr r� rH �Irw r rI r� r< rS �__all__�_SOCKET_TIMEOUT� __version__� version_info�major�minorr� r) r rE r rG r\ r rm rp r� r� r� r r r� r� ry r� r� r� �RawConfigParserr� r� r� rQ r� r� rP r' r' r' r( �<module> s� @ � # �" ! , (0 __pycache__/_shutil.cpython-310.pyc 0000644 00000003302 15030122015 0013107 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlmZmZ ddlmZ ddlm Z zddlm Z W n e y: de d e d dfd d �Z Y nw ed �Z dd� Zdede f deded e fdd�Zdefdd�Zdd� ZdS )z2Convenience layer on top of stdlib's shutil and os� N)�Callable�TypeVar� )�py311)�log)�chmod�args�kwargs�returnc O s d S �N� )r r r r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_shutil.pyr s r �_Tc C sR t �d| |� zt| |� W d S ty( } z t �d|� W Y d }~d S d }~ww )Nzchanging mode of %s to %ozchmod failed: %s)r �debugr �OSError)�path�mode�er r r �attempt_chmod_verbose s ��r �func.�arg�excc C s2 | t jt jfv rt jdkrt|tj� | |�S |�)zIshutils onexc callback to automatically call chmod for certain functions.�nt)�os�unlink�remove�namer �stat�S_IWRITE)r r r r r r � _auto_chmod s r Fc C s t �| ||�S )zx Similar to ``shutil.rmtree`` but automatically executes ``chmod`` for well know Windows failure scenarios. )r � shutil_rmtree)r � ignore_errors�onexcr r r �rmtree+ s r# c K s$ t j�| �rt| fi |�� d S d S r )r r �isdirr# )r �optsr r r �rmdir3 s �r& )�__doc__r r �typingr r �compatr � distutilsr r � ImportError�objectr r �str� BaseExceptionr r# r& r r r r �<module> s0 � ��� � __pycache__/_core_metadata.cpython-310.pyc 0000644 00000022313 15030122015 0014372 0 ustar 00 o �h�. � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl m Z ddl m Z ddlmZ dd lmZmZ dd lmZ d d lmZmZ d d lmZ d dlmZ ddl m Z dd� Z d_dd�Z d`dd �Z d`d d �Z!dad d!�Z"dbd"d#�Z#d$d%� Z$d&d'� Z%d(d)� Z&d*d+� Z'd,d-� Z(dcd2d3�Z)d4d5� Z*d6d7� Z+ddd:d;�Z,d<d=� Z-i d>d>�d?d@�dAdB�dCdD�dEdF�dGdH�dIdJ�dKdK�dLdL�dMdN�dOdP�dQdQ�dRdS�dTdT�dUdV�dWdX�dYdY�dZd[d\d]dCd^��Z.dS )ez� Handling of Core Metadata for Python packages (including reading and writing). See: https://packaging.python.org/en/latest/specifications/core-metadata/ � )� annotationsN)�message_from_file)�Message)�NamedTemporaryFile)�Marker)� Requirement)�canonicalize_name�canonicalize_version)�Version� )�_normalization�_reqs)� is_static)� SetuptoolsDeprecationWarning)� rfc822_escapec C s& t | dd �}|d u rtd�}|| _|S )N�metadata_versionz2.4)�getattrr r )�self�mv� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_core_metadata.py�get_metadata_version s r �content�str�returnc C sJ | � � }t|�dkr|d �� S d�|d �� t�d�|dd� ��f�S )zFReverse RFC-822 escaping by removing leading whitespaces from content.r r � N)� splitlines�len�lstrip�join�textwrap�dedent)r �linesr r r �rfc822_unescape$ s *r# �msgr �field� str | Nonec C s | | }|dkr dS |S )zRead Message header field.�UNKNOWNNr �r$ r% �valuer r r �_read_field_from_msg, s r* c C s t | |�}|du r |S t|�S )z4Read Message header field and apply rfc822_unescape.N)r* r# r( r r r � _read_field_unescaped_from_msg4 s r+ �list[str] | Nonec C s | � |d�}|g kr dS |S )z9Read Message header field and return all results as list.N)�get_all)r$ r% �valuesr r r �_read_list_from_msg< s r/ c C s$ t | �� ��� }|dks|sd S |S )Nr' )r � get_payload�strip)r$ r) r r r �_read_payload_from_msgD s r2 c C sP t |�}t|d �| _t|d�| _t|d�| _t|d�| _t|d�| _d| _t|d�| _ d| _ t|d�| _ t|d �| _ t |d �| _t |d �| _t |d �| _| jdu r^| jtd �kr^t|�| _t|d�| _d|v rqt|d��d�| _t|d�| _t|d�| _| jtd�kr�t|d�| _t|d�| _t|d�| _n d| _d| _d| _t|d�| _dS )z-Reads the metadata values from a file object.zmetadata-version�name�version�summary�authorN� author-email� home-page� download-url�license�license-expression� descriptionz2.1�keywords�,�platform� classifierz1.1�requires�provides� obsoletes� license-file)r r r r* r3 r4 r< r6 � maintainer� author_email�maintainer_email�url� download_urlr+ r: �license_expression�long_descriptionr2 �splitr= r/ � platforms� classifiersrA rB rC � license_files)r �filer$ r r r � read_pkg_fileK s: rQ c C s. d| v rd}t �d|� | �� �d�d } | S )zF Quick and dirty validation for Summary pypa/setuptools#1390. r zBnewlines are not allowed in `summary` and will break in the futurezInvalid config.r )r �emitr1 rL )�valr$ r r r � single_lineu s rT c C s� d}t j�|d�}zOtdd|dd��}|j}| �|� W d � n1 s%w Y t�t �|�j �}t � ||tj B tj B � t � ||� W |rUt j�|�rWt �|� dS dS dS |rgt j�|�rht �|� w w w )z.Write the PKG-INFO file into the release tree.� zPKG-INFO�wzutf-8F)�encoding�dir�deleteN)�os�pathr r r3 �write_pkg_file�stat�S_IMODE�lstat�st_mode�chmod�S_IRGRP�S_IROTH�replace�exists�remove)r �base_dir�temp�final�f� permissionsr r r �write_pkg_info� s �� �rl c s( | � � }� fdd�}|dt|�� |d| �� � |d| �� � | �� }|r,|dt|�� d}|D ]\}}t| |d�}|durC|||� q0| j } rO|d | � n | �� } r\|d t | �� | j � � D ]\} } |d | � d | � �� qad � | � � �} | r~|d| � | �� p�g }|D ]}|d|� q�| �� d| �� � | �� d| �� � | �� d| �� � | �� d| �� � t| d�r�|d| j� | jr�|d| j� tt| jp�g �}| �� d|� t| � � t� � D ]\}}t| |d� }r�t |�s�|d|� q�| � � }|�r� � d|� �� |� d��s� � d� dS dS dS )z0Write the PKG-INFO format data to a file object.c s � � | � d|� d�� d S )Nz: r )�write)�keyr) �rP r r � write_field� s z#write_pkg_file.<locals>.write_fieldzMetadata-Version�Namer �Summary))z Home-pagerH )z Download-URLrI )�Authorr6 )z Author-emailrF )� MaintainerrE )zMaintainer-emailrG NzLicense-Expression�Licensez Project-URLz, r> �Keywords�Platform� Classifier�Requires�Provides� Obsoletes�python_requireszRequires-PythonzDescription-Content-Typez License-File�Dynamicr ) r r �get_name� get_version�get_descriptionrT r rJ � get_licenser � project_urls�itemsr � get_keywords� get_platforms� _write_list�get_classifiers� get_requires� get_provides� get_obsoletes�hasattrr| � long_description_content_type�map�_safe_license_filerO �_write_requirements�_POSSIBLE_DYNAMIC_FIELDSr �get_long_descriptionrm �endswith)r rP r4 rp r5 �optional_fieldsr% �attr�attr_valrJ r: �labelrH r= rM r? �safe_license_filesrS rK r ro r r\ � s` � � �r\ c C s� t �| j�D ] }|�d|� d�� qi }| j�� D ]7\}}|�d�\}}}|�� }t� |�} | r7t ||| |� t � |�D ]}t || |�� �} |�d| � d�� q<q|S )NzRequires-Dist: r �:) r �parse�install_requiresrm �extras_requirer� � partitionr1 r � safe_extra�_write_provides_extra� parse_strings�_include_extra) r rP �req�processed_extras�augmented_extra�reqs� unsafe_extra�_� condition�extra�rr r r r� � s �r� r� r� r� r c C sb t | �}|jrd|j� d�nd |rd|� d�nd |r d|��nd f}td�dd� |D ���|_|S )N�(�)z extra == � and c s s � | ]}|r|V qd S �Nr )�.0�xr r r � <genexpr>� s � z!_include_extra.<locals>.<genexpr>)r �markerr r )r� r� r� r� �partsr r r r� � s �r� c C sX |� |�}||kr tjdd|�d|�d|�d�dd� d S |||< | �d|� d �� d S ) Nz8Ambiguity during "extra" normalization for dependencies.z r� z/ normalize to the same value: zW In future versions, setuptools might halt the build process. z!https://peps.python.org/pep-0685/)�see_urlzProvides-Extra: r )�getr rR rm )rP r� �safe�unsafe�previousr r r r� s ��� � r� c C s t | �� | �� �S r� )�_distribution_fullnamer~ r )r r r r � get_fullname s r� r3 r4 c C s d� t| ��dd�t|dd��S )a� >>> _distribution_fullname('setup.tools', '1.0-2') 'setup_tools-1.0.post2' >>> _distribution_fullname('setup-tools', '1.2post2') 'setup_tools-1.2.post2' >>> _distribution_fullname('setup-tools', '1.0-r2') 'setup_tools-1.0.post2' >>> _distribution_fullname('setup.tools', '1.0.post') 'setup_tools-1.0.post0' >>> _distribution_fullname('setup.tools', '1.0+ubuntu-1') 'setup_tools-1.0+ubuntu.1' z{}-{}�-r� F)�strip_trailing_zero)�formatr rd r )r3 r4 r r r r� s �r� c C s. t j�| ��t jd�}d|v rt j�|�S |S )N�/z../)rZ r[ �normpathrd �sep�basename)rP � normalizedr r r r� ) s r� r6 r7 rF r@ rN r< rK zdescription-content-typer� r9 rI r8 rH r= r: rD rO r; rJ rE zmaintainer-emailrG rC r? rM z project-urlr� rB r� rA r� r| )zprovides-extrarA z requires-distzrequires-pythonr5 )r r r r )r$ r r% r r r& )r$ r r% r r r, )r$ r r r& )r� r r� r r� r r r )r3 r r4 r r r )/�__doc__� __future__r rZ r] r �emailr � email.messager �tempfiler �packaging.markersr �packaging.requirementsr �packaging.utilsr r �packaging.versionr rU r r �_staticr �warningsr �distutils.utilr r r# r* r+ r/ r2 rQ rT rl r\ r� r� r� r� r� r� r� r r r r �<module> s� *K ������� � ��������� � __pycache__/_itertools.cpython-310.pyc 0000644 00000001561 15030122015 0013630 0 ustar 00 o �h� � @ s d dl mZ dd� fdd�ZdS )� )�consumec C s | S )N� )�xr r �H/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_itertools.py�<lambda> s r c c sJ � t � }|j}| D ]}||�}||v rtd|�d���||� |V q dS )a Wrap an iterable to raise a ValueError if non-unique values are encountered. >>> list(ensure_unique('abc')) ['a', 'b', 'c'] >>> consume(ensure_unique('abca')) Traceback (most recent call last): ... ValueError: Duplicate element 'a' encountered. zDuplicate element z encountered.N)�set�add� ValueError)�iterable�key�seen�seen_add�element�kr r r � ensure_unique s � �r N)�more_itertoolsr r r r r r �<module> s __pycache__/depends.cpython-310.pyc 0000644 00000012524 15030122015 0013070 0 ustar 00 o �hM � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlmZ d dlm Z m Z m Z d dl m Z ddlmZ ddlmZmZmZmZ e d �Zd d gZG d d � d �Zd d� Zej�d�srejdkrt d d dd�Z d d!d d �Zedd g7 ZdS dS dS )"� )� annotationsN)�CodeType)�Any�Literal�TypeVar)�Version� )�_imp)� PY_COMPILED� PY_FROZEN� PY_SOURCE� find_module�_T�Requirer c @ sT e Zd ZdZ dddd �Zd d � Zd d � Z dddd�Zd dd�Zd dd�Z dS ) r z7A prerequisite to building or installing a distribution� N�homepage�str�return�Nonec C sF |d u r |d ur t }|d ur||�}|d u rd}| j�t� � | `d S )N� __version__)r �__dict__�update�locals�self)r �name�requested_version�moduler � attribute�format� r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/depends.py�__init__ s zRequire.__init__c C s" | j dur| j� d| j � �S | jS )z0Return full package/distribution name, w/versionN�-)r r )r r r r � full_name+ s zRequire.full_namec C s0 | j du p| jdu pt|�dko| �|�| jkS )z%Is 'version' sufficiently up-to-date?N�unknown)r r r r )r �versionr r r � version_ok1 s � �zRequire.version_okr$ �default�_T | Literal['unknown']�$_T | Literal['unknown'] | None | Anyc C s� | j du r#z t| j|�\}}}W n ty Y dS w |r!|�� |S t| j| j ||�}|dur>||ur>| jdur>| �|�S |S )a� Get version number of installed module, 'None', or 'default' Search 'paths' for module. If not found, return 'None'. If found, return the extracted version attribute, or 'default' if no version attribute was specified, or the value cannot be determined without importing the module. The version is formatted according to the requirement's version format (if any), unless it is 'None' or the supplied 'default'. N)r r r � ImportError�close�get_module_constantr )r �pathsr' �f�_p�_i�vr r r � get_version: s � zRequire.get_versionc C s | � |�duS )z/Return true if dependency is present on 'paths'N)r2 )r r- r r r � is_presentW s zRequire.is_presentc C s$ | � |�}|du r dS | �t|��S )z>Return true if dependency is present and up-to-date on 'paths'NF)r2 r& r )r r- r% r r r � is_current[ s zRequire.is_current)r NN)r r r r )Nr$ )r' r( r r) �N) �__name__� __module__� __qualname__�__doc__r! r# r& r2 r3 r4 r r r r r s � � c C s" t jdd� �}| s |� S t �| �S )Nc s s � d V d S r5 r r r r r �emptyd s �zmaybe_close.<locals>.empty)� contextlib�contextmanager�closing)r. r: r r r � maybe_closec s r> �java�cli���r' �_T | intr �_T | int | None | Anyc C s� zt | |� \}}\}}}} W n ty Y dS w t|��C |tkr.|�d� t�|�} n,|tkr9t� | |�} n!|t krFt |�� |d�} nt� | || �} t | |d�W d � S W d � n1 sdw Y t| ||�S )a Find 'module' by searching 'paths', and extract 'symbol' Return 'None' if 'module' does not exist on 'paths', or it does not define 'symbol'. If the module defines 'symbol' as a constant, return the constant. Otherwise, return 'default'.N� �exec)r r* r> r �read�marshal�loadr r �get_frozen_objectr �compile� get_module�getattr�extract_constant) r �symbolr' r- r. �path�_suffix�_mode�kind�info�code�importedr r r r, s s& � �� r, rT r rN r c C s� || j vrdS t| j ��|�}tjd }tjd }tjd }|}t�| �D ]*}|j} |j} | |kr=| dus7J �| j| }q%| |krM| |ksI| |krM| S |}q%dS )a/ Extract the constant value of 'symbol' from 'code' If the name 'symbol' is bound to a constant value by the Python code object 'code', return that value. If 'symbol' is bound to an expression, return 'default'. Otherwise, return 'None'. Return value is based on the first assignment to 'symbol'. 'symbol' must be a global, or at least a non-"fast" local in the code block. That is, only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol' must be present in 'code.co_names'. N� STORE_NAME� STORE_GLOBAL� LOAD_CONST) �co_names�list�index�dis�opmap�Bytecode�opcode�arg� co_consts) rT rN r' �name_idxrV rW rX �const� byte_code�opr` r r r rM � s" rM )rA N)r' rB r rC )rA )rT r rN r r' rB r rC ) � __future__r r; r\ rG �sys�typesr �typingr r r �packaging.versionr r r r r r r r �__all__r r> �platform� startswithr, rM r r r r �<module> s* O � �(� __pycache__/_entry_points.cpython-310.pyc 0000644 00000006260 15030122015 0014342 0 ustar 00 o �h � @ s� d dl Z d dlZd dlZd dlmZ d dlmZ d dlmZ ddl m Z ddl m Z ddl mZ d d � Zd d � Zd d� Zde jfdd�Ze jdd� �Ze�e�dd� �Ze�ed�dd� � ede jfdd��Zdd� ZdS ) � N)� pass_none)� yield_lines)�consume� )�metadata)� ensure_unique)� OptionErrorc C s@ z| j W dS ttfy } z d| � d�}t|�|�d}~ww )zR Exercise one of the dynamic properties to trigger the pattern match. zProblems to parse zq. Please ensure entry-point follows the spec: https://packaging.python.org/en/latest/specifications/entry-points/N)�extras�AttributeError�AssertionErrorr )�ep�ex�msg� r �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_entry_points.py� ensure_valid s � ��r c C s* t | �}d|� d�d�|� }tj�|�S )zf Given a value of an entry point or series of entry points, return each as an EntryPoint. �[�] � )r �joinr � EntryPoints� _from_text)�value�group�lines�textr r r � load_group s r c C s | j | jfS �N)r �name)r r r r �by_group_and_name) s r �epsc C s t ttt| td��� | S )zM Ensure entry points are unique by group and name and validate each. ��key)r �mapr r r �r r r r �validate- s r% c C s( t j�dd� | �� D ��}tt�|��S )zA Given a Distribution.entry_points, produce EntryPoints. c s s � | ] \}}t ||�V qd S r )r )�.0r r r r r � <genexpr>: s � �zload.<locals>.<genexpr>)� itertools�chain� from_iterable�itemsr% r r )r �groupsr r r �load5 s �r- c C s t t�tj�| ���S )z� >>> ep, = load('[console_scripts]\nfoo=bar') >>> ep.group 'console_scripts' >>> ep.name 'foo' >>> ep.value 'bar' )r% r r r r$ r r r �_@ s r. c C s | S r r )�xr r r �<lambda>N s r0 c C s2 t �d�}t�t| |d�|�}d�dd� |D ��S )Nr r! r c s s* � | ]\}}d |� dt |�� d�V qdS )r r r N)� render_items)r& r r+ r r r r' V s �( zrender.<locals>.<genexpr>)�operator� attrgetterr( �groupby�sortedr )r �by_groupr, r r r �renderQ s r7 c C s d� dd� t| �D ��S )Nr c s s" � | ] }|j � d |j� �V qdS )z = N)r r )r& r r r r r' Z s � z render_items.<locals>.<genexpr>)r r5 r$ r r r r1 Y s r1 ) � functoolsr( r2 �jaraco.functoolsr � jaraco.textr �more_itertoolsr � _importlibr � _itertoolsr �errorsr r r r r r% �singledispatchr- �register�strr. �typer7 r1 r r r r �<module> s* __pycache__/installer.cpython-310.pyc 0000644 00000010076 15030122015 0013443 0 ustar 00 o �h� � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlmZ d dl m Z ddl m Z ddl m Z ddlmZ dd lmZ d d lmZ d d lmZ d d � Zdd� Zd dd�Zdd� Zdd� Zdd� ZG d d � d e�Z dS ) � )� annotationsN)�partial)� Distribution� )�_reqs)� _StrOrIter)� SetuptoolsDeprecationWarning)�Wheel)�log)�DistutilsErrorc C s( t | t�r | �� S t | ttf�sJ �| S )z8Ensure find-links option end-up being a list of strings.)� isinstance�str�split�tuple�list)� find_links� r �G/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/installer.py�_fixup_find_links s r c C s t �� t| � t| |�S )zLFetch an egg needed for building. Use pip/wheel to fetch/build a wheel.)�_DeprecatedInstaller�emit�_warn_wheel_not_available�_fetch_build_egg_no_warn)�dist�reqr r r �fetch_build_egg s r �requiresr �return�list[Distribution]c C s\ dd l }tjdd� t| � |jjt�||j�t t | �dd�}|D ] } |jj | dd� q!|S )Nr � )� stacklevelT)� installer�replace_conflicting)�replace) � pkg_resourcesr r r � working_set�resolver �parse� Requirementr r �add)r r r$ �resolved_distsr r r �_fetch_build_eggs& s �r+ c C s dd l }t|�}| �d�}d|v rtd��dtjvo dtjv}dtjv r'd }n d|v r2|d d }nd }d |v rDt|d d �d d � ng }| jrO|�| j� tj � | � � �}|� � }|� |�D ]} | |v ro|�| �ro| S q`t�� ��} tjd d d ddd| g} |r�| �d� |d ur�| �d|f� |p�g D ] } | �d| f� q�| �|jp�t|�� zt�| � W n tjy� } ztt| ��| �d } ~ ww tt�tj �| d��d �}tj �||� � �}|� |� |� |tj �|d��}|j j ||d�W d � S 1 s�w Y d S )Nr � easy_install� allow_hostszQthe `allow-hosts` option is not supported when using pip to install requirements.� PIP_QUIET� PIP_VERBOSE� PIP_INDEX_URL� index_urlr r z-m�pipz--disable-pip-version-check�wheelz --no-depsz-wz--quietz --index-urlz --find-linksz*.whlzEGG-INFO)�metadata)!r$ � strip_marker�get_option_dictr �os�environr �dependency_links�extend�path�realpath�get_egg_cache_dir� Environment�find_distributions�can_add�tempfile�TemporaryDirectory�sys� executable�append�urlr � subprocess� check_call�CalledProcessErrorr �glob�join�egg_name�install_as_egg� PathMetadatar � from_filename)r r r$ �opts�quietr1 r �eggs_dir� environment�egg_dist�tmpdir�cmd�link�er3 � dist_location� dist_metadatar r r r 6 sp � "� � � �� ��$�r c C s" ddl }|j�t| ��} d| _| S )z� Return a new requirement without the environment marker to avoid calling pip with something like `babel; extra == "i18n"`, which would always be ignored. r N)r$ r( r' r �marker)r r$ r r r r5 y s r5 c C s> dd l }z|�d� W d S |jy | �dtj� Y d S w )Nr r3 z,WARNING: The wheel package is not available.)r$ �get_distribution�DistributionNotFound�announcer �WARN)r r$ r r r r � s �r c @ s e Zd ZdZdZdS )r z9setuptools.installer and fetch_build_eggs are deprecated.z� Requirements should be satisfied by a PEP 517 installer. If you are using pip, you can try `pip install --use-pep517`. N)�__name__� __module__� __qualname__�_SUMMARY�_DETAILSr r r r r � s r )r r r r ) � __future__r rJ r7 rG rC rA � functoolsr r$ r � r r �warningsr r3 r � distutilsr �distutils.errorsr r r r+ r r5 r r r r r r �<module> s* C __pycache__/modified.cpython-310.pyc 0000644 00000000653 15030122015 0013226 0 ustar 00 o �h8 � @ sT zd dl mZmZmZmZ W n ey# ddlmZmZmZmZ Y nw g d�ZdS )� )�newer� newer_group�newer_pairwise�newer_pairwise_group� )r r r r N)�distutils._modifiedr r r r � ImportError�_distutils._modified�__all__� r r �F/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/modified.py�<module> s � __pycache__/errors.cpython-310.pyc 0000644 00000005454 15030122015 0012766 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlmZ ejZejZej Z ej Z ej Z ejZejZejZejZejZejZejZejZejZ ej Z ej Z ej Z!G dd� de�Z"G dd� de�Z#G dd � d e!e$�Z%G d d � d e!e$�Z&d S ) zCsetuptools.errors Provides exceptions used by setuptools modules. � )� annotations)�errorsc @ � e Zd ZdZdS )�InvalidConfigErrorz&Error used for invalid configurations.N��__name__� __module__� __qualname__�__doc__� r r �D/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/errors.pyr ! � r c @ r )�RemovedConfigErrorz?Error used for configurations that were deprecated and removed.Nr r r r r r % r r c @ r )�RemovedCommandErroraO Error used for commands that have been removed in setuptools. Since ``setuptools`` is built on ``distutils``, simply removing a command from ``setuptools`` will make the behavior fall back to ``distutils``; this error is raised if a command exists in ``distutils`` but has been actively removed in ``setuptools``. Nr r r r r r ) r r c @ r )�PackageDiscoveryErrora{ Impossible to perform automatic discovery of packages and/or modules. The current project layout or given discovery options can lead to problems when scanning the project directory. Setuptools might also refuse to complete auto-discovery if an error prone condition is detected (e.g. when a project is organised as a flat-layout but contains multiple directories that can be taken as top-level packages inside a single distribution [*]_). In these situations the users are encouraged to be explicit about which packages to include or to make the discovery parameters more specific. .. [*] Since multi-package distributions are uncommon it is very likely that the developers did not intend for all the directories to be packaged, and are just leaving auxiliary code in the repository top-level, such as maintenance-related scripts. Nr r r r r r 3 r r N)'r � __future__r � distutilsr �_distutils_errors�DistutilsByteCompileError�ByteCompileError�CCompilerError�DistutilsClassError� ClassError� CompileError�DistutilsExecError� ExecError�DistutilsFileError� FileError�DistutilsInternalError� InternalError�LibError� LinkError�DistutilsModuleError� ModuleError�DistutilsOptionError� OptionError�DistutilsPlatformError� PlatformError�PreprocessError�DistutilsSetupError� SetupError�DistutilsTemplateError� TemplateError�UnknownFileError�DistutilsError� BaseErrorr r � RuntimeErrorr r r r r r �<module> s0 __pycache__/sandbox.cpython-310.pyc 0000644 00000037755 15030122015 0013121 0 ustar 00 o �h:: � @ s d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl Z d dl mZ d dlmZmZmZ d dlZd dlmZ d dlmZ erYd dlZn e j�d�rod dlm m m m Z ne j ej Ze Z!erd dl"m#Z# g d �Z$d1d d �Z%ej&d1d d ��Z'ej&dd� �Z(ej&dd� �Z)ej&dd� �Z*G dd� de+�Z,G dd� d�Z-ej&dd� �Z.dd� Z/ej&d d � �Z0ej&d d � �Z1h d �Z2d!d"� Z3d#d$� Z4d%d&� Z5G d'd(� d(�Z6e7ed)�r�ej8gZ9ng Z9G d*d+� d+e6�Z:e�;ej<d,d-� d.�=� D ��Z>G d/d0� d0e�Z?dS )2� )� annotationsN)� TracebackType)� TYPE_CHECKING�Any�ClassVar)� working_set)�DistutilsError�java)�Self)�AbstractSandbox�DirectorySandbox�SandboxViolation� run_setupc C s^ d}t | |�� }|�� }W d � n1 sw Y |du r!|}t|| d�}t|||� dS )z. Python 3 implementation of execfile. �rbN�exec)�open�read�compiler )�filename�globals�locals�mode�stream�script�code� r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/sandbox.py� _execfile* s � r c c sR � t jd d � }| d ur| t jd d �< z |V W |t jd d �< d S |t jd d �< w �N)�sys�argv)�repl�savedr r r � save_argv7 s �"r# c c s< � t jd d � } z | V W | t jd d �< d S | t jd d �< w r )r �path�r" r r r � save_pathB s �"r& c c s8 � t j| dd� tj}| t_z dV W |t_dS |t_w )zL Monkey-patch tempfile.tempdir with replacement, ensuring it exists T)�exist_okN)�os�makedirs�tempfile�tempdir)� replacementr" r r r � override_tempK s �r- c c s8 � t �� }t �| � z |V W t �|� d S t �|� w r )r( �getcwd�chdir)�targetr" r r r �pushd\ s � r1 c @ s e Zd ZdZedd� �ZdS )�UnpickleableExceptionzP An exception representing another Exception that could not be pickled. c C sJ z t �| �t �|�fW S ty$ ddlm} |�||t|��� Y S w )z� Always return a dumped (pickled) type and exc. If exc can't be pickled, wrap it in UnpickleableException first. r )r2 )�pickle�dumps� Exception�setuptools.sandboxr2 �dump�repr)�type�exc�clsr r r r7 k s �zUnpickleableException.dumpN)�__name__� __module__� __qualname__�__doc__� staticmethodr7 r r r r r2 f s r2 c @ s, e Zd ZdZddd�Zdd d�Zdd� ZdS )�ExceptionSaverz] A Context Manager that will save an exception, serialize, and restore it later. �returnr c C s | S r r ��selfr r r � __enter__� s zExceptionSaver.__enter__r9 �type[BaseException] | Noner: �BaseException | None�tb�TracebackType | None�boolc C s |sdS t �||�| _|| _dS )NFT)r2 r7 �_saved�_tb)rD r9 r: rH r r r �__exit__� s zExceptionSaver.__exit__c C s. dt | �vrdS ttj| j�\}}|�| j��)z"restore and re-raise any exceptionrK N)�vars�mapr3 �loadsrK �with_tracebackrL )rD �_typer: r r r �resume� s zExceptionSaver.resumeN)rB r )r9 rF r: rG rH rI rB rJ )r< r= r> r? rE rM rS r r r r rA z s rA c # sl � t j�� � t� � } � V W d � n1 sw Y t j�� � � fdd�t jD �}t|� | �� dS )z� Context in which imported modules are saved. Translates exceptions internal to the context into the equivalent exception outside the context. Nc 3 s& � | ]}|� vr|� d �s|V qdS )z encodings.N�� startswith)�.0�mod_namer% r r � <genexpr>� s � ���z save_modules.<locals>.<genexpr>)r �modules�copyrA �update�_clear_modulesrS )� saved_exc� del_modulesr r% r � save_modules� s � � � r_ c C s t | �D ]}tj|= qd S r )�listr rY )� module_namesrW r r r r\ � s �r\ c c s. � t �� } z | V W t �| � d S t �| � w r )� pkg_resources� __getstate__� __setstate__r% r r r �save_pkg_resources_state� s �re c c s" � t j�| d�}t� �| t� �` t� �M t� t� �7 t|��# t | �� t d� d V W d � n1 s6w Y W d � n1 sEw Y W d � n1 sTw Y W d � n1 scw Y W d � n1 srw Y W d � d S W d � d S 1 s�w Y d S )N�temp� setuptools) r( r$ �joinre r_ r& �hide_setuptoolsr# r- r1 � __import__)� setup_dir�temp_dirr r r � setup_context� s. � �� �� �� �� ��"�rm > �Cython� distutilsrg rb �_distutils_hackc C s | � dd�d }|tv S )aH >>> _needs_hiding('setuptools') True >>> _needs_hiding('pkg_resources') True >>> _needs_hiding('setuptools_plugin') False >>> _needs_hiding('setuptools.__init__') True >>> _needs_hiding('distutils') True >>> _needs_hiding('os') False >>> _needs_hiding('Cython') True �.� r )�split�_MODULES_TO_HIDE)rW � base_moduler r r � _needs_hiding� s rv c C s6 t j�dd�} | dur| �� ttt j�}t|� dS )a% Remove references to setuptools' modules from sys.modules to allow the invocation to import the most appropriate setuptools. This technique is necessary to avoid issues such as #315 where setuptools upgrading itself would fail to find a function declared in the metadata. rp N)r rY �get� _remove_shim�filterrv r\ )rp rY r r r ri � s ri c C s t j�t j�| ��}t|��m z@| gt|� tjdd�< tj�d|� t � � t j � dd� � t |�� t| dd�}t| |� W d � n1 sIw Y W n tyj } z|jr`|jd r`� W Y d}~n d}~ww W d � dS W d � dS 1 s~w Y dS )z8Run a distutils setup script, sandboxed in its directoryNr c S s | � � S r )�activate)�distr r r �<lambda> s zrun_setup.<locals>.<lambda>�__main__)�__file__r< )r( r$ �abspath�dirnamerm r` r r �insertr �__init__� callbacks�appendr �dictr � SystemExit�args)� setup_scriptr� rk �ns�vr r r r s* �������" r c @ s0 e Zd ZdZdZd0dd�Zdd� Zd0d d �Zd1dd�Zdd� Z d2dd�Z dD ]Z e e e �r4e e �e� e < q&d3d2dd �Zed e�Zd D ]Z e e e �rPee �e� e < qBd2d d �Zd!D ]Z e e e �rfee �e� e < qXd2d"d#�Zd$D ]Z e e e �r|ee �e� e < qnd%d&� Zd'd(� Zd)d*� Zd+d,� Zer�d4d.d/�ZdS dS )5r zDWrap 'os' module and 'open()' builtin for virtualizing setup scriptsFrB �Nonec s � fdd�t t�D �� _d S )Nc s$ g | ]}|� d �st� |�r|�qS )�_)rU �hasattr)rV �namerC r r � <listcomp> s ���z,AbstractSandbox.__init__.<locals>.<listcomp>)�dir�_os�_attrsrC r rC r r� s �zAbstractSandbox.__init__c C s" | j D ] }tt|t||�� qd S r )r� �setattrr( �getattr)rD �sourcer� r r r �_copy! s �zAbstractSandbox._copyc C s | � | � | jt_d| _d S )NT)r� �_open�builtinsr �_activerC r r r rE % s zAbstractSandbox.__enter__�exc_typerF � exc_valuerG � tracebackrI c C s d| _ tt_| �t� d S �NF)r� r� r� r r� r� )rD r� r� r� r r r rM * s zAbstractSandbox.__exit__c C s. | � |� W d � S 1 sw Y dS )z Run 'func' under os sandboxingNr )rD �funcr r r �run4 s $�zAbstractSandbox.runr� �strc � t t� ��� �fdd�}|S )Nc s> | j r| j� ||g|�R i |��\}}�||g|�R i |��S r )r� � _remap_pair)rD �src�dstr� �kw�r� �originalr r �wrap< s z3AbstractSandbox._mk_dual_path_wrapper.<locals>.wrap�r� r� �r� r� r r� r �_mk_dual_path_wrapper9 s z%AbstractSandbox._mk_dual_path_wrapper)�rename�link�symlinkNc s �pt t� ��� �fdd�}|S )Nc s6 | j r| j� |g|�R i |��}�|g|�R i |��S r )r� � _remap_input�rD r$ r� r� r� r r r� J s z5AbstractSandbox._mk_single_path_wrapper.<locals>.wrapr� )r� r� r� r r� r �_mk_single_path_wrapperG s z'AbstractSandbox._mk_single_path_wrapperr )�stat�listdirr/ r �chmod�chown�mkdir�remove�unlink�rmdir�utime�lchown�chroot�lstat� startfile�mkfifo�mknod�pathconf�accessc r� )Nc sT | j r | j� |g|�R i |��}| �� �|g|�R i |���S �|g|�R i |��S r )r� r� � _remap_outputr� r� r r r� m s z4AbstractSandbox._mk_single_with_return.<locals>.wrapr� r� r r� r �_mk_single_with_returnj � z&AbstractSandbox._mk_single_with_return)�readlink�tempnamc r� )Nc s$ �|i |��}| j r| �� |�S |S r )r� r� )rD r� r� �retvalr� r r r� | s z'AbstractSandbox._mk_query.<locals>.wrapr� r� r r� r � _mk_queryy r� zAbstractSandbox._mk_query)r. �tmpnamc C s |S )z=Called to remap or validate any path, whether input or outputr )rD r$ r r r �_validate_path� s z AbstractSandbox._validate_pathc O � | � |�S �zCalled for path inputs�r� �rD � operationr$ r� r� r r r r� � � z AbstractSandbox._remap_inputc C r� )zCalled for path outputsr� )rD r� r$ r r r r� � r� z AbstractSandbox._remap_outputc O s< | j |d |g|�R i |��| j |d |g|�R i |��fS )�?Called for path pairs like rename, link, and symlink operationsz-fromz-to)r� �rD r� r� r� r� r� r r r r� � s �zAbstractSandbox._remap_pairr c C s d S r r )rD r� r r r �__getattribute__� s z AbstractSandbox.__getattribute__�rB r� )r� rF r� rG r� rI )r� r� r )r� r� rB r )r< r= r> r? r� r� r� rE rM r� r� �_AbstractSandbox__namer� r� r r� r� r� r� r� r� r� r� r r� r r r r r sH � � � ��r �devnullc @ s� e Zd ZU dZe�g d��Zded< g Zded< e fd d d �Z d d � Z d!dd�Z d dd�Z dd� Zdd� Zdd� Zdd� Zd"d#d d �Zd S )$r z<Restrict operations to a single subdirectory - pseudo-chroot) r r� r� r� r� r� r� r� r� r� r� r� r� zClassVar[dict[str, None]]� write_opszlist[str | re.Pattern]�_exception_patternsrB r� c C sF t j�t j�|��| _t j�| jd�| _dd� |D �| _t� | � d S )N� c S s g | ] }t j�t j�|���qS r )r( r$ �normcase�realpath)rV r$ r r r r� � s �z-DirectorySandbox.__init__.<locals>.<listcomp>) r( r$ r� r� �_sandboxrh �_prefix� _exceptionsr r� )rD �sandbox� exceptionsr r r r� � s �zDirectorySandbox.__init__c O s ddl m} ||||��)Nr )r )r6 r )rD r� r� r� r r r r � _violation� s zDirectorySandbox._violation�rc O sF |dvr| � |�s| jd||g|�R i |�� t||g|�R i |��S )N)r� �rtr �rU�Ur )�_okr� r� )rD r$ r r� r� r r r r� � s zDirectorySandbox._openc C s | � d� d S )Nr� )r� rC r r r r� � s zDirectorySandbox.tmpnamc C sR | j }z!d| _ tj�tj�|��}| �|�p || jkp |�| j�W || _ S || _ w r� ) r� r( r$ r� r� � _exemptedr� rU r� )rD r$ �activer� r r r r� � s � �zDirectorySandbox._okc s< � fdd�| j D �}� fdd�| jD �}t�||�}t|�S )Nc 3 s � | ]}� � |�V qd S r rT )rV � exception��filepathr r rX � s � �z-DirectorySandbox._exempted.<locals>.<genexpr>c 3 s � | ] }t �|� �V qd S r )�re�match)rV �patternr� r r rX � s � �)r� r� � itertools�chain�any)rD r� � start_matches�pattern_matches� candidatesr r� r r� � s � � zDirectorySandbox._exemptedc O s: || j v r| �|�s| j|tj�|�g|�R i |�� |S r� )r� r� r� r( r$ r� r� r r r r� � s "z DirectorySandbox._remap_inputc O s8 | � |�r | � |�s| j|||g|�R i |�� ||fS )r� )r� r� r� r r r r� � s z DirectorySandbox._remap_pair� r �intc O sL |t @ r| �|�s| jd|||g|�R i |�� tj|||g|�R i |��S )z Called for low-level os.open()zos.open)� WRITE_FLAGSr� r� r� r )rD �file�flagsr r� r� r r r r � s zDirectorySandbox.openNr� )r� )r� )r r� rB r� )r< r= r> r? r� �fromkeysr� �__annotations__r� � _EXCEPTIONSr� r� r� r� r� r� r� r� r r r r r r � s r c C s g | ]}t t|d ��qS )r r� )rV �ar r r r� � s ��r� z4O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARYc @ s( e Zd ZdZe�d��� Zddd�ZdS ) r zEA setup script attempted to modify the filesystem outside the sandboxa SandboxViolation: {cmd}{args!r} {kwargs} The package setup script has attempted to modify files on your system that are not within the EasyInstall build area, and has been aborted. This package cannot be safely installed by EasyInstall, and may not support alternate installation locations even if you run its setup script by hand. Please inform the package's author and the EasyInstall maintainers to find out if a fix or workaround is available. rB r� c C s | j \}}}| jjdi t� ��S )Nr )r� �tmpl�formatr )rD �cmdr� �kwargsr r r �__str__ s zSandboxViolation.__str__N)rB r� ) r< r= r> r? �textwrap�dedent�lstripr� r r r r r r s � �r r )@� __future__r r� � contextlib� functoolsr� �operatorr( r3 r� r r* r �typesr �typingr r r rb r �distutils.errorsr r� �platformrU �$org.python.modules.posix.PosixModule�pythonrY �posix� PosixModuler� r r� �typing_extensionsr �__all__r �contextmanagerr# r& r- r1 r5 r2 rA r_ r\ re rm rt rv ri r r r� r� r� r �reduce�or_rs r� r r r r r �<module> sz # U�� __pycache__/discovery.cpython-310.pyc 0000644 00000051302 15030122015 0013452 0 ustar 00 o �h S � @ sp d Z ddlmZ ddlZddlZddlmZmZmZ ddl m Z ddl m Z ddl m Z ddlmZmZ ddlZd d lmZ dd lmZ dd lmZ erRdd lmZ ejj Z d<dd�Z G dd� d�Z G dd� d�Z G dd� de �Z!G dd� de!�Z"G d d � d e �Z#G d d � d e"�Z$G d d!� d!e#�Z%d=d&d'�Z&G d(d)� d)�Z'd>d+d,�Z(d>d-d.�Z)d?d3d4�Z*d@d6d7�Z+dAd:d;�Z,dS )Bu_ Automatic discovery of Python modules and packages (for inclusion in the distribution) and other config values. For the purposes of this module, the following nomenclature is used: - "src-layout": a directory representing a Python project that contains a "src" folder. Everything under the "src" folder is meant to be included in the distribution when packaging the project. Example:: . ├── tox.ini ├── pyproject.toml └── src/ └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "flat-layout": a Python project that does not use "src-layout" but instead have a directory under the project root for each package:: . ├── tox.ini ├── pyproject.toml └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "single-module": a project that contains a single Python script direct under the project root (no directory used):: . ├── tox.ini ├── pyproject.toml └── mymodule.py � )� annotationsN)�Iterable�Iterator�Mapping�� fnmatchcase)�glob)�Path)� TYPE_CHECKING�ClassVar� )�StrPath)�log)� convert_path)� Distribution�pathr �return�boolc C s t j�| ��� S �N)�osr �basename� isidentifier)r � r �G/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/discovery.py� _valid_name? s r c @ s. e Zd ZdZddd�Zdd d �Zdd d �ZdS )�_Filterz� Given a list of patterns, create a callable that will be true only if the input matches at least one of the patterns. �patterns�strr �Nonec G s t �|�| _d S r )�dict�fromkeys� _patterns)�selfr r r r �__init__J s z_Filter.__init__�itemr c s t � fdd�| jD ��S )Nc 3 s � | ]}t � |�V qd S r r )�.0�pat�r$ r r � <genexpr>N s � z#_Filter.__call__.<locals>.<genexpr>)�anyr! �r" r$ r r' r �__call__M s z_Filter.__call__c C s || j v S r )r! r* r r r � __contains__P s z_Filter.__contains__N)r r r r )r$ r r r )�__name__� __module__� __qualname__�__doc__r# r+ r, r r r r r D s r c @ sN e Zd ZU dZdZded< dZded< e dddd��Zeddd��Z dS )�_Finderz@Base class that exposes functionality for module/package findersr zClassVar[tuple[str, ...]]�ALWAYS_EXCLUDE�DEFAULT_EXCLUDE�.��*�wherer �exclude� Iterable[str]�includer � list[str]c C s8 |p| j }t| �tt|��tg | j�|�R � t|� ��S )aF Return a list of all Python items (packages or modules, depending on the finder implementation) found within directory 'where'. 'where' is the root directory which will be searched. It should be supplied as a "cross-platform" (i.e. URL-style) path; it will be converted to the appropriate local path syntax. 'exclude' is a sequence of names to exclude; '*' can be used as a wildcard in the names. When finding packages, 'foo.*' will exclude all subpackages of 'foo' (but not 'foo' itself). 'include' is a sequence of names to include. If it's specified, only the named items will be included. If it's not specified, all found items will be included. 'include' can contain shell style wildcard patterns just like 'exclude'. )r3 �list� _find_iterr r r r2 ��clsr7 r8 r: r r r �findZ s ��z _Finder.findr � Iterator[str]c C s t �r )�NotImplementedErrorr> r r r r= } s z_Finder._find_iterN)r4 r r5 )r7 r r8 r9 r: r9 r r; �r7 r r8 r r: r r rA ) r- r. r/ r0 r2 �__annotations__r3 � classmethodr@ r= r r r r r1 T s �"r1 c @ s0 e Zd ZdZdZedd d ��Zeddd��ZdS )� PackageFinderzI Generate a list of all Python packages found within a directory )�ez_setupz *__pycache__r7 r r8 r r: r rA c c s� � t jt|�dd�D ]V\}}}|dd� }g |dd�< |D ]B}t j�||�} t j�| |�} | �t jjd�} d|v s?| �| | �s@q || �rK|| �sK| V | � d�|v sY| � d�|v rZq |� |� q q dS )zy All the packages found in 'where' that pass the 'include' filter, but not the 'exclude' filter. T)� followlinksNr4 r6 �.*) r �walkr r �join�relpath�replace�sep�_looks_like_package�append) r? r7 r8 r: �root�dirs�files�all_dirs�dir� full_path�rel_path�packager r r r= � s" � ��zPackageFinder._find_iterr � _package_namer r c C s t j�t j�| d��S )z%Does a directory look like a package?� __init__.py)r r �isfilerK )r rY r r r rO � s z!PackageFinder._looks_like_packageNrC )r r rY r r r ) r- r. r/ r0 r2 rE r= � staticmethodrO r r r r rF � s !rF c @ s e Zd Zed dd��Zd S ) �PEP420PackageFinder�_pathr rY r r r c C s dS )NTr )r^ rY r r r rO � s z'PEP420PackageFinder._looks_like_packageN)r^ r rY r r r )r- r. r/ r\ rO r r r r r] � s r] c @ s& e Zd ZdZed d d ��Zee�Zd S ) � ModuleFinderzYFind isolated Python modules. This function will **not** recurse subdirectories. r7 r r8 r r: r rA c c sX � t tj�|d��D ] }tj�tj�|��\}}| �|�s q ||�r)||�s)|V q d S )Nz*.py)r r r rK �splitextr �_looks_like_module)r? r7 r8 r: �file�module�_extr r r r= � s � ��zModuleFinder._find_iterNrC ) r- r. r/ r0 rE r= r\ r ra r r r r r_ � s r_ c @ s6 e Zd ZdZeedd� eD ���Z ed d d ��Zd S )�FlatLayoutPackageFinder)#�ci�bin�debian�doc�docs� documentation�manpages�news� newsfragments� changelog�test�tests� unit_test� unit_tests�example�examples�scripts�tools�util�utils�python�build�dist�venv�env� requirements�tasks�fabfile� site_scons� benchmark� benchmarks�exercise� exercises�htmlcov�[._]*c c s � | ] }||� d �fV qdS )rI Nr )r% �pr r r r( � s � z!FlatLayoutPackageFinder.<genexpr>r^ r � package_namer r r c C sB |� d�}|d �� p|d �d�}|o tdd� |dd � D ��S )Nr4 r �-stubsc s s � | ]}|� � V qd S r )r )r% �namer r r r( s � z>FlatLayoutPackageFinder._looks_like_package.<locals>.<genexpr>r )�splitr �endswith�all)r^ r� �names�root_pkg_is_validr r r rO � s z+FlatLayoutPackageFinder._looks_like_packageN)r^ r r� r r r ) r- r. r/ �_EXCLUDE�tuple� chain_iterr3 r\ rO r r r r re � s )re c @ s e Zd ZdZdS )�FlatLayoutModuleFinder)�setup�conftestrp rq rt ru r{ �toxfile�noxfile�pavement�dodor� r� z[Ss][Cc]onstruct� conanfile�manager� r� r� r� r� N)r- r. r/ r3 r r r r r� s r� �root_pkgr �pkg_dirr; c s" t �|�}� g� fdd�|D � S )Nc s g | ] }d � � |f��qS )r4 )rK �r% �n�r� r r � <listcomp>' s z)_find_packages_within.<locals>.<listcomp>)r] r@ )r� r� �nestedr r� r �_find_packages_within% s r� c @ s� e Zd ZdZd6dd�Zdd � Zd d � Zed7d d��Zed8dd��Z d9d:dd�Z d;dd�Z d;d d �Z d<d d �Z d<d d!�Zd<d"d#�Zd<d$d%�Zd<d&d'�Zd=d,d-�Zd>d.d/�Zd?d1d2�Zd?d3d4�Zd5S )@�ConfigDiscoveryz�Fill-in metadata and options that can be automatically derived (from other metadata/options, the file system or conventions) � distributionr r r c C s || _ d| _d| _d| _d S )NF)r| �_called� _disabled�_skip_ext_modules)r" r� r r r r# / s zConfigDiscovery.__init__c C � d| _ dS )z+Internal API to disable automatic discoveryTN)r� �r" r r r �_disable5 s zConfigDiscovery._disablec C r� )a� Internal API to disregard ext_modules. Normally auto-discovery would not be triggered if ``ext_modules`` are set (this is done for backward compatibility with existing packages relying on ``setup.py`` or ``setup.cfg``). However, ``setuptools`` can call this function to ignore given ``ext_modules`` and proceed with the auto-discovery if ``packages`` and ``py_modules`` are not given (e.g. when using pyproject.toml metadata). TN)r� r� r r r �_ignore_ext_modules9 s z#ConfigDiscovery._ignore_ext_modulesr c C s | j jptjS r )r| �src_rootr �curdirr� r r r � _root_dirE s zConfigDiscovery._root_dir�dict[str, str]c C s | j jd u ri S | j jS r )r| � package_dirr� r r r � _package_dirJ s z ConfigDiscovery._package_dirFT�forcer r� �ignore_ext_modulesc C s8 |du r | j s | jr dS | �|� |r| �� d| _ dS )a� Automatically discover missing configuration fields and modifies the given ``distribution`` object in-place. Note that by default this will only have an effect the first time the ``ConfigDiscovery`` object is called. To repeatedly invoke automatic discovery (e.g. when the project directory changes), please use ``force=True`` (or create a new ``ConfigDiscovery`` instance). FNT)r� r� �_analyse_package_layout� analyse_name)r" r� r� r� r r r r+ P s zConfigDiscovery.__call__c C sL |p| j }| jjdu p | }| jjdup%| jjdup%|p%t| jd�o%| jjS )zF``True`` if the user has specified some form of package/module listingN� configuration)r� r| � ext_modules�packages� py_modules�hasattrr� )r" r� r� r r r �_explicitly_specifiedg s �� �z%ConfigDiscovery._explicitly_specifiedc C s0 | � |�rdS t�d� | �� p| �� p| �� S )NTzLNo `packages` or `py_modules` configuration, performing automatic discovery.)r� r �debug�_analyse_explicit_layout�_analyse_src_layout�_analyse_flat_layout)r" r� r r r r� t s ���z'ConfigDiscovery._analyse_package_layoutc sr | j �� }|�dd� | j� |sdS t�d|� �� t� fdd�|�� D ��}t|�| j _ t�d| j j � �� dS ) zAThe user can explicitly give a package layout via ``package_dir``� NFz(`explicit-layout` detected -- analysing c 3 s( � | ]\}}t |tj�� |��V qd S r )r� r r rK )r% �pkg� parent_dir��root_dirr r r( � s � � �z;ConfigDiscovery._analyse_explicit_layout.<locals>.<genexpr>�discovered packages -- T) r� �copy�popr� r r� r� �itemsr< r| r� )r" r� �pkgsr r� r r� � s � z(ConfigDiscovery._analyse_explicit_layoutc C s� | j }tj�| j|�dd��}tj�|�sdS t�d|� �� |� dtj� |�� || j _ t �|�| j _t�|�| j _t�d| j j� �� t�d| j j� �� dS )a� Try to find all packages or modules under the ``src`` directory (or anything pointed by ``package_dir[""]``). The "src-layout" is relatively safe for automatic discovery. We assume that everything within is meant to be included in the distribution. If ``package_dir[""]`` is not given, but the ``src`` directory exists, this function will set ``package_dir[""] = "src"``. r� �srcFz#`src-layout` detected -- analysing r� �discovered py_modules -- T)r� r r rK r� �get�isdirr r� � setdefaultr r| r� r] r@ r� r_ r� )r" r� �src_dirr r r r� � s z#ConfigDiscovery._analyse_src_layoutc C s" t �d| j� �� | �� p| �� S )a� Try to find all packages and modules under the project root. Since the ``flat-layout`` is more dangerous in terms of accidentally including extra files/directories, this function is more conservative and will raise an error if multiple packages or modules are found. This assumes that multi-package dists are uncommon and refuse to support that use case in order to be able to prevent unintended errors. z$`flat-layout` detected -- analysing )r r� r� �_analyse_flat_packages�_analyse_flat_modulesr� r r r r� � s z$ConfigDiscovery._analyse_flat_layoutc C sH t �| j�| j_tt| jj��}t�d| jj� �� | � |d� t |�S )Nr� r� ) re r@ r� r| r� �remove_nested_packages� remove_stubsr r� � _ensure_no_accidental_inclusionr )r" � top_levelr r r r� � s z&ConfigDiscovery._analyse_flat_packagesc C s@ t �| j�| j_t�d| jj� �� | �| jjd� t| jj�S )Nr� �modules) r� r@ r� r| r� r r� r� r r� r r r r� � s z%ConfigDiscovery._analyse_flat_modules�detectedr; �kindr c C sL t |�dkr$ddlm} ddlm} d|� d|� d|� d�}|||���d S ) Nr r )�cleandoc)�PackageDiscoveryErrorzMultiple top-level z discovered in a flat-layout: z�. To avoid accidental inclusion of unwanted files or directories, setuptools will not proceed with this build. If you are trying to create a single distribution with multiple a� on purpose, you should not rely on automatic discovery. Instead, consider the following options: 1. set up custom discovery (`find` directive with `include` or `exclude`) 2. use a `src-layout` 3. explicitly set `py_modules` or `packages` with a list of names To find more information, look for "package discovery" on setuptools docs. )�len�inspectr� �setuptools.errorsr� )r" r� r� r� r� �msgr r r r� � s � �z/ConfigDiscovery._ensure_no_accidental_inclusionc C sF | j jjs | j jr dS t�d� | �� p| �� }|r!|| j j_dS dS )z�The packages/modules are the essential contribution of the author. Therefore the name of the distribution can be derived from them. Nz7No `name` configuration, performing automatic discovery)r| �metadatar� r r� �#_find_name_single_package_or_module�_find_name_from_packages)r" r� r r r r� � s ��z ConfigDiscovery.analyse_name� str | Nonec C sP dD ]#}t | j|d�p g }|r%t|�dkr%t�d|d � �� |d S qdS )z Exactly one module or package)r� r� Nr z&Single module/package detected, name: r )�getattrr| r� r r� )r" �fieldr� r r r r� � s �z3ConfigDiscovery._find_name_single_package_or_modulec C s` | j jsdS tt| j jtd��}| j jpi }t||| j�}|r)t� d|� �� |S t� d� dS )z<Try to find the root package that is not a PEP 420 namespaceN��keyz&Common parent package detected, name: z7No parent package detected, impossible to derive `name`) r| r� r� �sortedr� r� �find_parent_packager� r r� �warn)r" r� r� � parent_pkgr r r r� � s z(ConfigDiscovery._find_name_from_packagesN)r� r r r )r r )r r� )FTF)r� r r� r r� r )r� r r r )r r )r� r; r� r )r r )r r� )r- r. r/ r0 r# r� r� �propertyr� r� r+ r� r� r� r� r� r� r� r� r� r� r� r r r r r� * s, � r� r� c sb t | td�}|dd� }t|�}tt|��D ]\}� t� fdd�|D ��r.|�|| d � q|S )z�Remove nested packages from a list of packages. >>> remove_nested_packages(["a", "a.b1", "a.b2", "a.b1.c1"]) ['a'] >>> remove_nested_packages(["a", "b", "c.d", "c.d.e.f", "g.h", "a.a1"]) ['a', 'b', 'c.d', 'g.h'] r� Nc 3 s � | ] }� � |� d ��V qdS �r4 N�� startswith)r% �other�r� r r r( � � z)remove_nested_packages.<locals>.<genexpr>r )r� r� � enumerate�reversedr) r� )r� r� r� �size�ir r� r r� s �r� c C s dd� | D �S )z�Remove type stubs (:pep:`561`) from a list of packages. >>> remove_stubs(["a", "a.b", "a-stubs", "a-stubs.b.c", "b", "c-stubs"]) ['a', 'a.b', 'b'] c S s$ g | ]}|� d �d �d�s|�qS )r4 r r� )r� r� �r% r� r r r r� & s $ z remove_stubs.<locals>.<listcomp>r )r� r r r r� s r� r� �Mapping[str, str]r� r� c s� t | td�} g }t| �D ] \}� t� fdd�| |d d� D ��s# n|�� � q |D ]� t� ||�}tj�|d�}tj� |�rD� S q+dS )z0Find the parent package that is not a namespace.r� c 3 s � | ] }|� � � d ��V qdS r� r� r� r� r r r( 0 r� z&find_parent_package.<locals>.<genexpr>r NrZ ) r� r� r� r� rP �find_package_pathr r rK r[ )r� r� r� �common_ancestorsr� �pkg_path�initr r� r r� ) s " �r� r� c C s� | � d�}tt|�dd�D ]$}d�|d|� �}||v r1|| }tjj||g||d� �R � S q |�d�p8d}tjj|g|� d��|�R � S )a� Given a package name, return the path where it should be found on disk, considering the ``package_dir`` option. >>> path = find_package_path("my.pkg", {"": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/my/pkg' >>> path = find_package_path("my.pkg", {"my": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/pkg' >>> path = find_package_path("my.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested' >>> path = find_package_path("other.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './other/pkg' r4 r ���Nr� �/)r� �ranger� rK r r r� )r� r� r� �partsr� � partial_name�parentr r r r� A s "� r� � package_pathr� c s$ t | �}t|�j� � fdd�|D �S )Nc s& i | ]}|d � g � �|�d����qS )r r4 )rK r� r� ��prefixr r � <dictcomp>f s & z)construct_package_dir.<locals>.<dictcomp>)r� r r )r� r � parent_pkgsr r r �construct_package_dirc s r )r r r r )r� r r� r r r; )r� r; r r; )r� r; r� r� r� r r r� )r� r r� r� r� r r r )r� r; r r r r� )-r0 � __future__r � itertoolsr �collections.abcr r r �fnmatchr r �pathlibr �typingr r �_distutils_hack.override�_distutils_hackr^ r � distutilsr �distutils.utilr � setuptoolsr �chain� from_iterabler� r r r1 rF r] r_ re r� r� r� r� r� r� r� r r r r r �<module> s@ ' 0/5 e " __pycache__/_importlib.cpython-310.pyc 0000644 00000000524 15030122015 0013603 0 ustar 00 o �h� � @ s8 d dl Z e jdk rd dlZnd dlmZ d dlmZ dS )� N)� � )�sys� version_info�importlib_metadata�metadata�importlib.metadata�importlib.resources� resources� r r �H/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_importlib.py�<module> s __pycache__/build_meta.cpython-310.pyc 0000644 00000043441 15030122015 0013555 0 ustar 00 o �h N � @ s� U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z mZmZ ddlmZ ddlmZmZ ddlZddlmZ dd lmZmZ dd lm Z dd l m Z ddl Z dd l m Z erudd l!m"Z" g d�Z#G dd� de$�Z%G dd� dej&j'�Z'ej(dd� �Z)dd� Z*d+dd �Z+d d � Z,ej(d d � �Z-eee.ee.e/e. df f df Z0d!e1d"< G d#d$� d$�Z2G d%d&� d&e2�Z3G d'd(� d(e3�Z4G d)d*� d*e �Z5e3� Z6e6j7Z7e6j8Z8e6j9Z9e6j:Z:e6j;Z;e6j<Z<e6j=Z=e6j>Z>e4� Z?dS ),a' A PEP 517 interface to setuptools Previously, when a user or a command line tool (let's call it a "frontend") needed to make a request of setuptools to take a certain action, for example, generating a list of installation requirements, the frontend would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line. PEP 517 defines a different method of interfacing with setuptools. Rather than calling "setup.py" directly, the frontend should: 1. Set the current directory to the directory with a setup.py file 2. Import this module into a safe python interpreter (one in which setuptools can potentially set global variables or crash hard). 3. Call one of the functions defined in PEP 517. What each function does is defined in PEP 517. However, here is a "casual" definition of the functions (this definition should not be relied on for bug reports or API stability): - `build_wheel`: build a wheel in the folder and return the basename - `get_requires_for_build_wheel`: get the `setup_requires` to build - `prepare_metadata_for_build_wheel`: get the `install_requires` - `build_sdist`: build an sdist in the folder and return the basename - `get_requires_for_build_sdist`: get the `setup_requires` to build Again, this is not a formal definition! Just a "taste" of the module. � )� annotationsN)�Iterable�Iterator�Mapping)�Path)� TYPE_CHECKING�Union� )�errors)�StrPath� same_path)� parse_strings)� SetuptoolsDeprecationWarning)� strtobool)� TypeAlias) � get_requires_for_build_sdist� get_requires_for_build_wheel� prepare_metadata_for_build_wheel� build_wheel� build_sdist� get_requires_for_build_editable�#prepare_metadata_for_build_editable�build_editable� __legacy__�SetupRequirementsErrorc @ s e Zd Zddd�ZdS )r �return�Nonec C s || _ d S �N)� specifiers)�selfr � r �H/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/build_meta.py�__init__H � z SetupRequirementsError.__init__N)r r )�__name__� __module__� __qualname__r" r r r r! r G s r c @ s& e Zd Zdd� Zeejdd� ��ZdS )� Distributionc C s t t|��}t|��r )�listr r )r r �specifier_listr r r! �fetch_build_eggsM s z Distribution.fetch_build_eggsc c s2 � t jj}| t j_z dV W |t j_dS |t j_w )zw Replace distutils.dist.Distribution with this class for the duration of this context. N)� distutils�corer' )�cls�origr r r! �patchR s �zDistribution.patchN)r$ r% r& r* � classmethod� contextlib�contextmanagerr/ r r r r! r' L s r' c c s. � t j} dd� t _z dV W | t _dS | t _w )a Temporarily disable installing setup_requires Under PEP 517, the backend reports build dependencies to the frontend, and the frontend is responsible for ensuring they're installed. So setuptools (acting as a backend) should not try to install them. c S s d S r r )�attrsr r r! �<lambda>k s z+no_install_setup_requires.<locals>.<lambda>N)� setuptools�_install_setup_requires)r. r r r! �no_install_setup_requiresb s � r7 c s � fdd�t �� �D �S )Nc s& g | ]}t j�t j�� |��r|�qS r )�os�path�isdir�join)�.0�name��a_dirr r! � <listcomp>s s ��z1_get_immediate_subdirectories.<locals>.<listcomp>)r8 �listdirr> r r> r! � _get_immediate_subdirectoriesr s �rB � directoryr � extension�str | tuple[str, ...]c s> � fdd�t �| �D �}z|\}W |S ty td�d �w )Nc 3 s � | ] }|� � �r|V qd S r ��endswith�r< �f�rD r r! � <genexpr>y s � z'_file_with_extension.<locals>.<genexpr>z[No distribution was found. Ensure that `setup.py` is not empty and that it calls `setup()`.)r8 rA � ValueError)rC rD �matching�filer rJ r! �_file_with_extensionx s ����rO c C s t j�| �s t�d�S t�| �S )Nz%from setuptools import setup; setup())r8 r9 �exists�io�StringIO�tokenize�open�� setup_scriptr r r! �_open_setup_script� s rW c c sB � t �� � t �dd� d V W d � d S 1 sw Y d S )N�ignorez setup.py install is deprecated)�warnings�catch_warnings�filterwarningsr r r r! �suppress_known_deprecation� s � "�r\ r �_ConfigSettingsc @ sB e Zd ZdZddd �Zdd d �Zdd d�Zddd�Zddd�ZdS )�_ConfigSettingsTranslatorz�Translate ``config_settings`` into distutils-style command arguments. Only a limited number of options is currently supported. �key�str�config_settingsr] r � list[str]c C s. |pi }|� |�p g }t|t�rt�|�S |S )aA Get the value of a specific key in ``config_settings`` as a list of strings. >>> fn = _ConfigSettingsTranslator()._get_config >>> fn("--global-option", None) [] >>> fn("--global-option", {}) [] >>> fn("--global-option", {'--global-option': 'foo'}) ['foo'] >>> fn("--global-option", {'--global-option': ['foo']}) ['foo'] >>> fn("--global-option", {'--global-option': 'foo'}) ['foo'] >>> fn("--global-option", {'--global-option': 'foo bar'}) ['foo', 'bar'] )�get� isinstancer` �shlex�split)r r_ ra �cfg�optsr r r! � _get_config� s z%_ConfigSettingsTranslator._get_config� Iterator[str]c c s� � |pi }h d�}d|v sd|v r*t |�d�p |�d�p d�}|�� |v r'dndV d|v s2d|v rKt |�d�p>|�d�p>d�}|�� |v rHdndV | �d |�E d H d S ) a� Let the user specify ``verbose`` or ``quiet`` + escape hatch via ``--global-option``. Note: ``-v``, ``-vv``, ``-vvv`` have similar effects in setuptools, so we just have to cover the basic scenario ``-v``. >>> fn = _ConfigSettingsTranslator()._global_args >>> list(fn(None)) [] >>> list(fn({"verbose": "False"})) ['-q'] >>> list(fn({"verbose": "1"})) ['-v'] >>> list(fn({"--verbose": None})) ['-v'] >>> list(fn({"verbose": "true", "--global-option": "-q --no-user-cfg"})) ['-v', '-q', '--no-user-cfg'] >>> list(fn({"--quiet": None})) ['-q'] > �0�no�off�false�verbosez --verbose�1z-qz-v�quietz--quietz--global-optionN)r` rc �lowerri )r ra rg �falsey�levelr r r! � _global_args� s � z&_ConfigSettingsTranslator._global_argsc c sZ � |pi }d|v rt t|d pd��}|rdndV d|v r+dt|d �gE dH dS dS )a� The ``dist_info`` command accepts ``tag-date`` and ``tag-build``. .. warning:: We cannot use this yet as it requires the ``sdist`` and ``bdist_wheel`` commands run in ``build_sdist`` and ``build_wheel`` to reuse the egg-info directory created in ``prepare_metadata_for_build_wheel``. >>> fn = _ConfigSettingsTranslator()._ConfigSettingsTranslator__dist_info_args >>> list(fn(None)) [] >>> list(fn({"tag-date": "False"})) ['--no-date'] >>> list(fn({"tag-date": None})) ['--no-date'] >>> list(fn({"tag-date": "true", "tag-build": ".a"})) ['--tag-date', '--tag-build', '.a'] ztag-datern z --tag-datez --no-datez tag-buildz --tag-buildN)r r` )r ra rg �valr r r! �__dist_info_args� s ��z*_ConfigSettingsTranslator.__dist_info_argsc c s< � |pi }|� d�p|� d�}|sdS dt|�gE dH dS )a The ``editable_wheel`` command accepts ``editable-mode=strict``. >>> fn = _ConfigSettingsTranslator()._editable_args >>> list(fn(None)) [] >>> list(fn({"editable-mode": "strict"})) ['--mode', 'strict'] z editable-mode� editable_modeNz--mode)rc r` )r ra rg �moder r r! �_editable_args� s � z(_ConfigSettingsTranslator._editable_argsc c s � | � d|�E dH dS )av Users may expect to pass arbitrary lists of arguments to a command via "--global-option" (example provided in PEP 517 of a "escape hatch"). >>> fn = _ConfigSettingsTranslator()._arbitrary_args >>> list(fn(None)) [] >>> list(fn({})) [] >>> list(fn({'--build-option': 'foo'})) ['foo'] >>> list(fn({'--build-option': ['foo']})) ['foo'] >>> list(fn({'--build-option': 'foo'})) ['foo'] >>> list(fn({'--build-option': 'foo bar'})) ['foo', 'bar'] >>> list(fn({'--global-option': 'foo'})) [] z--build-optionN)ri �r ra r r r! �_arbitrary_args s �z)_ConfigSettingsTranslator._arbitrary_argsN)r_ r` ra r] r rb )ra r] r rj ) r$ r% r& �__doc__ri ru �)_ConfigSettingsTranslator__dist_info_argsrz r| r r r r! r^ � s r^ c @ s� e Zd Zd5dd�Zd6d7d d �Zd8d9d d�Zd8d9dd�Zd:dd�Zd;dd�Z d8d<dd�Z d=d>d#d$�Z d?d@d'd(�Z d8dAd*d+�Z dBd-d.�Z d?d@d/d0�Zd8d9d1d2�Z d8d<d3d4�Zd S )C�_BuildMetaBackendra r] � requirementsrb c C s� g t jd d� �| �|��d�t _z t�� � | �� W d � W |S 1 s'w Y W |S tyF } z ||j7 }W Y d }~|S d }~ww )Nr �egg_info)�sys�argvru r' r/ � run_setupr r )r ra r� �er r r! �_get_build_requires# s& ��� �����z%_BuildMetaBackend._get_build_requires�setup.pyrV r` c C s� t j�|�}d}t|��}|�� �dd�}W d � n1 s w Y z t|t� � W d S tyL } z|j r9� t j dddd� W Y d }~d S d }~ww )N�__main__z\r\nz\nz6Running `setup.py` directly as CLI tool is deprecated.znPlease avoid using `sys.exit(0)` or similar statements that don't fit in the paradigm of a configuration file.zAhttps://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html)�see_url) r8 r9 �abspathrW �read�replace�exec�locals� SystemExit�coder �emit)r rV �__file__r$ rI r� r� r r r! r� 3 s" ����z_BuildMetaBackend.run_setupNc C � | j |g d�S �N)r� �r� r{ r r r! r J � z._BuildMetaBackend.get_requires_for_build_wheelc C r� r� r� r{ r r r! r M r� z._BuildMetaBackend.get_requires_for_build_sdist�metadata_directoryr �suffixr c C s. | � ||�}t|j|�st�t|�|� |jS )z� PEP 517 requires that the .dist-info directory be placed in the metadata_directory. To comply, we MUST copy the directory to the root. Returns the basename of the info directory, e.g. `proj-0.0.0.dist-info`. )�_find_info_directoryr �parent�shutil�mover` r= )r r� r� �info_dirr r r! �_bubble_up_info_directoryP s z+_BuildMetaBackend._bubble_up_info_directoryr c s� t �|�D ]1\}}}� fdd�|D �}t|�dks t|�dkr6t|�dks-J d� � d���t||d � S qd� � d|� �}t�|��) Nc s g | ] }|� � �r|�qS r rF rH �r� r r! r@ a s z:_BuildMetaBackend._find_info_directory.<locals>.<listcomp>r r z Multiple z directories foundzNo z directory found in )r8 �walk�lenr r � InternalError)r r� r� r� �dirs�_� candidates�msgr r� r! r� _ s � z&_BuildMetaBackend._find_info_directoryc C sx g t jd d� �| �|��d�d�t|��d�t _t� � | �� W d � n1 s+w Y | �|d� | �|d�S )Nr � dist_infoz --output-dirz--keep-egg-infoz .egg-infoz .dist-info)r� r� ru r` r7 r� r� �r r� ra r r r! r j s$ ������ � z2_BuildMetaBackend.prepare_metadata_for_build_wheelr � setup_command� Iterable[str]�result_extensionrE �result_directory�arbitrary_argsc C s� t j�|�}t j|dd� tjd|d��Y}g tjd d� �| �|��|�d�|�|�t_t � � | � � W d � n1 s>w Y t ||�}t j� ||�}t j� |�rZt �|� t �t j� ||�|� W d � |S 1 spw Y |S )NT)�exist_okz.tmp-)�prefix�dirr z --dist-dir)r8 r9 r� �makedirs�tempfile�TemporaryDirectoryr� r� ru r7 r� rO r; rP �remove�rename) r r� r� r� ra r� � tmp_dist_dir�result_basename� result_pathr r r! �_build_with_temp_dir{ s> � ������ � ��z&_BuildMetaBackend._build_with_temp_dir�wheel_directory�StrPath | Nonec s~ d� ��fdd� }|d u r|dg�S z |ddt |�g�W S ty> } zdt |�vr+� t�� |dg�W Y d }~S d }~ww ) N�cmdrb c sB t � � ��| d�� ��� ��W d � S 1 sw Y d S )N�.whl)r\ r� r| )r� �ra r r� r r! �_build� s �$�z-_BuildMetaBackend.build_wheel.<locals>._build� bdist_wheel�--dist-info-dirz --dist-info-dir not recognized)r� rb )r` r� �_IncompatibleBdistWheelr� )r r� ra r� r� �exr r� r! r � s ��z _BuildMetaBackend.build_wheel�sdist_directoryc C s | � g d�d||�S )N)�sdistz --formats�gztarz.tar.gz)r� )r r� ra r r r! r � s �z _BuildMetaBackend.build_sdist� str | Nonec C s> |sd S t t|��d��}t|�dksJ �|r t|d �S d S )Nz *.dist-infor r )r( r �globr� r` )r r� �dist_info_candidatesr r r! �_get_dist_info_dir� s z$_BuildMetaBackend._get_dist_info_dirc C sh | � |�}|r d|gng }dg|�| �|��}t� � | �|d||�W d � S 1 s-w Y d S )Nr� �editable_wheelr� )r� rz r\ r� )r r� ra r� r� rh r� r r r! r � s �$�z _BuildMetaBackend.build_editablec C s | � |�S r )r r{ r r r! r � r# z1_BuildMetaBackend.get_requires_for_build_editablec C s | � ||�S r )r r� r r r! r � s �z5_BuildMetaBackend.prepare_metadata_for_build_editable)ra r] r� rb �r� �rV r` r )ra r] )r� r r� r` r r` )r� r r� r` r r )r� r ra r] )r ) r� r� r� rE r� r ra r] r� r� )NN)r� r ra r] r� r� )r� r ra r] )r� r� r r� )r$ r% r& r� r� r r r� r� r r� r r r� r r r r r r r! r " s. � �' � � � �r c s$ e Zd ZdZdd� fdd� Z� ZS ) �_BuildMetaLegacyBackendaO Compatibility backend for setuptools This is a version of setuptools.build_meta that endeavors to maintain backwards compatibility with pre-PEP 517 modes of invocation. It exists as a temporary bridge between the old packaging mechanism and the new packaging mechanism, and will eventually be removed. r� rV r` c s� t tj�}tj�tj�|��}|tjvrtj�d|� tjd }|tjd< zt� j |d� W |tjd d �< |tjd< d S |tjd d �< |tjd< w )Nr rU ) r( r� r9 r8 �dirnamer� �insertr� �superr� )r rV �sys_path� script_dir� sys_argv_0�� __class__r r! r� � s � z!_BuildMetaLegacyBackend.run_setupr� r� )r$ r% r& r} r� � __classcell__r r r� r! r� � s r� c @ s e Zd ZdZdZdZdZdS )r� zAwheel.bdist_wheel is deprecated, please import it from setuptoolsz| Ensure that any custom bdist_wheel implementation is a subclass of setuptools.command.bdist_wheel.bdist_wheel. )i� � � z&https://github.com/pypa/wheel/pull/631N)r$ r% r& �_SUMMARY�_DETAILS� _DUE_DATE�_SEE_URLr r r r! r� s r� )rC r rD rE )@r} � __future__r r1 rQ r8 re r� r� r� rS rY �collections.abcr r r �pathlibr �typingr r r5 � r �_pathr r �_reqsr r r+ �distutils.utilr �typing_extensionsr �__all__� BaseExceptionr �distr' r2 r7 rB rO rW r\ r` r( r] �__annotations__r^ r r� r� �_BACKENDr r r r r r r r r r r r r! �<module> sd * B( __pycache__/glob.cpython-310.pyc 0000644 00000012002 15030122015 0012360 0 ustar 00 o �h� � @ s< d Z ddlmZ ddlZddlZddlZddlmZmZ ddl m Z m Z m Z e r2ddl mZmZmZ g d�Zd;d<dd�Zd;d=dd�Zd=dd�Ze d>dd ��Ze d?d d ��Zd@d$d �Zd%d&� Ze dAd(d)��Ze dBd+d)��ZdCd-d)�Ze dDd.d/��Ze dEd0d/��ZdFd1d/�Ze�d2�Ze�d3�ZdGd5d6�Z dHd7d8�Z d9d:� Z dS )Iz� Filename globbing utility. Mostly a copy of `glob` from Python 3.5. Changes include: * `yield from` and PEP3102 `*` removed. * Hidden files are not ignored. � )� annotationsN)�Iterable�Iterator)� TYPE_CHECKING�AnyStr�overload)� BytesPath�StrOrBytesPath�StrPath)�glob�iglob�escapeF�pathnamer � recursive�bool�return� list[AnyStr]c C s t t| |d��S )ay Return a list of paths matching a pathname pattern. The pattern may contain simple shell-style wildcards a la fnmatch. However, unlike fnmatch, filenames starting with a dot are special cases that are not matched by '*' and '?' patterns. If recursive is true, the pattern '**' will match any files and zero or more directories and subdirectories. )r )�listr )r r � r �B/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/glob.pyr s r �Iterator[AnyStr]c C s* t | |�}|rt| �rt|�}|rJ �|S )a� Return an iterator which yields the paths matching a pathname pattern. The pattern may contain simple shell-style wildcards a la fnmatch. However, unlike fnmatch, filenames starting with a dot are special cases that are not matched by '*' and '?' patterns. If recursive is true, the pattern '**' will match any files and zero or more directories and subdirectories. )�_iglob� _isrecursive�next)r r �it�sr r r r % s r c c s� � t j�| �\}}|rt|�rtnt}t| �s/|r$t j�| �r"| V d S t j�|�r-| V d S |s;|||�E d H d S || krIt|�rIt ||�}n|g}t|�sRt }|D ]}|||�D ] }t j� ||�V q[qTd S �N) �os�path�splitr �glob2�glob1� has_magic�lexists�isdirr �glob0�join)r r �dirname�basename� glob_in_dir�dirs�namer r r r 7 s0 � � ��r r' r �pattern�str� list[str]c C � d S r r �r' r, r r r r! [ � r! r �bytes� list[bytes]c C r/ r r r0 r r r r! ] r1 r � str | bytes�list[str] | list[bytes]c C sT | st |t�rtj�d�} ntj} zt�| �}W n ty# g Y S w t�||�S �N�ASCII) � isinstancer2 r �curdir�encode�listdir�OSError�fnmatch�filter)r' r, �namesr r r r! _ s � c C s: |s t j�| �r |gS g S t j�t j�| |��r|gS g S r )r r r$ r# r& )r' r( r r r r% m s �r% � Iterator[str]c C r/ r r r0 r r r r } r1 r �Iterator[bytes]c C r/ r r r0 r r r r r1 �Iterator[str | bytes]c c s. � t |�sJ �|d d� V t| �E d H d S )Nr )r � _rlistdirr0 r r r r � s � c C r/ r r �r' r r r rC � r1 rC c C r/ r r rD r r r rC � r1 c c s� � | st | t�rtj�d�} ntj} zt�| �}W n ty# Y d S w |D ] }|V | r4tj�| |�n|}t |�D ] }tj�||�V q:q&d S r6 ) r8 r2 r r9 r: r; r< r r& rC )r' r? �xr �yr r r rC � s" � � ��z([*?[])s ([*?[])r c C s& t | t�r t�| �d uS t�| �d uS r )r8 r2 �magic_check_bytes�search� magic_check)r r r r r" � s r" c C s t | t�r | dkS | dkS )Ns **z**)r8 r2 )r, r r r r � s r c C sB t j�| �\}} t| t�rt�d| �} || S t�d| �} || S )z Escape all special characters.s [\1]z[\1])r r � splitdriver8 r2 rG �subrI )r �driver r r r � s �r )F)r r r r r r )r r r r r r )r' r r, r- r r. )r' r r, r2 r r3 )r' r r, r4 r r5 )r' r r, r- r r@ )r' r r, r2 r rA )r' r r, r4 r rB )r' r r r@ )r' r r rA )r' r r rB )r r4 r r )r, r4 r r ) �__doc__� __future__r r= r �re�collections.abcr r �typingr r r � _typeshedr r r �__all__r r r r! r% r rC �compilerI rG r" r r r r r r �<module> sD $ __pycache__/dist.cpython-310.pyc 0000644 00000110512 15030122015 0012405 0 ustar 00 o �ha� � @ s� U d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z m Z m Z m Z d dlmZ d dlmZ d dlmZmZmZ d dlmZmZ d dlmZmZ d d lm Z m Z d d l m Z d d l m!Z!m"Z"m#Z#m$Z% d d l&m'Z' d dl(m)Z) d dl*m+Z+ d dl"m,Z, d dl-m.Z.m/Z/ d dl0m1Z1 d dl2m3Z3 d dl4m5Z5 d dl6m7Z7m8Z8 d dl9Z:d dl;Z:d dl<Z:d dl=Z:d dl>Z:d dl?m@Z@ d dlAmBZBmCZC d dlDmEZE d dlFmGZG er�d dlHmIZI d dlJmKZL d gZMeNeOfZP eeNeQd f eOeQ f ZRd eSd < d ZTeeQeUeQef e eQ f ZVd eSd!< dKd&d'�ZWd(d)� ZXdLd-d.�ZYd/d0� ZZd1d2� Z[d3d4� Z\d5d6� Z]d7d8� Z^d9d:� Z_dMd;d<�Z`d=d>� Zad?d@� ZbdAdB� ZcdCdD� Zde�rVd dl<mKZe ne5e:jfjK�ZeG dEd � d ee�ZKejgdNdGdH��ZhG dIdJ� dJe8�ZidS )O� )� annotationsN)�Iterable�Iterator�MutableMapping�Sequence)�glob)�Path)� TYPE_CHECKING�Any�Union)� partition�unique_everseen)� InvalidMarker�Marker)�InvalidSpecifier� SpecifierSet)�Version� )� _entry_points�_reqs�_static�command)�metadata)� _canonicalize_license_expression)�StrPath)� _StrOrIter)� pyprojecttoml�setupcfg)�ConfigDiscovery)�InvalidConfigError)� get_unpatched)�InformationOnly� SetuptoolsDeprecationWarning)�DEBUG)�DistutilsOptionError�DistutilsSetupError��translate_longopt)� strtobool)� TypeAlias)� Distributionr* .r) � _Sequenceztuple[str, ...] | list[str]�_OrderedStrSequence�name�str�returnr c C s0 | dkrt jdddd� tS tdt�d| ����)N�sequencez@`setuptools.dist.sequence` is an internal implementation detail.z8Please define your own `sequence = tuple, list` instead.)i� � � )�due_datezmodule z has no attribute )r" �emit� _sequence�AttributeError�__name__�r- � r9 �B/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/dist.py� __getattr__K s �r; c C sX zt j|d d d�}|jrJ �W d S ttttfy+ } z t|�d|�d��|�d }~ww )N)�valuer- �groupz/ must be importable 'module:attrs' string (got �))r � EntryPoint�extras� TypeError� ValueErrorr6 �AssertionErrorr% )�dist�attrr< �ep�er9 r9 r: �check_importableV s ����rH rE r< �Nonec C sd zt |t�sJ �d�|�|ksJ �W dS ttttfy1 } zt|�dt� d|�d��|�d}~ww )z"Verify that value is a string list� z must be of type <�> (got r> N) � isinstancer5 �joinrA rB r6 rC r% �_sequence_type_repr�rD rE r< rG r9 r9 r: �assert_string_list` s ����rP c C sr |}t | ||� |D ],}| �|�std|����|�d�\}}}|r.||vr.tj�d||� tjdddd� q dS ) z(Verify that namespace packages are validzCDistribution contains no modules or packages for namespace package �.z^WARNING: %r is declared as a package namespace, but %r is not: please correct this in setup.pyz/The namespace_packages parameter is deprecated.z<Please replace its usage with implicit namespaces (PEP 420).z3references/keywords.html#keyword-namespace-packages)�see_docsN) rP �has_contents_forr% � rpartition� distutils�log�warnr" r4 )rD rE r< � ns_packages�nsp�parent�_sep�_childr9 r9 r: � check_nspn s( � ���r] c C sD z t t�t|�� �� W dS tttfy! } ztd�|�d}~ww )z+Verify that extras_require mapping is validz�'extras_require' must be a dictionary whose values are strings or lists of strings containing valid project/version requirement specifiers.N) �list� itertools�starmap� _check_extra�itemsrA rB r6 r% rO r9 r9 r: � check_extras� s ����rc c C sZ | � d�\}}}zt|� W n ty# d|� d| �d�}t|�d �w tt�|�� d S )N�:z Invalid environment marker: z (r> )r � _check_markerr r% r^ r �parse)�extra�reqs�_namer[ �marker�msgr9 r9 r: ra � s �ra c C s | sd S t | �}|�� d S �N)r �evaluate)rj �mr9 r9 r: re � s re c C s$ t |�|krt|�d|�d���dS )z)Verify that value is True, False, 0, or 1z must be a boolean value (got r> N)�boolr% �rD rE r< r9 r9 r: � assert_bool� s �rq c C s& |s t �|� d�� d S t|� d���)Nz is ignored.z is invalid.)�DistDeprecationWarningr4 r% rp r9 r9 r: �invalid_unless_false� s rs c C s\ zt t�|�� t|t�rtd��W dS ttfy- } z |�d|� �}t|�|�d}~ww )z9Verify that install_requires is a valid requirements listz Unordered types are not allowedzb must be a string or iterable of strings containing valid project/version requirement specifiers; N)r^ r rf rL �setrA rB r% �rD rE r< �errorrk r9 r9 r: �check_requirements� s ��� ��rw c C sD zt |� W dS ttfy! } z |�d|� �}t|�|�d}~ww )z.Verify that value is a valid version specifierz7 must be a string containing valid version specifiers; N)r r r6 r% ru r9 r9 r: �check_specifier� s ��rx c C s4 zt �|� W dS ty } zt|�|�d}~ww )z)Verify that entry_points map is parseableN)r �load� Exceptionr% rO r9 r9 r: �check_entry_points� s ��r{ c C sb t |t�s t|�d���|�� D ] \}}t |t�s$td|�d|�d���t| d|�d�|� qdS )z@Verify that value is a dictionary of package names to glob listszP must be a dictionary mapping package names to lists of string wildcard patternszkeys of z dict must be strings (got r> z values of z dictN)rL �dictr% rb r. rP )rD rE r< �k�vr9 r9 r: �check_package_data� s � ��r c C s( |D ]}t �d|�stj�d|� qd S )Nz \w+(\.\w+)*z[WARNING: %r not a valid package name; please use only .-separated package names in setup.py)�re�matchrU rV rW )rD rE r< �pkgnamer9 r9 r: �check_packages� s ���r� c s� e Zd ZU dZdd� eedd� dd� dd� eed�Zded < dudvdd�Zdd� Z dd� Z e dd� �Z dd� Z dd� Zdwdd �Zdwd d �Ze dxdyd$d%��Ze dxdzd(d)��Zdud*d+�Zd{d.d/�Zd{d0d1�Zd|d2d3�Zd|d4d5�Zdud6d7�Zd}d:d;�Z <d~dd>d?�Zd�dCdD�Z dwdEdF�Z e dGdH� �Z dIdJ� Z dKdL� Z dMdN� Z!d�dQdR�Z"dSdT� Z#dUdV� Z$dwdWdX�Z%d�dZd[�Z&d�d\d]�Z'd�dadb�Z(d�dcdd�Z)dwdedf�Z*d�dhdi�Z+djdk� Z,d�dmdn�Z-dodp� Z.dqdr� Z/dw� fdsdt� Z0� Z1S )�r* a� Distribution with support for tests and package data This is an enhanced version of 'distutils.dist.Distribution' that effectively adds the following new optional keyword arguments to 'setup()': 'install_requires' -- a string or sequence of strings specifying project versions that the distribution requires when installed, in the format used by 'pkg_resources.require()'. They will be installed automatically when the package is installed. If you wish to use packages that are not available in PyPI, or want to give your users an alternate download location, you can add a 'find_links' option to the '[easy_install]' section of your project's 'setup.cfg' file, and then setuptools will scan the listed web pages for links that satisfy the requirements. 'extras_require' -- a dictionary mapping names of optional "extras" to the additional requirement(s) that using those extras incurs. For example, this:: extras_require = dict(reST = ["docutils>=0.3", "reSTedit"]) indicates that the distribution can optionally provide an extra capability called "reST", but it can only be used if docutils and reSTedit are installed. If the user installs your package using EasyInstall and requests one of your extras, the corresponding additional requirements will be installed if needed. 'package_data' -- a dictionary mapping package names to lists of filenames or globs to use to find data files contained in the named packages. If the dictionary has filenames or globs listed under '""' (the empty string), those names will be searched for in every package, in addition to any names for the specific package. Data files found using these names/globs will be installed along with the package, in the same location as the package. Note that globs are allowed to reference the contents of non-package subdirectories, as long as you use '/' as a path separator. (Globs are automatically converted to platform-specific paths at runtime.) In addition to these new keywords, this class also has several new methods for manipulating the distribution's contents. For example, the 'include()' and 'exclude()' methods can be thought of as in-place add and subtract commands that add or remove packages, modules, extensions, and so on from the distribution. c C � d S rl r9 r9 r9 r9 r: �<lambda># � zDistribution.<lambda>c C r� rl r9 r9 r9 r9 r: r� & r� c C r� rl r9 r9 r9 r9 r: r� ' r� c C r� rl r9 r9 r9 r9 r: r� ( r� )� long_description_content_type� project_urls�provides_extras�license_expression� license_file� license_files�install_requires�extras_require� list[str]�namespace_packagesN�attrs� MutableMapping[str, Any] | Noner/ rI c s� t | d�}|s i | _|p i }g | _d | _d | _|�dd �| _|�dg �| _|�dg �| _t j dd�D ] }t | �� |j d � q2t| j�� � ddh8 � � fd d �|�� D �}t�| |� tt � | _t| �| _| �|� | �| j j�| j _| �� d S ) N� package_data�src_root�dependency_links�setup_requires�distutils.setup_keywords�r= r� r� c s i | ] \}}|� vr||�qS r9 r9 ��.0r} r~ �� metadata_onlyr9 r: � <dictcomp>B s z)Distribution.__init__.<locals>.<dictcomp>)�hasattrr� � dist_files�include_package_data�exclude_package_data�popr� r� r� r � entry_points�vars� setdefaultr- rt � _DISTUTILS_UNSUPPORTED_METADATArb � _Distribution�__init__r. �_referenced_filesr � set_defaults�_set_metadata_defaults�_normalize_version�version�_finalize_requires)�selfr� �have_package_datarF � dist_attrsr9 r� r: r� 1 s* zDistribution.__init__c s@ dh}� fdd�t � j�D �}|| }|r d|� �}t|��d S )Nr- c s" h | ] }t � j|d �d ur|�qS rl )�getattrr )r� �key�r� r9 r: � <setcomp>S s �z2Distribution._validate_metadata.<locals>.<setcomp>z&Required package metadata is missing: )r� r r% )r� �required�provided�missingrk r9 r� r: �_validate_metadataQ s � �z Distribution._validate_metadatac C s4 | j �� D ]\}}t| j��||�||� �� qdS )z� Fill-in missing metadata fields not supported by distutils. Some fields may have been set by other tools (e.g. pbr). Those fields (vars(self.metadata)) take precedence to supplied attrs. N)r� rb r� r r� �get)r� r� �option�defaultr9 r9 r: r� ^ s �z#Distribution._set_metadata_defaultsc C sl ddl m} t| tj�rt| �} n t| |�s| d u r | S tt| ��}| |kr4t�d| � d|� d�� |S | S )Nr )�sic� Normalizing '�' to '�') rJ r� rL �numbers�Numberr. r r! r4 )r� r� � normalizedr9 r9 r: r� h s z Distribution._normalize_versionc C sp t | dd�r | j| j_| �� | j| j_| j| j_| jr4| j�� D ]}|�d�d }|r3| jj� |� q!dS dS )z� Set `metadata.python_requires` and fix environment markers in `install_requires` and `extras_require`. �python_requiresNrd r ) r� r� r �_normalize_requiresr� r� �keys�splitr� r� )r� rg r9 r9 r: r� x s ��z Distribution._finalize_requiresc C sz t | dd�pg }t | dd�pi }t�|�rtjnt}|ttt�|���| _ t�|�r-tj nt }|dd� |� � D ��| _ dS )zAMake sure requirement-related attributes exist and are normalizedr� Nr� c s s0 � | ]\}}|t ttt�|pg ���fV qd S rl )r^ �mapr. r rf r� r9 r9 r: � <genexpr>� s � �z3Distribution._normalize_requires.<locals>.<genexpr>)r� r � is_static�Listr^ r� r. r rf r� �Dictr| rb r� )r� r� r� �list_�dict_r9 r9 r: r� � s �z Distribution._normalize_requiresc C s� | j �� }dd� |D �}| j j}|rCt�|�rtjnt}|t|��}||kr6t� d|� d|� d�� || j _|rAt dd� |� ��d S |rYd}t j d d d� |� d |� �d � d S d S )a� Normalize license and license_expression. >>> dist = Distribution({"license_expression": _static.Str("mit aNd gpl-3.0-OR-later")}) >>> _static.is_static(dist.metadata.license_expression) True >>> dist._finalize_license_expression() >>> _static.is_static(dist.metadata.license_expression) # preserve "static-ness" True >>> print(dist.metadata.license_expression) MIT AND GPL-3.0-or-later c S s g | ] }|� d �r|�qS )z License :: �� startswith)r� �clr9 r9 r: � <listcomp>� s z=Distribution._finalize_license_expression.<locals>.<listcomp>r� r� r� zyLicense classifiers have been superseded by license expressions (see https://peps.python.org/pep-0639/). Please remove: � z&guides/writing-pyproject-toml/#licensez#License classifiers are deprecated.z[Please consider removing the following classifiers in favor of a SPDX license expression: �'https://packaging.python.org/en/latest/)�see_urlN) r �get_classifiersr� r r� �Strr. r r! r4 r rM r" )r� � classifiers�license_classifiers� license_expr�str_r� � pypa_guidesr9 r9 r: � _finalize_license_expression� s4 ���� ��z)Distribution._finalize_license_expressionc C sx | j j}|pg }| j j}|r||vr|�|� |du r+|du r+g d�}| j|dd�}n| j|dd�}tt|��| j _dS )z<Compute names of all license files which should be included.N)z LICEN[CS]E*zCOPYING*zNOTICE*zAUTHORS*F)� enforce_matchT)r r� r� �append�_expand_patternsr^ r )r� r� �patternsr� �filesr9 r9 r: �_finalize_license_files� s z$Distribution._finalize_license_filesTr� r� ro � Iterator[str]c s � �fdd�|D �S )aO >>> list(Distribution._expand_patterns(['LICENSE'])) ['LICENSE'] >>> list(Distribution._expand_patterns(['pyproject.toml', 'LIC*'])) ['pyproject.toml', 'LICENSE'] >>> list(Distribution._expand_patterns(['setuptools/**/pyprojecttoml.py'])) ['setuptools/config/pyprojecttoml.py'] c 3 sJ � | ] }t � �|���D ]}|�d �s tj�|�r |�tjd�V q qdS )�~�/N)�sorted� _find_pattern�endswith�os�path�isfile�replace�sep)r� �patternr� ��clsr� r9 r: r� � s � �� � �z0Distribution._expand_patterns.<locals>.<genexpr>r9 )r� r� r� r9 r� r: r� � s �z Distribution._expand_patternsr� r. c C s� d}d| v rt jd| �d�dd|� �dd� | �tjd f�s"d | v r*td| �d ���t�d | �d u r?t jdd| d|� �dd� t| dd�}|rR|sRt jdd| dd� |S )a� >>> Distribution._find_pattern("LICENSE") ['LICENSE'] >>> Distribution._find_pattern("/LICENSE.MIT") Traceback (most recent call last): ... setuptools.errors.InvalidConfigError: Pattern '/LICENSE.MIT' should be relative... >>> Distribution._find_pattern("../LICENSE.MIT") Traceback (most recent call last): ... setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern '../LICENSE.MIT' cannot contain '..'... >>> Distribution._find_pattern("LICEN{CSE*") Traceback (most recent call last): ... setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern 'LICEN{CSE*' contains invalid characters... z specifications/glob-patterns/z..zPattern z cannot contain '..'z� Please ensure the files specified are contained by the root of the Python package (normally marked by `pyproject.toml`). r� )�� � � )r� r3 r� z:\z/ should be relative and must not start with '/'z^[\w\-\.\/\*\?\[\]]+$Nz$Please provide a valid glob pattern.z0Pattern {pattern!r} contains invalid characters.)r� r� r3 T)� recursivez,Cannot find any files for the given pattern.z,Pattern {pattern!r} did not match any files.)r� r3 ) r" r4 r� r� r� r r� r� r )r� r� r� �foundr9 r9 r: r� � s: � �� � zDistribution._find_patternc C s� ddl m} tjtjkrg ng d�}t|�}|du r | �� }tr%| �d� |� }t |_ |D ]f}t |dd��}trD| �dj d i t � ��� |�|� W d � n1 sSw Y |�� D ]2}|�|�}| �|�} |D ]#} | d kst| |v ruqj|�|| �} | �| |�} | �| |�} || f| | < qjq\|�� q-d | jvr�dS | jd �� D ]7\} \} } | j�| �} | r�t| � } n| d v r�t| �} z t| | p�| | � W q� ty� } zt |�|�d}~ww dS ) z� Adapted from distutils.dist.Distribution.parse_config_files, this method provides the same functionality in subtly-improved ways. r )� ConfigParser) z install-basezinstall-platbasez install-libzinstall-platlibzinstall-purelibzinstall-headerszinstall-scriptsz install-data�prefixz exec-prefix�home�user�rootNz"Distribution.parse_config_files():�utf-8��encodingz reading {filename}r7 �global)�verbose�dry_runr9 ) � configparserr� �sysr� � base_prefix� frozenset�find_config_filesr# �announcer. � optionxform�open�format�locals� read_file�sections�options�get_option_dictr� �_enforce_underscore�_enforce_option_lowercaser� �command_optionsrb � negative_optr( �setattrrB r$ )r� � filenamesr� �ignore_options�parser�filename�reader�sectionr �opt_dict�opt�val�src�aliasrG r9 r9 r: �_parse_config_files" sZ �� � � ���z Distribution._parse_config_filesr r c C s| d|vs | � |�r |S |�dd�}| jjr d| jj� d�nd}tjd|�d|�d|�d �d |�d |�d |� d �ddd� |S )N�-�_� (Affected: �).rJ zInvalid dash-separated key � in z- (setup.cfg), please use the underscore name � instead.z% Usage of dash-separated zV will not be supported in future versions. Please use the underscore name � instead. � �!userguide/declarative_config.html�r� r� r� �rR r3 )� _skip_setupcfg_normalizationr� r r- r" r4 )r� r r �underscore_opt�affectedr9 r9 r: r q s& ����� z Distribution._enforce_underscorec C s~ |� � s | �|�r |S |�� }| jjrd| jj� d�nd}tjd|�d|�d|�d�d|�d|�d |�d |� d � d d d� |S )Nr# r$ rJ zInvalid uppercase key r% z# (setup.cfg), please use lowercase r& z$ Usage of uppercase key zL will not be supported in future versions. Please use lowercase r' r( r) r* r+ )�islowerr, �lowerr r- r" r4 )r� r r � lowercase_optr. r9 r9 r: r � s* ������ z&Distribution._enforce_option_lowercasec C s d}||v p | � |� S )N)zoptions.extras_requirezoptions.data_fileszoptions.entry_pointszoptions.package_dataz options.exclude_package_data)�_is_setuptools_section)r� r �skipr9 r9 r: r, � s z)Distribution._skip_setupcfg_normalizationc C s |dkp |� d�p |t� v S )Nr r )r� �_setuptools_commands)r� r r9 r9 r: r2 � s ��z#Distribution._is_setuptools_sectionc C s` |� � }|du r | �|�}tr| �d|� d�� |�� D ]�\}\}}tr3| �d|� d|� d|� d�� z dd � |jD �}W n tyH g }Y nw z|j}W n tyY i }Y nw zBt|t �} ||v rr| rrt ||| t |� � n)||v r�| r�t ||t |�� nt ||�r�t |||� nt d |� d |� d |� d ���W q ty� } zt | �| �d} ~ ww dS )a� Set the options for 'command_obj' from 'option_dict'. Basically this means copying elements of a dictionary ('option_dict') to attributes of an instance ('command'). 'command_obj' must be a Command instance. If 'option_dict' is not supplied, uses the standard option dictionary for this command (from 'self.command_options'). (Adopted from distutils.dist.Distribution._set_command_options) Nz setting options for 'z ' command:z z = z (from r> c S s g | ]}t |��qS r9 r& )r� �or9 r9 r: r� � s z5Distribution._set_command_options.<locals>.<listcomp>z error in z : command 'z' has no such option 'r� )�get_command_namer r# r rb �boolean_optionsr6 r rL r. r r( r� r$ rB ) r� � command_obj� option_dict� command_namer� �sourcer< � bool_opts�neg_opt� is_stringrG r9 r9 r: �_set_command_options� sF � � �� ���z!Distribution._set_command_optionsr �Iterable[StrPath] | Nonec C sb g }t | jptjd�}|dur&tdd� |�}t|d �}t|d �}||fS |�� r-|g}||fS )z/Add default file and split between INI and TOMLzpyproject.tomlNc S s t | �jdkS )Nz.toml)r �suffix)�fr9 r9 r: r� � s z8Distribution._get_project_config_files.<locals>.<lambda>r r )r r� r� �curdirr r^ �exists)r� r � tomlfiles�standard_project_metadata�partsr9 r9 r: �_get_project_config_files� s �z&Distribution._get_project_config_filesF�ignore_option_errorsc C s` | � |�\}}| j|d� tj| | j|d� |D ] }t�| ||� q| �� | �� | � � dS )zXParses configuration files from various levels and loads configuration. )r )rI N) rH r r �parse_configurationr r �apply_configurationr� r� r� )r� r rI �inifilesrE r r9 r9 r: �parse_config_files� s � z Distribution.parse_config_files�requiresr �!list[_pkg_resources_Distribution]c C � ddl m} || |�S )z Resolve pre-setup requirementsr )�_fetch_build_eggs)� installerrQ )r� rN rQ r9 r9 r: �fetch_build_eggs� s z Distribution.fetch_build_eggsc C sR d}dd� }t j|d�}t�| j|�}tdd� |�}t||d�D ]}|| � q dS ) z� Allow plugins to apply arbitrary operations to the distribution. Each hook may optionally define a 'order' to influence the order of execution. Smaller numbers go first and the default is 0. z(setuptools.finalize_distribution_optionsc S s t | dd�S )N�orderr )r� )�hookr9 r9 r: �by_order s z/Distribution.finalize_options.<locals>.by_orderr� c S s | � � S rl )ry )rG r9 r9 r: r� s z/Distribution.finalize_options.<locals>.<lambda>)r� N)r r� r_ � filterfalse�_removedr� r� )r� r= rV �defined�filtered�loadedrF r9 r9 r: �finalize_options s �z Distribution.finalize_optionsc C s dh}| j |v S )z� When removing an entry point, if metadata is loaded from an older version of Setuptools, that removed entry point will attempt to be loaded and will fail. See #2765 for more details. � 2to3_doctestsr8 )rF �removedr9 r9 r: rX s � zDistribution._removedc C s> t jdd�D ]}t| |jd �}|d ur |�� | |j|� qd S )Nr� r� )r r� r� r- ry )r� rF r< r9 r9 r: �_finalize_setup_keywords" s ��z%Distribution._finalize_setup_keywordsc C s� ddl m} tj�tjd�}tj�|�sLt�|� |�|� tj�|d�}t |ddd��}|� d� |� d � |� d � W d � |S 1 sGw Y |S ) Nr )�windows_supportz.eggsz README.txt�wr� r� zcThis directory contains eggs that were downloaded by setuptools to build, test, and run plug-ins. zAThis directory caches those eggs to prevent repeated downloads. z/However, it is safe to delete this directory. ) rJ r` r� r� rM rC rD �mkdir� hide_filer �write)r� r` � egg_cache_dir�readme_txt_filenamerB r9 r9 r: �get_egg_cache_dir( s$ �� � � z Distribution.get_egg_cache_dirc C rP )z Fetch an egg needed for buildingr )�fetch_build_egg)rR rh )r� �reqrh r9 r9 r: rh = s z Distribution.fetch_build_eggr �type[distutils.cmd.Command]c C sh || j v r | j | S |dkrddlm} |S tjd|d�}|D ]}|�� | j |< }| S t�| |�S )z(Pluggable version of get_command_class()� bdist_wheelr )rk �distutils.commands)r= r- )�cmdclass�command.bdist_wheelrk r r� ry r� �get_command_class)r� r rk �epsrF rm r9 r9 r: ro C s z Distribution.get_command_classc C �< t jdd�D ]}|j| jvr|�� }|| j|j< qt�| �S �Nrl r� )r r� r- rm ry r� �print_commands�r� rF rm r9 r9 r: rs U � � zDistribution.print_commandsc C rq rr )r r� r- rm ry r� �get_command_listrt r9 r9 r: rv \ ru z Distribution.get_command_listc K �@ |� � D ]\}}t| d| d�}|r||� q| �||� qdS )a� Add items to distribution that are named in keyword arguments For example, 'dist.include(py_modules=["x"])' would add 'x' to the distribution's 'py_modules' attribute, if it was not already there. Currently, this method only supports inclusion for attributes that are lists or tuples. If you need to add support for adding to other attributes in this or a subclass, you can add an '_include_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'include()'. So, 'dist.include(foo={"bar":"baz"})' will try to call 'dist._include_foo({"bar":"baz"})', which can then handle whatever special inclusion logic is needed. � _include_N)rb r� � _include_misc)r� r� r} r~ �includer9 r9 r: rz c s �zDistribution.include�packagec sj � d �| j r� �fdd�| j D �| _ | jr"� �fdd�| jD �| _| jr3� �fdd�| jD �| _dS dS )z9Remove packages, modules, and extensions in named packagerQ c �" g | ] }|� kr|� ��s|�qS r9 r� �r� �p�r{ �pfxr9 r: r� ~ � z0Distribution.exclude_package.<locals>.<listcomp>c r| r9 r� r} r r9 r: r� � r� c s& g | ]}|j � kr|j ���s|�qS r9 )r- r� r} r r9 r: r� � s �N)�packages� py_modules� ext_modules)r� r{ r9 r r: �exclude_packagey s � � ��z Distribution.exclude_packagec C s2 |d }| � � D ]}||ks|�|�r dS qdS )z<Return true if 'exclude_package(package)' would do somethingrQ TF)�iter_distribution_namesr� )r� r{ r� r~ r9 r9 r: rS � s �z Distribution.has_contents_forr- r< r+ c s� t � t�st|� dt� d� �d���zt| |�}W n ty- } zt|� d��|�d}~ww |dur=t |t�s=t|d ��|rNt| |� fdd�|D �� dS dS ) zAHandle 'exclude()' for list/tuple attrs without a special handler�: setting must be of type <rK r> � : No such distribution settingN�4: this setting cannot be changed via include/excludec � g | ]}|� vr|�qS r9 r9 �r� �item�r< r9 r: r� � � z.Distribution._exclude_misc.<locals>.<listcomp>)rL r5 r% rN r� r6 r )r� r- r< �oldrG r9 r� r: � _exclude_misc� s" ���� �zDistribution._exclude_miscc s� t |t�st|� dt� d|�d���zt| |�� W n ty- } zt|� d��|�d}~ww � du r:t| ||� dS t � t�sEt|d ��� fdd�|D �}t| |t� �| � dS ) zAHandle 'include()' for list/tuple attrs without a special handlerr� rK r> r� Nr� c r� r9 r9 r� �r� r9 r: r� � r� z.Distribution._include_misc.<locals>.<listcomp>)rL r5 r% rN r� r6 r r^ )r� r- r< rG �newr9 r� r: ry � s$ ��� �zDistribution._include_miscc K rw )a Remove items from distribution that are named in keyword arguments For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from the distribution's 'py_modules' attribute. Excluding packages uses the 'exclude_package()' method, so all of the package's contained packages, modules, and extensions are also excluded. Currently, this method only supports exclusion from attributes that are lists or tuples. If you need to add support for excluding from other attributes in this or a subclass, you can add an '_exclude_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'exclude()'. So, 'dist.exclude(foo={"bar":"baz"})' will try to call 'dist._exclude_foo({"bar":"baz"})', which can then handle whatever special exclusion logic is needed. � _exclude_N)rb r� r� )r� r� r} r~ �excluder9 r9 r: r� � s �zDistribution.excluder� c C s4 t |t�stdt� d|�d���tt| j|�� d S )Nz#packages: setting must be of type <rK r> )rL r5 r% rN r^ r� r� )r� r� r9 r9 r: �_exclude_packages� s �z Distribution._exclude_packagesc C s� | j j| _| j j| _|d }| �d�}||v r6|| \}}||= dd l}|�|d�|d d�< |d }||v st�| ||�}| �|�} t | dd �rWd|f| �|�d< |d urWg S |S )Nr �aliasesTr �command_consumes_arguments� command line�args) � __class__�global_optionsr r �shlexr� r� �_parse_command_optsro r� ) r� r r� r r� �_srcr r� �nargs� cmd_classr9 r9 r: r� � s$ � z Distribution._parse_command_opts� dict[str, dict[str, str | None]]c C s� i }| j �� D ]W\}}|�� D ]N\}\}}|dkrq|�dd�}|dkrO| �|�}| j�� }|�t|di �� |�� D ]\} } | |krI| }d} nq;td��n|dkrUd}||� |i �|< qq|S ) ah Return a '{cmd: {opt:val}}' map of all command-line options Option names are all long, but do not include the leading '--', and contain dashes rather than underscores. If the option doesn't take an argument (e.g. '--quiet'), the 'val' is 'None'. Note that options provided by config files are intentionally excluded. r� r" r! r r Nz Shouldn't be able to get herer ) r rb r� �get_command_objr �copy�updater� rC r� ) r� �d�cmd�optsr r r �cmdobjr= �neg�posr9 r9 r: �get_cmdline_options� s. ���z Distribution.get_cmdline_optionsc c sl � | j pdE dH | jp dE dH | jpdD ] }t|t�r"|\}}n|j}|�d�r0|dd� }|V qdS )z@Yield all packages, modules, and extension names in distributionr9 N�modulei����)r� r� r� rL �tupler- r� )r� �extr- � _buildinfor9 r9 r: r� s � �z$Distribution.iter_distribution_namesc C s� ddl }| jr t�| |�S t|jtj�st�| |�S |jj� � dv r(t�| |�S |jj}|jj dd� zt�| |�W |jj |d� S |jj |d� w )z�If there were any non-global "display-only" options (--help-commands or the metadata display options) on the command line, display the requested info and return true; else return false. r N)r� �utf8r� r� ) r � help_commandsr� �handle_display_optionsrL �stdout�io� TextIOWrapperr� r0 � reconfigure)r� � option_orderr r� r9 r9 r: r� / s z#Distribution.handle_display_optionsc s | � � t� �|� d S rl )r� �super� run_command)r� r �r� r9 r: r� K s zDistribution.run_commandrl )r� r� r/ rI )r/ rI )T)r� r� r� ro r/ r� )r� r. r� ro r/ r� )r r. r r. r/ r. )r r. r/ ro )r r@ )NF)r r@ rI ro r/ rI )rN r r/ rO )r r. r/ rj )r{ r. r/ rI )r{ r. r/ ro )r- r. r< r+ r/ rI )r� r+ r/ rI )r/ r� )2r7 � __module__� __qualname__�__doc__r| r^ r� �__annotations__r� r� r� � staticmethodr� r� r� r� r� � classmethodr� r� r r r r, r2 r? rH rM rS r\ rX r_ rg rh ro rs rv rz r� rS r� ry r� r� r� r� r� r� r� � __classcell__r9 r9 r� r: r* � st .� (� 9 O - � ' �set[str]c C sH zt �d�j} dd� | D �}W n t jy g }Y nw h tjj�|�S )N� setuptoolsc s s � | ]}|j V qd S rl r8 )r� rF r9 r9 r: r� X s � z'_setuptools_commands.<locals>.<genexpr>)r � distributionr� �PackageNotFoundErrorrU r �__all__)r� rp r9 r9 r: r4 S s �r4 c @ s e Zd ZdZdS )rr zrClass for warning about deprecations in dist in setuptools. Not ignored by default, unlike DeprecationWarning.N)r7 r� r� r� r9 r9 r9 r: rr _ s rr )r- r. r/ r )rE r. r< r+ r/ rI )rE r. r< r, r/ rI )r/ r� )j� __future__r � functoolsr� r_ r� r� r� r �collections.abcr r r r r �pathlibr �typingr r r �more_itertoolsr r �packaging.markersr r �packaging.specifiersr r �packaging.versionr rJ r r r r r" � _importlibr �_normalizationr �_pathr r �configr r � discoveryr �errorsr �monkeyr �warningsr! r" � distutils.cmdrU �distutils.command�distutils.core�distutils.dist� distutils.log�distutils.debugr# �distutils.errorsr$ r% �distutils.fancy_getoptr' �distutils.utilr( �typing_extensionsr) � pkg_resourcesr* �_pkg_resources_Distributionr� r� r^ r5 r. r+ r� rN r| r, r; rH rP r] rc ra re rq rs rw rx r{ r r� r� �core�cacher4 rr r9 r9 r9 r: �<module> s� " e __pycache__/logging.cpython-310.pyc 0000644 00000002411 15030122015 0013066 0 ustar 00 o �h� � @ sT d dl Z d dlZd dlZddlmZ d dlZdd� Zd dd�Zd e de fd d �Z dS ) � N� )�monkeyc C s | j tjk S )N)�levelno�logging�WARNING)�record� r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/logging.py� _not_warning s r �returnc C sv t �� } | �t j� t �tj�}|�t� | |f}t jdd|t j d� t � t j j�r9t�tt jd� t jt j _dS dS )z� Configure logging to emit warning and above to stderr and everything else to stdout. This behavior is provided for compatibility with distutils.log but may change in the future. z {message}�{)�format�style�handlers�level� set_thresholdN)r � StreamHandler�setLevelr �sys�stdout� addFilterr � basicConfig�DEBUG�inspect�ismodule� distutils�dist�logr � patch_funcr )� err_handler� out_handlerr r r r � configure s ��r! r c C s t j�| d � t�| �S )N� )r �rootr r � unpatched)r r r r r & s r )r N) r r r � r � distutils.logr r r! �intr r r r r �<module> s __pycache__/_static.cpython-310.pyc 0000644 00000012063 15030122015 0013072 0 ustar 00 o �h� � @ s@ d dl mZ d dlmZ d dlZddlmZ G dd� d�Zde d e d e d dfd d �Z G dd� de e�Z G dd� de e�ZG dd� dee�ZdD ]Ze eed� qGG dd� dee�ZdD ]Ze eed� q[G dd� dejje�Zed �Zd ed efd d �Ze e e eeeeeiZd ed efd d!�Zd ed efd"d#�Z e� Z e� Z dS )$� )�wraps)�TypeVarN� )� SetuptoolsDeprecationWarningc @ s e Zd ZU dZdZeed< dS )�Statica` Wrapper for built-in object types that are allow setuptools to identify static core metadata (in opposition to ``Dynamic``, as defined :pep:`643`). The trick is to mark values with :class:`Static` when they come from ``pyproject.toml`` or ``setup.cfg``, so if any plugin overwrite the value with a built-in, setuptools will be able to recognise the change. We inherit from built-in classes, so that we don't need to change the existing code base to deal with the new types. We also should strive for immutability objects to avoid changes after the initial parsing. F� _mutated_N)�__name__� __module__� __qualname__�__doc__r �bool�__annotations__� r r �E/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_static.pyr s r �target�method�copying�returnc sJ t | |d���du r dS t��dtf� �fdd� �}d|_t| ||� dS )a Because setuptools is very flexible we cannot fully prevent plugins and user customizations from modifying static values that were parsed from config files. But we can attempt to block "in-place" mutations and identify when they were done. N�selfc s4 d| _ tjdd� � d�dd� �| g|�R i |��S )NTz/Direct modification of value will be disallowedz� In an effort to implement PEP 643, direct/in-place changes of static values that come from configuration files are deprecated. If you need to modify this value, please first create a copy with z� and make sure conform to all relevant standards when overriding setuptools functionality (https://packaging.python.org/en/latest/specifications/). )i� � r )�due_date)r r �emit)r �args�kwargs�r �fnr r � _replacement' s �� z+_prevent_modification.<locals>._replacement� )�getattrr r r �setattr)r r r r r r r �_prevent_modification s r c @ � e Zd ZdS )�StrN�r r r r r r r r" = � r" c @ r! )�TupleNr# r r r r r% A r$ r% c @ � e Zd ZdZdS )�Lista� :meta private: >>> x = List([1, 2, 3]) >>> is_static(x) True >>> x += [0] # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): SetuptoolsDeprecationWarning: Direct modification ... >>> is_static(x) # no longer static after modification False >>> y = list(x) >>> y.clear() >>> y [] >>> y == x False >>> is_static(List(y)) True N�r r r r r r r r r' E � r' ) � __delitem__�__iadd__� __setitem__�append�clear�extend�insert�remove�reverse�popz `list(value)`c @ r& )�Dicta� :meta private: >>> x = Dict({'a': 1, 'b': 2}) >>> is_static(x) True >>> x['c'] = 0 # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): SetuptoolsDeprecationWarning: Direct modification ... >>> x._mutated_ True >>> is_static(x) # no longer static after modification False >>> y = dict(x) >>> y.popitem() ('b', 2) >>> y == x False >>> is_static(Dict(y)) True Nr( r r r r r4 l r) r4 )r* �__ior__r, r. r3 �popitem� setdefault�updatez `dict(value)`c @ r& )� SpecifierSetz>Not exactly a built-in type but useful for ``requires-python``Nr( r r r r r9 � r) r9 �T�valuec C s | S )z >>> noop(42) 42 r �r; r r r �noop� s r= c C s t �t| �t�| �S )zc >>> is_static(attempt_conversion("hello")) True >>> is_static(object()) False )� _CONVERSIONS�get�typer= r< r r r �attempt_conversion� s rA c C s t | t�o| j S )z� >>> is_static(a := Dict({'a': 1})) True >>> is_static(dict(a)) False >>> is_static(b := List([1, 2, 3])) True >>> is_static(list(b)) False )� isinstancer r r< r r r � is_static� s rC ) � functoolsr �typingr �packaging.specifiers� packaging�warningsr r r@ �strr r" �tupler% �listr' �_method�dictr4 � specifiersr9 r: r= r> rA �objectr rC � EMPTY_LIST� EMPTY_DICTr r r r �<module> s, " __pycache__/_path.cpython-310.pyc 0000644 00000005530 15030122015 0012540 0 ustar 00 o �h} � @ s� U d dl mZ d dlZd dlZd dlZd dlmZmZmZ d dl m Z er+d dl m Z ee eje f Zded< edee eje f d �Zd d � Zddd�Zddd�Zejdd� �ZdS )� )� annotationsN)� TYPE_CHECKING�TypeVar�Union)�unique_everseen)� TypeAliasr �StrPath�StrPathT)�boundc C s t j�| �}t j|dd� dS )z1Ensure that the parent directory of `path` existsT)�exist_okN)�os�path�dirname�makedirs)r r � r �C/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_path.py�ensure_directory s r �p1�p2�return�boolc C s t | �t |�kS )a� Differs from os.path.samefile because it does not require paths to exist. Purely string based (no comparison between i-nodes). >>> same_path("a/b", "./a/b") True >>> same_path("a/b", "a/./b") True >>> same_path("a/b", "././a/b") True >>> same_path("a/b", "./a/b/c/..") True >>> same_path("a/b", "../a/b/c") False >>> same_path("a", "a/b") False )�normpath)r r r r r � same_path s r �filename�strc C s6 t jdkr tj�| �n| }tj�tj�tj�|���S )z2Normalize a file/dir name for comparison purposes.�cygwin)�sys�platformr r �abspath�normcase�realpathr )r �filer r r r * s r c c s� � t � }tj�d|�}tj�dd�}z4tj�t| ��}td||g�}tj�|�}|r/|tjd< dV W ||u r@tj�dd� dS |tjd< dS ||u rStj�dd� w |tjd< w )a� Add the indicated paths to the head of the PYTHONPATH environment variable so that subprocesses will also see the packages at these paths. Do this in a context that restores the value on exit. >>> getfixture('monkeypatch').setenv('PYTHONPATH', 'anything') >>> with paths_on_pythonpath(['foo', 'bar']): ... assert 'foo' in os.environ['PYTHONPATH'] ... assert 'anything' in os.environ['PYTHONPATH'] >>> os.environ['PYTHONPATH'] 'anything' >>> getfixture('monkeypatch').delenv('PYTHONPATH') >>> with paths_on_pythonpath(['foo', 'bar']): ... assert 'foo' in os.environ['PYTHONPATH'] >>> os.environ.get('PYTHONPATH') � PYTHONPATH� N) �objectr �environ�get�pathsep�joinr �filter�pop)�paths�nothing�orig_pythonpath�current_pythonpath�prefix�to_join�new_pathr r r �paths_on_pythonpath1 s" � �r2 )r r r r r r )r r r r )� __future__r � contextlibr r �typingr r r �more_itertoolsr �typing_extensionsr r �PathLiker �__annotations__r r r r �contextmanagerr2 r r r r �<module> s __pycache__/namespaces.cpython-310.pyc 0000644 00000007237 15030122015 0013572 0 ustar 00 o �hc � @ sR d dl Z d dlZddlmZ d dlmZ e jjZG dd� d�Z G dd� de �Z dS ) � N� )�py312)�logc @ sd e Zd ZdZddd�Zddd�Zdd � Zd d � Zd Z d Z dd� Z dd� Z dd� Z e dd� �ZdS )� Installerz -nspkg.pth�returnNc C s� | � � }|sd S | �� }| j�|� t�d|� t| j|�}| jr't |� d S t |dt j d��}|� |� W d � d S 1 s@w Y d S )Nz Installing %s�wt)�encoding)�_get_all_ns_packages�_get_nspkg_file�outputs�appendr �info�map�_gen_nspkg_line�dry_run�list�openr � PTH_ENCODING� writelines)�self�nsp�filename�lines�f� r �H/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/namespaces.py�install_namespaces s "�z Installer.install_namespacesc C s2 | � � }tj�|�s d S t�d|� t�|� d S )Nz Removing %s)r �os�path�existsr r �remove)r r r r r �uninstall_namespaces! s z Installer.uninstall_namespacesc C s t j�| �� �\}}|| j S �N)r r �splitext� _get_target� nspkg_ext)r r �_r r r r ( s zInstaller._get_nspkg_filec C � | j S r" )�target�r r r r r$ , � zInstaller._get_target)zimport sys, types, osz$p = os.path.join(%(root)s, *%(pth)r)z(importlib = __import__('importlib.util')z!__import__('importlib.machinery')z�m = sys.modules.setdefault(%(pkg)r, importlib.util.module_from_spec(importlib.machinery.PathFinder.find_spec(%(pkg)r, [os.path.dirname(p)])))zCm = m or sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))z7mp = (m or []) and m.__dict__.setdefault('__path__',[])z (p not in mp) and mp.append(p))z4m and setattr(sys.modules[%(parent)r], %(child)r, m)c C s dS )Nz$sys._getframe(1).f_locals['sitedir']r r) r r r � _get_rootD s zInstaller._get_rootc C sN t |�d��}| �� }| j}|�d�\}}}|r || j7 }d�|�t� d S )N�.�;� )�tuple�splitr+ � _nspkg_tmpl� rpartition�_nspkg_tmpl_multi�join�locals)r �pkg�pth�root� tmpl_lines�parent�sep�childr r r r G s zInstaller._gen_nspkg_linec C s$ | j jpg }tttt| j|����S )z,Return sorted list of all package namespaces)� distribution�namespace_packages�sorted�set�flattenr � _pkg_names)r �pkgsr r r r P s z Installer._get_all_ns_packagesc c s0 � | � d�}|rd�|�V |�� |sdS dS )z� Given a namespace package, yield the components of that package. >>> names = Installer._pkg_names('a.b.c') >>> set(names) == set(['a', 'a.b', 'a.b.c']) True r, N)r0 r4 �pop)r6 �partsr r r rB U s � �zInstaller._pkg_names)r N)�__name__� __module__� __qualname__r% r r! r r$ r1 r3 r+ r r � staticmethodrB r r r r r s r c @ s e Zd Zdd� Zdd� ZdS )�DevelopInstallerc C s t t| j��S r" )�repr�str�egg_pathr) r r r r+ f s zDevelopInstaller._get_rootc C r' r" )�egg_linkr) r r r r$ i r* z DevelopInstaller._get_targetN)rF rG rH r+ r$ r r r r rJ e s rJ ) � itertoolsr �compatr � distutilsr �chain� from_iterablerA r rJ r r r r �<module> s Z __pycache__/unicode_utils.cpython-310.pyc 0000644 00000006136 15030122015 0014316 0 ustar 00 o �hu � @ s� d dl Z d dlZd dlmZ ddlmZ ddlmZ dd� Zdd � Z d d � Z ej fd e d e fdd�Z ej fded e d dfdd�ZG dd� de�ZdS )� N)�RawConfigParser� )�py39)� SetuptoolsDeprecationWarningc C sR t | t�r t�d| �S z| �d�} t�d| �} | �d�} W | S ty( Y | S w )N�NFD�utf-8)� isinstance�str� unicodedata� normalize�decode�encode� UnicodeError)�path� r �K/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/unicode_utils.py� decompose s ��r c C sR t | t�r| S t�� p d}|df}|D ]}z| �|�W S ty& Y qw dS )z] Ensure that the given path is decoded, ``None`` when no expected encoding works r N)r r �sys�getfilesystemencodingr �UnicodeDecodeError)r �fs_enc� candidates�encr r r �filesys_decode s �r c C s" z| � |�W S ty Y dS w )z/turn unicode encoding into a functional routineN)r �UnicodeEncodeError)�stringr r r r � try_encode+ s �r �file�returnc C s� z t | ddd�� }|�� W d � W S 1 sw Y W dS tyM tj| |d� t | d|d��}|�� W d � Y S 1 sEw Y Y dS w )a First try to read the file with UTF-8, if there is an error fallback to a different encoding ("locale" by default). Returns the content of the file. Also useful when reading files that might have been produced by an older version of setuptools. �rr ��encodingN�r �fallback_encoding)�open�readr �_Utf8EncodingNeeded�emit)r r# �fr r r �_read_utf8_with_fallback3 s (� *��r) �cfgc C sN z | j |dd� W dS ty& tj||d� | �� | j ||d� Y dS w )z�Same idea as :func:`_read_utf8_with_fallback`, but for the :meth:`RawConfigParser.read` method. This method may call ``cfg.clear()``. r r r" N)r% r r& r' �clear)r* r r# r r r � _cfg_read_utf8_with_fallbackC s �r, c @ s e Zd ZdZdZdS )r& zZ `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`. a� Fallback behavior for UTF-8 is considered **deprecated** and future versions of `setuptools` may not implement it. Please encode {file!r} with "utf-8" to ensure future builds will succeed. If this file was produced by `setuptools` itself, cleaning up the cached files and re-building/re-installing the package with a newer version of `setuptools` (e.g. by updating `build-system.requires` in its `pyproject.toml`) might solve the problem. N)�__name__� __module__� __qualname__�_SUMMARY�_DETAILSr r r r r& S s r& )r r � configparserr �compatr �warningsr r r r �LOCALE_ENCODINGr r) r, r& r r r r �<module> s$ ��� � __pycache__/_normalization.cpython-310.pyc 0000644 00000012674 15030122015 0014501 0 ustar 00 o �h� � @ sB d Z ddlZddlmZ ddlZe�dej�Ze�dej�Ze�dej�Z e�dej�Z de d e fd d �Z d e d e fd d�Z de d e fdd�Zde d e fdd�Zde d e fdd�Zde d e fdd�Zde d e fdd�Zde d e fd d �Zde d e fd d �Zd e d e fd!d"�Zz dd#lmZ W dS ey� es�eZY dS Y dS w )$zZ Helpers for normalization as expected in wheel/sdist/module file names and core metadata � N)� TYPE_CHECKINGz)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$z [^A-Z0-9._-]+z [^A-Z0-9]+z,^v?(?P<safe>(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)�name�returnc C s t �dd| �}|�� s J �|S )z�Make a string safe to be used as Python identifier. >>> safe_identifier("12abc") '_12abc' >>> safe_identifier("__editable__.myns.pkg-78.9.3_local") '__editable___myns_pkg_78_9_3_local' z \W|^(?=\d)�_)�re�sub� isidentifier)r �safe� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_normalization.py�safe_identifier s r � componentc C s t �d| �S )z�Escape a component used as a project name according to Core Metadata. >>> safe_name("hello world") 'hello-world' >>> safe_name("hello?world") 'hello-world' >>> safe_name("hello_world") 'hello_world' �-)�_UNSAFE_NAME_CHARSr )r r r r � safe_name s r �versionc C sR | � dd�}z ttj�|��W S tjjy( t�d|�}ttj�|�� Y S w )a� Convert an arbitrary string into a valid version string. Can still raise an ``InvalidVersion`` exception. To avoid exceptions use ``best_effort_version``. >>> safe_version("1988 12 25") '1988.12.25' >>> safe_version("v0.2.1") '0.2.1' >>> safe_version("v0.2?beta") '0.2b0' >>> safe_version("v0.2 beta") '0.2b0' >>> safe_version("ubuntu lts") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts' � �.r )�replace�str� packagingr �Version�InvalidVersionr r )r �v�attemptr r r � safe_version+ s �r c C s� zt | �W S tjjyH | �dd�}t�|�}|r(|d }|t|�d� }nd}| }t� d|�� d�}d|� �� d�}t |� d|� �� Y S w )a� Convert an arbitrary string into a version-like string. Fallback when ``safe_version`` is not safe enough. >>> best_effort_version("v0.2 beta") '0.2b0' >>> best_effort_version("ubuntu lts") '0.dev0+sanitized.ubuntu.lts' >>> best_effort_version("0.23ubuntu1") '0.23.dev0+sanitized.ubuntu1' >>> best_effort_version("0.23-") '0.23.dev0+sanitized' >>> best_effort_version("0.-_") '0.dev0+sanitized' >>> best_effort_version("42.+?1") '42.dev0+sanitized.1' r r r N�0z sanitized.z.dev0+) r r r r r �_PEP440_FALLBACK�search�len�_NON_ALPHANUMERICr �strip)r r �matchr �rest� safe_rest�localr r r �best_effort_versionD s �r& �extrac C s t �d| ��d��� S )z�Normalize extra name according to PEP 685 >>> safe_extra("_FrIeNdLy-._.-bArD") 'friendly-bard' >>> safe_extra("FrIeNdLy-._.-bArD__._-") 'friendly-bard' r )r r r! �lower)r' r r r � safe_extrae s r) �valuec C s | � dd��d�S )z�Normalize each component of a filename (e.g. distribution/version part of wheel) Note: ``value`` needs to be already normalized. >>> filename_component("my-pkg") 'my_pkg' r r )r r! �r* r r r �filename_componento s r, c C s | � dd�S )a Produce the incorrect filename component for compatibility. See pypa/setuptools#4167 for detailed analysis. TODO: replace this with filename_component after pip 24 is nearly-ubiquitous. >>> filename_component_broken('foo_bar-baz') 'foo-bar-baz' r r )r r+ r r r �filename_component_brokenx s r- c C s t �ddt| ���� �dd�S )zBLike ``safe_name`` but can be used as filename component for wheelz[-_.]+r r )r r r r( r r+ r r r � safer_name� s �r. c C s t t| ��S )zLLike ``best_effort_version`` but can be used as filename component for wheel)r, r& r+ r r r �safer_best_effort_version� s r/ � expressionc C s t d��)a Defer import error to affect only users that actually use it https://github.com/pypa/setuptools/issues/4894 >>> _missing_canonicalize_license_expression("a OR b") Traceback (most recent call last): ... ImportError: ...Cannot import `packaging.licenses`... z�Cannot import `packaging.licenses`. Setuptools>=77.0.0 requires "packaging>=24.2" to work properly. Please make sure you have a suitable version installed. )� ImportError)r0 r r r �(_missing_canonicalize_license_expression� s �r2 )� canonicalize_license_expression)�__doc__r �typingr r �compile�I� _VALID_NAMEr r r r r r r r& r) r, r- r. r/ r2 �packaging.licensesr3 � _canonicalize_license_expressionr1 r r r r �<module> s2 ! �� _imp.py 0000644 00000004603 15030122015 0006032 0 ustar 00 """ Re-implementation of find_module and get_frozen_object from the deprecated imp module. """ import importlib.machinery import importlib.util import os import tokenize from importlib.util import module_from_spec PY_SOURCE = 1 PY_COMPILED = 2 C_EXTENSION = 3 C_BUILTIN = 6 PY_FROZEN = 7 def find_spec(module, paths): finder = ( importlib.machinery.PathFinder().find_spec if isinstance(paths, list) else importlib.util.find_spec ) return finder(module, paths) def find_module(module, paths=None): """Just like 'imp.find_module()', but with package support""" spec = find_spec(module, paths) if spec is None: raise ImportError(f"Can't find {module}") if not spec.has_location and hasattr(spec, 'submodule_search_locations'): spec = importlib.util.spec_from_loader('__init__.py', spec.loader) kind = -1 file = None static = isinstance(spec.loader, type) if ( spec.origin == 'frozen' or static and issubclass(spec.loader, importlib.machinery.FrozenImporter) ): kind = PY_FROZEN path = None # imp compabilty suffix = mode = '' # imp compatibility elif ( spec.origin == 'built-in' or static and issubclass(spec.loader, importlib.machinery.BuiltinImporter) ): kind = C_BUILTIN path = None # imp compabilty suffix = mode = '' # imp compatibility elif spec.has_location: path = spec.origin suffix = os.path.splitext(path)[1] mode = 'r' if suffix in importlib.machinery.SOURCE_SUFFIXES else 'rb' if suffix in importlib.machinery.SOURCE_SUFFIXES: kind = PY_SOURCE file = tokenize.open(path) elif suffix in importlib.machinery.BYTECODE_SUFFIXES: kind = PY_COMPILED file = open(path, 'rb') elif suffix in importlib.machinery.EXTENSION_SUFFIXES: kind = C_EXTENSION else: path = None suffix = mode = '' return file, path, (suffix, mode, kind) def get_frozen_object(module, paths=None): spec = find_spec(module, paths) if not spec: raise ImportError(f"Can't find {module}") return spec.loader.get_code(module) def get_module(module, paths, info): spec = find_spec(module, paths) if not spec: raise ImportError(f"Can't find {module}") return module_from_spec(spec) archive_util.py 0000644 00000016274 15030122015 0007573 0 ustar 00 """Utilities for extracting common archive formats""" import contextlib import os import posixpath import shutil import tarfile import zipfile from ._path import ensure_directory from distutils.errors import DistutilsError __all__ = [ "unpack_archive", "unpack_zipfile", "unpack_tarfile", "default_filter", "UnrecognizedFormat", "extraction_drivers", "unpack_directory", ] class UnrecognizedFormat(DistutilsError): """Couldn't recognize the archive type""" def default_filter(src, dst): """The default progress/filter callback; returns True for all files""" return dst def unpack_archive( filename, extract_dir, progress_filter=default_filter, drivers=None ) -> None: """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat`` `progress_filter` is a function taking two arguments: a source path internal to the archive ('/'-separated), and a filesystem path where it will be extracted. The callback must return the desired extract path (which may be the same as the one passed in), or else ``None`` to skip that file or directory. The callback can thus be used to report on the progress of the extraction, as well as to filter the items extracted or alter their extraction paths. `drivers`, if supplied, must be a non-empty sequence of functions with the same signature as this function (minus the `drivers` argument), that raise ``UnrecognizedFormat`` if they do not support extracting the designated archive type. The `drivers` are tried in sequence until one is found that does not raise an error, or until all are exhausted (in which case ``UnrecognizedFormat`` is raised). If you do not supply a sequence of drivers, the module's ``extraction_drivers`` constant will be used, which means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that order. """ for driver in drivers or extraction_drivers: try: driver(filename, extract_dir, progress_filter) except UnrecognizedFormat: continue else: return else: raise UnrecognizedFormat(f"Not a recognized archive type: {filename}") def unpack_directory(filename, extract_dir, progress_filter=default_filter) -> None: """ "Unpack" a directory, using the same interface as for archives Raises ``UnrecognizedFormat`` if `filename` is not a directory """ if not os.path.isdir(filename): raise UnrecognizedFormat(f"{filename} is not a directory") paths = { filename: ('', extract_dir), } for base, dirs, files in os.walk(filename): src, dst = paths[base] for d in dirs: paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d) for f in files: target = os.path.join(dst, f) target = progress_filter(src + f, target) if not target: # skip non-files continue ensure_directory(target) f = os.path.join(base, f) shutil.copyfile(f, target) shutil.copystat(f, target) def unpack_zipfile(filename, extract_dir, progress_filter=default_filter) -> None: """Unpack zip `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined by ``zipfile.is_zipfile()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. """ if not zipfile.is_zipfile(filename): raise UnrecognizedFormat(f"{filename} is not a zip file") with zipfile.ZipFile(filename) as z: _unpack_zipfile_obj(z, extract_dir, progress_filter) def _unpack_zipfile_obj(zipfile_obj, extract_dir, progress_filter=default_filter): """Internal/private API used by other parts of setuptools. Similar to ``unpack_zipfile``, but receives an already opened :obj:`zipfile.ZipFile` object instead of a filename. """ for info in zipfile_obj.infolist(): name = info.filename # don't extract absolute paths or ones with .. in them if name.startswith('/') or '..' in name.split('/'): continue target = os.path.join(extract_dir, *name.split('/')) target = progress_filter(name, target) if not target: continue if name.endswith('/'): # directory ensure_directory(target) else: # file ensure_directory(target) data = zipfile_obj.read(info.filename) with open(target, 'wb') as f: f.write(data) unix_attributes = info.external_attr >> 16 if unix_attributes: os.chmod(target, unix_attributes) def _resolve_tar_file_or_dir(tar_obj, tar_member_obj): """Resolve any links and extract link targets as normal files.""" while tar_member_obj is not None and ( tar_member_obj.islnk() or tar_member_obj.issym() ): linkpath = tar_member_obj.linkname if tar_member_obj.issym(): base = posixpath.dirname(tar_member_obj.name) linkpath = posixpath.join(base, linkpath) linkpath = posixpath.normpath(linkpath) tar_member_obj = tar_obj._getmember(linkpath) is_file_or_dir = tar_member_obj is not None and ( tar_member_obj.isfile() or tar_member_obj.isdir() ) if is_file_or_dir: return tar_member_obj raise LookupError('Got unknown file type') def _iter_open_tar(tar_obj, extract_dir, progress_filter): """Emit member-destination pairs from a tar archive.""" # don't do any chowning! tar_obj.chown = lambda *args: None with contextlib.closing(tar_obj): for member in tar_obj: name = member.name # don't extract absolute paths or ones with .. in them if name.startswith('/') or '..' in name.split('/'): continue prelim_dst = os.path.join(extract_dir, *name.split('/')) try: member = _resolve_tar_file_or_dir(tar_obj, member) except LookupError: continue final_dst = progress_filter(name, prelim_dst) if not final_dst: continue if final_dst.endswith(os.sep): final_dst = final_dst[:-1] yield member, final_dst def unpack_tarfile(filename, extract_dir, progress_filter=default_filter) -> bool: """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir` Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined by ``tarfile.open()``). See ``unpack_archive()`` for an explanation of the `progress_filter` argument. """ try: tarobj = tarfile.open(filename) except tarfile.TarError as e: raise UnrecognizedFormat( f"{filename} is not a compressed or uncompressed tar file" ) from e for member, final_dst in _iter_open_tar( tarobj, extract_dir, progress_filter, ): try: # XXX Ugh tarobj._extract_member(member, final_dst) except tarfile.ExtractError: # chown/chmod/mkfifo/mknode/makedev failed pass return True extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile logging.py 0000644 00000002355 15030122015 0006536 0 ustar 00 import inspect import logging import sys from . import monkey import distutils.log def _not_warning(record): return record.levelno < logging.WARNING def configure() -> None: """ Configure logging to emit warning and above to stderr and everything else to stdout. This behavior is provided for compatibility with distutils.log but may change in the future. """ err_handler = logging.StreamHandler() err_handler.setLevel(logging.WARNING) out_handler = logging.StreamHandler(sys.stdout) out_handler.addFilter(_not_warning) handlers = err_handler, out_handler logging.basicConfig( format="{message}", style='{', handlers=handlers, level=logging.DEBUG ) if inspect.ismodule(distutils.dist.log): monkey.patch_func(set_threshold, distutils.log, 'set_threshold') # For some reason `distutils.log` module is getting cached in `distutils.dist` # and then loaded again when patched, # implying: id(distutils.log) != id(distutils.dist.log). # Make sure the same module object is used everywhere: distutils.dist.log = distutils.log def set_threshold(level: int) -> int: logging.root.setLevel(level * 10) return set_threshold.unpatched(level) _importlib.py 0000644 00000000337 15030122015 0007246 0 ustar 00 import sys if sys.version_info < (3, 10): import importlib_metadata as metadata # pragma: no cover else: import importlib.metadata as metadata # noqa: F401 import importlib.resources as resources # noqa: F401 _core_metadata.py 0000644 00000027312 15030122015 0010037 0 ustar 00 """ Handling of Core Metadata for Python packages (including reading and writing). See: https://packaging.python.org/en/latest/specifications/core-metadata/ """ from __future__ import annotations import os import stat import textwrap from email import message_from_file from email.message import Message from tempfile import NamedTemporaryFile from packaging.markers import Marker from packaging.requirements import Requirement from packaging.utils import canonicalize_name, canonicalize_version from packaging.version import Version from . import _normalization, _reqs from ._static import is_static from .warnings import SetuptoolsDeprecationWarning from distutils.util import rfc822_escape def get_metadata_version(self): mv = getattr(self, 'metadata_version', None) if mv is None: mv = Version('2.4') self.metadata_version = mv return mv def rfc822_unescape(content: str) -> str: """Reverse RFC-822 escaping by removing leading whitespaces from content.""" lines = content.splitlines() if len(lines) == 1: return lines[0].lstrip() return '\n'.join((lines[0].lstrip(), textwrap.dedent('\n'.join(lines[1:])))) def _read_field_from_msg(msg: Message, field: str) -> str | None: """Read Message header field.""" value = msg[field] if value == 'UNKNOWN': return None return value def _read_field_unescaped_from_msg(msg: Message, field: str) -> str | None: """Read Message header field and apply rfc822_unescape.""" value = _read_field_from_msg(msg, field) if value is None: return value return rfc822_unescape(value) def _read_list_from_msg(msg: Message, field: str) -> list[str] | None: """Read Message header field and return all results as list.""" values = msg.get_all(field, None) if values == []: return None return values def _read_payload_from_msg(msg: Message) -> str | None: value = str(msg.get_payload()).strip() if value == 'UNKNOWN' or not value: return None return value def read_pkg_file(self, file): """Reads the metadata values from a file object.""" msg = message_from_file(file) self.metadata_version = Version(msg['metadata-version']) self.name = _read_field_from_msg(msg, 'name') self.version = _read_field_from_msg(msg, 'version') self.description = _read_field_from_msg(msg, 'summary') # we are filling author only. self.author = _read_field_from_msg(msg, 'author') self.maintainer = None self.author_email = _read_field_from_msg(msg, 'author-email') self.maintainer_email = None self.url = _read_field_from_msg(msg, 'home-page') self.download_url = _read_field_from_msg(msg, 'download-url') self.license = _read_field_unescaped_from_msg(msg, 'license') self.license_expression = _read_field_unescaped_from_msg(msg, 'license-expression') self.long_description = _read_field_unescaped_from_msg(msg, 'description') if self.long_description is None and self.metadata_version >= Version('2.1'): self.long_description = _read_payload_from_msg(msg) self.description = _read_field_from_msg(msg, 'summary') if 'keywords' in msg: self.keywords = _read_field_from_msg(msg, 'keywords').split(',') self.platforms = _read_list_from_msg(msg, 'platform') self.classifiers = _read_list_from_msg(msg, 'classifier') # PEP 314 - these fields only exist in 1.1 if self.metadata_version == Version('1.1'): self.requires = _read_list_from_msg(msg, 'requires') self.provides = _read_list_from_msg(msg, 'provides') self.obsoletes = _read_list_from_msg(msg, 'obsoletes') else: self.requires = None self.provides = None self.obsoletes = None self.license_files = _read_list_from_msg(msg, 'license-file') def single_line(val): """ Quick and dirty validation for Summary pypa/setuptools#1390. """ if '\n' in val: # TODO: Replace with `raise ValueError("newlines not allowed")` # after reviewing #2893. msg = "newlines are not allowed in `summary` and will break in the future" SetuptoolsDeprecationWarning.emit("Invalid config.", msg) # due_date is undefined. Controversial change, there was a lot of push back. val = val.strip().split('\n')[0] return val def write_pkg_info(self, base_dir): """Write the PKG-INFO file into the release tree.""" temp = "" final = os.path.join(base_dir, 'PKG-INFO') try: # Use a temporary file while writing to avoid race conditions # (e.g. `importlib.metadata` reading `.egg-info/PKG-INFO`): with NamedTemporaryFile("w", encoding="utf-8", dir=base_dir, delete=False) as f: temp = f.name self.write_pkg_file(f) permissions = stat.S_IMODE(os.lstat(temp).st_mode) os.chmod(temp, permissions | stat.S_IRGRP | stat.S_IROTH) os.replace(temp, final) # atomic operation. finally: if temp and os.path.exists(temp): os.remove(temp) # Based on Python 3.5 version def write_pkg_file(self, file): # noqa: C901 # is too complex (14) # FIXME """Write the PKG-INFO format data to a file object.""" version = self.get_metadata_version() def write_field(key, value): file.write(f"{key}: {value}\n") write_field('Metadata-Version', str(version)) write_field('Name', self.get_name()) write_field('Version', self.get_version()) summary = self.get_description() if summary: write_field('Summary', single_line(summary)) optional_fields = ( ('Home-page', 'url'), ('Download-URL', 'download_url'), ('Author', 'author'), ('Author-email', 'author_email'), ('Maintainer', 'maintainer'), ('Maintainer-email', 'maintainer_email'), ) for field, attr in optional_fields: attr_val = getattr(self, attr, None) if attr_val is not None: write_field(field, attr_val) if license_expression := self.license_expression: write_field('License-Expression', license_expression) elif license := self.get_license(): write_field('License', rfc822_escape(license)) for label, url in self.project_urls.items(): write_field('Project-URL', f'{label}, {url}') keywords = ','.join(self.get_keywords()) if keywords: write_field('Keywords', keywords) platforms = self.get_platforms() or [] for platform in platforms: write_field('Platform', platform) self._write_list(file, 'Classifier', self.get_classifiers()) # PEP 314 self._write_list(file, 'Requires', self.get_requires()) self._write_list(file, 'Provides', self.get_provides()) self._write_list(file, 'Obsoletes', self.get_obsoletes()) # Setuptools specific for PEP 345 if hasattr(self, 'python_requires'): write_field('Requires-Python', self.python_requires) # PEP 566 if self.long_description_content_type: write_field('Description-Content-Type', self.long_description_content_type) safe_license_files = map(_safe_license_file, self.license_files or []) self._write_list(file, 'License-File', safe_license_files) _write_requirements(self, file) for field, attr in _POSSIBLE_DYNAMIC_FIELDS.items(): if (val := getattr(self, attr, None)) and not is_static(val): write_field('Dynamic', field) long_description = self.get_long_description() if long_description: file.write(f"\n{long_description}") if not long_description.endswith("\n"): file.write("\n") def _write_requirements(self, file): for req in _reqs.parse(self.install_requires): file.write(f"Requires-Dist: {req}\n") processed_extras = {} for augmented_extra, reqs in self.extras_require.items(): # Historically, setuptools allows "augmented extras": `<extra>:<condition>` unsafe_extra, _, condition = augmented_extra.partition(":") unsafe_extra = unsafe_extra.strip() extra = _normalization.safe_extra(unsafe_extra) if extra: _write_provides_extra(file, processed_extras, extra, unsafe_extra) for req in _reqs.parse_strings(reqs): r = _include_extra(req, extra, condition.strip()) file.write(f"Requires-Dist: {r}\n") return processed_extras def _include_extra(req: str, extra: str, condition: str) -> Requirement: r = Requirement(req) # create a fresh object that can be modified parts = ( f"({r.marker})" if r.marker else None, f"({condition})" if condition else None, f"extra == {extra!r}" if extra else None, ) r.marker = Marker(" and ".join(x for x in parts if x)) return r def _write_provides_extra(file, processed_extras, safe, unsafe): previous = processed_extras.get(safe) if previous == unsafe: SetuptoolsDeprecationWarning.emit( 'Ambiguity during "extra" normalization for dependencies.', f""" {previous!r} and {unsafe!r} normalize to the same value:\n {safe!r}\n In future versions, setuptools might halt the build process. """, see_url="https://peps.python.org/pep-0685/", ) else: processed_extras[safe] = unsafe file.write(f"Provides-Extra: {safe}\n") # from pypa/distutils#244; needed only until that logic is always available def get_fullname(self): return _distribution_fullname(self.get_name(), self.get_version()) def _distribution_fullname(name: str, version: str) -> str: """ >>> _distribution_fullname('setup.tools', '1.0-2') 'setup_tools-1.0.post2' >>> _distribution_fullname('setup-tools', '1.2post2') 'setup_tools-1.2.post2' >>> _distribution_fullname('setup-tools', '1.0-r2') 'setup_tools-1.0.post2' >>> _distribution_fullname('setup.tools', '1.0.post') 'setup_tools-1.0.post0' >>> _distribution_fullname('setup.tools', '1.0+ubuntu-1') 'setup_tools-1.0+ubuntu.1' """ return "{}-{}".format( canonicalize_name(name).replace('-', '_'), canonicalize_version(version, strip_trailing_zero=False), ) def _safe_license_file(file): # XXX: Do we need this after the deprecation discussed in #4892, #4896?? normalized = os.path.normpath(file).replace(os.sep, "/") if "../" in normalized: return os.path.basename(normalized) # Temporarily restore pre PEP639 behaviour return normalized _POSSIBLE_DYNAMIC_FIELDS = { # Core Metadata Field x related Distribution attribute "author": "author", "author-email": "author_email", "classifier": "classifiers", "description": "long_description", "description-content-type": "long_description_content_type", "download-url": "download_url", "home-page": "url", "keywords": "keywords", "license": "license", # XXX: License-File is complicated because the user gives globs that are expanded # during the build. Without special handling it is likely always # marked as Dynamic, which is an acceptable outcome according to: # https://github.com/pypa/setuptools/issues/4629#issuecomment-2331233677 "license-file": "license_files", "license-expression": "license_expression", # PEP 639 "maintainer": "maintainer", "maintainer-email": "maintainer_email", "obsoletes": "obsoletes", # "obsoletes-dist": "obsoletes_dist", # NOT USED "platform": "platforms", "project-url": "project_urls", "provides": "provides", # "provides-dist": "provides_dist", # NOT USED "provides-extra": "extras_require", "requires": "requires", "requires-dist": "install_requires", # "requires-external": "requires_external", # NOT USED "requires-python": "python_requires", "summary": "description", # "supported-platform": "supported_platforms", # NOT USED } sandbox.py 0000644 00000035072 15030122015 0006550 0 ustar 00 from __future__ import annotations import builtins import contextlib import functools import itertools import operator import os import pickle import re import sys import tempfile import textwrap from types import TracebackType from typing import TYPE_CHECKING, Any, ClassVar import pkg_resources from pkg_resources import working_set from distutils.errors import DistutilsError if TYPE_CHECKING: import os as _os elif sys.platform.startswith('java'): import org.python.modules.posix.PosixModule as _os # pyright: ignore[reportMissingImports] else: _os = sys.modules[os.name] _open = open if TYPE_CHECKING: from typing_extensions import Self __all__ = [ "AbstractSandbox", "DirectorySandbox", "SandboxViolation", "run_setup", ] def _execfile(filename, globals, locals=None): """ Python 3 implementation of execfile. """ mode = 'rb' with open(filename, mode) as stream: script = stream.read() if locals is None: locals = globals code = compile(script, filename, 'exec') exec(code, globals, locals) @contextlib.contextmanager def save_argv(repl=None): saved = sys.argv[:] if repl is not None: sys.argv[:] = repl try: yield saved finally: sys.argv[:] = saved @contextlib.contextmanager def save_path(): saved = sys.path[:] try: yield saved finally: sys.path[:] = saved @contextlib.contextmanager def override_temp(replacement): """ Monkey-patch tempfile.tempdir with replacement, ensuring it exists """ os.makedirs(replacement, exist_ok=True) saved = tempfile.tempdir tempfile.tempdir = replacement try: yield finally: tempfile.tempdir = saved @contextlib.contextmanager def pushd(target): saved = os.getcwd() os.chdir(target) try: yield saved finally: os.chdir(saved) class UnpickleableException(Exception): """ An exception representing another Exception that could not be pickled. """ @staticmethod def dump(type, exc): """ Always return a dumped (pickled) type and exc. If exc can't be pickled, wrap it in UnpickleableException first. """ try: return pickle.dumps(type), pickle.dumps(exc) except Exception: # get UnpickleableException inside the sandbox from setuptools.sandbox import UnpickleableException as cls return cls.dump(cls, cls(repr(exc))) class ExceptionSaver: """ A Context Manager that will save an exception, serialize, and restore it later. """ def __enter__(self) -> Self: return self def __exit__( self, type: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None, ) -> bool: if not exc: return False # dump the exception self._saved = UnpickleableException.dump(type, exc) self._tb = tb # suppress the exception return True def resume(self): "restore and re-raise any exception" if '_saved' not in vars(self): return _type, exc = map(pickle.loads, self._saved) raise exc.with_traceback(self._tb) @contextlib.contextmanager def save_modules(): """ Context in which imported modules are saved. Translates exceptions internal to the context into the equivalent exception outside the context. """ saved = sys.modules.copy() with ExceptionSaver() as saved_exc: yield saved sys.modules.update(saved) # remove any modules imported since del_modules = ( mod_name for mod_name in sys.modules if mod_name not in saved # exclude any encodings modules. See #285 and not mod_name.startswith('encodings.') ) _clear_modules(del_modules) saved_exc.resume() def _clear_modules(module_names): for mod_name in list(module_names): del sys.modules[mod_name] @contextlib.contextmanager def save_pkg_resources_state(): saved = pkg_resources.__getstate__() try: yield saved finally: pkg_resources.__setstate__(saved) @contextlib.contextmanager def setup_context(setup_dir): temp_dir = os.path.join(setup_dir, 'temp') with save_pkg_resources_state(): with save_modules(): with save_path(): hide_setuptools() with save_argv(): with override_temp(temp_dir): with pushd(setup_dir): # ensure setuptools commands are available __import__('setuptools') yield _MODULES_TO_HIDE = { 'setuptools', 'distutils', 'pkg_resources', 'Cython', '_distutils_hack', } def _needs_hiding(mod_name): """ >>> _needs_hiding('setuptools') True >>> _needs_hiding('pkg_resources') True >>> _needs_hiding('setuptools_plugin') False >>> _needs_hiding('setuptools.__init__') True >>> _needs_hiding('distutils') True >>> _needs_hiding('os') False >>> _needs_hiding('Cython') True """ base_module = mod_name.split('.', 1)[0] return base_module in _MODULES_TO_HIDE def hide_setuptools(): """ Remove references to setuptools' modules from sys.modules to allow the invocation to import the most appropriate setuptools. This technique is necessary to avoid issues such as #315 where setuptools upgrading itself would fail to find a function declared in the metadata. """ _distutils_hack = sys.modules.get('_distutils_hack', None) if _distutils_hack is not None: _distutils_hack._remove_shim() modules = filter(_needs_hiding, sys.modules) _clear_modules(modules) def run_setup(setup_script, args): """Run a distutils setup script, sandboxed in its directory""" setup_dir = os.path.abspath(os.path.dirname(setup_script)) with setup_context(setup_dir): try: sys.argv[:] = [setup_script] + list(args) sys.path.insert(0, setup_dir) # reset to include setup dir, w/clean callback list working_set.__init__() working_set.callbacks.append(lambda dist: dist.activate()) with DirectorySandbox(setup_dir): ns = dict(__file__=setup_script, __name__='__main__') _execfile(setup_script, ns) except SystemExit as v: if v.args and v.args[0]: raise # Normal exit, just return class AbstractSandbox: """Wrap 'os' module and 'open()' builtin for virtualizing setup scripts""" _active = False def __init__(self) -> None: self._attrs = [ name for name in dir(_os) if not name.startswith('_') and hasattr(self, name) ] def _copy(self, source): for name in self._attrs: setattr(os, name, getattr(source, name)) def __enter__(self) -> None: self._copy(self) builtins.open = self._open self._active = True def __exit__( self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, ): self._active = False builtins.open = _open self._copy(_os) def run(self, func): """Run 'func' under os sandboxing""" with self: return func() def _mk_dual_path_wrapper(name: str): # type: ignore[misc] # https://github.com/pypa/setuptools/pull/4099 original = getattr(_os, name) def wrap(self, src, dst, *args, **kw): if self._active: src, dst = self._remap_pair(name, src, dst, *args, **kw) return original(src, dst, *args, **kw) return wrap for __name in ["rename", "link", "symlink"]: if hasattr(_os, __name): locals()[__name] = _mk_dual_path_wrapper(__name) def _mk_single_path_wrapper(name: str, original=None): # type: ignore[misc] # https://github.com/pypa/setuptools/pull/4099 original = original or getattr(_os, name) def wrap(self, path, *args, **kw): if self._active: path = self._remap_input(name, path, *args, **kw) return original(path, *args, **kw) return wrap _open = _mk_single_path_wrapper('open', _open) for __name in [ "stat", "listdir", "chdir", "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "lstat", "startfile", "mkfifo", "mknod", "pathconf", "access", ]: if hasattr(_os, __name): locals()[__name] = _mk_single_path_wrapper(__name) def _mk_single_with_return(name: str): # type: ignore[misc] # https://github.com/pypa/setuptools/pull/4099 original = getattr(_os, name) def wrap(self, path, *args, **kw): if self._active: path = self._remap_input(name, path, *args, **kw) return self._remap_output(name, original(path, *args, **kw)) return original(path, *args, **kw) return wrap for __name in ['readlink', 'tempnam']: if hasattr(_os, __name): locals()[__name] = _mk_single_with_return(__name) def _mk_query(name: str): # type: ignore[misc] # https://github.com/pypa/setuptools/pull/4099 original = getattr(_os, name) def wrap(self, *args, **kw): retval = original(*args, **kw) if self._active: return self._remap_output(name, retval) return retval return wrap for __name in ['getcwd', 'tmpnam']: if hasattr(_os, __name): locals()[__name] = _mk_query(__name) def _validate_path(self, path): """Called to remap or validate any path, whether input or output""" return path def _remap_input(self, operation, path, *args, **kw): """Called for path inputs""" return self._validate_path(path) def _remap_output(self, operation, path): """Called for path outputs""" return self._validate_path(path) def _remap_pair(self, operation, src, dst, *args, **kw): """Called for path pairs like rename, link, and symlink operations""" return ( self._remap_input(operation + '-from', src, *args, **kw), self._remap_input(operation + '-to', dst, *args, **kw), ) if TYPE_CHECKING: # This is a catch-all for all the dynamically created attributes. # This isn't public API anyway def __getattribute__(self, name: str) -> Any: ... if hasattr(os, 'devnull'): _EXCEPTIONS = [os.devnull] else: _EXCEPTIONS = [] class DirectorySandbox(AbstractSandbox): """Restrict operations to a single subdirectory - pseudo-chroot""" write_ops: ClassVar[dict[str, None]] = dict.fromkeys([ "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "mkfifo", "mknod", "tempnam", ]) _exception_patterns: list[str | re.Pattern] = [] "exempt writing to paths that match the pattern" def __init__(self, sandbox, exceptions=_EXCEPTIONS) -> None: self._sandbox = os.path.normcase(os.path.realpath(sandbox)) self._prefix = os.path.join(self._sandbox, '') self._exceptions = [ os.path.normcase(os.path.realpath(path)) for path in exceptions ] AbstractSandbox.__init__(self) def _violation(self, operation, *args, **kw): from setuptools.sandbox import SandboxViolation raise SandboxViolation(operation, args, kw) def _open(self, path, mode='r', *args, **kw): if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path): self._violation("open", path, mode, *args, **kw) return _open(path, mode, *args, **kw) def tmpnam(self) -> None: self._violation("tmpnam") def _ok(self, path): active = self._active try: self._active = False realpath = os.path.normcase(os.path.realpath(path)) return ( self._exempted(realpath) or realpath == self._sandbox or realpath.startswith(self._prefix) ) finally: self._active = active def _exempted(self, filepath): start_matches = ( filepath.startswith(exception) for exception in self._exceptions ) pattern_matches = ( re.match(pattern, filepath) for pattern in self._exception_patterns ) candidates = itertools.chain(start_matches, pattern_matches) return any(candidates) def _remap_input(self, operation, path, *args, **kw): """Called for path inputs""" if operation in self.write_ops and not self._ok(path): self._violation(operation, os.path.realpath(path), *args, **kw) return path def _remap_pair(self, operation, src, dst, *args, **kw): """Called for path pairs like rename, link, and symlink operations""" if not self._ok(src) or not self._ok(dst): self._violation(operation, src, dst, *args, **kw) return (src, dst) def open(self, file, flags, mode: int = 0o777, *args, **kw) -> int: """Called for low-level os.open()""" if flags & WRITE_FLAGS and not self._ok(file): self._violation("os.open", file, flags, mode, *args, **kw) return _os.open(file, flags, mode, *args, **kw) WRITE_FLAGS = functools.reduce( operator.or_, [ getattr(_os, a, 0) for a in "O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARY".split() ], ) class SandboxViolation(DistutilsError): """A setup script attempted to modify the filesystem outside the sandbox""" tmpl = textwrap.dedent( """ SandboxViolation: {cmd}{args!r} {kwargs} The package setup script has attempted to modify files on your system that are not within the EasyInstall build area, and has been aborted. This package cannot be safely installed by EasyInstall, and may not support alternate installation locations even if you run its setup script by hand. Please inform the package's author and the EasyInstall maintainers to find out if a fix or workaround is available. """ ).lstrip() def __str__(self) -> str: cmd, args, kwargs = self.args return self.tmpl.format(**locals()) installer.py 0000644 00000011766 15030122015 0007113 0 ustar 00 from __future__ import annotations import glob import os import subprocess import sys import tempfile from functools import partial from pkg_resources import Distribution from . import _reqs from ._reqs import _StrOrIter from .warnings import SetuptoolsDeprecationWarning from .wheel import Wheel from distutils import log from distutils.errors import DistutilsError def _fixup_find_links(find_links): """Ensure find-links option end-up being a list of strings.""" if isinstance(find_links, str): return find_links.split() assert isinstance(find_links, (tuple, list)) return find_links def fetch_build_egg(dist, req): """Fetch an egg needed for building. Use pip/wheel to fetch/build a wheel.""" _DeprecatedInstaller.emit() _warn_wheel_not_available(dist) return _fetch_build_egg_no_warn(dist, req) def _fetch_build_eggs(dist, requires: _StrOrIter) -> list[Distribution]: import pkg_resources # Delay import to avoid unnecessary side-effects _DeprecatedInstaller.emit(stacklevel=3) _warn_wheel_not_available(dist) resolved_dists = pkg_resources.working_set.resolve( _reqs.parse(requires, pkg_resources.Requirement), # required for compatibility installer=partial(_fetch_build_egg_no_warn, dist), # avoid warning twice replace_conflicting=True, ) for dist in resolved_dists: pkg_resources.working_set.add(dist, replace=True) return resolved_dists def _fetch_build_egg_no_warn(dist, req): # noqa: C901 # is too complex (16) # FIXME import pkg_resources # Delay import to avoid unnecessary side-effects # Ignore environment markers; if supplied, it is required. req = strip_marker(req) # Take easy_install options into account, but do not override relevant # pip environment variables (like PIP_INDEX_URL or PIP_QUIET); they'll # take precedence. opts = dist.get_option_dict('easy_install') if 'allow_hosts' in opts: raise DistutilsError( 'the `allow-hosts` option is not supported ' 'when using pip to install requirements.' ) quiet = 'PIP_QUIET' not in os.environ and 'PIP_VERBOSE' not in os.environ if 'PIP_INDEX_URL' in os.environ: index_url = None elif 'index_url' in opts: index_url = opts['index_url'][1] else: index_url = None find_links = ( _fixup_find_links(opts['find_links'][1])[:] if 'find_links' in opts else [] ) if dist.dependency_links: find_links.extend(dist.dependency_links) eggs_dir = os.path.realpath(dist.get_egg_cache_dir()) environment = pkg_resources.Environment() for egg_dist in pkg_resources.find_distributions(eggs_dir): if egg_dist in req and environment.can_add(egg_dist): return egg_dist with tempfile.TemporaryDirectory() as tmpdir: cmd = [ sys.executable, '-m', 'pip', '--disable-pip-version-check', 'wheel', '--no-deps', '-w', tmpdir, ] if quiet: cmd.append('--quiet') if index_url is not None: cmd.extend(('--index-url', index_url)) for link in find_links or []: cmd.extend(('--find-links', link)) # If requirement is a PEP 508 direct URL, directly pass # the URL to pip, as `req @ url` does not work on the # command line. cmd.append(req.url or str(req)) try: subprocess.check_call(cmd) except subprocess.CalledProcessError as e: raise DistutilsError(str(e)) from e wheel = Wheel(glob.glob(os.path.join(tmpdir, '*.whl'))[0]) dist_location = os.path.join(eggs_dir, wheel.egg_name()) wheel.install_as_egg(dist_location) dist_metadata = pkg_resources.PathMetadata( dist_location, os.path.join(dist_location, 'EGG-INFO') ) return pkg_resources.Distribution.from_filename( dist_location, metadata=dist_metadata ) def strip_marker(req): """ Return a new requirement without the environment marker to avoid calling pip with something like `babel; extra == "i18n"`, which would always be ignored. """ import pkg_resources # Delay import to avoid unnecessary side-effects # create a copy to avoid mutating the input req = pkg_resources.Requirement.parse(str(req)) req.marker = None return req def _warn_wheel_not_available(dist): import pkg_resources # Delay import to avoid unnecessary side-effects try: pkg_resources.get_distribution('wheel') except pkg_resources.DistributionNotFound: dist.announce('WARNING: The wheel package is not available.', log.WARN) class _DeprecatedInstaller(SetuptoolsDeprecationWarning): _SUMMARY = "setuptools.installer and fetch_build_eggs are deprecated." _DETAILS = """ Requirements should be satisfied by a PEP 517 installer. If you are using pip, you can try `pip install --use-pep517`. """ # _DUE_DATE not decided yet _distutils/tests/test_build_py.py 0000644 00000015342 15030122015 0013303 0 ustar 00 """Tests for distutils.command.build_py.""" import os import sys from distutils.command.build_py import build_py from distutils.core import Distribution from distutils.errors import DistutilsFileError from distutils.tests import support import jaraco.path import pytest @support.combine_markers class TestBuildPy(support.TempdirManager): def test_package_data(self): sources = self.mkdtemp() jaraco.path.build( { '__init__.py': "# Pretend this is a package.", 'README.txt': 'Info about this package', }, sources, ) destination = self.mkdtemp() dist = Distribution({"packages": ["pkg"], "package_dir": {"pkg": sources}}) # script_name need not exist, it just need to be initialized dist.script_name = os.path.join(sources, "setup.py") dist.command_obj["build"] = support.DummyCommand( force=False, build_lib=destination ) dist.packages = ["pkg"] dist.package_data = {"pkg": ["README.txt"]} dist.package_dir = {"pkg": sources} cmd = build_py(dist) cmd.compile = True cmd.ensure_finalized() assert cmd.package_data == dist.package_data cmd.run() # This makes sure the list of outputs includes byte-compiled # files for Python modules but not for package data files # (there shouldn't *be* byte-code files for those!). assert len(cmd.get_outputs()) == 3 pkgdest = os.path.join(destination, "pkg") files = os.listdir(pkgdest) pycache_dir = os.path.join(pkgdest, "__pycache__") assert "__init__.py" in files assert "README.txt" in files if sys.dont_write_bytecode: assert not os.path.exists(pycache_dir) else: pyc_files = os.listdir(pycache_dir) assert f"__init__.{sys.implementation.cache_tag}.pyc" in pyc_files def test_empty_package_dir(self): # See bugs #1668596/#1720897 sources = self.mkdtemp() jaraco.path.build({'__init__.py': '', 'doc': {'testfile': ''}}, sources) os.chdir(sources) dist = Distribution({ "packages": ["pkg"], "package_dir": {"pkg": ""}, "package_data": {"pkg": ["doc/*"]}, }) # script_name need not exist, it just need to be initialized dist.script_name = os.path.join(sources, "setup.py") dist.script_args = ["build"] dist.parse_command_line() try: dist.run_commands() except DistutilsFileError: self.fail("failed package_data test when package_dir is ''") @pytest.mark.skipif('sys.dont_write_bytecode') def test_byte_compile(self): project_dir, dist = self.create_dist(py_modules=['boiledeggs']) os.chdir(project_dir) self.write_file('boiledeggs.py', 'import antigravity') cmd = build_py(dist) cmd.compile = True cmd.build_lib = 'here' cmd.finalize_options() cmd.run() found = os.listdir(cmd.build_lib) assert sorted(found) == ['__pycache__', 'boiledeggs.py'] found = os.listdir(os.path.join(cmd.build_lib, '__pycache__')) assert found == [f'boiledeggs.{sys.implementation.cache_tag}.pyc'] @pytest.mark.skipif('sys.dont_write_bytecode') def test_byte_compile_optimized(self): project_dir, dist = self.create_dist(py_modules=['boiledeggs']) os.chdir(project_dir) self.write_file('boiledeggs.py', 'import antigravity') cmd = build_py(dist) cmd.compile = False cmd.optimize = 1 cmd.build_lib = 'here' cmd.finalize_options() cmd.run() found = os.listdir(cmd.build_lib) assert sorted(found) == ['__pycache__', 'boiledeggs.py'] found = os.listdir(os.path.join(cmd.build_lib, '__pycache__')) expect = f'boiledeggs.{sys.implementation.cache_tag}.opt-1.pyc' assert sorted(found) == [expect] def test_dir_in_package_data(self): """ A directory in package_data should not be added to the filelist. """ # See bug 19286 sources = self.mkdtemp() jaraco.path.build( { 'pkg': { '__init__.py': '', 'doc': { 'testfile': '', # create a directory that could be incorrectly detected as a file 'otherdir': {}, }, } }, sources, ) os.chdir(sources) dist = Distribution({"packages": ["pkg"], "package_data": {"pkg": ["doc/*"]}}) # script_name need not exist, it just need to be initialized dist.script_name = os.path.join(sources, "setup.py") dist.script_args = ["build"] dist.parse_command_line() try: dist.run_commands() except DistutilsFileError: self.fail("failed package_data when data dir includes a dir") def test_dont_write_bytecode(self, caplog): # makes sure byte_compile is not used dist = self.create_dist()[1] cmd = build_py(dist) cmd.compile = True cmd.optimize = 1 old_dont_write_bytecode = sys.dont_write_bytecode sys.dont_write_bytecode = True try: cmd.byte_compile([]) finally: sys.dont_write_bytecode = old_dont_write_bytecode assert 'byte-compiling is disabled' in caplog.records[0].message def test_namespace_package_does_not_warn(self, caplog): """ Originally distutils implementation did not account for PEP 420 and included warns for package directories that did not contain ``__init__.py`` files. After the acceptance of PEP 420, these warnings don't make more sense so we want to ensure there are not displayed to not confuse the users. """ # Create a fake project structure with a package namespace: tmp = self.mkdtemp() jaraco.path.build({'ns': {'pkg': {'module.py': ''}}}, tmp) os.chdir(tmp) # Configure the package: attrs = { "name": "ns.pkg", "packages": ["ns", "ns.pkg"], "script_name": "setup.py", } dist = Distribution(attrs) # Run code paths that would trigger the trap: cmd = dist.get_command_obj("build_py") cmd.finalize_options() modules = cmd.find_all_modules() assert len(modules) == 1 module_path = modules[0][-1] assert module_path.replace(os.sep, "/") == "ns/pkg/module.py" cmd.run() assert not any( "package init file" in msg and "not found" in msg for msg in caplog.messages ) _distutils/tests/support.py 0000644 00000010003 15030122015 0012136 0 ustar 00 """Support code for distutils test cases.""" import itertools import os import pathlib import shutil import sys import sysconfig import tempfile from distutils.core import Distribution import pytest from more_itertools import always_iterable @pytest.mark.usefixtures('distutils_managed_tempdir') class TempdirManager: """ Mix-in class that handles temporary directories for test cases. """ def mkdtemp(self): """Create a temporary directory that will be cleaned up. Returns the path of the directory. """ d = tempfile.mkdtemp() self.tempdirs.append(d) return d def write_file(self, path, content='xxx'): """Writes a file in the given path. path can be a string or a sequence. """ pathlib.Path(*always_iterable(path)).write_text(content, encoding='utf-8') def create_dist(self, pkg_name='foo', **kw): """Will generate a test environment. This function creates: - a Distribution instance using keywords - a temporary directory with a package structure It returns the package directory and the distribution instance. """ tmp_dir = self.mkdtemp() pkg_dir = os.path.join(tmp_dir, pkg_name) os.mkdir(pkg_dir) dist = Distribution(attrs=kw) return pkg_dir, dist class DummyCommand: """Class to store options for retrieval via set_undefined_options().""" def __init__(self, **kwargs): vars(self).update(kwargs) def ensure_finalized(self): pass def copy_xxmodule_c(directory): """Helper for tests that need the xxmodule.c source file. Example use: def test_compile(self): copy_xxmodule_c(self.tmpdir) self.assertIn('xxmodule.c', os.listdir(self.tmpdir)) If the source file can be found, it will be copied to *directory*. If not, the test will be skipped. Errors during copy are not caught. """ shutil.copy(_get_xxmodule_path(), os.path.join(directory, 'xxmodule.c')) def _get_xxmodule_path(): source_name = 'xxmodule.c' if sys.version_info > (3, 9) else 'xxmodule-3.8.c' return os.path.join(os.path.dirname(__file__), source_name) def fixup_build_ext(cmd): """Function needed to make build_ext tests pass. When Python was built with --enable-shared on Unix, -L. is not enough to find libpython<blah>.so, because regrtest runs in a tempdir, not in the source directory where the .so lives. When Python was built with in debug mode on Windows, build_ext commands need their debug attribute set, and it is not done automatically for some reason. This function handles both of these things. Example use: cmd = build_ext(dist) support.fixup_build_ext(cmd) cmd.ensure_finalized() Unlike most other Unix platforms, Mac OS X embeds absolute paths to shared libraries into executables, so the fixup is not needed there. """ if os.name == 'nt': cmd.debug = sys.executable.endswith('_d.exe') elif sysconfig.get_config_var('Py_ENABLE_SHARED'): # To further add to the shared builds fun on Unix, we can't just add # library_dirs to the Extension() instance because that doesn't get # plumbed through to the final compiler command. runshared = sysconfig.get_config_var('RUNSHARED') if runshared is None: cmd.library_dirs = ['.'] else: if sys.platform == 'darwin': cmd.library_dirs = [] else: name, equals, value = runshared.partition('=') cmd.library_dirs = [d for d in value.split(os.pathsep) if d] def combine_markers(cls): """ pytest will honor markers as found on the class, but when markers are on multiple subclasses, only one appears. Use this decorator to combine those markers. """ cls.pytestmark = [ mark for base in itertools.chain([cls], cls.__bases__) for mark in getattr(base, 'pytestmark', []) ] return cls _distutils/tests/test_core.py 0000644 00000007365 15030122015 0012432 0 ustar 00 """Tests for distutils.core.""" import distutils.core import io import os import sys from distutils.dist import Distribution import pytest # setup script that uses __file__ setup_using___file__ = """\ __file__ from distutils.core import setup setup() """ setup_prints_cwd = """\ import os print(os.getcwd()) from distutils.core import setup setup() """ setup_does_nothing = """\ from distutils.core import setup setup() """ setup_defines_subclass = """\ from distutils.core import setup from distutils.command.install import install as _install class install(_install): sub_commands = _install.sub_commands + ['cmd'] setup(cmdclass={'install': install}) """ setup_within_if_main = """\ from distutils.core import setup def main(): return setup(name="setup_within_if_main") if __name__ == "__main__": main() """ @pytest.fixture(autouse=True) def save_stdout(monkeypatch): monkeypatch.setattr(sys, 'stdout', sys.stdout) @pytest.fixture def temp_file(tmp_path): return tmp_path / 'file' @pytest.mark.usefixtures('save_env') @pytest.mark.usefixtures('save_argv') class TestCore: def test_run_setup_provides_file(self, temp_file): # Make sure the script can use __file__; if that's missing, the test # setup.py script will raise NameError. temp_file.write_text(setup_using___file__, encoding='utf-8') distutils.core.run_setup(temp_file) def test_run_setup_preserves_sys_argv(self, temp_file): # Make sure run_setup does not clobber sys.argv argv_copy = sys.argv.copy() temp_file.write_text(setup_does_nothing, encoding='utf-8') distutils.core.run_setup(temp_file) assert sys.argv == argv_copy def test_run_setup_defines_subclass(self, temp_file): # Make sure the script can use __file__; if that's missing, the test # setup.py script will raise NameError. temp_file.write_text(setup_defines_subclass, encoding='utf-8') dist = distutils.core.run_setup(temp_file) install = dist.get_command_obj('install') assert 'cmd' in install.sub_commands def test_run_setup_uses_current_dir(self, tmp_path): """ Test that the setup script is run with the current directory as its own current directory. """ sys.stdout = io.StringIO() cwd = os.getcwd() # Create a directory and write the setup.py file there: setup_py = tmp_path / 'setup.py' setup_py.write_text(setup_prints_cwd, encoding='utf-8') distutils.core.run_setup(setup_py) output = sys.stdout.getvalue() if output.endswith("\n"): output = output[:-1] assert cwd == output def test_run_setup_within_if_main(self, temp_file): temp_file.write_text(setup_within_if_main, encoding='utf-8') dist = distutils.core.run_setup(temp_file, stop_after="config") assert isinstance(dist, Distribution) assert dist.get_name() == "setup_within_if_main" def test_run_commands(self, temp_file): sys.argv = ['setup.py', 'build'] temp_file.write_text(setup_within_if_main, encoding='utf-8') dist = distutils.core.run_setup(temp_file, stop_after="commandline") assert 'build' not in dist.have_run distutils.core.run_commands(dist) assert 'build' in dist.have_run def test_debug_mode(self, capsys, monkeypatch): # this covers the code called when DEBUG is set sys.argv = ['setup.py', '--name'] distutils.core.setup(name='bar') assert capsys.readouterr().out == 'bar\n' monkeypatch.setattr(distutils.core, 'DEBUG', True) distutils.core.setup(name='bar') wanted = "options (after parsing config files):\n" assert capsys.readouterr().out.startswith(wanted) _distutils/tests/test_text_file.py 0000644 00000006604 15030122015 0013460 0 ustar 00 """Tests for distutils.text_file.""" from distutils.tests import support from distutils.text_file import TextFile import jaraco.path import path TEST_DATA = """# test file line 3 \\ # intervening comment continues on next line """ class TestTextFile(support.TempdirManager): def test_class(self): # old tests moved from text_file.__main__ # so they are really called by the buildbots # result 1: no fancy options result1 = [ '# test file\n', '\n', 'line 3 \\\n', '# intervening comment\n', ' continues on next line\n', ] # result 2: just strip comments result2 = ["\n", "line 3 \\\n", " continues on next line\n"] # result 3: just strip blank lines result3 = [ "# test file\n", "line 3 \\\n", "# intervening comment\n", " continues on next line\n", ] # result 4: default, strip comments, blank lines, # and trailing whitespace result4 = ["line 3 \\", " continues on next line"] # result 5: strip comments and blanks, plus join lines (but don't # "collapse" joined lines result5 = ["line 3 continues on next line"] # result 6: strip comments and blanks, plus join lines (and # "collapse" joined lines result6 = ["line 3 continues on next line"] def test_input(count, description, file, expected_result): result = file.readlines() assert result == expected_result tmp_path = path.Path(self.mkdtemp()) filename = tmp_path / 'test.txt' jaraco.path.build({filename.name: TEST_DATA}, tmp_path) in_file = TextFile( filename, strip_comments=False, skip_blanks=False, lstrip_ws=False, rstrip_ws=False, ) try: test_input(1, "no processing", in_file, result1) finally: in_file.close() in_file = TextFile( filename, strip_comments=True, skip_blanks=False, lstrip_ws=False, rstrip_ws=False, ) try: test_input(2, "strip comments", in_file, result2) finally: in_file.close() in_file = TextFile( filename, strip_comments=False, skip_blanks=True, lstrip_ws=False, rstrip_ws=False, ) try: test_input(3, "strip blanks", in_file, result3) finally: in_file.close() in_file = TextFile(filename) try: test_input(4, "default processing", in_file, result4) finally: in_file.close() in_file = TextFile( filename, strip_comments=True, skip_blanks=True, join_lines=True, rstrip_ws=True, ) try: test_input(5, "join lines without collapsing", in_file, result5) finally: in_file.close() in_file = TextFile( filename, strip_comments=True, skip_blanks=True, join_lines=True, rstrip_ws=True, collapse_join=True, ) try: test_input(6, "join lines with collapsing", in_file, result6) finally: in_file.close() _distutils/tests/test_build_scripts.py 0000644 00000005500 15030122015 0014335 0 ustar 00 """Tests for distutils.command.build_scripts.""" import os import textwrap from distutils import sysconfig from distutils.command.build_scripts import build_scripts from distutils.core import Distribution from distutils.tests import support import jaraco.path class TestBuildScripts(support.TempdirManager): def test_default_settings(self): cmd = self.get_build_scripts_cmd("/foo/bar", []) assert not cmd.force assert cmd.build_dir is None cmd.finalize_options() assert cmd.force assert cmd.build_dir == "/foo/bar" def test_build(self): source = self.mkdtemp() target = self.mkdtemp() expected = self.write_sample_scripts(source) cmd = self.get_build_scripts_cmd( target, [os.path.join(source, fn) for fn in expected] ) cmd.finalize_options() cmd.run() built = os.listdir(target) for name in expected: assert name in built def get_build_scripts_cmd(self, target, scripts): import sys dist = Distribution() dist.scripts = scripts dist.command_obj["build"] = support.DummyCommand( build_scripts=target, force=True, executable=sys.executable ) return build_scripts(dist) @staticmethod def write_sample_scripts(dir): spec = { 'script1.py': textwrap.dedent(""" #! /usr/bin/env python2.3 # bogus script w/ Python sh-bang pass """).lstrip(), 'script2.py': textwrap.dedent(""" #!/usr/bin/python # bogus script w/ Python sh-bang pass """).lstrip(), 'shell.sh': textwrap.dedent(""" #!/bin/sh # bogus shell script w/ sh-bang exit 0 """).lstrip(), } jaraco.path.build(spec, dir) return list(spec) def test_version_int(self): source = self.mkdtemp() target = self.mkdtemp() expected = self.write_sample_scripts(source) cmd = self.get_build_scripts_cmd( target, [os.path.join(source, fn) for fn in expected] ) cmd.finalize_options() # https://bugs.python.org/issue4524 # # On linux-g++-32 with command line `./configure --enable-ipv6 # --with-suffix=3`, python is compiled okay but the build scripts # failed when writing the name of the executable old = sysconfig.get_config_vars().get('VERSION') sysconfig._config_vars['VERSION'] = 4 try: cmd.run() finally: if old is not None: sysconfig._config_vars['VERSION'] = old built = os.listdir(target) for name in expected: assert name in built _distutils/tests/test_build_ext.py 0000644 00000054021 15030122015 0013450 0 ustar 00 import contextlib import glob import importlib import os.path import platform import re import shutil import site import subprocess import sys import tempfile import textwrap import time from distutils import sysconfig from distutils.command.build_ext import build_ext from distutils.core import Distribution from distutils.errors import ( CompileError, DistutilsPlatformError, DistutilsSetupError, UnknownFileError, ) from distutils.extension import Extension from distutils.tests import missing_compiler_executable from distutils.tests.support import TempdirManager, copy_xxmodule_c, fixup_build_ext from io import StringIO import jaraco.path import path import pytest from test import support from .compat import py39 as import_helper @pytest.fixture() def user_site_dir(request): self = request.instance self.tmp_dir = self.mkdtemp() self.tmp_path = path.Path(self.tmp_dir) from distutils.command import build_ext orig_user_base = site.USER_BASE site.USER_BASE = self.mkdtemp() build_ext.USER_BASE = site.USER_BASE # bpo-30132: On Windows, a .pdb file may be created in the current # working directory. Create a temporary working directory to cleanup # everything at the end of the test. with self.tmp_path: yield site.USER_BASE = orig_user_base build_ext.USER_BASE = orig_user_base if sys.platform == 'cygwin': time.sleep(1) @contextlib.contextmanager def safe_extension_import(name, path): with import_helper.CleanImport(name): with extension_redirect(name, path) as new_path: with import_helper.DirsOnSysPath(new_path): yield @contextlib.contextmanager def extension_redirect(mod, path): """ Tests will fail to tear down an extension module if it's been imported. Before importing, copy the file to a temporary directory that won't be cleaned up. Yield the new path. """ if platform.system() != "Windows" and sys.platform != "cygwin": yield path return with import_helper.DirsOnSysPath(path): spec = importlib.util.find_spec(mod) filename = os.path.basename(spec.origin) trash_dir = tempfile.mkdtemp(prefix='deleteme') dest = os.path.join(trash_dir, os.path.basename(filename)) shutil.copy(spec.origin, dest) yield trash_dir # TODO: can the file be scheduled for deletion? @pytest.mark.usefixtures('user_site_dir') class TestBuildExt(TempdirManager): def build_ext(self, *args, **kwargs): return build_ext(*args, **kwargs) @pytest.mark.parametrize("copy_so", [False]) def test_build_ext(self, copy_so): missing_compiler_executable() copy_xxmodule_c(self.tmp_dir) xx_c = os.path.join(self.tmp_dir, 'xxmodule.c') xx_ext = Extension('xx', [xx_c]) if sys.platform != "win32": if not copy_so: xx_ext = Extension( 'xx', [xx_c], library_dirs=['/usr/lib'], libraries=['z'], runtime_library_dirs=['/usr/lib'], ) elif sys.platform == 'linux': libz_so = { os.path.realpath(name) for name in glob.iglob('/usr/lib*/libz.so*') } libz_so = sorted(libz_so, key=lambda lib_path: len(lib_path)) shutil.copyfile(libz_so[-1], '/tmp/libxx_z.so') xx_ext = Extension( 'xx', [xx_c], library_dirs=['/tmp'], libraries=['xx_z'], runtime_library_dirs=['/tmp'], ) dist = Distribution({'name': 'xx', 'ext_modules': [xx_ext]}) dist.package_dir = self.tmp_dir cmd = self.build_ext(dist) fixup_build_ext(cmd) cmd.build_lib = self.tmp_dir cmd.build_temp = self.tmp_dir old_stdout = sys.stdout if not support.verbose: # silence compiler output sys.stdout = StringIO() try: cmd.ensure_finalized() cmd.run() finally: sys.stdout = old_stdout with safe_extension_import('xx', self.tmp_dir): self._test_xx(copy_so) if sys.platform == 'linux' and copy_so: os.unlink('/tmp/libxx_z.so') @staticmethod def _test_xx(copy_so): import xx # type: ignore[import-not-found] # Module generated for tests for attr in ('error', 'foo', 'new', 'roj'): assert hasattr(xx, attr) assert xx.foo(2, 5) == 7 assert xx.foo(13, 15) == 28 assert xx.new().demo() is None if support.HAVE_DOCSTRINGS: doc = 'This is a template module just for instruction.' assert xx.__doc__ == doc assert isinstance(xx.Null(), xx.Null) assert isinstance(xx.Str(), xx.Str) if sys.platform == 'linux': so_headers = subprocess.check_output( ["readelf", "-d", xx.__file__], universal_newlines=True ) import pprint pprint.pprint(so_headers) rpaths = [ rpath for line in so_headers.split("\n") if "RPATH" in line or "RUNPATH" in line for rpath in line.split()[2][1:-1].split(":") ] if not copy_so: pprint.pprint(rpaths) # Linked against a library in /usr/lib{,64} assert "/usr/lib" not in rpaths and "/usr/lib64" not in rpaths else: # Linked against a library in /tmp assert "/tmp" in rpaths # The import is the real test here def test_solaris_enable_shared(self): dist = Distribution({'name': 'xx'}) cmd = self.build_ext(dist) old = sys.platform sys.platform = 'sunos' # fooling finalize_options from distutils.sysconfig import _config_vars old_var = _config_vars.get('Py_ENABLE_SHARED') _config_vars['Py_ENABLE_SHARED'] = True try: cmd.ensure_finalized() finally: sys.platform = old if old_var is None: del _config_vars['Py_ENABLE_SHARED'] else: _config_vars['Py_ENABLE_SHARED'] = old_var # make sure we get some library dirs under solaris assert len(cmd.library_dirs) > 0 def test_user_site(self): import site dist = Distribution({'name': 'xx'}) cmd = self.build_ext(dist) # making sure the user option is there options = [name for name, short, label in cmd.user_options] assert 'user' in options # setting a value cmd.user = True # setting user based lib and include lib = os.path.join(site.USER_BASE, 'lib') incl = os.path.join(site.USER_BASE, 'include') os.mkdir(lib) os.mkdir(incl) # let's run finalize cmd.ensure_finalized() # see if include_dirs and library_dirs # were set assert lib in cmd.library_dirs assert lib in cmd.rpath assert incl in cmd.include_dirs def test_optional_extension(self): # this extension will fail, but let's ignore this failure # with the optional argument. modules = [Extension('foo', ['xxx'], optional=False)] dist = Distribution({'name': 'xx', 'ext_modules': modules}) cmd = self.build_ext(dist) cmd.ensure_finalized() with pytest.raises((UnknownFileError, CompileError)): cmd.run() # should raise an error modules = [Extension('foo', ['xxx'], optional=True)] dist = Distribution({'name': 'xx', 'ext_modules': modules}) cmd = self.build_ext(dist) cmd.ensure_finalized() cmd.run() # should pass def test_finalize_options(self): # Make sure Python's include directories (for Python.h, pyconfig.h, # etc.) are in the include search path. modules = [Extension('foo', ['xxx'], optional=False)] dist = Distribution({'name': 'xx', 'ext_modules': modules}) cmd = self.build_ext(dist) cmd.finalize_options() py_include = sysconfig.get_python_inc() for p in py_include.split(os.path.pathsep): assert p in cmd.include_dirs plat_py_include = sysconfig.get_python_inc(plat_specific=True) for p in plat_py_include.split(os.path.pathsep): assert p in cmd.include_dirs # make sure cmd.libraries is turned into a list # if it's a string cmd = self.build_ext(dist) cmd.libraries = 'my_lib, other_lib lastlib' cmd.finalize_options() assert cmd.libraries == ['my_lib', 'other_lib', 'lastlib'] # make sure cmd.library_dirs is turned into a list # if it's a string cmd = self.build_ext(dist) cmd.library_dirs = f'my_lib_dir{os.pathsep}other_lib_dir' cmd.finalize_options() assert 'my_lib_dir' in cmd.library_dirs assert 'other_lib_dir' in cmd.library_dirs # make sure rpath is turned into a list # if it's a string cmd = self.build_ext(dist) cmd.rpath = f'one{os.pathsep}two' cmd.finalize_options() assert cmd.rpath == ['one', 'two'] # make sure cmd.link_objects is turned into a list # if it's a string cmd = build_ext(dist) cmd.link_objects = 'one two,three' cmd.finalize_options() assert cmd.link_objects == ['one', 'two', 'three'] # XXX more tests to perform for win32 # make sure define is turned into 2-tuples # strings if they are ','-separated strings cmd = self.build_ext(dist) cmd.define = 'one,two' cmd.finalize_options() assert cmd.define == [('one', '1'), ('two', '1')] # make sure undef is turned into a list of # strings if they are ','-separated strings cmd = self.build_ext(dist) cmd.undef = 'one,two' cmd.finalize_options() assert cmd.undef == ['one', 'two'] # make sure swig_opts is turned into a list cmd = self.build_ext(dist) cmd.swig_opts = None cmd.finalize_options() assert cmd.swig_opts == [] cmd = self.build_ext(dist) cmd.swig_opts = '1 2' cmd.finalize_options() assert cmd.swig_opts == ['1', '2'] def test_check_extensions_list(self): dist = Distribution() cmd = self.build_ext(dist) cmd.finalize_options() # 'extensions' option must be a list of Extension instances with pytest.raises(DistutilsSetupError): cmd.check_extensions_list('foo') # each element of 'ext_modules' option must be an # Extension instance or 2-tuple exts = [('bar', 'foo', 'bar'), 'foo'] with pytest.raises(DistutilsSetupError): cmd.check_extensions_list(exts) # first element of each tuple in 'ext_modules' # must be the extension name (a string) and match # a python dotted-separated name exts = [('foo-bar', '')] with pytest.raises(DistutilsSetupError): cmd.check_extensions_list(exts) # second element of each tuple in 'ext_modules' # must be a dictionary (build info) exts = [('foo.bar', '')] with pytest.raises(DistutilsSetupError): cmd.check_extensions_list(exts) # ok this one should pass exts = [('foo.bar', {'sources': [''], 'libraries': 'foo', 'some': 'bar'})] cmd.check_extensions_list(exts) ext = exts[0] assert isinstance(ext, Extension) # check_extensions_list adds in ext the values passed # when they are in ('include_dirs', 'library_dirs', 'libraries' # 'extra_objects', 'extra_compile_args', 'extra_link_args') assert ext.libraries == 'foo' assert not hasattr(ext, 'some') # 'macros' element of build info dict must be 1- or 2-tuple exts = [ ( 'foo.bar', { 'sources': [''], 'libraries': 'foo', 'some': 'bar', 'macros': [('1', '2', '3'), 'foo'], }, ) ] with pytest.raises(DistutilsSetupError): cmd.check_extensions_list(exts) exts[0][1]['macros'] = [('1', '2'), ('3',)] cmd.check_extensions_list(exts) assert exts[0].undef_macros == ['3'] assert exts[0].define_macros == [('1', '2')] def test_get_source_files(self): modules = [Extension('foo', ['xxx'], optional=False)] dist = Distribution({'name': 'xx', 'ext_modules': modules}) cmd = self.build_ext(dist) cmd.ensure_finalized() assert cmd.get_source_files() == ['xxx'] def test_unicode_module_names(self): modules = [ Extension('foo', ['aaa'], optional=False), Extension('föö', ['uuu'], optional=False), ] dist = Distribution({'name': 'xx', 'ext_modules': modules}) cmd = self.build_ext(dist) cmd.ensure_finalized() assert re.search(r'foo(_d)?\..*', cmd.get_ext_filename(modules[0].name)) assert re.search(r'föö(_d)?\..*', cmd.get_ext_filename(modules[1].name)) 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 # when the command is run dist = Distribution() cmd = self.build_ext(dist) cmd.compiler = 'unix' cmd.ensure_finalized() cmd.run() assert cmd.compiler == 'unix' def test_get_outputs(self): missing_compiler_executable() tmp_dir = self.mkdtemp() c_file = os.path.join(tmp_dir, 'foo.c') self.write_file(c_file, 'void PyInit_foo(void) {}\n') ext = Extension('foo', [c_file], optional=False) dist = Distribution({'name': 'xx', 'ext_modules': [ext]}) cmd = self.build_ext(dist) fixup_build_ext(cmd) cmd.ensure_finalized() assert len(cmd.get_outputs()) == 1 cmd.build_lib = os.path.join(self.tmp_dir, 'build') cmd.build_temp = os.path.join(self.tmp_dir, 'tempt') # issue #5977 : distutils build_ext.get_outputs # returns wrong result with --inplace other_tmp_dir = os.path.realpath(self.mkdtemp()) old_wd = os.getcwd() os.chdir(other_tmp_dir) try: cmd.inplace = True cmd.run() so_file = cmd.get_outputs()[0] finally: os.chdir(old_wd) assert os.path.exists(so_file) ext_suffix = sysconfig.get_config_var('EXT_SUFFIX') assert so_file.endswith(ext_suffix) so_dir = os.path.dirname(so_file) assert so_dir == other_tmp_dir cmd.inplace = False cmd.compiler = None cmd.run() so_file = cmd.get_outputs()[0] assert os.path.exists(so_file) assert so_file.endswith(ext_suffix) so_dir = os.path.dirname(so_file) assert so_dir == cmd.build_lib # inplace = False, cmd.package = 'bar' build_py = cmd.get_finalized_command('build_py') build_py.package_dir = {'': 'bar'} path = cmd.get_ext_fullpath('foo') # checking that the last directory is the build_dir path = os.path.split(path)[0] assert path == cmd.build_lib # inplace = True, cmd.package = 'bar' cmd.inplace = True other_tmp_dir = os.path.realpath(self.mkdtemp()) old_wd = os.getcwd() os.chdir(other_tmp_dir) try: path = cmd.get_ext_fullpath('foo') finally: os.chdir(old_wd) # checking that the last directory is bar path = os.path.split(path)[0] lastdir = os.path.split(path)[-1] assert lastdir == 'bar' def test_ext_fullpath(self): ext = sysconfig.get_config_var('EXT_SUFFIX') # building lxml.etree inplace # etree_c = os.path.join(self.tmp_dir, 'lxml.etree.c') # etree_ext = Extension('lxml.etree', [etree_c]) # dist = Distribution({'name': 'lxml', 'ext_modules': [etree_ext]}) dist = Distribution() cmd = self.build_ext(dist) cmd.inplace = True cmd.distribution.package_dir = {'': 'src'} cmd.distribution.packages = ['lxml', 'lxml.html'] curdir = os.getcwd() wanted = os.path.join(curdir, 'src', 'lxml', 'etree' + ext) path = cmd.get_ext_fullpath('lxml.etree') assert wanted == path # building lxml.etree not inplace cmd.inplace = False cmd.build_lib = os.path.join(curdir, 'tmpdir') wanted = os.path.join(curdir, 'tmpdir', 'lxml', 'etree' + ext) path = cmd.get_ext_fullpath('lxml.etree') assert wanted == path # building twisted.runner.portmap not inplace build_py = cmd.get_finalized_command('build_py') build_py.package_dir = {} cmd.distribution.packages = ['twisted', 'twisted.runner.portmap'] path = cmd.get_ext_fullpath('twisted.runner.portmap') wanted = os.path.join(curdir, 'tmpdir', 'twisted', 'runner', 'portmap' + ext) assert wanted == path # building twisted.runner.portmap inplace cmd.inplace = True path = cmd.get_ext_fullpath('twisted.runner.portmap') wanted = os.path.join(curdir, 'twisted', 'runner', 'portmap' + ext) assert wanted == path @pytest.mark.skipif('platform.system() != "Darwin"') @pytest.mark.usefixtures('save_env') def test_deployment_target_default(self): # Issue 9516: Test that, in the absence of the environment variable, # an extension module is compiled with the same deployment target as # the interpreter. self._try_compile_deployment_target('==', None) @pytest.mark.skipif('platform.system() != "Darwin"') @pytest.mark.usefixtures('save_env') def test_deployment_target_too_low(self): # Issue 9516: Test that an extension module is not allowed to be # compiled with a deployment target less than that of the interpreter. with pytest.raises(DistutilsPlatformError): self._try_compile_deployment_target('>', '10.1') @pytest.mark.skipif('platform.system() != "Darwin"') @pytest.mark.usefixtures('save_env') def test_deployment_target_higher_ok(self): # pragma: no cover # Issue 9516: Test that an extension module can be compiled with a # deployment target higher than that of the interpreter: the ext # module may depend on some newer OS feature. deptarget = sysconfig.get_config_var('MACOSX_DEPLOYMENT_TARGET') if deptarget: # increment the minor version number (i.e. 10.6 -> 10.7) deptarget = [int(x) for x in deptarget.split('.')] deptarget[-1] += 1 deptarget = '.'.join(str(i) for i in deptarget) self._try_compile_deployment_target('<', deptarget) def _try_compile_deployment_target(self, operator, target): # pragma: no cover if target is None: if os.environ.get('MACOSX_DEPLOYMENT_TARGET'): del os.environ['MACOSX_DEPLOYMENT_TARGET'] else: os.environ['MACOSX_DEPLOYMENT_TARGET'] = target jaraco.path.build( { 'deptargetmodule.c': textwrap.dedent(f"""\ #include <AvailabilityMacros.h> int dummy; #if TARGET {operator} MAC_OS_X_VERSION_MIN_REQUIRED #else #error "Unexpected target" #endif """), }, self.tmp_path, ) # get the deployment target that the interpreter was built with target = sysconfig.get_config_var('MACOSX_DEPLOYMENT_TARGET') target = tuple(map(int, target.split('.')[0:2])) # format the target value as defined in the Apple # Availability Macros. We can't use the macro names since # at least one value we test with will not exist yet. if target[:2] < (10, 10): # for 10.1 through 10.9.x -> "10n0" tmpl = '{:02}{:01}0' else: # for 10.10 and beyond -> "10nn00" if len(target) >= 2: tmpl = '{:02}{:02}00' else: # 11 and later can have no minor version (11 instead of 11.0) tmpl = '{:02}0000' target = tmpl.format(*target) deptarget_ext = Extension( 'deptarget', [self.tmp_path / 'deptargetmodule.c'], extra_compile_args=[f'-DTARGET={target}'], ) dist = Distribution({'name': 'deptarget', 'ext_modules': [deptarget_ext]}) dist.package_dir = self.tmp_dir cmd = self.build_ext(dist) cmd.build_lib = self.tmp_dir cmd.build_temp = self.tmp_dir try: old_stdout = sys.stdout if not support.verbose: # silence compiler output sys.stdout = StringIO() try: cmd.ensure_finalized() cmd.run() finally: sys.stdout = old_stdout except CompileError: self.fail("Wrong deployment target during compilation") class TestParallelBuildExt(TestBuildExt): def build_ext(self, *args, **kwargs): build_ext = super().build_ext(*args, **kwargs) build_ext.parallel = True return build_ext _distutils/tests/__pycache__/test_install_lib.cpython-310.pyc 0000644 00000006073 15030122015 0020330 0 ustar 00 o �h � @ s| d Z ddlZddlZddlZddlmZ ddlmZ ddl m Z ddl m Z ddl Z e je j�d�G dd � d e j���ZdS ) z)Tests for distutils.command.install_data.� N)� install_lib)�DistutilsOptionError)� Extension)�support�save_envc @ s@ e Zd Zdd� Zej�d�dd� �Zdd� Zdd � Z d d � Z d S ) �TestInstallLibc C s� | � � d }t|�}|�� |jdksJ �|jdks J �d|_t�t�� |�� W d � n1 s3w Y d|_t�t�� |�� W d � n1 sOw Y d|_|�� |jdksbJ �d S )N� r �foo�4�2� )� create_distr �finalize_options�compile�optimize�pytest�raisesr )�self�dist�cmd� r �_/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_install_lib.py�test_finalize_options s � �z$TestInstallLib.test_finalize_optionszsys.dont_write_bytecodec C s� | � � \}}t�|� t|�}d |_|_tj�|d�}| �|d� |� |g� t j j ddd�}t j j d|jd�}tj� |�sAJ �tj� |�sIJ �d S )Nr zfoo.pyz # python file� )� optimization)r �os�chdirr r r �path�join� write_file� byte_compile� importlib�util�cache_from_source�exists)r � project_dirr r �f�pyc_file� pyc_opt_filer r r �test_byte_compile' s �z TestInstallLib.test_byte_compilec C � | � � \}}t�|� t�d� t|�}d |_|_| �� |_tj � |dd�}| � |d� t ddg�g|j _dg|j _d|j _|�� }t|�dksMJ |��d S ) N�spamr � __init__.py�# python packager �xxx�setup.py� )r r r �mkdirr r r �mkdtemp� install_dirr r r r � distribution� ext_modules�packages� script_name� get_outputs�len)r r% r r r& �outputsr r r �test_get_outputs8 � z TestInstallLib.test_get_outputsc C r* ) Nr+ r r, r- r r. r/ r )r r r r1 r r r r2 r3 r r r r r4 r5 r6 r7 � get_inputsr9 )r r% r r r& �inputsr r r �test_get_inputsL r< z TestInstallLib.test_get_inputsc C s` | � � d }t|�}d|_d|_tj}dt_z |�g � W |t_n|t_w d|jd v s.J �d S )Nr Tzbyte-compiling is disabledr )r r r r �sys�dont_write_bytecoder �messages)r �caplogr r �old_dont_write_bytecoder r r �test_dont_write_bytecode` s z'TestInstallLib.test_dont_write_bytecodeN) �__name__� __module__� __qualname__r r �mark�skipifr) r; r? rE r r r r r s r )�__doc__�importlib.utilr! r r@ � distutils.command.install_libr �distutils.errorsr �distutils.extensionr �distutils.testsr r �combine_markersrI � usefixtures�TempdirManagerr r r r r �<module> s � _distutils/tests/__pycache__/test_clean.cpython-310.pyc 0000644 00000002461 15030122015 0017113 0 ustar 00 o �h� � @ s: d Z ddlZddlmZ ddlmZ G dd� dej�ZdS )z"Tests for distutils.command.clean.� N)�clean)�supportc @ s e Zd Zdd� ZdS )� TestCleanc s� | � � \� }t|�}� fdd�dD �}|D ]#\}}t�|� t|||� |dkr)qdD ] }| �tj�||�� q+qd|_|� � |� � |D ]\}}tj� |�rWJ |� d���qFd|_|� � |� � d S )Nc s g | ] }|t j�� |�f�qS � )�os�path�join)�.0�d��pkg_dirr �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_clean.py� <listcomp> s ��z-TestClean.test_simple_run.<locals>.<listcomp>)� build_temp� build_lib� bdist_base� build_scripts� build_baser )�one�two�three� z was not removed) � create_distr r �mkdir�setattr� write_filer r �all�ensure_finalized�run�exists)�self�dist�cmd�dirs�namer �f�_namer r r �test_simple_run s* � � zTestClean.test_simple_runN)�__name__� __module__� __qualname__r' r r r r r s r )�__doc__r �distutils.command.cleanr �distutils.testsr �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_build_scripts.cpython-310.pyc 0000644 00000006065 15030122015 0020703 0 ustar 00 o �h@ � @ sb d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl m Z ddl Z G dd� de j �ZdS ) z*Tests for distutils.command.build_scripts.� N)� sysconfig)� build_scripts)� Distribution)�supportc @ s8 e Zd Zdd� Zdd� Zdd� Zedd� �Zd d � Zd S ) �TestBuildScriptsc C sH | � dg �}|jr J �|jd u sJ �|�� |jsJ �|jdks"J �d S )Nz/foo/bar)�get_build_scripts_cmd�force� build_dir�finalize_options)�self�cmd� r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_build_scripts.py�test_default_settings s z&TestBuildScripts.test_default_settingsc sh | � � � | � � }| �� �}| �|� fdd�|D ��}|�� |�� t�|�}|D ]}||v s1J �q)d S )Nc � g | ] }t j�� |��qS r ��os�path�join��.0�fn��sourcer r � <listcomp> � z/TestBuildScripts.test_build.<locals>.<listcomp>)�mkdtemp�write_sample_scriptsr r �runr �listdir)r �target�expectedr �built�namer r r � test_build s � �zTestBuildScripts.test_buildc C s4 dd l }t� }||_tj|d|jd�|jd< t|�S )Nr T)r r � executable�build)�sysr �scriptsr � DummyCommandr% � command_objr )r r r( r' �distr r r r ' s �z&TestBuildScripts.get_build_scripts_cmdc C s@ t �d��� t �d��� t �d��� d�}tj�|| � t|�S )Nz� #! /usr/bin/env python2.3 # bogus script w/ Python sh-bang pass zy #!/usr/bin/python # bogus script w/ Python sh-bang pass zr #!/bin/sh # bogus shell script w/ sh-bang exit 0 )z script1.pyz script2.pyzshell.sh)�textwrap�dedent�lstrip�jaracor r& �list)�dir�specr r r r 1 s �z%TestBuildScripts.write_sample_scriptsc s� | � � � | � � }| �� �}| �|� fdd�|D ��}|�� t�� �d�}dtjd< z|�� W |d ur9|tjd< n |d urC|tjd< w t � |�}|D ]}||v sSJ �qKd S )Nc r r r r r r r r M r z5TestBuildScripts.test_version_int.<locals>.<listcomp>�VERSION� ) r r r r r �get_config_vars�get� _config_varsr r r )r r r! r �oldr" r# r r r �test_version_intG s( � �� �z!TestBuildScripts.test_version_intN) �__name__� __module__� __qualname__r r$ r � staticmethodr r9 r r r r r s r )�__doc__r r, � distutilsr � distutils.command.build_scriptsr �distutils.corer �distutils.testsr � jaraco.pathr/ �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_modified.cpython-310.pyc 0000644 00000010154 15030122015 0017607 0 ustar 00 o �h} � @ s� d Z ddlZddlZddlmZmZmZmZ ddlm Z ddl m Z ddl Z G dd� de j �Ze jdd � �Zd d � Zd d � ZdS )z Tests for distutils._modified.� N)�newer� newer_group�newer_pairwise�newer_pairwise_group)�DistutilsFileError)�supportc @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )� TestDepUtilc C s� | � � }tj�|d�}tj�t�}t�t�� t ||� W d � n1 s&w Y | � |� t |d�s7J �t ||�s>J �t ||�rEJ �d S )N�new� I_dont_exist) �mkdtemp�os�path�join�abspath�__file__�pytest�raisesr r � write_file)�self�tmpdir�new_file�old_file� r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_modified.py� test_newer s � zTestDepUtil.test_newerc C s� | � � }tj�|d�}tj�|d�}t�|� t�|� tj�|d�}tj�|d�}tj�t�}tj�|d�}| �|� | �|� | �|� ||||fS )N�sources�targets�one�two�four)r r r r �mkdirr r r )r r r r r r �threer r r r � _setup_1234 s zTestDepUtil._setup_1234c C s6 | � � \}}}}t||g||g�|g|gfksJ �d S �N�r" r �r r r r! r r r r �test_newer_pairwise/ s &z TestDepUtil.test_newer_pairwisec C s� | � � \}}}}t�t�� t|g||g� W d � n1 s w Y t�t�� t||g|g� W d � d S 1 s>w Y d S r# )r" r r � ValueErrorr r% r r r � test_newer_pairwise_mismatch4 s � "�z(TestDepUtil.test_newer_pairwise_mismatchc C s t g g �g g fks J �d S r# )r )r r r r �test_newer_pairwise_empty= s z%TestDepUtil.test_newer_pairwise_emptyc C s2 | � � \}}}}t||g||g�g g fksJ �d S r# r$ r% r r r �test_newer_pairwise_fresh@ s "z%TestDepUtil.test_newer_pairwise_freshc C s | � � }tj�|d�}t�|� tj�|d�}tj�|d�}tj�|d�}tj�t�}| �|� | �|� | �|� t|||g|�sDJ �t|||g|�rNJ �t� |� t � t �� t|||g|� W d � n1 skw Y t|||g|dd�r|J �t|||g|dd�s�J �d S )Nr r r r! �ignore)�missingr ) r r r r r r r r r �remover r �OSError)r r r r r r! r r r r �test_newer_groupE s$ � z TestDepUtil.test_newer_groupN) �__name__� __module__� __qualname__r r" r& r( r) r* r/ r r r r r s r c sn g d�}� fdd�|D �}t |�D ]\}}|jddd� t�|||f� qtj|dd� |d |d d� d �S ) zt Set up some older sources, a target, and newer sources. Returns a simple namespace with these values. )zolder.czolder.hztarget.oznewer.cznewer.hc s g | ]}� | �qS r r )�.0�name��tmp_pathr r � <listcomp>h s z!groups_target.<locals>.<listcomp>� zutf-8)�encodingN� � )�older�targetr )� enumerate� write_textr �utime�types�SimpleNamespace)r6 � filenames�paths�mtimer r r5 r � groups_target` s $rF c C sP t | jg| jg�}t | jg| jg�}|g g fksJ �|| jg| jgfks&J �d S r# )r r< r= r )rF r< r r r r �test_newer_pairwise_groups s rG c C s t g t| d ��s J �dS )z4 Consider no sources and no target "newer". zdoes-not-existN)r �strr5 r r r �%test_newer_group_no_sources_no_targetz s rI )�__doc__r rA �distutils._modifiedr r r r �distutils.errorsr �distutils.testsr r �TempdirManagerr �fixturerF rG rI r r r r �<module> s T _distutils/tests/__pycache__/test_install.cpython-310.pyc 0000644 00000016365 15030122015 0017507 0 ustar 00 o �h�! � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z ddl m Z ddl mZm Z ddlmZ ddlmZ dd lmZ dd lmZmZ dd lmZ ddlZd d � Zej ej � d�G dd� dej ���Z dS )z$Tests for distutils.command.install.� N)� sysconfig)�install)� build_ext)�INSTALL_SCHEMESr )� Distribution)�DistutilsOptionError)� Extension)�missing_compiler_executable�support)�is_mingwc C s | t �d� S )N� EXT_SUFFIX)r �get_config_var)�modname� r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_install.py�_make_ext_name s r �save_envc @ sT e Zd Zejjddd�dd� �Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dS )� TestInstallz=platform.system() == "Windows" and sys.version_info > (3, 11)zpypa/distutils#148)�reasonc C s* | � � }tj�|d�}tddi�}tj�|d�|_tj|tj�|d�d�|jd< t |�}||_ |� � |j |ks:J �|j |ksAJ �dd � }tjj�d d �}tj�|d|�}||j|� ttd d�}tj�|||�} ||j| � ||j|� ||jtj�|d |d�� ||jtj�|d�� ||j|� d S )N� installation�name�foopkgzsetup.py�lib)� build_base� build_lib�buildc S s( t j�| �} t j�|�}| |ksJ �d S �N)�os�path�normpath)�got�expectedr r r � check_path8 s z=TestInstall.test_home_installation_scheme.<locals>.check_path�cpython�python� platlibdir�include�bin)�mkdtempr r �joinr � script_namer � DummyCommand� command_objr �home�ensure_finalized� install_base�install_platbase�sys�implementationr �replace� install_lib�getattr�install_platlib�install_purelib�install_headers�install_scripts� install_data) �self�builddir� destination�dist�cmdr" � impl_name�libdir� _platlibdirr% r r r � test_home_installation_scheme s6 � �z)TestInstall.test_home_installation_schemec s� � � � � _tj}tj}|�tdtj�� jd�� |�tdtj�� jd�� |�t dtj� |�t dtj� � fdd�}|�tjd|� dD ]}|t v sMJ �qEt d d i�}t |�}d d � |j D �}d |v sfJ �d|_tj�tj�rrJ �tj�tj�r{J �|�� tj�tj�s�J �tj�tj�s�J �d|jv s�J �d|jv s�J �tj�|jtj�} tjdkr�t� s�tj�tj�|�|�} tj�| d�} nt�dd�} tj�| d �} tj�| �tj�| �ks�J �d S )N� USER_BASE�B� USER_SITE�Sc s( | � d�rtj�� j| dd � �S | S )N�~� )� startswithr r r �tmpdir)r �r; r r � _expanduserV s z/TestInstall.test_user_site.<locals>._expanduser� expanduser)�nt_user� posix_userr �xxc S s g | ]\}}}|�qS r r )�.0r �short�labelr r r � <listcomp>d s z.TestInstall.test_user_site.<locals>.<listcomp>�userT�userbase�usersite�nt�Includer � )r( rK �siterF rD �setattrr r r) �install_moduler r r � user_optionsrV �existsr. � config_vars�relpathr8 r r �dirnamer �get_python_inc�normcase) r; � monkeypatch� orig_site� orig_baserM �keyr> r? �options�actual_headers� site_pathr& �expect_headersr rL r �test_user_siteK s< zTestInstall.test_user_sitec C s t ddd��}t|�}|�� |jddgksJ �|jdks J �|jdks&J �dg|_|�� |jdgks6J �|jdks=J �|jdksDJ �d |_|_|�� |jd u sUJ �|jdks\J �|jd u scJ �d|_t�t�� |�� W d � d S 1 s{w Y d S )NrQ z path,dirs)r � extra_pathr �dirsr[ zpath,dirs,again) r r �handle_extra_pathro � extra_dirs� path_file�pytest�raisesr �r; r> r? r r r �test_handle_extra_path� s( "�z"TestInstall.test_handle_extra_pathc C s� t ddi�}t|�}d|_d|_t�t�� |�� W d � n1 s$w Y d |_d|_t�t�� |�� W d � n1 sCw Y d |_d|_ t�t�� |�� W d � d S 1 scw Y d S )Nr rQ �prefix�baser- rV ) r r rx r/ rt ru r �finalize_optionsr- rV rv r r r �test_finalize_options� s" � � "�z!TestInstall.test_finalize_optionsc C s� | � � }| jdgdgd�\}}t�|� | �dd� | �dd� t|�}||jd< ||_tj� |d�|_ |� � |� � t �|j �jd d �}d d � |�� D �}dd tjj� d�ddjtjd d� � g}||ksiJ �d S )N�hello�sayhi)� py_modules�scriptszhello.pyzdef main(): print('o hai')z from hello import main; main()r �filelist�utf-8��encodingc S � g | ]}t �|�j�qS r ��pathlib�Pathr �rR �liner r r rU � � z+TestInstall.test_record.<locals>.<listcomp>zhello.z.pyc� UNKNOWN-0.0.0-py{}.{}.egg-info� )r( � create_distr �chdir� write_filer r, �rootr r) �recordr. �runr� r� � read_text� splitlinesr1 r2 � cache_tag�format� version_info)r; � install_dir� project_dirr> r? �content�foundr! r r r � test_record� s& �zTestInstall.test_recordc C s t � }|d urt�d|�d�� | �� }| jtddg�gd�\}}t�|� t� |� t |�}t� |� |� � t |�}||jd< ||jd< ||_tj�|d�|_|� � |�� t�|j�jd d �}d d � |�� D �}td�d jtjd d� � g}||ks�J �d S )NzThe z command is not foundrQ z xxmodule.c)� ext_modulesr r r� r� r� c S r� r r� r� r r r rU � r� z6TestInstall.test_record_extensions.<locals>.<listcomp>r� r� ) r rt �skipr( r� r r r� r �copy_xxmodule_cr �fixup_build_extr. r r, r� r r) r� r� r� r� r� r� r r� r1 r� ) r; r? r� r� r> � buildextcmdr� r� r! r r r �test_record_extensions� s2 � �z"TestInstall.test_record_extensionsc C s> |� tdd� |�tj� | �� tdd� |jD ��s J �d S )N�DEBUGTc s s � | ] }|j tjkr|V qd S r )�levelno�loggingr� )rR �recr r r � <genexpr>� s � z.TestInstall.test_debug_mode.<locals>.<genexpr>)r] r^ � set_levelr� r� r� �any�records)r; �caplogrf r r r �test_debug_mode� s zTestInstall.test_debug_modeN) �__name__� __module__� __qualname__rt �mark�xfailrC rn rw r{ r� r� r� r r r r r s � )7 r )!�__doc__r� r r� r\ r1 � distutilsr �distutils.commandr r^ �distutils.command.build_extr �distutils.command.installr �distutils.corer �distutils.errorsr �distutils.extensionr �distutils.testsr r �distutils.utilr rt r �combine_markersr� � usefixtures�TempdirManagerr r r r r �<module> s, � _distutils/tests/__pycache__/test_install_scripts.cpython-310.pyc 0000644 00000003225 15030122015 0021245 0 ustar 00 o �h@ � @ sR d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z G dd � d ej �Z dS ) z,Tests for distutils.command.install_scripts.� N)�install_scripts)� Distribution)�support� )�test_build_scriptsc @ s e Zd Zdd� Zdd� ZdS )�TestInstallScriptsc C s� t � }tjdd�|jd< tjdddd�|jd< t|�}|jr J �|jr%J �|jd u s,J �|jd u s3J �|� � |js<J �|jsAJ �|jdksHJ �|jdksOJ �d S )Nz/foo/bar�� build_scripts�buildz /splat/funkT�r �force� skip_build�install) r r � DummyCommand� command_objr r r � build_dir� install_dir�finalize_options)�self�dist�cmd� r �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_install_scripts.py�test_default_settings s" � z(TestInstallScripts.test_default_settingsc C s� | � � }tj�|�}| � � }t� }tj|d�|jd< tj|ddd�|jd< t|�}|� � |� � t � |�}|D ]}||v s@J �q8d S )Nr r Tr r ) �mkdtempr �TestBuildScripts�write_sample_scriptsr r r r r r �run�os�listdir)r �source�expected�targetr r � installed�namer r r �test_installation! s" � �z$TestInstallScripts.test_installationN)�__name__� __module__� __qualname__r r% r r r r r s r ) �__doc__r �!distutils.command.install_scriptsr �distutils.corer �distutils.testsr � r �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_versionpredicate.cpython-310.pyc 0000644 00000000301 15030122015 0021366 0 ustar 00 o �h � @ s d S )N� r r r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_versionpredicate.py�<module> s _distutils/tests/__pycache__/test_sysconfig.cpython-310.pyc 0000644 00000025201 15030122015 0020032 0 ustar 00 o �h�. � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddlm Z ddl m Z ddl Z ddlZddlZddlmZ ddlmZ dd � Zej�d �G d d � d ��ZdS ) z Tests for distutils.sysconfig.� N)� sysconfig)� new_compiler)� UnixCCompiler)�trim)� swap_itemc C s t j�dt|�i| � | d S )N�Makefile)�jaraco�path�buildr )�root�contents� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_sysconfig.py� _gen_makefile s r �save_envc @ sv e Zd Zdd� Zej�d�ej�d�dd� ��Zdd� Zd d � Z ej�d �ej�d �ej� d �dd� ���Z ej�d �ej�d�dd� ��Z dd� Z dd� Zej�d�ej�d�dd� ��Zdd � Zd d � Zd d � Zej�d!�d"d#� �Zej�d$�d%d&� �Zd'd(� Zd)d*� Zej�d+�ej�d�d,d-� ��Zej�d+�ej�d�ejjd.�� ej�� vd/d0�d1d2� ���Z d3d4� Z d5S )6� TestSysconfigc C � t �� }tj�|�s J �d S �N)r �get_config_h_filename�osr �isfile)�self�config_hr r r �test_get_config_h_filename s z(TestSysconfig.test_get_config_h_filenamez platform.system() == 'Windows'z$sys.implementation.name != 'cpython'c C r r )r �get_makefile_filenamer r r )r �makefiler r r �test_get_makefile_filename s z(TestSysconfig.test_get_makefile_filenamec C s t �� t j|d�ks J �d S )N)�prefix)r �get_python_lib)r �tmp_pathr r r �test_get_python_lib% s z!TestSysconfig.test_get_python_libc C s" t �� }t|t�s J �|sJ �d S r )r �get_config_vars� isinstance�dict)r �cvarsr r r �test_get_config_vars( s z"TestSysconfig.test_get_config_varszsysconfig.IS_PYPYzsysconfig.python_buildz platform.system() == "Windows"c C sJ t �t�d��}|�� sJ �|�� sJ �t �t�� �}|j�|�s#J �d S )N�srcdir) �pathlib�Pathr �get_config_var�absolute�is_dirr �parent�samefile)r r& r r r r �test_srcdir_simple- s z TestSysconfig.test_srcdir_simpleznot sysconfig.python_buildc C sL t �t�d��}|�dd�}|�� sJ �t�|�sJ �t�t|��s$J �d S )Nr& �IncludezPython.h)r' r( r r) �joinpath�is_file�_is_python_source_dir�str)r r& �Python_hr r r �test_srcdir_python_build: s z&TestSysconfig.test_srcdir_python_buildc C sN t �d�}t�d�� t �d�}W d � n1 sw Y ||ks%J �dS )zO srcdir should be independent of the current working directory r& z..N)r r) r r( )r r& �srcdir2r r r � test_srcdir_independent_of_cwdG s �z,TestSysconfig.test_srcdir_independent_of_cwdc C s� G dd� d�}ddddddd d d �}|� }t �� �!}|�� D ]\}}|�ttj||�� q t�|� W d � |S 1 s=w Y |S ) Nc @ s& e Zd ZdZejZdd� Zdd� ZdS )z2TestSysconfig.customize_compiler.<locals>.compiler�unixc S s i | _ d S r )�exes�r r r r �__init__W s z;TestSysconfig.customize_compiler.<locals>.compiler.__init__c [ s |� � D ] \}}|| j|< qd S r )�itemsr9 )r �kw�k�vr r r �set_executablesZ s �zBTestSysconfig.customize_compiler.<locals>.compiler.set_executablesN)�__name__� __module__� __qualname__� compiler_typer � executablesr; r@ r r r r �compilerS s rF �sc_ar�sc_cc�sc_cxxz --sc-arflagsz --sc-cflagsz --sc-ccshared� sc_ldshared�sc_shutil_suffix)�AR�CC�CXX�ARFLAGS�CFLAGS�CCSHARED�LDSHARED� SHLIB_SUFFIX)� contextlib� ExitStackr< � enter_contextr r � _config_vars�customize_compiler)r rF �sysconfig_vars�comp�cm�key�valuer r r rX Q s& � ��z TestSysconfig.customize_compilerz-not isinstance(new_compiler(), UnixCCompiler)�disable_macos_customizationc C s( t �� dtjd< dtjd< dtjd< dtjd< d tjd < d tjd < d tjd< dtjd< dtjd< dtjd< | �� }|jd dksCJ �|jd dksLJ �|jd dksUJ �|jd d ks^J �|jd d ksgJ �|jd dkspJ �|jd d!ksyJ �|jd"ks�J �tjd#kr�|jd$ dks�J �nd$|jvs�J �tjd= tjd= tjd= tjd= tjd = tjd = tjd= tjd= tjd= tjd= | �� }|jd d%ks�J �|jd d&ks�J �|jd d'ks�J �|jd d(ks�J �|jd d)ks�J �|jd d*ks�J �|jd d+k�sJ �|jd"k�s J �d$|jv�sJ �d S ),N�env_arrL �env_ccrM �env_cpp�CPPzenv_cxx --env-cxx-flagsrN � env_ldsharedrR z --env-ldflags�LDFLAGSz --env-arflagsrO z --env-cflagsrP z--env-cppflags�CPPFLAGS� env_ranlib�RANLIB�archiverzenv_ar --env-arflags� preprocessorzenv_cpp --env-cppflagsrF z"env_cc --env-cflags --env-cppflags� compiler_soz0env_cc --env-cflags --env-cppflags --sc-ccshared� compiler_cxxz2env_cxx --env-cxx-flags --sc-cflags --env-cppflags� linker_exe� linker_soz6env_ldshared --env-ldflags --env-cflags --env-cppflagsrK �darwin�ranlibzsc_ar --sc-arflagszsc_cc -Ezsc_cc --sc-cflagsz sc_cc --sc-cflags --sc-ccsharedzsc_cxx --sc-cflagsrH rJ ) r r! r �environrX r9 �shared_lib_extension�sys�platform)r rZ r r r �test_customize_compilerq sb ��� z%TestSysconfig.test_customize_compilerc C �* t |d�}t�|�}|ddd�ksJ �d S )Nzo CONFIG_ARGS= '--arg1=optarg1' 'ENV=LIB' VAR=$OTHER OTHER=foo z'--arg1=optarg1' 'ENV=LIB'�foo�� CONFIG_ARGS�OTHER�r r �parse_makefile�r r r �dr r r �test_parse_makefile_base� � � z&TestSysconfig.test_parse_makefile_basec C ru )Nzr CONFIG_ARGS= '--arg1=optarg1' 'ENV=\$$LIB' VAR=$OTHER OTHER=foo z '--arg1=optarg1' 'ENV=\$LIB'rv rw rz r| r r r �"test_parse_makefile_literal_dollar� r z0TestSysconfig.test_parse_makefile_literal_dollarc C s< dd l }|�d�t �d�ksJ �|�d�t �d�ks J �d S )Nr rP rd �r r) �r �global_sysconfigr r r �test_sysconfig_module� s � �z#TestSysconfig.test_sysconfig_modulez3sysconfig.get_config_var('CUSTOMIZED_OSX_COMPILER')c C sP dd l }t �d�rt�d� |�d�t �d�ksJ �|�d�t �d�ks&J �d S )Nr �CUSTOMIZED_OSX_COMPILERzcompiler flags customizedrR rM )r r) �pytest�skipr� r r r � test_sysconfig_compiler_vars� s � z*TestSysconfig.test_sysconfig_compiler_varsz*not sysconfig.get_config_var('EXT_SUFFIX')c C s: t �t�� t�d� W d � d S 1 sw Y d S )N�SO)r� �warns�DeprecationWarningr r) r: r r r �test_SO_deprecation� s "�z!TestSysconfig.test_SO_deprecationc C s^ t j�dtd�i|� tjtj|d gtjtj ddd�}|� � \}}d|j ks-J d| ��d S )N�filea[ from distutils.core import Distribution config = Distribution().get_command_obj('config') # try_compile may pass or it may fail if no compiler # is found but it should not raise an exception. rc = config.try_compile('int x;') T�utf-8)�stdout�stderr�universal_newlines�encodingr zSubprocess failed: ) r r r r � subprocess�Popenrr � executable�PIPE�STDOUT� communicate� returncode)r r �p�outs�errsr r r �.test_customize_compiler_before_get_config_vars� s � � � z<TestSysconfig.test_customize_compiler_before_get_config_varsc C s� t �� }i }t|dd��}t j||d�}W d � n1 s w Y ||u s)J �t|dd�� }t �|�}W d � n1 s?w Y t|t�sKJ �d S )Nr� )r� )�g)r r �open�parse_config_hr" r# )r r �input�f�resultr r r �test_parse_config_h s � �z!TestSysconfig.test_parse_config_hz platform.system() != 'Windows'c C s* t �d��d�s J �t �d�dksJ �d S )N� EXT_SUFFIXz.pyd)r r) �endswithr: r r r �test_win_ext_suffix s z!TestSysconfig.test_win_ext_suffixz \PCbuild\z*Need sys.executable to be in a source tree)�reasonc C sp t j�� }|j|_||_|�� |�� ddg}tj � tj � t j ��}t j|i tj�d|i�d�}|dks6J �dS )zAEnsure distutils.sysconfig detects venvs from source tree builds.z-czCimport distutils.sysconfig; print(distutils.sysconfig.python_build)� PYTHONPATH)�env�TrueN)r �envs�VEnv� clean_opts� create_optsr � ensure_env�exer r �dirname� distutils�__file__r� � check_outputrp )r r r� �cmd�distutils_path�outr r r �$test_win_build_venv_from_source_tree s ��z2TestSysconfig.test_win_build_venv_from_source_treec C s. dd� }|� td|� tj�t�� �sJ �dS )a5 In portable Python installations, the sysconfig will be broken, pointing to the directories where the installation was built and not where it currently is. In this case, ensure that the missing directory isn't used for get_python_inc. See pypa/distutils#178. c S s | dkrdS t �| �S )N� INCLUDEPYz/does-not-existr� )�namer r r �override8 s zFTestSysconfig.test_get_python_inc_missing_config_dir.<locals>.overrider) N)�setattrr r r �exists�get_python_inc)r � monkeypatchr� r r r �&test_get_python_inc_missing_config_dir. s z4TestSysconfig.test_get_python_inc_missing_config_dirN) rA rB rC r r� �mark�skipifr r r% �xfailr. r5 r7 rX � usefixturesrt r~ r� r� r� r� r� r� r� �casefoldrr r� r� r� r r r r r sN ; � r )�__doc__rT r� r r' r� rr r �distutils.ccompilerr �distutils.unixccompilerr � jaraco.envsr r r� � jaraco.textr � test.supportr r r� r� r r r r r �<module> s$ _distutils/tests/__pycache__/unix_compat.cpython-310.pyc 0000644 00000001021 15030122015 0017307 0 ustar 00 o �h� � @ s~ d dl Z z d dlZd dlZW n ey d ZZY nw d dlZeo#eZeo*e jdkZejj e dd�Z ejj e dd�Z dS )� N�cygwinz Requires grp and pwd support)�reasonzRequires UID 0 support) �sys�grp�pwd� ImportError�pytest�UNIX_ID_SUPPORT�platform� UID_0_SUPPORT�mark�skipif�require_unix_id� require_uid_0� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/unix_compat.py�<module> s �� _distutils/tests/__pycache__/test_bdist_dumb.cpython-310.pyc 0000644 00000004100 15030122015 0020135 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl Z dZ e j e j �d�e j �d�e j �d �G d d � d e j�����ZdS ) z'Tests for distutils.command.bdist_dumb.� N)� bdist_dumb)� Distribution)�supportz�from distutils.core import setup import foo setup(name='foo', version='0.1', py_modules=['foo'], url='xxx', author='xxx', author_email='xxx') �save_env� save_argv�save_cwdc @ s e Zd Zej�d�dd� �ZdS )� TestBuildDumb� needs_zlibc C sz | � � }tj�|d�}t�|� | �|dft� | �|dfd� | �|dfd� | �|dfd� tdd dgd d d d ��}d|_t� |� dgt _ t |�}d |_ |�� |�� t�tj�|d ��}|�� � d|j� d�}||gkssJ �t�tj�d |��}z |�� }W |�� n|�� w ttd ttjj|���}dj t jd d� � dg} t j s�| � dt j j � d�� |t| �ks�J �d S )N�foozsetup.pyzfoo.py�#z MANIFEST.inzinclude foo.py�README� z0.1�xxx)�name�version� py_modules�url�author� author_email�zip�dist�.z.zipzfoo-0.1-py{}.{}.egg-info� zfoo.z.pyc) �mkdtemp�os�path�join�mkdir� write_file�SETUP_PYr � script_name�chdir�sys�argvr �format�ensure_finalized�run�listdir� get_fullname� plat_name�zipfile�ZipFile�namelist�close�sorted�filter�map�basename� version_info�dont_write_bytecode�append�implementation� cache_tag) �self�tmp_dir�pkg_dirr �cmd� dist_created�base�fp�contents�wanted� r@ �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py�test_simple_built sD � z TestBuildDumb.test_simple_builtN)�__name__� __module__� __qualname__�pytest�mark� usefixturesrB r@ r@ r@ rA r s r )�__doc__r r" r* � distutils.command.bdist_dumbr �distutils.corer �distutils.testsr rF r �combine_markersrG rH �TempdirManagerr r@ r@ r@ rA �<module> s � _distutils/tests/__pycache__/test_config_cmd.cpython-310.pyc 0000644 00000005743 15030122015 0020127 0 ustar 00 o �hh � @ s� d Z ddlZddlZddlmZ ddlmZmZ ddlm Z m Z ddl Z ddl Z ddl Z e jdd�dd � �Ze jG d d � d e j��ZdS ) z#Tests for distutils.command.config.� N)�log)�config� dump_file)�missing_compiler_executable�supportT)�autousec C s | j }g |_|�td|j� d S )N�info)�instance�_logs�setattrr �_info)�request� monkeypatch�self� r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_config_cmd.py�info_log s r c @ s@ e Zd Zdd� Zdd� Zej�d�dd� �Zdd � Z d d � Z d S ) � TestConfigc G s |� � D ]}| j�|� qd S )N)� splitlinesr �append)r �msg�args�liner r r r s �zTestConfig._infoc C sj t �t��d�}|jdd�� }t�|�}W d � n1 s w Y t|d� t| j �|d ks3J �d S )Nz.pyzutf-8)�encodingzI am the header� ) �path�Path�__file__� with_suffix�open�more_itertools�ilenr �lenr )r � this_file�f�numlinesr r r �test_dump_file s � zTestConfig.test_dump_filez platform.system() == "Windows"c C s� t dg�}|d ur| �d|�d�� | �� \}}t|�}|�� |j}tjd d� dkr:d|jd � � v r:| �d� |j d d d �}|dksGJ �|j d d d �}|d ksTJ �d S )N� preprocessorzThe z command is not found� �aix�xlcr zAxlc: The -E option overrides the -P, -o, and -qsyntaxonly options�xxxz /* xxx */)�pattern�body� _configtestr ) r �skipTest� create_distr �_check_compiler�compiler�sys�platformr' �lower� search_cpp)r �cmd�pkg_dir�distr2 �matchr r r �test_search_cpp# s $� zTestConfig.test_search_cppc C sz | � � \}}t|�}dtj� d�|_d|_dtj� d�|_|�� |jddgks*J �|jdgks2J �|jddgks;J �d S )N�one�two�three�four)r0 r �os�pathsep� include_dirs� libraries� library_dirs�ensure_finalized)r r8 r9 r7 r r r �test_finalize_options8 s z TestConfig.test_finalize_optionsc C s� | � � }tj�|d�}tj�|d�}| �|d� | �|d� ||fD ] }tj�|�s,J �q"| �� \}}t|�}|�||� ||fD ] }tj�|�rKJ �qAd S )Nr< r= r+ ) �mkdtempr@ r �join� write_file�existsr0 r �_clean)r �tmp_dir�f1�f2r$ r8 r9 r7 r r r � test_cleanF s �zTestConfig.test_cleanN) �__name__� __module__� __qualname__r r& �pytest�mark�skipifr; rF rO r r r r r s r )�__doc__r@ r3 �distutils._logr �distutils.command.configr r �distutils.testsr r r r rS �fixturer �combine_markers�TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_spawn.cpython-310.pyc 0000644 00000007036 15030122015 0017164 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z m Z ddl m Z ddl Z ddlZddlmZ ddlmZ G d d � d e j�ZdS ) zTests for distutils.spawn.� N)�DistutilsExecError)�find_executable�spawn)�support)� unix_shell� )�py39c @ s< e Zd Zej�d�dd� �Zdd� Zedd� �Z dd � Z d S ) � TestSpawnz os.name not in ('nt', 'posix')c C s� | � � }tjdkrtj�|d�}| �|dt� d�� n tj�|d�}| �|d� t�|d� t � t �� t |g� W d � n1 sCw Y tjdkr_tj�|d�}| �|dt� d�� n tj�|d�}| �|d � t�|d� t |g� d S ) N�win32zfoo.shz#!z exit 1zfoo.batzexit 1i� z exit 0zexit 0) �mkdtemp�sys�platform�os�path�join� write_filer �chmod�pytest�raisesr r )�self�tmpdir�exe� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_spawn.py� test_spawn s" � zTestSpawn.test_spawnc C s� | � |d�}|j}|�d�j}t|�}t�|�}t||d�}||ks$J �tjdkr5t||d�}||ks5J �|� t|�}||ksBJ �W d � n1 sLw Y d| }t||d�}|d u saJ �t � � �`} d| d< t j d|dd ��D t � d |��. t|�}|d u s�J �|� t|�}||ks�J �W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y t � � �d} t j| d< t j dddd ��F t � d d��/ t|�}|d u s�J �|� t|�}||ks�J �W d � n 1 �s w Y W d � n 1 �sw Y W d � n 1 �s)w Y W d � n 1 �s9w Y t � � ��} | �dd � t j dtdd ��* t � d |�� t|�}||k�sdJ �W d � n 1 �sow Y W d � n 1 �sw Y t j d|dd ��* t � d d�� t|�}||k�s�J �W d � n 1 �s�w Y W d � n1 �s�w Y W d � d S W d � d S 1 �s�w Y d S ) Nz.exe� )r r � dontexist_�PATHzdistutils.spawn.os.confstrT)� return_value�createzdistutils.spawn.os.defpath)� side_effectr )�_make_executable�name� with_suffix�strr �Pathr r r � os_helper�EnvironmentVarGuard�mock�patchr �pathsep�pop� ValueError) r �tmp_path� program_path�program�program_noeext�filename�tmp_dir�rv�dont_exist_program�envr r r �test_find_executable/ s� � �� � �� �� � � � � �� �� � � �� � �� �� � �� �$�z TestSpawn.test_find_executablec C s. | � d��|�}|jddd� |�tj� |S )Nr/ r zutf-8)�encoding)�joinpathr# � write_textr �stat�S_IXUSR)r- �extr/ r r r r! � s zTestSpawn._make_executablec C sJ t �t�� }tdg� W d � n1 sw Y dt|j�v s#J �d S )Nzdoes-not-existz command 'does-not-exist' failed)r r r r r$ �value)r �ctxr r r �test_spawn_missing_exe� s �z TestSpawn.test_spawn_missing_exeN) �__name__� __module__� __qualname__r �mark�skipifr r6 � staticmethodr! r? r r r r r s R r )�__doc__r r: r � unittest.mockr( �distutils.errorsr �distutils.spawnr r �distutils.testsr r r � test.supportr �compatr r& �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_build.cpython-310.pyc 0000644 00000002674 15030122015 0017136 0 ustar 00 o �h� � @ sR d Z ddlZddlZddlmZ ddlmZ ddlmZm Z G dd� dej �Z dS )z"Tests for distutils.command.build.� N)�build)�support)�get_config_var� get_platformc @ s e Zd Zdd� ZdS )� TestBuildc C s4 | � � \}}t|�}|�� |jt� ksJ �tj�|jd�}|j |ks%J �d|j� dt j j � �}t d�r8|d7 }tt d�rI|j�d�sEJ �|d7 }tj�|jd| �}|j|ksZJ �|j|j ksbJ �tj�|jd| �}|j|kssJ �tj�|jd t jj� dt jj� ��}|j|ks�J �|jtj�t j�ks�J �d S ) N�lib�.�-�Py_GIL_DISABLED�t�gettotalrefcountz-pydebug�tempzscripts-)� create_distr �finalize_options� plat_namer �os�path�join� build_base� build_purelib�sys�implementation� cache_tagr �hasattr� build_platlib�endswith� build_lib� build_temp� version_info�major�minor� build_scripts� executable�normpath)�self�pkg_dir�dist�cmd�wanted� plat_spec� r* �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_build.py�test_finalize_options s, � z TestBuild.test_finalize_optionsN)�__name__� __module__� __qualname__r, r* r* r* r+ r s r ) �__doc__r r �distutils.command.buildr �distutils.testsr � sysconfigr r �TempdirManagerr r* r* r* r+ �<module> s _distutils/tests/__pycache__/test_install_data.cpython-310.pyc 0000644 00000003514 15030122015 0020470 0 ustar 00 o �h� � @ sV d Z ddlZddlZddlmZ ddlmZ ddlZej� d�G dd� dej ��Z dS )z)Tests for distutils.command.install_data.� N)� install_data)�support�save_envc @ s e Zd Zdd� ZdS )�TestInstallDatac C s� | � � \}}t|�}tj�|d� |_}tj�|d�}| �|d� tj�|d�}tj�|d�}| �|d� t�|�d }| �|d� |||gf|g|_ |� � |||gf|gksYJ �|� � |� � t |�� �dkskJ �tj�|�d } tj�tj�|| ��s�J �tj�|�d } tj�tj�|| ��s�J �tj�|�d } tj�tj�|| ��s�J �g |_d |_|� � |� � t |�� �dks�J �tj�tj�|| ��s�J �tj�tj�|| ��s�J �tj�tj�|| ��s�J �g |_tj�|d �|_tj�|d �} tj�|jd �} | �| d � |||gf|d | gf| g fg|_ |� � |� � t |�� �dk�s,J �tj�tj�|| ���s:J �tj�tj�|| ���sHJ �tj�tj�|| ���sVJ �d S )N�inst�one�xxx�inst2�two�three� ���T�root�inst5�four�xx� )� create_distr �os�path�join� install_dir� write_file�pathlib�Path� data_files� get_inputs�ensure_finalized�run�len� get_outputs�split�exists�outfiles�warn_dirr )�self�pkg_dir�dist�cmdr r r r r �rthree�rtwo�roner r � r, �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_install_data.py�test_simple_run sR z TestInstallData.test_simple_runN)�__name__� __module__� __qualname__r. r, r, r, r- r s r ) �__doc__r r � distutils.command.install_datar �distutils.testsr �pytest�mark� usefixtures�TempdirManagerr r, r, r, r- �<module> s � _distutils/tests/__pycache__/__init__.cpython-310.pyc 0000644 00000002743 15030122015 0016534 0 ustar 00 o �h� � @ s2 d Z ddlZddlmZ g fdee fdd�ZdS )a Test suite for distutils. Tests for the command classes in the distutils.command package are included in distutils.tests as well, instead of using a separate distutils.command.tests package, since command identification is done by import rather than matching pre-defined names. � N)�Sequence� cmd_namesc C s� ddl m}m}m} |�� }|�|� |jdkr*z|�� W n |jy) Y dS w |j D ]/}| r6|| vr6q-t ||�}| rJ|dusIJ d|� d���n|sMq-t � |d �du r\|d S q-dS )a< Check if the compiler components used to build the interpreter exist. Check for the existence of the compiler executables whose names are listed in 'cmd_names' or all the compiler executables when 'cmd_names' is empty and return the first missing executable or None when none is found missing. r )� ccompiler�errors� sysconfig�msvcNzthe 'z ' executable is not configured) � distutilsr r r � new_compiler�customize_compiler� compiler_type� initialize�DistutilsPlatformError� executables�getattr�shutil�which)r r r r �compiler�name�cmd� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/__init__.py�missing_compiler_executable s* � ��r )�__doc__r �collections.abcr �strr r r r r �<module> s _distutils/tests/__pycache__/test_extension.cpython-310.pyc 0000644 00000005066 15030122015 0020051 0 ustar 00 o �hV � @ sR d Z ddlZddlZddlZddlmZmZ ddlZddlm Z G dd� d�Z dS )z Tests for distutils.extension.� N)� Extension�read_setup_file)�check_warningsc @ s e Zd Zdd� Zdd� ZdS )� TestExtensionc C sL t j�t j�t�d�}t|�}dd� |D �}|�� g d�}||ks$J �d S )Nz Setup.samplec S s g | ]}|j �qS � )�name)�.0�extr r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_extension.py� <listcomp> s z6TestExtension.test_read_setup_file.<locals>.<listcomp>)"�_arraysurfarray�_camera�_numericsndarray�_numericsurfarray�base� bufferproxy�cdrom�color� constants�display�draw�event� fastevent�font�gfxdraw�image�imageext�joystick�key�mask�mixer� mixer_music�mouse�movie�overlay� pixelarray�pypm�rect�rwobject�scrap�surface�surflock�time� transform)�os�path�join�dirname�__file__r �sort)�self�setup�exts�names�wantedr r r �test_read_setup_file s %z"TestExtension.test_read_setup_filec C s: t �t�� tdg � W d � n1 sw Y tdg �}|jdks&J �t �t�� tdd� W d � n1 s;w Y t �t�� tdddg� W d � n1 sWw Y tdddg�}|jddgkslJ �tdt�d�t�d�g�}|jddgks�J �tdd�}|jddgks�J �tdddh�}t|j�ddgks�J �tdt ddg��}|jddgks�J �tdt�d�dg�}|jddgks�J �dD ] }t ||�g ks�J �q�|j d u s�J �|j d u s�J �t � �}t�d� tdddgd d �}W d � n1 s�w Y t|j�dk�sJ �t|jd j�d k�sJ �d S ) N� r �file�file1�file2)r< r= ) � include_dirs� define_macros� undef_macros� library_dirs� libraries�runtime_library_dirs� extra_objects�extra_compile_args�extra_link_args�export_symbols� swig_opts�depends�alwaysT)�chicr z!Unknown Extension options: 'chic')�pytest�raises� TypeErrorr r �sources�pathlib�Path�sorted�iter�getattr�language�optionalr �warnings� simplefilter�len�str�message)r4 r �attr�wr r r �test_extension_init? sB � � � � z!TestExtension.test_extension_initN)�__name__� __module__� __qualname__r9 r^ r r r r r s 2r ) �__doc__r. rP rW �distutils.extensionr r rL � test.support.warnings_helperr r r r r r �<module> s _distutils/tests/__pycache__/test_build_ext.cpython-310.pyc 0000644 00000036230 15030122015 0020011 0 ustar 00 o �hX � @ sh d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dl Z d dl Z d dlmZ d dlmZ d dlmZ d dlmZmZmZmZ d dlmZ d dlm Z d dl m Z m Z m Z d d l!m"Z" d dl#Z$d dl%Z%d dl&Z&d d l'm(Z( d d l)m*Z+ e&�,� d d� �Z-e j.dd� �Z/e j.dd� �Z0e&j1�2d�G dd� de ��Z3G dd� de3�Z4dS )� N)� sysconfig�� build_ext)� Distribution)� CompileError�DistutilsPlatformError�DistutilsSetupError�UnknownFileError)� Extension)�missing_compiler_executable)�TempdirManager�copy_xxmodule_c�fixup_build_ext)�StringIO)�support� )�py39c c s� � | j }|�� |_t�|j�|_ddlm} tj }|�� t_ tj |_ |j� d V W d � n1 s3w Y |t_ ||_ t j dkrJt � d� d S d S )Nr r �cygwinr )�instance�mkdtemp�tmp_dir�path�Path�tmp_path�distutils.commandr �site� USER_BASE�sys�platform�time�sleep)�request�selfr �orig_user_base� r$ �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_build_ext.py� user_site_dir$ s � � �r& c c s� � t �| ��> t| |�� }t �|�� d V W d � n1 s w Y W d � n1 s/w Y W d � d S W d � d S 1 sGw Y d S �N)� import_helper� CleanImport�extension_redirect� DirsOnSysPath)�namer �new_pathr$ r$ r% �safe_extension_import= s � �� ��"�r. c c s� � t �� dkrtj dkr|V dS t�|�� tj�| �}W d � n1 s'w Y tj � |j �}t j dd�}tj �|tj � |��}t�|j |� |V dS )z� Tests will fail to tear down an extension module if it's been imported. Before importing, copy the file to a temporary directory that won't be cleaned up. Yield the new path. �Windowsr N�deleteme)�prefix)r �systemr r( r+ � importlib�util� find_spec�osr �basename�origin�tempfiler �join�shutil�copy)�modr �spec�filename� trash_dir�destr$ r$ r% r* E s � � r* c @ s� e Zd Zdd� Zej�ddg�dd� �Zedd� �Z d d � Z d d � Z d d� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zej�d �ej�d �d!d"� ��Zej�d �ej�d �d#d$� ��Zej�d �ej�d �d%d&� ��Zd'd(� Zd)S )*� TestBuildExtc O s t |i |��S r' r )r" �args�kwargsr$ r$ r% r \ s zTestBuildExt.build_ext�copy_soFc C sz t � t| j� tj�| jd�}td|g�}tjdkrW|s+td|gdgdgdgd�}n,tjdkrWdd � t � d �D �}t |d d � d �}t � |d d� td|gdgdgdgd�}td|gd��}| j|_| �|�}t|� | j|_| j|_tj}tjs~t� t_z |�� |�� W |t_n|t_w td| j�� | �|� W d � n1 s�w Y tjdkr�|r�t� d� d S d S d S )Nz xxmodule.c�xx�win32�/usr/lib�z)� library_dirs� libraries�runtime_library_dirs�linuxc S s h | ]}t j�|��qS r$ )r6 r �realpath)�.0r, r$ r$ r% � <setcomp>o s �z.TestBuildExt.test_build_ext.<locals>.<setcomp>z/usr/lib*/libz.so*c S s t | �S r' )�len)�lib_pathr$ r$ r% �<lambda>r s z-TestBuildExt.test_build_ext.<locals>.<lambda>)�key���z/tmp/libxx_z.so�/tmp�xx_z�r, � ext_modules) r r r r6 r r: r r r �glob�iglob�sortedr; �copyfiler � package_dirr r � build_lib� build_temp�stdoutr �verboser �ensure_finalized�runr. �_test_xx�unlink)r" rE �xx_c�xx_ext�libz_so�dist�cmd� old_stdoutr$ r$ r% �test_build_ext_ sZ � �� ��zTestBuildExt.test_build_extc C s dd l }dD ] }t||�sJ �q|�dd�dksJ �|�dd�dks$J �|�� �� d u s.J �tjr:d }|j|ks:J �t|� � |j �sDJ �t|� � |j �sNJ �t j d kr�t jd d |jgd d�}dd l}|�|� dd� |�d�D �}| s�|�|� d|vr�d|vs�J �d S d|v s�J �d S d S )Nr )�error�foo�new�roj� � � � � � z/This is a template module just for instruction.rM �readelfz-dT)�universal_newlinesc S s@ g | ] }d |v s d|v r|� � d dd� � d�D ]}|�qqS )�RPATH�RUNPATHrr r rU �:)�split)rO �line�rpathr$ r$ r% � <listcomp>� s ��z)TestBuildExt._test_xx.<locals>.<listcomp>� rH z /usr/lib64rV )rF �hasattrro rp �demor �HAVE_DOCSTRINGS�__doc__� isinstance�Null�Strr r � subprocess� check_output�__file__�pprintr} )rE rF �attr�doc� so_headersr� �rpathsr$ r$ r% re � s4 � � �zTestBuildExt._test_xxc C s� t ddi�}| �|�}tj}dt_ddlm} |�d�}d|d< z|�� W |t_|d u r1|d= n||d< n|t_|d u rA|d= w ||d< w t|j �dksOJ �d S )Nr, rF �sunosr )� _config_vars�Py_ENABLE_SHAREDT) r r r r �distutils.sysconfigr� �getrc rQ rJ )r" rj rk �oldr� �old_varr$ r$ r% �test_solaris_enable_shared� s$ � z'TestBuildExt.test_solaris_enable_sharedc C s� dd l }tddi�}| �|�}dd� |jD �}d|v s J �d|_tj�|jd�}tj�|jd �}t� |� t� |� |� � ||j v sEJ �||j v sLJ �||j v sSJ �d S ) Nr r, rF c S s g | ]\}}}|�qS r$ r$ )rO r, �short�labelr$ r$ r% r� � s z/TestBuildExt.test_user_site.<locals>.<listcomp>�userT�lib�include)r r r � user_optionsr� r6 r r: r �mkdirrc rJ r � include_dirs)r" r rj rk �optionsr� �inclr$ r$ r% �test_user_site� s zTestBuildExt.test_user_sitec C s� t ddgdd�g}td|d��}| �|�}|�� t�ttf�� |�� W d � n1 s/w Y t ddgdd�g}td|d��}| �|�}|�� |�� d S )Nro �xxxF��optionalrF rX T) r r r rc �pytest�raisesr r rd �r" �modulesrj rk r$ r$ r% �test_optional_extension� s � z$TestBuildExt.test_optional_extensionc C s� t ddgdd�g}td|d��}| �|�}|�� t�� }|�tjj �D ] }||j v s-J �q$tjdd�}|�tjj �D ] }||j v sDJ �q;| �|�}d |_ |�� |j g d �ksZJ �| �|�}d tj � d �|_ |�� d |j v srJ �d |j v syJ �| �|�}d tj � d�|_ |�� |j d dgks�J �t|�}d|_|�� |jg d�ks�J �| �|�}d|_|�� |jddgks�J �| �|�}d|_|�� |jd dgks�J �| �|�}d |_|�� |jg ks�J �| �|�}d|_|�� |jddgks�J �d S )Nro r� Fr� rF rX T)� plat_specificzmy_lib, other_lib lastlib)�my_lib� other_lib�lastlib� my_lib_dir� other_lib_dir�one�twoz one two,three)r� r� �threezone,two)r� �1)r� r� z1 2r� �2)r r r �finalize_optionsr �get_python_incr} r6 r �pathsepr� rK rJ r � link_objects�define�undef� swig_opts)r" r� rj rk � py_include�p�plat_py_includer$ r$ r% �test_finalize_options� sV z"TestBuildExt.test_finalize_optionsc C s� t � }| �|�}|�� t�t�� |�d� W d � n1 s!w Y ddg}t�t�� |�|� W d � n1 s?w Y dg}t�t�� |�|� W d � n1 s\w Y dg}t�t�� |�|� W d � n1 syw Y ddgddd�fg}|�|� |d }t|t�s�J �|j dks�J �t |d �r�J �ddgddd dgd �fg}t�t�� |�|� W d � n1 s�w Y d dg|d d d< |�|� |d j dgks�J �|d j d gks�J �d S )Nro )�barro r� )zfoo-bar� )�foo.barr� r� r� r� )�sourcesrK �somer r� )r� r� �3)r� rK r� �macros)r� r� )r� r r� r� ) r r r� r� r� r �check_extensions_listr� r rK r� � undef_macros� define_macros)r" rj rk �exts�extr$ r$ r% �test_check_extensions_listC sN � � � � ��� � z'TestBuildExt.test_check_extensions_listc C sH t ddgdd�g}td|d��}| �|�}|�� |�� dgks"J �d S )Nro r� Fr� rF rX )r r r rc �get_source_filesr� r$ r$ r% �test_get_source_files s z"TestBuildExt.test_get_source_filesc C s� t ddgdd�t ddgdd�g}td|d��}| �|�}|�� t�d |�|d j��s.J �t�d |�|d j��s<J �|�|d �d gksHJ �|�|d �dgksTJ �d S )Nro �aaaFr� u föö�uuurF rX z foo(_d)?\..*r u föö(_d)?\..*r � PyInit_foo�PyInitU_f_1gaa) r r r rc �re�search�get_ext_filenamer, �get_export_symbolsr� r$ r$ r% �test_unicode_module_names� s � z&TestBuildExt.test_unicode_module_namesc C sl t ddg�t ddg�g}td|d��}| �|�}|�� |�|d �dgks(J �|�|d �d gks4J �d S ) Nz foo.__init__r� u föö.__init__r� rF rX r r� r r� )r r r rc r� r� r$ r$ r% �test_export_symbols__init__� s � z(TestBuildExt.test_export_symbols__init__c C s8 t � }| �|�}d|_|�� |�� |jdksJ �d S )N�unix)r r �compilerrc rd )r" rj rk r$ r$ r% �test_compiler_option� s z!TestBuildExt.test_compiler_optionc C sF t � | �� }tj�|d�}| �|d� td|gdd�}td|gd��}| �|�}t |� |� � t |� � �dks;J �tj�| j d �|_tj�| j d �|_tj�| �� �}t�� }t�|� zd |_|�� |� � d }W t�|� nt�|� w tj�|�s�J �t�d �} |�| �s�J �tj�|�} | |ks�J �d|_d |_|�� |� � d }tj�|�s�J �|�| �s�J �tj�|�} | |jks�J �|�d�} ddi| _ |� d�} tj� | �d } | |jks�J �d |_tj�| �� �}t�� }t�|� z |� d�} W t�|� nt�|� w tj� | �d } tj� | �d } | dk�s!J �d S )Nzfoo.czvoid PyInit_foo(void) {} ro Fr� rF rX r �build�temptTr � EXT_SUFFIX�build_pyr� r� rU ) r r r6 r r: � write_filer r r r rc rQ � get_outputsr r_ r` rN �getcwd�chdir�inplacerd �existsr �get_config_var�endswith�dirnamer� �get_finalized_commandr^ �get_ext_fullpathr} )r" r �c_filer� rj rk � other_tmp_dir�old_wd�so_file� ext_suffix�so_dirr� r �lastdirr$ r$ r% �test_get_outputs� s` z TestBuildExt.test_get_outputsc C s. t �d�}t� }| �|�}d|_ddi|j_ddg|j_t� � }tj � |ddd| �}|� d�}||ks6J �d |_tj � |d �|_ tj � |d dd| �}|� d�}||ksWJ �|�d �}i |_d d g|j_|� d �}tj � |d d dd| �}||ks|J �d|_|� d �}tj � |d dd| �}||ks�J �d S )Nr� Tr� �src�lxmlz lxml.html�etreez lxml.etreeF�tmpdirr� �twistedztwisted.runner.portmap�runner�portmap)r r� r r r� � distributionr^ �packagesr6 r� r r: r� r_ r� )r" r� rj rk �curdir�wantedr r� r$ r$ r% �test_ext_fullpath� s2 z TestBuildExt.test_ext_fullpathz platform.system() != "Darwin"�save_envc C s | � dd � d S )Nz==)� _try_compile_deployment_target�r" r$ r$ r% � test_deployment_target_default s z+TestBuildExt.test_deployment_target_defaultc C s< t �t�� | �dd� W d � d S 1 sw Y d S )N�>z10.1)r� r� r r r r$ r$ r% � test_deployment_target_too_low s "�z+TestBuildExt.test_deployment_target_too_lowc C sZ t �d�}|r+dd� |�d�D �}|d d7 < d�dd� |D ��}| �d |� d S d S ) N�MACOSX_DEPLOYMENT_TARGETc S s g | ]}t |��qS r$ )�int)rO �xr$ r$ r% r� ( s zATestBuildExt.test_deployment_target_higher_ok.<locals>.<listcomp>�.rU r c s s � | ]}t |�V qd S r' )�str)rO �ir$ r$ r% � <genexpr>* s � z@TestBuildExt.test_deployment_target_higher_ok.<locals>.<genexpr>�<)r r� r} r: r )r" � deptargetr$ r$ r% � test_deployment_target_higher_ok s �z-TestBuildExt.test_deployment_target_higher_okc C sR |d u rt j�d�rt jd= n|t jd< tj�dt�d|� d��i| j� t � d�}t t t |�d�dd� ��}|d d� dk rCd }n t|�dkrLd }nd }|j|� }td | jd gd |� �gd�}td |gd��}| j|_| �|�}| j|_| j|_z tj}tjs�t � t_z|� � |� � W |t_W d S |t_w t y� | � d� Y d S w )Nr zdeptargetmodule.czt #include <AvailabilityMacros.h> int dummy; #if TARGET z� MAC_OS_X_VERSION_MIN_REQUIRED #else #error "Unexpected target" #endif r r rr )� r z {:02}{:01}0z {:02}{:02}00z {:02}0000r z -DTARGET=)�extra_compile_argsrX z*Wrong deployment target during compilation)!r6 �environr� �jaracor r� �textwrap�dedentr r r� �tuple�mapr r} rQ �formatr r r r^ r r_ r` r ra r rb r rc rd r �fail)r" �operator�target�tmpl� deptarget_extrj rk rl r$ r$ r% r - sR � �� � � �z+TestBuildExt._try_compile_deployment_targetN)�__name__� __module__� __qualname__r r� �mark� parametrizerm � staticmethodre r� r� r� r� r� r� r� r� r� r� r �skipif� usefixturesr r r r r$ r$ r$ r% rB Z s6 3 % H< ? % rB c s e Zd Z� fdd�Z� ZS )�TestParallelBuildExtc s t � j|i |��}d|_|S )NT)�superr �parallel)r" rC rD r �� __class__r$ r% r q s z TestParallelBuildExt.build_ext)r r r! r � __classcell__r$ r$ r* r% r' p s r' )5� contextlibrZ r3 �os.pathr6 r r� r; r r� r r9 r r � distutilsr �distutils.command.build_extr �distutils.corer �distutils.errorsr r r r �distutils.extensionr �distutils.testsr �distutils.tests.supportr r r �ior � jaraco.pathr r r� �testr �compatr r( �fixturer& �contextmanagerr. r* r" r& rB r' r$ r$ r$ r% �<module> sN _distutils/tests/__pycache__/support.cpython-310.pyc 0000644 00000011764 15030122015 0016514 0 ustar 00 o �h � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl Z ddl m Z e j �d�G dd� d��ZG dd � d �Zd d � Zd d � Zdd� Zdd� ZdS )z&Support code for distutils test cases.� N)� Distribution)�always_iterable�distutils_managed_tempdirc @ s, e Zd ZdZdd� Zd dd�Zd dd �Zd S ) �TempdirManagerzI Mix-in class that handles temporary directories for test cases. c C s t �� }| j�|� |S )zjCreate a temporary directory that will be cleaned up. Returns the path of the directory. )�tempfile�mkdtemp�tempdirs�append)�self�d� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/support.pyr s zTempdirManager.mkdtemp�xxxc C s t jt|�� j|dd� dS )zVWrites a file in the given path. path can be a string or a sequence. zutf-8)�encodingN)�pathlib�Pathr � write_text)r �path�contentr r r � write_file s zTempdirManager.write_file�fooc K s2 | � � }tj�||�}t�|� t|d�}||fS )a Will generate a test environment. This function creates: - a Distribution instance using keywords - a temporary directory with a package structure It returns the package directory and the distribution instance. )�attrs)r �osr �join�mkdirr )r �pkg_name�kw�tmp_dir�pkg_dir�distr r r � create_dist& s zTempdirManager.create_distN)r )r )�__name__� __module__� __qualname__�__doc__r r r r r r r r s r c @ s e Zd ZdZdd� Zdd� ZdS )� DummyCommandzAClass to store options for retrieval via set_undefined_options().c K s t | ��|� d S �N)�vars�update)r �kwargsr r r �__init__; s zDummyCommand.__init__c C s d S r& r )r r r r �ensure_finalized> s z DummyCommand.ensure_finalizedN)r! r" r# r$ r* r+ r r r r r% 8 s r% c C s t �t� tj�| d�� dS )ak Helper for tests that need the xxmodule.c source file. Example use: def test_compile(self): copy_xxmodule_c(self.tmpdir) self.assertIn('xxmodule.c', os.listdir(self.tmpdir)) If the source file can be found, it will be copied to *directory*. If not, the test will be skipped. Errors during copy are not caught. � xxmodule.cN)�shutil�copy�_get_xxmodule_pathr r r )� directoryr r r �copy_xxmodule_cB s r1 c C s( t jdkrdnd} tj�tj�t�| �S )N)� � r, zxxmodule-3.8.c)�sys� version_infor r r �dirname�__file__)� source_namer r r r/ Q s r/ c C s� t jdkrtj�d�| _dS t�d�rBt�d�}|du r"dg| _dS tj dkr,g | _dS |� d�\}}}d d � |� t j �D �| _dS dS ) a� Function needed to make build_ext tests pass. When Python was built with --enable-shared on Unix, -L. is not enough to find libpython<blah>.so, because regrtest runs in a tempdir, not in the source directory where the .so lives. When Python was built with in debug mode on Windows, build_ext commands need their debug attribute set, and it is not done automatically for some reason. This function handles both of these things. Example use: cmd = build_ext(dist) support.fixup_build_ext(cmd) cmd.ensure_finalized() Unlike most other Unix platforms, Mac OS X embeds absolute paths to shared libraries into executables, so the fixup is not needed there. �ntz_d.exe�Py_ENABLE_SHARED� RUNSHAREDN�.�darwin�=c S s g | ]}|r|�qS r r )�.0r r r r � <listcomp>x s z#fixup_build_ext.<locals>.<listcomp>) r �namer4 � executable�endswith�debug� sysconfig�get_config_var� library_dirs�platform� partition�split�pathsep)�cmd� runsharedrA �equals�valuer r r �fixup_build_extV s �rP c C s dd� t �| g| j�D �| _| S )z� pytest will honor markers as found on the class, but when markers are on multiple subclasses, only one appears. Use this decorator to combine those markers. c S s" g | ] }t |d g �D ]}|�q qS )� pytestmark)�getattr)r? �base�markr r r r@ � s ���z#combine_markers.<locals>.<listcomp>)� itertools�chain� __bases__rQ )�clsr r r �combine_markers{ s �rY )r$ rU r r r- r4 rE r �distutils.corer �pytest�more_itertoolsr rT � usefixturesr r% r1 r/ rP rY r r r r �<module> s$ ' % _distutils/tests/__pycache__/test_text_file.cpython-310.pyc 0000644 00000004177 15030122015 0020022 0 ustar 00 o �h� � @ sF d Z ddlmZ ddlmZ ddlZddlZdZG dd� dej �Z dS )z Tests for distutils.text_file.� )�support)�TextFileNzE# test file line 3 \ # intervening comment continues on next line c @ s e Zd Zdd� ZdS )� TestTextFilec C s� g d�}g d�}g d�}ddg}dg}dg}dd � }t �| �� �}|d } tj �| jti|� t| d d d d d �} z |d d| |� W | �� n| �� w t| dd d d d �} z |dd| |� W | �� n| �� w t| d dd d d �} z |dd| |� W | �� n| �� w t| �} z |dd| |� W | �� n| �� w t| ddddd�} z |dd| |� W | �� n| �� w t| dddddd�} z|dd| |� W | �� d S | �� w ) N)� # test file � � line 3 \ �# intervening comment � continues on next line )r r r )r r r r zline 3 \z continues on next linez line 3 continues on next linez line 3 continues on next linec S s |� � }||ks J �d S )N)� readlines)�count� description�file�expected_result�result� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_text_file.py� test_input6 s z+TestTextFile.test_class.<locals>.test_inputztest.txtF)�strip_comments� skip_blanks� lstrip_ws� rstrip_ws� z no processingT� zstrip comments� z strip blanks� zdefault processing)r r � join_linesr � z join lines without collapsing)r r r r � collapse_join� zjoin lines with collapsing) �path�Path�mkdtemp�jaraco�build�name� TEST_DATAr �close) �self�result1�result2�result3�result4�result5�result6r �tmp_path�filename�in_filer r r � test_class s� �����zTestTextFile.test_classN)�__name__� __module__� __qualname__r1 r r r r r s r ) �__doc__�distutils.testsr �distutils.text_filer � jaraco.pathr" r r% �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_core.cpython-310.pyc 0000644 00000007616 15030122015 0016770 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlZddlmZ ddlZdZ dZ dZ dZ dZ ejd d �d d � �Zejd d� �Zej�d�ej�d�G dd� d���ZdS )zTests for distutils.core.� N)� Distributionz4 __file__ from distutils.core import setup setup() zH import os print(os.getcwd()) from distutils.core import setup setup() z)from distutils.core import setup setup() z�from distutils.core import setup from distutils.command.install import install as _install class install(_install): sub_commands = _install.sub_commands + ['cmd'] setup(cmdclass={'install': install}) z�from distutils.core import setup def main(): return setup(name="setup_within_if_main") if __name__ == "__main__": main() T)�autousec C s | � tdtj� d S )N�stdout)�setattr�sysr )� monkeypatch� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_core.py� save_stdout8 s r c C s | d S )N�filer )�tmp_pathr r r � temp_file= s r �save_env� save_argvc @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )�TestCorec C s |j tdd� tj�|� d S �N�utf-8��encoding)� write_text�setup_using___file__� distutils�core� run_setup)�selfr r r r � test_run_setup_provides_fileE s z%TestCore.test_run_setup_provides_filec C s6 t j�� }|jtdd� tj�|� t j|ksJ �d S r )r �argv�copyr �setup_does_nothingr r r )r r � argv_copyr r r �!test_run_setup_preserves_sys_argvK s z*TestCore.test_run_setup_preserves_sys_argvc C s6 |j tdd� tj�|�}|�d�}d|jv sJ �d S )Nr r �install�cmd)r �setup_defines_subclassr r r �get_command_obj� sub_commands)r r �distr! r r r � test_run_setup_defines_subclassR s z(TestCore.test_run_setup_defines_subclassc C sd t �� t_t�� }|d }|jtdd� tj � |� tj� � }|� d�r*|dd� }||ks0J �dS )zt Test that the setup script is run with the current directory as its own current directory. �setup.pyr r � N���) �io�StringIOr r �os�getcwdr �setup_prints_cwdr r r �getvalue�endswith)r r �cwd�setup_py�outputr r r � test_run_setup_uses_current_dirZ s z(TestCore.test_run_setup_uses_current_dirc C s@ |j tdd� tjj|dd�}t|t�sJ �|�� dks J �d S )Nr r �config�� stop_after�setup_within_if_main)r r9 r r r � isinstancer �get_name�r r r& r r r � test_run_setup_within_if_mainl s z&TestCore.test_run_setup_within_if_mainc C sT ddgt _|jtdd� tjj|dd�}d|jvsJ �tj�|� d|jv s(J �d S )Nr( �buildr r � commandliner7 ) r r r r9 r r r �have_run� run_commandsr< r r r �test_run_commandsr s zTestCore.test_run_commandsc C sd ddgt _tjjdd� |�� jdksJ �|�tjdd� tjjdd� d}|�� j�|�s0J �d S ) Nr( z--name�bar)�namezbar �DEBUGTz&options (after parsing config files): ) r r r r �setup� readouterr�outr � startswith)r �capsysr �wantedr r r �test_debug_modez s zTestCore.test_debug_modeN) �__name__� __module__� __qualname__r r r' r5 r= rB rL r r r r r B s r )�__doc__�distutils.corer r+ r- r �distutils.distr �pytestr r/ r r# r9 �fixturer r �mark� usefixturesr r r r r �<module> s& _distutils/tests/__pycache__/test_dir_util.cpython-310.pyc 0000644 00000011543 15030122015 0017645 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlZddlmZ ddlmZm Z ddl m Z m Z m Z mZmZ ddlmZ ddlZddlZddlZejdd�dd � �ZG d d � d ej�ZdS ) z Tests for distutils.dir_util.� N)�dir_util�errors)� copy_tree� create_tree�ensure_relative�mkpath� remove_tree)�supportT)�autousec C sD | j }|�� }tj�|d�|_tj�|jd�|_tj�|d�|_d S )N�deep�here�deep2)�instance�mkdtemp�os�path�join� root_target�target�target2)�request� monkeypatch�distutils_managed_tempdir�self�tmp_dir� r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_dir_util.py�stuff s r c @ sX e Zd Zdd� Zej�d�dd� �Zdd� Zdd � Z d d � Z d d � Z dd� Z dd� Z dS )� TestDirUtilc C s� t | jdd� |jr J �t| jdd� t | jdd� d| j� �g}|j|ks(J �|�� t| jdd� d| j� d�g}|j|ksBJ �d S )NF��verboseT� creating z removing 'z' (and everything under it))r r �recordsr r �messages�clear�r �caplog�wantedr r r �!test_mkpath_remove_tree_verbosity! s z-TestDirUtil.test_mkpath_remove_tree_verbosityz platform.system() == 'Windows'c C st t �d�}t �|� t| jd� t�t �| j�j�d| @ ks!J �t| jd� t�t �| j�j�d| @ ks8J �d S )N� i� im )r �umaskr r �stat�S_IMODE�st_moder )r r* r r r � test_mkpath_with_custom_mode/ s " &z(TestDirUtil.test_mkpath_with_custom_modec C sr t | jg d�dd� |jg ksJ �t| jdd� d| j� �g}t | jg d�dd� |j|ks0J �t| jdd� d S )N)�one�two�threeFr r! T)r r r# r r% r r r �test_create_tree_verbosity9 s z&TestDirUtil.test_create_tree_verbosityc C s� t | jdd� t| j| jdd� |jg ksJ �t| jdd� t | jdd� t�| j�d }t j� ddi| j� d|� d| j� �g}t| j| jdd� |j|ksQJ �t| jdd� t| jdd� d S )NFr �ok.txt� some contentzcopying z -> T) r r r r r# r r r �Path�jaraco�build)r r& �a_filer' r r r �test_copy_tree_verbosityD s z$TestDirUtil.test_copy_tree_verbosityc C sh t | jdd� tj�ddd�| j� t| j| j� t�| j�dgks$J �t | j dd� t | jdd� d S )NFr r4 � )r3 z .nfs123abcr3 ) r r r6 r r7 r r r �listdirr r �r r r r �#test_copy_tree_skips_nfs_temp_filesW s z/TestDirUtil.test_copy_tree_skips_nfs_temp_filesc C sR t jdkrtd�dks J �td�dksJ �d S td�dks J �td�dks'J �d S )N�/z /home/foozhome/fooz some/pathz c:\home\fooz c:home\foozhome\foo)r �sepr r< r r r �test_ensure_relativeb s z TestDirUtil.test_ensure_relativec C s� t jdt� d��2 t�tj�� | jd }t� |d� W d � n1 s%w Y W d � dS W d � dS 1 s=w Y dS )zK An exception in listdir should raise a DistutilsFileError z os.listdir)� side_effect���N) �mock�patch�OSError�pytest�raisesr �DistutilsFileError�tempdirsr r )r �srcr r r �#test_copy_tree_exception_in_listdirj s � � P�z/TestDirUtil.test_copy_tree_exception_in_listdirc C sv G dd� dt j�}|d }t�tj�� t||�� W d � n1 s$w Y |�� r/J �t|� |�� s9J �dS )zZ Caching should not remember failed attempts. pypa/distutils#304 c @ s, e Zd Zdd� Zejdk re�� jZdS dS )z<TestDirUtil.test_mkpath_exception_uncached.<locals>.FailPathc _ s t d��)NzFailed to create directory)rE )r �args�kwargsr r r �mkdir} s zBTestDirUtil.test_mkpath_exception_uncached.<locals>.FailPath.mkdir)� � N) �__name__� __module__� __qualname__rN �sys� version_info�pathlibr5 �_flavourr r r r �FailPath| s �rX �foodirN)rV r5 rF rG r rH r �exists)r r �tmp_pathrX r r r r � test_mkpath_exception_uncachedu s � z*TestDirUtil.test_mkpath_exception_uncachedN)rQ rR rS r( rF �mark�skipifr. r2 r9 r= r@ rK r\ r r r r r s r )�__doc__r rV r+ rT � unittest.mockrC � distutilsr r �distutils.dir_utilr r r r r �distutils.testsr � jaraco.pathr6 r rF �fixturer �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_log.cpython-310.pyc 0000644 00000001317 15030122015 0016611 0 ustar 00 o �hC � @ s* d Z ddlZddlmZ G dd� d�ZdS )zTests for distutils.log� N)�logc @ s e Zd Zdd� ZdS )�TestLogc C s6 |� tj� t�d� t�d� |jddgksJ �d S )Nu Dεbug Mėssãgeu Fαtal Èrrōr)� set_level�logging�DEBUGr �debug�fatal�messages)�self�caplog� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_log.py�test_non_ascii s zTestLog.test_non_asciiN)�__name__� __module__� __qualname__r r r r r r s r )�__doc__r �distutils._logr r r r r r �<module> s _distutils/tests/__pycache__/test_check.cpython-310.pyc 0000644 00000010521 15030122015 0017102 0 ustar 00 o �hR � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl Z zddl Z W n e y1 dZ Y nw ej � e�ZejG dd� dej��ZdS )z"Tests for distutils.command.check.� N)�check)�DistutilsSetupError)�supportc @ sF e Zd Zddd�Zdd� Zdd� Zdd � Zd d � Zd d � Zdd� Z dS )� TestCheckNc K s� |d u ri }|d urt �� }t �|� | jdi |��\}}t|�}|�� |�� D ] \}} t||| � q)|�� |� � |d urEt �|� |S )N� ) �os�getcwd�chdir� create_distr �initialize_options�items�setattr�ensure_finalized�run) �self�metadata�cwd�options�old_dir�pkg_info�dist�cmd�name�valuer r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_check.py�_run s zTestCheck._runc C s� | � � }|jdks J �dddddd�}| � |�}|jdks J �t�t�� | j i fi ddi�� W d � n1 s:w Y | j |dd�}|jdksMJ �dddddd d d �}| � |�}|jdkscJ �d S ) N� �xxx)�url�author� author_emailr �versionr �strictT)r" u Éricu Something about esszet ßu More things about esszet ß)r r r r r! � description�long_description)r � _warnings�pytest�raisesr )r r r r r r �test_check_metadata' s2 � �� z TestCheck.test_check_metadatac C s� dD ]A}dd|d dddddi}| � |�}|jdks J �d ||d < | � |�}|jdks.J �d ||< ||d = | � |�}|jdksCJ �qd S ) N)r � maintainerr r �_emailzName <name@email.com>r r! r zname@email.com�Name)r r% )r �kindr r r r r � test_check_author_maintainerQ s � �z&TestCheck.test_check_author_maintainerc C s^ t �d� | �� \}}t|�}d}|�|�}t|�dks J �d}|�|�}t|�dks-J �d S )N�docutils�title === testr ztitle ===== testr )r& � importorskipr r �_check_rst_data�len)r r r r � broken_rest�msgs�restr r r �test_check_documenti s z TestCheck.test_check_documentc C s� t �d� d}| j|d�\}}t|�}|�� |jdks J �ddddd|d�}t �t�� | j|fi ddd��� W d � n1 sCw Y d|d < | j|d d d�}|jd ks[J �d |d < | j|t d d d �}|jd ksoJ �d S )Nr. r/ �r$ r r )r r r r r! r$ �r" �restructuredtextu title ===== test ßr$ Tr z)title ===== .. include:: includetest.rst)r r" r9 ) r& r0 r r �check_restructuredtextr% r' r r �HERE)r r3 r r r r r r r �test_check_restructuredtextx s, � �z%TestCheck.test_check_restructuredtextc C s� t �d� t�d�t�d�g}|D ]8}| j|d�\}}t|�}|�� |�|�}td ur5t |�dks4J �qt |�dks=J �t |d d �dksIJ �qd S )Nr. z} Here's some code: .. code:: python def foo(): pass z� Here's some code: .. code-block:: python def foo(): pass r7 r r z0Cannot analyze code. Pygments package not found.) r& r0 �textwrap�dedentr r r: r1 �pygmentsr2 �str)r �example_rst_docs�rest_with_coder r r r4 r r r �1test_check_restructuredtext_with_syntax_highlight� s( � �� ��z;TestCheck.test_check_restructuredtext_with_syntax_highlightc C sH t �t�� | ji fi ddd��� W d � d S 1 s w Y d S )Nr r8 )r& r' r r )r r r r �test_check_all� s "�zTestCheck.test_check_all)NN) �__name__� __module__� __qualname__r r( r- r6 r< rC rD r r r r r s * )r )�__doc__r r= �distutils.command.checkr �distutils.errorsr �distutils.testsr r& r? � ImportError�path�dirname�__file__r; �combine_markers�TempdirManagerr r r r r �<module> s � _distutils/tests/__pycache__/test_archive_util.cpython-310.pyc 0000644 00000024720 15030122015 0020511 0 ustar 00 o �h . � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m Z m Z m Z m Z mZ ddlmZ ddlmZ ddlmZ ddlZddlZddlmZ d d lmZmZm Z m Z m Z d d � Z d d� Z dd� Z!G dd� dej"�Z#dS )z!Tests for distutils.archive_util.� N)� archive_util)�ARCHIVE_FORMATS�check_archive_formats� make_archive� make_tarball� make_zipfile)�spawn)�support)� splitdrive)�patch� )� UID_0_SUPPORT�grp�pwd� require_uid_0�require_unix_idc C s6 t jjrdS z | �t�� � W dS ty Y dS w )zF Return True if the filename can be saved in the file system. TF)�os�path�supports_unicode_filenames�encode�sys�getfilesystemencoding�UnicodeEncodeError)�filename� r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_archive_util.py� can_fs_encode s ��r c C s t �tj| �S �N)� functools�reduce�operator�eq)�valuesr r r � all_equal) s r# c G s t dd� | D ��S )Nc s s � | ] }t �|�jV qd S r )�pathlib�Path�drive)�.0r r r r � <genexpr>. s � z same_drive.<locals>.<genexpr>)r# )�pathsr r r � same_drive- s r* c @ s@ e Zd Zej�d�d4dd��Zej�d�dd� �Zdd� Zd d � Z ej� d �d d � �Z ej� d�dd� �Z dd� Z dd� Zg d�Zdd� eD �Zdd� Zej�d�ej� d�dd � ��Zej�d�d d � �Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zej�d�d)d*� �Zd+d,� Zd-d.� Zd/d0� Z ej�d�e e d1d2� ���Z d3S )5�ArchiveUtilTestCase� needs_zlib�archivec C s, | � � }| �||d� | j||dd d� d S )N�.tar.gz�.tar��compress�� _create_files� _make_tarball)�self�name�tmpdirr r r �test_make_tarball2 s z%ArchiveUtilTestCase.test_make_tarballc C s | � � }| j|dddd� d S )Nr- r. �gzipr0 r2 �r5 r7 r r r �test_make_tarball_gzip: s z*ArchiveUtilTestCase.test_make_tarball_gzipc C �( t �d� | �� }| j|dddd� d S )N�bz2r- z.tar.bz2�bzip2r0 ��pytest� importorskipr3 r4 r: r r r �test_make_tarball_bzip2? � z+ArchiveUtilTestCase.test_make_tarball_bzip2c C r< )N�lzmar- z.tar.xz�xzr0 r? r: r r r �test_make_tarball_xzD rC z(ArchiveUtilTestCase.test_make_tarball_xzu not can_fs_encode('årchiv')c C � | � d� dS )zV Mirror test_make_tarball, except filename contains latin characters. u årchivN�r8 �r5 r r r �test_make_tarball_latin1I s z,ArchiveUtilTestCase.test_make_tarball_latin1u' not can_fs_encode('のアーカイブ')c C rG )z{ Mirror test_make_tarball, except filename contains extended characters outside the latin charset. u のアーカイブNrH rI r r r �test_make_tarball_extendedP s z.ArchiveUtilTestCase.test_make_tarball_extendedc K s� | � � }t||�rt�d� tj�||�}t�|�� tt |�d dfi |�� W d � n1 s2w Y || }tj� |�sCJ �| � |�| j ksMJ �d S )Nz)source and target should be on same driver �dist) �mkdtempr* r@ �skipr r �joinr% r r �exists�_tarinfo�_created_files)r5 r7 � target_name�suffix�kwargs�tmpdir2� base_name�tarballr r r r4 X s �z!ArchiveUtilTestCase._make_tarballc C s4 t �|�}z|�� }|�� |W |�� S |�� w r )�tarfile�open�getnames�sort�close)r5 r �tar�namesr r r rQ h s z ArchiveUtilTestCase._tarinfo)zdist/z dist/file1z dist/file2z dist/sub/zdist/sub/file3z dist/sub2/c C s g | ]}|� d ��qS )�/)�rstrip)r' �pr r r � <listcomp>y s z ArchiveUtilTestCase.<listcomp>c C s~ | � � }tj�|d�}t�|� | �|dgd� | �|dgd� t�tj�|d�� | �|ddgd� t�tj�|d�� |S )NrL �file1�xxx�file2�sub�file3�sub2)rM r r rO �mkdir� write_file)r5 r7 rL r r r r3 { s z!ArchiveUtilTestCase._create_filesz2not (shutil.which('tar') and shutil.which('gzip'))c C s� | � � }| �� }tj�|d�}t�� }t�|� z t|d� W t�|� nt�|� w |d }tj�|�s7J �tj�|d�}g d�}g d�}t�� }t�|� zt |� t |� W t�|� nt�|� w tj�|�smJ �| � |�| j kswJ �| � |�| j ks�J �tj�|d�}t�� }t�|� zt|dd d� W t�|� nt�|� w |d }tj�|�s�J �tj�|d�}t�� }t�|� zt|dd d d � W t�|� nt�|� w |d }tj�|�s�J �d S ) Nr- rL r. zarchive2.tar.gz)r^ z-cf� archive2.tarrL )r9 z-fz-9rl r0 r/ T)r1 �dry_run) r3 rM r r rO �getcwd�chdirr rP r rQ rR ) r5 r7 rV rW �old_dirrX �tarball2�tar_cmd�gzip_cmdr r r �test_tarfile_vs_tar� sL z'ArchiveUtilTestCase.test_tarfile_vs_tarc C s� t �d�}| �� }tj�| �� d�}t�|�� t|d� W d � n1 s'w Y |d }tj� |�s8J �|� |��}t |� � �| j ksIJ �W d � d S 1 sTw Y d S )N�zipfiler- rL �.zip)r@ rA r3 r r rO rM r% r rP �ZipFile�sorted�namelist�_zip_created_files)r5 ru r7 rW rX �zfr r r �test_make_zipfile� s � "�z%ArchiveUtilTestCase.test_make_zipfilec s t �d��t| tjdd � g � �j�� ��fdd�}t| tjd|� | �� }tj� | � � d�}t� |�� t |d� W d � n1 sDw Y |d }� |d fd �j ifgks[J �tj�|�scJ ���|��}t|�� �| jkstJ �W d � d S 1 sw Y d S ) Nru �zlibc s. |� dd ��jkr� �| |f� �| i |��S )N� compression)�get� ZIP_STORED�append)�a�kw��calledru � zipfile_classr r � fake_zipfile� s zCArchiveUtilTestCase.test_make_zipfile_no_zlib.<locals>.fake_zipfilerw r- rL rv �wr~ )r@ rA r r ru rw r3 r r rO rM r% r r� rP rx ry rz )r5 r� r7 rW rX r{ r r� r �test_make_zipfile_no_zlib� s" � "�z-ArchiveUtilTestCase.test_make_zipfile_no_zlibc C s, t g d��dks J �t g d��d u sJ �d S )N)�gztarre �zipre )r� �bztar�xztar�ztarr^ r� )r rI r r r �test_check_archive_formats� s �z.ArchiveUtilTestCase.test_check_archive_formatsc C sP | � � }tj�|d�}t�t�� t|d� W d � d S 1 s!w Y d S )Nr- re )rM r r rO r@ �raises� ValueErrorr )r5 r7 rW r r r �test_make_archive� s "�z%ArchiveUtilTestCase.test_make_archivec C sv t �� }dd� }|g dftd< z%z tdd| �� d� W n ty$ Y nw t �� |ks-J �W t�d� d S t�d� w )Nc _ s t � �r )� RuntimeError)�argsr� r r r �_breaks� s z:ArchiveUtilTestCase.test_make_archive_cwd.<locals>._breakszxxx filere )�root_dir)r rn r r rM � Exception�pop)r5 � current_dirr� r r r �test_make_archive_cwd� s �z)ArchiveUtilTestCase.test_make_archive_cwdc C �d | � � }tj�| �� d�}t|d|d�}tj�|�s J �tj�|�dks&J �| �|�| j ks0J �d S )Nr- r^ rL z archive.tar� r3 r r rO rM r rP �basenamerQ rR �r5 �base_dirrW �resr r r �test_make_archive_tar s z)ArchiveUtilTestCase.test_make_archive_tarc C r� )Nr- r� rL zarchive.tar.gzr� r� r r r �test_make_archive_gztar s z+ArchiveUtilTestCase.test_make_archive_gztarc C �n t �d� | �� }tj�| �� d�}t|d|d�}tj�|�s!J �tj� |�dks+J �| � |�| j ks5J �d S )Nr= r- r� rL zarchive.tar.bz2� r@ rA r3 r r rO rM r rP r� rQ rR r� r r r �test_make_archive_bztar � z+ArchiveUtilTestCase.test_make_archive_bztarc C r� )NrD r- r� rL zarchive.tar.xzr� r� r r r �test_make_archive_xztar r� z+ArchiveUtilTestCase.test_make_archive_xztarc C s� t rt�d�d }t�d�d }nd }}| �� }| �� }tj� | �� d�}t |d||||d�}tj� |�s8J �t |d||�}tj� |�sGJ �t |d||||d�}tj� |�sYJ �t |d||ddd�}tj� |�skJ �d S ) Nr �rootr- r� )�owner�groupr^ � kjhkjhkjg�oihohoh) r r �getgrgidr �getpwuidr3 rM r r rO r rP )r5 r� r� r� r� rW r� r r r � test_make_archive_owner_group( s* � � �z1ArchiveUtilTestCase.test_make_archive_owner_groupc C s� | � � }tj�| �� d�}t�� }t�|� t�d�d }t � d�d }zt |dd ||d�}W t�|� nt�|� w tj� |�sCJ �t �|�}z |�� D ]}|jdksVJ �|jdks]J �qMW |�� d S |�� w )Nr- r rL )r1 r� r� )r3 r r rO rM rn ro r r� r r� r rP rY rZ � getmembers�uid�gidr] ) r5 r7 rW rp r� r� � archive_namer- �memberr r r �test_tarfile_root_ownerF s& � �z+ArchiveUtilTestCase.test_tarfile_root_ownerN)r- ) �__name__� __module__� __qualname__r@ �mark� usefixturesr8 r; rB rF �skipifrJ rK r4 rQ rz rR r3 rt r| r� r� r� r� r� r� r� r� r� r r r� r r r r r+ 1 sF 6 r+ )$�__doc__r r r r$ r rY � distutilsr �distutils.archive_utilr r r r r �distutils.spawnr �distutils.testsr �os.pathr r r@ � test.supportr � unix_compatr r r r r r r# r* �TempdirManagerr+ r r r r �<module> s( _distutils/tests/__pycache__/test_cmd.cpython-310.pyc 0000644 00000007765 15030122015 0016610 0 ustar 00 o �h� � @ st d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddl Z G dd� de�Z e j d d � �Z G d d � d �ZdS ) zTests for distutils.cmd.� N)�debug)�Command)� Distribution)�DistutilsOptionErrorc @ s e Zd Zdd� ZdS )�MyCmdc C s d S �N� )�selfr r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_cmd.py�initialize_options s zMyCmd.initialize_optionsN)�__name__� __module__� __qualname__r r r r r r s r c C s t t� �S r )r r )�requestr r r �cmd s r c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )� TestCommandc C s g d�|_ g d�|_t� |_d|_|�d� |�d� t�t�� |�d� W d � n1 s0w Y t�t�� |�d� W d � n1 sJw Y d|_ |�d � |j dd gks`J �d d g|_ |�d � ddg|_ t�t�� |�d� W d � d S 1 s�w Y d S )N)�one� �three)r �twor �ok�yes_string_list�yes_string_list2�not_string_list�not_string_list2zok,dok�option1�dok�xxx�www�option2r �option3) r r �objectr r �ensure_string_list�pytest�raisesr r r r �r r r r r �test_ensure_string_list s* � � "�z#TestCommand.test_ensure_string_listc C sf t �t�� |jddddd� W d � n1 sw Y dd� }d|_||_|jdd ddd� d S ) NT� �funcr )�infiles�outfiler( �argsc S s |dksJ �d S )Nzgenerating out from inr )r( r+ �exec_msg�levelr r r �_execute6 s z,TestCommand.test_make_file.<locals>._execute�in�out)r# r$ � TypeError� make_file�force�execute)r r r. r r r �test_make_file0 s �zTestCommand.test_make_filec sL g � � fdd�}||_ d|_d|_ddg|_|�� g d�}� |ks$J �d S )Nc s � � | � d S r )�append)�msgr- ��msgsr r � _announce@ s z0TestCommand.test_dump_options.<locals>._announce� )r r' r' )r r' r' )z command options for 'MyCmd':z option1 = 1z option2 = 1)�announcer r � user_options� dump_options)r r r: �wantedr r8 r �test_dump_options= s z TestCommand.test_dump_optionsc C sp d|_ |�d� d |_|�dd� t|d�sJ �d|_t�t�� |�d� W d � d S 1 s1w Y d S )Nr r r r r; r )r � ensure_stringr �hasattrr r# r$ r r% r r r �test_ensure_stringL s "�z TestCommand.test_ensure_stringc C sP t |_|�d� d|_t�t�� |�d� W d � d S 1 s!w Y d S �Nr r r )�__file__r �ensure_filenamer r# r$ r r% r r r �test_ensure_filenameX s "�z TestCommand.test_ensure_filenamec C s^ t j�t�pt j|_|�d� d|_t� t �� |�d� W d � d S 1 s(w Y d S rD ) �os�path�dirnamerE �curdirr �ensure_dirnamer r# r$ r r% r r r �test_ensure_dirname_ s "�z TestCommand.test_ensure_dirnamec C sJ |� d� |�� jdksJ �|�tdd� |� d� |�� jdks#J �d S )Nr r' �DEBUGTzxxx )� debug_print� readouterrr0 �setattrr )r r �capsys� monkeypatchr r r �test_debug_printf s z TestCommand.test_debug_printN) r r r r& r5 r@ rC rG rM rT r r r r r s r )�__doc__rH � distutilsr � distutils.cmdr �distutils.distr �distutils.errorsr r# r �fixturer r r r r r �<module> s _distutils/tests/__pycache__/test_util.cpython-310.pyc 0000644 00000017337 15030122015 0017016 0 ustar 00 o �h4 � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZ ddl m Z ddl m Z ddl mZmZ ddlmZmZ ddlmZmZmZmZmZmZmZmZmZm Z ddl Z e j dd�d d � �Z e j �!d �G d d � d ��Z"dS )zTests for distutils.util.� N)�copy)� sysconfig�util)�DistutilsByteCompileError�DistutilsPlatformError) � byte_compile� change_root� check_environ� convert_path�get_host_platform� get_platform�grok_environment_error� rfc822_escape� split_quoted� strtoboolT)�autousec C s� | � tdtj� | � tdtj� | � tdtj� | � tdtj� | � tjdtjj� | � tjdtjj � | � tjdtjj � | � t dt t j �� d S ) N�name�platform�version�sep�join�isabs� splitdrive� _config_vars)�setattr�osr �sysr r r �pathr r r r r r )� monkeypatch� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_util.py� environment s r! �save_envc @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zej � d �d d � �Z dd� Z dd� Z dZej �ddde� de� de� �fdde� d�fdd d e� d e� d e� d e� �fg�d!d"� �Zd#d$� Zd%d&� Zd'S )(�TestUtilc C s� t �dd��B t �dd�� t� dksJ �W d � n1 s w Y t �dd�� t� dks2J �W d � n1 s<w Y W d � n1 sKw Y t �dd �� t� t�� ks`J �W d � d S 1 skw Y d S ) N�os.name�ntz sys.versionz... [... (ARM64)]� win-arm64z... [... (ARM)]� win-arm32zsys.version_info)� � r �finalr )�mock�patchr �stdlib_sysconfigr ��selfr r r �test_get_host_platform- s � �� �"�z TestUtil.test_get_host_platformc C sB t �dd��� t j�dddi�� t� dksJ �W d � n1 s"w Y t j�dddi�� t� dks8J �W d � n1 sBw Y t j�ddd i�� t� d ksXJ �W d � n1 sbw Y t j�ddd i�� t� d ksxJ �W d � n1 s�w Y W d � d S W d � d S 1 s�w Y d S ) Nr$ r% z os.environ�VSCMD_ARG_TGT_ARCH�x86�win32�x64z win-amd64�armr' �arm64r& )r+ r, �dictr r. r r r �test_get_platform7 s � � � ��"�zTestUtil.test_get_platformc C sH t j�d�}td�|ksJ �tt�d��|ksJ �td�t jks"J �d S )N)� �home�to�my�stuffz/home/to/my/stuff�.)r r r r �pathlib�Path�curdir)r/ �expectedr r r �test_convert_pathB s zTestUtil.test_convert_pathc C s� dt _dd� }|t j_dd� }|t j_tdd�dks J �tdd �d ks%J �d t _d t _d d� }|t j_dd� }|t j_dd� }|t j_tdd�dksLJ �tdd�dksUJ �dt _t� t �� tdd� W d � d S 1 snw Y d S )N�posixc S s | d dkS )Nr �/r �r r r r �_isabsL s z)TestUtil.test_change_root.<locals>._isabsc W � d� | �S )NrE �r rF r r r �_joinQ � z(TestUtil.test_change_root.<locals>._joinz/rootz /old/its/herez/root/old/its/herezits/herez/root/its/herer% �\c S s | � d�S )Nzc:\)� startswithrF r r r rG ] rK c S s" | � d�r d| �dd�fS d| fS )Nzc:r9 )rM �replacerF r r r � _splitdriveb s z.TestUtil.test_change_root.<locals>._splitdrivec W rH )NrL rI rF r r r rJ i rK zc:\rootzc:\old\its\herezc:\root\old\its\herezits\herezc:\root\its\here� BugsBunny) r r r r r r r r �pytest�raisesr )r/ rG rJ rO r r r �test_change_rootH s* "�zTestUtil.test_change_rootc C s6 t j�� tj�dd � t� tjd t� ksJ �d S )N�HOME�PLAT)r r � cache_clearr �environ�popr r. r r r �test_check_environz s zTestUtil.test_check_environzos.name != 'posix'c C s� t j�� tj�dd � dd l}|�d�}tj j |d|d�� t� tjd dks+J �W d � n1 s5w Y t j�� tj�dd � tj j |dt d�� t� dtjvsZJ �W d � d S 1 sew Y d S )NrT r )NNNNN�/home/distutilsN�getpwuid)� return_valuerZ )� side_effect) r r rV r rW rX �pwd� struct_passwdr+ r, �object�KeyError)r/ r^ �resultr r r �test_check_environ_getpwuid� s � "�z$TestUtil.test_check_environ_getpwuidc C s t d�g d�ks J �d S )Nz""one"" "two" 'three' \four)�one�two�three�four)r r. r r r �test_split_quoted� s zTestUtil.test_split_quotedc C s8 d}d}|D ]}t |�sJ �q|D ]}t |�rJ �qd S )N) �y�Y�yes�True�t�truerl �On�on�1) �n�no�f�false�off�0�Off�No�N)r )r/ rk rs ri rr r r r �test_strtobool� s �zTestUtil.test_strtoboolz z given,wantedz hello world zhello � zworld z hello worldzhello �world)r9 r9 z I am a poor lonesome header zI am a zpoor z lonesome zheader c C s� t |�}tjjdddd�}t�� �(}d|� d�}t�|�}tjj||d�� |� |� d� t� |�}W d � n1 s<w Y ||fD ]"} | � � d ksOJ �| d d ksWJ �t | d �� �t |�� �ksgJ �qE||ksnJ �dS ) a{ We want to ensure a multi-line header parses correctly. For interoperability, the escaped value should also "round-trip" over `email.generator.Generator.flatten` and `email.message_from_*` (see pypa/setuptools#4033). The main issue is that internally `email.policy.EmailPolicy` uses `splitlines` which will split on some control chars. If all the new lines are not prefixed with spaces, the parser will interrupt reading the current header and produce an incomplete value, while incorrectly interpreting the rest of the headers as part of the payload. TFr )�utf8� mangle_from_�max_line_lengthzheader: z other-header: 42 payload )�policyNzpayload z other-header�42�header)r �emailr� � EmailPolicy�io�StringIO�message_from_string� generator� Generator�flatten�seek�message_from_file� get_payload�set� splitlines) r/ �given�wanted�resr� �buffer�raw�orig�regen�msgr r r �test_rfc822_escape� s$ � � "zTestUtil.test_rfc822_escapec C s` t j}dt _z%t�t�� tg � W d � n1 sw Y W |t _d S W |t _d S |t _w )NT)r �dont_write_bytecoderQ rR r r )r/ �old_dont_write_bytecoder r r �test_dont_write_bytecode� s � �z!TestUtil.test_dont_write_bytecodec C s t d�}t|�}|dksJ �d S )NzUnable to find batch filez error: Unable to find batch file)�OSErrorr )r/ �excr� r r r �test_grok_environment_error� s z$TestUtil.test_grok_environment_errorN)�__name__� __module__� __qualname__r0 r8 rC rS rY rQ �mark�skipifrc rh r{ �indent� parametrizer� r� r� r r r r r# + s0 2 ��� $ r# )#�__doc__r� �email.generator� email.policyr� r r? r r r- � unittest.mockr+ r � distutilsr �distutils.errorsr r �distutils.utilr r r r r r r r r r rQ �fixturer! r� � usefixturesr# r r r r �<module> s& 0 _distutils/tests/__pycache__/test_bdist_rpm.cpython-310.pyc 0000644 00000005716 15030122015 0020022 0 ustar 00 o �h\ � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl Z ddl m Z dZ e jdd �d d � �Ze jjd d d�Ze j�d�e j�d�e j�d�G dd� de j����ZdS )z&Tests for distutils.command.bdist_rpm.� N)� bdist_rpm)� Distribution)�support)� requires_zlibz�from distutils.core import setup import foo setup(name='foo', version='0.1', py_modules=['foo'], url='xxx', author='xxx', author_email='xxx') T)�autousec C s2 z t j�d� W d S ty t�d� Y d S w )NzUTF-8z(sys.executable is not encodable to UTF-8)�sys� executable�encode�UnicodeEncodeError�pytest�skip� r r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py�sys_executable_encodable s �r z$not sys.platform.startswith('linux')z)spurious sdtout/stderr output under macOS)�reason�save_env� save_argv�save_cwdc @ s` e Zd Zee� ej�d�ej�d�dd� ����Zee� ej�d�ej�d�dd� ����Z dS )� TestBuildRpmznot shutil.which('rpm')z not shutil.which('rpmbuild')c C s� | � � }|tjd< tj�|d�}t�|� | �|dft� | �|dfd� | �|dfd� | �|dfd � tdd dgd d d d ��}d|_ t� |� dgt _ t |�}d |_d |_|�� |�� t�tj�|d��}d|v soJ �d|jv svJ �d|jv s}J �d S �N�HOME�foozsetup.pyzfoo.py�#z MANIFEST.inzinclude foo.py�README� z0.1�xxx)�name�version� py_modules�url�author� author_emailT�distzfoo-0.1-1.noarch.rpm)r �anyzdist/foo-0.1-1.src.rpm)r r# zdist/foo-0.1-1.noarch.rpm)�mkdtemp�os�environ�path�join�mkdir� write_file�SETUP_PYr � script_name�chdirr �argvr � fix_python�quiet�ensure_finalized�run�listdir� dist_files��self�tmp_dir�pkg_dirr" �cmd� dist_createdr r r � test_quiet+ s8 � zTestBuildRpm.test_quietc C s | � � }|tjd< tj�|d�}t�|� | �|dft� | �|dfd� | �|dfd� | �|dfd � tdd dgd d d d ��}d|_ t� |� dgt _ t |�}d |_d |_|�� |�� t�tj�|d��}d|v soJ �d|jv svJ �d|jv s}J �t�tj�|dd�� d S r )r$ r% r& r' r( r) r* r+ r r, r- r r. r r/ r0 r1 r2 r3 r4 �remover5 r r r �test_no_optimize_flagU s: � z"TestBuildRpm.test_no_optimize_flagN) �__name__� __module__� __qualname__�mac_woesr r �mark�skipifr; r= r r r r r % s & r )�__doc__r% �shutilr �distutils.command.bdist_rpmr �distutils.corer �distutils.testsr r � test.supportr r+ �fixturer rB rC rA � usefixtures�TempdirManagerr r r r r �<module> s, � � _distutils/tests/__pycache__/test_bdist.cpython-310.pyc 0000644 00000002444 15030122015 0017137 0 ustar 00 o �ht � @ s2 d Z ddlmZ ddlmZ G dd� dej�ZdS )z"Tests for distutils.command.bdist.� )�bdist)�supportc @ s e Zd Zdd� Zdd� ZdS )� TestBuildc C sV | � � d }t|�}dg|_|�� |jdgksJ �g d�}t|j�}||ks)J �d S )N� �gztar)�bztarr �rpm�tar�xztar�zip�ztar)� create_distr �formats�ensure_finalized�sorted�format_commands)�self�dist�cmdr �found� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_bdist.py� test_formats s zTestBuild.test_formatsc C sl | � � d }t|�}d|_|�� ||jd< dg}|D ]}|�|�}t|dd�r)q|js3J |� d���qd S )Nr Tr � bdist_dumb� _unsupportedFz$ should take --skip-build from bdist)r r � skip_buildr � command_obj�get_finalized_command�getattr)r r r �names�name�subcmdr r r �test_skip_build s � �zTestBuild.test_skip_buildN)�__name__� __module__� __qualname__r r" r r r r r s r N)�__doc__�distutils.command.bdistr �distutils.testsr �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_build_clib.cpython-310.pyc 0000644 00000007263 15030122015 0020126 0 ustar 00 o �h� � @ sR d Z ddlZddlmZ ddlmZ ddlmZmZ ddl Z G dd� dej �Z dS )z'Tests for distutils.command.build_clib.� N)� build_clib)�DistutilsSetupError)�missing_compiler_executable�supportc @ s@ e Zd Zdd� Zdd� Zdd� Zdd� Zej� d �d d � �Z d S ) � TestBuildCLibc C sN | � � \}}t|�}t�t�� |�d� W d � n1 s w Y t�t�� |�ddg� W d � n1 s;w Y t�t�� |�ddg� W d � n1 sWw Y t�t�� |�ddg� W d � n1 ssw Y t�t�� |�di fd g� W d � n1 s�w Y di fdd d ifg}|�|� d S ) N�foo�foo1�foo2)� r )�namer )r r )z another/namer r )�anotherr �ok�good)� create_distr �pytest�raisesr �check_library_list)�self�pkg_dir�dist�cmd�libs� r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_build_clib.py�test_check_library_dist s. � � � � � � �z%TestBuildCLib.test_check_library_distc C s | � � \}}t|�}di fg|_t�t�� |�� W d � n1 s$w Y dddifg|_t�t�� |�� W d � n1 sEw Y ddddgifg|_|�� ddgks^J �dddifg|_|�� ddgkspJ �dddifdddd gifg|_|�� g d �ks�J �d S ) Nr �sourcesr �a�b)r r �name2�c�d)r r r r )r r � librariesr r r �get_source_files�r r r r r r r �test_get_source_files- s$ � � �z#TestBuildCLib.test_get_source_filesc C s� | � � \}}t|�}G dd� d�}|� |_dddifg}t�t�� |�|� W d � n1 s1w Y ddt� ifg}|�|� ddt� ifg}|�|� d S )Nc @ s e Zd Zdd� ZeZdS )z8TestBuildCLib.test_build_libraries.<locals>.FakeCompilerc _ s d S )Nr )�args�kwr r r �compileL s z@TestBuildCLib.test_build_libraries.<locals>.FakeCompiler.compileN)�__name__� __module__� __qualname__r' �create_static_libr r r r � FakeCompilerK s r, r r �notvalid) r r �compilerr r r �build_libraries�list�tuple)r r r r r, �libr r r �test_build_librariesG s � z"TestBuildCLib.test_build_librariesc C s� | � � \}}t|�}d|_|�� |jdgksJ �d |_|�� |jg ks'J �d|j_t�t�� |�� W d � d S 1 s@w Y d S )Nzone-dir�WONTWORK) r r � include_dirs�finalize_options� distributionr! r r r r# r r r �test_finalize_options^ s "�z#TestBuildCLib.test_finalize_optionsz platform.system() == "Windows"c C s� | � � \}}t|�}tj�|d�}| �|d� dd|gifg|_tj�|d�}t�|� ||_||_t � }|d urB| � d|�d�� |� � dt� |�v sOJ �d S ) Nzfoo.cz int main(void) { return 1;} r r �buildzThe z command is not foundzlibfoo.a) r r �os�path�join� write_filer! �mkdir� build_tempr �skipTest�run�listdir)r r r r �foo_cr? �ccmdr r r �test_runn s zTestBuildCLib.test_runN) r( r) r* r r$ r3 r8 r �mark�skipifrE r r r r r s ! r ) �__doc__r: � distutils.command.build_clibr �distutils.errorsr �distutils.testsr r r �TempdirManagerr r r r r �<module> s _distutils/tests/__pycache__/test_sdist.cpython-310.pyc 0000644 00000025715 15030122015 0017166 0 ustar 00 o �h�: � @ s d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z m Z ddl m Z ddl mZ ddlmZ ddlmZ dd lmZ ddlZddlZddlZdd lmZ d d lm Z d d l m Z m Z m Z m!Z! dZ"dZ#ej$dd�dd� �Z%dd� Z&G dd� de j'�Z(dS )z"Tests for distutils.command.sdist.� N)�ARCHIVE_FORMATS)�sdist� show_formats)� Distribution)�DistutilsOptionError)�FileList)�join)�dedent)�ilen� )�support)�grp�pwd� require_uid_0�require_unix_idzF from distutils.core import setup import somecode setup(name='fake') z�# file GENERATED by distutils, do NOT edit README buildout.cfg inroot.txt setup.py data%(sep)sdata.dt scripts%(sep)sscript.py some%(sep)sfile.txt some%(sep)sother_file.txt somecode%(sep)s__init__.py somecode%(sep)sdoc.dat somecode%(sep)sdoc.txt T)�autousec c sf � | j }|�� |_tj�ddidtd�|j� t�|j�� d V W d � d S 1 s,w Y d S )Nz __init__.py�#�xxx)�somecode�README�setup.py)�instance�mkdtemp�tmp_dir�jaraco�path�build�SETUP_PY�Path)�request�distutils_managed_tempdir�self� r" �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_sdist.py� project_dir/ s � ��� "�r$ c c sR � t �| �jdd��}td ttj|��E d H W d � d S 1 s"w Y d S )N�utf-8��encoding)�pathlibr �open�filter�map�str�strip)�filepath�fr" r" r# � clean_linesA s �"�r0 c @ sL e Zd Zd)dd�Zej�d�dd� �Zej�d�ej�d�ej�d�d d � ���Z ej�d�d d � �Z e d*dd��Z ej�d�dd� �Z dd� Zdd� Zdd� Zdd� Zdd� Zej�d �d d � �Zej�d�d d � �Zej�d�d!d"� �Zej�d�d#d$� �Zej�d�d%d&� �Zej�d�eeej�d�ej�d�d'd(� �����ZdS )+� TestSDistNc C sJ |du r dddddd�}t |�}d|_dg|_d|_t|�}d |_||fS ) z Returns a cmdNz ns.fake--pkgz1.0r )�name�version�url�author� author_emailr r T�dist)r � script_name�packages�include_package_datar �dist_dir)r! �metadatar7 �cmdr" r" r# �get_cmdG s �zTestSDist.get_cmd� needs_zlibc C s0 t �t| jdd�� | �| jdddfd� t �t| jdd�� | �| jdddfd� t �t| jdd�� | �| jdddfd� | �| jddfd� | �� \}}d g|_|�� |�� t| jd �}t � |�}|d gksmJ �t � t|d ��}z |� � }W |� � n|� � w g d �}t|�d d� |D �ks�J �d S )Nr z.svnzok.pyr �.hg�okz.gitz.nfs0001�zipr7 �ns_fake_pkg-1.0.zip)� �PKG-INFOr r � somecode/�somecode/__init__.pyc S � g | ]}d | �qS �zns_fake_pkg-1.0/r" ��.0�xr" r" r# � <listcomp>� � z2TestSDist.test_prune_file_list.<locals>.<listcomp>)�os�mkdirr r � write_filer> �formats�ensure_finalized�run�listdir�zipfile�ZipFile�namelist�close�sorted)r! r7 r= � dist_folder�files�zip_file�content�expectedr" r" r# �test_prune_file_listY s( z TestSDist.test_prune_file_listznot shutil.which('tar')znot shutil.which('gzip')c C s� | � � \}}ddg|_|�� |�� t| jd�}t�|�}|�� |ddgks*J �t� t|d�� t� t|d�� ddg|_|�� |�� t�|�}|�� |ddgksXJ �d S )N�gztar�tarr7 zns_fake_pkg-1.0.tar�ns_fake_pkg-1.0.tar.gz) r> rR rS rT r r rO rU �sort�remove)r! r7 r= r[ �resultr" r" r# �test_make_distribution� s z TestSDist.test_make_distributionc C s� | � � \}}ddgdgd�|_| �| jddfd� | �| jddfd� t| jd �}t�|� | �|d fd� t| jd �}t�|� t| jd �}t�|� | �|d fd� | �| jdfd� | �| jdfd� | �|dfd� | �|dfd� d g d�fddg|_t| jd�}t�|� | �|dfd� tdd�g|_dg|_ d|_ |� � |� � t| jd�}t� |�}|dgks�J �t�t|d��} z | �� } W | �� n| �� w g d�} t| �d d � | D �ks�J �t�| jd �jd d �} | td!tji ks�J �d S )"Nz*.cfgz*.dat�*.txt)rD r r �doc.txtr zdoc.dat�datazdata.dt�somer@ zlast-message.txt� buildout.cfg� inroot.txtzfile.txtzother_file.txt)� data/data.dtrl rm � notexisting� some/file.txt�some/other_file.txt�scriptsz script.pyrB Tr7 rC )rD rE r rl zdata/rn rm zscripts/zscripts/script.pyr zsome/rp rq rF rG zsomecode/doc.datzsomecode/doc.txtc S rH rI r" rJ r" r" r# rM � rN z/TestSDist.test_add_defaults.<locals>.<listcomp>�MANIFESTr% r& �sep)r> � package_datarQ r r rO rP � data_filesrr rR � use_defaultsrS rT rU rV rW rX rY rZ r( r � read_textrs rt ) r! r7 r= �data_dir�some_dir�hg_dir� script_dirr[ r\ r] r^ r_ �manifestr" r" r# �test_add_defaults� sN � zTestSDist.test_add_defaults� warning: c s � fdd�| D �S )Nc s g | ] }|� � �r|�qS r" )� startswith)rK �msg��prefixr" r# rM s z&TestSDist.warnings.<locals>.<listcomp>r" )�messagesr� r" r� r# �warnings� s zTestSDist.warningsc C s� | j i d�\}}|�� |�� t| �|jd��dks J �|�� | � � \}}|�� d|_|�� t| �|jd��dks?J �d S )N)r< zwarning: check: r Fr )r> rS rT �lenr� r� �clear�metadata_check)r! �caplogr7 r= r" r" r# �test_metadata_check_option s z$TestSDist.test_metadata_check_optionc C s@ t � tt�� �}dd� |�� j�d�D �}t|�|ks J �d S )Nc S s g | ] }|� � �d �r|�qS )z --formats=)r- r� )rK �liner" r" r# rM s ��z/TestSDist.test_show_formats.<locals>.<listcomp>� )r r� r �keys� readouterr�out�split)r! �capsys� num_formats�outputr" r" r# �test_show_formats s �zTestSDist.test_show_formatsc C s� | � � \}}|�� |jdksJ �|jdksJ �|jdks J �d|_t�t�� |�� W d � n1 s6w Y dg|_|�� d|_t�t�� |�� W d � d S 1 s[w Y d S )Nrs � MANIFEST.inr7 r rB �supazipa) r> �finalize_optionsr} �templater; rR �pytest�raisesr �r! r7 r= r" r" r# �test_finalize_options! s � "�z TestSDist.test_finalize_optionsc C sX | � � \}}t�| j� | �d|� |�� t� |_|�� t | � |j ��dks*J �d S )Nr� r ) r> rO �chdirr rQ rS r �filelist� read_templater� r� r� )r! r^ r� r7 r= r" r" r# �_check_template: s zTestSDist._check_templatec C � | � d|� d S )Nztaunt knights *�r� �r! r� r" r" r# �%test_invalid_template_unknown_commandC s z/TestSDist.test_invalid_template_unknown_commandc C r� )N�pruner� r� r" r" r# �%test_invalid_template_wrong_argumentsF s z/TestSDist.test_invalid_template_wrong_argumentsz platform.system() != 'Windows'c C r� )Nzinclude examples/r� r� r" r" r# � test_invalid_template_wrong_pathJ s z*TestSDist.test_invalid_template_wrong_pathc C s� | � � \}}ddgi|_| �| jddfd� dg|_|�� |�� tt|j ��dks-J �| �| jddfd� |� d�}d |_ |�� |�� t t|j ��}t |�d ksVJ �d|d v s^J �d S ) Nr rh ri r ra � zdoc2.txt�build_pyF� ���)r> ru rQ r rR rS rT r r0 r} �get_command_obj� finalized�listr� )r! r7 r= r� � manifest2r" r" r# �test_get_file_listP s z TestSDist.test_get_file_listc C s6 | � � \}}|�� |�� tt|j��dksJ �d S )Nz*# file GENERATED by distutils, do NOT edit)r> rS rT �nextr0 r} r� r" r" r# �test_manifest_markern s �z TestSDist.test_manifest_markerc C s� t d�}| �� \}}|�� | �| j|jf|� | �| jdfd� | �| jdfd� | �| jdfd� |�� |jjdgks@J �d S )NzI # bad.py #bad.py good.py zgood.pyz # pick me!zbad.pyz# don't pick me!z#bad.py) r r> rS rQ r r} rT r� r\ )r! �contentsr7 r= r" r" r# �test_manifest_commentsz s � z TestSDist.test_manifest_commentsc C s� | � � \}}dg|_|�� | �| j|jfd� | �| jdfd� |�� |jjdgks.J �t t |j��dgks:J �t | jdd�}t � |�}z dd� |D �}W |�� n|�� w t|�g d�kscJ �d S ) Nra z README.manualz0This project maintains its MANIFEST file itself.r7 rc c S s g | ]}|j �qS r" )r2 )rK �tarinfor" r" r# rM � s z2TestSDist.test_manual_manifest.<locals>.<listcomp>)zns_fake_pkg-1.0zns_fake_pkg-1.0/PKG-INFOz ns_fake_pkg-1.0/README.manual)r> rR rS rQ r r} rT r� r\ r� r0 r �tarfiler) rY rZ )r! r7 r= � archive_name�archive� filenamesr" r" r# �test_manual_manifest� s" � z TestSDist.test_manual_manifestc C s | � � \}}dg|_t�d�d |_t�d�d |_|�� |� � t | j dd�}t � |�}z|�� D ]}|jdks<J �|jdksCJ �q3W |�� n|�� w | � � \}}dg|_|�� |� � t | j dd�}t � |�}z|�� D ] }|jt�� ks}J �qrW |�� d S |�� w )Nra r r7 rc )r> rR r �getpwuid�ownerr �getgrgid�grouprS rT r r r� r) � getmembers�uid�gidrY rO �getuid)r! r7 r= r� r� �memberr" r" r# �"test_make_distribution_owner_group� s2 � �z,TestSDist.test_make_distribution_owner_group)N)r )�__name__� __module__� __qualname__r> r� �mark� usefixturesr` �skipifrg r~ � staticmethodr� r� r� r� r� r� r� r� r� r� r� r� r r r� r" r" r" r# r1 F sF 0 T r1 ))�__doc__rO r( �shutilr� rV �distutils.archive_utilr �distutils.command.sdistr r �distutils.corer �distutils.errorsr �distutils.filelistr �os.pathr �textwrapr � jaraco.pathr r r� �more_itertoolsr rD r � unix_compatr r r r r rs �fixturer$ r0 �TempdirManagerr1 r" r" r" r# �<module> s2 _distutils/tests/__pycache__/test_file_util.cpython-310.pyc 0000644 00000006661 15030122015 0020013 0 ustar 00 o �h� � @ sr d Z ddlZddlZddlmZ ddlmZ ddlmZm Z ddl Z ddl Z e j dd�dd� �ZG d d � d �ZdS ) z Tests for distutils.file_util.� N)�DistutilsFileError)� copy_file� move_fileT)�autousec C s( | j }|d |_|d |_|d |_d S )N�f1�f2�d1)�instance�source�target� target_dir)�request�tmp_path�self� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_file_util.py�stuff s r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) � TestFileUtilc C s� t j�| jdi� t| j| jdd� |jrJ �t| j| jdd� t| j| jdd� d| j� d| j� �g}|j|ks;J �t| j| jdd� |�� t� | j � t| j| j dd� d| j� d| j � �g}|j|ksiJ �d S )N� some contentF��verboseTzmoving z -> ) �jaraco�path�buildr r r �messages�clear�os�mkdirr )r �caplog�wantedr r r �test_move_file_verbosity s z%TestFileUtil.test_move_file_verbosityc C s� t jdtdd�d��8 t�t�� tj�| j di� t | j | j dd� W d � n1 s-w Y W d � d S W d � d S 1 sEw Y d S )N� os.rename�wrong� �� side_effect� spam eggsFr ) �mock�patch�OSError�pytest�raisesr r r r r r r �r r r r �)test_move_file_exception_unpacking_rename- s ��P�z6TestFileUtil.test_move_file_exception_unpacking_renamec C s� t jdttjd�d��R t jdtdd�d��/ t�t�� tj � | j di� t | j | j dd� W d � n1 s9w Y W d � n1 sHw Y W d � d S W d � d S 1 s`w Y d S ) Nr! r" r$ z os.unlinkr# r& Fr )r' r( r) �errno�EXDEVr* r+ r r r r r r r r, r r r �)test_move_file_exception_unpacking_unlink6 s ��� ��P z6TestFileUtil.test_move_file_exception_unpacking_unlinkc C s� t j�| jdi� z t�| j| j� W n ty- } z| �d|� �� W Y d }~n d }~ww | j� � t� | j�}t | j| jdd� t� | j�}t� | j�}tj� ||�s[J ||f��tj� ||�shJ ||f��| jj dd�dkssJ �d S )Nr z os.link: �hard��link�utf-8��encoding)r r r r r r3 r r) �skipTest�unlink�statr �samestat� read_text)r �e�st�st2�st3r r r �test_copy_file_hard_link@ s �� z%TestFileUtil.test_copy_file_hard_linkc C s� t j�| jdi� t�| j�}tjdtdd�d�� t | j| j dd� W d � n1 s-w Y t�| j�}t�| j �}tj� ||�sKJ ||f��tj� ||�rXJ ||f��| j| j fD ] }|j dd �dksjJ �q^d S ) Nr zos.linkr zlinking unsupportedr$ r1 r2 r4 r5 ) r r r r r r9 r' r( r) r r r: r; )r r= r> r? �fnr r r � test_copy_file_hard_link_failureR s � �z-TestFileUtil.test_copy_file_hard_link_failureN)�__name__� __module__� __qualname__r r- r0 r@ rB r r r r r s r )�__doc__r. r � unittest.mockr' �distutils.errorsr �distutils.file_utilr r � jaraco.pathr r* �fixturer r r r r r �<module> s _distutils/tests/__pycache__/test_filelist.cpython-310.pyc 0000644 00000020174 15030122015 0017645 0 ustar 00 o �h* � @ s� d Z ddlZddlZddlZddlmZmZ ddlmZ ddl m Z m Z m Z ddl ZddlZddlmZ dZd d � ZG d d � d �ZG d d� d�ZdS )z Tests for distutils.filelist.� N)�debug�filelist)�DistutilsTemplateError)�FileList� glob_to_re�translate_pattern� )�py39z�include ok include xo exclude xo include foo.tmp include buildout.cfg global-include *.x global-include *.txt global-exclude *.tmp recursive-include f *.oo recursive-exclude global *.x graft dir prune dir3 c C s | � dtj�S )z"Converts '/' in a string to os.sep�/)�replace�os�sep)�s� r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_filelist.py�make_local_path s r c @ sd e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dS )� TestFileListc C s$ dd� |j D �}|r J �|�� d S )Nc S � g | ] }|j tjkr|�qS r ��levelno�logging�WARNING��.0�recr r r � <listcomp>& � z1TestFileList.assertNoWarnings.<locals>.<listcomp>��records�clear��self�caplog�warningsr r r �assertNoWarnings% � z TestFileList.assertNoWarningsc C s$ dd� |j D �}|s J �|�� d S )Nc S r r r r r r r r + r z/TestFileList.assertWarnings.<locals>.<listcomp>r r r r r �assertWarnings* r% zTestFileList.assertWarningsc C sJ t j}t jdkrt�t j�}dD ]\}}|d|i }t|�|ks"J �qd S )N�\))zfoo*z(?s:foo[^%(sep)s]*)\Z)zfoo?z(?s:foo[^%(sep)s])\Z)zfoo??z (?s:foo[^%(sep)s][^%(sep)s])\Z)zfoo\\*z(?s:foo\\\\[^%(sep)s]*)\Z)zfoo\\\*z(?s:foo\\\\\\[^%(sep)s]*)\Z)zfoo????z2(?s:foo[^%(sep)s][^%(sep)s][^%(sep)s][^%(sep)s])\Z)zfoo\\??z"(?s:foo\\\\[^%(sep)s][^%(sep)s])\Zr )r r �re�escaper )r! r �glob�regexr r r �test_glob_to_re/ s �z TestFileList.test_glob_to_rec C s� t � }t}ddddd|d�|d�|d�|d �|d �|d �|d �|d �|d�|d�g|_t�d�D ]}|�� dkr9q0|�|� q0ddd|d�|d�|d�|d �|d �|d �g }|j|ks]J �d S )Nzfoo.tmp�ok�xozfour.txtz buildout.cfgz.hg/last-message.txtzglobal/one.txtzglobal/two.txtzglobal/files.xzglobal/here.tmpzf/o/f.ooz dir/graft-onezdir/dir2/graft2zdir3/okzdir3/sub/ok.txt� � )r r �allfiles� MANIFEST_IN�split�strip�process_template_line�files)r! � file_list�mlp�line�wantedr r r �test_process_template_lineB sB � � z'TestFileList.test_process_template_linec C sP t � }|�d� |�� jdksJ �|�tdd� |�d� |�� jdks&J �d S )N�xxxr0 �DEBUGTzxxx )r � debug_print� readouterr�out�setattrr )r! �capsys� monkeypatchr7 r r r �test_debug_printo s z TestFileList.test_debug_printc C s* t � }g d�}|�|� |j|ksJ �d S )N)�a�b�c)r � set_allfilesr1 )r! r7 r6 r r r �test_set_allfilesx s z TestFileList.test_set_allfilesc C s6 t � }g d�|_|�� |�� |jg d�ksJ �d S )N)rE rF rE �grG rJ )rE rF rG rJ )r r6 �sort�remove_duplicates�r! r7 r r r �test_remove_duplicates~ s z#TestFileList.test_remove_duplicatesc C sl t tdddd�d�s J �t�d�}t|ddd�|ks J �t tdddd�d�s(J �tdddd��d�s4J �d S )NrE TF)�anchor�is_regex�search�*.pyz filelist.py)�hasattrr r( �compilerQ )r! r+ r r r �test_translate_pattern� s �z#TestFileList.test_translate_patternc C s` t � }|�d�r J �t � }ddg|_|�d�sJ �t � }ddg|_|�d� |jdgks.J �d S )NrR �a.pyzb.pyza.txt)r �exclude_patternr6 rM r r r �test_exclude_pattern� s z!TestFileList.test_exclude_patternc C s� t � }|�g � |�d�rJ �t � }|�ddg� |�d�s J �t � }|jd u s*J �|�ddg� |�d� |jddgks?J �d S )NrR rV �b.txt�*)r rH �include_patternr1 rM r r r �test_include_pattern� s z!TestFileList.test_include_patternc C s� t }t� }dD ] }t�t�� |�|� W d � n1 s w Y qt� }|�dd|d�g� |�d� |jdgks>J �| �|� |�d� |jdgksPJ �| � |� t� }dd|d�g|_|�d� |jd|d�gkspJ �| �|� |�d� |jd|d�gks�J �| � |� t� }|�dd|d�g� |�d � |jd|d�gks�J �| �|� |�d � |jd|d�gks�J �| � |� t� }dd|d�g|_|�d � |jdgks�J �| �|� |�d � |jdgks�J �| � |� t� }|�d|d �|d�|d�g� |�d� |j|d �|d�gk�sJ �| �|� |�d� |j|d �|d�gk�s-J �| � |� t� }d|d �|d�|d�g|_|�d� |jd|d�gk�sSJ �| �|� |�d� |jd|d�gk�siJ �| � |� t� }|�d|d �|d�|d�g� |�d� |j|d �|d�gk�s�J �| �|� |�d� |j|d �|d�gk�s�J �| � |� t� }d|d �|d�|d�g|_|�d� |jd|d�gk�s�J �| �|� |�d� |jd|d�gk�s�J �| � |� d S )N) �include�excludezglobal-includezglobal-excludezrecursive-includezrecursive-exclude�graft�prune�blargrV rY zd/c.pyz include *.pyz include *.rbz exclude *.pyz exclude *.rbzglobal-include *.pyzglobal-include *.rbzglobal-exclude *.pyzglobal-exclude *.rbzd/b.pyzd/c.txtzd/d/e.pyzrecursive-include d *.pyzrecursive-include e *.pyzrecursive-exclude d *.pyzrecursive-exclude e *.pyzf/f.pyzgraft dzgraft ezprune dzprune e) r r �pytest�raisesr r5 rH r6 r$ r& )r! r" r8 r7 �actionr r r �test_process_template� s� �� z"TestFileList.test_process_templateN)�__name__� __module__� __qualname__r$ r& r, r; rD rI rN rU rX r\ re r r r r r $ s - r c @ s8 e Zd Zejdd� �Zdd� Zdd� Zejdd� �Zd S ) � TestFindAllc C s t �dd� t�� g ksJ �d S )N�foo�bar)r �symlinkr �findall)r! �temp_cwdr r r �test_missing_symlink, s z TestFindAll.test_missing_symlinkc C sV t j�ddiddid�� tj�dd�}tj�dd�}||g}tt�� �|ks)J �dS )z� When findall is called with no parameters or with '.' as the parameter, the dot should be omitted from the results. � file1.txtr0 z file2.txt)rj rk rj rk N)�jaraco�path�buildr �join�sortedr rm )r! rn �file1�file2�expectedr r r �test_basic_discovery1 s z TestFindAll.test_basic_discoveryc C s6 t j�ddi|� t|d �g}t�|�|ksJ �dS )zj When findall is called with another path, the full path name should be returned. rp r0 N)rq rr rs �strr rm )r! �tmp_pathrx r r r �test_non_local_discovery= s z$TestFindAll.test_non_local_discoveryc C s: t j�t j�d�dd�|� t�|�}t|�dksJ �d S )N�.r0 )zlink-to-parent�somefiler )rq rr rs �Symlinkr rm �len)r! r{ r6 r r r �test_symlink_loopF s �� z TestFindAll.test_symlink_loopN) rf rg rh � os_helper�skip_unless_symlinkro ry r| r� r r r r ri + s ri )�__doc__r r r( � distutilsr r �distutils.errorsr �distutils.filelistr r r � jaraco.pathrq rb �compatr r� r2 r r ri r r r r �<module> s _distutils/tests/__pycache__/test_install_headers.cpython-310.pyc 0000644 00000002220 15030122015 0021163 0 ustar 00 o �h� � @ sN d Z ddlZddlmZ ddlmZ ddlZej�d�G dd� dej ��Z dS )z,Tests for distutils.command.install_headers.� N)�install_headers)�support�save_envc @ s e Zd Zdd� ZdS )�TestInstallHeadersc C s� | � � }tj�|d�}tj�|d�}| �|� | �|� ||g}| j|d�\}}t|�}|�� |ks4J �tj�|d�|_|� � |� � t |� � �dksNJ �d S )N�header1�header2)�headers�inst� ) �mkdtemp�os�path�join� write_file� create_distr � get_inputs� install_dir�ensure_finalized�run�len� get_outputs)�self� header_listr r r �pkg_dir�dist�cmd� r �c/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_install_headers.py�test_simple_run s z"TestInstallHeaders.test_simple_runN)�__name__� __module__� __qualname__r r r r r r s r ) �__doc__r �!distutils.command.install_headersr �distutils.testsr �pytest�mark� usefixtures�TempdirManagerr r r r r �<module> s � _distutils/tests/__pycache__/test_dist.cpython-310.pyc 0000644 00000040610 15030122015 0016772 0 ustar 00 o �hiI � @ s: d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl Z ddl m Z ddlmZmZ ddlmZ ddlmZ ddlZddlZdejdk d ZG d d � d e �ZG d d � d e�Zej dd� �Z ej ej � d�ej � d�G dd� dej!����Z"ej � d�ej � d�G dd� dej!���Z#dS )zTests for distutils.dist.� N)�Command)� Distribution�fix_help_options)�support)�ClassVar�.�posixzpydistutils.cfgc @ s: e Zd ZU dZdgZeeeeeef e d< dd� Z dS )� test_distz#Sample distutils extension command.)zsample-option=�Sz help text� user_optionsc C s d | _ d S �N)� sample_option��self� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_dist.py�initialize_options s z test_dist.initialize_optionsN) �__name__� __module__� __qualname__�__doc__r r �list�tuple�str�__annotations__r r r r r r s � r c @ s e Zd ZdZdd� ZdS )�TestDistributionz�Distribution subclasses that avoids the default search for configuration files. The ._config_files attribute must be set before .parse_config_files() is called. c C s | j S r )� _config_filesr r r r �find_config_files+ s z"TestDistribution.find_config_filesN)r r r r r r r r r r # s r c C s t jdd �= d S )N� )�sys�argvr r r r � clear_argv/ s r! �save_env� save_argvc @ s� e Zd Zd dd�Zdd� Zdd� Zejjde j jvd d �d d � �Z d d� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd� Zejjdd d �d d � �Zd S )!�TestDistributionBehaviorr c C s t � }||_|�� |�� |S r )r r �parse_config_files�parse_command_line)r � configfiles�dr r r �create_distribution8 s z,TestDistributionBehavior.create_distributionc C s* t j�d� | �� }|�� dgksJ �d S )N�build�distutils.command)r r �appendr) �get_command_packages)r r! r( r r r �!test_command_packages_unspecified? s z:TestDistributionBehavior.test_command_packages_unspecifiedc C sb ddl m} tj�g d�� | �� }|�� g d�ks J �|�d�}t||�s(J �|j dks/J �d S )Nr )r )�--command-packageszfoo.bar,distutils.testsr z -Ssometext)r+ �foo.barzdistutils.testsr �sometext) �distutils.tests.test_distr r r �extendr) r- �get_command_obj� isinstancer )r r! r r( �cmdr r r � test_command_packages_cmdlineD s z6TestDistributionBehavior.test_command_packages_cmdline� distutilsz;Cannot test when virtualenv has monkey-patched Distribution)�reasonc C s� t j�d� t|d �}d}tj�|d|� d|� d|� d|� d|� d |� d |� d |� d |� d |� d|� d|� d|� d�i� tjj t ddd�� | � |g�}W d � n1 sXw Y ||f}|||||||||||||d� }t |j � d��� �t |�� �ks�J �|j � d��� D ] \}} | || ks�J �q�tjj t ddd�� | � |g�}W d � n1 s�w Y |�� D ] }||j � di �vs�J �q�d S )N�install�filez/somedirzB [install] install-base = z( install-platbase = z# install-lib = z' install-platlib = z' install-purelib = z' install-headers = z' install-scripts = z$ install-data = z prefix = z# exec-prefix = z home = z user = z root = z z/a)�prefix� base_prefix) � install_base�install_platbase� install_lib�install_platlib�install_purelib�install_headers�install_scripts� install_datar< � exec_prefix�home�user�rootz/b)r r r, r �jaraco�pathr* �mock�patch�multipler) �sorted�command_options�get�keys�items) r �tmp_pathr! r; �fakepathr( � option_tuple� result_dict�key�valuer r r �test_venv_install_optionsX sz ������� � � � � ��� �� � � �z2TestDistributionBehavior.test_venv_install_optionsc C s� t j�d� t|d �}tj�|di� | �|g�}|�� g d�ks$J �g d�t jdd �< | �|g�}|�� ddgks=J �g d �t jdd �< | �|g�}|�� dgksUJ �d S ) Nr* r; zh [global] command_packages = foo.bar, splat )r+ r0 �splat)r/ �sporkr* r r+ r\ )r/ � r* ) r r r, r rJ rK r* r) r- )r rT r! r; r( r r r � test_command_packages_configfile� s � z9TestDistributionBehavior.test_command_packages_configfilec sh g � � fdd�}|� t�ttdtj�� |t_tddddi d�d�}t� �dks*J �d t|�vs2J �d S ) Nc s � � | � d S r )r, )�msg��warnsr r �_warn� s z:TestDistributionBehavior.test_empty_options.<locals>._warn�warn�xxx�xxxx)�author�name�version�url�options��attrsr rj ) � addfinalizer� functools�partial�setattr�warningsrc r �len�dir)r �requestrb �distr r` r �test_empty_options� s ��� z+TestDistributionBehavior.test_empty_optionsc C s� ddd�}t |d�}|�� |jjddgksJ �|jjddgks"J �ddd�}t |d�}|�� |jjdgks9J �|jjdgksBJ �d S )N�one,two)�keywords� platformsrk �one�twozfoo bar)r �finalize_options�metadatary rx �r rl ru r r r �test_finalize_options� s z.TestDistributionBehavior.test_finalize_optionsc C s\ t � }|jd u s J �|�� }|dgksJ �|jdgks J �d|_|�� }|g d�ks,J �d S )Nr+ rw )r+ rz r{ )r �command_packagesr- )r ru �cmdsr r r �test_get_command_packages� s z2TestDistributionBehavior.test_get_command_packagesc C sD t � }t�t�� |jddd� W d � d S 1 sw Y d S )N�ok�ok2)�level)r �pytest�raises� TypeError�announce)r ru r r r � test_announce� s "�z&TestDistributionBehavior.test_announcec C sT t j�tdi|� t� }|�� }tddgid�}|�� }t|�d t|�ks(J �d S )Nz [distutils] � script_args� --no-user-cfgrk r )rJ rK r* �pydistutils_cfgr r rr )r � temp_homer( � all_files�filesr r r � test_find_config_files_disable� s z7TestDistributionBehavior.test_find_config_files_disablec C s$ t ddid�}|jddgksJ �d S )Nr� )r* r� rk r* r� )r r� )r r( r r r � test_script_args_list_coercion� s z7TestDistributionBehavior.test_script_args_list_coercionz platform.system() == "Windows"z Windows does not honor chmod 000c C s, |� t�jddd� |�d� t� �� dS )zV Finding config files should not fail when directory is inaccessible. r] zutf-8)�encodingr N)�joinpathr� � write_text�chmodr r )r � fake_homer r r �'test_find_config_files_permission_error s z@TestDistributionBehavior.test_find_config_files_permission_errorN)r )r r r r) r. r7 r� �mark�skipifr r% rZ r^ rv r r� r� r� r� r� r r r r r$ 4 s* � = �r$ c @ s� e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1S )2� TestMetadatac C s t �� }|j�|� |�� S r )�io�StringIOr} �write_pkg_file�getvalue)r ru �sior r r �format_metadata s z TestMetadata.format_metadatac C s\ ddd�}t |�}| �|�}d|v sJ �d|�� vs J �d|�� vs$J �d|�� vs,J �d S )N�package�1.0)rg rh zMetadata-Version: 1.0� provides:� requires:� obsoletes:)r r� �lower�r rl ru �metar r r �test_simple_metadata s z!TestMetadata.test_simple_metadatac C s| ddddgd�}t |�}|j�� ddgksJ �|�� ddgks!J �| �|�}d|v s,J �d|�� vs4J �d|�� vs<J �d S )Nr� r� z package.sub�rg rh �provides�Metadata-Version: 1.1r� r� )r r} � get_providesr� r� r� r r r � test_provides s � zTestMetadata.test_providesc C �B t �t�� tdddgd�� W d � d S 1 sw Y d S )Nr� r� �my.pkg (splat)r� �r� r� � ValueErrorr r r r r �test_provides_illegal, � �"�z"TestMetadata.test_provides_illegalc C s� ddddgd�}t |�}|j�� ddgksJ �|�� ddgks!J �| �|�}d|v s,J �d|�� vs4J �d|v s:J �d |v s@J �d |�� vsHJ �d S ) Nr� r� �otherzanother (==1.0)�rg rh �requiresr� r� zRequires: otherzRequires: another (==1.0)r� )r r} � get_requiresr� r� r� r r r � test_requires2 s � zTestMetadata.test_requiresc C r� )Nr� r� r� r� r� r r r r �test_requires_illegalB r� z"TestMetadata.test_requires_illegalc C �. dt dg�d�}t|�}t|jjt�sJ �d S )Nr� r� )rg r� )�iterr r5 r} r� r r~ r r r �test_requires_to_listH � z"TestMetadata.test_requires_to_listc C s� ddddgd�}t |�}|j�� ddgksJ �|�� ddgks!J �| �|�}d|v s,J �d|�� vs4J �d|�� vs<J �d |v sBJ �d |v sHJ �d S ) Nr� r� r� zanother (<1.0)�rg rh � obsoletesr� r� r� zObsoletes: otherzObsoletes: another (<1.0))r r} � get_obsoletesr� r� r� r r r �test_obsoletesM s � zTestMetadata.test_obsoletesc C r� )Nr� r� r� r� r� r r r r �test_obsoletes_illegal] r� z#TestMetadata.test_obsoletes_illegalc C r� )Nr� r� )rg r� )r� r r5 r} r� r r~ r r r �test_obsoletes_to_listc r� z#TestMetadata.test_obsoletes_to_listc C sB dddgd�}t |�}|�� dgksJ �| �|�}d|v s J �d S )N�Boa�3.0�#Programming Language :: Python :: 3�rg rh � classifiersr� )r �get_classifiersr� r� r r r �test_classifierh s � z TestMetadata.test_classifierc C �T dddd�}t |�}d|jd v sJ �t|jjt�s J �|jjt|d �ks(J �d S )Nr� r� )r� r� �should be a listr r� )r �messagesr5 r} r� r �r �caplogrl r( r r r � test_classifier_invalid_types � � z)TestMetadata.test_classifier_invalid_typec C s0 ddg d�d�}t |�}|�� g d�ksJ �d S )N�Montyr� ��spam�eggsz life of brian�rg rh rx )r � get_keywordsr~ r r r � test_keywords� � �zTestMetadata.test_keywordsc C r� )Nr� r� r� r� r� r rx )r r� r5 r} rx r r� r r r �test_keywords_invalid_type� r� z'TestMetadata.test_keywords_invalid_typec C s0 ddddgd�}t |�}|�� ddgksJ �d S )Nr� r� � GNU/Linux�Some Evil Platform�rg rh ry )r � get_platformsr~ r r r �test_platforms� r� zTestMetadata.test_platformsc C r� )Nr� r� )r� r� r� r� r ry )r r� r5 r} ry r r� r r r � test_platforms_invalid_types� r� z)TestMetadata.test_platforms_invalid_typesc C s. dddd�}t |�}| �|�}d|v sJ �d S )Nr� r� zhttp://example.org/boa)rg rh � download_urlr� )r r� r� r r r �test_download_url� s � z TestMetadata.test_download_urlc C sD t �d�}dd|d�}t|�}| �|�}|�dd�}||v s J �d S )Nzc example:: We start here and continue here and end here.r� r� �rg rh �long_descriptionz � )�textwrap�dedentr r� �replace)r � long_descrl ru r� r r r �test_long_description� s � z"TestMetadata.test_long_descriptionc C s4 t j�tdi|� |t }t|�t� �� v sJ �dS )z* pydistutils.cfg is found r] N)rJ rK r* r� r r r )r r� � config_pathr r r �test_custom_pydistutils� s z$TestMetadata.test_custom_pydistutilsc C sD t j�ddi|� |d }|�dt|�� t|�t� �� v s J �d S )Nz overrides.cfgr] �DIST_EXTRA_CONFIG)rJ rK r* �setenvr r r )r � monkeypatchrT �filenamer r r �test_extra_pydistutils� s z#TestMetadata.test_extra_pydistutilsc C s4 ddg}t |�}|d dksJ �|d dksJ �d S )N)�a�b�cr( )r � � � r )r� r� r� r )r r� r� )r )r � help_tuples� fancy_optionsr r r �test_fix_help_options� s z"TestMetadata.test_fix_help_optionsc C sF t � }g t_d|_d|_|�� dd� |�� j�d�D �}|s!J �d S )NTzsetup.pyc S s g | ] }|� � d kr|�qS )r] )�strip)�.0�liner r r � <listcomp>� s z/TestMetadata.test_show_help.<locals>.<listcomp>r� ) r r r �help� script_namer& � readouterr�out�split)r rt �capsysru �outputr r r �test_show_help� s � zTestMetadata.test_show_helpc C s� dddddddgdgd �}t |�}|j}t�� }|�|� |�d � |�|� |jdks.J �|jdks5J �|j dks<J �|j dksCJ �|j ddgksLJ �|j d u sSJ �|j d u sZJ �|jdgksbJ �d S ) Nr� r� �descrd zhttp://example.comrz r{ �foo)rg rh r� � descriptionr� rx r� r )r r} r� r� r� �seek� read_pkg_filerg rh r r� rx ry r� r� )r rl ru r} �PKG_INFOr r r �test_read_metadata� s, � z TestMetadata.test_read_metadatac C s� dddd�}t |�}|j}t�� �}|�|� |�� }W d � n1 s%w Y t�|�}tjj dddd �}t�� � }tj j ||d �� |� |� d� t�|�}W d � n1 s\w Y t|d �� �} t|d �� �} | | kswJ �dS ) z� In pypa/setuptools#4033, it was shown that once PKG-INFO is re-generated using ``email.generator.Generator``, some control characters might cause problems. r� r� z hello world r� NTFr )�utf8� mangle_from_�max_line_length)�policy� Description)r r} r� r� r� r� �email�message_from_stringr � EmailPolicy� generator� Generator�flattenr �message_from_file�set� splitlines) r rl ru r} �bufferr_ �origr �regen� orig_desc� regen_descr r r �'test_round_trip_through_email_generator s0 � � � �z4TestMetadata.test_round_trip_through_email_generatorN)r r r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r# r r r r r� s2 r� )$r r �email.generator� email.policyrn r� �osr r� � unittest.mockrL rq � distutils.cmdr �distutils.distr r �distutils.testsr �typingr � jaraco.pathrJ r� rg r� r r �fixturer! �combine_markersr� � usefixtures�TempdirManagerr$ r� r r r r �<module> s< W _distutils/tests/__pycache__/test_build_py.cpython-310.pyc 0000644 00000012725 15030122015 0017644 0 ustar 00 o �h� � @ sp d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl m Z ddl Z ddl Z e jG dd� de j��ZdS ) z%Tests for distutils.command.build_py.� N)�build_py)� Distribution)�DistutilsFileError)�supportc @ s\ e Zd Zdd� Zdd� Zej�d�dd� �Zej�d�dd � �Z d d � Z d d � Z dd� Z dS )� TestBuildPyc C s: | � � }tj�ddd�|� | � � }tdgd|id��}tj�|d�|_tj d|d�|j d < dg|_ dd gi|_ d|i|_ t|�}d |_|�� |j |j ksPJ �|�� t|�� �d ks^J �tj�|d�}t�|�}tj�|d �}d|v swJ �d |v s}J �tjr�tj�|�r�J �d S t�|�}dtjj� d�|v s�J �d S )Nz # Pretend this is a package.zInfo about this package)� __init__.py� README.txt�pkg)�packages� package_dir�setup.pyF)�force� build_lib�buildr T� � __pycache__r z __init__.�.pyc)�mkdtemp�jaraco�pathr r �os�join� script_namer � DummyCommand� command_objr � package_datar r �compile�ensure_finalized�run�len� get_outputs�listdir�sys�dont_write_bytecode�exists�implementation� cache_tag) �self�sources� destination�dist�cmd�pkgdest�files� pycache_dir� pyc_files� r0 �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_build_py.py�test_package_data s> �� � z TestBuildPy.test_package_datac C s� | � � }tj�dddid�|� t�|� tdgddiddgid��}tj�|d�|_dg|_ |� � z|� � W d S t yI | � d � Y d S w ) N� �testfile�r �docr �doc/*)r r r r r z/failed package_data test when package_dir is ''�r r r r r �chdirr r r � script_args�parse_command_line� run_commandsr �fail�r' r( r* r0 r0 r1 �test_empty_package_dir< s � �z"TestBuildPy.test_empty_package_dirzsys.dont_write_bytecodec C s� | j dgd�\}}t�|� | �dd� t|�}d|_d|_|�� |�� t� |j�}t |�ddgks6J �t� tj � |jd��}|dt jj� d �gksNJ �d S ) N� boiledeggs�� py_modules� boiledeggs.py�import antigravityT�herer � boiledeggs.r )� create_distr r9 � write_filer r r �finalize_optionsr r! �sortedr r r" r% r& )r' � project_dirr* r+ �foundr0 r0 r1 �test_byte_compileQ s z TestBuildPy.test_byte_compilec C s� | j dgd�\}}t�|� | �dd� t|�}d|_d|_d|_|�� |� � t� |j�}t |�ddgks9J �t� tj � |jd��}d tjj� d �}t |�|gksUJ �d S ) Nr@ rA rC rD F� rE r rF z .opt-1.pyc)rG r r9 rH r r �optimizer rI r r! rJ r r r" r% r& )r' rK r* r+ rL �expectr0 r0 r1 �test_byte_compile_optimizeda s z'TestBuildPy.test_byte_compile_optimizedc C s� | � � }tj�dddi d�d�i|� t�|� tdgddgid��}tj�|d�|_dg|_ |� � z|� � W d S t yI | � d � Y d S w ) zR A directory in package_data should not be added to the filelist. r r3 )r4 �otherdirr5 r7 )r r r r z0failed package_data when data dir includes a dirNr8 r> r0 r0 r1 �test_dir_in_package_datas s* ��� � �z$TestBuildPy.test_dir_in_package_datac C sb | � � d }t|�}d|_d|_tj}dt_z |�g � W |t_n|t_w d|jd jv s/J �d S )NrN Tzbyte-compiling is disabledr ) rG r r rO r" r# � byte_compile�records�message)r' �caplogr* r+ �old_dont_write_bytecoder0 r0 r1 �test_dont_write_bytecode� s z$TestBuildPy.test_dont_write_bytecodec C s� | � � }tj�ddddiii|� t�|� dddgdd�}t|�}|�d�}|�� |� � }t |�d ks7J �|d d }|� tj d �d ksHJ �|� � tdd� |jD ��rXJ �dS )aU Originally distutils implementation did not account for PEP 420 and included warns for package directories that did not contain ``__init__.py`` files. After the acceptance of PEP 420, these warnings don't make more sense so we want to ensure there are not displayed to not confuse the users. �nsr z module.pyr3 zns.pkgr )�namer r r rN r ����/zns/pkg/module.pyc s s � | ] }d |v o d|v V qdS )zpackage init filez not foundNr0 )�.0�msgr0 r0 r1 � <genexpr>� s � �zCTestBuildPy.test_namespace_package_does_not_warn.<locals>.<genexpr>N)r r r r r r9 r �get_command_objrI �find_all_modulesr �replace�sepr �any�messages)r' rW �tmp�attrsr* r+ �modules� module_pathr0 r0 r1 �$test_namespace_package_does_not_warn� s$ � �z0TestBuildPy.test_namespace_package_does_not_warnN) �__name__� __module__� __qualname__r2 r? �pytest�mark�skipifrM rQ rS rY rk r0 r0 r0 r1 r s , r )�__doc__r r" �distutils.command.build_pyr �distutils.corer �distutils.errorsr �distutils.testsr � jaraco.pathr ro �combine_markers�TempdirManagerr r0 r0 r0 r1 �<module> s _distutils/tests/__pycache__/test_version.cpython-310.pyc 0000644 00000004656 15030122015 0017526 0 ustar 00 o �h� � @ sJ d Z ddlZddlmZmZ ddlZejdd�dd� �ZG dd � d �ZdS ) z Tests for distutils.version.� N)� LooseVersion� StrictVersionT)�autousec c s8 � t j�� � d V W d � d S 1 sw Y d S )N)� distutils�version�suppress_known_deprecation� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/test_version.py�suppress_deprecation s � "�r c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )� TestVersionc C sP t d�}|jdks J �|jdksJ �t|�dksJ �t d�}t|�dks&J �d S )Nz1.2.3a1)� � � )�ar z1.2.0�1.2)r r � prerelease�str)�selfr r r r �test_prerelease s zTestVersion.test_prereleasec C s, dddt fdddt fddt fd d t fd d d dddddddt ff}|D ]q\}}}z t|��t|��}W n t yJ |t u r?Y q"td|� d|� d���w ||ks_J d|� d|� d|� d|� ���t|��|�}||kszJ d|� d|� d|� d|� ���t|��t� �}|tu s�J d|� d|� d|� ���q"d S )N�z1.5.1z1.5.2b2����161�3.10a��8.02r r �3.4j� 1996.07.12�3.2.pl0�3.1.1.6�2g6�11g)z0.9z2.2r )�1.2.1r r )�1.1�1.2.2r )r r" r )r! r# r )r# r r )r r# r )z0.4.0z0.4r �1.13++�5.5.kw�cmp(�, z ) shouldn't raise ValueError� ) should be �, got � ) should be NotImplemented, got )� ValueErrorr �_cmp�AssertionError�object�NotImplemented�r �versions�v1�v2�wanted�resr r r �test_cmp_strict s@ � �(( ��zTestVersion.test_cmp_strictc C s� d}|D ]V\}}}t |��t |��}||ks&J d|� d|� d|� d|� ���t |��|�}||ksAJ d|� d|� d|� d|� ���t |��t� �}|tu sZJ d|� d|� d|� ���qd S )N)r )r r r r )r r r )r r r )r r r )z0.960923z 2.2beta29r )r$ r% r r& r' r( r) r* )r r, r. r/ r0 r r r �test_cmp< s (( ��zTestVersion.test_cmpN)�__name__� __module__� __qualname__r r6 r7 r r r r r s #r ) �__doc__r �distutils.versionr r �pytest�fixturer r r r r r �<module> s _distutils/tests/test_extension.py 0000644 00000007126 15030122015 0013511 0 ustar 00 """Tests for distutils.extension.""" import os import pathlib import warnings from distutils.extension import Extension, read_setup_file import pytest from test.support.warnings_helper import check_warnings class TestExtension: def test_read_setup_file(self): # trying to read a Setup file # (sample extracted from the PyGame project) setup = os.path.join(os.path.dirname(__file__), 'Setup.sample') exts = read_setup_file(setup) names = [ext.name for ext in exts] names.sort() # here are the extensions read_setup_file should have created # out of the file wanted = [ '_arraysurfarray', '_camera', '_numericsndarray', '_numericsurfarray', 'base', 'bufferproxy', 'cdrom', 'color', 'constants', 'display', 'draw', 'event', 'fastevent', 'font', 'gfxdraw', 'image', 'imageext', 'joystick', 'key', 'mask', 'mixer', 'mixer_music', 'mouse', 'movie', 'overlay', 'pixelarray', 'pypm', 'rect', 'rwobject', 'scrap', 'surface', 'surflock', 'time', 'transform', ] assert names == wanted def test_extension_init(self): # the first argument, which is the name, must be a string with pytest.raises(TypeError): Extension(1, []) ext = Extension('name', []) assert ext.name == 'name' # the second argument, which is the list of files, must # be an iterable of strings or PathLike objects, and not a string with pytest.raises(TypeError): Extension('name', 'file') with pytest.raises(TypeError): Extension('name', ['file', 1]) ext = Extension('name', ['file1', 'file2']) assert ext.sources == ['file1', 'file2'] ext = Extension('name', [pathlib.Path('file1'), pathlib.Path('file2')]) assert ext.sources == ['file1', 'file2'] # any non-string iterable of strings or PathLike objects should work ext = Extension('name', ('file1', 'file2')) # tuple assert ext.sources == ['file1', 'file2'] ext = Extension('name', {'file1', 'file2'}) # set assert sorted(ext.sources) == ['file1', 'file2'] ext = Extension('name', iter(['file1', 'file2'])) # iterator assert ext.sources == ['file1', 'file2'] ext = Extension('name', [pathlib.Path('file1'), 'file2']) # mixed types assert ext.sources == ['file1', 'file2'] # others arguments have defaults for attr in ( 'include_dirs', 'define_macros', 'undef_macros', 'library_dirs', 'libraries', 'runtime_library_dirs', 'extra_objects', 'extra_compile_args', 'extra_link_args', 'export_symbols', 'swig_opts', 'depends', ): assert getattr(ext, attr) == [] assert ext.language is None assert ext.optional is None # if there are unknown keyword options, warn about them with check_warnings() as w: warnings.simplefilter('always') ext = Extension('name', ['file1', 'file2'], chic=True) assert len(w.warnings) == 1 assert str(w.warnings[0].message) == "Unknown Extension options: 'chic'" _distutils/tests/test_cmd.py 0000644 00000006266 15030122015 0012244 0 ustar 00 """Tests for distutils.cmd.""" import os from distutils import debug from distutils.cmd import Command from distutils.dist import Distribution from distutils.errors import DistutilsOptionError import pytest class MyCmd(Command): def initialize_options(self): pass @pytest.fixture def cmd(request): return MyCmd(Distribution()) class TestCommand: def test_ensure_string_list(self, cmd): cmd.not_string_list = ['one', 2, 'three'] cmd.yes_string_list = ['one', 'two', 'three'] cmd.not_string_list2 = object() cmd.yes_string_list2 = 'ok' cmd.ensure_string_list('yes_string_list') cmd.ensure_string_list('yes_string_list2') with pytest.raises(DistutilsOptionError): cmd.ensure_string_list('not_string_list') with pytest.raises(DistutilsOptionError): cmd.ensure_string_list('not_string_list2') cmd.option1 = 'ok,dok' cmd.ensure_string_list('option1') assert cmd.option1 == ['ok', 'dok'] cmd.option2 = ['xxx', 'www'] cmd.ensure_string_list('option2') cmd.option3 = ['ok', 2] with pytest.raises(DistutilsOptionError): cmd.ensure_string_list('option3') def test_make_file(self, cmd): # making sure it raises when infiles is not a string or a list/tuple with pytest.raises(TypeError): cmd.make_file(infiles=True, outfile='', func='func', args=()) # making sure execute gets called properly def _execute(func, args, exec_msg, level): assert exec_msg == 'generating out from in' cmd.force = True cmd.execute = _execute cmd.make_file(infiles='in', outfile='out', func='func', args=()) def test_dump_options(self, cmd): msgs = [] def _announce(msg, level): msgs.append(msg) cmd.announce = _announce cmd.option1 = 1 cmd.option2 = 1 cmd.user_options = [('option1', '', ''), ('option2', '', '')] cmd.dump_options() wanted = ["command options for 'MyCmd':", ' option1 = 1', ' option2 = 1'] assert msgs == wanted def test_ensure_string(self, cmd): cmd.option1 = 'ok' cmd.ensure_string('option1') cmd.option2 = None cmd.ensure_string('option2', 'xxx') assert hasattr(cmd, 'option2') cmd.option3 = 1 with pytest.raises(DistutilsOptionError): cmd.ensure_string('option3') def test_ensure_filename(self, cmd): cmd.option1 = __file__ cmd.ensure_filename('option1') cmd.option2 = 'xxx' with pytest.raises(DistutilsOptionError): cmd.ensure_filename('option2') def test_ensure_dirname(self, cmd): cmd.option1 = os.path.dirname(__file__) or os.curdir cmd.ensure_dirname('option1') cmd.option2 = 'xxx' with pytest.raises(DistutilsOptionError): cmd.ensure_dirname('option2') def test_debug_print(self, cmd, capsys, monkeypatch): cmd.debug_print('xxx') assert capsys.readouterr().out == '' monkeypatch.setattr(debug, 'DEBUG', True) cmd.debug_print('xxx') assert capsys.readouterr().out == 'xxx\n' _distutils/tests/test_file_util.py 0000644 00000006702 15030122015 0013450 0 ustar 00 """Tests for distutils.file_util.""" import errno import os import unittest.mock as mock from distutils.errors import DistutilsFileError from distutils.file_util import copy_file, move_file import jaraco.path import pytest @pytest.fixture(autouse=True) def stuff(request, tmp_path): self = request.instance self.source = tmp_path / 'f1' self.target = tmp_path / 'f2' self.target_dir = tmp_path / 'd1' class TestFileUtil: def test_move_file_verbosity(self, caplog): jaraco.path.build({self.source: 'some content'}) move_file(self.source, self.target, verbose=False) assert not caplog.messages # back to original state move_file(self.target, self.source, verbose=False) move_file(self.source, self.target, verbose=True) wanted = [f'moving {self.source} -> {self.target}'] assert caplog.messages == wanted # back to original state move_file(self.target, self.source, verbose=False) caplog.clear() # now the target is a dir os.mkdir(self.target_dir) move_file(self.source, self.target_dir, verbose=True) wanted = [f'moving {self.source} -> {self.target_dir}'] assert caplog.messages == wanted def test_move_file_exception_unpacking_rename(self): # see issue 22182 with ( mock.patch("os.rename", side_effect=OSError("wrong", 1)), pytest.raises(DistutilsFileError), ): jaraco.path.build({self.source: 'spam eggs'}) move_file(self.source, self.target, verbose=False) def test_move_file_exception_unpacking_unlink(self): # see issue 22182 with ( mock.patch("os.rename", side_effect=OSError(errno.EXDEV, "wrong")), mock.patch("os.unlink", side_effect=OSError("wrong", 1)), pytest.raises(DistutilsFileError), ): jaraco.path.build({self.source: 'spam eggs'}) move_file(self.source, self.target, verbose=False) def test_copy_file_hard_link(self): jaraco.path.build({self.source: 'some content'}) # Check first that copy_file() will not fall back on copying the file # instead of creating the hard link. try: os.link(self.source, self.target) except OSError as e: self.skipTest(f'os.link: {e}') else: self.target.unlink() st = os.stat(self.source) copy_file(self.source, self.target, link='hard') st2 = os.stat(self.source) st3 = os.stat(self.target) assert os.path.samestat(st, st2), (st, st2) assert os.path.samestat(st2, st3), (st2, st3) assert self.source.read_text(encoding='utf-8') == 'some content' def test_copy_file_hard_link_failure(self): # If hard linking fails, copy_file() falls back on copying file # (some special filesystems don't support hard linking even under # Unix, see issue #8876). jaraco.path.build({self.source: 'some content'}) st = os.stat(self.source) with mock.patch("os.link", side_effect=OSError(0, "linking unsupported")): copy_file(self.source, self.target, link='hard') st2 = os.stat(self.source) st3 = os.stat(self.target) assert os.path.samestat(st, st2), (st, st2) assert not os.path.samestat(st2, st3), (st2, st3) for fn in (self.source, self.target): assert fn.read_text(encoding='utf-8') == 'some content' _distutils/tests/test_version.py 0000644 00000005276 15030122015 0013166 0 ustar 00 """Tests for distutils.version.""" import distutils from distutils.version import LooseVersion, StrictVersion import pytest @pytest.fixture(autouse=True) def suppress_deprecation(): with distutils.version.suppress_known_deprecation(): yield class TestVersion: def test_prerelease(self): version = StrictVersion('1.2.3a1') assert version.version == (1, 2, 3) assert version.prerelease == ('a', 1) assert str(version) == '1.2.3a1' version = StrictVersion('1.2.0') assert str(version) == '1.2' def test_cmp_strict(self): versions = ( ('1.5.1', '1.5.2b2', -1), ('161', '3.10a', ValueError), ('8.02', '8.02', 0), ('3.4j', '1996.07.12', ValueError), ('3.2.pl0', '3.1.1.6', ValueError), ('2g6', '11g', ValueError), ('0.9', '2.2', -1), ('1.2.1', '1.2', 1), ('1.1', '1.2.2', -1), ('1.2', '1.1', 1), ('1.2.1', '1.2.2', -1), ('1.2.2', '1.2', 1), ('1.2', '1.2.2', -1), ('0.4.0', '0.4', 0), ('1.13++', '5.5.kw', ValueError), ) for v1, v2, wanted in versions: try: res = StrictVersion(v1)._cmp(StrictVersion(v2)) except ValueError: if wanted is ValueError: continue else: raise AssertionError(f"cmp({v1}, {v2}) shouldn't raise ValueError") assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' res = StrictVersion(v1)._cmp(v2) assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' res = StrictVersion(v1)._cmp(object()) assert res is NotImplemented, ( f'cmp({v1}, {v2}) should be NotImplemented, got {res}' ) def test_cmp(self): versions = ( ('1.5.1', '1.5.2b2', -1), ('161', '3.10a', 1), ('8.02', '8.02', 0), ('3.4j', '1996.07.12', -1), ('3.2.pl0', '3.1.1.6', 1), ('2g6', '11g', -1), ('0.960923', '2.2beta29', -1), ('1.13++', '5.5.kw', -1), ) for v1, v2, wanted in versions: res = LooseVersion(v1)._cmp(LooseVersion(v2)) assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' res = LooseVersion(v1)._cmp(v2) assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' res = LooseVersion(v1)._cmp(object()) assert res is NotImplemented, ( f'cmp({v1}, {v2}) should be NotImplemented, got {res}' ) _distutils/tests/test_filelist.py 0000644 00000025016 15030122015 0013306 0 ustar 00 """Tests for distutils.filelist.""" import logging import os import re from distutils import debug, filelist from distutils.errors import DistutilsTemplateError from distutils.filelist import FileList, glob_to_re, translate_pattern import jaraco.path import pytest from .compat import py39 as os_helper MANIFEST_IN = """\ include ok include xo exclude xo include foo.tmp include buildout.cfg global-include *.x global-include *.txt global-exclude *.tmp recursive-include f *.oo recursive-exclude global *.x graft dir prune dir3 """ def make_local_path(s): """Converts '/' in a string to os.sep""" return s.replace('/', os.sep) class TestFileList: def assertNoWarnings(self, caplog): warnings = [rec for rec in caplog.records if rec.levelno == logging.WARNING] assert not warnings caplog.clear() def assertWarnings(self, caplog): warnings = [rec for rec in caplog.records if rec.levelno == logging.WARNING] assert warnings caplog.clear() def test_glob_to_re(self): sep = os.sep if os.sep == '\\': sep = re.escape(os.sep) for glob, regex in ( # simple cases ('foo*', r'(?s:foo[^%(sep)s]*)\Z'), ('foo?', r'(?s:foo[^%(sep)s])\Z'), ('foo??', r'(?s:foo[^%(sep)s][^%(sep)s])\Z'), # special cases (r'foo\\*', r'(?s:foo\\\\[^%(sep)s]*)\Z'), (r'foo\\\*', r'(?s:foo\\\\\\[^%(sep)s]*)\Z'), ('foo????', r'(?s:foo[^%(sep)s][^%(sep)s][^%(sep)s][^%(sep)s])\Z'), (r'foo\\??', r'(?s:foo\\\\[^%(sep)s][^%(sep)s])\Z'), ): regex = regex % {'sep': sep} assert glob_to_re(glob) == regex def test_process_template_line(self): # testing all MANIFEST.in template patterns file_list = FileList() mlp = make_local_path # simulated file list file_list.allfiles = [ 'foo.tmp', 'ok', 'xo', 'four.txt', 'buildout.cfg', # filelist does not filter out VCS directories, # it's sdist that does mlp('.hg/last-message.txt'), mlp('global/one.txt'), mlp('global/two.txt'), mlp('global/files.x'), mlp('global/here.tmp'), mlp('f/o/f.oo'), mlp('dir/graft-one'), mlp('dir/dir2/graft2'), mlp('dir3/ok'), mlp('dir3/sub/ok.txt'), ] for line in MANIFEST_IN.split('\n'): if line.strip() == '': continue file_list.process_template_line(line) wanted = [ 'ok', 'buildout.cfg', 'four.txt', mlp('.hg/last-message.txt'), mlp('global/one.txt'), mlp('global/two.txt'), mlp('f/o/f.oo'), mlp('dir/graft-one'), mlp('dir/dir2/graft2'), ] assert file_list.files == wanted def test_debug_print(self, capsys, monkeypatch): file_list = FileList() file_list.debug_print('xxx') assert capsys.readouterr().out == '' monkeypatch.setattr(debug, 'DEBUG', True) file_list.debug_print('xxx') assert capsys.readouterr().out == 'xxx\n' def test_set_allfiles(self): file_list = FileList() files = ['a', 'b', 'c'] file_list.set_allfiles(files) assert file_list.allfiles == files def test_remove_duplicates(self): file_list = FileList() file_list.files = ['a', 'b', 'a', 'g', 'c', 'g'] # files must be sorted beforehand (sdist does it) file_list.sort() file_list.remove_duplicates() assert file_list.files == ['a', 'b', 'c', 'g'] def test_translate_pattern(self): # not regex assert hasattr(translate_pattern('a', anchor=True, is_regex=False), 'search') # is a regex regex = re.compile('a') assert translate_pattern(regex, anchor=True, is_regex=True) == regex # plain string flagged as regex assert hasattr(translate_pattern('a', anchor=True, is_regex=True), 'search') # glob support assert translate_pattern('*.py', anchor=True, is_regex=False).search( 'filelist.py' ) def test_exclude_pattern(self): # return False if no match file_list = FileList() assert not file_list.exclude_pattern('*.py') # return True if files match file_list = FileList() file_list.files = ['a.py', 'b.py'] assert file_list.exclude_pattern('*.py') # test excludes file_list = FileList() file_list.files = ['a.py', 'a.txt'] file_list.exclude_pattern('*.py') assert file_list.files == ['a.txt'] def test_include_pattern(self): # return False if no match file_list = FileList() file_list.set_allfiles([]) assert not file_list.include_pattern('*.py') # return True if files match file_list = FileList() file_list.set_allfiles(['a.py', 'b.txt']) assert file_list.include_pattern('*.py') # test * matches all files file_list = FileList() assert file_list.allfiles is None file_list.set_allfiles(['a.py', 'b.txt']) file_list.include_pattern('*') assert file_list.allfiles == ['a.py', 'b.txt'] def test_process_template(self, caplog): mlp = make_local_path # invalid lines file_list = FileList() for action in ( 'include', 'exclude', 'global-include', 'global-exclude', 'recursive-include', 'recursive-exclude', 'graft', 'prune', 'blarg', ): with pytest.raises(DistutilsTemplateError): file_list.process_template_line(action) # include file_list = FileList() file_list.set_allfiles(['a.py', 'b.txt', mlp('d/c.py')]) file_list.process_template_line('include *.py') assert file_list.files == ['a.py'] self.assertNoWarnings(caplog) file_list.process_template_line('include *.rb') assert file_list.files == ['a.py'] self.assertWarnings(caplog) # exclude file_list = FileList() file_list.files = ['a.py', 'b.txt', mlp('d/c.py')] file_list.process_template_line('exclude *.py') assert file_list.files == ['b.txt', mlp('d/c.py')] self.assertNoWarnings(caplog) file_list.process_template_line('exclude *.rb') assert file_list.files == ['b.txt', mlp('d/c.py')] self.assertWarnings(caplog) # global-include file_list = FileList() file_list.set_allfiles(['a.py', 'b.txt', mlp('d/c.py')]) file_list.process_template_line('global-include *.py') assert file_list.files == ['a.py', mlp('d/c.py')] self.assertNoWarnings(caplog) file_list.process_template_line('global-include *.rb') assert file_list.files == ['a.py', mlp('d/c.py')] self.assertWarnings(caplog) # global-exclude file_list = FileList() file_list.files = ['a.py', 'b.txt', mlp('d/c.py')] file_list.process_template_line('global-exclude *.py') assert file_list.files == ['b.txt'] self.assertNoWarnings(caplog) file_list.process_template_line('global-exclude *.rb') assert file_list.files == ['b.txt'] self.assertWarnings(caplog) # recursive-include file_list = FileList() file_list.set_allfiles(['a.py', mlp('d/b.py'), mlp('d/c.txt'), mlp('d/d/e.py')]) file_list.process_template_line('recursive-include d *.py') assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] self.assertNoWarnings(caplog) file_list.process_template_line('recursive-include e *.py') assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] self.assertWarnings(caplog) # recursive-exclude file_list = FileList() file_list.files = ['a.py', mlp('d/b.py'), mlp('d/c.txt'), mlp('d/d/e.py')] file_list.process_template_line('recursive-exclude d *.py') assert file_list.files == ['a.py', mlp('d/c.txt')] self.assertNoWarnings(caplog) file_list.process_template_line('recursive-exclude e *.py') assert file_list.files == ['a.py', mlp('d/c.txt')] self.assertWarnings(caplog) # graft file_list = FileList() file_list.set_allfiles(['a.py', mlp('d/b.py'), mlp('d/d/e.py'), mlp('f/f.py')]) file_list.process_template_line('graft d') assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] self.assertNoWarnings(caplog) file_list.process_template_line('graft e') assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] self.assertWarnings(caplog) # prune file_list = FileList() file_list.files = ['a.py', mlp('d/b.py'), mlp('d/d/e.py'), mlp('f/f.py')] file_list.process_template_line('prune d') assert file_list.files == ['a.py', mlp('f/f.py')] self.assertNoWarnings(caplog) file_list.process_template_line('prune e') assert file_list.files == ['a.py', mlp('f/f.py')] self.assertWarnings(caplog) class TestFindAll: @os_helper.skip_unless_symlink def test_missing_symlink(self, temp_cwd): os.symlink('foo', 'bar') assert filelist.findall() == [] def test_basic_discovery(self, temp_cwd): """ When findall is called with no parameters or with '.' as the parameter, the dot should be omitted from the results. """ jaraco.path.build({'foo': {'file1.txt': ''}, 'bar': {'file2.txt': ''}}) file1 = os.path.join('foo', 'file1.txt') file2 = os.path.join('bar', 'file2.txt') expected = [file2, file1] assert sorted(filelist.findall()) == expected def test_non_local_discovery(self, tmp_path): """ When findall is called with another path, the full path name should be returned. """ jaraco.path.build({'file1.txt': ''}, tmp_path) expected = [str(tmp_path / 'file1.txt')] assert filelist.findall(tmp_path) == expected @os_helper.skip_unless_symlink def test_symlink_loop(self, tmp_path): jaraco.path.build( { 'link-to-parent': jaraco.path.Symlink('.'), 'somefile': '', }, tmp_path, ) files = filelist.findall(tmp_path) assert len(files) == 1 _distutils/tests/test_modified.py 0000644 00000010175 15030122015 0013253 0 ustar 00 """Tests for distutils._modified.""" import os import types from distutils._modified import newer, newer_group, newer_pairwise, newer_pairwise_group from distutils.errors import DistutilsFileError from distutils.tests import support import pytest class TestDepUtil(support.TempdirManager): def test_newer(self): tmpdir = self.mkdtemp() new_file = os.path.join(tmpdir, 'new') old_file = os.path.abspath(__file__) # Raise DistutilsFileError if 'new_file' does not exist. with pytest.raises(DistutilsFileError): newer(new_file, old_file) # Return true if 'new_file' exists and is more recently modified than # 'old_file', or if 'new_file' exists and 'old_file' doesn't. self.write_file(new_file) assert newer(new_file, 'I_dont_exist') assert newer(new_file, old_file) # Return false if both exist and 'old_file' is the same age or younger # than 'new_file'. assert not newer(old_file, new_file) def _setup_1234(self): tmpdir = self.mkdtemp() sources = os.path.join(tmpdir, 'sources') targets = os.path.join(tmpdir, 'targets') os.mkdir(sources) os.mkdir(targets) one = os.path.join(sources, 'one') two = os.path.join(sources, 'two') three = os.path.abspath(__file__) # I am the old file four = os.path.join(targets, 'four') self.write_file(one) self.write_file(two) self.write_file(four) return one, two, three, four def test_newer_pairwise(self): one, two, three, four = self._setup_1234() assert newer_pairwise([one, two], [three, four]) == ([one], [three]) def test_newer_pairwise_mismatch(self): one, two, three, four = self._setup_1234() with pytest.raises(ValueError): newer_pairwise([one], [three, four]) with pytest.raises(ValueError): newer_pairwise([one, two], [three]) def test_newer_pairwise_empty(self): assert newer_pairwise([], []) == ([], []) def test_newer_pairwise_fresh(self): one, two, three, four = self._setup_1234() assert newer_pairwise([one, three], [two, four]) == ([], []) def test_newer_group(self): tmpdir = self.mkdtemp() sources = os.path.join(tmpdir, 'sources') os.mkdir(sources) one = os.path.join(sources, 'one') two = os.path.join(sources, 'two') three = os.path.join(sources, 'three') old_file = os.path.abspath(__file__) # return true if 'old_file' is out-of-date with respect to any file # listed in 'sources'. self.write_file(one) self.write_file(two) self.write_file(three) assert newer_group([one, two, three], old_file) assert not newer_group([one, two, old_file], three) # missing handling os.remove(one) with pytest.raises(OSError): newer_group([one, two, old_file], three) assert not newer_group([one, two, old_file], three, missing='ignore') assert newer_group([one, two, old_file], three, missing='newer') @pytest.fixture def groups_target(tmp_path): """ Set up some older sources, a target, and newer sources. Returns a simple namespace with these values. """ filenames = ['older.c', 'older.h', 'target.o', 'newer.c', 'newer.h'] paths = [tmp_path / name for name in filenames] for mtime, path in enumerate(paths): path.write_text('', encoding='utf-8') # make sure modification times are sequential os.utime(path, (mtime, mtime)) return types.SimpleNamespace(older=paths[:2], target=paths[2], newer=paths[3:]) def test_newer_pairwise_group(groups_target): older = newer_pairwise_group([groups_target.older], [groups_target.target]) newer = newer_pairwise_group([groups_target.newer], [groups_target.target]) assert older == ([], []) assert newer == ([groups_target.newer], [groups_target.target]) def test_newer_group_no_sources_no_target(tmp_path): """ Consider no sources and no target "newer". """ assert newer_group([], str(tmp_path / 'does-not-exist')) _distutils/tests/test_versionpredicate.py 0000644 00000000000 15030122015 0015023 0 ustar 00 _distutils/tests/test_install.py 0000644 00000020652 15030122015 0013142 0 ustar 00 """Tests for distutils.command.install.""" import logging import os import pathlib import site import sys from distutils import sysconfig from distutils.command import install as install_module from distutils.command.build_ext import build_ext from distutils.command.install import INSTALL_SCHEMES, install from distutils.core import Distribution from distutils.errors import DistutilsOptionError from distutils.extension import Extension from distutils.tests import missing_compiler_executable, support from distutils.util import is_mingw import pytest def _make_ext_name(modname): return modname + sysconfig.get_config_var('EXT_SUFFIX') @support.combine_markers @pytest.mark.usefixtures('save_env') class TestInstall( support.TempdirManager, ): @pytest.mark.xfail( 'platform.system() == "Windows" and sys.version_info > (3, 11)', reason="pypa/distutils#148", ) def test_home_installation_scheme(self): # This ensure two things: # - that --home generates the desired set of directory names # - test --home is supported on all platforms builddir = self.mkdtemp() destination = os.path.join(builddir, "installation") dist = Distribution({"name": "foopkg"}) # script_name need not exist, it just need to be initialized dist.script_name = os.path.join(builddir, "setup.py") dist.command_obj["build"] = support.DummyCommand( build_base=builddir, build_lib=os.path.join(builddir, "lib"), ) cmd = install(dist) cmd.home = destination cmd.ensure_finalized() assert cmd.install_base == destination assert cmd.install_platbase == destination def check_path(got, expected): got = os.path.normpath(got) expected = os.path.normpath(expected) assert got == expected impl_name = sys.implementation.name.replace("cpython", "python") libdir = os.path.join(destination, "lib", impl_name) check_path(cmd.install_lib, libdir) _platlibdir = getattr(sys, "platlibdir", "lib") platlibdir = os.path.join(destination, _platlibdir, impl_name) check_path(cmd.install_platlib, platlibdir) check_path(cmd.install_purelib, libdir) check_path( cmd.install_headers, os.path.join(destination, "include", impl_name, "foopkg"), ) check_path(cmd.install_scripts, os.path.join(destination, "bin")) check_path(cmd.install_data, destination) def test_user_site(self, monkeypatch): # test install with --user # preparing the environment for the test self.tmpdir = self.mkdtemp() orig_site = site.USER_SITE orig_base = site.USER_BASE monkeypatch.setattr(site, 'USER_BASE', os.path.join(self.tmpdir, 'B')) monkeypatch.setattr(site, 'USER_SITE', os.path.join(self.tmpdir, 'S')) monkeypatch.setattr(install_module, 'USER_BASE', site.USER_BASE) monkeypatch.setattr(install_module, 'USER_SITE', site.USER_SITE) def _expanduser(path): if path.startswith('~'): return os.path.normpath(self.tmpdir + path[1:]) return path monkeypatch.setattr(os.path, 'expanduser', _expanduser) for key in ('nt_user', 'posix_user'): assert key in INSTALL_SCHEMES dist = Distribution({'name': 'xx'}) cmd = install(dist) # making sure the user option is there options = [name for name, short, label in cmd.user_options] assert 'user' in options # setting a value cmd.user = True # user base and site shouldn't be created yet assert not os.path.exists(site.USER_BASE) assert not os.path.exists(site.USER_SITE) # let's run finalize cmd.ensure_finalized() # now they should assert os.path.exists(site.USER_BASE) assert os.path.exists(site.USER_SITE) assert 'userbase' in cmd.config_vars assert 'usersite' in cmd.config_vars actual_headers = os.path.relpath(cmd.install_headers, site.USER_BASE) if os.name == 'nt' and not is_mingw(): site_path = os.path.relpath(os.path.dirname(orig_site), orig_base) include = os.path.join(site_path, 'Include') else: include = sysconfig.get_python_inc(0, '') expect_headers = os.path.join(include, 'xx') assert os.path.normcase(actual_headers) == os.path.normcase(expect_headers) def test_handle_extra_path(self): dist = Distribution({'name': 'xx', 'extra_path': 'path,dirs'}) cmd = install(dist) # two elements cmd.handle_extra_path() assert cmd.extra_path == ['path', 'dirs'] assert cmd.extra_dirs == 'dirs' assert cmd.path_file == 'path' # one element cmd.extra_path = ['path'] cmd.handle_extra_path() assert cmd.extra_path == ['path'] assert cmd.extra_dirs == 'path' assert cmd.path_file == 'path' # none dist.extra_path = cmd.extra_path = None cmd.handle_extra_path() assert cmd.extra_path is None assert cmd.extra_dirs == '' assert cmd.path_file is None # three elements (no way !) cmd.extra_path = 'path,dirs,again' with pytest.raises(DistutilsOptionError): cmd.handle_extra_path() def test_finalize_options(self): dist = Distribution({'name': 'xx'}) cmd = install(dist) # must supply either prefix/exec-prefix/home or # install-base/install-platbase -- not both cmd.prefix = 'prefix' cmd.install_base = 'base' with pytest.raises(DistutilsOptionError): cmd.finalize_options() # must supply either home or prefix/exec-prefix -- not both cmd.install_base = None cmd.home = 'home' with pytest.raises(DistutilsOptionError): cmd.finalize_options() # can't combine user with prefix/exec_prefix/home or # install_(plat)base cmd.prefix = None cmd.user = 'user' with pytest.raises(DistutilsOptionError): cmd.finalize_options() def test_record(self): install_dir = self.mkdtemp() project_dir, dist = self.create_dist(py_modules=['hello'], scripts=['sayhi']) os.chdir(project_dir) self.write_file('hello.py', "def main(): print('o hai')") self.write_file('sayhi', 'from hello import main; main()') cmd = install(dist) dist.command_obj['install'] = cmd cmd.root = install_dir cmd.record = os.path.join(project_dir, 'filelist') cmd.ensure_finalized() cmd.run() content = pathlib.Path(cmd.record).read_text(encoding='utf-8') found = [pathlib.Path(line).name for line in content.splitlines()] expected = [ 'hello.py', f'hello.{sys.implementation.cache_tag}.pyc', 'sayhi', 'UNKNOWN-0.0.0-py{}.{}.egg-info'.format(*sys.version_info[:2]), ] assert found == expected def test_record_extensions(self): cmd = missing_compiler_executable() if cmd is not None: pytest.skip(f'The {cmd!r} command is not found') install_dir = self.mkdtemp() project_dir, dist = self.create_dist( ext_modules=[Extension('xx', ['xxmodule.c'])] ) os.chdir(project_dir) support.copy_xxmodule_c(project_dir) buildextcmd = build_ext(dist) support.fixup_build_ext(buildextcmd) buildextcmd.ensure_finalized() cmd = install(dist) dist.command_obj['install'] = cmd dist.command_obj['build_ext'] = buildextcmd cmd.root = install_dir cmd.record = os.path.join(project_dir, 'filelist') cmd.ensure_finalized() cmd.run() content = pathlib.Path(cmd.record).read_text(encoding='utf-8') found = [pathlib.Path(line).name for line in content.splitlines()] expected = [ _make_ext_name('xx'), 'UNKNOWN-0.0.0-py{}.{}.egg-info'.format(*sys.version_info[:2]), ] assert found == expected def test_debug_mode(self, caplog, monkeypatch): # this covers the code called when DEBUG is set monkeypatch.setattr(install_module, 'DEBUG', True) caplog.set_level(logging.DEBUG) self.test_record() assert any(rec for rec in caplog.records if rec.levelno == logging.DEBUG) _distutils/tests/test_check.py 0000644 00000014122 15030122015 0012544 0 ustar 00 """Tests for distutils.command.check.""" import os import textwrap from distutils.command.check import check from distutils.errors import DistutilsSetupError from distutils.tests import support import pytest try: import pygments except ImportError: pygments = None HERE = os.path.dirname(__file__) @support.combine_markers class TestCheck(support.TempdirManager): def _run(self, metadata=None, cwd=None, **options): if metadata is None: metadata = {} if cwd is not None: old_dir = os.getcwd() os.chdir(cwd) pkg_info, dist = self.create_dist(**metadata) cmd = check(dist) cmd.initialize_options() for name, value in options.items(): setattr(cmd, name, value) cmd.ensure_finalized() cmd.run() if cwd is not None: os.chdir(old_dir) return cmd def test_check_metadata(self): # let's run the command with no metadata at all # by default, check is checking the metadata # should have some warnings cmd = self._run() assert cmd._warnings == 1 # now let's add the required fields # and run it again, to make sure we don't get # any warning anymore metadata = { 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', 'name': 'xxx', 'version': 'xxx', } cmd = self._run(metadata) assert cmd._warnings == 0 # now with the strict mode, we should # get an error if there are missing metadata with pytest.raises(DistutilsSetupError): self._run({}, **{'strict': 1}) # and of course, no error when all metadata are present cmd = self._run(metadata, strict=True) assert cmd._warnings == 0 # now a test with non-ASCII characters metadata = { 'url': 'xxx', 'author': '\u00c9ric', 'author_email': 'xxx', 'name': 'xxx', 'version': 'xxx', 'description': 'Something about esszet \u00df', 'long_description': 'More things about esszet \u00df', } cmd = self._run(metadata) assert cmd._warnings == 0 def test_check_author_maintainer(self): for kind in ("author", "maintainer"): # ensure no warning when author_email or maintainer_email is given # (the spec allows these fields to take the form "Name <email>") metadata = { 'url': 'xxx', kind + '_email': 'Name <name@email.com>', 'name': 'xxx', 'version': 'xxx', } cmd = self._run(metadata) assert cmd._warnings == 0 # the check should not warn if only email is given metadata[kind + '_email'] = 'name@email.com' cmd = self._run(metadata) assert cmd._warnings == 0 # the check should not warn if only the name is given metadata[kind] = "Name" del metadata[kind + '_email'] cmd = self._run(metadata) assert cmd._warnings == 0 def test_check_document(self): pytest.importorskip('docutils') pkg_info, dist = self.create_dist() cmd = check(dist) # let's see if it detects broken rest broken_rest = 'title\n===\n\ntest' msgs = cmd._check_rst_data(broken_rest) assert len(msgs) == 1 # and non-broken rest rest = 'title\n=====\n\ntest' msgs = cmd._check_rst_data(rest) assert len(msgs) == 0 def test_check_restructuredtext(self): pytest.importorskip('docutils') # let's see if it detects broken rest in long_description broken_rest = 'title\n===\n\ntest' pkg_info, dist = self.create_dist(long_description=broken_rest) cmd = check(dist) cmd.check_restructuredtext() assert cmd._warnings == 1 # let's see if we have an error with strict=True metadata = { 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', 'name': 'xxx', 'version': 'xxx', 'long_description': broken_rest, } with pytest.raises(DistutilsSetupError): self._run(metadata, **{'strict': 1, 'restructuredtext': 1}) # and non-broken rest, including a non-ASCII character to test #12114 metadata['long_description'] = 'title\n=====\n\ntest \u00df' cmd = self._run(metadata, strict=True, restructuredtext=True) assert cmd._warnings == 0 # check that includes work to test #31292 metadata['long_description'] = 'title\n=====\n\n.. include:: includetest.rst' cmd = self._run(metadata, cwd=HERE, strict=True, restructuredtext=True) assert cmd._warnings == 0 def test_check_restructuredtext_with_syntax_highlight(self): pytest.importorskip('docutils') # Don't fail if there is a `code` or `code-block` directive example_rst_docs = [ textwrap.dedent( """\ Here's some code: .. code:: python def foo(): pass """ ), textwrap.dedent( """\ Here's some code: .. code-block:: python def foo(): pass """ ), ] for rest_with_code in example_rst_docs: pkg_info, dist = self.create_dist(long_description=rest_with_code) cmd = check(dist) cmd.check_restructuredtext() msgs = cmd._check_rst_data(rest_with_code) if pygments is not None: assert len(msgs) == 0 else: assert len(msgs) == 1 assert ( str(msgs[0][1]) == 'Cannot analyze code. Pygments package not found.' ) def test_check_all(self): with pytest.raises(DistutilsSetupError): self._run({}, **{'strict': 1, 'restructuredtext': 1}) _distutils/tests/test_build.py 0000644 00000003316 15030122015 0012571 0 ustar 00 """Tests for distutils.command.build.""" import os import sys from distutils.command.build import build from distutils.tests import support from sysconfig import get_config_var, get_platform class TestBuild(support.TempdirManager): def test_finalize_options(self): pkg_dir, dist = self.create_dist() cmd = build(dist) cmd.finalize_options() # if not specified, plat_name gets the current platform assert cmd.plat_name == get_platform() # build_purelib is build + lib wanted = os.path.join(cmd.build_base, 'lib') assert cmd.build_purelib == wanted # build_platlib is 'build/lib.platform-cache_tag[-pydebug]' # examples: # build/lib.macosx-10.3-i386-cpython39 plat_spec = f'.{cmd.plat_name}-{sys.implementation.cache_tag}' if get_config_var('Py_GIL_DISABLED'): plat_spec += 't' if hasattr(sys, 'gettotalrefcount'): assert cmd.build_platlib.endswith('-pydebug') plat_spec += '-pydebug' wanted = os.path.join(cmd.build_base, 'lib' + plat_spec) assert cmd.build_platlib == wanted # by default, build_lib = build_purelib assert cmd.build_lib == cmd.build_purelib # build_temp is build/temp.<plat> wanted = os.path.join(cmd.build_base, 'temp' + plat_spec) assert cmd.build_temp == wanted # build_scripts is build/scripts-x.x wanted = os.path.join( cmd.build_base, f'scripts-{sys.version_info.major}.{sys.version_info.minor}' ) assert cmd.build_scripts == wanted # executable is os.path.normpath(sys.executable) assert cmd.executable == os.path.normpath(sys.executable) _distutils/tests/test_config_cmd.py 0000644 00000005150 15030122015 0013560 0 ustar 00 """Tests for distutils.command.config.""" import os import sys from distutils._log import log from distutils.command.config import config, dump_file from distutils.tests import missing_compiler_executable, support import more_itertools import path import pytest @pytest.fixture(autouse=True) def info_log(request, monkeypatch): self = request.instance self._logs = [] monkeypatch.setattr(log, 'info', self._info) @support.combine_markers class TestConfig(support.TempdirManager): def _info(self, msg, *args): for line in msg.splitlines(): self._logs.append(line) def test_dump_file(self): this_file = path.Path(__file__).with_suffix('.py') with this_file.open(encoding='utf-8') as f: numlines = more_itertools.ilen(f) dump_file(this_file, 'I am the header') assert len(self._logs) == numlines + 1 @pytest.mark.skipif('platform.system() == "Windows"') def test_search_cpp(self): cmd = missing_compiler_executable(['preprocessor']) if cmd is not None: self.skipTest(f'The {cmd!r} command is not found') pkg_dir, dist = self.create_dist() cmd = config(dist) cmd._check_compiler() compiler = cmd.compiler if sys.platform[:3] == "aix" and "xlc" in compiler.preprocessor[0].lower(): self.skipTest( 'xlc: The -E option overrides the -P, -o, and -qsyntaxonly options' ) # simple pattern searches match = cmd.search_cpp(pattern='xxx', body='/* xxx */') assert match == 0 match = cmd.search_cpp(pattern='_configtest', body='/* xxx */') assert match == 1 def test_finalize_options(self): # finalize_options does a bit of transformation # on options pkg_dir, dist = self.create_dist() cmd = config(dist) cmd.include_dirs = f'one{os.pathsep}two' cmd.libraries = 'one' cmd.library_dirs = f'three{os.pathsep}four' cmd.ensure_finalized() assert cmd.include_dirs == ['one', 'two'] assert cmd.libraries == ['one'] assert cmd.library_dirs == ['three', 'four'] def test_clean(self): # _clean removes files tmp_dir = self.mkdtemp() f1 = os.path.join(tmp_dir, 'one') f2 = os.path.join(tmp_dir, 'two') self.write_file(f1, 'xxx') self.write_file(f2, 'xxx') for f in (f1, f2): assert os.path.exists(f) pkg_dir, dist = self.create_dist() cmd = config(dist) cmd._clean(f1, f2) for f in (f1, f2): assert not os.path.exists(f) _distutils/tests/test_install_data.py 0000644 00000004640 15030122015 0014132 0 ustar 00 """Tests for distutils.command.install_data.""" import os import pathlib from distutils.command.install_data import install_data from distutils.tests import support import pytest @pytest.mark.usefixtures('save_env') class TestInstallData( support.TempdirManager, ): def test_simple_run(self): pkg_dir, dist = self.create_dist() cmd = install_data(dist) cmd.install_dir = inst = os.path.join(pkg_dir, 'inst') # data_files can contain # - simple files # - a Path object # - a tuple with a path, and a list of file one = os.path.join(pkg_dir, 'one') self.write_file(one, 'xxx') inst2 = os.path.join(pkg_dir, 'inst2') two = os.path.join(pkg_dir, 'two') self.write_file(two, 'xxx') three = pathlib.Path(pkg_dir) / 'three' self.write_file(three, 'xxx') cmd.data_files = [one, (inst2, [two]), three] assert cmd.get_inputs() == [one, (inst2, [two]), three] # let's run the command cmd.ensure_finalized() cmd.run() # let's check the result assert len(cmd.get_outputs()) == 3 rthree = os.path.split(one)[-1] assert os.path.exists(os.path.join(inst, rthree)) rtwo = os.path.split(two)[-1] assert os.path.exists(os.path.join(inst2, rtwo)) rone = os.path.split(one)[-1] assert os.path.exists(os.path.join(inst, rone)) cmd.outfiles = [] # let's try with warn_dir one cmd.warn_dir = True cmd.ensure_finalized() cmd.run() # let's check the result assert len(cmd.get_outputs()) == 3 assert os.path.exists(os.path.join(inst, rthree)) assert os.path.exists(os.path.join(inst2, rtwo)) assert os.path.exists(os.path.join(inst, rone)) cmd.outfiles = [] # now using root and empty dir cmd.root = os.path.join(pkg_dir, 'root') inst5 = os.path.join(pkg_dir, 'inst5') four = os.path.join(cmd.install_dir, 'four') self.write_file(four, 'xx') cmd.data_files = [one, (inst2, [two]), three, ('inst5', [four]), (inst5, [])] cmd.ensure_finalized() cmd.run() # let's check the result assert len(cmd.get_outputs()) == 5 assert os.path.exists(os.path.join(inst, rthree)) assert os.path.exists(os.path.join(inst2, rtwo)) assert os.path.exists(os.path.join(inst, rone)) _distutils/tests/test_build_clib.py 0000644 00000010353 15030122015 0013561 0 ustar 00 """Tests for distutils.command.build_clib.""" import os from distutils.command.build_clib import build_clib from distutils.errors import DistutilsSetupError from distutils.tests import missing_compiler_executable, support import pytest class TestBuildCLib(support.TempdirManager): def test_check_library_dist(self): pkg_dir, dist = self.create_dist() cmd = build_clib(dist) # 'libraries' option must be a list with pytest.raises(DistutilsSetupError): cmd.check_library_list('foo') # each element of 'libraries' must a 2-tuple with pytest.raises(DistutilsSetupError): cmd.check_library_list(['foo1', 'foo2']) # first element of each tuple in 'libraries' # must be a string (the library name) with pytest.raises(DistutilsSetupError): cmd.check_library_list([(1, 'foo1'), ('name', 'foo2')]) # library name may not contain directory separators with pytest.raises(DistutilsSetupError): cmd.check_library_list( [('name', 'foo1'), ('another/name', 'foo2')], ) # second element of each tuple must be a dictionary (build info) with pytest.raises(DistutilsSetupError): cmd.check_library_list( [('name', {}), ('another', 'foo2')], ) # those work libs = [('name', {}), ('name', {'ok': 'good'})] cmd.check_library_list(libs) def test_get_source_files(self): pkg_dir, dist = self.create_dist() cmd = build_clib(dist) # "in 'libraries' option 'sources' must be present and must be # a list of source filenames cmd.libraries = [('name', {})] with pytest.raises(DistutilsSetupError): cmd.get_source_files() cmd.libraries = [('name', {'sources': 1})] with pytest.raises(DistutilsSetupError): cmd.get_source_files() cmd.libraries = [('name', {'sources': ['a', 'b']})] assert cmd.get_source_files() == ['a', 'b'] cmd.libraries = [('name', {'sources': ('a', 'b')})] assert cmd.get_source_files() == ['a', 'b'] cmd.libraries = [ ('name', {'sources': ('a', 'b')}), ('name2', {'sources': ['c', 'd']}), ] assert cmd.get_source_files() == ['a', 'b', 'c', 'd'] def test_build_libraries(self): pkg_dir, dist = self.create_dist() cmd = build_clib(dist) class FakeCompiler: def compile(*args, **kw): pass create_static_lib = compile cmd.compiler = FakeCompiler() # build_libraries is also doing a bit of typo checking lib = [('name', {'sources': 'notvalid'})] with pytest.raises(DistutilsSetupError): cmd.build_libraries(lib) lib = [('name', {'sources': list()})] cmd.build_libraries(lib) lib = [('name', {'sources': tuple()})] cmd.build_libraries(lib) def test_finalize_options(self): pkg_dir, dist = self.create_dist() cmd = build_clib(dist) cmd.include_dirs = 'one-dir' cmd.finalize_options() assert cmd.include_dirs == ['one-dir'] cmd.include_dirs = None cmd.finalize_options() assert cmd.include_dirs == [] cmd.distribution.libraries = 'WONTWORK' with pytest.raises(DistutilsSetupError): cmd.finalize_options() @pytest.mark.skipif('platform.system() == "Windows"') def test_run(self): pkg_dir, dist = self.create_dist() cmd = build_clib(dist) foo_c = os.path.join(pkg_dir, 'foo.c') self.write_file(foo_c, 'int main(void) { return 1;}\n') cmd.libraries = [('foo', {'sources': [foo_c]})] build_temp = os.path.join(pkg_dir, 'build') os.mkdir(build_temp) cmd.build_temp = build_temp cmd.build_clib = build_temp # Before we run the command, we want to make sure # all commands are present on the system. ccmd = missing_compiler_executable() if ccmd is not None: self.skipTest(f'The {ccmd!r} command is not found') # this should work cmd.run() # let's check the result assert 'libfoo.a' in os.listdir(build_temp) _distutils/tests/test_util.py 0000644 00000017464 15030122015 0012460 0 ustar 00 """Tests for distutils.util.""" import email import email.generator import email.policy import io import os import pathlib import sys import sysconfig as stdlib_sysconfig import unittest.mock as mock from copy import copy from distutils import sysconfig, util from distutils.errors import DistutilsByteCompileError, DistutilsPlatformError from distutils.util import ( byte_compile, change_root, check_environ, convert_path, get_host_platform, get_platform, grok_environment_error, rfc822_escape, split_quoted, strtobool, ) import pytest @pytest.fixture(autouse=True) def environment(monkeypatch): monkeypatch.setattr(os, 'name', os.name) monkeypatch.setattr(sys, 'platform', sys.platform) monkeypatch.setattr(sys, 'version', sys.version) monkeypatch.setattr(os, 'sep', os.sep) monkeypatch.setattr(os.path, 'join', os.path.join) monkeypatch.setattr(os.path, 'isabs', os.path.isabs) monkeypatch.setattr(os.path, 'splitdrive', os.path.splitdrive) monkeypatch.setattr(sysconfig, '_config_vars', copy(sysconfig._config_vars)) @pytest.mark.usefixtures('save_env') class TestUtil: def test_get_host_platform(self): with mock.patch('os.name', 'nt'): with mock.patch('sys.version', '... [... (ARM64)]'): assert get_host_platform() == 'win-arm64' with mock.patch('sys.version', '... [... (ARM)]'): assert get_host_platform() == 'win-arm32' with mock.patch('sys.version_info', (3, 9, 0, 'final', 0)): assert get_host_platform() == stdlib_sysconfig.get_platform() def test_get_platform(self): with mock.patch('os.name', 'nt'): with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'x86'}): assert get_platform() == 'win32' with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'x64'}): assert get_platform() == 'win-amd64' with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'arm'}): assert get_platform() == 'win-arm32' with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'arm64'}): assert get_platform() == 'win-arm64' def test_convert_path(self): expected = os.sep.join(('', 'home', 'to', 'my', 'stuff')) assert convert_path('/home/to/my/stuff') == expected assert convert_path(pathlib.Path('/home/to/my/stuff')) == expected assert convert_path('.') == os.curdir def test_change_root(self): # linux/mac os.name = 'posix' def _isabs(path): return path[0] == '/' os.path.isabs = _isabs def _join(*path): return '/'.join(path) os.path.join = _join assert change_root('/root', '/old/its/here') == '/root/old/its/here' assert change_root('/root', 'its/here') == '/root/its/here' # windows os.name = 'nt' os.sep = '\\' def _isabs(path): return path.startswith('c:\\') os.path.isabs = _isabs def _splitdrive(path): if path.startswith('c:'): return ('', path.replace('c:', '')) return ('', path) os.path.splitdrive = _splitdrive def _join(*path): return '\\'.join(path) os.path.join = _join assert ( change_root('c:\\root', 'c:\\old\\its\\here') == 'c:\\root\\old\\its\\here' ) assert change_root('c:\\root', 'its\\here') == 'c:\\root\\its\\here' # BugsBunny os (it's a great os) os.name = 'BugsBunny' with pytest.raises(DistutilsPlatformError): change_root('c:\\root', 'its\\here') # XXX platforms to be covered: mac def test_check_environ(self): util.check_environ.cache_clear() os.environ.pop('HOME', None) check_environ() assert os.environ['PLAT'] == get_platform() @pytest.mark.skipif("os.name != 'posix'") def test_check_environ_getpwuid(self): util.check_environ.cache_clear() os.environ.pop('HOME', None) import pwd # only set pw_dir field, other fields are not used result = pwd.struct_passwd(( None, None, None, None, None, '/home/distutils', None, )) with mock.patch.object(pwd, 'getpwuid', return_value=result): check_environ() assert os.environ['HOME'] == '/home/distutils' util.check_environ.cache_clear() os.environ.pop('HOME', None) # bpo-10496: Catch pwd.getpwuid() error with mock.patch.object(pwd, 'getpwuid', side_effect=KeyError): check_environ() assert 'HOME' not in os.environ def test_split_quoted(self): assert split_quoted('""one"" "two" \'three\' \\four') == [ 'one', 'two', 'three', 'four', ] def test_strtobool(self): yes = ('y', 'Y', 'yes', 'True', 't', 'true', 'True', 'On', 'on', '1') no = ('n', 'no', 'f', 'false', 'off', '0', 'Off', 'No', 'N') for y in yes: assert strtobool(y) for n in no: assert not strtobool(n) indent = 8 * ' ' @pytest.mark.parametrize( "given,wanted", [ # 0x0b, 0x0c, ..., etc are also considered a line break by Python ("hello\x0b\nworld\n", f"hello\x0b{indent}\n{indent}world\n{indent}"), ("hello\x1eworld", f"hello\x1e{indent}world"), ("", ""), ( "I am a\npoor\nlonesome\nheader\n", f"I am a\n{indent}poor\n{indent}lonesome\n{indent}header\n{indent}", ), ], ) def test_rfc822_escape(self, given, wanted): """ We want to ensure a multi-line header parses correctly. For interoperability, the escaped value should also "round-trip" over `email.generator.Generator.flatten` and `email.message_from_*` (see pypa/setuptools#4033). The main issue is that internally `email.policy.EmailPolicy` uses `splitlines` which will split on some control chars. If all the new lines are not prefixed with spaces, the parser will interrupt reading the current header and produce an incomplete value, while incorrectly interpreting the rest of the headers as part of the payload. """ res = rfc822_escape(given) policy = email.policy.EmailPolicy( utf8=True, mangle_from_=False, max_line_length=0, ) with io.StringIO() as buffer: raw = f"header: {res}\nother-header: 42\n\npayload\n" orig = email.message_from_string(raw) email.generator.Generator(buffer, policy=policy).flatten(orig) buffer.seek(0) regen = email.message_from_file(buffer) for msg in (orig, regen): assert msg.get_payload() == "payload\n" assert msg["other-header"] == "42" # Generator may replace control chars with `\n` assert set(msg["header"].splitlines()) == set(res.splitlines()) assert res == wanted def test_dont_write_bytecode(self): # makes sure byte_compile raise a DistutilsError # if sys.dont_write_bytecode is True old_dont_write_bytecode = sys.dont_write_bytecode sys.dont_write_bytecode = True try: with pytest.raises(DistutilsByteCompileError): byte_compile([]) finally: sys.dont_write_bytecode = old_dont_write_bytecode def test_grok_environment_error(self): # test obsolete function to ensure backward compat (#4931) exc = OSError("Unable to find batch file") msg = grok_environment_error(exc) assert msg == "error: Unable to find batch file" _distutils/tests/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000273 15030122015 0020013 0 ustar 00 o �h � @ s d S )N� r r r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/compat/__init__.py�<module> s _distutils/tests/compat/__pycache__/py39.cpython-310.pyc 0000644 00000001132 15030122015 0017053 0 ustar 00 o �h � @ s� d dl Z e jdkr/d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlm Z dS d dl mZ d dl mZ d dl mZ d dl mZ d dl mZ d dl m Z dS ) � N)� � )� CleanImport)� DirsOnSysPath)�EnvironmentVarGuard)�rmtree)�skip_unless_symlink)�unlink) �sys� version_info�test.support.import_helperr r �test.support.os_helperr r r r � test.support� r r �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/tests/compat/py39.py�<module> s _distutils/tests/compat/py39.py 0000644 00000002002 15030122015 0012511 0 ustar 00 import sys if sys.version_info >= (3, 10): from test.support.import_helper import ( CleanImport as CleanImport, ) from test.support.import_helper import ( DirsOnSysPath as DirsOnSysPath, ) from test.support.os_helper import ( EnvironmentVarGuard as EnvironmentVarGuard, ) from test.support.os_helper import ( rmtree as rmtree, ) from test.support.os_helper import ( skip_unless_symlink as skip_unless_symlink, ) from test.support.os_helper import ( unlink as unlink, ) else: from test.support import ( CleanImport as CleanImport, ) from test.support import ( DirsOnSysPath as DirsOnSysPath, ) from test.support import ( EnvironmentVarGuard as EnvironmentVarGuard, ) from test.support import ( rmtree as rmtree, ) from test.support import ( skip_unless_symlink as skip_unless_symlink, ) from test.support import ( unlink as unlink, ) _distutils/tests/compat/__init__.py 0000644 00000000000 15030122015 0013440 0 ustar 00 _distutils/tests/test_sdist.py 0000644 00000035326 15030122015 0012626 0 ustar 00 """Tests for distutils.command.sdist.""" import os import pathlib import shutil # noqa: F401 import tarfile import zipfile from distutils.archive_util import ARCHIVE_FORMATS from distutils.command.sdist import sdist, show_formats from distutils.core import Distribution from distutils.errors import DistutilsOptionError from distutils.filelist import FileList from os.path import join from textwrap import dedent import jaraco.path import path import pytest from more_itertools import ilen from . import support from .unix_compat import grp, pwd, require_uid_0, require_unix_id SETUP_PY = """ from distutils.core import setup import somecode setup(name='fake') """ MANIFEST = """\ # file GENERATED by distutils, do NOT edit README buildout.cfg inroot.txt setup.py data%(sep)sdata.dt scripts%(sep)sscript.py some%(sep)sfile.txt some%(sep)sother_file.txt somecode%(sep)s__init__.py somecode%(sep)sdoc.dat somecode%(sep)sdoc.txt """ @pytest.fixture(autouse=True) def project_dir(request, distutils_managed_tempdir): self = request.instance self.tmp_dir = self.mkdtemp() jaraco.path.build( { 'somecode': { '__init__.py': '#', }, 'README': 'xxx', 'setup.py': SETUP_PY, }, self.tmp_dir, ) with path.Path(self.tmp_dir): yield def clean_lines(filepath): with pathlib.Path(filepath).open(encoding='utf-8') as f: yield from filter(None, map(str.strip, f)) class TestSDist(support.TempdirManager): def get_cmd(self, metadata=None): """Returns a cmd""" if metadata is None: metadata = { 'name': 'ns.fake--pkg', 'version': '1.0', 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', } dist = Distribution(metadata) dist.script_name = 'setup.py' dist.packages = ['somecode'] dist.include_package_data = True cmd = sdist(dist) cmd.dist_dir = 'dist' return dist, cmd @pytest.mark.usefixtures('needs_zlib') def test_prune_file_list(self): # this test creates a project with some VCS dirs and an NFS rename # file, then launches sdist to check they get pruned on all systems # creating VCS directories with some files in them os.mkdir(join(self.tmp_dir, 'somecode', '.svn')) self.write_file((self.tmp_dir, 'somecode', '.svn', 'ok.py'), 'xxx') os.mkdir(join(self.tmp_dir, 'somecode', '.hg')) self.write_file((self.tmp_dir, 'somecode', '.hg', 'ok'), 'xxx') os.mkdir(join(self.tmp_dir, 'somecode', '.git')) self.write_file((self.tmp_dir, 'somecode', '.git', 'ok'), 'xxx') self.write_file((self.tmp_dir, 'somecode', '.nfs0001'), 'xxx') # now building a sdist dist, cmd = self.get_cmd() # zip is available universally # (tar might not be installed under win32) cmd.formats = ['zip'] cmd.ensure_finalized() cmd.run() # now let's check what we have dist_folder = join(self.tmp_dir, 'dist') files = os.listdir(dist_folder) assert files == ['ns_fake_pkg-1.0.zip'] zip_file = zipfile.ZipFile(join(dist_folder, 'ns_fake_pkg-1.0.zip')) try: content = zip_file.namelist() finally: zip_file.close() # making sure everything has been pruned correctly expected = [ '', 'PKG-INFO', 'README', 'setup.py', 'somecode/', 'somecode/__init__.py', ] assert sorted(content) == ['ns_fake_pkg-1.0/' + x for x in expected] @pytest.mark.usefixtures('needs_zlib') @pytest.mark.skipif("not shutil.which('tar')") @pytest.mark.skipif("not shutil.which('gzip')") def test_make_distribution(self): # now building a sdist dist, cmd = self.get_cmd() # creating a gztar then a tar cmd.formats = ['gztar', 'tar'] cmd.ensure_finalized() cmd.run() # making sure we have two files dist_folder = join(self.tmp_dir, 'dist') result = os.listdir(dist_folder) result.sort() assert result == ['ns_fake_pkg-1.0.tar', 'ns_fake_pkg-1.0.tar.gz'] os.remove(join(dist_folder, 'ns_fake_pkg-1.0.tar')) os.remove(join(dist_folder, 'ns_fake_pkg-1.0.tar.gz')) # now trying a tar then a gztar cmd.formats = ['tar', 'gztar'] cmd.ensure_finalized() cmd.run() result = os.listdir(dist_folder) result.sort() assert result == ['ns_fake_pkg-1.0.tar', 'ns_fake_pkg-1.0.tar.gz'] @pytest.mark.usefixtures('needs_zlib') def test_add_defaults(self): # https://bugs.python.org/issue2279 # add_default should also include # data_files and package_data dist, cmd = self.get_cmd() # filling data_files by pointing files # in package_data dist.package_data = {'': ['*.cfg', '*.dat'], 'somecode': ['*.txt']} self.write_file((self.tmp_dir, 'somecode', 'doc.txt'), '#') self.write_file((self.tmp_dir, 'somecode', 'doc.dat'), '#') # adding some data in data_files data_dir = join(self.tmp_dir, 'data') os.mkdir(data_dir) self.write_file((data_dir, 'data.dt'), '#') some_dir = join(self.tmp_dir, 'some') os.mkdir(some_dir) # make sure VCS directories are pruned (#14004) hg_dir = join(self.tmp_dir, '.hg') os.mkdir(hg_dir) self.write_file((hg_dir, 'last-message.txt'), '#') # a buggy regex used to prevent this from working on windows (#6884) self.write_file((self.tmp_dir, 'buildout.cfg'), '#') self.write_file((self.tmp_dir, 'inroot.txt'), '#') self.write_file((some_dir, 'file.txt'), '#') self.write_file((some_dir, 'other_file.txt'), '#') dist.data_files = [ ('data', ['data/data.dt', 'buildout.cfg', 'inroot.txt', 'notexisting']), 'some/file.txt', 'some/other_file.txt', ] # adding a script script_dir = join(self.tmp_dir, 'scripts') os.mkdir(script_dir) self.write_file((script_dir, 'script.py'), '#') dist.scripts = [join('scripts', 'script.py')] cmd.formats = ['zip'] cmd.use_defaults = True cmd.ensure_finalized() cmd.run() # now let's check what we have dist_folder = join(self.tmp_dir, 'dist') files = os.listdir(dist_folder) assert files == ['ns_fake_pkg-1.0.zip'] zip_file = zipfile.ZipFile(join(dist_folder, 'ns_fake_pkg-1.0.zip')) try: content = zip_file.namelist() finally: zip_file.close() # making sure everything was added expected = [ '', 'PKG-INFO', 'README', 'buildout.cfg', 'data/', 'data/data.dt', 'inroot.txt', 'scripts/', 'scripts/script.py', 'setup.py', 'some/', 'some/file.txt', 'some/other_file.txt', 'somecode/', 'somecode/__init__.py', 'somecode/doc.dat', 'somecode/doc.txt', ] assert sorted(content) == ['ns_fake_pkg-1.0/' + x for x in expected] # checking the MANIFEST manifest = pathlib.Path(self.tmp_dir, 'MANIFEST').read_text(encoding='utf-8') assert manifest == MANIFEST % {'sep': os.sep} @staticmethod def warnings(messages, prefix='warning: '): return [msg for msg in messages if msg.startswith(prefix)] @pytest.mark.usefixtures('needs_zlib') def test_metadata_check_option(self, caplog): # testing the `medata-check` option dist, cmd = self.get_cmd(metadata={}) # this should raise some warnings ! # with the `check` subcommand cmd.ensure_finalized() cmd.run() assert len(self.warnings(caplog.messages, 'warning: check: ')) == 1 # trying with a complete set of metadata caplog.clear() dist, cmd = self.get_cmd() cmd.ensure_finalized() cmd.metadata_check = False cmd.run() assert len(self.warnings(caplog.messages, 'warning: check: ')) == 0 def test_show_formats(self, capsys): show_formats() # the output should be a header line + one line per format num_formats = len(ARCHIVE_FORMATS.keys()) output = [ line for line in capsys.readouterr().out.split('\n') if line.strip().startswith('--formats=') ] assert len(output) == num_formats def test_finalize_options(self): dist, cmd = self.get_cmd() cmd.finalize_options() # default options set by finalize assert cmd.manifest == 'MANIFEST' assert cmd.template == 'MANIFEST.in' assert cmd.dist_dir == 'dist' # formats has to be a string splitable on (' ', ',') or # a stringlist cmd.formats = 1 with pytest.raises(DistutilsOptionError): cmd.finalize_options() cmd.formats = ['zip'] cmd.finalize_options() # formats has to be known cmd.formats = 'supazipa' with pytest.raises(DistutilsOptionError): cmd.finalize_options() # the following tests make sure there is a nice error message instead # of a traceback when parsing an invalid manifest template def _check_template(self, content, caplog): dist, cmd = self.get_cmd() os.chdir(self.tmp_dir) self.write_file('MANIFEST.in', content) cmd.ensure_finalized() cmd.filelist = FileList() cmd.read_template() assert len(self.warnings(caplog.messages)) == 1 def test_invalid_template_unknown_command(self, caplog): self._check_template('taunt knights *', caplog) def test_invalid_template_wrong_arguments(self, caplog): # this manifest command takes one argument self._check_template('prune', caplog) @pytest.mark.skipif("platform.system() != 'Windows'") def test_invalid_template_wrong_path(self, caplog): # on Windows, trailing slashes are not allowed # this used to crash instead of raising a warning: #8286 self._check_template('include examples/', caplog) @pytest.mark.usefixtures('needs_zlib') def test_get_file_list(self): # make sure MANIFEST is recalculated dist, cmd = self.get_cmd() # filling data_files by pointing files in package_data dist.package_data = {'somecode': ['*.txt']} self.write_file((self.tmp_dir, 'somecode', 'doc.txt'), '#') cmd.formats = ['gztar'] cmd.ensure_finalized() cmd.run() assert ilen(clean_lines(cmd.manifest)) == 5 # adding a file self.write_file((self.tmp_dir, 'somecode', 'doc2.txt'), '#') # make sure build_py is reinitialized, like a fresh run build_py = dist.get_command_obj('build_py') build_py.finalized = False build_py.ensure_finalized() cmd.run() manifest2 = list(clean_lines(cmd.manifest)) # do we have the new file in MANIFEST ? assert len(manifest2) == 6 assert 'doc2.txt' in manifest2[-1] @pytest.mark.usefixtures('needs_zlib') def test_manifest_marker(self): # check that autogenerated MANIFESTs have a marker dist, cmd = self.get_cmd() cmd.ensure_finalized() cmd.run() assert ( next(clean_lines(cmd.manifest)) == '# file GENERATED by distutils, do NOT edit' ) @pytest.mark.usefixtures('needs_zlib') def test_manifest_comments(self): # make sure comments don't cause exceptions or wrong includes contents = dedent( """\ # bad.py #bad.py good.py """ ) dist, cmd = self.get_cmd() cmd.ensure_finalized() self.write_file((self.tmp_dir, cmd.manifest), contents) self.write_file((self.tmp_dir, 'good.py'), '# pick me!') self.write_file((self.tmp_dir, 'bad.py'), "# don't pick me!") self.write_file((self.tmp_dir, '#bad.py'), "# don't pick me!") cmd.run() assert cmd.filelist.files == ['good.py'] @pytest.mark.usefixtures('needs_zlib') def test_manual_manifest(self): # check that a MANIFEST without a marker is left alone dist, cmd = self.get_cmd() cmd.formats = ['gztar'] cmd.ensure_finalized() self.write_file((self.tmp_dir, cmd.manifest), 'README.manual') self.write_file( (self.tmp_dir, 'README.manual'), 'This project maintains its MANIFEST file itself.', ) cmd.run() assert cmd.filelist.files == ['README.manual'] assert list(clean_lines(cmd.manifest)) == ['README.manual'] archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') archive = tarfile.open(archive_name) try: filenames = [tarinfo.name for tarinfo in archive] finally: archive.close() assert sorted(filenames) == [ 'ns_fake_pkg-1.0', 'ns_fake_pkg-1.0/PKG-INFO', 'ns_fake_pkg-1.0/README.manual', ] @pytest.mark.usefixtures('needs_zlib') @require_unix_id @require_uid_0 @pytest.mark.skipif("not shutil.which('tar')") @pytest.mark.skipif("not shutil.which('gzip')") def test_make_distribution_owner_group(self): # now building a sdist dist, cmd = self.get_cmd() # creating a gztar and specifying the owner+group cmd.formats = ['gztar'] cmd.owner = pwd.getpwuid(0)[0] cmd.group = grp.getgrgid(0)[0] cmd.ensure_finalized() cmd.run() # making sure we have the good rights archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') archive = tarfile.open(archive_name) try: for member in archive.getmembers(): assert member.uid == 0 assert member.gid == 0 finally: archive.close() # building a sdist again dist, cmd = self.get_cmd() # creating a gztar cmd.formats = ['gztar'] cmd.ensure_finalized() cmd.run() # making sure we have the good rights archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') archive = tarfile.open(archive_name) # note that we are not testing the group ownership here # because, depending on the platforms and the container # rights (see #7408) try: for member in archive.getmembers(): assert member.uid == os.getuid() finally: archive.close() _distutils/tests/test_spawn.py 0000644 00000011303 15030122015 0012615 0 ustar 00 """Tests for distutils.spawn.""" import os import stat import sys import unittest.mock as mock from distutils.errors import DistutilsExecError from distutils.spawn import find_executable, spawn from distutils.tests import support import path import pytest from test.support import unix_shell from .compat import py39 as os_helper class TestSpawn(support.TempdirManager): @pytest.mark.skipif("os.name not in ('nt', 'posix')") def test_spawn(self): tmpdir = self.mkdtemp() # creating something executable # through the shell that returns 1 if sys.platform != 'win32': exe = os.path.join(tmpdir, 'foo.sh') self.write_file(exe, f'#!{unix_shell}\nexit 1') else: exe = os.path.join(tmpdir, 'foo.bat') self.write_file(exe, 'exit 1') os.chmod(exe, 0o777) with pytest.raises(DistutilsExecError): spawn([exe]) # now something that works if sys.platform != 'win32': exe = os.path.join(tmpdir, 'foo.sh') self.write_file(exe, f'#!{unix_shell}\nexit 0') else: exe = os.path.join(tmpdir, 'foo.bat') self.write_file(exe, 'exit 0') os.chmod(exe, 0o777) spawn([exe]) # should work without any error def test_find_executable(self, tmp_path): program_path = self._make_executable(tmp_path, '.exe') program = program_path.name program_noeext = program_path.with_suffix('').name filename = str(program_path) tmp_dir = path.Path(tmp_path) # test path parameter rv = find_executable(program, path=tmp_dir) assert rv == filename if sys.platform == 'win32': # test without ".exe" extension rv = find_executable(program_noeext, path=tmp_dir) assert rv == filename # test find in the current directory with tmp_dir: rv = find_executable(program) assert rv == program # test non-existent program dont_exist_program = "dontexist_" + program rv = find_executable(dont_exist_program, path=tmp_dir) assert rv is None # PATH='': no match, except in the current directory with os_helper.EnvironmentVarGuard() as env: env['PATH'] = '' with ( mock.patch( 'distutils.spawn.os.confstr', return_value=tmp_dir, create=True ), mock.patch('distutils.spawn.os.defpath', tmp_dir), ): rv = find_executable(program) assert rv is None # look in current directory with tmp_dir: rv = find_executable(program) assert rv == program # PATH=':': explicitly looks in the current directory with os_helper.EnvironmentVarGuard() as env: env['PATH'] = os.pathsep with ( mock.patch('distutils.spawn.os.confstr', return_value='', create=True), mock.patch('distutils.spawn.os.defpath', ''), ): rv = find_executable(program) assert rv is None # look in current directory with tmp_dir: rv = find_executable(program) assert rv == program # missing PATH: test os.confstr("CS_PATH") and os.defpath with os_helper.EnvironmentVarGuard() as env: env.pop('PATH', None) # without confstr with ( mock.patch( 'distutils.spawn.os.confstr', side_effect=ValueError, create=True ), mock.patch('distutils.spawn.os.defpath', tmp_dir), ): rv = find_executable(program) assert rv == filename # with confstr with ( mock.patch( 'distutils.spawn.os.confstr', return_value=tmp_dir, create=True ), mock.patch('distutils.spawn.os.defpath', ''), ): rv = find_executable(program) assert rv == filename @staticmethod def _make_executable(tmp_path, ext): # Give the temporary program a suffix regardless of platform. # It's needed on Windows and not harmful on others. program = tmp_path.joinpath('program').with_suffix(ext) program.write_text("", encoding='utf-8') program.chmod(stat.S_IXUSR) return program def test_spawn_missing_exe(self): with pytest.raises(DistutilsExecError) as ctx: spawn(['does-not-exist']) assert "command 'does-not-exist' failed" in str(ctx.value) _distutils/tests/test_install_scripts.py 0000644 00000003100 15030122015 0014676 0 ustar 00 """Tests for distutils.command.install_scripts.""" import os from distutils.command.install_scripts import install_scripts from distutils.core import Distribution from distutils.tests import support from . import test_build_scripts class TestInstallScripts(support.TempdirManager): def test_default_settings(self): dist = Distribution() dist.command_obj["build"] = support.DummyCommand(build_scripts="/foo/bar") dist.command_obj["install"] = support.DummyCommand( install_scripts="/splat/funk", force=True, skip_build=True, ) cmd = install_scripts(dist) assert not cmd.force assert not cmd.skip_build assert cmd.build_dir is None assert cmd.install_dir is None cmd.finalize_options() assert cmd.force assert cmd.skip_build assert cmd.build_dir == "/foo/bar" assert cmd.install_dir == "/splat/funk" def test_installation(self): source = self.mkdtemp() expected = test_build_scripts.TestBuildScripts.write_sample_scripts(source) target = self.mkdtemp() dist = Distribution() dist.command_obj["build"] = support.DummyCommand(build_scripts=source) dist.command_obj["install"] = support.DummyCommand( install_scripts=target, force=True, skip_build=True, ) cmd = install_scripts(dist) cmd.finalize_options() cmd.run() installed = os.listdir(target) for name in expected: assert name in installed _distutils/tests/test_bdist.py 0000644 00000002564 15030122015 0012603 0 ustar 00 """Tests for distutils.command.bdist.""" from distutils.command.bdist import bdist from distutils.tests import support class TestBuild(support.TempdirManager): def test_formats(self): # let's create a command and make sure # we can set the format dist = self.create_dist()[1] cmd = bdist(dist) cmd.formats = ['gztar'] cmd.ensure_finalized() assert cmd.formats == ['gztar'] # what formats does bdist offer? formats = [ 'bztar', 'gztar', 'rpm', 'tar', 'xztar', 'zip', 'ztar', ] found = sorted(cmd.format_commands) assert found == formats def test_skip_build(self): # bug #10946: bdist --skip-build should trickle down to subcommands dist = self.create_dist()[1] cmd = bdist(dist) cmd.skip_build = True cmd.ensure_finalized() dist.command_obj['bdist'] = cmd names = [ 'bdist_dumb', ] # bdist_rpm does not support --skip-build for name in names: subcmd = cmd.get_finalized_command(name) if getattr(subcmd, '_unsupported', False): # command is not supported on this build continue assert subcmd.skip_build, f'{name} should take --skip-build from bdist' _distutils/tests/test_dir_util.py 0000644 00000010624 15030122015 0013305 0 ustar 00 """Tests for distutils.dir_util.""" import os import pathlib import stat import sys import unittest.mock as mock from distutils import dir_util, errors from distutils.dir_util import ( copy_tree, create_tree, ensure_relative, mkpath, remove_tree, ) from distutils.tests import support import jaraco.path import path import pytest @pytest.fixture(autouse=True) def stuff(request, monkeypatch, distutils_managed_tempdir): self = request.instance tmp_dir = self.mkdtemp() self.root_target = os.path.join(tmp_dir, 'deep') self.target = os.path.join(self.root_target, 'here') self.target2 = os.path.join(tmp_dir, 'deep2') class TestDirUtil(support.TempdirManager): def test_mkpath_remove_tree_verbosity(self, caplog): mkpath(self.target, verbose=False) assert not caplog.records remove_tree(self.root_target, verbose=False) mkpath(self.target, verbose=True) wanted = [f'creating {self.target}'] assert caplog.messages == wanted caplog.clear() remove_tree(self.root_target, verbose=True) wanted = [f"removing '{self.root_target}' (and everything under it)"] assert caplog.messages == wanted @pytest.mark.skipif("platform.system() == 'Windows'") def test_mkpath_with_custom_mode(self): # Get and set the current umask value for testing mode bits. umask = os.umask(0o002) os.umask(umask) mkpath(self.target, 0o700) assert stat.S_IMODE(os.stat(self.target).st_mode) == 0o700 & ~umask mkpath(self.target2, 0o555) assert stat.S_IMODE(os.stat(self.target2).st_mode) == 0o555 & ~umask def test_create_tree_verbosity(self, caplog): create_tree(self.root_target, ['one', 'two', 'three'], verbose=False) assert caplog.messages == [] remove_tree(self.root_target, verbose=False) wanted = [f'creating {self.root_target}'] create_tree(self.root_target, ['one', 'two', 'three'], verbose=True) assert caplog.messages == wanted remove_tree(self.root_target, verbose=False) def test_copy_tree_verbosity(self, caplog): mkpath(self.target, verbose=False) copy_tree(self.target, self.target2, verbose=False) assert caplog.messages == [] remove_tree(self.root_target, verbose=False) mkpath(self.target, verbose=False) a_file = path.Path(self.target) / 'ok.txt' jaraco.path.build({'ok.txt': 'some content'}, self.target) wanted = [f'copying {a_file} -> {self.target2}'] copy_tree(self.target, self.target2, verbose=True) assert caplog.messages == wanted remove_tree(self.root_target, verbose=False) remove_tree(self.target2, verbose=False) def test_copy_tree_skips_nfs_temp_files(self): mkpath(self.target, verbose=False) jaraco.path.build({'ok.txt': 'some content', '.nfs123abc': ''}, self.target) copy_tree(self.target, self.target2) assert os.listdir(self.target2) == ['ok.txt'] remove_tree(self.root_target, verbose=False) remove_tree(self.target2, verbose=False) def test_ensure_relative(self): if os.sep == '/': assert ensure_relative('/home/foo') == 'home/foo' assert ensure_relative('some/path') == 'some/path' else: # \\ assert ensure_relative('c:\\home\\foo') == 'c:home\\foo' assert ensure_relative('home\\foo') == 'home\\foo' def test_copy_tree_exception_in_listdir(self): """ An exception in listdir should raise a DistutilsFileError """ with ( mock.patch("os.listdir", side_effect=OSError()), pytest.raises(errors.DistutilsFileError), ): src = self.tempdirs[-1] dir_util.copy_tree(src, None) def test_mkpath_exception_uncached(self, monkeypatch, tmp_path): """ Caching should not remember failed attempts. pypa/distutils#304 """ class FailPath(pathlib.Path): def mkdir(self, *args, **kwargs): raise OSError("Failed to create directory") if sys.version_info < (3, 12): _flavour = pathlib.Path()._flavour target = tmp_path / 'foodir' with pytest.raises(errors.DistutilsFileError): mkpath(FailPath(target)) assert not target.exists() mkpath(target) assert target.exists() _distutils/tests/test_bdist_rpm.py 0000644 00000007534 15030122015 0013463 0 ustar 00 """Tests for distutils.command.bdist_rpm.""" import os import shutil # noqa: F401 import sys from distutils.command.bdist_rpm import bdist_rpm from distutils.core import Distribution from distutils.tests import support import pytest from test.support import requires_zlib SETUP_PY = """\ from distutils.core import setup import foo setup(name='foo', version='0.1', py_modules=['foo'], url='xxx', author='xxx', author_email='xxx') """ @pytest.fixture(autouse=True) def sys_executable_encodable(): try: sys.executable.encode('UTF-8') except UnicodeEncodeError: pytest.skip("sys.executable is not encodable to UTF-8") mac_woes = pytest.mark.skipif( "not sys.platform.startswith('linux')", reason='spurious sdtout/stderr output under macOS', ) @pytest.mark.usefixtures('save_env') @pytest.mark.usefixtures('save_argv') @pytest.mark.usefixtures('save_cwd') class TestBuildRpm( support.TempdirManager, ): @mac_woes @requires_zlib() @pytest.mark.skipif("not shutil.which('rpm')") @pytest.mark.skipif("not shutil.which('rpmbuild')") def test_quiet(self): # let's create a package tmp_dir = self.mkdtemp() os.environ['HOME'] = tmp_dir # to confine dir '.rpmdb' creation pkg_dir = os.path.join(tmp_dir, 'foo') os.mkdir(pkg_dir) self.write_file((pkg_dir, 'setup.py'), SETUP_PY) self.write_file((pkg_dir, 'foo.py'), '#') self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') self.write_file((pkg_dir, 'README'), '') dist = Distribution({ 'name': 'foo', 'version': '0.1', 'py_modules': ['foo'], 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', }) dist.script_name = 'setup.py' os.chdir(pkg_dir) sys.argv = ['setup.py'] cmd = bdist_rpm(dist) cmd.fix_python = True # running in quiet mode cmd.quiet = True cmd.ensure_finalized() cmd.run() dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) assert 'foo-0.1-1.noarch.rpm' in dist_created # bug #2945: upload ignores bdist_rpm files assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.src.rpm') in dist.dist_files assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.noarch.rpm') in dist.dist_files @mac_woes @requires_zlib() # https://bugs.python.org/issue1533164 @pytest.mark.skipif("not shutil.which('rpm')") @pytest.mark.skipif("not shutil.which('rpmbuild')") def test_no_optimize_flag(self): # let's create a package that breaks bdist_rpm tmp_dir = self.mkdtemp() os.environ['HOME'] = tmp_dir # to confine dir '.rpmdb' creation pkg_dir = os.path.join(tmp_dir, 'foo') os.mkdir(pkg_dir) self.write_file((pkg_dir, 'setup.py'), SETUP_PY) self.write_file((pkg_dir, 'foo.py'), '#') self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') self.write_file((pkg_dir, 'README'), '') dist = Distribution({ 'name': 'foo', 'version': '0.1', 'py_modules': ['foo'], 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', }) dist.script_name = 'setup.py' os.chdir(pkg_dir) sys.argv = ['setup.py'] cmd = bdist_rpm(dist) cmd.fix_python = True cmd.quiet = True cmd.ensure_finalized() cmd.run() dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) assert 'foo-0.1-1.noarch.rpm' in dist_created # bug #2945: upload ignores bdist_rpm files assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.src.rpm') in dist.dist_files assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.noarch.rpm') in dist.dist_files os.remove(os.path.join(pkg_dir, 'dist', 'foo-0.1-1.noarch.rpm')) _distutils/tests/test_bdist_dumb.py 0000644 00000004307 15030122015 0013607 0 ustar 00 """Tests for distutils.command.bdist_dumb.""" import os import sys import zipfile from distutils.command.bdist_dumb import bdist_dumb from distutils.core import Distribution from distutils.tests import support import pytest SETUP_PY = """\ from distutils.core import setup import foo setup(name='foo', version='0.1', py_modules=['foo'], url='xxx', author='xxx', author_email='xxx') """ @support.combine_markers @pytest.mark.usefixtures('save_env') @pytest.mark.usefixtures('save_argv') @pytest.mark.usefixtures('save_cwd') class TestBuildDumb( support.TempdirManager, ): @pytest.mark.usefixtures('needs_zlib') def test_simple_built(self): # let's create a simple package tmp_dir = self.mkdtemp() pkg_dir = os.path.join(tmp_dir, 'foo') os.mkdir(pkg_dir) self.write_file((pkg_dir, 'setup.py'), SETUP_PY) self.write_file((pkg_dir, 'foo.py'), '#') self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') self.write_file((pkg_dir, 'README'), '') dist = Distribution({ 'name': 'foo', 'version': '0.1', 'py_modules': ['foo'], 'url': 'xxx', 'author': 'xxx', 'author_email': 'xxx', }) dist.script_name = 'setup.py' os.chdir(pkg_dir) sys.argv = ['setup.py'] cmd = bdist_dumb(dist) # so the output is the same no matter # what is the platform cmd.format = 'zip' cmd.ensure_finalized() cmd.run() # see what we have dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) base = f"{dist.get_fullname()}.{cmd.plat_name}.zip" assert dist_created == [base] # now let's check what we have in the zip file fp = zipfile.ZipFile(os.path.join('dist', base)) try: contents = fp.namelist() finally: fp.close() contents = sorted(filter(None, map(os.path.basename, contents))) wanted = ['foo-0.1-py{}.{}.egg-info'.format(*sys.version_info[:2]), 'foo.py'] if not sys.dont_write_bytecode: wanted.append(f'foo.{sys.implementation.cache_tag}.pyc') assert contents == sorted(wanted) _distutils/tests/test_dist.py 0000644 00000044551 15030122015 0012443 0 ustar 00 """Tests for distutils.dist.""" import email import email.generator import email.policy import functools import io import os import sys import textwrap import unittest.mock as mock import warnings from distutils.cmd import Command from distutils.dist import Distribution, fix_help_options from distutils.tests import support from typing import ClassVar import jaraco.path import pytest pydistutils_cfg = '.' * (os.name == 'posix') + 'pydistutils.cfg' class test_dist(Command): """Sample distutils extension command.""" user_options: ClassVar[list[tuple[str, str, str]]] = [ ("sample-option=", "S", "help text"), ] def initialize_options(self): self.sample_option = None class TestDistribution(Distribution): """Distribution subclasses that avoids the default search for configuration files. The ._config_files attribute must be set before .parse_config_files() is called. """ def find_config_files(self): return self._config_files @pytest.fixture def clear_argv(): del sys.argv[1:] @support.combine_markers @pytest.mark.usefixtures('save_env') @pytest.mark.usefixtures('save_argv') class TestDistributionBehavior(support.TempdirManager): def create_distribution(self, configfiles=()): d = TestDistribution() d._config_files = configfiles d.parse_config_files() d.parse_command_line() return d def test_command_packages_unspecified(self, clear_argv): sys.argv.append("build") d = self.create_distribution() assert d.get_command_packages() == ["distutils.command"] def test_command_packages_cmdline(self, clear_argv): from distutils.tests.test_dist import test_dist sys.argv.extend([ "--command-packages", "foo.bar,distutils.tests", "test_dist", "-Ssometext", ]) d = self.create_distribution() # let's actually try to load our test command: assert d.get_command_packages() == [ "distutils.command", "foo.bar", "distutils.tests", ] cmd = d.get_command_obj("test_dist") assert isinstance(cmd, test_dist) assert cmd.sample_option == "sometext" @pytest.mark.skipif( 'distutils' not in Distribution.parse_config_files.__module__, reason='Cannot test when virtualenv has monkey-patched Distribution', ) def test_venv_install_options(self, tmp_path, clear_argv): sys.argv.append("install") file = str(tmp_path / 'file') fakepath = '/somedir' jaraco.path.build({ file: f""" [install] install-base = {fakepath} install-platbase = {fakepath} install-lib = {fakepath} install-platlib = {fakepath} install-purelib = {fakepath} install-headers = {fakepath} install-scripts = {fakepath} install-data = {fakepath} prefix = {fakepath} exec-prefix = {fakepath} home = {fakepath} user = {fakepath} root = {fakepath} """, }) # Base case: Not in a Virtual Environment with mock.patch.multiple(sys, prefix='/a', base_prefix='/a'): d = self.create_distribution([file]) option_tuple = (file, fakepath) result_dict = { 'install_base': option_tuple, 'install_platbase': option_tuple, 'install_lib': option_tuple, 'install_platlib': option_tuple, 'install_purelib': option_tuple, 'install_headers': option_tuple, 'install_scripts': option_tuple, 'install_data': option_tuple, 'prefix': option_tuple, 'exec_prefix': option_tuple, 'home': option_tuple, 'user': option_tuple, 'root': option_tuple, } assert sorted(d.command_options.get('install').keys()) == sorted( result_dict.keys() ) for key, value in d.command_options.get('install').items(): assert value == result_dict[key] # Test case: In a Virtual Environment with mock.patch.multiple(sys, prefix='/a', base_prefix='/b'): d = self.create_distribution([file]) for key in result_dict.keys(): assert key not in d.command_options.get('install', {}) def test_command_packages_configfile(self, tmp_path, clear_argv): sys.argv.append("build") file = str(tmp_path / "file") jaraco.path.build({ file: """ [global] command_packages = foo.bar, splat """, }) d = self.create_distribution([file]) assert d.get_command_packages() == ["distutils.command", "foo.bar", "splat"] # ensure command line overrides config: sys.argv[1:] = ["--command-packages", "spork", "build"] d = self.create_distribution([file]) assert d.get_command_packages() == ["distutils.command", "spork"] # Setting --command-packages to '' should cause the default to # be used even if a config file specified something else: sys.argv[1:] = ["--command-packages", "", "build"] d = self.create_distribution([file]) assert d.get_command_packages() == ["distutils.command"] def test_empty_options(self, request): # an empty options dictionary should not stay in the # list of attributes # catching warnings warns = [] def _warn(msg): warns.append(msg) request.addfinalizer( functools.partial(setattr, warnings, 'warn', warnings.warn) ) warnings.warn = _warn dist = Distribution( attrs={ 'author': 'xxx', 'name': 'xxx', 'version': 'xxx', 'url': 'xxxx', 'options': {}, } ) assert len(warns) == 0 assert 'options' not in dir(dist) def test_finalize_options(self): attrs = {'keywords': 'one,two', 'platforms': 'one,two'} dist = Distribution(attrs=attrs) dist.finalize_options() # finalize_option splits platforms and keywords assert dist.metadata.platforms == ['one', 'two'] assert dist.metadata.keywords == ['one', 'two'] attrs = {'keywords': 'foo bar', 'platforms': 'foo bar'} dist = Distribution(attrs=attrs) dist.finalize_options() assert dist.metadata.platforms == ['foo bar'] assert dist.metadata.keywords == ['foo bar'] def test_get_command_packages(self): dist = Distribution() assert dist.command_packages is None cmds = dist.get_command_packages() assert cmds == ['distutils.command'] assert dist.command_packages == ['distutils.command'] dist.command_packages = 'one,two' cmds = dist.get_command_packages() assert cmds == ['distutils.command', 'one', 'two'] def test_announce(self): # make sure the level is known dist = Distribution() with pytest.raises(TypeError): dist.announce('ok', level='ok2') def test_find_config_files_disable(self, temp_home): # Ticket #1180: Allow user to disable their home config file. jaraco.path.build({pydistutils_cfg: '[distutils]\n'}, temp_home) d = Distribution() all_files = d.find_config_files() d = Distribution(attrs={'script_args': ['--no-user-cfg']}) files = d.find_config_files() # make sure --no-user-cfg disables the user cfg file assert len(all_files) - 1 == len(files) def test_script_args_list_coercion(self): d = Distribution(attrs={'script_args': ('build', '--no-user-cfg')}) # make sure script_args is a list even if it started as a different iterable assert d.script_args == ['build', '--no-user-cfg'] @pytest.mark.skipif( 'platform.system() == "Windows"', reason='Windows does not honor chmod 000', ) def test_find_config_files_permission_error(self, fake_home): """ Finding config files should not fail when directory is inaccessible. """ fake_home.joinpath(pydistutils_cfg).write_text('', encoding='utf-8') fake_home.chmod(0o000) Distribution().find_config_files() @pytest.mark.usefixtures('save_env') @pytest.mark.usefixtures('save_argv') class TestMetadata(support.TempdirManager): def format_metadata(self, dist): sio = io.StringIO() dist.metadata.write_pkg_file(sio) return sio.getvalue() def test_simple_metadata(self): attrs = {"name": "package", "version": "1.0"} dist = Distribution(attrs) meta = self.format_metadata(dist) assert "Metadata-Version: 1.0" in meta assert "provides:" not in meta.lower() assert "requires:" not in meta.lower() assert "obsoletes:" not in meta.lower() def test_provides(self): attrs = { "name": "package", "version": "1.0", "provides": ["package", "package.sub"], } dist = Distribution(attrs) assert dist.metadata.get_provides() == ["package", "package.sub"] assert dist.get_provides() == ["package", "package.sub"] meta = self.format_metadata(dist) assert "Metadata-Version: 1.1" in meta assert "requires:" not in meta.lower() assert "obsoletes:" not in meta.lower() def test_provides_illegal(self): with pytest.raises(ValueError): Distribution( {"name": "package", "version": "1.0", "provides": ["my.pkg (splat)"]}, ) def test_requires(self): attrs = { "name": "package", "version": "1.0", "requires": ["other", "another (==1.0)"], } dist = Distribution(attrs) assert dist.metadata.get_requires() == ["other", "another (==1.0)"] assert dist.get_requires() == ["other", "another (==1.0)"] meta = self.format_metadata(dist) assert "Metadata-Version: 1.1" in meta assert "provides:" not in meta.lower() assert "Requires: other" in meta assert "Requires: another (==1.0)" in meta assert "obsoletes:" not in meta.lower() def test_requires_illegal(self): with pytest.raises(ValueError): Distribution( {"name": "package", "version": "1.0", "requires": ["my.pkg (splat)"]}, ) def test_requires_to_list(self): attrs = {"name": "package", "requires": iter(["other"])} dist = Distribution(attrs) assert isinstance(dist.metadata.requires, list) def test_obsoletes(self): attrs = { "name": "package", "version": "1.0", "obsoletes": ["other", "another (<1.0)"], } dist = Distribution(attrs) assert dist.metadata.get_obsoletes() == ["other", "another (<1.0)"] assert dist.get_obsoletes() == ["other", "another (<1.0)"] meta = self.format_metadata(dist) assert "Metadata-Version: 1.1" in meta assert "provides:" not in meta.lower() assert "requires:" not in meta.lower() assert "Obsoletes: other" in meta assert "Obsoletes: another (<1.0)" in meta def test_obsoletes_illegal(self): with pytest.raises(ValueError): Distribution( {"name": "package", "version": "1.0", "obsoletes": ["my.pkg (splat)"]}, ) def test_obsoletes_to_list(self): attrs = {"name": "package", "obsoletes": iter(["other"])} dist = Distribution(attrs) assert isinstance(dist.metadata.obsoletes, list) def test_classifier(self): attrs = { 'name': 'Boa', 'version': '3.0', 'classifiers': ['Programming Language :: Python :: 3'], } dist = Distribution(attrs) assert dist.get_classifiers() == ['Programming Language :: Python :: 3'] meta = self.format_metadata(dist) assert 'Metadata-Version: 1.1' in meta def test_classifier_invalid_type(self, caplog): attrs = { 'name': 'Boa', 'version': '3.0', 'classifiers': ('Programming Language :: Python :: 3',), } d = Distribution(attrs) # should have warning about passing a non-list assert 'should be a list' in caplog.messages[0] # should be converted to a list assert isinstance(d.metadata.classifiers, list) assert d.metadata.classifiers == list(attrs['classifiers']) def test_keywords(self): attrs = { 'name': 'Monty', 'version': '1.0', 'keywords': ['spam', 'eggs', 'life of brian'], } dist = Distribution(attrs) assert dist.get_keywords() == ['spam', 'eggs', 'life of brian'] def test_keywords_invalid_type(self, caplog): attrs = { 'name': 'Monty', 'version': '1.0', 'keywords': ('spam', 'eggs', 'life of brian'), } d = Distribution(attrs) # should have warning about passing a non-list assert 'should be a list' in caplog.messages[0] # should be converted to a list assert isinstance(d.metadata.keywords, list) assert d.metadata.keywords == list(attrs['keywords']) def test_platforms(self): attrs = { 'name': 'Monty', 'version': '1.0', 'platforms': ['GNU/Linux', 'Some Evil Platform'], } dist = Distribution(attrs) assert dist.get_platforms() == ['GNU/Linux', 'Some Evil Platform'] def test_platforms_invalid_types(self, caplog): attrs = { 'name': 'Monty', 'version': '1.0', 'platforms': ('GNU/Linux', 'Some Evil Platform'), } d = Distribution(attrs) # should have warning about passing a non-list assert 'should be a list' in caplog.messages[0] # should be converted to a list assert isinstance(d.metadata.platforms, list) assert d.metadata.platforms == list(attrs['platforms']) def test_download_url(self): attrs = { 'name': 'Boa', 'version': '3.0', 'download_url': 'http://example.org/boa', } dist = Distribution(attrs) meta = self.format_metadata(dist) assert 'Metadata-Version: 1.1' in meta def test_long_description(self): long_desc = textwrap.dedent( """\ example:: We start here and continue here and end here.""" ) attrs = {"name": "package", "version": "1.0", "long_description": long_desc} dist = Distribution(attrs) meta = self.format_metadata(dist) meta = meta.replace('\n' + 8 * ' ', '\n') assert long_desc in meta def test_custom_pydistutils(self, temp_home): """ pydistutils.cfg is found """ jaraco.path.build({pydistutils_cfg: ''}, temp_home) config_path = temp_home / pydistutils_cfg assert str(config_path) in Distribution().find_config_files() def test_extra_pydistutils(self, monkeypatch, tmp_path): jaraco.path.build({'overrides.cfg': ''}, tmp_path) filename = tmp_path / 'overrides.cfg' monkeypatch.setenv('DIST_EXTRA_CONFIG', str(filename)) assert str(filename) in Distribution().find_config_files() def test_fix_help_options(self): help_tuples = [('a', 'b', 'c', 'd'), (1, 2, 3, 4)] fancy_options = fix_help_options(help_tuples) assert fancy_options[0] == ('a', 'b', 'c') assert fancy_options[1] == (1, 2, 3) def test_show_help(self, request, capsys): # smoke test, just makes sure some help is displayed dist = Distribution() sys.argv = [] dist.help = True dist.script_name = 'setup.py' dist.parse_command_line() output = [ line for line in capsys.readouterr().out.split('\n') if line.strip() != '' ] assert output def test_read_metadata(self): attrs = { "name": "package", "version": "1.0", "long_description": "desc", "description": "xxx", "download_url": "http://example.com", "keywords": ['one', 'two'], "requires": ['foo'], } dist = Distribution(attrs) metadata = dist.metadata # write it then reloads it PKG_INFO = io.StringIO() metadata.write_pkg_file(PKG_INFO) PKG_INFO.seek(0) metadata.read_pkg_file(PKG_INFO) assert metadata.name == "package" assert metadata.version == "1.0" assert metadata.description == "xxx" assert metadata.download_url == 'http://example.com' assert metadata.keywords == ['one', 'two'] assert metadata.platforms is None assert metadata.obsoletes is None assert metadata.requires == ['foo'] def test_round_trip_through_email_generator(self): """ In pypa/setuptools#4033, it was shown that once PKG-INFO is re-generated using ``email.generator.Generator``, some control characters might cause problems. """ # Given a PKG-INFO file ... attrs = { "name": "package", "version": "1.0", "long_description": "hello\x0b\nworld\n", } dist = Distribution(attrs) metadata = dist.metadata with io.StringIO() as buffer: metadata.write_pkg_file(buffer) msg = buffer.getvalue() # ... when it is read and re-written using stdlib's email library, orig = email.message_from_string(msg) policy = email.policy.EmailPolicy( utf8=True, mangle_from_=False, max_line_length=0, ) with io.StringIO() as buffer: email.generator.Generator(buffer, policy=policy).flatten(orig) buffer.seek(0) regen = email.message_from_file(buffer) # ... then it should be the same as the original # (except for the specific line break characters) orig_desc = set(orig["Description"].splitlines()) regen_desc = set(regen["Description"].splitlines()) assert regen_desc == orig_desc _distutils/tests/test_sysconfig.py 0000644 00000027322 15030122015 0013501 0 ustar 00 """Tests for distutils.sysconfig.""" import contextlib import distutils import os import pathlib import subprocess import sys from distutils import sysconfig from distutils.ccompiler import new_compiler # noqa: F401 from distutils.unixccompiler import UnixCCompiler import jaraco.envs import path import pytest from jaraco.text import trim from test.support import swap_item def _gen_makefile(root, contents): jaraco.path.build({'Makefile': trim(contents)}, root) return root / 'Makefile' @pytest.mark.usefixtures('save_env') class TestSysconfig: def test_get_config_h_filename(self): config_h = sysconfig.get_config_h_filename() assert os.path.isfile(config_h) @pytest.mark.skipif("platform.system() == 'Windows'") @pytest.mark.skipif("sys.implementation.name != 'cpython'") def test_get_makefile_filename(self): makefile = sysconfig.get_makefile_filename() assert os.path.isfile(makefile) def test_get_python_lib(self, tmp_path): assert sysconfig.get_python_lib() != sysconfig.get_python_lib(prefix=tmp_path) def test_get_config_vars(self): cvars = sysconfig.get_config_vars() assert isinstance(cvars, dict) assert cvars @pytest.mark.skipif('sysconfig.IS_PYPY') @pytest.mark.skipif('sysconfig.python_build') @pytest.mark.xfail('platform.system() == "Windows"') def test_srcdir_simple(self): # See #15364. srcdir = pathlib.Path(sysconfig.get_config_var('srcdir')) assert srcdir.absolute() assert srcdir.is_dir() makefile = pathlib.Path(sysconfig.get_makefile_filename()) assert makefile.parent.samefile(srcdir) @pytest.mark.skipif('sysconfig.IS_PYPY') @pytest.mark.skipif('not sysconfig.python_build') def test_srcdir_python_build(self): # See #15364. srcdir = pathlib.Path(sysconfig.get_config_var('srcdir')) # The python executable has not been installed so srcdir # should be a full source checkout. Python_h = srcdir.joinpath('Include', 'Python.h') assert Python_h.is_file() assert sysconfig._is_python_source_dir(srcdir) assert sysconfig._is_python_source_dir(str(srcdir)) def test_srcdir_independent_of_cwd(self): """ srcdir should be independent of the current working directory """ # See #15364. srcdir = sysconfig.get_config_var('srcdir') with path.Path('..'): srcdir2 = sysconfig.get_config_var('srcdir') assert srcdir == srcdir2 def customize_compiler(self): # make sure AR gets caught class compiler: compiler_type = 'unix' executables = UnixCCompiler.executables def __init__(self): self.exes = {} def set_executables(self, **kw): for k, v in kw.items(): self.exes[k] = v sysconfig_vars = { 'AR': 'sc_ar', 'CC': 'sc_cc', 'CXX': 'sc_cxx', 'ARFLAGS': '--sc-arflags', 'CFLAGS': '--sc-cflags', 'CCSHARED': '--sc-ccshared', 'LDSHARED': 'sc_ldshared', 'SHLIB_SUFFIX': 'sc_shutil_suffix', } comp = compiler() with contextlib.ExitStack() as cm: for key, value in sysconfig_vars.items(): cm.enter_context(swap_item(sysconfig._config_vars, key, value)) sysconfig.customize_compiler(comp) return comp @pytest.mark.skipif("not isinstance(new_compiler(), UnixCCompiler)") @pytest.mark.usefixtures('disable_macos_customization') def test_customize_compiler(self): # Make sure that sysconfig._config_vars is initialized sysconfig.get_config_vars() os.environ['AR'] = 'env_ar' os.environ['CC'] = 'env_cc' os.environ['CPP'] = 'env_cpp' os.environ['CXX'] = 'env_cxx --env-cxx-flags' os.environ['LDSHARED'] = 'env_ldshared' os.environ['LDFLAGS'] = '--env-ldflags' os.environ['ARFLAGS'] = '--env-arflags' os.environ['CFLAGS'] = '--env-cflags' os.environ['CPPFLAGS'] = '--env-cppflags' os.environ['RANLIB'] = 'env_ranlib' comp = self.customize_compiler() assert comp.exes['archiver'] == 'env_ar --env-arflags' assert comp.exes['preprocessor'] == 'env_cpp --env-cppflags' assert comp.exes['compiler'] == 'env_cc --env-cflags --env-cppflags' assert comp.exes['compiler_so'] == ( 'env_cc --env-cflags --env-cppflags --sc-ccshared' ) assert ( comp.exes['compiler_cxx'] == 'env_cxx --env-cxx-flags --sc-cflags --env-cppflags' ) assert comp.exes['linker_exe'] == 'env_cc' assert comp.exes['linker_so'] == ( 'env_ldshared --env-ldflags --env-cflags --env-cppflags' ) assert comp.shared_lib_extension == 'sc_shutil_suffix' if sys.platform == "darwin": assert comp.exes['ranlib'] == 'env_ranlib' else: assert 'ranlib' not in comp.exes del os.environ['AR'] del os.environ['CC'] del os.environ['CPP'] del os.environ['CXX'] del os.environ['LDSHARED'] del os.environ['LDFLAGS'] del os.environ['ARFLAGS'] del os.environ['CFLAGS'] del os.environ['CPPFLAGS'] del os.environ['RANLIB'] comp = self.customize_compiler() assert comp.exes['archiver'] == 'sc_ar --sc-arflags' assert comp.exes['preprocessor'] == 'sc_cc -E' assert comp.exes['compiler'] == 'sc_cc --sc-cflags' assert comp.exes['compiler_so'] == 'sc_cc --sc-cflags --sc-ccshared' assert comp.exes['compiler_cxx'] == 'sc_cxx --sc-cflags' assert comp.exes['linker_exe'] == 'sc_cc' assert comp.exes['linker_so'] == 'sc_ldshared' assert comp.shared_lib_extension == 'sc_shutil_suffix' assert 'ranlib' not in comp.exes def test_parse_makefile_base(self, tmp_path): makefile = _gen_makefile( tmp_path, """ CONFIG_ARGS= '--arg1=optarg1' 'ENV=LIB' VAR=$OTHER OTHER=foo """, ) d = sysconfig.parse_makefile(makefile) assert d == {'CONFIG_ARGS': "'--arg1=optarg1' 'ENV=LIB'", 'OTHER': 'foo'} def test_parse_makefile_literal_dollar(self, tmp_path): makefile = _gen_makefile( tmp_path, """ CONFIG_ARGS= '--arg1=optarg1' 'ENV=\\$$LIB' VAR=$OTHER OTHER=foo """, ) d = sysconfig.parse_makefile(makefile) assert d == {'CONFIG_ARGS': r"'--arg1=optarg1' 'ENV=\$LIB'", 'OTHER': 'foo'} def test_sysconfig_module(self): import sysconfig as global_sysconfig assert global_sysconfig.get_config_var('CFLAGS') == sysconfig.get_config_var( 'CFLAGS' ) assert global_sysconfig.get_config_var('LDFLAGS') == sysconfig.get_config_var( 'LDFLAGS' ) # On macOS, binary installers support extension module building on # various levels of the operating system with differing Xcode # configurations, requiring customization of some of the # compiler configuration directives to suit the environment on # the installed machine. Some of these customizations may require # running external programs and are thus deferred until needed by # the first extension module build. Only # the Distutils version of sysconfig is used for extension module # builds, which happens earlier in the Distutils tests. This may # cause the following tests to fail since no tests have caused # the global version of sysconfig to call the customization yet. # The solution for now is to simply skip this test in this case. # The longer-term solution is to only have one version of sysconfig. @pytest.mark.skipif("sysconfig.get_config_var('CUSTOMIZED_OSX_COMPILER')") def test_sysconfig_compiler_vars(self): import sysconfig as global_sysconfig if sysconfig.get_config_var('CUSTOMIZED_OSX_COMPILER'): pytest.skip('compiler flags customized') assert global_sysconfig.get_config_var('LDSHARED') == sysconfig.get_config_var( 'LDSHARED' ) assert global_sysconfig.get_config_var('CC') == sysconfig.get_config_var('CC') @pytest.mark.skipif("not sysconfig.get_config_var('EXT_SUFFIX')") def test_SO_deprecation(self): with pytest.warns(DeprecationWarning): sysconfig.get_config_var('SO') def test_customize_compiler_before_get_config_vars(self, tmp_path): # Issue #21923: test that a Distribution compiler # instance can be called without an explicit call to # get_config_vars(). jaraco.path.build( { 'file': trim(""" from distutils.core import Distribution config = Distribution().get_command_obj('config') # try_compile may pass or it may fail if no compiler # is found but it should not raise an exception. rc = config.try_compile('int x;') """) }, tmp_path, ) p = subprocess.Popen( [sys.executable, tmp_path / 'file'], stdout=subprocess.PIPE, stderr=subprocess.STDOUT, universal_newlines=True, encoding='utf-8', ) outs, errs = p.communicate() assert 0 == p.returncode, "Subprocess failed: " + outs def test_parse_config_h(self): config_h = sysconfig.get_config_h_filename() input = {} with open(config_h, encoding="utf-8") as f: result = sysconfig.parse_config_h(f, g=input) assert input is result with open(config_h, encoding="utf-8") as f: result = sysconfig.parse_config_h(f) assert isinstance(result, dict) @pytest.mark.skipif("platform.system() != 'Windows'") @pytest.mark.skipif("sys.implementation.name != 'cpython'") def test_win_ext_suffix(self): assert sysconfig.get_config_var("EXT_SUFFIX").endswith(".pyd") assert sysconfig.get_config_var("EXT_SUFFIX") != ".pyd" @pytest.mark.skipif("platform.system() != 'Windows'") @pytest.mark.skipif("sys.implementation.name != 'cpython'") @pytest.mark.skipif( '\\PCbuild\\'.casefold() not in sys.executable.casefold(), reason='Need sys.executable to be in a source tree', ) def test_win_build_venv_from_source_tree(self, tmp_path): """Ensure distutils.sysconfig detects venvs from source tree builds.""" env = jaraco.envs.VEnv() env.create_opts = env.clean_opts env.root = tmp_path env.ensure_env() cmd = [ env.exe(), "-c", "import distutils.sysconfig; print(distutils.sysconfig.python_build)", ] distutils_path = os.path.dirname(os.path.dirname(distutils.__file__)) out = subprocess.check_output( cmd, env={**os.environ, "PYTHONPATH": distutils_path} ) assert out == "True" def test_get_python_inc_missing_config_dir(self, monkeypatch): """ In portable Python installations, the sysconfig will be broken, pointing to the directories where the installation was built and not where it currently is. In this case, ensure that the missing directory isn't used for get_python_inc. See pypa/distutils#178. """ def override(name): if name == 'INCLUDEPY': return '/does-not-exist' return sysconfig.get_config_var(name) monkeypatch.setattr(sysconfig, 'get_config_var', override) assert os.path.exists(sysconfig.get_python_inc()) _distutils/tests/test_archive_util.py 0000644 00000027013 15030122015 0014150 0 ustar 00 """Tests for distutils.archive_util.""" import functools import operator import os import pathlib import sys import tarfile from distutils import archive_util from distutils.archive_util import ( ARCHIVE_FORMATS, check_archive_formats, make_archive, make_tarball, make_zipfile, ) from distutils.spawn import spawn from distutils.tests import support from os.path import splitdrive import path import pytest from test.support import patch from .unix_compat import UID_0_SUPPORT, grp, pwd, require_uid_0, require_unix_id def can_fs_encode(filename): """ Return True if the filename can be saved in the file system. """ if os.path.supports_unicode_filenames: return True try: filename.encode(sys.getfilesystemencoding()) except UnicodeEncodeError: return False return True def all_equal(values): return functools.reduce(operator.eq, values) def same_drive(*paths): return all_equal(pathlib.Path(path).drive for path in paths) class ArchiveUtilTestCase(support.TempdirManager): @pytest.mark.usefixtures('needs_zlib') def test_make_tarball(self, name='archive'): # creating something to tar tmpdir = self._create_files() self._make_tarball(tmpdir, name, '.tar.gz') # trying an uncompressed one self._make_tarball(tmpdir, name, '.tar', compress=None) @pytest.mark.usefixtures('needs_zlib') def test_make_tarball_gzip(self): tmpdir = self._create_files() self._make_tarball(tmpdir, 'archive', '.tar.gz', compress='gzip') def test_make_tarball_bzip2(self): pytest.importorskip('bz2') tmpdir = self._create_files() self._make_tarball(tmpdir, 'archive', '.tar.bz2', compress='bzip2') def test_make_tarball_xz(self): pytest.importorskip('lzma') tmpdir = self._create_files() self._make_tarball(tmpdir, 'archive', '.tar.xz', compress='xz') @pytest.mark.skipif("not can_fs_encode('årchiv')") def test_make_tarball_latin1(self): """ Mirror test_make_tarball, except filename contains latin characters. """ self.test_make_tarball('årchiv') # note this isn't a real word @pytest.mark.skipif("not can_fs_encode('のアーカイブ')") def test_make_tarball_extended(self): """ Mirror test_make_tarball, except filename contains extended characters outside the latin charset. """ self.test_make_tarball('のアーカイブ') # japanese for archive def _make_tarball(self, tmpdir, target_name, suffix, **kwargs): tmpdir2 = self.mkdtemp() if same_drive(tmpdir, tmpdir2): pytest.skip("source and target should be on same drive") base_name = os.path.join(tmpdir2, target_name) # working with relative paths to avoid tar warnings with path.Path(tmpdir): make_tarball(splitdrive(base_name)[1], 'dist', **kwargs) # check if the compressed tarball was created tarball = base_name + suffix assert os.path.exists(tarball) assert self._tarinfo(tarball) == self._created_files def _tarinfo(self, path): tar = tarfile.open(path) try: names = tar.getnames() names.sort() return names finally: tar.close() _zip_created_files = [ 'dist/', 'dist/file1', 'dist/file2', 'dist/sub/', 'dist/sub/file3', 'dist/sub2/', ] _created_files = [p.rstrip('/') for p in _zip_created_files] def _create_files(self): # creating something to tar tmpdir = self.mkdtemp() dist = os.path.join(tmpdir, 'dist') os.mkdir(dist) self.write_file([dist, 'file1'], 'xxx') self.write_file([dist, 'file2'], 'xxx') os.mkdir(os.path.join(dist, 'sub')) self.write_file([dist, 'sub', 'file3'], 'xxx') os.mkdir(os.path.join(dist, 'sub2')) return tmpdir @pytest.mark.usefixtures('needs_zlib') @pytest.mark.skipif("not (shutil.which('tar') and shutil.which('gzip'))") def test_tarfile_vs_tar(self): tmpdir = self._create_files() tmpdir2 = self.mkdtemp() base_name = os.path.join(tmpdir2, 'archive') old_dir = os.getcwd() os.chdir(tmpdir) try: make_tarball(base_name, 'dist') finally: os.chdir(old_dir) # check if the compressed tarball was created tarball = base_name + '.tar.gz' assert os.path.exists(tarball) # now create another tarball using `tar` tarball2 = os.path.join(tmpdir, 'archive2.tar.gz') tar_cmd = ['tar', '-cf', 'archive2.tar', 'dist'] gzip_cmd = ['gzip', '-f', '-9', 'archive2.tar'] old_dir = os.getcwd() os.chdir(tmpdir) try: spawn(tar_cmd) spawn(gzip_cmd) finally: os.chdir(old_dir) assert os.path.exists(tarball2) # let's compare both tarballs assert self._tarinfo(tarball) == self._created_files assert self._tarinfo(tarball2) == self._created_files # trying an uncompressed one base_name = os.path.join(tmpdir2, 'archive') old_dir = os.getcwd() os.chdir(tmpdir) try: make_tarball(base_name, 'dist', compress=None) finally: os.chdir(old_dir) tarball = base_name + '.tar' assert os.path.exists(tarball) # now for a dry_run base_name = os.path.join(tmpdir2, 'archive') old_dir = os.getcwd() os.chdir(tmpdir) try: make_tarball(base_name, 'dist', compress=None, dry_run=True) finally: os.chdir(old_dir) tarball = base_name + '.tar' assert os.path.exists(tarball) @pytest.mark.usefixtures('needs_zlib') def test_make_zipfile(self): zipfile = pytest.importorskip('zipfile') # creating something to tar tmpdir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') with path.Path(tmpdir): make_zipfile(base_name, 'dist') # check if the compressed tarball was created tarball = base_name + '.zip' assert os.path.exists(tarball) with zipfile.ZipFile(tarball) as zf: assert sorted(zf.namelist()) == self._zip_created_files def test_make_zipfile_no_zlib(self): zipfile = pytest.importorskip('zipfile') patch(self, archive_util.zipfile, 'zlib', None) # force zlib ImportError called = [] zipfile_class = zipfile.ZipFile def fake_zipfile(*a, **kw): if kw.get('compression', None) == zipfile.ZIP_STORED: called.append((a, kw)) return zipfile_class(*a, **kw) patch(self, archive_util.zipfile, 'ZipFile', fake_zipfile) # create something to tar and compress tmpdir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') with path.Path(tmpdir): make_zipfile(base_name, 'dist') tarball = base_name + '.zip' assert called == [((tarball, "w"), {'compression': zipfile.ZIP_STORED})] assert os.path.exists(tarball) with zipfile.ZipFile(tarball) as zf: assert sorted(zf.namelist()) == self._zip_created_files def test_check_archive_formats(self): assert check_archive_formats(['gztar', 'xxx', 'zip']) == 'xxx' assert ( check_archive_formats(['gztar', 'bztar', 'xztar', 'ztar', 'tar', 'zip']) is None ) def test_make_archive(self): tmpdir = self.mkdtemp() base_name = os.path.join(tmpdir, 'archive') with pytest.raises(ValueError): make_archive(base_name, 'xxx') def test_make_archive_cwd(self): current_dir = os.getcwd() def _breaks(*args, **kw): raise RuntimeError() ARCHIVE_FORMATS['xxx'] = (_breaks, [], 'xxx file') try: try: make_archive('xxx', 'xxx', root_dir=self.mkdtemp()) except Exception: pass assert os.getcwd() == current_dir finally: ARCHIVE_FORMATS.pop('xxx') def test_make_archive_tar(self): base_dir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') res = make_archive(base_name, 'tar', base_dir, 'dist') assert os.path.exists(res) assert os.path.basename(res) == 'archive.tar' assert self._tarinfo(res) == self._created_files @pytest.mark.usefixtures('needs_zlib') def test_make_archive_gztar(self): base_dir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') res = make_archive(base_name, 'gztar', base_dir, 'dist') assert os.path.exists(res) assert os.path.basename(res) == 'archive.tar.gz' assert self._tarinfo(res) == self._created_files def test_make_archive_bztar(self): pytest.importorskip('bz2') base_dir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') res = make_archive(base_name, 'bztar', base_dir, 'dist') assert os.path.exists(res) assert os.path.basename(res) == 'archive.tar.bz2' assert self._tarinfo(res) == self._created_files def test_make_archive_xztar(self): pytest.importorskip('lzma') base_dir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') res = make_archive(base_name, 'xztar', base_dir, 'dist') assert os.path.exists(res) assert os.path.basename(res) == 'archive.tar.xz' assert self._tarinfo(res) == self._created_files def test_make_archive_owner_group(self): # testing make_archive with owner and group, with various combinations # this works even if there's not gid/uid support if UID_0_SUPPORT: group = grp.getgrgid(0)[0] owner = pwd.getpwuid(0)[0] else: group = owner = 'root' base_dir = self._create_files() root_dir = self.mkdtemp() base_name = os.path.join(self.mkdtemp(), 'archive') res = make_archive( base_name, 'zip', root_dir, base_dir, owner=owner, group=group ) assert os.path.exists(res) res = make_archive(base_name, 'zip', root_dir, base_dir) assert os.path.exists(res) res = make_archive( base_name, 'tar', root_dir, base_dir, owner=owner, group=group ) assert os.path.exists(res) res = make_archive( base_name, 'tar', root_dir, base_dir, owner='kjhkjhkjg', group='oihohoh' ) assert os.path.exists(res) @pytest.mark.usefixtures('needs_zlib') @require_unix_id @require_uid_0 def test_tarfile_root_owner(self): tmpdir = self._create_files() base_name = os.path.join(self.mkdtemp(), 'archive') old_dir = os.getcwd() os.chdir(tmpdir) group = grp.getgrgid(0)[0] owner = pwd.getpwuid(0)[0] try: archive_name = make_tarball( base_name, 'dist', compress=None, owner=owner, group=group ) finally: os.chdir(old_dir) # check if the compressed tarball was created assert os.path.exists(archive_name) # now checks the rights archive = tarfile.open(archive_name) try: for member in archive.getmembers(): assert member.uid == 0 assert member.gid == 0 finally: archive.close() _distutils/tests/test_clean.py 0000644 00000002330 15030122015 0012547 0 ustar 00 """Tests for distutils.command.clean.""" import os from distutils.command.clean import clean from distutils.tests import support class TestClean(support.TempdirManager): def test_simple_run(self): pkg_dir, dist = self.create_dist() cmd = clean(dist) # let's add some elements clean should remove dirs = [ (d, os.path.join(pkg_dir, d)) for d in ( 'build_temp', 'build_lib', 'bdist_base', 'build_scripts', 'build_base', ) ] for name, path in dirs: os.mkdir(path) setattr(cmd, name, path) if name == 'build_base': continue for f in ('one', 'two', 'three'): self.write_file(os.path.join(path, f)) # let's run the command cmd.all = 1 cmd.ensure_finalized() cmd.run() # make sure the files where removed for _name, path in dirs: assert not os.path.exists(path), f'{path} was not removed' # let's run the command again (should spit warnings but succeed) cmd.all = 1 cmd.ensure_finalized() cmd.run() _distutils/tests/unix_compat.py 0000644 00000000602 15030122015 0012754 0 ustar 00 import sys try: import grp import pwd except ImportError: grp = pwd = None import pytest UNIX_ID_SUPPORT = grp and pwd UID_0_SUPPORT = UNIX_ID_SUPPORT and sys.platform != "cygwin" require_unix_id = pytest.mark.skipif( not UNIX_ID_SUPPORT, reason="Requires grp and pwd support" ) require_uid_0 = pytest.mark.skipif(not UID_0_SUPPORT, reason="Requires UID 0 support") _distutils/tests/test_install_lib.py 0000644 00000007034 15030122015 0013767 0 ustar 00 """Tests for distutils.command.install_data.""" import importlib.util import os import sys from distutils.command.install_lib import install_lib from distutils.errors import DistutilsOptionError from distutils.extension import Extension from distutils.tests import support import pytest @support.combine_markers @pytest.mark.usefixtures('save_env') class TestInstallLib( support.TempdirManager, ): def test_finalize_options(self): dist = self.create_dist()[1] cmd = install_lib(dist) cmd.finalize_options() assert cmd.compile == 1 assert cmd.optimize == 0 # optimize must be 0, 1, or 2 cmd.optimize = 'foo' with pytest.raises(DistutilsOptionError): cmd.finalize_options() cmd.optimize = '4' with pytest.raises(DistutilsOptionError): cmd.finalize_options() cmd.optimize = '2' cmd.finalize_options() assert cmd.optimize == 2 @pytest.mark.skipif('sys.dont_write_bytecode') def test_byte_compile(self): project_dir, dist = self.create_dist() os.chdir(project_dir) cmd = install_lib(dist) cmd.compile = cmd.optimize = 1 f = os.path.join(project_dir, 'foo.py') self.write_file(f, '# python file') cmd.byte_compile([f]) pyc_file = importlib.util.cache_from_source('foo.py', optimization='') pyc_opt_file = importlib.util.cache_from_source( 'foo.py', optimization=cmd.optimize ) assert os.path.exists(pyc_file) assert os.path.exists(pyc_opt_file) def test_get_outputs(self): project_dir, dist = self.create_dist() os.chdir(project_dir) os.mkdir('spam') cmd = install_lib(dist) # setting up a dist environment cmd.compile = cmd.optimize = 1 cmd.install_dir = self.mkdtemp() f = os.path.join(project_dir, 'spam', '__init__.py') self.write_file(f, '# python package') cmd.distribution.ext_modules = [Extension('foo', ['xxx'])] cmd.distribution.packages = ['spam'] cmd.distribution.script_name = 'setup.py' # get_outputs should return 4 elements: spam/__init__.py and .pyc, # foo.import-tag-abiflags.so / foo.pyd outputs = cmd.get_outputs() assert len(outputs) == 4, outputs def test_get_inputs(self): project_dir, dist = self.create_dist() os.chdir(project_dir) os.mkdir('spam') cmd = install_lib(dist) # setting up a dist environment cmd.compile = cmd.optimize = 1 cmd.install_dir = self.mkdtemp() f = os.path.join(project_dir, 'spam', '__init__.py') self.write_file(f, '# python package') cmd.distribution.ext_modules = [Extension('foo', ['xxx'])] cmd.distribution.packages = ['spam'] cmd.distribution.script_name = 'setup.py' # get_inputs should return 2 elements: spam/__init__.py and # foo.import-tag-abiflags.so / foo.pyd inputs = cmd.get_inputs() assert len(inputs) == 2, inputs def test_dont_write_bytecode(self, caplog): # makes sure byte_compile is not used dist = self.create_dist()[1] cmd = install_lib(dist) cmd.compile = True cmd.optimize = 1 old_dont_write_bytecode = sys.dont_write_bytecode sys.dont_write_bytecode = True try: cmd.byte_compile([]) finally: sys.dont_write_bytecode = old_dont_write_bytecode assert 'byte-compiling is disabled' in caplog.messages[0] _distutils/tests/test_log.py 0000644 00000000503 15030122015 0012246 0 ustar 00 """Tests for distutils.log""" import logging from distutils._log import log class TestLog: def test_non_ascii(self, caplog): caplog.set_level(logging.DEBUG) log.debug('Dεbug\tMėssãge') log.fatal('Fαtal\tÈrrōr') assert caplog.messages == ['Dεbug\tMėssãge', 'Fαtal\tÈrrōr'] _distutils/tests/test_install_headers.py 0000644 00000001650 15030122015 0014632 0 ustar 00 """Tests for distutils.command.install_headers.""" import os from distutils.command.install_headers import install_headers from distutils.tests import support import pytest @pytest.mark.usefixtures('save_env') class TestInstallHeaders( support.TempdirManager, ): def test_simple_run(self): # we have two headers header_list = self.mkdtemp() header1 = os.path.join(header_list, 'header1') header2 = os.path.join(header_list, 'header2') self.write_file(header1) self.write_file(header2) headers = [header1, header2] pkg_dir, dist = self.create_dist(headers=headers) cmd = install_headers(dist) assert cmd.get_inputs() == headers # let's run the command cmd.install_dir = os.path.join(pkg_dir, 'inst') cmd.ensure_finalized() cmd.run() # let's check the results assert len(cmd.get_outputs()) == 2 _distutils/tests/__init__.py 0000644 00000002715 15030122015 0012174 0 ustar 00 """ Test suite for distutils. Tests for the command classes in the distutils.command package are included in distutils.tests as well, instead of using a separate distutils.command.tests package, since command identification is done by import rather than matching pre-defined names. """ import shutil from collections.abc import Sequence def missing_compiler_executable(cmd_names: Sequence[str] = []): # pragma: no cover """Check if the compiler components used to build the interpreter exist. Check for the existence of the compiler executables whose names are listed in 'cmd_names' or all the compiler executables when 'cmd_names' is empty and return the first missing executable or None when none is found missing. """ from distutils import ccompiler, errors, sysconfig compiler = ccompiler.new_compiler() sysconfig.customize_compiler(compiler) if compiler.compiler_type == "msvc": # MSVC has no executables, so check whether initialization succeeds try: compiler.initialize() except errors.DistutilsPlatformError: return "msvc" for name in compiler.executables: if cmd_names and name not in cmd_names: continue cmd = getattr(compiler, name) if cmd_names: assert cmd is not None, f"the '{name}' executable is not configured" elif not cmd: continue if shutil.which(cmd[0]) is None: return cmd[0] _distutils/command/install_lib.py 0000644 00000020614 15030122015 0013203 0 ustar 00 """distutils.command.install_lib Implements the Distutils 'install_lib' command (install all Python modules).""" from __future__ import annotations import importlib.util import os import sys from typing import Any, ClassVar from ..core import Command from ..errors import DistutilsOptionError # Extension for Python source files. PYTHON_SOURCE_EXTENSION = ".py" class install_lib(Command): description = "install all Python modules (extensions and pure Python)" # The byte-compilation options are a tad confusing. Here are the # possible scenarios: # 1) no compilation at all (--no-compile --no-optimize) # 2) compile .pyc only (--compile --no-optimize; default) # 3) compile .pyc and "opt-1" .pyc (--compile --optimize) # 4) compile "opt-1" .pyc only (--no-compile --optimize) # 5) compile .pyc and "opt-2" .pyc (--compile --optimize-more) # 6) compile "opt-2" .pyc only (--no-compile --optimize-more) # # The UI for this is two options, 'compile' and 'optimize'. # 'compile' is strictly boolean, and only decides whether to # generate .pyc files. 'optimize' is three-way (0, 1, or 2), and # decides both whether to generate .pyc files and what level of # optimization to use. user_options = [ ('install-dir=', 'd', "directory to install to"), ('build-dir=', 'b', "build directory (where to install from)"), ('force', 'f', "force installation (overwrite existing files)"), ('compile', 'c', "compile .py to .pyc [default]"), ('no-compile', None, "don't compile .py files"), ( 'optimize=', 'O', "also compile with optimization: -O1 for \"python -O\", " "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", ), ('skip-build', None, "skip the build steps"), ] boolean_options: ClassVar[list[str]] = ['force', 'compile', 'skip-build'] negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} def initialize_options(self): # let the 'install' command dictate our installation directory self.install_dir = None self.build_dir = None self.force = False self.compile = None self.optimize = None self.skip_build = None def finalize_options(self) -> None: # Get all the information we need to install pure Python modules # from the umbrella 'install' command -- build (source) directory, # install (target) directory, and whether to compile .py files. self.set_undefined_options( 'install', ('build_lib', 'build_dir'), ('install_lib', 'install_dir'), ('force', 'force'), ('compile', 'compile'), ('optimize', 'optimize'), ('skip_build', 'skip_build'), ) if self.compile is None: self.compile = True if self.optimize is None: self.optimize = False if not isinstance(self.optimize, int): try: self.optimize = int(self.optimize) except ValueError: pass if self.optimize not in (0, 1, 2): raise DistutilsOptionError("optimize must be 0, 1, or 2") def run(self) -> None: # Make sure we have built everything we need first self.build() # Install everything: simply dump the entire contents of the build # directory to the installation directory (that's the beauty of # having a build directory!) outfiles = self.install() # (Optionally) compile .py to .pyc if outfiles is not None and self.distribution.has_pure_modules(): self.byte_compile(outfiles) # -- Top-level worker functions ------------------------------------ # (called from 'run()') def build(self) -> None: if not self.skip_build: if self.distribution.has_pure_modules(): self.run_command('build_py') if self.distribution.has_ext_modules(): self.run_command('build_ext') # Any: https://typing.readthedocs.io/en/latest/guides/writing_stubs.html#the-any-trick def install(self) -> list[str] | Any: if os.path.isdir(self.build_dir): outfiles = self.copy_tree(self.build_dir, self.install_dir) else: self.warn( f"'{self.build_dir}' does not exist -- no Python modules to install" ) return return outfiles def byte_compile(self, files) -> None: if sys.dont_write_bytecode: self.warn('byte-compiling is disabled, skipping.') return from ..util import byte_compile # Get the "--root" directory supplied to the "install" command, # and use it as a prefix to strip off the purported filename # encoded in bytecode files. This is far from complete, but it # should at least generate usable bytecode in RPM distributions. install_root = self.get_finalized_command('install').root if self.compile: byte_compile( files, optimize=0, force=self.force, prefix=install_root, dry_run=self.dry_run, ) if self.optimize > 0: byte_compile( files, optimize=self.optimize, force=self.force, prefix=install_root, verbose=self.verbose, dry_run=self.dry_run, ) # -- Utility methods ----------------------------------------------- def _mutate_outputs(self, has_any, build_cmd, cmd_option, output_dir): if not has_any: return [] build_cmd = self.get_finalized_command(build_cmd) build_files = build_cmd.get_outputs() build_dir = getattr(build_cmd, cmd_option) prefix_len = len(build_dir) + len(os.sep) outputs = [os.path.join(output_dir, file[prefix_len:]) for file in build_files] return outputs def _bytecode_filenames(self, py_filenames): bytecode_files = [] for py_file in py_filenames: # Since build_py handles package data installation, the # list of outputs can contain more than just .py files. # Make sure we only report bytecode for the .py files. ext = os.path.splitext(os.path.normcase(py_file))[1] if ext != PYTHON_SOURCE_EXTENSION: continue if self.compile: bytecode_files.append( importlib.util.cache_from_source(py_file, optimization='') ) if self.optimize > 0: bytecode_files.append( importlib.util.cache_from_source( py_file, optimization=self.optimize ) ) return bytecode_files # -- External interface -------------------------------------------- # (called by outsiders) def get_outputs(self): """Return the list of files that would be installed if this command were actually run. Not affected by the "dry-run" flag or whether modules have actually been built yet. """ pure_outputs = self._mutate_outputs( self.distribution.has_pure_modules(), 'build_py', 'build_lib', self.install_dir, ) if self.compile: bytecode_outputs = self._bytecode_filenames(pure_outputs) else: bytecode_outputs = [] ext_outputs = self._mutate_outputs( self.distribution.has_ext_modules(), 'build_ext', 'build_lib', self.install_dir, ) return pure_outputs + bytecode_outputs + ext_outputs def get_inputs(self): """Get the list of files that are input to this command, ie. the files that get installed as they are named in the build tree. The files in this list correspond one-to-one to the output filenames returned by 'get_outputs()'. """ inputs = [] if self.distribution.has_pure_modules(): build_py = self.get_finalized_command('build_py') inputs.extend(build_py.get_outputs()) if self.distribution.has_ext_modules(): build_ext = self.get_finalized_command('build_ext') inputs.extend(build_ext.get_outputs()) return inputs _distutils/command/install.py 0000644 00000072570 15030122015 0012365 0 ustar 00 """distutils.command.install Implements the Distutils 'install' command.""" from __future__ import annotations import collections import contextlib import itertools import os import sys import sysconfig from distutils._log import log from site import USER_BASE, USER_SITE from typing import ClassVar from ..core import Command from ..debug import DEBUG from ..errors import DistutilsOptionError, DistutilsPlatformError from ..file_util import write_file from ..sysconfig import get_config_vars from ..util import change_root, convert_path, get_platform, subst_vars from . import _framework_compat as fw HAS_USER_SITE = True WINDOWS_SCHEME = { 'purelib': '{base}/Lib/site-packages', 'platlib': '{base}/Lib/site-packages', 'headers': '{base}/Include/{dist_name}', 'scripts': '{base}/Scripts', 'data': '{base}', } INSTALL_SCHEMES = { 'posix_prefix': { 'purelib': '{base}/lib/{implementation_lower}{py_version_short}/site-packages', 'platlib': '{platbase}/{platlibdir}/{implementation_lower}' '{py_version_short}/site-packages', 'headers': '{base}/include/{implementation_lower}' '{py_version_short}{abiflags}/{dist_name}', 'scripts': '{base}/bin', 'data': '{base}', }, 'posix_home': { 'purelib': '{base}/lib/{implementation_lower}', 'platlib': '{base}/{platlibdir}/{implementation_lower}', 'headers': '{base}/include/{implementation_lower}/{dist_name}', 'scripts': '{base}/bin', 'data': '{base}', }, 'nt': WINDOWS_SCHEME, 'pypy': { 'purelib': '{base}/site-packages', 'platlib': '{base}/site-packages', 'headers': '{base}/include/{dist_name}', 'scripts': '{base}/bin', 'data': '{base}', }, 'pypy_nt': { 'purelib': '{base}/site-packages', 'platlib': '{base}/site-packages', 'headers': '{base}/include/{dist_name}', 'scripts': '{base}/Scripts', 'data': '{base}', }, } # user site schemes if HAS_USER_SITE: INSTALL_SCHEMES['nt_user'] = { 'purelib': '{usersite}', 'platlib': '{usersite}', 'headers': '{userbase}/{implementation}{py_version_nodot_plat}' '/Include/{dist_name}', 'scripts': '{userbase}/{implementation}{py_version_nodot_plat}/Scripts', 'data': '{userbase}', } INSTALL_SCHEMES['posix_user'] = { 'purelib': '{usersite}', 'platlib': '{usersite}', 'headers': '{userbase}/include/{implementation_lower}' '{py_version_short}{abiflags}/{dist_name}', 'scripts': '{userbase}/bin', 'data': '{userbase}', } INSTALL_SCHEMES.update(fw.schemes) # The keys to an installation scheme; if any new types of files are to be # installed, be sure to add an entry to every installation scheme above, # and to SCHEME_KEYS here. SCHEME_KEYS = ('purelib', 'platlib', 'headers', 'scripts', 'data') def _load_sysconfig_schemes(): with contextlib.suppress(AttributeError): return { scheme: sysconfig.get_paths(scheme, expand=False) for scheme in sysconfig.get_scheme_names() } def _load_schemes(): """ Extend default schemes with schemes from sysconfig. """ sysconfig_schemes = _load_sysconfig_schemes() or {} return { scheme: { **INSTALL_SCHEMES.get(scheme, {}), **sysconfig_schemes.get(scheme, {}), } for scheme in set(itertools.chain(INSTALL_SCHEMES, sysconfig_schemes)) } def _get_implementation(): if hasattr(sys, 'pypy_version_info'): return 'PyPy' else: return 'Python' def _select_scheme(ob, name): scheme = _inject_headers(name, _load_scheme(_resolve_scheme(name))) vars(ob).update(_remove_set(ob, _scheme_attrs(scheme))) def _remove_set(ob, attrs): """ Include only attrs that are None in ob. """ return {key: value for key, value in attrs.items() if getattr(ob, key) is None} def _resolve_scheme(name): os_name, sep, key = name.partition('_') try: resolved = sysconfig.get_preferred_scheme(key) except Exception: resolved = fw.scheme(name) return resolved def _load_scheme(name): return _load_schemes()[name] def _inject_headers(name, scheme): """ Given a scheme name and the resolved scheme, if the scheme does not include headers, resolve the fallback scheme for the name and use headers from it. pypa/distutils#88 """ # Bypass the preferred scheme, which may not # have defined headers. fallback = _load_scheme(name) scheme.setdefault('headers', fallback['headers']) return scheme def _scheme_attrs(scheme): """Resolve install directories by applying the install schemes.""" return {f'install_{key}': scheme[key] for key in SCHEME_KEYS} class install(Command): description = "install everything from build directory" user_options = [ # Select installation scheme and set base director(y|ies) ('prefix=', None, "installation prefix"), ('exec-prefix=', None, "(Unix only) prefix for platform-specific files"), ('home=', None, "(Unix only) home directory to install under"), # Or, just set the base director(y|ies) ( 'install-base=', None, "base installation directory (instead of --prefix or --home)", ), ( 'install-platbase=', None, "base installation directory for platform-specific files (instead of --exec-prefix or --home)", ), ('root=', None, "install everything relative to this alternate root directory"), # Or, explicitly set the installation scheme ( 'install-purelib=', None, "installation directory for pure Python module distributions", ), ( 'install-platlib=', None, "installation directory for non-pure module distributions", ), ( 'install-lib=', None, "installation directory for all module distributions (overrides --install-purelib and --install-platlib)", ), ('install-headers=', None, "installation directory for C/C++ headers"), ('install-scripts=', None, "installation directory for Python scripts"), ('install-data=', None, "installation directory for data files"), # Byte-compilation options -- see install_lib.py for details, as # these are duplicated from there (but only install_lib does # anything with them). ('compile', 'c', "compile .py to .pyc [default]"), ('no-compile', None, "don't compile .py files"), ( 'optimize=', 'O', "also compile with optimization: -O1 for \"python -O\", " "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", ), # Miscellaneous control options ('force', 'f', "force installation (overwrite any existing files)"), ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), # Where to install documentation (eventually!) # ('doc-format=', None, "format of documentation to generate"), # ('install-man=', None, "directory for Unix man pages"), # ('install-html=', None, "directory for HTML documentation"), # ('install-info=', None, "directory for GNU info files"), ('record=', None, "filename in which to record list of installed files"), ] boolean_options: ClassVar[list[str]] = ['compile', 'force', 'skip-build'] if HAS_USER_SITE: user_options.append(( 'user', None, f"install in user site-package '{USER_SITE}'", )) boolean_options.append('user') negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} def initialize_options(self) -> None: """Initializes options.""" # High-level options: these select both an installation base # and scheme. self.prefix: str | None = None self.exec_prefix: str | None = None self.home: str | None = None self.user = False # These select only the installation base; it's up to the user to # specify the installation scheme (currently, that means supplying # the --install-{platlib,purelib,scripts,data} options). self.install_base = None self.install_platbase = None self.root: str | None = None # These options are the actual installation directories; if not # supplied by the user, they are filled in using the installation # scheme implied by prefix/exec-prefix/home and the contents of # that installation scheme. self.install_purelib = None # for pure module distributions self.install_platlib = None # non-pure (dists w/ extensions) self.install_headers = None # for C/C++ headers self.install_lib: str | None = None # set to either purelib or platlib self.install_scripts = None self.install_data = None self.install_userbase = USER_BASE self.install_usersite = USER_SITE self.compile = None self.optimize = None # Deprecated # These two are for putting non-packagized distributions into their # own directory and creating a .pth file if it makes sense. # 'extra_path' comes from the setup file; 'install_path_file' can # be turned off if it makes no sense to install a .pth file. (But # better to install it uselessly than to guess wrong and not # install it when it's necessary and would be used!) Currently, # 'install_path_file' is always true unless some outsider meddles # with it. self.extra_path = None self.install_path_file = True # 'force' forces installation, even if target files are not # out-of-date. 'skip_build' skips running the "build" command, # handy if you know it's not necessary. 'warn_dir' (which is *not* # a user option, it's just there so the bdist_* commands can turn # it off) determines whether we warn about installing to a # directory not in sys.path. self.force = False self.skip_build = False self.warn_dir = True # These are only here as a conduit from the 'build' command to the # 'install_*' commands that do the real work. ('build_base' isn't # actually used anywhere, but it might be useful in future.) They # are not user options, because if the user told the install # command where the build directory is, that wouldn't affect the # build command. self.build_base = None self.build_lib = None # Not defined yet because we don't know anything about # documentation yet. # self.install_man = None # self.install_html = None # self.install_info = None self.record = None # -- Option finalizing methods ------------------------------------- # (This is rather more involved than for most commands, # because this is where the policy for installing third- # party Python modules on various platforms given a wide # array of user input is decided. Yes, it's quite complex!) def finalize_options(self) -> None: # noqa: C901 """Finalizes options.""" # This method (and its helpers, like 'finalize_unix()', # 'finalize_other()', and 'select_scheme()') is where the default # installation directories for modules, extension modules, and # anything else we care to install from a Python module # distribution. Thus, this code makes a pretty important policy # statement about how third-party stuff is added to a Python # installation! Note that the actual work of installation is done # by the relatively simple 'install_*' commands; they just take # their orders from the installation directory options determined # here. # Check for errors/inconsistencies in the options; first, stuff # that's wrong on any platform. if (self.prefix or self.exec_prefix or self.home) and ( self.install_base or self.install_platbase ): raise DistutilsOptionError( "must supply either prefix/exec-prefix/home or install-base/install-platbase -- not both" ) if self.home and (self.prefix or self.exec_prefix): raise DistutilsOptionError( "must supply either home or prefix/exec-prefix -- not both" ) if self.user and ( self.prefix or self.exec_prefix or self.home or self.install_base or self.install_platbase ): raise DistutilsOptionError( "can't combine user with prefix, " "exec_prefix/home, or install_(plat)base" ) # Next, stuff that's wrong (or dubious) only on certain platforms. if os.name != "posix": if self.exec_prefix: self.warn("exec-prefix option ignored on this platform") self.exec_prefix = None # Now the interesting logic -- so interesting that we farm it out # to other methods. The goal of these methods is to set the final # values for the install_{lib,scripts,data,...} options, using as # input a heady brew of prefix, exec_prefix, home, install_base, # install_platbase, user-supplied versions of # install_{purelib,platlib,lib,scripts,data,...}, and the # install schemes. Phew! self.dump_dirs("pre-finalize_{unix,other}") if os.name == 'posix': self.finalize_unix() else: self.finalize_other() self.dump_dirs("post-finalize_{unix,other}()") # Expand configuration variables, tilde, etc. in self.install_base # and self.install_platbase -- that way, we can use $base or # $platbase in the other installation directories and not worry # about needing recursive variable expansion (shudder). py_version = sys.version.split()[0] (prefix, exec_prefix) = get_config_vars('prefix', 'exec_prefix') try: abiflags = sys.abiflags except AttributeError: # sys.abiflags may not be defined on all platforms. abiflags = '' local_vars = { 'dist_name': self.distribution.get_name(), 'dist_version': self.distribution.get_version(), 'dist_fullname': self.distribution.get_fullname(), 'py_version': py_version, 'py_version_short': f'{sys.version_info.major}.{sys.version_info.minor}', 'py_version_nodot': f'{sys.version_info.major}{sys.version_info.minor}', 'sys_prefix': prefix, 'prefix': prefix, 'sys_exec_prefix': exec_prefix, 'exec_prefix': exec_prefix, 'abiflags': abiflags, 'platlibdir': getattr(sys, 'platlibdir', 'lib'), 'implementation_lower': _get_implementation().lower(), 'implementation': _get_implementation(), } # vars for compatibility on older Pythons compat_vars = dict( # Python 3.9 and earlier py_version_nodot_plat=getattr(sys, 'winver', '').replace('.', ''), ) if HAS_USER_SITE: local_vars['userbase'] = self.install_userbase local_vars['usersite'] = self.install_usersite self.config_vars = collections.ChainMap( local_vars, sysconfig.get_config_vars(), compat_vars, fw.vars(), ) self.expand_basedirs() self.dump_dirs("post-expand_basedirs()") # Now define config vars for the base directories so we can expand # everything else. local_vars['base'] = self.install_base local_vars['platbase'] = self.install_platbase if DEBUG: from pprint import pprint print("config vars:") pprint(dict(self.config_vars)) # Expand "~" and configuration variables in the installation # directories. self.expand_dirs() self.dump_dirs("post-expand_dirs()") # Create directories in the home dir: if self.user: self.create_home_path() # Pick the actual directory to install all modules to: either # install_purelib or install_platlib, depending on whether this # module distribution is pure or not. Of course, if the user # already specified install_lib, use their selection. if self.install_lib is None: if self.distribution.has_ext_modules(): # has extensions: non-pure self.install_lib = self.install_platlib else: self.install_lib = self.install_purelib # Convert directories from Unix /-separated syntax to the local # convention. self.convert_paths( 'lib', 'purelib', 'platlib', 'scripts', 'data', 'headers', 'userbase', 'usersite', ) # Deprecated # Well, we're not actually fully completely finalized yet: we still # have to deal with 'extra_path', which is the hack for allowing # non-packagized module distributions (hello, Numerical Python!) to # get their own directories. self.handle_extra_path() self.install_libbase = self.install_lib # needed for .pth file self.install_lib = os.path.join(self.install_lib, self.extra_dirs) # If a new root directory was supplied, make all the installation # dirs relative to it. if self.root is not None: self.change_roots( 'libbase', 'lib', 'purelib', 'platlib', 'scripts', 'data', 'headers' ) self.dump_dirs("after prepending root") # Find out the build directories, ie. where to install from. self.set_undefined_options( 'build', ('build_base', 'build_base'), ('build_lib', 'build_lib') ) # Punt on doc directories for now -- after all, we're punting on # documentation completely! def dump_dirs(self, msg) -> None: """Dumps the list of user options.""" if not DEBUG: return from ..fancy_getopt import longopt_xlate log.debug(msg + ":") for opt in self.user_options: opt_name = opt[0] if opt_name[-1] == "=": opt_name = opt_name[0:-1] if opt_name in self.negative_opt: opt_name = self.negative_opt[opt_name] opt_name = opt_name.translate(longopt_xlate) val = not getattr(self, opt_name) else: opt_name = opt_name.translate(longopt_xlate) val = getattr(self, opt_name) log.debug(" %s: %s", opt_name, val) def finalize_unix(self) -> None: """Finalizes options for posix platforms.""" if self.install_base is not None or self.install_platbase is not None: incomplete_scheme = ( ( self.install_lib is None and self.install_purelib is None and self.install_platlib is None ) or self.install_headers is None or self.install_scripts is None or self.install_data is None ) if incomplete_scheme: raise DistutilsOptionError( "install-base or install-platbase supplied, but " "installation scheme is incomplete" ) return if self.user: if self.install_userbase is None: raise DistutilsPlatformError("User base directory is not specified") self.install_base = self.install_platbase = self.install_userbase self.select_scheme("posix_user") elif self.home is not None: self.install_base = self.install_platbase = self.home self.select_scheme("posix_home") else: if self.prefix is None: if self.exec_prefix is not None: raise DistutilsOptionError( "must not supply exec-prefix without prefix" ) # Allow Fedora to add components to the prefix _prefix_addition = getattr(sysconfig, '_prefix_addition', "") self.prefix = os.path.normpath(sys.prefix) + _prefix_addition self.exec_prefix = os.path.normpath(sys.exec_prefix) + _prefix_addition else: if self.exec_prefix is None: self.exec_prefix = self.prefix self.install_base = self.prefix self.install_platbase = self.exec_prefix self.select_scheme("posix_prefix") def finalize_other(self) -> None: """Finalizes options for non-posix platforms""" if self.user: if self.install_userbase is None: raise DistutilsPlatformError("User base directory is not specified") self.install_base = self.install_platbase = self.install_userbase self.select_scheme(os.name + "_user") elif self.home is not None: self.install_base = self.install_platbase = self.home self.select_scheme("posix_home") else: if self.prefix is None: self.prefix = os.path.normpath(sys.prefix) self.install_base = self.install_platbase = self.prefix try: self.select_scheme(os.name) except KeyError: raise DistutilsPlatformError( f"I don't know how to install stuff on '{os.name}'" ) def select_scheme(self, name) -> None: _select_scheme(self, name) def _expand_attrs(self, attrs): for attr in attrs: val = getattr(self, attr) if val is not None: if os.name in ('posix', 'nt'): val = os.path.expanduser(val) val = subst_vars(val, self.config_vars) setattr(self, attr, val) def expand_basedirs(self) -> None: """Calls `os.path.expanduser` on install_base, install_platbase and root.""" self._expand_attrs(['install_base', 'install_platbase', 'root']) def expand_dirs(self) -> None: """Calls `os.path.expanduser` on install dirs.""" self._expand_attrs([ 'install_purelib', 'install_platlib', 'install_lib', 'install_headers', 'install_scripts', 'install_data', ]) def convert_paths(self, *names) -> None: """Call `convert_path` over `names`.""" for name in names: attr = "install_" + name setattr(self, attr, convert_path(getattr(self, attr))) def handle_extra_path(self) -> None: """Set `path_file` and `extra_dirs` using `extra_path`.""" if self.extra_path is None: self.extra_path = self.distribution.extra_path if self.extra_path is not None: log.warning( "Distribution option extra_path is deprecated. " "See issue27919 for details." ) if isinstance(self.extra_path, str): self.extra_path = self.extra_path.split(',') if len(self.extra_path) == 1: path_file = extra_dirs = self.extra_path[0] elif len(self.extra_path) == 2: path_file, extra_dirs = self.extra_path else: raise DistutilsOptionError( "'extra_path' option must be a list, tuple, or " "comma-separated string with 1 or 2 elements" ) # convert to local form in case Unix notation used (as it # should be in setup scripts) extra_dirs = convert_path(extra_dirs) else: path_file = None extra_dirs = '' # XXX should we warn if path_file and not extra_dirs? (in which # case the path file would be harmless but pointless) self.path_file = path_file self.extra_dirs = extra_dirs def change_roots(self, *names) -> None: """Change the install directories pointed by name using root.""" for name in names: attr = "install_" + name setattr(self, attr, change_root(self.root, getattr(self, attr))) def create_home_path(self) -> None: """Create directories under ~.""" if not self.user: return home = convert_path(os.path.expanduser("~")) for path in self.config_vars.values(): if str(path).startswith(home) and not os.path.isdir(path): self.debug_print(f"os.makedirs('{path}', 0o700)") os.makedirs(path, 0o700) # -- Command execution methods ------------------------------------- def run(self): """Runs the command.""" # Obviously have to build before we can install if not self.skip_build: self.run_command('build') # If we built for any other platform, we can't install. build_plat = self.distribution.get_command_obj('build').plat_name # check warn_dir - it is a clue that the 'install' is happening # internally, and not to sys.path, so we don't check the platform # matches what we are running. if self.warn_dir and build_plat != get_platform(): raise DistutilsPlatformError("Can't install when cross-compiling") # Run all sub-commands (at least those that need to be run) for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) if self.path_file: self.create_path_file() # write list of installed files, if requested. if self.record: outputs = self.get_outputs() if self.root: # strip any package prefix root_len = len(self.root) for counter in range(len(outputs)): outputs[counter] = outputs[counter][root_len:] self.execute( write_file, (self.record, outputs), f"writing list of installed files to '{self.record}'", ) sys_path = map(os.path.normpath, sys.path) sys_path = map(os.path.normcase, sys_path) install_lib = os.path.normcase(os.path.normpath(self.install_lib)) if ( self.warn_dir and not (self.path_file and self.install_path_file) and install_lib not in sys_path ): log.debug( ( "modules installed to '%s', which is not in " "Python's module search path (sys.path) -- " "you'll have to change the search path yourself" ), self.install_lib, ) def create_path_file(self): """Creates the .pth file""" filename = os.path.join(self.install_libbase, self.path_file + ".pth") if self.install_path_file: self.execute( write_file, (filename, [self.extra_dirs]), f"creating {filename}" ) else: self.warn(f"path file '{filename}' not created") # -- Reporting methods --------------------------------------------- def get_outputs(self): """Assembles the outputs of all the sub-commands.""" outputs = [] for cmd_name in self.get_sub_commands(): cmd = self.get_finalized_command(cmd_name) # Add the contents of cmd.get_outputs(), ensuring # that outputs doesn't contain duplicate entries for filename in cmd.get_outputs(): if filename not in outputs: outputs.append(filename) if self.path_file and self.install_path_file: outputs.append(os.path.join(self.install_libbase, self.path_file + ".pth")) return outputs def get_inputs(self): """Returns the inputs of all the sub-commands""" # XXX gee, this looks familiar ;-( inputs = [] for cmd_name in self.get_sub_commands(): cmd = self.get_finalized_command(cmd_name) inputs.extend(cmd.get_inputs()) return inputs # -- Predicates for sub-command list ------------------------------- def has_lib(self): """Returns true if the current distribution has any Python modules to install.""" return ( self.distribution.has_pure_modules() or self.distribution.has_ext_modules() ) def has_headers(self): """Returns true if the current distribution has any headers to install.""" return self.distribution.has_headers() def has_scripts(self): """Returns true if the current distribution has any scripts to. install.""" return self.distribution.has_scripts() def has_data(self): """Returns true if the current distribution has any data to. install.""" return self.distribution.has_data_files() # 'sub_commands': a list of commands this command might have to run to # get its work done. See cmd.py for more info. sub_commands = [ ('install_lib', has_lib), ('install_headers', has_headers), ('install_scripts', has_scripts), ('install_data', has_data), ('install_egg_info', lambda self: True), ] _distutils/command/build_py.py 0000644 00000040470 15030122015 0012520 0 ustar 00 """distutils.command.build_py Implements the Distutils 'build_py' command.""" import glob import importlib.util import os import sys from distutils._log import log from typing import ClassVar from ..core import Command from ..errors import DistutilsFileError, DistutilsOptionError from ..util import convert_path class build_py(Command): description = "\"build\" pure Python modules (copy to build directory)" user_options = [ ('build-lib=', 'd', "directory to \"build\" (copy) to"), ('compile', 'c', "compile .py to .pyc"), ('no-compile', None, "don't compile .py files [default]"), ( 'optimize=', 'O', "also compile with optimization: -O1 for \"python -O\", " "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", ), ('force', 'f', "forcibly build everything (ignore file timestamps)"), ] boolean_options: ClassVar[list[str]] = ['compile', 'force'] negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} def initialize_options(self): self.build_lib = None self.py_modules = None self.package = None self.package_data = None self.package_dir = None self.compile = False self.optimize = 0 self.force = None def finalize_options(self) -> None: self.set_undefined_options( 'build', ('build_lib', 'build_lib'), ('force', 'force') ) # Get the distribution options that are aliases for build_py # options -- list of packages and list of modules. self.packages = self.distribution.packages self.py_modules = self.distribution.py_modules self.package_data = self.distribution.package_data self.package_dir = {} if self.distribution.package_dir: for name, path in self.distribution.package_dir.items(): self.package_dir[name] = convert_path(path) self.data_files = self.get_data_files() # Ick, copied straight from install_lib.py (fancy_getopt needs a # type system! Hell, *everything* needs a type system!!!) if not isinstance(self.optimize, int): try: self.optimize = int(self.optimize) assert 0 <= self.optimize <= 2 except (ValueError, AssertionError): raise DistutilsOptionError("optimize must be 0, 1, or 2") def run(self) -> None: # XXX copy_file by default preserves atime and mtime. IMHO this is # the right thing to do, but perhaps it should be an option -- in # particular, a site administrator might want installed files to # reflect the time of installation rather than the last # modification time before the installed release. # XXX copy_file by default preserves mode, which appears to be the # wrong thing to do: if a file is read-only in the working # directory, we want it to be installed read/write so that the next # installation of the same module distribution can overwrite it # without problems. (This might be a Unix-specific issue.) Thus # we turn off 'preserve_mode' when copying to the build directory, # since the build directory is supposed to be exactly what the # installation will look like (ie. we preserve mode when # installing). # Two options control which modules will be installed: 'packages' # and 'py_modules'. The former lets us work with whole packages, not # specifying individual modules at all; the latter is for # specifying modules one-at-a-time. if self.py_modules: self.build_modules() if self.packages: self.build_packages() self.build_package_data() self.byte_compile(self.get_outputs(include_bytecode=False)) def get_data_files(self): """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" data = [] if not self.packages: return data for package in self.packages: # Locate package source directory src_dir = self.get_package_dir(package) # Compute package build directory build_dir = os.path.join(*([self.build_lib] + package.split('.'))) # Length of path to strip from found files plen = 0 if src_dir: plen = len(src_dir) + 1 # Strip directory from globbed filenames filenames = [file[plen:] for file in self.find_data_files(package, src_dir)] data.append((package, src_dir, build_dir, filenames)) return data def find_data_files(self, package, src_dir): """Return filenames for package's data files in 'src_dir'""" globs = self.package_data.get('', []) + self.package_data.get(package, []) files = [] for pattern in globs: # Each pattern has to be converted to a platform-specific path filelist = glob.glob( os.path.join(glob.escape(src_dir), convert_path(pattern)) ) # Files that match more than one pattern are only added once files.extend([ fn for fn in filelist if fn not in files and os.path.isfile(fn) ]) return files def build_package_data(self) -> None: """Copy data files into build directory""" for _package, src_dir, build_dir, filenames in self.data_files: for filename in filenames: target = os.path.join(build_dir, filename) self.mkpath(os.path.dirname(target)) self.copy_file( os.path.join(src_dir, filename), target, preserve_mode=False ) def get_package_dir(self, package): """Return the directory, relative to the top of the source distribution, where package 'package' should be found (at least according to the 'package_dir' option, if any).""" path = package.split('.') if not self.package_dir: if path: return os.path.join(*path) else: return '' else: tail = [] while path: try: pdir = self.package_dir['.'.join(path)] except KeyError: tail.insert(0, path[-1]) del path[-1] else: tail.insert(0, pdir) return os.path.join(*tail) else: # Oops, got all the way through 'path' without finding a # match in package_dir. If package_dir defines a directory # for the root (nameless) package, then fallback on it; # otherwise, we might as well have not consulted # package_dir at all, as we just use the directory implied # by 'tail' (which should be the same as the original value # of 'path' at this point). pdir = self.package_dir.get('') if pdir is not None: tail.insert(0, pdir) if tail: return os.path.join(*tail) else: return '' def check_package(self, package, package_dir): # Empty dir name means current directory, which we can probably # assume exists. Also, os.path.exists and isdir don't know about # my "empty string means current dir" convention, so we have to # circumvent them. if package_dir != "": if not os.path.exists(package_dir): raise DistutilsFileError( f"package directory '{package_dir}' does not exist" ) if not os.path.isdir(package_dir): raise DistutilsFileError( f"supposed package directory '{package_dir}' exists, " "but is not a directory" ) # Directories without __init__.py are namespace packages (PEP 420). if package: init_py = os.path.join(package_dir, "__init__.py") if os.path.isfile(init_py): return init_py # Either not in a package at all (__init__.py not expected), or # __init__.py doesn't exist -- so don't return the filename. return None def check_module(self, module, module_file): if not os.path.isfile(module_file): log.warning("file %s (for module %s) not found", module_file, module) return False else: return True def find_package_modules(self, package, package_dir): self.check_package(package, package_dir) module_files = glob.glob(os.path.join(glob.escape(package_dir), "*.py")) modules = [] setup_script = os.path.abspath(self.distribution.script_name) for f in module_files: abs_f = os.path.abspath(f) if abs_f != setup_script: module = os.path.splitext(os.path.basename(f))[0] modules.append((package, module, f)) else: self.debug_print(f"excluding {setup_script}") return modules def find_modules(self): """Finds individually-specified Python modules, ie. those listed by module name in 'self.py_modules'. Returns a list of tuples (package, module_base, filename): 'package' is a tuple of the path through package-space to the module; 'module_base' is the bare (no packages, no dots) module name, and 'filename' is the path to the ".py" file (relative to the distribution root) that implements the module. """ # Map package names to tuples of useful info about the package: # (package_dir, checked) # package_dir - the directory where we'll find source files for # this package # checked - true if we have checked that the package directory # is valid (exists, contains __init__.py, ... ?) packages = {} # List of (package, module, filename) tuples to return modules = [] # We treat modules-in-packages almost the same as toplevel modules, # just the "package" for a toplevel is empty (either an empty # string or empty list, depending on context). Differences: # - don't check for __init__.py in directory for empty package for module in self.py_modules: path = module.split('.') package = '.'.join(path[0:-1]) module_base = path[-1] try: (package_dir, checked) = packages[package] except KeyError: package_dir = self.get_package_dir(package) checked = False if not checked: init_py = self.check_package(package, package_dir) packages[package] = (package_dir, 1) if init_py: modules.append((package, "__init__", init_py)) # XXX perhaps we should also check for just .pyc files # (so greedy closed-source bastards can distribute Python # modules too) module_file = os.path.join(package_dir, module_base + ".py") if not self.check_module(module, module_file): continue modules.append((package, module_base, module_file)) return modules def find_all_modules(self): """Compute the list of all modules that will be built, whether they are specified one-module-at-a-time ('self.py_modules') or by whole packages ('self.packages'). Return a list of tuples (package, module, module_file), just like 'find_modules()' and 'find_package_modules()' do.""" modules = [] if self.py_modules: modules.extend(self.find_modules()) if self.packages: for package in self.packages: package_dir = self.get_package_dir(package) m = self.find_package_modules(package, package_dir) modules.extend(m) return modules def get_source_files(self): return [module[-1] for module in self.find_all_modules()] def get_module_outfile(self, build_dir, package, module): outfile_path = [build_dir] + list(package) + [module + ".py"] return os.path.join(*outfile_path) def get_outputs(self, include_bytecode: bool = True) -> list[str]: modules = self.find_all_modules() outputs = [] for package, module, _module_file in modules: package = package.split('.') filename = self.get_module_outfile(self.build_lib, package, module) outputs.append(filename) if include_bytecode: if self.compile: outputs.append( importlib.util.cache_from_source(filename, optimization='') ) if self.optimize > 0: outputs.append( importlib.util.cache_from_source( filename, optimization=self.optimize ) ) outputs += [ os.path.join(build_dir, filename) for package, src_dir, build_dir, filenames in self.data_files for filename in filenames ] return outputs def build_module(self, module, module_file, package): if isinstance(package, str): package = package.split('.') elif not isinstance(package, (list, tuple)): raise TypeError( "'package' must be a string (dot-separated), list, or tuple" ) # Now put the module source file into the "build" area -- this is # easy, we just copy it somewhere under self.build_lib (the build # directory for Python source). outfile = self.get_module_outfile(self.build_lib, package, module) dir = os.path.dirname(outfile) self.mkpath(dir) return self.copy_file(module_file, outfile, preserve_mode=False) def build_modules(self) -> None: modules = self.find_modules() for package, module, module_file in modules: # Now "build" the module -- ie. copy the source file to # self.build_lib (the build directory for Python source). # (Actually, it gets copied to the directory for this package # under self.build_lib.) self.build_module(module, module_file, package) def build_packages(self) -> None: for package in self.packages: # Get list of (package, module, module_file) tuples based on # scanning the package directory. 'package' is only included # in the tuple so that 'find_modules()' and # 'find_package_tuples()' have a consistent interface; it's # ignored here (apart from a sanity check). Also, 'module' is # the *unqualified* module name (ie. no dots, no package -- we # already know its package!), and 'module_file' is the path to # the .py file, relative to the current directory # (ie. including 'package_dir'). package_dir = self.get_package_dir(package) modules = self.find_package_modules(package, package_dir) # Now loop over the modules we found, "building" each one (just # copy it to self.build_lib). for package_, module, module_file in modules: assert package == package_ self.build_module(module, module_file, package) def byte_compile(self, files) -> None: if sys.dont_write_bytecode: self.warn('byte-compiling is disabled, skipping.') return from ..util import byte_compile prefix = self.build_lib if prefix[-1] != os.sep: prefix = prefix + os.sep # XXX this code is essentially the same as the 'byte_compile() # method of the "install_lib" command, except for the determination # of the 'prefix' string. Hmmm. if self.compile: byte_compile( files, optimize=0, force=self.force, prefix=prefix, dry_run=self.dry_run ) if self.optimize > 0: byte_compile( files, optimize=self.optimize, force=self.force, prefix=prefix, dry_run=self.dry_run, ) _distutils/command/install_data.py 0000644 00000005473 15030122015 0013354 0 ustar 00 """distutils.command.install_data Implements the Distutils 'install_data' command, for installing platform-independent data files.""" # contributed by Bastian Kleineidam from __future__ import annotations import functools import os from collections.abc import Iterable from typing import ClassVar from ..core import Command from ..util import change_root, convert_path class install_data(Command): description = "install data files" user_options = [ ( 'install-dir=', 'd', "base directory for installing data files [default: installation base dir]", ), ('root=', None, "install everything relative to this alternate root directory"), ('force', 'f', "force installation (overwrite existing files)"), ] boolean_options: ClassVar[list[str]] = ['force'] def initialize_options(self): self.install_dir = None self.outfiles = [] self.root = None self.force = False self.data_files = self.distribution.data_files self.warn_dir = True def finalize_options(self) -> None: self.set_undefined_options( 'install', ('install_data', 'install_dir'), ('root', 'root'), ('force', 'force'), ) def run(self) -> None: self.mkpath(self.install_dir) for f in self.data_files: self._copy(f) @functools.singledispatchmethod def _copy(self, f: tuple[str | os.PathLike, Iterable[str | os.PathLike]]): # it's a tuple with path to install to and a list of files dir = convert_path(f[0]) if not os.path.isabs(dir): dir = os.path.join(self.install_dir, dir) elif self.root: dir = change_root(self.root, dir) self.mkpath(dir) if f[1] == []: # If there are no files listed, the user must be # trying to create an empty directory, so add the # directory to the list of output files. self.outfiles.append(dir) else: # Copy files, adding them to the list of output files. for data in f[1]: data = convert_path(data) (out, _) = self.copy_file(data, dir) self.outfiles.append(out) @_copy.register(str) @_copy.register(os.PathLike) def _(self, f: str | os.PathLike): # it's a simple file, so copy it f = convert_path(f) if self.warn_dir: self.warn( "setup script did not provide a directory for " f"'{f}' -- installing right in '{self.install_dir}'" ) (out, _) = self.copy_file(f, self.install_dir) self.outfiles.append(out) def get_inputs(self): return self.data_files or [] def get_outputs(self): return self.outfiles _distutils/command/__pycache__/sdist.cpython-310.pyc 0000644 00000035003 15030122015 0016372 0 ustar 00 o �h�J � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZm Z m Z ddl m Z ddl m Z ddlmZ dd lmZ d d lmZ d d lmZmZ d d lmZ d dlmZ d dlm Z dd� Z G dd� de�Z ddd�Z dS )zadistutils.command.sdist Implements the Distutils 'sdist' command (create a source distribution).� )� annotationsN)�Callable)� archive_util�dir_util� file_util)�log)�glob)� filterfalse)�ClassVar� )�Command)�DistutilsOptionError�DistutilsTemplateError)�FileList)�TextFile)� convert_pathc sD ddl m� ddlm} t� fdd�� �� D ��}| |��d� dS )zoPrint all possible values for the 'formats' option (used by the "--help-formats" command-line option). r ��ARCHIVE_FORMATS)� FancyGetoptc 3 s& � | ]}d | d� | d fV qdS )�formats=Nr � )�.0�formatr r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/sdist.py� <genexpr> s � � �z show_formats.<locals>.<genexpr>z.List of available source distribution formats:N)r r � fancy_getoptr �sorted�keys� print_help)r �formatsr r r � show_formats s �r c @ s2 e Zd ZU dZdCdd�Zg d�Zg d�Zded < d d d efgZ d ed< ddd�Z ded< defgZ dZ ded< dd� Z dDdd �ZdDd d �ZdDd d �ZdDd!d"�Zed#d$� �Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� ZdDd3d4�ZdDd5d6�Z dDd7d8�Z d9d:� Z dDd;d<�Z dDd=d>�Z dDd?d@�Z!dAdB� Z"d S )E�sdistz6create a source distribution (tarball, zip file, etc.)�return�boolc C � | j S )zYCallable used for the check sub-command. Placed here so user_options can view it)�metadata_check��selfr r r �checking_metadata( � zsdist.checking_metadata))z template=�tz5name of manifest template file [default: MANIFEST.in])z manifest=�mz)name of manifest file [default: MANIFEST])� use-defaultsNzRinclude the default file set in the manifest [default; disable with --no-defaults])� no-defaultsNz"don't include the default file set)�pruneNz�specifically exclude files/directories that should not be distributed (build tree, RCS/CVS dirs, etc.) [default; disable with --no-prune])�no-pruneNz$don't automatically exclude anything)� manifest-only�ozEjust regenerate the manifest and then stop (implies --force-manifest))�force-manifest�fzkforcibly regenerate the manifest and carry on as usual. Deprecated: now the manifest is always regenerated.)r Nz6formats for source distribution (comma-separated list))� keep-temp�kz@keep the distribution tree around after creating archive file(s))z dist-dir=�dzFdirectory to put the source distribution archive(s) in [default: dist])�metadata-checkNz[Ensure that all required elements of meta-data are supplied. Warn if any missing. [default])zowner=�uz@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group])r, r. r0 r2 r4 r7 zClassVar[list[str]]�boolean_optionsz help-formatsNz#list available distribution formatszAClassVar[list[tuple[str, str | None, str, Callable[[], object]]]]� help_optionsr, r. )r- r/ zClassVar[dict[str, str]]� negative_opt�check)�READMEz README.txtz README.rstzClassVar[tuple[str, ...]]�READMESc C sT d | _ d | _d| _d| _d| _d| _dg| _d| _d | _d | _ d| _ d | _ d | _ d S )NTF�gztar) �template�manifest� use_defaultsr. � manifest_only�force_manifestr � keep_temp�dist_dir� archive_filesr% �owner�groupr& r r r �initialize_options~ s zsdist.initialize_options�Nonec C sb | j d u rd| _ | jd u rd| _| �d� t�| j�}|r%td|� d���| jd u r/d| _d S d S )N�MANIFESTz MANIFEST.inr zunknown archive format '�'�dist)rB rA �ensure_string_listr �check_archive_formatsr r rG )r' � bad_formatr r r �finalize_options� s �zsdist.finalize_optionsc C s> t � | _| �� D ]}| �|� q| �� | jrd S | �� d S �N)r �filelist�get_sub_commands� run_command� get_file_listrD �make_distribution)r' �cmd_namer r r �run� s z sdist.runc C s� t j�| j�}|s | �� r | �� | j�� | j�� dS |s'| � d| j � | j� � | j r3| � � |r9| � � | jr@| �� | j�� | j�� | �� dS )aC Figure out the list of files to include in the source distribution, and put it in 'self.filelist'. This might involve reading the manifest template (and writing the manifest), or just reading the manifest, or just using the default file set -- it all depends on the user's options. Nz?manifest template '%s' does not exist (using default file list))�os�path�isfilerA �_manifest_is_not_generated� read_manifestrU �sort�remove_duplicates�warn�findallrC � add_defaults� read_templater. �prune_file_list�write_manifest)r' �template_existsr r r rX � s, �� zsdist.get_file_listc C s< | � � | �� | �� | �� | �� | �� | �� dS )aL Add all the default files to self.filelist: - README or README.txt - setup.py - tests/test*.py and test/test*.py - all pure Python modules mentioned in setup script - all files pointed by package_data (build_py) - all files defined in data_files. - all files defined as scripts. - all C sources listed as part of extensions or C libraries in the setup script (doesn't catch C headers!) Warns if (README or README.txt) or setup.py are missing; everything else is optional. N)�_add_defaults_standards�_add_defaults_optional�_add_defaults_python�_add_defaults_data_files�_add_defaults_ext�_add_defaults_c_libs�_add_defaults_scriptsr& r r r re � s zsdist.add_defaultsc C s: t j�| �sdS t j�| �}t j�|�\}}|t �|�v S )z� Case-sensitive path existence check >>> sdist._cs_path_exists(__file__) True >>> sdist._cs_path_exists(__file__.upper()) False F)r\ r] �exists�abspath�split�listdir)�fspathrr � directory�filenamer r r �_cs_path_exists� s zsdist._cs_path_existsc C s� | j | jjg}|D ]A}t|t�r5|}d}|D ]}| �|�r'd}| j�|� nq|s4| �dd� |� � q | �|�rA| j�|� q | �d|� d�� q d S )NFTz,standard file not found: should have one of z, zstandard file 'z ' not found) r? � distribution� script_name� isinstance�tuplerx rU �appendrc �join)r' � standards�fn�alts�got_itr r r rj s( � �� �z sdist._add_defaults_standardsc C s4 g d�}|D ]}t tjjt|��}| j�|� qd S )N)ztests/test*.pyz test/test*.pyz setup.cfg)�filterr\ r] r^ r rU �extend)r' �optional�pattern�filesr r r rk s �z sdist._add_defaults_optionalc C s\ | � d�}| j�� r| j�|�� � |jD ]\}}}}|D ] }| j�tj � ||�� q qd S )N�build_py) �get_finalized_commandry �has_pure_modulesrU r� �get_source_files� data_filesr} r\ r] r~ )r' r� �_pkg�src_dir� _build_dir� filenamesrw r r r rl & s ��zsdist._add_defaults_pythonc C s~ | j �� r;| j jD ]3}t|t�r!t|�}tj�|�r | j � |� q |\}}|D ]}t|�}tj�|�r9| j � |� q'q d S d S rT ) ry �has_data_filesr� r{ �strr r\ r] r^ rU r} )r' �item�dirnamer� r3 r r r rm 6 s � ���z sdist._add_defaults_data_filesc C �, | j �� r| �d�}| j�|�� � d S d S )N� build_ext)ry �has_ext_modulesr� rU r� r� )r' r� r r r rn G � �zsdist._add_defaults_extc C r� )N� build_clib)ry �has_c_librariesr� rU r� r� )r' r� r r r ro L r� zsdist._add_defaults_c_libsc C r� )N� build_scripts)ry � has_scriptsr� rU r� r� )r' r� r r r rp Q r� zsdist._add_defaults_scriptsc C s� t �d| j� t| jddddddd�}z@ |�� }|du r n/z| j�|� W n% ttfyK } z| � |j � dt |j �� d|� �� W Y d}~nd}~ww qW |� � dS |� � w )z�Read and parse manifest template file named by self.template. (usually "MANIFEST.in") The parsing and processing is done by 'self.filelist', which updates itself accordingly. z reading manifest template '%s'T)�strip_comments� skip_blanks� join_lines� lstrip_ws� rstrip_ws� collapse_joinNz, line z: )r �inforA r �readlinerU �process_template_liner � ValueErrorrc rw �int� current_line�close)r' rA �line�msgr r r rf V s4 � ���� zsdist.read_templatec C s� | � d�}| j�� }| jjdt�|j�d� | jjd|d� tj dkr&d}nd}g d�}d� |d � |�|�}| jj|d d � dS ) av Prune off branches that might slip into the file list as created by 'read_template()', but really don't belong there: * the build tree (typically "build") * the release tree itself (only an issue if we ran "sdist" previously with --keep-temp, or it aborted) * any RCS, CVS, .svn, .hg, .git, .bzr, _darcs directories �buildN)�prefix�win32z/|\\�/)�RCS�CVSz\.svnz\.hgz\.gitz\.bzr�_darcsz(^|{})({})({}).*�|T)�is_regex) r� ry � get_fullnamerU �exclude_patternr\ ru � build_base�sys�platformr r~ )r' r� �base_dir�seps�vcs_dirs�vcs_ptrnr r r rg y s zsdist.prune_file_listc C s` | � � rt�d| j� d�� dS | jjdd� }|�dd� | �tj | j|fd| j� d�� dS )z�Write the file list in 'self.filelist' (presumably as filled in by 'add_defaults()' and 'read_template()') to the manifest file named by 'self.manifest'. z2not writing to manually maintained manifest file 'rN Nr z*# file GENERATED by distutils, do NOT editzwriting manifest file ') r_ r r� rB rU r� �insert�executer � write_file)r' �contentr r r rh � s � �zsdist.write_manifestc C sV t j�| j�s dS t| jdd��}t|�}W d � |dkS 1 s"w Y |dkS )NF�utf-8��encodingz+# file GENERATED by distutils, do NOT edit )r\ r] r^ rB �open�next)r' �fp� first_liner r r r_ � s ��z sdist._manifest_is_not_generatedc C sb t �d| j� t| jdd��}| j�tdttt t j |���� W d � dS 1 s*w Y dS )z�Read the manifest file (named by 'self.manifest') and use it to fill in 'self.filelist', the list of files to include in the source distribution. zreading manifest file '%s'r� r� N) r r� rB r� rU r� r� r � is_comment�mapr� �strip)r' �linesr r r r` � s �"�zsdist.read_manifestc C s� | � |� tj||| jd� ttd�r d}d|� d�}nd}d|� d�}|s,t�d� nt�|� |D ] }tj � |�sBt�d |� q3tj � ||�}| j |||d � q3| j j�|� dS ) a� Create the directory tree that will become the source distribution archive. All directories implied by the filenames in 'files' are created under 'base_dir', and then we hard link or copy (if hard linking is unavailable) those files into place. Essentially, this duplicates the developer's source tree, but in a directory named after the distribution, containing only the files to be distributed. ��dry_run�link�hardzmaking hard links in z...Nzcopying files to z)no files to distribute -- empty manifest?z#'%s' not a regular file -- skipping)r� )�mkpathr � create_treer� �hasattrr\ r �warningr� r] r^ r~ � copy_filery �metadata�write_pkg_info)r' r� r� r� r� �file�destr r r �make_release_tree� s zsdist.make_release_treec C s� | j �� }tj�| j|�}| �|| jj� g }d| j v r*| j � | j � | j � d��� | j D ] }| j |||| j| jd�}|� |� | j j� dd|f� q-|| _| js[tj|| jd� dS dS )a� Create the source distribution(s). First, we create the release tree with 'make_release_tree()'; then, we create all required archive files (according to 'self.formats') from the release tree. Finally, we clean up by blowing away the release tree (unless 'self.keep_temp' is true). The list of archive files created is stored so it can be retrieved later by 'get_archive_files()'. �tar)r� rI rJ r! � r� N)ry r� r\ r] r~ rG r� rU r� r r} �pop�index� make_archiverI rJ � dist_filesrH rF r � remove_treer� )r' r� � base_namerH �fmtr� r r r rY � s � �zsdist.make_distributionc C r$ )zzReturn the list of archive files created when the command was run, or None if the command hasn't run yet. )rH r& r r r �get_archive_files r) zsdist.get_archive_files)r" r# )r" rL )#�__name__� __module__� __qualname__� descriptionr( � user_optionsr: �__annotations__r r; r< � sub_commandsr? rK rS r[ rX re � staticmethodrx rj rk rl rm rn ro rp rf rg rh r_ r` r� rY r� r r r r r! % sD : �� ) # * r! r� r� r" r# c C s | � d�S )N�#)� startswith)r� r r r r� s r� )r� r� r" r# ) �__doc__� __future__r r\ r� �collections.abcr � distutilsr r r �distutils._logr r � itertoolsr �typingr �corer �errorsr r rU r � text_filer �utilr r r! r� r r r r �<module> s* f _distutils/command/__pycache__/check.cpython-310.pyc 0000644 00000011454 15030122015 0016325 0 ustar 00 o �hR � @ s� d Z ddlZddlmZ ddlmZ ddlmZ e�e ��" ddl Z ddl Z ddl Z ddlZ G dd� de jj�ZW d � n1 sBw Y G d d � d e�ZdS ) zCdistutils.command.check Implements the Distutils 'check' command. � N)�ClassVar� )�Command)�DistutilsSetupErrorc s. e Zd Z d � fdd� Zdd� Z� ZS ) �SilentReporterNF�ascii�replacec s" g | _ t� �|||||||� d S �N)�messages�super�__init__)�self�source� report_level� halt_level�stream�debug�encoding� error_handler�� __class__� �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/check.pyr s �zSilentReporter.__init__c O s: | j �||||f� tjj|g|�R || j| d�|��S )N)�level�type)r �append�docutils�nodes�system_message�levels)r r �message�children�kwargsr r r r " s �� ��z SilentReporter.system_message)NFr r )�__name__� __module__� __qualname__r r � __classcell__r r r r r s �r c @ s� e Zd ZU dZdZg d�Zeeee e e f e d< g d�Z eee e d< dd� Z d d � Z d d � Zd d� Zdd� Zdd� Zdd� ZdS )�checkz1This command checks the meta-data of the package.z"perform some checks on the package))�metadata�mzVerify meta-data)�restructuredtext�rzEChecks if long string meta-data syntax are reStructuredText-compliant)�strict�sz(Will exit with an error if a check fails� user_options)r( r* r, �boolean_optionsc C s d| _ d| _d| _d| _dS )z Sets default values for options.F� r N)r* r( r, � _warnings�r r r r �initialize_options9 s zcheck.initialize_optionsc C s d S r r r2 r r r �finalize_options@ s zcheck.finalize_optionsc C s | j d7 _ t�| |�S )z*Counts the number of warnings that occurs.r0 )r1 r �warn)r �msgr r r r5 C s z check.warnc C s~ | j r| �� | jr/dt� v r(z| �� W n ty' } ztt|���d}~ww | jr/td��| jr;| j dkr=td��dS dS )zRuns the command.r Nz The docutils package is needed.r z Please correct your package.) r( �check_metadatar* �globals�check_restructuredtext� TypeErrorr �strr, r1 )r �excr r r �runH s ���z check.runc s< | j j� � fdd�dD �}|r | �d�d�|��� dS dS )z�Ensures that all required elements of meta-data are supplied. Required fields: name, version Warns if any are missing. c s g | ] }t � |d �s|�qS r )�getattr)�.0�attr�r( r r � <listcomp>e s ��z(check.check_metadata.<locals>.<listcomp>)�name�versionz missing required meta-data: {}z, N)� distributionr( r5 �format�join)r �missingr rA r r7 [ s ��zcheck.check_metadatac C s\ | j �� }| �|�D ]!}|d �d�}|du r |d }n |d � d|� d�}| �|� q dS )z4Checks if the long string fields are reST-compliant.����lineNr0 z (line �))rE �get_long_description�_check_rst_data�getr5 )r �data�warningrJ r r r r9 l s �z check.check_restructuredtextc C s� | j jpd}tjj�� }tjjtjjjfd��� }d|_ d|_ d|_ t ||j |j|j|j|j|jd�}tjj|||d�}|�|d� z |�||� W |jS ttfyp } z|j�dd|� d �d i f� W Y d}~|jS d}~ww ) z8Returns warnings when the provided data doesn't compile.zsetup.py)� components� N)r r r r )r rI z Could not finish the parsing: �.� )rE � script_namer �parsers�rst�Parser�frontend� OptionParser�get_default_values� tab_width�pep_references�rfc_referencesr r r �warning_streamr �error_encoding� error_encoding_error_handlerr �document� note_source�parse�AttributeErrorr: r r )r rO � source_path�parser�settings�reporterrb �er r r rM w sD ��� � ���zcheck._check_rst_dataN)r# r$ r% �__doc__� descriptionr. r �list�tupler; �__annotations__r/ r3 r4 r5 r= r7 r9 rM r r r r r' ) s " r' )rk � contextlib�typingr �corer �errorsr �suppress� ImportError�docutils.frontendr �docutils.nodes�docutils.parsers.rst�docutils.utils�utils�Reporterr r' r r r r �<module> s � _distutils/command/__pycache__/install_egg_info.cpython-310.pyc 0000644 00000006573 15030122015 0020561 0 ustar 00 o �h4 � @ sx d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl m Z G dd � d e �Z d d � Z d d � Zdd� ZdS )z� distutils.command.install_egg_info Implements the Distutils 'install_egg_info' command, for installing a package's PKG-INFO metadata. � N)�ClassVar� )�dir_util)�log)�Commandc @ sb e Zd ZU dZdZdgZeeee e e f e d< dd� Z e dd� �Z d d � Zd d � Zd d� ZdS )�install_egg_infoz)Install an .egg-info file for the packagez8Install package's PKG-INFO metadata as an .egg-info file)z install-dir=�dzdirectory to install to� user_optionsc C s d | _ d S �N)� install_dir��self� r �a/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install_egg_info.py�initialize_options s z#install_egg_info.initialize_optionsc C sH t t| j�� ��}t t| j�� ��}|� d|� dtjj� dtjj � d�S )z_ Allow basename to be overridden by child class. Ref pypa/distutils#2. �-z-py�.z .egg-info) � to_filename� safe_name� distribution�get_name� safe_version� get_version�sys� version_info�major�minor)r �name�versionr r r �basename s $zinstall_egg_info.basenamec C s. | � dd� tj�| j| j�| _| jg| _d S )N� install_lib)r r )�set_undefined_options�os�path�joinr r �target�outputsr r r r �finalize_options' s z!install_egg_info.finalize_optionsc C s� | j }tj�|�rtj�|�stj|| jd� n'tj�|�r+| � tj | j fd| � ntj�| j �s?| � tj | j fd| j � t �d|� | jsit|ddd��}| jj�|� W d � d S 1 sbw Y d S d S )N)�dry_runz Removing z Creating z Writing %s�wzUTF-8)�encoding)r% r" r# �isdir�islinkr � remove_treer( �exists�execute�unlinkr �makedirsr �info�openr �metadata�write_pkg_file)r r% �fr r r �run, s � "��zinstall_egg_info.runc C s | j S r )r& r r r r � get_outputs; s z install_egg_info.get_outputsN)�__name__� __module__� __qualname__�__doc__� descriptionr r �list�tuple�str�__annotations__r �propertyr r' r7 r8 r r r r r s � r c C s t �dd| �S )z�Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. �[^A-Za-z0-9.]+r )�re�sub�r r r r r D s r c C s | � dd�} t�dd| �S )z�Convert an arbitrary string to a standard version string Spaces become dots, and all other non-alphanumeric characters become dashes, with runs of multiple dashes condensed to a single dash. � r rC r )�replacerD rE )r r r r r L s r c C s | � dd�S )z|Convert a project or version name to its filename-escaped form Any '-' characters are currently replaced with '_'. r �_)rH rF r r r r V s r )r< r" rD r �typingr � r �_logr �cmdr r r r r r r r r �<module> s 2 _distutils/command/__pycache__/__init__.cpython-310.pyc 0000644 00000000743 15030122015 0017006 0 ustar 00 o �h� � @ s d Z g d�ZdS )z\distutils.command Package containing implementation of all the standard Distutils commands.)�build�build_py� build_ext� build_clib� build_scripts�clean�install� install_lib�install_headers�install_scripts� install_data�sdist�bdist� bdist_dumb� bdist_rpm�checkN)�__doc__�__all__� r r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/__init__.py�<module> s _distutils/command/__pycache__/install_data.cpython-310.pyc 0000644 00000005717 15030122015 0017714 0 ustar 00 o �h; � @ sh d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m Z ddl m Z m Z G d d � d e �ZdS ) z�distutils.command.install_data Implements the Distutils 'install_data' command, for installing platform-independent data files.� )� annotationsN)�Iterable)�ClassVar� )�Command)� change_root� convert_pathc @ s� e Zd ZU dZg d�ZdgZded< dd� Zdd d �Zdd d �Z e j ddd��Z e � e�e � ej�d dd���Zdd� Zdd� ZdS ) � install_datazinstall data files))z install-dir=�dzIbase directory for installing data files [default: installation base dir])zroot=Nz<install everything relative to this alternate root directory)�force�fz-force installation (overwrite existing files)r zClassVar[list[str]]�boolean_optionsc C s, d | _ g | _d | _d| _| jj| _d| _d S )NFT)� install_dir�outfiles�rootr � distribution� data_files�warn_dir��self� r �]/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install_data.py�initialize_options" s z install_data.initialize_options�return�Nonec C s | � dddd� d S )N�install)r r )r r )r r )�set_undefined_optionsr r r r �finalize_options* s �z install_data.finalize_optionsc C s& | � | j� | jD ]}| �|� q d S �N)�mkpathr r �_copy)r r r r r �run2 s �zinstall_data.runr �5tuple[str | os.PathLike, Iterable[str | os.PathLike]]c C s� t |d �}tj�|�stj�| j|�}n | jr t| j|�}| �|� |d g kr1| j � |� d S |d D ]}t |�}| � ||�\}}| j � |� q5d S )Nr � ) r �os�path�isabs�joinr r r r r �append� copy_file)r r �dir�data�out�_r r r r 7 s �zinstall_data._copy�str | os.PathLikec C sJ t |�}| jr| �d|� d| j� d�� | �|| j�\}}| j�|� d S )Nz.setup script did not provide a directory for 'z' -- installing right in '�')r r �warnr r) r r( )r r r, r- r r r r- M s ���zinstall_data._c C s | j pg S r )r r r r r � get_inputsZ s zinstall_data.get_inputsc C s | j S r )r r r r r � get_outputs] s zinstall_data.get_outputsN)r r )r r" )r r. )�__name__� __module__� __qualname__� description� user_optionsr �__annotations__r r r! � functools�singledispatchmethodr �register�strr$ �PathLiker- r1 r2 r r r r r s r )�__doc__� __future__r r9 r$ �collections.abcr �typingr �corer �utilr r r r r r r �<module> s _distutils/command/__pycache__/build_clib.cpython-310.pyc 0000644 00000011704 15030122015 0017336 0 ustar 00 o �ha � @ s� d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl m Z m Z dd l mZ dd lmZ dd lmZ G d d � d e�ZdS )z�distutils.command.build_clib Implements the Distutils 'build_clib' command, to build a C/C++ library that is included in the module distribution and needed by an extension module.� )� annotationsN)�Callable)�log)�ClassVar� )� new_compiler�show_compilers)�Command)�DistutilsSetupError)�customize_compilerc @ s� e Zd ZU dZg d�Zded< ddgZded< d d d efgZd ed < dd� Z d dd�Z d dd�Z d dd�Z dd� Z dd� Zd d d �Zd S ) � build_clibz/build C/C++ libraries used by Python extensions))z build-clib=�bz%directory to build C/C++ libraries to)z build-temp=�tz,directory to put temporary build by-products)�debug�gz"compile with debugging information)�force�fz2forcibly build everything (ignore file timestamps))z compiler=�czspecify the compiler typez$ClassVar[list[tuple[str, str, str]]]� user_optionsr r zClassVar[list[str]]�boolean_optionsz help-compilerNzlist available compilerszAClassVar[list[tuple[str, str | None, str, Callable[[], object]]]]� help_optionsc C s: d | _ d | _d | _d | _d | _d | _d | _d| _d | _d S )NF) r � build_temp� libraries� include_dirs�define�undefr r �compiler��self� r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/build_clib.py�initialize_options- s z build_clib.initialize_options�return�Nonec C sl | � dddddd� | jj| _| jr| �| j� | jd u r$| jjp"g | _t| jt�r4| j�tj �| _d S d S )N�build)r r )r r )r r )r r )r r ) �set_undefined_options� distributionr �check_library_listr � isinstance�str�split�os�pathsepr r r r �finalize_options< s � �zbuild_clib.finalize_optionsc C s� | j sd S t| j| j| jd�| _t| j� | jd ur!| j�| j� | jd ur5| jD ] \}}| j� ||� q)| j d urF| j D ]}| j� |� q=| � | j � d S )N)r �dry_runr ) r r r r. r r r �set_include_dirsr � define_macror �undefine_macro�build_libraries)r �name�value�macror r r �runW s � zbuild_clib.runc C s� t |t�s td��|D ]?}t |t�s t|�dkr td��|\}}t |t�s)td��d|v s7tjdkrAtj|v rAtd|d � d���t |t�sJtd ��q d S ) a` Ensure that the list of libraries is valid. `library` is presumably provided as a command option 'libraries'. This method checks that it is a list of 2-tuples, where the tuples are (library_name, build_info_dict). Raise DistutilsSetupError if the structure is invalid anywhere; just returns otherwise. z+'libraries' option must be a list of tuplesr z*each element of 'libraries' must a 2-tuplezNfirst element of each tuple in 'libraries' must be a string (the library name)�/zbad library name 'r z'': may not contain directory separatorszMsecond element of each tuple in 'libraries' must be a dictionary (build info)N) r( �listr �tuple�lenr) r+ �sep�dict)r r �libr3 � build_infor r r r' l s( � � ���z build_clib.check_library_listc C s, | j sd S g }| j D ] \}}|�|� q |S )N)r �append)r � lib_names�lib_name� _build_infor r r �get_library_names� s z build_clib.get_library_namesc C s^ | � | j� g }| jD ]!\}}|�d�}|d u s t|ttf�s'td|� d���|�|� q |S )N�sources� in 'libraries' option (library '�D'), 'sources' must be present and must be a list of source filenames)r' r �getr( r8 r9 r �extend)r � filenamesrA r> rD r r r �get_source_files� s � zbuild_clib.get_source_filesc C s� |D ]I\}}|� d�}|d u st|ttf�s td|� d���t|�}t�d|� |� d�}|� d�}| jj|| j ||| j d�}| jj ||| j | j d� qd S ) NrD rE rF zbuilding '%s' library�macrosr )� output_dirrK r r )rL r ) rG r( r8 r9 r r �infor �compiler r �create_static_libr )r r rA r> rD rK r �objectsr r r r2 � s* � � ��zbuild_clib.build_libraries)r" r# )�__name__� __module__� __qualname__� descriptionr �__annotations__r r r r! r- r6 r' rC rJ r2 r r r r r s � $ r )�__doc__� __future__r r+ �collections.abcr �distutils._logr �typingr � ccompilerr r �corer �errorsr � sysconfigr r r r r r �<module> s _distutils/command/__pycache__/install_headers.cpython-310.pyc 0000644 00000003525 15030122015 0020411 0 ustar 00 o �h� � @ s0 d Z ddlmZ ddlmZ G dd� de�ZdS )z�distutils.command.install_headers Implements the Distutils 'install_headers' command, to install C/C++ header files to the Python include directory.� )�ClassVar� )�Commandc @ sr e Zd ZU dZddgZeeeeeef e d< dgZ eee e d< dd� Z d d � Z d d � Z d d� Zdd� ZdS )�install_headerszinstall C/C++ header files)z install-dir=�dz$directory to install header files to)�force�fz-force installation (overwrite existing files)� user_optionsr �boolean_optionsc C s d | _ d| _g | _d S )NF)� install_dirr �outfiles��self� r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install_headers.py�initialize_options s z"install_headers.initialize_optionsc C s | � ddd� d S )N�install)r r )r r )�set_undefined_optionsr r r r �finalize_options s �z install_headers.finalize_optionsc C sH | j j}|sd S | �| j� |D ]}| �|| j�\}}| j�|� qd S �N)� distribution�headers�mkpathr � copy_filer �append)r r �header�out�_r r r �run s �zinstall_headers.runc C s | j jpg S r )r r r r r r � get_inputs* s zinstall_headers.get_inputsc C s | j S r )r r r r r � get_outputs- s zinstall_headers.get_outputsN)�__name__� __module__� __qualname__� descriptionr r �list�tuple�str�__annotations__r r r r r r r r r r r s � r N)�__doc__�typingr �corer r r r r r �<module> s _distutils/command/__pycache__/build_scripts.cpython-310.pyc 0000644 00000010617 15030122015 0020116 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl m Z ddl m Z dd lmZ e�d �Z eZG d d � d e �ZdS ) zRdistutils.command.build_scripts Implements the Distutils 'build_scripts' command.� N)�log)�ST_MODE)�ClassVar� )�newer)�Command)� convert_pathz ^#!.*python[0-9.]*([ ].*)?$c @ s� e Zd ZU dZg d�Zeeeeeef e d< dgZ eee e d< dd� Z dd � Z d d � Z d d � Zdd� Zdd� Zdd� Zdd� Zedd� �ZdS )� build_scriptsz("build" scripts (copy and fixup #! line)))z build-dir=�dz directory to "build" (copy) to)�force�fz1forcibly build everything (ignore file timestamps)z executable=�ez*specify final destination interpreter path� user_optionsr �boolean_optionsc C s d | _ d | _d | _d | _d S �N)� build_dir�scriptsr � executable��self� r �^/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/build_scripts.py�initialize_options$ s z build_scripts.initialize_optionsc C s | � dddd� | jj| _d S )N�build)r r )r r )r r )�set_undefined_options� distributionr r r r r �finalize_options* s �z build_scripts.finalize_optionsc C s | j S r )r r r r r �get_source_files3 s z build_scripts.get_source_filesc C s | j sd S | �� d S r )r � copy_scriptsr r r r �run6 s zbuild_scripts.runc C s@ | � | j� g }g }| jD ] }| �|||� q | �|� ||fS )a2 Copy each script listed in ``self.scripts``. If a script is marked as a Python script (first line matches 'shebang_pattern', i.e. starts with ``#!`` and contains "python"), then adjust in the copy the first line to refer to the current Python interpreter. )�mkpathr r � _copy_script� _change_modes)r �outfiles� updated_files�scriptr r r r ; s zbuild_scripts.copy_scriptsc C sj d }t |�}tj�| jtj�|��}|�|� | js't||�s't � d|� d S zt � |�}W n t y= | js9� d }Y nw |�� }|sN| �|� d�� d S t�|�}|�|� |r�t �d|| j� | js�|�d�pkd}d|� d�} | �| |j� t |d|jd ��} | �| � | �|�� � W d � n1 s�w Y |r�|�� d S d S |r�|�� | �||� d S ) Nznot copying %s (up-to-date)z is an empty file (skipping)z copying and adjusting %s -> %s� � z#!python� �w)�encoding) r �os�path�joinr �basename�appendr r r �debug�tokenize�open�OSError�dry_run�readline�warn�shebang_pattern�match�info�group�_validate_shebangr* �write� writelines� readlines�close� copy_file) r r% r# r$ � shebang_match�outfiler � first_line� post_interp�shebang�outfr r r r! N sH � � �zbuild_scripts._copy_scriptc C s& t jdkrd S |D ]}| �|� q d S )N�posix)r+ �name� _change_mode)r r# �filer r r r" y s �zbuild_scripts._change_modesc C s` | j r t�d|� d S t�|�t d@ }|dB d@ }||kr.t�d|||� t�||� d S d S )Nzchanging mode of %si� im z!changing mode of %s from %o to %o)r4 r r9 r+ �statr �chmod)r rJ �oldmode�newmoder r r rI � s �zbuild_scripts._change_modec C sd z| � d� W n ty td| �d���w z| � |� W d S ty1 td| �d|� d���w )Nzutf-8z The shebang (z) is not encodable to utf-8z+) is not encodable to the script encoding (�))�encode�UnicodeEncodeError� ValueError)rE r* r r r r; � s � ���z build_scripts._validate_shebangN)�__name__� __module__� __qualname__� descriptionr r �list�tuple�str�__annotations__r r r r r r r! r" rI � staticmethodr; r r r r r s " + r )�__doc__r+ �rer1 �distutils._logr rK r �typingr � _modifiedr �corer �utilr �compiler7 � first_line_rer r r r r �<module> s _distutils/command/__pycache__/clean.cpython-310.pyc 0000644 00000004235 15030122015 0016331 0 ustar 00 o �hT � @ sP d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z G dd � d e�Z dS ) zBdistutils.command.clean Implements the Distutils 'clean' command.� N)�log)�ClassVar� )�Command)� remove_treec @ sH e Zd ZU dZg d�ZdgZeee e d< dd� Z dd� Z d d � Z d S ) �cleanz-clean up temporary files from 'build' command))z build-base=�bz2base build directory [default: 'build.build-base'])z build-lib=Nz<build directory for all modules [default: 'build.build-lib'])z build-temp=�tz7temporary build directory [default: 'build.build-temp'])zbuild-scripts=Nz<build directory for scripts [default: 'build.build-scripts'])z bdist-base=Nz+temporary directory for built distributions)�all�az7remove all build output, not just temporary by-productsr �boolean_optionsc C s( d | _ d | _d | _d | _d | _d | _d S )N)� build_base� build_lib� build_temp� build_scripts� bdist_baser ��self� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/clean.py�initialize_options$ s zclean.initialize_optionsc C s" | � ddddd� | � dd� d S )N�build)r r )r r )r r )r r �bdist)r r )�set_undefined_optionsr r r r �finalize_options, s �zclean.finalize_optionsc C s� t j�| j�rt| j| jd� nt�d| j� | jr9| j | j | j fD ]}t j�|�r2t|| jd� q"t� d|� q"| jsWzt � | j� t�d| j� W d S tyV Y d S w d S )N)�dry_runz%'%s' does not exist -- can't clean itz removing '%s')�os�path�existsr r r r �debugr r r r �warning�rmdirr �info�OSError)r � directoryr r r �run6 s ��z clean.runN) �__name__� __module__� __qualname__� description� user_optionsr r �list�str�__annotations__r r r% r r r r r s r ) �__doc__r �distutils._logr �typingr �corer �dir_utilr r r r r r �<module> s _distutils/command/__pycache__/build_py.cpython-310.pyc 0000644 00000023356 15030122015 0017063 0 ustar 00 o �h8A � @ sx d Z ddlZddlZddlZddlZddlmZ ddlm Z ddl m Z ddl m Z mZ ddlmZ G d d � d e �ZdS ) zHdistutils.command.build_py Implements the Distutils 'build_py' command.� N)�log)�ClassVar� )�Command)�DistutilsFileError�DistutilsOptionError)� convert_pathc @ s e Zd ZU dZg d�ZddgZeee e d< ddiZ ee eef e d< dd � Z d2d d �Z d2dd�Zdd� Zdd� Zd2dd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd3d'ed ee fd(d)�Zd*d+� Z d2d,d-�Z d2d.d/�Z d2d0d1�Z d S )4�build_pyz5"build" pure Python modules (copy to build directory)))z build-lib=�dz directory to "build" (copy) to)�compile�czcompile .py to .pyc)� no-compileNz!don't compile .py files [default])z optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])�force�fz2forcibly build everything (ignore file timestamps)r r �boolean_optionsr � negative_optc C s4 d | _ d | _d | _d | _d | _d| _d| _d | _d S )NFr )� build_lib� py_modules�package� package_data� package_dirr �optimizer ��self� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/build_py.py�initialize_options$ s zbuild_py.initialize_options�returnNc C s� | � ddd� | jj| _| jj| _| jj| _i | _| jjr/| jj�� D ] \}}t|�| j|< q#| �� | _ t | j t �s`zt | j �| _ d| j krMdksPJ � J �W d S t tfy_ td��w d S )N�build)r r )r r r r zoptimize must be 0, 1, or 2)�set_undefined_options� distribution�packagesr r r �itemsr �get_data_files� data_files� isinstancer �int� ValueError�AssertionErrorr )r �name�pathr r r �finalize_options. s& � $��zbuild_py.finalize_optionsc C s: | j r| �� | jr| �� | �� | �| jdd�� d S )NF)�include_bytecode)r � build_modulesr" �build_packages�build_package_data� byte_compile� get_outputsr r r r �runG s z build_py.runc s� g }| j s|S | j D ]4}| �|�}tjj| jg|�d� � }d� |r(t|�d � � fdd�| �||�D �}|� ||||f� q |S )z?Generate list of '(package,src_dir,build_dir,filenames)' tuples�.r � c s g | ]}|� d � �qS �Nr )�.0�file��plenr r � <listcomp>w s z+build_py.get_data_files.<locals>.<listcomp>) r" �get_package_dir�osr+ �joinr �split�len�find_data_files�append)r �datar �src_dir� build_dir� filenamesr r9 r r$ e s zbuild_py.get_data_filesc sd | j �dg �| j �|g � }g � |D ] }t�tj�t�|�t|���}� �� fdd�|D �� q� S )z6Return filenames for package's data files in 'src_dir'� c s$ g | ]}|� vrt j�|�r|�qS r )r= r+ �isfile)r7 �fn��filesr r r; � s z,build_py.find_data_files.<locals>.<listcomp>) r �get�globr= r+ r> �escaper �extend)r r rD �globs�pattern�filelistr rJ r rA { s � �zbuild_py.find_data_filesc C s\ | j D ](\}}}}|D ] }tj�||�}| �tj�|�� | jtj�||�|dd� q qdS )z$Copy data files into build directoryF�� preserve_modeN)r% r= r+ r> �mkpath�dirname� copy_file)r �_packagerD rE rF �filename�targetr r r r0 � s ���zbuild_py.build_package_datac C s� |� d�}| js|rtjj|� S dS g }|rCz | jd�|� }W n ty4 |�d|d � |d= Y n w |�d|� tjj|� S |s| j�d�}|durS|�d|� |r[tjj|� S dS )z�Return the directory, relative to the top of the source distribution, where package 'package' should be found (at least according to the 'package_dir' option, if any).r4 rG r ���N)r? r r= r+ r> �KeyError�insertrL )r r r+ �tail�pdirr r r r< � s, � � zbuild_py.get_package_dirc C sf |dkr t j�|�std|� d���t j�|�s td|� d���|r1t j�|d�}t j�|�r1|S d S )NrG zpackage directory 'z' does not existz supposed package directory 'z ' exists, but is not a directoryz __init__.py)r= r+ �existsr �isdirr> rH )r r r �init_pyr r r � check_package� s � � zbuild_py.check_packagec C s" t j�|�st�d||� dS dS )Nz!file %s (for module %s) not foundFT)r= r+ rH r �warning)r �module� module_filer r r � check_module� s zbuild_py.check_modulec C s� | � ||� t�tj�t�|�d��}g }tj�| jj�}|D ])}tj�|�}||kr@tj� tj� |��d }|� |||f� q | � d|� �� q |S )Nz*.pyr z excluding ) rc rM r= r+ r> rN �abspathr! � script_name�splitext�basenamerB � debug_print) r r r � module_files�modules� setup_scriptr �abs_fre r r r �find_package_modules� s z build_py.find_package_modulesc C s� i }g }| j D ]]}|�d�}d�|dd� �}|d }z|| \}}W n ty3 | �|�}d}Y nw |sL| �||�} |df||< | rL|�|d| f� tj�||d �} | � || �s\q|�||| f� q|S )a� Finds individually-specified Python modules, ie. those listed by module name in 'self.py_modules'. Returns a list of tuples (package, module_base, filename): 'package' is a tuple of the path through package-space to the module; 'module_base' is the bare (no packages, no dots) module name, and 'filename' is the path to the ".py" file (relative to the distribution root) that implements the module. r4 r r[ Fr5 �__init__�.py) r r? r> r\ r< rc rB r= r+ rg ) r r" rn re r+ r � module_baser �checkedrb rf r r r � find_modules� s, � zbuild_py.find_modulesc C sN g }| j r |�| �� � | jr%| jD ]}| �|�}| �||�}|�|� q|S )a4 Compute the list of all modules that will be built, whether they are specified one-module-at-a-time ('self.py_modules') or by whole packages ('self.packages'). Return a list of tuples (package, module, module_file), just like 'find_modules()' and 'find_package_modules()' do.)r rO rv r" r< rq )r rn r r �mr r r �find_all_modules s zbuild_py.find_all_modulesc C s dd� | � � D �S )Nc S s g | ]}|d �qS )r[ r )r7 re r r r r; 0 s z-build_py.get_source_files.<locals>.<listcomp>)rx r r r r �get_source_files/ s zbuild_py.get_source_filesc C s$ |gt |� |d g }tjj|� S )Nrs )�listr= r+ r> )r rE r re � outfile_pathr r r �get_module_outfile2 s zbuild_py.get_module_outfileTr- c C s� | � � }g }|D ]8\}}}|�d�}| �| j||�}|�|� |r@| jr/|�tjj|dd�� | j dkr@|�tjj|| j d�� q|dd� | j D �7 }|S )Nr4 rG )� optimizationr c S s, g | ]\}}}}|D ] }t j�||��q qS r )r= r+ r> )r7 r rD rE rF rY r r r r; I s � ��z(build_py.get_outputs.<locals>.<listcomp>) rx r? r| r rB r � importlib�util�cache_from_sourcer r% )r r- rn �outputsr re � _module_filerY r r r r2 6 s, � ����zbuild_py.get_outputsc C sb t |t�r |�d�}n t |ttf�std��| �| j||�}tj � |�}| � |� | j ||dd�S )Nr4 z:'package' must be a string (dot-separated), list, or tupleFrS ) r& �strr? rz �tuple� TypeErrorr| r r= r+ rV rU rW )r re rf r �outfile�dirr r r � build_moduleQ s � zbuild_py.build_modulec C s* | � � }|D ] \}}}| �|||� qd S r6 )rv r� )r rn r re rf r r r r. a s �zbuild_py.build_modulesc C sP | j D ]"}| �|�}| �||�}|D ]\}}}||ks J �| �|||� qqd S r6 )r" r< rq r� )r r r rn �package_re rf r r r r/ j s ��zbuild_py.build_packagesc C s� t jr | �d� d S ddlm} | j}|d tjkr |tj }| jr-||d| j || j d� | j dkr@||| j | j || j d� d S d S )Nz%byte-compiling is disabled, skipping.r )r1 r[ r )r r �prefix�dry_run) �sys�dont_write_bytecode�warnr r1 r r= �sepr r r� r )r rK r1 r� r r r r1 ~ s( � ��zbuild_py.byte_compile)r N)T) �__name__� __module__� __qualname__� description� user_optionsr r rz r� �__annotations__r �dictr r, r3 r$ rA r0 r< rc rg rq rv rx ry r| �boolr2 r� r. r/ r1 r r r r r s0 '4 r )�__doc__rM �importlib.utilr~ r= r� �distutils._logr �typingr �corer �errorsr r r r r r r r r �<module> s _distutils/command/__pycache__/_framework_compat.cpython-310.pyc 0000644 00000003560 15030122015 0020746 0 ustar 00 o �hI � @ sr d Z ddlZddlZddlZddlZddlZejdd� �Zeeddddd d d d d �d�Z ejdd� �Z dd� Z dS )z6 Backward compatibility for homebrew builds on macOS. � Nc C sh dt j k o dk n } t jdkot j}dt�d�v }t jt jk}tj � d�}| o3|o3|o3| o3| S )z^ Only enabled for Python 3.9 framework homebrew builds except ensurepip and venv. )� � )r � �darwin�Cellar� projectbase�ENSUREPIP_OPTIONS) �sys� version_info�platform� _framework� sysconfig�get_config_var�prefix� base_prefix�os�environ�get)�PY39� framework�homebrew�venv� ensurepip� r �b/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/_framework_compat.py�enabled s r z6{installed_base}/{platlibdir}/python{py_version_short}z0{platbase}/{platlibdir}/python{py_version_short}z<{homebrew_prefix}/lib/python{py_version_short}/site-packageszE{homebrew_prefix}/{platlibdir}/python{py_version_short}/site-packagesz;{installed_base}/include/python{py_version_short}{abiflags}z?{installed_platbase}/include/python{py_version_short}{abiflags}z{homebrew_prefix}/binz{homebrew_prefix})�stdlib� platstdlib�purelib�platlib�include� platinclude�scripts�data)�osx_framework_libraryc C s& t � si S tjddgdd��� } t� S )N�brewz--prefixT)�text)r � subprocess� check_output�strip�locals)�homebrew_prefixr r r �vars( s r, c C s t � r| �d�s | S dS )z8 Override the selected scheme for posix_prefix. �_prefixr$ )r �endswith)�namer r r �scheme0 s r0 ) �__doc__� functoolsr r' r r � lru_cacher �dict�schemesr, r0 r r r r �<module> s. �� _distutils/command/__pycache__/build.cpython-310.pyc 0000644 00000010047 15030122015 0016344 0 ustar 00 o �h# � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl m Z ddl m Z dd lmZ dd lmZ G d d � d e �ZdS ) zBdistutils.command.build Implements the Distutils 'build' command.� )� annotationsN)�Callable)�ClassVar� )�show_compilers)�Command)�DistutilsOptionError)� get_platformc @ s� e Zd ZU dZdddddddd d e� � d �fd d dddg ZddgZded< dddefgZ ded< dd� Z d.d d �Z d.d d!�Z d"d#� Z d$d%� Zd&d'� Zd(d)� Zd*e fd+efd,efd-efgZdS )/�buildz"build everything needed to install)z build-base=�bz base directory for build library)zbuild-purelib=Nz2build directory for platform-neutral distributions)zbuild-platlib=Nz3build directory for platform-specific distributions)z build-lib=NzWbuild directory for all distribution (defaults to either build-purelib or build-platlib)zbuild-scripts=Nzbuild directory for scripts)z build-temp=�tztemporary build directoryz plat-name=�pz3platform name to build for, if supported [default: �])z compiler=�czspecify the compiler type)z parallel=�jz number of parallel build jobs)�debug�gz;compile extensions and libraries with debugging information)�force�fz2forcibly build everything (ignore file timestamps))z executable=�ez5specify final destination interpreter path (build.py)r r zClassVar[list[str]]�boolean_optionsz help-compilerNzlist available compilerszAClassVar[list[tuple[str, str | None, str, Callable[[], object]]]]� help_optionsc C sL d| _ d | _d | _d | _d | _d | _d | _d | _d | _d| _ d | _ d | _ d S )Nr F) � build_base� build_purelib� build_platlib� build_lib� build_temp� build_scripts�compiler� plat_namer r � executable�parallel��self� r$ �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/build.py�initialize_options3 s zbuild.initialize_options�return�Nonec C sl | j d u r t� | _ n tjdkrtd��d| j � dtjj� �}t� d�r'|d7 }t td�r0|d7 }| j d u r>tj � | jd �| _ | jd u rNtj � | jd | �| _| jd u ra| j�� r]| j| _n| j | _| jd u rqtj � | jd | �| _| jd u r�tj � | jd tjj� dtjj� ��| _| jd u r�tjr�tj �tj�| _t| jt �r�z t | j�| _W d S t y� td ��w d S ) N�ntzW--plat-name only supported on Windows (try using './configure --help' on your platform)�.�-�Py_GIL_DISABLEDr �gettotalrefcountz-pydebug�lib�tempzscripts-z parallel should be an integer) r r �os�namer �sys�implementation� cache_tag� sysconfig�get_config_var�hasattrr �path�joinr r r � distribution�has_ext_modulesr r � version_info�major�minorr �normpath� isinstancer! �str�int� ValueError)r# �plat_specifierr$ r$ r% �finalize_optionsC sF � � ��zbuild.finalize_optionsc C s | � � D ]}| �|� qd S �N)�get_sub_commands� run_command)r# �cmd_namer$ r$ r% �run� s �z build.runc C � | j �� S rF )r: �has_pure_modulesr" r$ r$ r% rL � � zbuild.has_pure_modulesc C rK rF )r: �has_c_librariesr" r$ r$ r% rN � rM zbuild.has_c_librariesc C rK rF )r: r; r" r$ r$ r% r; � rM zbuild.has_ext_modulesc C rK rF )r: � has_scriptsr" r$ r$ r% rO � rM zbuild.has_scripts�build_py� build_clib� build_extr )r' r( )�__name__� __module__� __qualname__� descriptionr � user_optionsr �__annotations__r r r& rE rJ rL rN r; rO � sub_commandsr$ r$ r$ r% r sB �� � = �r )�__doc__� __future__r r0 r2 r5 �collections.abcr �typingr � ccompilerr �corer �errorsr �utilr r r$ r$ r$ r% �<module> s _distutils/command/__pycache__/config.cpython-310.pyc 0000644 00000024334 15030122015 0016516 0 ustar 00 o �h2 � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl m Z m Z m Z mZ ddlmZ dd lmZ dd lmZ d d d �ZG dd� de�Zddd�ZdS )a� distutils.command.config Implements the Distutils 'config' command, a (mostly) empty command class that exists mainly to be sub-classed by specific module distributions and applications. The idea is that while every "config" command is different, at least they're all named the same, and users always see "config" in the list of standard commands. Also, this is a good place to put common configure-like tasks: "try to compile this C code", or "figure out where this header file lives". � )� annotationsN)�Sequence)�log� )� CCompiler� CompileError� LinkError� new_compiler)�Command)�DistutilsExecError)�customize_compilerz.cz.cxx)�czc++c @ s� e Zd ZdZg d�Zdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z d*dd�Zd*dd�Zd+dd �Z d,d d �Z d,d d �Z ! !d-d"d#�Zdddg fd.d&d'�Zd+d(d)�ZdS )/�configzprepare to build) )z compiler=Nzspecify the compiler type)zcc=Nz specify the compiler executable)z include-dirs=�Iz.list of directories to search for header files)zdefine=�Dz C preprocessor macros to define)zundef=�Uz!C preprocessor macros to undefine)z libraries=�lz!external C libraries to link with)z library-dirs=�Lz.directories to search for external C libraries)�noisyNz1show every action (compile, link, run, ...) taken)z dump-sourceNz=dump generated source files before attempting to compile themc C s4 d | _ d | _d | _d | _d | _d| _d| _g | _d S )N� )�compiler�cc� include_dirs� libraries� library_dirsr � dump_source� temp_files��self� r �W/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/config.py�initialize_options2 s zconfig.initialize_optionsc C s� | j d u r | jj p g | _ nt| j t�r| j �tj�| _ | jd u r$g | _n t| jt�r/| jg| _| jd u r9g | _d S t| jt�rI| j�tj�| _d S d S �N) r � distribution� isinstance�str�split�os�pathsepr r r r r r �finalize_optionsA s �zconfig.finalize_optionsc C s d S r" r r r r r �runQ s z config.runc C sr t | jt�s5t| j| jdd�| _t| j� | jr | j�| j� | jr)| j� | j� | j r7| j� | j � dS dS dS )z^Check that 'self.compiler' really is a CCompiler object; if not, make it one. T)r �dry_run�forceN) r$ r r r r+ r r �set_include_dirsr � set_librariesr �set_library_dirsr r r r �_check_compilerX s � � zconfig._check_compilerc C s� dt | }t|ddd��6}|r#|D ] }|�d|� d�� q|�d� |�|� |d dkr;|�d� W d � |S W d � |S 1 sFw Y |S ) N� _configtest�w�utf-8��encodingz #include <z> � ���)�LANG_EXT�open�write)r �body�headers�lang�filename�file�headerr r r �_gen_temp_sourcefilej s �� ��zconfig._gen_temp_sourcefilec C s< | � |||�}d}| j�||g� | jj|||d� ||fS )Nz _configtest.i�r )rA r �extendr � preprocess)r r; r< r r= �src�outr r r � _preprocessv s zconfig._preprocessc C s` | � |||�}| jrt|d|� d�� | j�|g�\}| j�||g� | jj|g|d� ||fS )Nz compiling 'z':rB )rA r � dump_filer �object_filenamesr rC �compile)r r; r< r r= rE �objr r r �_compile} s zconfig._compilec C sr | � ||||�\}}tj�tj�|��d } | jj|g| |||d� | jjd ur.| | jj } | j� | � ||| fS )Nr )r r � target_lang) rL r' �path�splitext�basenamer �link_executable� exe_extensionr �append) r r; r< r r r r= rE rK �progr r r �_link� s � z config._linkc G sP |s| j }g | _ t�dd�|�� |D ]}zt�|� W q ty% Y qw d S )Nz removing: %s� )r r �info�joinr' �remove�OSError)r � filenamesr> r r r �_clean� s ��z config._cleanNr c C sD | � � d}z | �||||� W n ty d}Y nw | �� |S )aQ Construct a source file from 'body' (a string containing lines of C/C++ code) and 'headers' (a list of header files to include) and run it through the preprocessor. Return true if the preprocessor succeeded, false if there were any errors. ('body' probably isn't of much use, but what the heck.) TF)r0 rG r r\ �r r; r< r r= �okr r r �try_cpp� s �zconfig.try_cppc s~ | � � | �||||�\}}t� t�rt�� �� t|dd��}t� fdd�|D ��} W d � n1 s4w Y | �� | S )a� Construct a source file (just like 'try_cpp()'), run it through the preprocessor, and return true if any line of the output matches 'pattern'. 'pattern' should either be a compiled regex object or a string containing a regex. If both 'body' and 'headers' are None, preprocesses an empty file -- which can be useful to determine the symbols the preprocessor and compiler set by default. r3 r4 c 3 s � | ]}� � |�V qd S r" )�search)�.0�line��patternr r � <genexpr>� s � z$config.search_cpp.<locals>.<genexpr>N) r0 rG r$ r% �rerJ r9 �anyr\ ) r rd r; r< r r= rE rF r? �matchr rc r � search_cpp� s �zconfig.search_cppc C sV | � � z | �||||� d}W n ty d}Y nw t�|r"dp#d� | �� |S )zwTry to compile a source file built from 'body' and 'headers'. Return true on success, false otherwise. TF�success!�failure.)r0 rL r r rW r\ r] r r r � try_compile� s �zconfig.try_compilec C s^ | � � z| �||||||� d}W n ttfy d}Y nw t�|r&dp'd� | �� |S )z�Try to compile and link a source file, built from 'body' and 'headers', to executable form. Return true on success, false otherwise. TFrj rk )r0 rU r r r rW r\ )r r; r< r r r r= r^ r r r �try_link� s �zconfig.try_linkc C sr | � � z| �||||||�\}}} | �| g� d} W n tttfy) d} Y nw t�| r0dp1d� | �� | S )z�Try to compile, link to an executable, and run a program built from 'body' and 'headers'. Return true on success, false otherwise. TFrj rk ) r0 rU �spawnr r r r rW r\ ) r r; r< r r r r= rE rK �exer^ r r r �try_run� s � �zconfig.try_runFc C s� | � � g }|r|�d|� d�� |�d� |r"|�d|� d�� n |�d|� d�� |�d� d�|�d }| �|||||�S ) a� Determine if function 'func' is available by constructing a source file that refers to 'func', and compiles and links it. If everything succeeds, returns true; otherwise returns false. The constructed source file starts out by including the header files listed in 'headers'. If 'decl' is true, it then declares 'func' (as "int func()"); you probably shouldn't supply 'headers' and set 'decl' true in the same call, or you might get errors about a conflicting declarations for 'func'. Finally, the constructed 'main()' function either references 'func' or (if 'call' is true) calls it. 'libraries' and 'library_dirs' are used when linking. zint z ();z int main () {z z();�;�}r6 )r0 rS rX rm ) r �funcr< r r r �decl�callr; r r r � check_func s zconfig.check_func�other_libraries� Sequence[str]c C s$ | � � | �d|||gt|� |�S )a� Determine if 'library' is available to be linked against, without actually checking that any particular symbols are provided by it. 'headers' will be used in constructing the source file to be compiled, but the only effect of this is to check if all the header files listed are available. Any libraries listed in 'other_libraries' will be included in the link, in case 'library' has symbols that depend on other libraries. zint main (void) { })r0 rm �list)r �libraryr r< r rw r r r � check_lib< s �zconfig.check_libc C s | j d|g|d�S )z�Determine if the system header file named by 'header_file' exists and can be found by the preprocessor; return true if so, false otherwise. z /* No body */)r; r< r )r_ )r r@ r r r= r r r � check_headerU s �zconfig.check_header)NNNr )NNr )NNNNr )NNNNFF)rw rx )�__name__� __module__� __qualname__� description� user_optionsr! r) r* r0 rA rG rL rU r\ r_ ri rl rm rp rv r{ r| r r r r r sP � �" �( �r c C s< |du r t �d| � nt �|� t �t�| �jdd�� dS )zjDumps a file content into log.info. If head is not None, will be dumped before the file content. Nz%sr3 r4 )r rW �pathlib�Path� read_text)r> �headr r r rH _ s rH r" )�__doc__� __future__r r' r� rf �collections.abcr �distutils._logr � ccompilerr r r r �corer �errorsr � sysconfigr r8 r rH r r r r �<module> s E _distutils/command/__pycache__/bdist_rpm.cpython-310.pyc 0000644 00000030176 15030122015 0017235 0 ustar 00 o �hU � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl m Z ddl m Z mZmZmZ dd lmZ dd lmZ G d d � d e �ZdS ) zwdistutils.command.bdist_rpm Implements the Distutils 'bdist_rpm' command (create RPM source and binary distributions).� N)�log)�ClassVar� )�Command)�DEBUG)�DistutilsExecError�DistutilsFileError�DistutilsOptionError�DistutilsPlatformError)� write_file)�get_python_versionc @ s� e Zd ZU dZg d�Zg d�Zeee e d< dddd�Z ee eef e d < d d � Z ddd�Z ddd�Zddd�Zdd� Zdd� Zdd� Zd S )� bdist_rpmzcreate an RPM distribution)))z bdist-base=Nz/base directory for creating built distributions)z rpm-base=Nzdbase directory for creating RPMs (defaults to "rpm" under --bdist-base; must be specified for RPM 2))z dist-dir=�dzDdirectory to put final RPM files in (and .spec files if --spec-only))zpython=NzMpath to Python interpreter to hard-code in the .spec file [default: "python"])z fix-pythonNzLhard-code the exact path to the current Python interpreter in the .spec file)z spec-onlyNzonly regenerate spec file)z source-onlyNzonly generate source RPM)z binary-onlyNzonly generate binary RPM)z use-bzip2Nz7use bzip2 instead of gzip to create source distribution)zdistribution-name=Nzgname of the (Linux) distribution to which this RPM applies (*not* the name of the module distribution!))zgroup=Nz9package classification [default: "Development/Libraries"])zrelease=NzRPM release number)zserial=NzRPM serial number)zvendor=NzaRPM "vendor" (eg. "Joe Blow <joe@example.com>") [default: maintainer or author from setup script])z packager=NzBRPM packager (eg. "Jane Doe <jane@example.net>") [default: vendor])z doc-files=Nz6list of documentation files (space or comma-separated))z changelog=Nz RPM changelog)zicon=Nzname of icon file)z provides=Nz%capabilities provided by this package)z requires=Nz%capabilities required by this package)z conflicts=Nz-capabilities which conflict with this package)zbuild-requires=Nz+capabilities required to build this package)z obsoletes=Nz*capabilities made obsolete by this package)� no-autoreqNz+do not automatically calculate dependencies)� keep-temp�kz"don't clean up RPM build directory)� no-keep-tempNz&clean up RPM build directory [default])�use-rpm-opt-flagsNz8compile with RPM_OPT_FLAGS when building from source RPM)�no-rpm-opt-flagsNz&do not pass any RPM CFLAGS to compiler)� rpm3-modeNz"RPM 3 compatibility mode (default))� rpm2-modeNzRPM 2 compatibility mode)z prep-script=Nz3Specify a script for the PREP phase of RPM building)z build-script=Nz4Specify a script for the BUILD phase of RPM building)z pre-install=Nz:Specify a script for the pre-INSTALL phase of RPM building)zinstall-script=Nz6Specify a script for the INSTALL phase of RPM building)z post-install=Nz;Specify a script for the post-INSTALL phase of RPM building)zpre-uninstall=Nz<Specify a script for the pre-UNINSTALL phase of RPM building)zpost-uninstall=Nz=Specify a script for the post-UNINSTALL phase of RPM building)z clean-script=Nz4Specify a script for the CLEAN phase of RPM building)zverify-script=Nz6Specify a script for the VERIFY phase of the RPM build)z force-arch=Nz0Force an architecture onto the RPM build process)�quiet�qz3Run the INSTALL phase of RPM building in quiet mode)r r r r r �boolean_optionsr r r )r r r � negative_optc C s� d | _ d | _d | _d | _d | _d | _d | _d | _d | _d | _ d | _ d | _ d | _ d | _ d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _d | _ d | _ d | _ d | _ d | _ d| _!d| _"d| _#d| _$d | _%d| _&d S )NFT)'� bdist_base�rpm_base�dist_dir�python� fix_python� spec_only� binary_only� source_only� use_bzip2�distribution_name�group�release�serial�vendor�packager� doc_files� changelog�icon� prep_script� build_script�install_script� clean_script� verify_script� pre_install� post_install� pre_uninstall�post_uninstall�prep�provides�requires� conflicts�build_requires� obsoletes� keep_temp�use_rpm_opt_flags� rpm3_mode� no_autoreq� force_archr ��self� rC �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/bdist_rpm.py�initialize_options� sN z bdist_rpm.initialize_options�returnNc C s� | � dd� | jd u r| jstd��tj�| jd�| _| jd u r,| j r(t j | _n d| _n| j r3td��tj dkr@t dtj � ���| jrJ| jrJtd ��| j�� sRd | _| � dd � | �� d S ) N�bdist)r r z)you must specify --rpm-base in RPM 2 mode�rpm�python3z8--python and --fix-python are mutually exclusive options�posixz7don't know how to create RPM distributions on platform z6cannot supply both '--source-only' and '--binary-only'F)r r )�set_undefined_optionsr r> r �os�path�joinr r r �sys� executable�namer r! r" � distribution�has_ext_modulesr= �finalize_package_datarA rC rC rD �finalize_options� s2 � � � zbdist_rpm.finalize_optionsc C sX | � dd� | � d| j�� � d| j�� � d�� | � d� | �d� t| jt�r>dD ]}tj � |�r=|| jvr=| j� |� q*| � d d � | � d � | � d � | � d � | � | j �| _ | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d� | �d � | � d � d S ) Nr% zDevelopment/Librariesr( z <�>r) r* )�READMEz README.txtr& �1r' r$ r+ r, r- r. r/ r0 r1 r2 r3 r4 r5 r7 r8 r9 r: r; r@ )� ensure_stringrR � get_contact�get_contact_email�ensure_string_list� isinstancer* �listrL rM �exists�append�_format_changelogr+ �ensure_filename)rB �readmerC rC rD rT � sB � � z bdist_rpm.finalize_package_datac C s� t r td� td| j� td| j� td| j� td| j� | jr*| j}| �|� n i }dD ]}t j � | j |�||< | �|| � q.|d }t j � || j �� � d��}| �t|| �� fd |� d �� | jrgd S | j jd d � }| �d �}| jr|d g|_nd g|_| �d � || j _|�� d }|d }| �||� | jr�t j �| j�r�| �| j|� n td| j� d���t � d� dg} | j r�| � d� n| j r�| � d� n| � d� | �!dd| j"� �g� | j#r�| �!ddt j �$| j �� �g� | j%s�| � d� | j&�r| � d� | � |� d } | d } d | d } d | � d!| � d"|� d �} t �'| �}zBg }d } |�(� }|�s1n!|�)� �*� }t+|�d$k�s@J �|� |d% � |d u �rP|d }�q)|�,� }|�r`t-d&| ����W |�,� n|�,� w | �.| � | j/�s�| j �0� �r~t1� }nd'}| j �s�t j � |d( |�}t j �|��s�J �| �2|| j� t j � | j|�}| j j� d)||f� | j �s�|D ]4}t j � |d* |�}t j �|��r�| �2|| j� t j � | jt j �3|��}| j j� d)||f� �q�d S d S d S )+Nzbefore _get_package_data():zvendor =z packager =z doc_files =z changelog =)�SOURCES�SPECS�BUILD�RPMS�SRPMSre z.specz writing '�'�sdist�bztar�gztarr rd z icon file 'z' does not existz building RPMs�rpmbuildz-bsz-bbz-baz--definez __python z_topdir z--cleanz--quietz %{name}-%{version}-%{release}z.src.rpmz%{arch}/z .%{arch}.rpmz rpm -q --qf '� z\n' --specfile 'Tr � zFailed to execute: �anyrh r rg )4r �printr( r) r* r+ r r �mkpathrL rM rN r rR �get_name�executer �_make_spec_file� dist_files�reinitialize_commandr# �formats� run_command�get_archive_files� copy_filer, r_ r r �infor" r` r! �extendr r> �abspathr< r �popen�readline�strip�split�len�closer �spawn�dry_runrS r � move_file�basename)rB �spec_dir�rpm_dirr � spec_path�saved_dist_filesrj �source� source_dir�rpm_cmd� nvr_string�src_rpm� non_src_rpm�q_cmd�out� binary_rpms� source_rpm�line�ell�status� pyversion�srpm�filenamerH rC rC rD �run s� � � � ��� z bdist_rpm.runc C s t j�| jt j�|��S )N)rL rM rN r r� )rB rM rC rC rD � _dist_path� s zbdist_rpm._dist_pathc C s` d| j �� d| j �� �dd� d| j �� d| j�dd� dd| j �� p&d g}t�d �}d �d d � |� � D ��}d}d}|�||�}||krV|� d� |� d| d � |� g d�� | j rf|� d� n|� d� |� d| j � � ptd d| j ddg� | js�| j �� s�|� d� n |� d| j� �� dD ])}t| |�� �}t|t�r�|� d �|d �|��� q�|d ur�|� |� d |� �� q�| j �� r�|� d | j �� � | jr�|� d!| j � | jr�|� d"d �| j� � | jr�|� d#tj� | j� � | j �r|� d$� |� dd%| j � � �p dg� | j � d tj� t j!d& �� �}|� d'�} | j"�r+d(| } |� d)�} d*d+d,| fd-d.| fd/d0d1d2d3d4g } | D ]C\} } }t| | �}|�sS|�r�|� dd5| g� |�r�t#|��}|� |�$� �%d �� W d � n 1 �syw Y �qC|� |� �qC|� g d6�� | j&�r�|� d7d �| j&� � | j'�r�|� dd8g� |� | j'� |S )9ziGenerate the text of an RPM spec file and return it as a list of strings (one per line). z %define name z%define version �-�_z%define unmangled_version z%define release � z Summary: �UNKNOWNz rpm --eval %{__os_install_post}� c S s g | ] }d |� � � d��qS )� z \)r� )�.0r� rC rC rD � <listcomp>� s �z-bdist_rpm._make_spec_file.<locals>.<listcomp>zbrp-python-bytecompile \ z%brp-python-bytecompile %{__python} \ z3# Workaround for https://bugs.python.org/issue14443z%define __os_install_post )z Name: %{name}zVersion: %{version}zRelease: %{release}z-Source0: %{name}-%{unmangled_version}.tar.bz2z,Source0: %{name}-%{unmangled_version}.tar.gzz License: zGroup: z>BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-buildrootzPrefix: %{_prefix}zBuildArch: noarchz BuildArch: )�Vendor�Packager�Provides�Requires� Conflicts� Obsoletesz{}: {}rn Nz: zUrl: zDistribution: zBuildRequires: zIcon: z AutoReq: 0z %descriptionr z buildz env CFLAGS="$RPM_OPT_FLAGS" z< install -O1 --root=$RPM_BUILD_ROOT --record=INSTALLED_FILES)r6 r- z&%setup -n %{name}-%{unmangled_version}�buildr. �installr/ )�cleanr0 zrm -rf $RPM_BUILD_ROOT)� verifyscriptr1 N)�prer2 N)�postr3 N)�preunr4 N)�postunr5 N�%)r� z%files -f INSTALLED_FILESz%defattr(-,root,root)z%doc z %changelog)(rR rs � get_version�replacer& �get_description� subprocess� getoutputrN � splitlinesr` r} r# � get_licenser% r@ rS �getattr�lowerr] r^ �format�get_urlr$ r: r, rL rM r� r? �get_long_descriptionr rO �argvr= �open�readr� r* r+ )rB � spec_file� vendor_hook�problem�fixed� fixed_hook�field�val�def_setup_call� def_build� install_cmd�script_options�rpm_opt�attr�default�frC rC rD ru � s� � � � � � � � � �� �� zbdist_rpm._make_spec_filec C s| |s|S g }|� � �d�D ]'}|� � }|d dkr!|�d|g� q |d dkr-|�|� q |�d| � q |d s<|d= |S )zBFormat the changelog correctly and convert it to a list of stringsr� r �*r� r� r� )r� r� r} r` )rB r+ � new_changelogr� rC rC rD ra D s zbdist_rpm._format_changelog)rF N)�__name__� __module__� __qualname__� description� user_optionsr r r^ �str�__annotations__r �dictrE rU rT r� r� ru ra rC rC rC rD r s" q � - ! . ,r )�__doc__rL r� rO �distutils._logr �typingr �corer �debugr �errorsr r r r � file_utilr � sysconfigr r rC rC rC rD �<module> s _distutils/command/__pycache__/install.cpython-310.pyc 0000644 00000041163 15030122015 0016716 0 ustar 00 o �hxu � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlmZ ddlmZ dd lmZ dd lmZmZ dd lmZ dd lmZ dd lmZm Z m Z m Z ddl m Z! dZ"dddddd�Z#dddddd�ddd ddd�e#d d d ddd�d d d ddd�d �Z$e"r�d d d!d"d#d�e$d$< d d d%d&d#d�e$d'< e$�%e!j&� dZ'd(d)� Z(d*d+� Z)d,d-� Z*d.d/� Z+d0d1� Z,d2d3� Z-d4d5� Z.d6d7� Z/d8d9� Z0G d:d;� d;e�Z1dS )<zFdistutils.command.install Implements the Distutils 'install' command.� )� annotationsN)�log)� USER_BASE� USER_SITE)�ClassVar� )�Command)�DEBUG)�DistutilsOptionError�DistutilsPlatformError)� write_file)�get_config_vars)� change_root� convert_path� get_platform� subst_vars� )�_framework_compatTz{base}/Lib/site-packagesz{base}/Include/{dist_name}z{base}/Scriptsz{base})�purelib�platlib�headers�scripts�datazA{base}/lib/{implementation_lower}{py_version_short}/site-packageszN{platbase}/{platlibdir}/{implementation_lower}{py_version_short}/site-packageszM{base}/include/{implementation_lower}{py_version_short}{abiflags}/{dist_name}z {base}/binz!{base}/lib/{implementation_lower}z*{base}/{platlibdir}/{implementation_lower}z1{base}/include/{implementation_lower}/{dist_name}z{base}/site-packagesz{base}/include/{dist_name})� posix_prefix� posix_home�nt�pypy�pypy_ntz {usersite}zF{userbase}/{implementation}{py_version_nodot_plat}/Include/{dist_name}z:{userbase}/{implementation}{py_version_nodot_plat}/Scriptsz {userbase}�nt_userzQ{userbase}/include/{implementation_lower}{py_version_short}{abiflags}/{dist_name}z{userbase}/bin� posix_userc C s@ t �t�� dd� t�� D �W d � S 1 sw Y d S )Nc S s i | ] }|t j|d d��qS )F)�expand)� sysconfig� get_paths��.0�scheme� r& �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install.py� <dictcomp>e s ��z+_load_sysconfig_schemes.<locals>.<dictcomp>)� contextlib�suppress�AttributeErrorr! �get_scheme_namesr& r& r& r' �_load_sysconfig_schemesc s �$�r- c s( t � pi � � fdd�tt�t� ��D �S )z= Extend default schemes with schemes from sysconfig. c s* i | ]}|i t �|i ��� �|i ���qS r& )�INSTALL_SCHEMES�getr# ��sysconfig_schemesr& r' r( r s � � ��z!_load_schemes.<locals>.<dictcomp>)r- �set� itertools�chainr. r& r& r0 r' � _load_schemesk s �r5 c C s t td�rdS dS )N�pypy_version_info�PyPy�Python)�hasattr�sysr& r& r& r' �_get_implementation{ s r; c C s. t |tt|���}t| ��t| t|��� d S �N)�_inject_headers� _load_scheme�_resolve_scheme�vars�update� _remove_set� _scheme_attrs)�ob�namer% r& r& r' �_select_scheme� s rF c s � fdd�|� � D �S )z1 Include only attrs that are None in ob. c s$ i | ]\}}t � |�d u r||�qS r< )�getattr)r$ �key�value�rD r& r' r( � s $ z _remove_set.<locals>.<dictcomp>)�items)rD �attrsr& rJ r' rB � s rB c C s@ | � d�\}}}zt�|�}W |S ty t�| �}Y |S w )N�_)� partitionr! �get_preferred_scheme� Exception�fwr% )rE �os_name�seprH �resolvedr& r& r' r? � s � �r? c C s t � | S r< )r5 )rE r& r& r' r> � s r> c C s t | �}|�d|d � |S )z� Given a scheme name and the resolved scheme, if the scheme does not include headers, resolve the fallback scheme for the name and use headers from it. pypa/distutils#88 r )r> � setdefault)rE r% �fallbackr& r& r' r= � s r= c s � fdd�t D �S )z<Resolve install directories by applying the install schemes.c s i | ] }d |� �� | �qS )�install_r& )r$ rH �r% r& r' r( � s z!_scheme_attrs.<locals>.<dictcomp>)� SCHEME_KEYSrX r& rX r' rC � � rC c @ sF e Zd ZU dZg d�Zg d�Zded< er&e�ddde � d �f� e�d� d d iZ d ed < dAdd�Z dAdd�Z dAdd�Z dAdd�ZdAdd�ZdAdd�Zd d � ZdAd d �ZdAd d!�ZdAd"d#�ZdAd$d%�ZdAd&d'�ZdAd(d)�Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:e fd;e fd<e fd=e fd>d?d@� fgZ dS )B�installz'install everything from build directory))zprefix=Nzinstallation prefix)z exec-prefix=Nz.(Unix only) prefix for platform-specific files)zhome=Nz+(Unix only) home directory to install under)z install-base=Nz;base installation directory (instead of --prefix or --home))zinstall-platbase=Nz\base installation directory for platform-specific files (instead of --exec-prefix or --home))zroot=Nz<install everything relative to this alternate root directory)zinstall-purelib=Nz;installation directory for pure Python module distributions)zinstall-platlib=Nz8installation directory for non-pure module distributions)z install-lib=Nzginstallation directory for all module distributions (overrides --install-purelib and --install-platlib))zinstall-headers=Nz(installation directory for C/C++ headers)zinstall-scripts=Nz)installation directory for Python scripts)z install-data=Nz%installation directory for data files)�compile�cz compile .py to .pyc [default])� no-compileNzdon't compile .py files)z optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])�force�fz1force installation (overwrite any existing files))� skip-buildNz2skip rebuilding everything (for testing/debugging))zrecord=Nz3filename in which to record list of installed files)r\ r` rb zClassVar[list[str]]�boolean_options�userNz install in user site-package '�'r^ r\ zClassVar[dict[str, str]]� negative_opt�return�Nonec C s� d| _ d| _d| _d| _d| _d| _d| _d| _d| _d| _ d| _ d| _ d| _ t | _t| _d| _d| _d| _d| _d| _d| _d| _d| _d| _d| _dS )zInitializes options.NFT)�prefix� exec_prefix�homerd � install_base�install_platbase�root�install_purelib�install_platlib�install_headers� install_lib�install_scripts� install_datar �install_userbaser �install_usersiter\ �optimize� extra_path�install_path_filer` � skip_build�warn_dir� build_base� build_lib�record��selfr& r& r' �initialize_options� s2 zinstall.initialize_optionsc C s� | j s | js | jr| js| jrtd��| jr | j s | jr td��| jr6| j s2| js2| js2| js2| jr6td��tjdkrF| jrF| � d� d| _| � d� tjdkrU| � � n| � � | � d� t j�� d }td d �\}}zt j}W n ty| d }Y nw | j�� | j�� | j�� |t jj� d t jj� �t jj� t jj� �|||||tt dd�t� � � t� d�}t tt dd �� d d �d�}t r�| j |d< | j!|d< t"�#|t$�� |t%�&� �| _'| �(� | � d� | j|d< | j|d< t)r�d dl*m*} t+d� |t | j'�� | �,� | � d� | j�r | �-� | j.du �r"| j�/� �r | j0| _.n| j1| _.| �2ddd d d d dd� | �3� | j.| _4tj5�6| j.| j7�| _.| j8du�rQ| �9d ddd d d d � | � d!� | �:d"d#d$� dS )%zFinalizes options.zWmust supply either prefix/exec-prefix/home or install-base/install-platbase -- not bothz9must supply either home or prefix/exec-prefix -- not bothzGcan't combine user with prefix, exec_prefix/home, or install_(plat)base�posixz+exec-prefix option ignored on this platformNzpre-finalize_{unix,other}z post-finalize_{unix,other}()r ri rj � �.� platlibdir�lib)� dist_name� dist_version� dist_fullname� py_version�py_version_short�py_version_nodot� sys_prefixri �sys_exec_prefixrj �abiflagsr� �implementation_lower�implementation�winver)�py_version_nodot_plat�userbase�usersitezpost-expand_basedirs()�base�platbase)�pprintz config vars:zpost-expand_dirs()r r r r r �libbasezafter prepending root�build)r| r| )r} r} );ri rj rk rl rm r rd �osrE �warn� dump_dirs� finalize_unix�finalize_otherr: �version�splitr r� r+ � distribution�get_name� get_version� get_fullname� version_info�major�minorrG r; �lower�dict�replace� HAS_USER_SITEru rv � collections�ChainMapr! rQ r@ � config_vars�expand_basedirsr r� �print� expand_dirs�create_home_pathrr �has_ext_modulesrp ro � convert_paths�handle_extra_path�install_libbase�path�join� extra_dirsrn � change_roots�set_undefined_options)r� r� ri rj r� � local_vars� compat_varsr� r& r& r' �finalize_optionsD s� ���������� � �� � � � �zinstall.finalize_optionsc C s� t sdS ddlm} t�|d � | jD ]9}|d }|d dkr&|dd� }|| jv r<| j| }|�|�}t| |� }n |�|�}t| |�}t�d||� qdS ) z Dumps the list of user options.Nr )� longopt_xlate�:r ����=z %s: %s) r � fancy_getoptr� r �debug� user_optionsrf � translaterG )r� �msgr� �opt�opt_name�valr& r& r' r� � s �zinstall.dump_dirsc C s< | j dus | jdur0| jdu o| jdu o| jdu p'| jdu p'| jdu p'| jdu }|r.td��dS | j rJ| j du r<t d��| j | _ | _| � d� dS | j dur]| j | _ | _| � d� dS | jdu r�| jdurktd��ttdd�}tj�tj�| | _tj�tj�| | _n | jdu r�| j| _| j| _ | j| _| � d � dS ) z&Finalizes options for posix platforms.NzPinstall-base or install-platbase supplied, but installation scheme is incomplete�$User base directory is not specifiedr r z*must not supply exec-prefix without prefix�_prefix_additionr� r )rl rm rr ro rp rq rs rt r rd ru r � select_schemerk ri rj rG r! r� r� �normpathr: )r� �incomplete_schemer� r& r& r' r� sL ����� � � zinstall.finalize_unixc C s� | j r | jdu r td��| j | _| _| �tjd � dS | jdur0| j | _| _| �d� dS | j du r=tj � t j �| _ | j | _| _z | �tj� W dS t y] tdtj� d���w )z)Finalizes options for non-posix platformsNr� �_userr z&I don't know how to install stuff on 're )rd ru r rl rm r� r� rE rk ri r� r� r: �KeyErrorr r& r& r' r� @ s$ ��zinstall.finalize_otherc C s t | |� d S r< )rF )r� rE r& r& r' r� V s zinstall.select_schemec C sN |D ]"}t | |�}|d ur$tjdv rtj�|�}t|| j�}t| ||� qd S )N)r� r )rG r� rE r� � expanduserr r� �setattr)r� rL �attrr� r& r& r' � _expand_attrsY s ��zinstall._expand_attrsc C � | � g d�� dS )zNCalls `os.path.expanduser` on install_base, install_platbase and root.)rl rm rn N�r� r r& r& r' r� b s zinstall.expand_basedirsc C r� )z+Calls `os.path.expanduser` on install dirs.)ro rp rr rq rs rt Nr� r r& r& r' r� g rZ zinstall.expand_dirsc G s, |D ]}d| }t | |tt| |��� qdS )z!Call `convert_path` over `names`.rW N)r� r rG �r� �namesrE r� r& r& r' r� r s �zinstall.convert_pathsc C s� | j du r | jj | _ | j durFt�d� t| j t�r!| j �d�| _ t| j �dkr0| j d }}nt| j �dkr=| j \}}ntd��t |�}nd}d}|| _ || _ dS ) z4Set `path_file` and `extra_dirs` using `extra_path`.NzIDistribution option extra_path is deprecated. See issue27919 for details.�,r r r zY'extra_path' option must be a list, tuple, or comma-separated string with 1 or 2 elementsr� ) rx r� r �warning� isinstance�strr� �lenr r � path_filer� )r� r� r� r& r& r' r� x s( � � zinstall.handle_extra_pathc G s0 |D ]}d| }t | |t| jt| |��� qdS )z:Change the install directories pointed by name using root.rW N)r� r rn rG r� r& r& r' r� � s �zinstall.change_rootsc C sf | j sdS ttj�d��}| j�� D ] }t|��|�r0tj� |�s0| � d|� d�� t� |d� qdS )zCreate directories under ~.N�~z os.makedirs('z ', 0o700)i� ) rd r r� r� r� r� �valuesr� � startswith�isdir� debug_print�makedirs)r� rk r� r& r& r' r� � s ��zinstall.create_home_pathc C s* | j s| �d� | j�d�j}| jr|t� krtd��| �� D ]}| �|� q | j r.| � � | j r_| � � }| j rPt| j �}tt|��D ] }|| |d� ||< qC| �t| j |fd| j � d�� ttjjtj�}ttjj|�}tj�tj�| j��}| jr�| j r�| js�||vr�t�d| j� dS dS dS dS )zRuns the command.r� z"Can't install when cross-compilingNz$writing list of installed files to 're z�modules installed to '%s', which is not in Python's module search path (sys.path) -- you'll have to change the search path yourself) rz � run_commandr� �get_command_obj� plat_namer{ r r �get_sub_commandsr� �create_path_filer~ � get_outputsrn r� �range�executer �mapr� r� r� r: �normcaserr ry r r� )r� � build_plat�cmd_name�outputs�root_len�counter�sys_pathrr r& r& r' �run� sJ �������z install.runc C sR t j�| j| jd �}| jr | �t|| jgfd|� �� dS | � d|� d�� dS )zCreates the .pth file�.pthz creating z path file 'z ' not createdN) r� r� r� r� r� ry r� r r� r� )r� �filenamer& r& r' r� � s �zinstall.create_path_filec C sh g }| � � D ]}| �|�}|�� D ] }||vr |�|� qq| jr2| jr2|�tj�| j | jd �� |S )z.Assembles the outputs of all the sub-commands.r� ) r� �get_finalized_commandr� �appendr� ry r� r� r� r� )r� r� r� �cmdr� r& r& r' r� � s �� zinstall.get_outputsc C s. g }| � � D ]}| �|�}|�|�� � q|S )z*Returns the inputs of all the sub-commands)r� r� �extend� get_inputs)r� �inputsr� r� r& r& r' r� � s zinstall.get_inputsc C s | j �� p | j �� S )zSReturns true if the current distribution has any Python modules to install.)r� �has_pure_modulesr� r r& r& r' �has_lib s �zinstall.has_libc C � | j �� S )zLReturns true if the current distribution has any headers to install.)r� � has_headersr r& r& r' r � zinstall.has_headersc C r )zMReturns true if the current distribution has any scripts to. install.)r� � has_scriptsr r& r& r' r r zinstall.has_scriptsc C r )zJReturns true if the current distribution has any data to. install.)r� �has_data_filesr r& r& r' �has_data r zinstall.has_datarr rq rs rt �install_egg_infoc C s dS )NTr& r r& r& r' �<lambda>$ s zinstall.<lambda>)rg rh )!�__name__� __module__� __qualname__� descriptionr� rc �__annotations__r� r� r rf r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r � sub_commandsr& r& r& r' r[ � sP : � M 8 1 # 2 �r[ )2�__doc__� __future__r r� r) r3 r� r: r! �distutils._logr �siter r �typingr �corer r� r �errorsr r � file_utilr r �utilr r r r r� r rQ r� �WINDOWS_SCHEMEr. rA �schemesrY r- r5 r; rF rB r? r> r= rC r[ r& r& r& r' �<module> s� � � ����# � � _distutils/command/__pycache__/bdist.cpython-310.pyc 0000644 00000011343 15030122015 0016352 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlZddlZddlmZ ddlmZm Z ddl m Z ddl m Z mZ dd lmZ er;dd lmZ nd d � Zd d� ZG dd� deeeeef f �ZG dd� de �ZdS )zidistutils.command.bdist Implements the Distutils 'bdist' command (create a built [binary] distribution).� )� annotationsN)�Callable)� TYPE_CHECKING�ClassVar� )�Command)�DistutilsOptionError�DistutilsPlatformError)� get_platform)� deprecatedc C s dd� S )Nc S s | S )N� )�fnr r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/bdist.py�<lambda> s z deprecated.<locals>.<lambda>r )�messager r r r s r c C s2 ddl m} dd� tjD �}| |�}|�d� dS )zAPrint list of available formats (arguments to "--format" option).r )� FancyGetoptc S s$ g | ]}d | dt j| d f�qS )�formats=N� )�bdist�format_commands)�.0�formatr r r � <listcomp> s ��z show_formats.<locals>.<listcomp>z'List of available distribution formats:N)� fancy_getoptr r r � print_help)r �formats�pretty_printerr r r � show_formats s �r c @ s e Zd Zed�d dd��ZdS ) � ListCompat�4format_commands is now a dict. append is deprecated.�item�object�return�Nonec C s t jdtdd� d S )Nr r )� stacklevel)�warnings�warn�DeprecationWarning)�selfr r r r �append' s �zListCompat.appendN)r r! r" r# )�__name__� __module__� __qualname__r r) r r r r r % s r c @ s� e Zd ZU dZdddde� � d�fddd d d gZd gZd ed< dddefgZ ded< dZ ded< ddd�Z ded< e d d d d d d!d"d#��Z e Zd$d%� Zd,d(d)�Zd,d*d+�ZdS )-r z$create a built (binary) distribution)z bdist-base=�bz4temporary directory for creating built distributionsz plat-name=�pz8platform name to embed in generated filenames [default: �])r Nz/formats for distribution (comma-separated list))z dist-dir=�dz=directory to put final built distributions in [default: dist])� skip-buildNz2skip rebuilding everything (for testing/debugging))zowner=�uz@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group]r1 zClassVar[list[str]]�boolean_optionsz help-formatsNz$lists available distribution formatszAClassVar[list[tuple[str, str | None, str, Callable[[], object]]]]� help_options)� bdist_rpmzClassVar[tuple[str, ...]]�no_format_option�gztar�zip)�posix�ntzClassVar[dict[str, str]]�default_format)r6 zRPM distribution)� bdist_dumbzgzip'ed tar file)r= zbzip2'ed tar file)r= zxz'ed tar file)r= zcompressed tar file)r= ztar file)r= zZIP file)�rpmr8 �bztar�xztar�ztar�tarr9 c C s. d | _ d | _d | _d | _d| _d | _d | _d S )NF)� bdist_base� plat_namer �dist_dir� skip_build�group�owner)r( r r r �initialize_optionsi s zbdist.initialize_optionsr" r# c C s� | j d u r| jr t� | _ n| �d�j | _ | jd u r*| �d�j}tj�|d| j �| _| � d� | j d u rNz | j tj g| _ W n t yM tdtj � ���w | jd u rXd| _d S d S )N�buildzbdist.r z9don't know how to create built distributions on platform �dist)rD rF r �get_finalized_commandrC � build_base�os�path�join�ensure_string_listr r< �name�KeyErrorr rE )r( rM r r r �finalize_optionsr s* ��� �zbdist.finalize_optionsc C s� g }| j D ] }z |�| j| d � W q ty" td|� d���w tt| j ��D ]4}|| }| �|�}|| jvr@| j | |_ |dkrL| j |_ | j |_ |||d d � v rYd|_ | � |� q*d S )Nr zinvalid format '�'r= r T)r r) r rS r �range�len�reinitialize_commandr7 r rH rG � keep_temp� run_command)r( �commandsr �i�cmd_name�sub_cmdr r r �run� s& � �z bdist.run)r" r# )r* r+ r, � descriptionr � user_optionsr4 �__annotations__r r5 r7 r< r r �format_commandrI rT r_ r r r r r 0 sB ��� � � r )�__doc__� __future__r rN r% �collections.abcr �typingr r �corer �errorsr r �utilr �typing_extensionsr r �dict�str�tupler r r r r r �<module> s _distutils/command/__pycache__/install_lib.cpython-310.pyc 0000644 00000012640 15030122015 0017542 0 ustar 00 o �h�! � @ sh d Z ddlmZ ddlZddlZddlZddlmZm Z ddl m Z ddl m Z dZG d d � d e �ZdS ) zkdistutils.command.install_lib Implements the Distutils 'install_lib' command (install all Python modules).� )� annotationsN)�Any�ClassVar� )�Command)�DistutilsOptionErrorz.pyc @ s� e Zd ZU dZg d�Zg d�Zded< ddiZded < d d � Zd"dd�Z d"dd�Z d"dd�Z d#dd�Z d"dd�Z dd� Zdd � Zd d � Zd d � Zd!S )$� install_libz7install all Python modules (extensions and pure Python)))z install-dir=�dzdirectory to install to)z build-dir=�bz'build directory (where to install from))�force�fz-force installation (overwrite existing files))�compile�cz compile .py to .pyc [default])� no-compileNzdon't compile .py files)z optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])� skip-buildNzskip the build steps)r r r zClassVar[list[str]]�boolean_optionsr r zClassVar[dict[str, str]]� negative_optc C s( d | _ d | _d| _d | _d | _d | _d S )NF)� install_dir� build_dirr r �optimize� skip_build��self� r �\/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install_lib.py�initialize_options8 s z install_lib.initialize_options�return�Nonec C s� | � ddddddd� | jd u rd| _| jd u rd | _t| jt�s<zt| j�| _W n ty2 Y nw | jd vr>td ��d S d S ) N�install)� build_libr )r r )r r )r r )r r )r r TF)r � r zoptimize must be 0, 1, or 2)�set_undefined_optionsr r � isinstance�int� ValueErrorr r r r r �finalize_optionsA s. � � �z install_lib.finalize_optionsc C s8 | � � | �� }|d ur| j�� r| �|� d S d S d S �N)�buildr � distribution�has_pure_modules� byte_compile�r �outfilesr r r �run\ s �zinstall_lib.runc C s: | j s| j�� r | �d� | j�� r| �d� d S d S d S )N�build_py� build_ext)r r) r* � run_command�has_ext_modulesr r r r r( l s �zinstall_lib.build�list[str] | Anyc C s: t j�| j�r| �| j| j�}|S | �d| j� d�� d S )N�'z0' does not exist -- no Python modules to install)�os�path�isdirr � copy_treer �warnr, r r r r t s � �zinstall_lib.installc C sv t jr | �d� d S ddlm} | �d�j}| jr$||d| j|| j d� | j dkr9||| j | j|| j | j d� d S d S )Nz%byte-compiling is disabled, skipping.r )r+ r r )r r �prefix�dry_run)r r r: �verboser; ) �sys�dont_write_bytecoder9 �utilr+ �get_finalized_command�rootr r r; r r< )r �filesr+ � install_rootr r r r+ ~ s. � ��zinstall_lib.byte_compilec sN |sg S | � |�}|�� }t||�}t|�ttj� �� �fdd�|D �}|S )Nc s" g | ] }t j�� |�d � ��qS r' )r5 r6 �join)�.0�file�� output_dir� prefix_lenr r � <listcomp>� s " z/install_lib._mutate_outputs.<locals>.<listcomp>)r@ � get_outputs�getattr�lenr5 �sep)r �has_any� build_cmd� cmd_optionrH � build_filesr �outputsr rG r �_mutate_outputs� s zinstall_lib._mutate_outputsc C sr g }|D ]2}t j�t j�|��d }|tkrq| jr%|�tjj |dd�� | j dkr6|�tjj || j d�� q|S )Nr! � )� optimizationr ) r5 r6 �splitext�normcase�PYTHON_SOURCE_EXTENSIONr �append� importlibr? �cache_from_sourcer )r � py_filenames�bytecode_files�py_file�extr r r �_bytecode_filenames� s" � ���z install_lib._bytecode_filenamesc C sR | � | j�� dd| j�}| jr| �|�}ng }| � | j�� dd| j�}|| | S )z�Return the list of files that would be installed if this command were actually run. Not affected by the "dry-run" flag or whether modules have actually been built yet. r/ r r0 )rT r) r* r r ra r2 )r � pure_outputs�bytecode_outputs� ext_outputsr r r rK � s � � zinstall_lib.get_outputsc C sL g }| j �� r| �d�}|�|�� � | j �� r$| �d�}|�|�� � |S )z�Get the list of files that are input to this command, ie. the files that get installed as they are named in the build tree. The files in this list correspond one-to-one to the output filenames returned by 'get_outputs()'. r/ r0 )r) r* r@ �extendrK r2 )r �inputsr/ r0 r r r � get_inputs� s zinstall_lib.get_inputsN)r r )r r3 )�__name__� __module__� __qualname__� description� user_optionsr �__annotations__r r r& r. r( r r+ rT ra rK rg r r r r r s ! r )�__doc__� __future__r �importlib.utilr[ r5 r= �typingr r �corer �errorsr rY r r r r r �<module> s _distutils/command/__pycache__/install_scripts.cpython-310.pyc 0000644 00000004371 15030122015 0020465 0 ustar 00 o �h� � @ sP d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z G dd � d e �Z dS ) zudistutils.command.install_scripts Implements the Distutils 'install_scripts' command, for installing Python scripts.� N)�log)�ST_MODE)�ClassVar� )�Commandc @ s^ e Zd ZU dZg d�ZddgZeee e d< dd� Z dd d �Z dd d �Z dd� Z dd� Zd S )�install_scriptsz%install scripts (Python or otherwise)))z install-dir=�dz directory to install scripts to)z build-dir=�bz'build directory (where to install from))�force�fz-force installation (overwrite existing files))� skip-buildNzskip the build stepsr r �boolean_optionsc C s d | _ d| _d | _d | _d S )NF)� install_dirr � build_dir� skip_build��self� r �`/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/install_scripts.py�initialize_options s z"install_scripts.initialize_options�returnNc C s | � dd� | � dddd� d S )N�build)� build_scriptsr �install)r r )r r )r r )�set_undefined_optionsr r r r �finalize_options" s �z install_scripts.finalize_optionsc C s� | j s| �d� | �| j| j�| _tjdkr?| �� D ]&}| j r&t � d|� qt� |�t dB d@ }t � d||� t�||� qd S d S )Nr �posixzchanging mode of %sim i� zchanging mode of %s to %o)r � run_command� copy_treer r �outfiles�os�name� get_outputs�dry_runr �info�statr �chmod)r �file�moder r r �run+ s �zinstall_scripts.runc C s | j jpg S �N)� distribution�scriptsr r r r � get_inputs: s zinstall_scripts.get_inputsc C s | j pg S r* )r r r r r r" = s zinstall_scripts.get_outputs)r N)�__name__� __module__� __qualname__� description� user_optionsr r �list�str�__annotations__r r r) r- r" r r r r r s r ) �__doc__r �distutils._logr r% r �typingr �corer r r r r r �<module> s _distutils/command/__pycache__/build_ext.cpython-310.pyc 0000644 00000041732 15030122015 0017231 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m Z ddl m Z ddl mZ dd lmZ dd lmZmZ dd lmZ dd lmZmZmZmZmZm Z dd l m Z ddl m Z m!Z!m"Z" ddl#m$Z$m%Z%m&Z& e�'d�Z(G dd� de�Z)dS )z�distutils.command.build_ext Implements the Distutils 'build_ext' command, for building extension modules (currently limited to C extensions, should accommodate C++ extensions ASAP).� )� annotationsN)�Callable)�log)� USER_BASE)�ClassVar� )� newer_group)� new_compiler�show_compilers)�Command)�CCompilerError� CompileError�DistutilsError�DistutilsOptionError�DistutilsPlatformError�DistutilsSetupError)� Extension)�customize_compiler�get_config_h_filename�get_python_version)� get_platform�is_freethreaded�is_mingwz3^[a-zA-Z_][a-zA-Z_0-9]*(\.[a-zA-Z_][a-zA-Z_0-9]*)*$c @ sR e Zd ZU dZdej� d�Zddddde� � d �fd d d d e fdddddde fddddddddd d gZg d �Z d e d < d!d"d#e fgZ d$e d%< d&d'� Z ed(d)� �ZdUd,d-�ZdUd.d/�ZdUd0d1�Zd2d3� Zd4d5� ZdUd6d7�Zd8d9� Zd:d;� Zejd<d=� �ZdUd>d?�Zd@dA� Z dBdC� Z dVdFdG�Z dVdHdI�Z dVdJdK�Z dWdOdP�Z!dQdR� Z"dWdSdT�Z#d"S )X� build_extz8build C/C++ extensions (compile/link to build directory)z (separated by 'z'))z build-lib=�bz(directory for compiled extension modules)z build-temp=�tz1directory for temporary files (build by-products)z plat-name=�pz;platform name to cross-compile for, if supported [default: �])�inplace�iziignore build-lib and put compiled extensions into the source directory alongside your pure Python modulesz include-dirs=�Iz.list of directories to search for header files)zdefine=�Dz C preprocessor macros to define)zundef=�Uz!C preprocessor macros to undefine)z libraries=�lz!external C libraries to link withz library-dirs=�Lz.directories to search for external C libraries)zrpath=�Rz7directories to search for shared C libraries at runtime)z link-objects=�Oz2extra explicit link objects to include in the link)�debug�gz'compile/link with debugging information)�force�fz2forcibly build everything (ignore file timestamps))z compiler=�czspecify the compiler type)z parallel=�jz number of parallel build jobs)�swig-cppNz)make SWIG create C++ files (default is C))z swig-opts=Nz!list of SWIG command line options)zswig=Nzpath to the SWIG executable)�userNz#add user include, library and rpath)r r' r) r- r. zClassVar[list[str]]�boolean_optionsz help-compilerNzlist available compilerszAClassVar[list[tuple[str, str | None, str, Callable[[], object]]]]� help_optionsc C s� d | _ d | _d | _d | _d| _d | _d | _d | _d | _d | _ d | _ d | _ d | _ d | _ d | _d | _d | _d | _d | _d | _d | _d S )NF)� extensions� build_lib� plat_name� build_tempr �package� include_dirs�define�undef� libraries� library_dirs�rpath� link_objectsr' r) �compiler�swig�swig_cpp� swig_optsr. �parallel��self� rD �Z/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/build_ext.py�initialize_optionsp s* z build_ext.initialize_optionsc c sb � | � d�sdS | jrdV dS tjdkr)| � d�}| � d�}tj�||�V dS | � d�V dS )z� Resolve Python's library directory for building extensions that rely on a shared Python library. See python/cpython#44264 and python/cpython#48686 �Py_ENABLE_SHAREDN�.�zos�base� platlibdir�LIBDIR)�get_config_var� python_build�sys�platform�os�path�join)� sysconfig� installed_dir�lib_dirrD rD rE �_python_lib_dir� s � zbuild_ext._python_lib_dir�return�Nonec C s� ddl m} | �ddddddd d � | jd u r | jj| _| jj| _|�� }|jd d �}| j d u r7| jj p5g | _ t | j t �rE| j � t j�| _ tjtjkrW| j �t j�tjd �� | j �|� t jj�� ||krq| j �|� t jj�� | �d� | �d� | jd u r�g | _| jd u r�g | _nt | jt �r�| j� t j�| _| jd u r�g | _nt | jt �r�| j� t j�| _t jdk�r)t� �s)| j�t j�tjd�� tjtj kr�| j�t j�tjd�� | j r�t j�| j d�| _ n t j�| j d�| _ | j �t j� t � �� | j�tj� | j!dk�r d}n| j!dd � }t j�tjd�}|�r#t j�||�}| j�|� tj"d d� dk�rO|j#�sI| j�t j�tj ddt$� d�� n| j�d � | j�| �%|�� | j&�rj| j&� d �}d d � |D �| _&| j'�ru| j'� d �| _'| j(d u �rg | _(n| j(� d �| _(| j)�r�t j�t*d �}t j�t*d�}t j�+|��r�| j �|� t j�+|��r�| j�|� | j�|� t | j,t ��r�z t-| j,�| _,W d S t.�y� t/d!��w d S )"Nr )rT �build)r2 r2 )r4 r4 )r= r= )r' r' )r) r) )rA rA )r3 r3 T)� plat_specific�includer9 r< �nt�libs�Debug�Release�win32� �PCbuild� �cygwin�lib�python�configrH �,c S s g | ]}|d f�qS )�1rD )�.0�symbolrD rD rE � <listcomp> s z.build_ext.finalize_options.<locals>.<listcomp>� z parallel should be an integer)0� distutilsrT �set_undefined_optionsr5 � distribution� ext_package� ext_modulesr1 �get_python_incr6 � isinstance�str�splitrQ �pathseprO � exec_prefix�base_exec_prefix�appendrR rS �extend�ensure_string_listr9 r: r; �namer �prefixr' r4 �dirnamer r3 rP rN r rW r7 r8 r@ r. r �isdirrA �int� ValueErrorr ) rC rT � py_include�plat_py_include�suffix�new_lib�defines� user_include�user_librD rD rE �finalize_options� s� � �� ��zbuild_ext.finalize_optionsc C st | j sd S | j�� r | �d�}| j�|�� pg � | j�|j � t | j | j | j | jd�| _ t| j � tjdkrD| jt� krD| j �| j� tjdkrSt� rS| j �dd� | jd ur_| j �| j� | jd urs| jD ] \}}| j �||� qg| jd ur�| jD ]}| j �|� q{| jd ur�| j � | j� | jd ur�| j � | j� | j d ur�| j � | j � | j d ur�| j �!| j � | �"� d S )N� build_clib)r= �verbose�dry_runr) r] �Py_GIL_DISABLEDrj )#r1 rq �has_c_libraries�get_finalized_commandr9 r| �get_library_namesr: r{ r� r r= r� r� r) r rQ r~ r3 r � initializer � define_macror6 �set_include_dirsr7 r8 �undefine_macro� set_libraries�set_library_dirsr; �set_runtime_library_dirsr< �set_link_objects�build_extensions)rC r� r~ �value�macrorD rD rE �run, sD � z build_ext.runc C sh t |t�s td��t|�D ]�\}}t |t�rq t |t�r"t|�dkr&td��|\}}t�d|� t |t �r:t � |�s>td��t |t �sGtd��t||d �}dD ]}|� |�}|d urat|||� qP|� d �|_d |v rqt�d � |� d �}|r�g |_g |_|D ],} t | t�r�t| �dv s�td��t| �dkr�|j�| d � q�t| �dkr�|j�| � q�|||< q d S )a� Ensure that the list of extensions (presumably provided as a command option 'extensions') is valid, i.e. it is a list of Extension objects. We also support the old-style list of 2-tuples, where the tuples are (ext_name, build_info), which are converted to Extension instances here. Raise DistutilsSetupError if the structure is invalid anywhere; just returns otherwise. z:'ext_modules' option must be a list of Extension instancesr zMeach element of 'ext_modules' option must be an Extension instance or 2-tuplezvold-style (ext_name, build_info) tuple found in ext_modules for extension '%s' -- please convert to Extension instancezRfirst element of each tuple in 'ext_modules' must be the extension name (a string)zOsecond element of each tuple in 'ext_modules' must be a dictionary (build info)�sources)r6 r: r9 � extra_objects�extra_compile_args�extra_link_argsNr; �def_filez9'def_file' element of build info dict no longer supported�macros)� r z9'macros' element of build info dict must be 1- or 2-tupler� r )ru �listr � enumerater �tuple�lenr �warningrv �extension_name_re�match�dict�get�setattr�runtime_library_dirs� define_macros� undef_macrosr{ ) rC r1 r �ext�ext_name� build_info�key�valr� r� rD rD rE �check_extensions_listr sb � ��� � � � � �z build_ext.check_extensions_listc C s, | � | j� g }| jD ]}|�|j� q |S �N)r� r1 r| r� )rC � filenamesr� rD rD rE �get_source_files� s zbuild_ext.get_source_filesc s � � � j� � fdd�� jD �S )Nc s g | ]}� � |j��qS rD )�get_ext_fullpathr~ �rk r� rB rD rE rm � s z)build_ext.get_outputs.<locals>.<listcomp>)r� r1 rB rD rB rE � get_outputs� s zbuild_ext.get_outputsc C s* | � | j� | jr| �� d S | �� d S r� )r� r1 rA �_build_extensions_parallel�_build_extensions_serialrB rD rD rE r� � s zbuild_ext.build_extensionsc s� �j }�j du r t�� }zddlm} W n ty d }Y nw |d u r*��� d S ||d��8� � �fdd��jD �}t�j|�D ] \}}�� |�� |� � W d � n1 sYw Y qAW d � d S 1 sjw Y d S )NTr )�ThreadPoolExecutor)� max_workersc s g | ] }� � �j|��qS rD )�submit�build_extensionr� ��executorrC rD rE rm � s �z8build_ext._build_extensions_parallel.<locals>.<listcomp>) rA rQ � cpu_count�concurrent.futuresr� � ImportErrorr� r1 �zip�_filter_build_errors�result)rC �workersr� �futuresr� �futrD r� rE r� � s, � � ���"�z$build_ext._build_extensions_parallelc C sD | j D ] }| �|�� | �|� W d � n1 sw Y qd S r� )r1 r� r� )rC r� rD rD rE r� � s ���z"build_ext._build_extensions_serialc c s\ � zd V W d S t ttfy- } z|js� | �d|j� d|� �� W Y d }~d S d }~ww )Nzbuilding extension "z " failed: )r r r �optional�warnr~ )rC r� �erD rD rE r� s � &��z build_ext._filter_build_errorsc C sP |j }|d u st|ttf�std|j� d���t|�}| �|j�}||j }| j s8t ||d�s8t � d|j� d S t � d|j� | �||�}|jpIg }|jd d � }|jD ]}|�|f� qT| jj|| j||j| j ||jd�}|d d � | _|jr~|�|j� |jp�g }|jp�| j� |�} | jj ||| � |�|j |j || �!|�| j | j| d� d S )Nz$in 'ext_modules' option (extension 'zD'), 'sources' must be present and must be a list of source filenames�newerz$skipping '%s' extension (up-to-date)zbuilding '%s' extension)� output_dirr� r6 r' �extra_postargs�depends)r9 r: r� r� �export_symbolsr' r4 � target_lang)"r� ru r� r� r r~ �sortedr� r� r) r r r' �info� swig_sourcesr� r� r� r{ r= �compiler4 r6 �_built_objectsr� r| r� �language�detect_language�link_shared_object� get_librariesr: r� �get_export_symbols) rC r� r� �ext_pathr� � extra_argsr� r8 �objectsr� rD rD rE r� sV � � �zbuild_ext.build_extensionc C s g }g }i }| j rt�d� | j sd| jv sd|jv r d}nd}|D ](}tj�|�\}} | dkrE|�|d | � |�|� |d ||< q"|�|� q"|sO|S | jpU| � � } | dg} | � | j� | j rh| �d� | jsq| � |j� |D ]}|| } t� d || � | � | d | |g � qs|S ) z�Walk the list of source files in 'sources', looking for SWIG interface (.i) files. Run SWIG on all that are found, and return a modified 'sources' list with SWIG source files replaced by the generated C (or C++) files. z/--swig-cpp is deprecated - use --swig-opts=-c++z-c++z.cppz.cz.i�_wrap���z-pythonzswigging %s to %sz-o) r? r r� r@ rQ rR �splitextr{ r> � find_swigr| r� �spawn) rC r� � extension� new_sourcesr� � swig_targets� target_ext�sourcerJ r� r> �swig_cmd�targetrD rD rE r� Z s@ � zbuild_ext.swig_sourcesc C s` t jdkrdS t jdkr'dD ]}t j�d|� �d�}t j�|�r$| S qdS tdt j� d���) z�Return the name of the SWIG executable. On Unix, this is just "swig" -- it should be in the PATH. Tries a bit harder on Windows. �posixr> r] )z1.3z1.2z1.1zc:\swigzswig.exez;I don't know how to find (much less run) SWIG on platform '�')rQ r~ rR rS �isfiler )rC �vers�fnrD rD rE r� � s � �zbuild_ext.find_swigr� rv c C s� | � |�}|�d�}| �|d �}| js)tjj|dd� |g � }tj�| j|�S d�|dd� �}| �d�}tj� |� |��}tj�||�S )z�Returns the path of the filename for a given extension. The file is located in `build_lib` or directly in the package (inplace option). rH r� Nr �build_py) �get_ext_fullnamerw �get_ext_filenamer rQ rR rS r2 r� �abspath�get_package_dir)rC r� �fullname�modpath�filenamer5 r� � package_dirrD rD rE r� � s zbuild_ext.get_ext_fullpathc C s | j du r|S | j d | S )zSReturns the fullname of a given extension name. Adds the `package.` prefixNrH )r5 )rC r� rD rD rE r� � s zbuild_ext.get_ext_fullnamec C s. ddl m} |�d�}|d�}tjj|� | S )z�Convert the name of an extension (eg. "foo.bar") into the name of the file from which it will be loaded (eg. "foo/bar.so", or "foo\bar.pyd"). r �rM rH � EXT_SUFFIX)rT rM rw rQ rR rS )rC r� rM r� � ext_suffixrD rD rE r� � s zbuild_ext.get_ext_filenamer� r � list[str]c C st | � |�}z|�d� W n ty# d|�d��dd��d� }Y nw d| }d| }||jvr7|j�|� |jS )a Return the list of symbols that a shared extension has to export. This either uses 'ext.export_symbols' or, if it's not provided, "PyInit_" + module_name. Only relevant on Windows, where the .pyd file (DLL) must export the module "PyInit_" function. �ascii�U_�punycode� -� _�_�PyInit)�_get_module_name_for_symbol�encode�UnicodeEncodeError�replace�decoder� r{ )rC r� r~ r� � initfunc_namerD rD rE r� � s � z build_ext.get_export_symbolsc C s4 |j �d�}|d dkrt|�dkr|d S |d S )NrH r� �__init__r ���)r~ rw r� )rC r� �partsrD rD rE r � s z%build_ext._get_module_name_for_symbolc C s� t jdkr4t� s4ddlm} t| j|�s1d}| jr |d }|t jd? t jd? d@ f }|j |g S |j S dd l m } d }|d �rit t d �rHd }n!t jdksPt� rSd }ndt jv ri|d�dkrad }n|d�dkrid }|rw|d�}|j d| g S |j S )z�Return the list of libraries to link against when building a shared extension. On most platforms, this is just 'ext.libraries'; on Windows, we add the Python library (eg. python20.dll). ra r )� MSVCCompilerz python%d%d�_d� � � r FrG �getandroidapilevelTre �_PYTHON_HOST_PLATFORM�ANDROID_API_LEVELr �MACHDEP� LDVERSIONrg )rO rP r � _msvccompilerr ru r= r' � hexversionr9 rT rM �hasattrrQ �environ)rC r� r �template� pythonlibrM �link_libpython� ldversionrD rD rE r� � s8 � � zbuild_ext.get_libraries)rX rY )r� rv rX rv )r� r rX r )$�__name__� __module__� __qualname__� descriptionrQ rx �sep_byr � user_optionsr/ �__annotations__r r0 rF � staticmethodrW r� r� r� r� r� r� r� r� � contextlib�contextmanagerr� r� r� r� r� r� r� r� r r� rD rD rD rE r & sx �����( � FX Q8 r )*�__doc__� __future__r r. rQ �rerO �collections.abcr �distutils._logr �siter �typingr � _modifiedr � ccompilerr r �corer �errorsr r r r r r r� r rT r r r �utilr r r r� r� r rD rD rD rE �<module> s& _distutils/command/__pycache__/bdist_dumb.cpython-310.pyc 0000644 00000007133 15030122015 0017363 0 ustar 00 o �h � @ sx d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z m Z ddl m Z dd l mZ dd lmZ G d d � d e�ZdS ) z�distutils.command.bdist_dumb Implements the Distutils 'bdist_dumb' command (create a "dumb" built distribution -- i.e., just an archive to be unpacked under $prefix or $exec_prefix).� N)�log)�ClassVar� )�Command)�ensure_relative� remove_tree)�DistutilsPlatformError)�get_python_version)� get_platformc @ sr e Zd ZU dZdddde� � d�fddd d d d d g Zg d�Zeee e d< ddd�Z dd� Z dd� Z dd� ZdS )� bdist_dumbz"create a "dumb" built distribution)z bdist-dir=�dz1temporary directory for creating the distributionz plat-name=�pz8platform name to embed in generated filenames [default: �])zformat=�fz>archive format to create (tar, gztar, bztar, xztar, ztar, zip))� keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z dist-dir=r z-directory to put final built distributions in)� skip-buildNz2skip rebuilding everything (for testing/debugging))�relativeNz7build the archive using relative paths [default: false])zowner=�uz@Owner name used when creating a tar file [default: current user])zgroup=�gzAGroup name used when creating a tar file [default: current group])r r r �boolean_options�gztar�zip)�posix�ntc C s: d | _ d | _d | _d| _d | _d | _d| _d | _d | _d S )NF) � bdist_dir� plat_name�format� keep_temp�dist_dir� skip_buildr �owner�group)�self� r$ �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/command/bdist_dumb.py�initialize_options> s z bdist_dumb.initialize_optionsc C sv | j d u r| �d�j}tj�|d�| _ | jd u r1z | jtj | _W n t y0 t dtj� ���w | � dddd� d S )N�bdist�dumbz>don't know how to create dumb built distributions on platform )r r )r r )r r ) r �get_finalized_command� bdist_base�os�path�joinr �default_format�name�KeyErrorr �set_undefined_options)r# r* r$ r$ r% �finalize_optionsI s& ����zbdist_dumb.finalize_optionsc C s( | j s| �d� | jddd�}| j|_| j |_ d|_t�d| j� | �d� | j� � � d| j � �}t j � | j|�}| js@| j}n#| j�� rX|j|jkrXtd|j�d |j�d ���t j � | jt|j��}| j|| j|| j| jd �}| j�� ryt� }nd }| jj�d ||f� | j s�t | j| j d� d S d S )N�build�installT)�reinit_subcommandsFzinstalling to %s�.zLcan't make a dumb built distribution where base and platbase are different (z, �))�root_dirr! r" �anyr )�dry_run) r � run_command�reinitialize_commandr �root�warn_dirr �info� distribution� get_fullnamer r+ r, r- r r �has_ext_modules� install_base�install_platbaser r � make_archiver r! r" r � dist_files�appendr r r: )r# r4 �archive_basename�pseudoinstall_root� archive_root�filename� pyversionr$ r$ r% �run^ sL ��� �� �zbdist_dumb.runN)�__name__� __module__� __qualname__� descriptionr � user_optionsr r �list�str�__annotations__r. r& r2 rM r$ r$ r$ r% r s, ���% r )�__doc__r+ �distutils._logr �typingr �corer �dir_utilr r �errorsr � sysconfigr �utilr r r$ r$ r$ r% �<module> s _distutils/command/build.py 0000644 00000013443 15030122015 0012010 0 ustar 00 """distutils.command.build Implements the Distutils 'build' command.""" from __future__ import annotations import os import sys import sysconfig from collections.abc import Callable from typing import ClassVar from ..ccompiler import show_compilers from ..core import Command from ..errors import DistutilsOptionError from ..util import get_platform class build(Command): description = "build everything needed to install" user_options = [ ('build-base=', 'b', "base directory for build library"), ('build-purelib=', None, "build directory for platform-neutral distributions"), ('build-platlib=', None, "build directory for platform-specific distributions"), ( 'build-lib=', None, "build directory for all distribution (defaults to either build-purelib or build-platlib", ), ('build-scripts=', None, "build directory for scripts"), ('build-temp=', 't', "temporary build directory"), ( 'plat-name=', 'p', f"platform name to build for, if supported [default: {get_platform()}]", ), ('compiler=', 'c', "specify the compiler type"), ('parallel=', 'j', "number of parallel build jobs"), ('debug', 'g', "compile extensions and libraries with debugging information"), ('force', 'f', "forcibly build everything (ignore file timestamps)"), ('executable=', 'e', "specify final destination interpreter path (build.py)"), ] boolean_options: ClassVar[list[str]] = ['debug', 'force'] help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ ('help-compiler', None, "list available compilers", show_compilers), ] def initialize_options(self): self.build_base = 'build' # these are decided only after 'build_base' has its final value # (unless overridden by the user or client) self.build_purelib = None self.build_platlib = None self.build_lib = None self.build_temp = None self.build_scripts = None self.compiler = None self.plat_name = None self.debug = None self.force = False self.executable = None self.parallel = None def finalize_options(self) -> None: # noqa: C901 if self.plat_name is None: self.plat_name = get_platform() else: # plat-name only supported for windows (other platforms are # supported via ./configure flags, if at all). Avoid misleading # other platforms. if os.name != 'nt': raise DistutilsOptionError( "--plat-name only supported on Windows (try " "using './configure --help' on your platform)" ) plat_specifier = f".{self.plat_name}-{sys.implementation.cache_tag}" # Python 3.13+ with --disable-gil shouldn't share build directories if sysconfig.get_config_var('Py_GIL_DISABLED'): plat_specifier += 't' # Make it so Python 2.x and Python 2.x with --with-pydebug don't # share the same build directories. Doing so confuses the build # process for C modules if hasattr(sys, 'gettotalrefcount'): plat_specifier += '-pydebug' # 'build_purelib' and 'build_platlib' just default to 'lib' and # 'lib.<plat>' under the base build directory. We only use one of # them for a given distribution, though -- if self.build_purelib is None: self.build_purelib = os.path.join(self.build_base, 'lib') if self.build_platlib is None: self.build_platlib = os.path.join(self.build_base, 'lib' + plat_specifier) # 'build_lib' is the actual directory that we will use for this # particular module distribution -- if user didn't supply it, pick # one of 'build_purelib' or 'build_platlib'. if self.build_lib is None: if self.distribution.has_ext_modules(): self.build_lib = self.build_platlib else: self.build_lib = self.build_purelib # 'build_temp' -- temporary directory for compiler turds, # "build/temp.<plat>" if self.build_temp is None: self.build_temp = os.path.join(self.build_base, 'temp' + plat_specifier) if self.build_scripts is None: self.build_scripts = os.path.join( self.build_base, f'scripts-{sys.version_info.major}.{sys.version_info.minor}', ) if self.executable is None and sys.executable: self.executable = os.path.normpath(sys.executable) if isinstance(self.parallel, str): try: self.parallel = int(self.parallel) except ValueError: raise DistutilsOptionError("parallel should be an integer") def run(self) -> None: # Run all relevant sub-commands. This will be some subset of: # - build_py - pure Python modules # - build_clib - standalone C libraries # - build_ext - Python extensions # - build_scripts - (Python) scripts for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) # -- Predicates for the sub-command list --------------------------- def has_pure_modules(self): return self.distribution.has_pure_modules() def has_c_libraries(self): return self.distribution.has_c_libraries() def has_ext_modules(self): return self.distribution.has_ext_modules() def has_scripts(self): return self.distribution.has_scripts() sub_commands = [ ('build_py', has_pure_modules), ('build_clib', has_c_libraries), ('build_ext', has_ext_modules), ('build_scripts', has_scripts), ] _distutils/command/install_egg_info.py 0000644 00000005464 15030122015 0014220 0 ustar 00 """ distutils.command.install_egg_info Implements the Distutils 'install_egg_info' command, for installing a package's PKG-INFO metadata. """ import os import re import sys from typing import ClassVar from .. import dir_util from .._log import log from ..cmd import Command class install_egg_info(Command): """Install an .egg-info file for the package""" description = "Install package's PKG-INFO metadata as an .egg-info file" user_options: ClassVar[list[tuple[str, str, str]]] = [ ('install-dir=', 'd', "directory to install to"), ] def initialize_options(self): self.install_dir = None @property def basename(self): """ Allow basename to be overridden by child class. Ref pypa/distutils#2. """ name = to_filename(safe_name(self.distribution.get_name())) version = to_filename(safe_version(self.distribution.get_version())) return f"{name}-{version}-py{sys.version_info.major}.{sys.version_info.minor}.egg-info" def finalize_options(self): self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) self.target = os.path.join(self.install_dir, self.basename) self.outputs = [self.target] def run(self): target = self.target if os.path.isdir(target) and not os.path.islink(target): dir_util.remove_tree(target, dry_run=self.dry_run) elif os.path.exists(target): self.execute(os.unlink, (self.target,), "Removing " + target) elif not os.path.isdir(self.install_dir): self.execute( os.makedirs, (self.install_dir,), "Creating " + self.install_dir ) log.info("Writing %s", target) if not self.dry_run: with open(target, 'w', encoding='UTF-8') as f: self.distribution.metadata.write_pkg_file(f) def get_outputs(self): return self.outputs # The following routines are taken from setuptools' pkg_resources module and # can be replaced by importing them from pkg_resources once it is included # in the stdlib. def safe_name(name): """Convert an arbitrary string to a standard distribution name Any runs of non-alphanumeric/. characters are replaced with a single '-'. """ return re.sub('[^A-Za-z0-9.]+', '-', name) def safe_version(version): """Convert an arbitrary string to a standard version string Spaces become dots, and all other non-alphanumeric characters become dashes, with runs of multiple dashes condensed to a single dash. """ version = version.replace(' ', '.') return re.sub('[^A-Za-z0-9.]+', '-', version) def to_filename(name): """Convert a project or version name to its filename-escaped form Any '-' characters are currently replaced with '_'. """ return name.replace('-', '_') _distutils/command/install_headers.py 0000644 00000002370 15030122015 0014047 0 ustar 00 """distutils.command.install_headers Implements the Distutils 'install_headers' command, to install C/C++ header files to the Python include directory.""" from typing import ClassVar from ..core import Command # XXX force is never used class install_headers(Command): description = "install C/C++ header files" user_options: ClassVar[list[tuple[str, str, str]]] = [ ('install-dir=', 'd', "directory to install header files to"), ('force', 'f', "force installation (overwrite existing files)"), ] boolean_options: ClassVar[list[str]] = ['force'] def initialize_options(self): self.install_dir = None self.force = False self.outfiles = [] def finalize_options(self): self.set_undefined_options( 'install', ('install_headers', 'install_dir'), ('force', 'force') ) def run(self): headers = self.distribution.headers if not headers: return self.mkpath(self.install_dir) for header in headers: (out, _) = self.copy_file(header, self.install_dir) self.outfiles.append(out) def get_inputs(self): return self.distribution.headers or [] def get_outputs(self): return self.outfiles _distutils/command/check.py 0000644 00000011522 15030122015 0011762 0 ustar 00 """distutils.command.check Implements the Distutils 'check' command. """ import contextlib from typing import ClassVar from ..core import Command from ..errors import DistutilsSetupError with contextlib.suppress(ImportError): import docutils.frontend import docutils.nodes import docutils.parsers.rst import docutils.utils class SilentReporter(docutils.utils.Reporter): def __init__( self, source, report_level, halt_level, stream=None, debug=False, encoding='ascii', error_handler='replace', ): self.messages = [] super().__init__( source, report_level, halt_level, stream, debug, encoding, error_handler ) def system_message(self, level, message, *children, **kwargs): self.messages.append((level, message, children, kwargs)) return docutils.nodes.system_message( message, *children, level=level, type=self.levels[level], **kwargs ) class check(Command): """This command checks the meta-data of the package.""" description = "perform some checks on the package" user_options: ClassVar[list[tuple[str, str, str]]] = [ ('metadata', 'm', 'Verify meta-data'), ( 'restructuredtext', 'r', 'Checks if long string meta-data syntax are reStructuredText-compliant', ), ('strict', 's', 'Will exit with an error if a check fails'), ] boolean_options: ClassVar[list[str]] = ['metadata', 'restructuredtext', 'strict'] def initialize_options(self): """Sets default values for options.""" self.restructuredtext = False self.metadata = 1 self.strict = False self._warnings = 0 def finalize_options(self): pass def warn(self, msg): """Counts the number of warnings that occurs.""" self._warnings += 1 return Command.warn(self, msg) def run(self): """Runs the command.""" # perform the various tests if self.metadata: self.check_metadata() if self.restructuredtext: if 'docutils' in globals(): try: self.check_restructuredtext() except TypeError as exc: raise DistutilsSetupError(str(exc)) elif self.strict: raise DistutilsSetupError('The docutils package is needed.') # let's raise an error in strict mode, if we have at least # one warning if self.strict and self._warnings > 0: raise DistutilsSetupError('Please correct your package.') def check_metadata(self): """Ensures that all required elements of meta-data are supplied. Required fields: name, version Warns if any are missing. """ metadata = self.distribution.metadata missing = [ attr for attr in ('name', 'version') if not getattr(metadata, attr, None) ] if missing: self.warn("missing required meta-data: {}".format(', '.join(missing))) def check_restructuredtext(self): """Checks if the long string fields are reST-compliant.""" data = self.distribution.get_long_description() for warning in self._check_rst_data(data): line = warning[-1].get('line') if line is None: warning = warning[1] else: warning = f'{warning[1]} (line {line})' self.warn(warning) def _check_rst_data(self, data): """Returns warnings when the provided data doesn't compile.""" # the include and csv_table directives need this to be a path source_path = self.distribution.script_name or 'setup.py' parser = docutils.parsers.rst.Parser() settings = docutils.frontend.OptionParser( components=(docutils.parsers.rst.Parser,) ).get_default_values() settings.tab_width = 4 settings.pep_references = None settings.rfc_references = None reporter = SilentReporter( source_path, settings.report_level, settings.halt_level, stream=settings.warning_stream, debug=settings.debug, encoding=settings.error_encoding, error_handler=settings.error_encoding_error_handler, ) document = docutils.nodes.document(settings, reporter, source=source_path) document.note_source(source_path, -1) try: parser.parse(data, document) except (AttributeError, TypeError) as e: reporter.messages.append(( -1, f'Could not finish the parsing: {e}.', '', {}, )) return reporter.messages _distutils/command/build_ext.py 0000644 00000077706 15030122015 0012704 0 ustar 00 """distutils.command.build_ext Implements the Distutils 'build_ext' command, for building extension modules (currently limited to C extensions, should accommodate C++ extensions ASAP).""" from __future__ import annotations import contextlib import os import re import sys from collections.abc import Callable from distutils._log import log from site import USER_BASE from typing import ClassVar from .._modified import newer_group from ..ccompiler import new_compiler, show_compilers from ..core import Command from ..errors import ( CCompilerError, CompileError, DistutilsError, DistutilsOptionError, DistutilsPlatformError, DistutilsSetupError, ) from ..extension import Extension from ..sysconfig import customize_compiler, get_config_h_filename, get_python_version from ..util import get_platform, is_freethreaded, is_mingw # An extension name is just a dot-separated list of Python NAMEs (ie. # the same as a fully-qualified module name). extension_name_re = re.compile(r'^[a-zA-Z_][a-zA-Z_0-9]*(\.[a-zA-Z_][a-zA-Z_0-9]*)*$') class build_ext(Command): description = "build C/C++ extensions (compile/link to build directory)" # XXX thoughts on how to deal with complex command-line options like # these, i.e. how to make it so fancy_getopt can suck them off the # command line and make it look like setup.py defined the appropriate # lists of tuples of what-have-you. # - each command needs a callback to process its command-line options # - Command.__init__() needs access to its share of the whole # command line (must ultimately come from # Distribution.parse_command_line()) # - it then calls the current command class' option-parsing # callback to deal with weird options like -D, which have to # parse the option text and churn out some custom data # structure # - that data structure (in this case, a list of 2-tuples) # will then be present in the command object by the time # we get to finalize_options() (i.e. the constructor # takes care of both command-line and client options # in between initialize_options() and finalize_options()) sep_by = f" (separated by '{os.pathsep}')" user_options = [ ('build-lib=', 'b', "directory for compiled extension modules"), ('build-temp=', 't', "directory for temporary files (build by-products)"), ( 'plat-name=', 'p', "platform name to cross-compile for, if supported " f"[default: {get_platform()}]", ), ( 'inplace', 'i', "ignore build-lib and put compiled extensions into the source " "directory alongside your pure Python modules", ), ( 'include-dirs=', 'I', "list of directories to search for header files" + sep_by, ), ('define=', 'D', "C preprocessor macros to define"), ('undef=', 'U', "C preprocessor macros to undefine"), ('libraries=', 'l', "external C libraries to link with"), ( 'library-dirs=', 'L', "directories to search for external C libraries" + sep_by, ), ('rpath=', 'R', "directories to search for shared C libraries at runtime"), ('link-objects=', 'O', "extra explicit link objects to include in the link"), ('debug', 'g', "compile/link with debugging information"), ('force', 'f', "forcibly build everything (ignore file timestamps)"), ('compiler=', 'c', "specify the compiler type"), ('parallel=', 'j', "number of parallel build jobs"), ('swig-cpp', None, "make SWIG create C++ files (default is C)"), ('swig-opts=', None, "list of SWIG command line options"), ('swig=', None, "path to the SWIG executable"), ('user', None, "add user include, library and rpath"), ] boolean_options: ClassVar[list[str]] = [ 'inplace', 'debug', 'force', 'swig-cpp', 'user', ] help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ ('help-compiler', None, "list available compilers", show_compilers), ] def initialize_options(self): self.extensions = None self.build_lib = None self.plat_name = None self.build_temp = None self.inplace = False self.package = None self.include_dirs = None self.define = None self.undef = None self.libraries = None self.library_dirs = None self.rpath = None self.link_objects = None self.debug = None self.force = None self.compiler = None self.swig = None self.swig_cpp = None self.swig_opts = None self.user = None self.parallel = None @staticmethod def _python_lib_dir(sysconfig): """ Resolve Python's library directory for building extensions that rely on a shared Python library. See python/cpython#44264 and python/cpython#48686 """ if not sysconfig.get_config_var('Py_ENABLE_SHARED'): return if sysconfig.python_build: yield '.' return if sys.platform == 'zos': # On z/OS, a user is not required to install Python to # a predetermined path, but can use Python portably installed_dir = sysconfig.get_config_var('base') lib_dir = sysconfig.get_config_var('platlibdir') yield os.path.join(installed_dir, lib_dir) else: # building third party extensions yield sysconfig.get_config_var('LIBDIR') def finalize_options(self) -> None: # noqa: C901 from distutils import sysconfig self.set_undefined_options( 'build', ('build_lib', 'build_lib'), ('build_temp', 'build_temp'), ('compiler', 'compiler'), ('debug', 'debug'), ('force', 'force'), ('parallel', 'parallel'), ('plat_name', 'plat_name'), ) if self.package is None: self.package = self.distribution.ext_package self.extensions = self.distribution.ext_modules # Make sure Python's include directories (for Python.h, pyconfig.h, # etc.) are in the include search path. py_include = sysconfig.get_python_inc() plat_py_include = sysconfig.get_python_inc(plat_specific=True) if self.include_dirs is None: self.include_dirs = self.distribution.include_dirs or [] if isinstance(self.include_dirs, str): self.include_dirs = self.include_dirs.split(os.pathsep) # If in a virtualenv, add its include directory # Issue 16116 if sys.exec_prefix != sys.base_exec_prefix: self.include_dirs.append(os.path.join(sys.exec_prefix, 'include')) # Put the Python "system" include dir at the end, so that # any local include dirs take precedence. self.include_dirs.extend(py_include.split(os.path.pathsep)) if plat_py_include != py_include: self.include_dirs.extend(plat_py_include.split(os.path.pathsep)) self.ensure_string_list('libraries') self.ensure_string_list('link_objects') # Life is easier if we're not forever checking for None, so # simplify these options to empty lists if unset if self.libraries is None: self.libraries = [] if self.library_dirs is None: self.library_dirs = [] elif isinstance(self.library_dirs, str): self.library_dirs = self.library_dirs.split(os.pathsep) if self.rpath is None: self.rpath = [] elif isinstance(self.rpath, str): self.rpath = self.rpath.split(os.pathsep) # for extensions under windows use different directories # for Release and Debug builds. # also Python's library directory must be appended to library_dirs if os.name == 'nt' and not is_mingw(): # the 'libs' directory is for binary installs - we assume that # must be the *native* platform. But we don't really support # cross-compiling via a binary install anyway, so we let it go. self.library_dirs.append(os.path.join(sys.exec_prefix, 'libs')) if sys.base_exec_prefix != sys.prefix: # Issue 16116 self.library_dirs.append(os.path.join(sys.base_exec_prefix, 'libs')) if self.debug: self.build_temp = os.path.join(self.build_temp, "Debug") else: self.build_temp = os.path.join(self.build_temp, "Release") # Append the source distribution include and library directories, # this allows distutils on windows to work in the source tree self.include_dirs.append(os.path.dirname(get_config_h_filename())) self.library_dirs.append(sys.base_exec_prefix) # Use the .lib files for the correct architecture if self.plat_name == 'win32': suffix = 'win32' else: # win-amd64 suffix = self.plat_name[4:] new_lib = os.path.join(sys.exec_prefix, 'PCbuild') if suffix: new_lib = os.path.join(new_lib, suffix) self.library_dirs.append(new_lib) # For extensions under Cygwin, Python's library directory must be # appended to library_dirs if sys.platform[:6] == 'cygwin': if not sysconfig.python_build: # building third party extensions self.library_dirs.append( os.path.join( sys.prefix, "lib", "python" + get_python_version(), "config" ) ) else: # building python standard extensions self.library_dirs.append('.') self.library_dirs.extend(self._python_lib_dir(sysconfig)) # The argument parsing will result in self.define being a string, but # it has to be a list of 2-tuples. All the preprocessor symbols # specified by the 'define' option will be set to '1'. Multiple # symbols can be separated with commas. if self.define: defines = self.define.split(',') self.define = [(symbol, '1') for symbol in defines] # The option for macros to undefine is also a string from the # option parsing, but has to be a list. Multiple symbols can also # be separated with commas here. if self.undef: self.undef = self.undef.split(',') if self.swig_opts is None: self.swig_opts = [] else: self.swig_opts = self.swig_opts.split(' ') # Finally add the user include and library directories if requested if self.user: user_include = os.path.join(USER_BASE, "include") user_lib = os.path.join(USER_BASE, "lib") if os.path.isdir(user_include): self.include_dirs.append(user_include) if os.path.isdir(user_lib): self.library_dirs.append(user_lib) self.rpath.append(user_lib) if isinstance(self.parallel, str): try: self.parallel = int(self.parallel) except ValueError: raise DistutilsOptionError("parallel should be an integer") def run(self) -> None: # noqa: C901 # 'self.extensions', as supplied by setup.py, is a list of # Extension instances. See the documentation for Extension (in # distutils.extension) for details. # # For backwards compatibility with Distutils 0.8.2 and earlier, we # also allow the 'extensions' list to be a list of tuples: # (ext_name, build_info) # where build_info is a dictionary containing everything that # Extension instances do except the name, with a few things being # differently named. We convert these 2-tuples to Extension # instances as needed. if not self.extensions: return # If we were asked to build any C/C++ libraries, make sure that the # directory where we put them is in the library search path for # linking extensions. if self.distribution.has_c_libraries(): build_clib = self.get_finalized_command('build_clib') self.libraries.extend(build_clib.get_library_names() or []) self.library_dirs.append(build_clib.build_clib) # Setup the CCompiler object that we'll use to do all the # compiling and linking self.compiler = new_compiler( compiler=self.compiler, verbose=self.verbose, dry_run=self.dry_run, force=self.force, ) customize_compiler(self.compiler) # If we are cross-compiling, init the compiler now (if we are not # cross-compiling, init would not hurt, but people may rely on # late initialization of compiler even if they shouldn't...) if os.name == 'nt' and self.plat_name != get_platform(): self.compiler.initialize(self.plat_name) # The official Windows free threaded Python installer doesn't set # Py_GIL_DISABLED because its pyconfig.h is shared with the # default build, so define it here (pypa/setuptools#4662). if os.name == 'nt' and is_freethreaded(): self.compiler.define_macro('Py_GIL_DISABLED', '1') # And make sure that any compile/link-related options (which might # come from the command-line or from the setup script) are set in # that CCompiler object -- that way, they automatically apply to # all compiling and linking done here. if self.include_dirs is not None: self.compiler.set_include_dirs(self.include_dirs) if self.define is not None: # 'define' option is a list of (name,value) tuples for name, value in self.define: self.compiler.define_macro(name, value) if self.undef is not None: for macro in self.undef: self.compiler.undefine_macro(macro) if self.libraries is not None: self.compiler.set_libraries(self.libraries) if self.library_dirs is not None: self.compiler.set_library_dirs(self.library_dirs) if self.rpath is not None: self.compiler.set_runtime_library_dirs(self.rpath) if self.link_objects is not None: self.compiler.set_link_objects(self.link_objects) # Now actually compile and link everything. self.build_extensions() def check_extensions_list(self, extensions) -> None: # noqa: C901 """Ensure that the list of extensions (presumably provided as a command option 'extensions') is valid, i.e. it is a list of Extension objects. We also support the old-style list of 2-tuples, where the tuples are (ext_name, build_info), which are converted to Extension instances here. Raise DistutilsSetupError if the structure is invalid anywhere; just returns otherwise. """ if not isinstance(extensions, list): raise DistutilsSetupError( "'ext_modules' option must be a list of Extension instances" ) for i, ext in enumerate(extensions): if isinstance(ext, Extension): continue # OK! (assume type-checking done # by Extension constructor) if not isinstance(ext, tuple) or len(ext) != 2: raise DistutilsSetupError( "each element of 'ext_modules' option must be an " "Extension instance or 2-tuple" ) ext_name, build_info = ext log.warning( "old-style (ext_name, build_info) tuple found in " "ext_modules for extension '%s' " "-- please convert to Extension instance", ext_name, ) if not (isinstance(ext_name, str) and extension_name_re.match(ext_name)): raise DistutilsSetupError( "first element of each tuple in 'ext_modules' " "must be the extension name (a string)" ) if not isinstance(build_info, dict): raise DistutilsSetupError( "second element of each tuple in 'ext_modules' " "must be a dictionary (build info)" ) # OK, the (ext_name, build_info) dict is type-safe: convert it # to an Extension instance. ext = Extension(ext_name, build_info['sources']) # Easy stuff: one-to-one mapping from dict elements to # instance attributes. for key in ( 'include_dirs', 'library_dirs', 'libraries', 'extra_objects', 'extra_compile_args', 'extra_link_args', ): val = build_info.get(key) if val is not None: setattr(ext, key, val) # Medium-easy stuff: same syntax/semantics, different names. ext.runtime_library_dirs = build_info.get('rpath') if 'def_file' in build_info: log.warning("'def_file' element of build info dict no longer supported") # Non-trivial stuff: 'macros' split into 'define_macros' # and 'undef_macros'. macros = build_info.get('macros') if macros: ext.define_macros = [] ext.undef_macros = [] for macro in macros: if not (isinstance(macro, tuple) and len(macro) in (1, 2)): raise DistutilsSetupError( "'macros' element of build info dict must be 1- or 2-tuple" ) if len(macro) == 1: ext.undef_macros.append(macro[0]) elif len(macro) == 2: ext.define_macros.append(macro) extensions[i] = ext def get_source_files(self): self.check_extensions_list(self.extensions) filenames = [] # Wouldn't it be neat if we knew the names of header files too... for ext in self.extensions: filenames.extend(ext.sources) return filenames def get_outputs(self): # Sanity check the 'extensions' list -- can't assume this is being # done in the same run as a 'build_extensions()' call (in fact, we # can probably assume that it *isn't*!). self.check_extensions_list(self.extensions) # And build the list of output (built) filenames. Note that this # ignores the 'inplace' flag, and assumes everything goes in the # "build" tree. return [self.get_ext_fullpath(ext.name) for ext in self.extensions] def build_extensions(self) -> None: # First, sanity-check the 'extensions' list self.check_extensions_list(self.extensions) if self.parallel: self._build_extensions_parallel() else: self._build_extensions_serial() def _build_extensions_parallel(self): workers = self.parallel if self.parallel is True: workers = os.cpu_count() # may return None try: from concurrent.futures import ThreadPoolExecutor except ImportError: workers = None if workers is None: self._build_extensions_serial() return with ThreadPoolExecutor(max_workers=workers) as executor: futures = [ executor.submit(self.build_extension, ext) for ext in self.extensions ] for ext, fut in zip(self.extensions, futures): with self._filter_build_errors(ext): fut.result() def _build_extensions_serial(self): for ext in self.extensions: with self._filter_build_errors(ext): self.build_extension(ext) @contextlib.contextmanager def _filter_build_errors(self, ext): try: yield except (CCompilerError, DistutilsError, CompileError) as e: if not ext.optional: raise self.warn(f'building extension "{ext.name}" failed: {e}') def build_extension(self, ext) -> None: sources = ext.sources if sources is None or not isinstance(sources, (list, tuple)): raise DistutilsSetupError( f"in 'ext_modules' option (extension '{ext.name}'), " "'sources' must be present and must be " "a list of source filenames" ) # sort to make the resulting .so file build reproducible sources = sorted(sources) ext_path = self.get_ext_fullpath(ext.name) depends = sources + ext.depends if not (self.force or newer_group(depends, ext_path, 'newer')): log.debug("skipping '%s' extension (up-to-date)", ext.name) return else: log.info("building '%s' extension", ext.name) # First, scan the sources for SWIG definition files (.i), run # SWIG on 'em to create .c files, and modify the sources list # accordingly. sources = self.swig_sources(sources, ext) # Next, compile the source code to object files. # XXX not honouring 'define_macros' or 'undef_macros' -- the # CCompiler API needs to change to accommodate this, and I # want to do one thing at a time! # Two possible sources for extra compiler arguments: # - 'extra_compile_args' in Extension object # - CFLAGS environment variable (not particularly # elegant, but people seem to expect it and I # guess it's useful) # The environment variable should take precedence, and # any sensible compiler will give precedence to later # command line args. Hence we combine them in order: extra_args = ext.extra_compile_args or [] macros = ext.define_macros[:] for undef in ext.undef_macros: macros.append((undef,)) objects = self.compiler.compile( sources, output_dir=self.build_temp, macros=macros, include_dirs=ext.include_dirs, debug=self.debug, extra_postargs=extra_args, depends=ext.depends, ) # XXX outdated variable, kept here in case third-part code # needs it. self._built_objects = objects[:] # Now link the object files together into a "shared object" -- # of course, first we have to figure out all the other things # that go into the mix. if ext.extra_objects: objects.extend(ext.extra_objects) extra_args = ext.extra_link_args or [] # Detect target language, if not provided language = ext.language or self.compiler.detect_language(sources) self.compiler.link_shared_object( objects, ext_path, libraries=self.get_libraries(ext), library_dirs=ext.library_dirs, runtime_library_dirs=ext.runtime_library_dirs, extra_postargs=extra_args, export_symbols=self.get_export_symbols(ext), debug=self.debug, build_temp=self.build_temp, target_lang=language, ) def swig_sources(self, sources, extension): """Walk the list of source files in 'sources', looking for SWIG interface (.i) files. Run SWIG on all that are found, and return a modified 'sources' list with SWIG source files replaced by the generated C (or C++) files. """ new_sources = [] swig_sources = [] swig_targets = {} # XXX this drops generated C/C++ files into the source tree, which # is fine for developers who want to distribute the generated # source -- but there should be an option to put SWIG output in # the temp dir. if self.swig_cpp: log.warning("--swig-cpp is deprecated - use --swig-opts=-c++") if ( self.swig_cpp or ('-c++' in self.swig_opts) or ('-c++' in extension.swig_opts) ): target_ext = '.cpp' else: target_ext = '.c' for source in sources: (base, ext) = os.path.splitext(source) if ext == ".i": # SWIG interface file new_sources.append(base + '_wrap' + target_ext) swig_sources.append(source) swig_targets[source] = new_sources[-1] else: new_sources.append(source) if not swig_sources: return new_sources swig = self.swig or self.find_swig() swig_cmd = [swig, "-python"] swig_cmd.extend(self.swig_opts) if self.swig_cpp: swig_cmd.append("-c++") # Do not override commandline arguments if not self.swig_opts: swig_cmd.extend(extension.swig_opts) for source in swig_sources: target = swig_targets[source] log.info("swigging %s to %s", source, target) self.spawn(swig_cmd + ["-o", target, source]) return new_sources def find_swig(self): """Return the name of the SWIG executable. On Unix, this is just "swig" -- it should be in the PATH. Tries a bit harder on Windows. """ if os.name == "posix": return "swig" elif os.name == "nt": # Look for SWIG in its standard installation directory on # Windows (or so I presume!). If we find it there, great; # if not, act like Unix and assume it's in the PATH. for vers in ("1.3", "1.2", "1.1"): fn = os.path.join(f"c:\\swig{vers}", "swig.exe") if os.path.isfile(fn): return fn else: return "swig.exe" else: raise DistutilsPlatformError( f"I don't know how to find (much less run) SWIG on platform '{os.name}'" ) # -- Name generators ----------------------------------------------- # (extension names, filenames, whatever) def get_ext_fullpath(self, ext_name: str) -> str: """Returns the path of the filename for a given extension. The file is located in `build_lib` or directly in the package (inplace option). """ fullname = self.get_ext_fullname(ext_name) modpath = fullname.split('.') filename = self.get_ext_filename(modpath[-1]) if not self.inplace: # no further work needed # returning : # build_dir/package/path/filename filename = os.path.join(*modpath[:-1] + [filename]) return os.path.join(self.build_lib, filename) # the inplace option requires to find the package directory # using the build_py command for that package = '.'.join(modpath[0:-1]) build_py = self.get_finalized_command('build_py') package_dir = os.path.abspath(build_py.get_package_dir(package)) # returning # package_dir/filename return os.path.join(package_dir, filename) def get_ext_fullname(self, ext_name: str) -> str: """Returns the fullname of a given extension name. Adds the `package.` prefix""" if self.package is None: return ext_name else: return self.package + '.' + ext_name def get_ext_filename(self, ext_name: str) -> str: r"""Convert the name of an extension (eg. "foo.bar") into the name of the file from which it will be loaded (eg. "foo/bar.so", or "foo\bar.pyd"). """ from ..sysconfig import get_config_var ext_path = ext_name.split('.') ext_suffix = get_config_var('EXT_SUFFIX') return os.path.join(*ext_path) + ext_suffix def get_export_symbols(self, ext: Extension) -> list[str]: """Return the list of symbols that a shared extension has to export. This either uses 'ext.export_symbols' or, if it's not provided, "PyInit_" + module_name. Only relevant on Windows, where the .pyd file (DLL) must export the module "PyInit_" function. """ name = self._get_module_name_for_symbol(ext) try: # Unicode module name support as defined in PEP-489 # https://peps.python.org/pep-0489/#export-hook-name name.encode('ascii') except UnicodeEncodeError: suffix = 'U_' + name.encode('punycode').replace(b'-', b'_').decode('ascii') else: suffix = "_" + name initfunc_name = "PyInit" + suffix if initfunc_name not in ext.export_symbols: ext.export_symbols.append(initfunc_name) return ext.export_symbols def _get_module_name_for_symbol(self, ext): # Package name should be used for `__init__` modules # https://github.com/python/cpython/issues/80074 # https://github.com/pypa/setuptools/issues/4826 parts = ext.name.split(".") if parts[-1] == "__init__" and len(parts) >= 2: return parts[-2] return parts[-1] def get_libraries(self, ext: Extension) -> list[str]: # noqa: C901 """Return the list of libraries to link against when building a shared extension. On most platforms, this is just 'ext.libraries'; on Windows, we add the Python library (eg. python20.dll). """ # The python library is always needed on Windows. For MSVC, this # is redundant, since the library is mentioned in a pragma in # pyconfig.h that MSVC groks. The other Windows compilers all seem # to need it mentioned explicitly, though, so that's what we do. # Append '_d' to the python import library on debug builds. if sys.platform == "win32" and not is_mingw(): from .._msvccompiler import MSVCCompiler if not isinstance(self.compiler, MSVCCompiler): template = "python%d%d" if self.debug: template = template + '_d' pythonlib = template % ( sys.hexversion >> 24, (sys.hexversion >> 16) & 0xFF, ) # don't extend ext.libraries, it may be shared with other # extensions, it is a reference to the original list return ext.libraries + [pythonlib] else: # On Android only the main executable and LD_PRELOADs are considered # to be RTLD_GLOBAL, all the dependencies of the main executable # remain RTLD_LOCAL and so the shared libraries must be linked with # libpython when python is built with a shared python library (issue # bpo-21536). # On Cygwin (and if required, other POSIX-like platforms based on # Windows like MinGW) it is simply necessary that all symbols in # shared libraries are resolved at link time. from ..sysconfig import get_config_var link_libpython = False if get_config_var('Py_ENABLE_SHARED'): # A native build on an Android device or on Cygwin if hasattr(sys, 'getandroidapilevel'): link_libpython = True elif sys.platform == 'cygwin' or is_mingw(): link_libpython = True elif '_PYTHON_HOST_PLATFORM' in os.environ: # We are cross-compiling for one of the relevant platforms if get_config_var('ANDROID_API_LEVEL') != 0: link_libpython = True elif get_config_var('MACHDEP') == 'cygwin': link_libpython = True if link_libpython: ldversion = get_config_var('LDVERSION') return ext.libraries + ['python' + ldversion] return ext.libraries _distutils/command/config.py 0000644 00000031022 15030122015 0012147 0 ustar 00 """distutils.command.config Implements the Distutils 'config' command, a (mostly) empty command class that exists mainly to be sub-classed by specific module distributions and applications. The idea is that while every "config" command is different, at least they're all named the same, and users always see "config" in the list of standard commands. Also, this is a good place to put common configure-like tasks: "try to compile this C code", or "figure out where this header file lives". """ from __future__ import annotations import os import pathlib import re from collections.abc import Sequence from distutils._log import log from ..ccompiler import CCompiler, CompileError, LinkError, new_compiler from ..core import Command from ..errors import DistutilsExecError from ..sysconfig import customize_compiler LANG_EXT = {"c": ".c", "c++": ".cxx"} class config(Command): description = "prepare to build" user_options = [ ('compiler=', None, "specify the compiler type"), ('cc=', None, "specify the compiler executable"), ('include-dirs=', 'I', "list of directories to search for header files"), ('define=', 'D', "C preprocessor macros to define"), ('undef=', 'U', "C preprocessor macros to undefine"), ('libraries=', 'l', "external C libraries to link with"), ('library-dirs=', 'L', "directories to search for external C libraries"), ('noisy', None, "show every action (compile, link, run, ...) taken"), ( 'dump-source', None, "dump generated source files before attempting to compile them", ), ] # The three standard command methods: since the "config" command # does nothing by default, these are empty. def initialize_options(self): self.compiler = None self.cc = None self.include_dirs = None self.libraries = None self.library_dirs = None # maximal output for now self.noisy = 1 self.dump_source = 1 # list of temporary files generated along-the-way that we have # to clean at some point self.temp_files = [] def finalize_options(self): if self.include_dirs is None: self.include_dirs = self.distribution.include_dirs or [] elif isinstance(self.include_dirs, str): self.include_dirs = self.include_dirs.split(os.pathsep) if self.libraries is None: self.libraries = [] elif isinstance(self.libraries, str): self.libraries = [self.libraries] if self.library_dirs is None: self.library_dirs = [] elif isinstance(self.library_dirs, str): self.library_dirs = self.library_dirs.split(os.pathsep) def run(self): pass # Utility methods for actual "config" commands. The interfaces are # loosely based on Autoconf macros of similar names. Sub-classes # may use these freely. def _check_compiler(self): """Check that 'self.compiler' really is a CCompiler object; if not, make it one. """ # We do this late, and only on-demand, because this is an expensive # import. if not isinstance(self.compiler, CCompiler): self.compiler = new_compiler( compiler=self.compiler, dry_run=self.dry_run, force=True ) customize_compiler(self.compiler) if self.include_dirs: self.compiler.set_include_dirs(self.include_dirs) if self.libraries: self.compiler.set_libraries(self.libraries) if self.library_dirs: self.compiler.set_library_dirs(self.library_dirs) def _gen_temp_sourcefile(self, body, headers, lang): filename = "_configtest" + LANG_EXT[lang] with open(filename, "w", encoding='utf-8') as file: if headers: for header in headers: file.write(f"#include <{header}>\n") file.write("\n") file.write(body) if body[-1] != "\n": file.write("\n") return filename def _preprocess(self, body, headers, include_dirs, lang): src = self._gen_temp_sourcefile(body, headers, lang) out = "_configtest.i" self.temp_files.extend([src, out]) self.compiler.preprocess(src, out, include_dirs=include_dirs) return (src, out) def _compile(self, body, headers, include_dirs, lang): src = self._gen_temp_sourcefile(body, headers, lang) if self.dump_source: dump_file(src, f"compiling '{src}':") (obj,) = self.compiler.object_filenames([src]) self.temp_files.extend([src, obj]) self.compiler.compile([src], include_dirs=include_dirs) return (src, obj) def _link(self, body, headers, include_dirs, libraries, library_dirs, lang): (src, obj) = self._compile(body, headers, include_dirs, lang) prog = os.path.splitext(os.path.basename(src))[0] self.compiler.link_executable( [obj], prog, libraries=libraries, library_dirs=library_dirs, target_lang=lang, ) if self.compiler.exe_extension is not None: prog = prog + self.compiler.exe_extension self.temp_files.append(prog) return (src, obj, prog) def _clean(self, *filenames): if not filenames: filenames = self.temp_files self.temp_files = [] log.info("removing: %s", ' '.join(filenames)) for filename in filenames: try: os.remove(filename) except OSError: pass # XXX these ignore the dry-run flag: what to do, what to do? even if # you want a dry-run build, you still need some sort of configuration # info. My inclination is to make it up to the real config command to # consult 'dry_run', and assume a default (minimal) configuration if # true. The problem with trying to do it here is that you'd have to # return either true or false from all the 'try' methods, neither of # which is correct. # XXX need access to the header search path and maybe default macros. def try_cpp(self, body=None, headers=None, include_dirs=None, lang="c"): """Construct a source file from 'body' (a string containing lines of C/C++ code) and 'headers' (a list of header files to include) and run it through the preprocessor. Return true if the preprocessor succeeded, false if there were any errors. ('body' probably isn't of much use, but what the heck.) """ self._check_compiler() ok = True try: self._preprocess(body, headers, include_dirs, lang) except CompileError: ok = False self._clean() return ok def search_cpp(self, pattern, body=None, headers=None, include_dirs=None, lang="c"): """Construct a source file (just like 'try_cpp()'), run it through the preprocessor, and return true if any line of the output matches 'pattern'. 'pattern' should either be a compiled regex object or a string containing a regex. If both 'body' and 'headers' are None, preprocesses an empty file -- which can be useful to determine the symbols the preprocessor and compiler set by default. """ self._check_compiler() src, out = self._preprocess(body, headers, include_dirs, lang) if isinstance(pattern, str): pattern = re.compile(pattern) with open(out, encoding='utf-8') as file: match = any(pattern.search(line) for line in file) self._clean() return match def try_compile(self, body, headers=None, include_dirs=None, lang="c"): """Try to compile a source file built from 'body' and 'headers'. Return true on success, false otherwise. """ self._check_compiler() try: self._compile(body, headers, include_dirs, lang) ok = True except CompileError: ok = False log.info(ok and "success!" or "failure.") self._clean() return ok def try_link( self, body, headers=None, include_dirs=None, libraries=None, library_dirs=None, lang="c", ): """Try to compile and link a source file, built from 'body' and 'headers', to executable form. Return true on success, false otherwise. """ self._check_compiler() try: self._link(body, headers, include_dirs, libraries, library_dirs, lang) ok = True except (CompileError, LinkError): ok = False log.info(ok and "success!" or "failure.") self._clean() return ok def try_run( self, body, headers=None, include_dirs=None, libraries=None, library_dirs=None, lang="c", ): """Try to compile, link to an executable, and run a program built from 'body' and 'headers'. Return true on success, false otherwise. """ self._check_compiler() try: src, obj, exe = self._link( body, headers, include_dirs, libraries, library_dirs, lang ) self.spawn([exe]) ok = True except (CompileError, LinkError, DistutilsExecError): ok = False log.info(ok and "success!" or "failure.") self._clean() return ok # -- High-level methods -------------------------------------------- # (these are the ones that are actually likely to be useful # when implementing a real-world config command!) def check_func( self, func, headers=None, include_dirs=None, libraries=None, library_dirs=None, decl=False, call=False, ): """Determine if function 'func' is available by constructing a source file that refers to 'func', and compiles and links it. If everything succeeds, returns true; otherwise returns false. The constructed source file starts out by including the header files listed in 'headers'. If 'decl' is true, it then declares 'func' (as "int func()"); you probably shouldn't supply 'headers' and set 'decl' true in the same call, or you might get errors about a conflicting declarations for 'func'. Finally, the constructed 'main()' function either references 'func' or (if 'call' is true) calls it. 'libraries' and 'library_dirs' are used when linking. """ self._check_compiler() body = [] if decl: body.append(f"int {func} ();") body.append("int main () {") if call: body.append(f" {func}();") else: body.append(f" {func};") body.append("}") body = "\n".join(body) + "\n" return self.try_link(body, headers, include_dirs, libraries, library_dirs) def check_lib( self, library, library_dirs=None, headers=None, include_dirs=None, other_libraries: Sequence[str] = [], ): """Determine if 'library' is available to be linked against, without actually checking that any particular symbols are provided by it. 'headers' will be used in constructing the source file to be compiled, but the only effect of this is to check if all the header files listed are available. Any libraries listed in 'other_libraries' will be included in the link, in case 'library' has symbols that depend on other libraries. """ self._check_compiler() return self.try_link( "int main (void) { }", headers, include_dirs, [library] + list(other_libraries), library_dirs, ) def check_header(self, header, include_dirs=None, library_dirs=None, lang="c"): """Determine if the system header file named by 'header_file' exists and can be found by the preprocessor; return true if so, false otherwise. """ return self.try_cpp( body="/* No body */", headers=[header], include_dirs=include_dirs ) def dump_file(filename, head=None): """Dumps a file content into log.info. If head is not None, will be dumped before the file content. """ if head is None: log.info('%s', filename) else: log.info(head) log.info(pathlib.Path(filename).read_text(encoding='utf-8')) _distutils/command/build_scripts.py 0000644 00000011776 15030122015 0013566 0 ustar 00 """distutils.command.build_scripts Implements the Distutils 'build_scripts' command.""" import os import re import tokenize from distutils._log import log from stat import ST_MODE from typing import ClassVar from .._modified import newer from ..core import Command from ..util import convert_path shebang_pattern = re.compile('^#!.*python[0-9.]*([ \t].*)?$') """ Pattern matching a Python interpreter indicated in first line of a script. """ # for Setuptools compatibility first_line_re = shebang_pattern class build_scripts(Command): description = "\"build\" scripts (copy and fixup #! line)" user_options: ClassVar[list[tuple[str, str, str]]] = [ ('build-dir=', 'd', "directory to \"build\" (copy) to"), ('force', 'f', "forcibly build everything (ignore file timestamps"), ('executable=', 'e', "specify final destination interpreter path"), ] boolean_options: ClassVar[list[str]] = ['force'] def initialize_options(self): self.build_dir = None self.scripts = None self.force = None self.executable = None def finalize_options(self): self.set_undefined_options( 'build', ('build_scripts', 'build_dir'), ('force', 'force'), ('executable', 'executable'), ) self.scripts = self.distribution.scripts def get_source_files(self): return self.scripts def run(self): if not self.scripts: return self.copy_scripts() def copy_scripts(self): """ Copy each script listed in ``self.scripts``. If a script is marked as a Python script (first line matches 'shebang_pattern', i.e. starts with ``#!`` and contains "python"), then adjust in the copy the first line to refer to the current Python interpreter. """ self.mkpath(self.build_dir) outfiles = [] updated_files = [] for script in self.scripts: self._copy_script(script, outfiles, updated_files) self._change_modes(outfiles) return outfiles, updated_files def _copy_script(self, script, outfiles, updated_files): shebang_match = None script = convert_path(script) outfile = os.path.join(self.build_dir, os.path.basename(script)) outfiles.append(outfile) if not self.force and not newer(script, outfile): log.debug("not copying %s (up-to-date)", script) return # Always open the file, but ignore failures in dry-run mode # in order to attempt to copy directly. try: f = tokenize.open(script) except OSError: if not self.dry_run: raise f = None else: first_line = f.readline() if not first_line: self.warn(f"{script} is an empty file (skipping)") return shebang_match = shebang_pattern.match(first_line) updated_files.append(outfile) if shebang_match: log.info("copying and adjusting %s -> %s", script, self.build_dir) if not self.dry_run: post_interp = shebang_match.group(1) or '' shebang = f"#!python{post_interp}\n" self._validate_shebang(shebang, f.encoding) with open(outfile, "w", encoding=f.encoding) as outf: outf.write(shebang) outf.writelines(f.readlines()) if f: f.close() else: if f: f.close() self.copy_file(script, outfile) def _change_modes(self, outfiles): if os.name != 'posix': return for file in outfiles: self._change_mode(file) def _change_mode(self, file): if self.dry_run: log.info("changing mode of %s", file) return oldmode = os.stat(file)[ST_MODE] & 0o7777 newmode = (oldmode | 0o555) & 0o7777 if newmode != oldmode: log.info("changing mode of %s from %o to %o", file, oldmode, newmode) os.chmod(file, newmode) @staticmethod def _validate_shebang(shebang, encoding): # Python parser starts to read a script using UTF-8 until # it gets a #coding:xxx cookie. The shebang has to be the # first line of a file, the #coding:xxx cookie cannot be # written before. So the shebang has to be encodable to # UTF-8. try: shebang.encode('utf-8') except UnicodeEncodeError: raise ValueError(f"The shebang ({shebang!r}) is not encodable to utf-8") # If the script is encoded to a custom encoding (use a # #coding:xxx cookie), the shebang has to be encodable to # the script encoding too. try: shebang.encode(encoding) except UnicodeEncodeError: raise ValueError( f"The shebang ({shebang!r}) is not encodable " f"to the script encoding ({encoding})" ) _distutils/command/_framework_compat.py 0000644 00000003111 15030122015 0014377 0 ustar 00 """ Backward compatibility for homebrew builds on macOS. """ import functools import os import subprocess import sys import sysconfig @functools.lru_cache def enabled(): """ Only enabled for Python 3.9 framework homebrew builds except ensurepip and venv. """ PY39 = (3, 9) < sys.version_info < (3, 10) framework = sys.platform == 'darwin' and sys._framework homebrew = "Cellar" in sysconfig.get_config_var('projectbase') venv = sys.prefix != sys.base_prefix ensurepip = os.environ.get("ENSUREPIP_OPTIONS") return PY39 and framework and homebrew and not venv and not ensurepip schemes = dict( osx_framework_library=dict( stdlib='{installed_base}/{platlibdir}/python{py_version_short}', platstdlib='{platbase}/{platlibdir}/python{py_version_short}', purelib='{homebrew_prefix}/lib/python{py_version_short}/site-packages', platlib='{homebrew_prefix}/{platlibdir}/python{py_version_short}/site-packages', include='{installed_base}/include/python{py_version_short}{abiflags}', platinclude='{installed_platbase}/include/python{py_version_short}{abiflags}', scripts='{homebrew_prefix}/bin', data='{homebrew_prefix}', ) ) @functools.lru_cache def vars(): if not enabled(): return {} homebrew_prefix = subprocess.check_output(['brew', '--prefix'], text=True).strip() return locals() def scheme(name): """ Override the selected scheme for posix_prefix. """ if not enabled() or not name.endswith('_prefix'): return name return 'osx_framework_library' _distutils/command/sdist.py 0000644 00000045317 15030122015 0012044 0 ustar 00 """distutils.command.sdist Implements the Distutils 'sdist' command (create a source distribution).""" from __future__ import annotations import os import sys from collections.abc import Callable from distutils import archive_util, dir_util, file_util from distutils._log import log from glob import glob from itertools import filterfalse from typing import ClassVar from ..core import Command from ..errors import DistutilsOptionError, DistutilsTemplateError from ..filelist import FileList from ..text_file import TextFile from ..util import convert_path def show_formats(): """Print all possible values for the 'formats' option (used by the "--help-formats" command-line option). """ from ..archive_util import ARCHIVE_FORMATS from ..fancy_getopt import FancyGetopt formats = sorted( ("formats=" + format, None, ARCHIVE_FORMATS[format][2]) for format in ARCHIVE_FORMATS.keys() ) FancyGetopt(formats).print_help("List of available source distribution formats:") class sdist(Command): description = "create a source distribution (tarball, zip file, etc.)" def checking_metadata(self) -> bool: """Callable used for the check sub-command. Placed here so user_options can view it""" return self.metadata_check user_options = [ ('template=', 't', "name of manifest template file [default: MANIFEST.in]"), ('manifest=', 'm', "name of manifest file [default: MANIFEST]"), ( 'use-defaults', None, "include the default file set in the manifest " "[default; disable with --no-defaults]", ), ('no-defaults', None, "don't include the default file set"), ( 'prune', None, "specifically exclude files/directories that should not be " "distributed (build tree, RCS/CVS dirs, etc.) " "[default; disable with --no-prune]", ), ('no-prune', None, "don't automatically exclude anything"), ( 'manifest-only', 'o', "just regenerate the manifest and then stop (implies --force-manifest)", ), ( 'force-manifest', 'f', "forcibly regenerate the manifest and carry on as usual. " "Deprecated: now the manifest is always regenerated.", ), ('formats=', None, "formats for source distribution (comma-separated list)"), ( 'keep-temp', 'k', "keep the distribution tree around after creating " + "archive file(s)", ), ( 'dist-dir=', 'd', "directory to put the source distribution archive(s) in [default: dist]", ), ( 'metadata-check', None, "Ensure that all required elements of meta-data " "are supplied. Warn if any missing. [default]", ), ( 'owner=', 'u', "Owner name used when creating a tar file [default: current user]", ), ( 'group=', 'g', "Group name used when creating a tar file [default: current group]", ), ] boolean_options: ClassVar[list[str]] = [ 'use-defaults', 'prune', 'manifest-only', 'force-manifest', 'keep-temp', 'metadata-check', ] help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ ('help-formats', None, "list available distribution formats", show_formats), ] negative_opt: ClassVar[dict[str, str]] = { 'no-defaults': 'use-defaults', 'no-prune': 'prune', } sub_commands = [('check', checking_metadata)] READMES: ClassVar[tuple[str, ...]] = ('README', 'README.txt', 'README.rst') def initialize_options(self): # 'template' and 'manifest' are, respectively, the names of # the manifest template and manifest file. self.template = None self.manifest = None # 'use_defaults': if true, we will include the default file set # in the manifest self.use_defaults = True self.prune = True self.manifest_only = False self.force_manifest = False self.formats = ['gztar'] self.keep_temp = False self.dist_dir = None self.archive_files = None self.metadata_check = True self.owner = None self.group = None def finalize_options(self) -> None: if self.manifest is None: self.manifest = "MANIFEST" if self.template is None: self.template = "MANIFEST.in" self.ensure_string_list('formats') bad_format = archive_util.check_archive_formats(self.formats) if bad_format: raise DistutilsOptionError(f"unknown archive format '{bad_format}'") if self.dist_dir is None: self.dist_dir = "dist" def run(self) -> None: # 'filelist' contains the list of files that will make up the # manifest self.filelist = FileList() # Run sub commands for cmd_name in self.get_sub_commands(): self.run_command(cmd_name) # Do whatever it takes to get the list of files to process # (process the manifest template, read an existing manifest, # whatever). File list is accumulated in 'self.filelist'. self.get_file_list() # If user just wanted us to regenerate the manifest, stop now. if self.manifest_only: return # Otherwise, go ahead and create the source distribution tarball, # or zipfile, or whatever. self.make_distribution() def get_file_list(self) -> None: """Figure out the list of files to include in the source distribution, and put it in 'self.filelist'. This might involve reading the manifest template (and writing the manifest), or just reading the manifest, or just using the default file set -- it all depends on the user's options. """ # new behavior when using a template: # the file list is recalculated every time because # even if MANIFEST.in or setup.py are not changed # the user might have added some files in the tree that # need to be included. # # This makes --force the default and only behavior with templates. template_exists = os.path.isfile(self.template) if not template_exists and self._manifest_is_not_generated(): self.read_manifest() self.filelist.sort() self.filelist.remove_duplicates() return if not template_exists: self.warn( ("manifest template '%s' does not exist " + "(using default file list)") % self.template ) self.filelist.findall() if self.use_defaults: self.add_defaults() if template_exists: self.read_template() if self.prune: self.prune_file_list() self.filelist.sort() self.filelist.remove_duplicates() self.write_manifest() def add_defaults(self) -> None: """Add all the default files to self.filelist: - README or README.txt - setup.py - tests/test*.py and test/test*.py - all pure Python modules mentioned in setup script - all files pointed by package_data (build_py) - all files defined in data_files. - all files defined as scripts. - all C sources listed as part of extensions or C libraries in the setup script (doesn't catch C headers!) Warns if (README or README.txt) or setup.py are missing; everything else is optional. """ self._add_defaults_standards() self._add_defaults_optional() self._add_defaults_python() self._add_defaults_data_files() self._add_defaults_ext() self._add_defaults_c_libs() self._add_defaults_scripts() @staticmethod def _cs_path_exists(fspath): """ Case-sensitive path existence check >>> sdist._cs_path_exists(__file__) True >>> sdist._cs_path_exists(__file__.upper()) False """ if not os.path.exists(fspath): return False # make absolute so we always have a directory abspath = os.path.abspath(fspath) directory, filename = os.path.split(abspath) return filename in os.listdir(directory) def _add_defaults_standards(self): standards = [self.READMES, self.distribution.script_name] for fn in standards: if isinstance(fn, tuple): alts = fn got_it = False for fn in alts: if self._cs_path_exists(fn): got_it = True self.filelist.append(fn) break if not got_it: self.warn( "standard file not found: should have one of " + ', '.join(alts) ) else: if self._cs_path_exists(fn): self.filelist.append(fn) else: self.warn(f"standard file '{fn}' not found") def _add_defaults_optional(self): optional = ['tests/test*.py', 'test/test*.py', 'setup.cfg'] for pattern in optional: files = filter(os.path.isfile, glob(pattern)) self.filelist.extend(files) def _add_defaults_python(self): # build_py is used to get: # - python modules # - files defined in package_data build_py = self.get_finalized_command('build_py') # getting python files if self.distribution.has_pure_modules(): self.filelist.extend(build_py.get_source_files()) # getting package_data files # (computed in build_py.data_files by build_py.finalize_options) for _pkg, src_dir, _build_dir, filenames in build_py.data_files: for filename in filenames: self.filelist.append(os.path.join(src_dir, filename)) def _add_defaults_data_files(self): # getting distribution.data_files if self.distribution.has_data_files(): for item in self.distribution.data_files: if isinstance(item, str): # plain file item = convert_path(item) if os.path.isfile(item): self.filelist.append(item) else: # a (dirname, filenames) tuple dirname, filenames = item for f in filenames: f = convert_path(f) if os.path.isfile(f): self.filelist.append(f) def _add_defaults_ext(self): if self.distribution.has_ext_modules(): build_ext = self.get_finalized_command('build_ext') self.filelist.extend(build_ext.get_source_files()) def _add_defaults_c_libs(self): if self.distribution.has_c_libraries(): build_clib = self.get_finalized_command('build_clib') self.filelist.extend(build_clib.get_source_files()) def _add_defaults_scripts(self): if self.distribution.has_scripts(): build_scripts = self.get_finalized_command('build_scripts') self.filelist.extend(build_scripts.get_source_files()) def read_template(self) -> None: """Read and parse manifest template file named by self.template. (usually "MANIFEST.in") The parsing and processing is done by 'self.filelist', which updates itself accordingly. """ log.info("reading manifest template '%s'", self.template) template = TextFile( self.template, strip_comments=True, skip_blanks=True, join_lines=True, lstrip_ws=True, rstrip_ws=True, collapse_join=True, ) try: while True: line = template.readline() if line is None: # end of file break try: self.filelist.process_template_line(line) # the call above can raise a DistutilsTemplateError for # malformed lines, or a ValueError from the lower-level # convert_path function except (DistutilsTemplateError, ValueError) as msg: self.warn( f"{template.filename}, line {int(template.current_line)}: {msg}" ) finally: template.close() def prune_file_list(self) -> None: """Prune off branches that might slip into the file list as created by 'read_template()', but really don't belong there: * the build tree (typically "build") * the release tree itself (only an issue if we ran "sdist" previously with --keep-temp, or it aborted) * any RCS, CVS, .svn, .hg, .git, .bzr, _darcs directories """ build = self.get_finalized_command('build') base_dir = self.distribution.get_fullname() self.filelist.exclude_pattern(None, prefix=os.fspath(build.build_base)) self.filelist.exclude_pattern(None, prefix=base_dir) if sys.platform == 'win32': seps = r'/|\\' else: seps = '/' vcs_dirs = ['RCS', 'CVS', r'\.svn', r'\.hg', r'\.git', r'\.bzr', '_darcs'] vcs_ptrn = r'(^|{})({})({}).*'.format(seps, '|'.join(vcs_dirs), seps) self.filelist.exclude_pattern(vcs_ptrn, is_regex=True) def write_manifest(self) -> None: """Write the file list in 'self.filelist' (presumably as filled in by 'add_defaults()' and 'read_template()') to the manifest file named by 'self.manifest'. """ if self._manifest_is_not_generated(): log.info( f"not writing to manually maintained manifest file '{self.manifest}'" ) return content = self.filelist.files[:] content.insert(0, '# file GENERATED by distutils, do NOT edit') self.execute( file_util.write_file, (self.manifest, content), f"writing manifest file '{self.manifest}'", ) def _manifest_is_not_generated(self): # check for special comment used in 3.1.3 and higher if not os.path.isfile(self.manifest): return False with open(self.manifest, encoding='utf-8') as fp: first_line = next(fp) return first_line != '# file GENERATED by distutils, do NOT edit\n' def read_manifest(self) -> None: """Read the manifest file (named by 'self.manifest') and use it to fill in 'self.filelist', the list of files to include in the source distribution. """ log.info("reading manifest file '%s'", self.manifest) with open(self.manifest, encoding='utf-8') as lines: self.filelist.extend( # ignore comments and blank lines filter(None, filterfalse(is_comment, map(str.strip, lines))) ) def make_release_tree(self, base_dir, files) -> None: """Create the directory tree that will become the source distribution archive. All directories implied by the filenames in 'files' are created under 'base_dir', and then we hard link or copy (if hard linking is unavailable) those files into place. Essentially, this duplicates the developer's source tree, but in a directory named after the distribution, containing only the files to be distributed. """ # Create all the directories under 'base_dir' necessary to # put 'files' there; the 'mkpath()' is just so we don't die # if the manifest happens to be empty. self.mkpath(base_dir) dir_util.create_tree(base_dir, files, dry_run=self.dry_run) # And walk over the list of files, either making a hard link (if # os.link exists) to each one that doesn't already exist in its # corresponding location under 'base_dir', or copying each file # that's out-of-date in 'base_dir'. (Usually, all files will be # out-of-date, because by default we blow away 'base_dir' when # we're done making the distribution archives.) if hasattr(os, 'link'): # can make hard links on this system link = 'hard' msg = f"making hard links in {base_dir}..." else: # nope, have to copy link = None msg = f"copying files to {base_dir}..." if not files: log.warning("no files to distribute -- empty manifest?") else: log.info(msg) for file in files: if not os.path.isfile(file): log.warning("'%s' not a regular file -- skipping", file) else: dest = os.path.join(base_dir, file) self.copy_file(file, dest, link=link) self.distribution.metadata.write_pkg_info(base_dir) def make_distribution(self) -> None: """Create the source distribution(s). First, we create the release tree with 'make_release_tree()'; then, we create all required archive files (according to 'self.formats') from the release tree. Finally, we clean up by blowing away the release tree (unless 'self.keep_temp' is true). The list of archive files created is stored so it can be retrieved later by 'get_archive_files()'. """ # Don't warn about missing meta-data here -- should be (and is!) # done elsewhere. base_dir = self.distribution.get_fullname() base_name = os.path.join(self.dist_dir, base_dir) self.make_release_tree(base_dir, self.filelist.files) archive_files = [] # remember names of files we create # tar archive must be created last to avoid overwrite and remove if 'tar' in self.formats: self.formats.append(self.formats.pop(self.formats.index('tar'))) for fmt in self.formats: file = self.make_archive( base_name, fmt, base_dir=base_dir, owner=self.owner, group=self.group ) archive_files.append(file) self.distribution.dist_files.append(('sdist', '', file)) self.archive_files = archive_files if not self.keep_temp: dir_util.remove_tree(base_dir, dry_run=self.dry_run) def get_archive_files(self): """Return the list of archive files created when the command was run, or None if the command hasn't run yet. """ return self.archive_files def is_comment(line: str) -> bool: return line.startswith('#') _distutils/command/bdist_dumb.py 0000644 00000011027 15030122015 0013021 0 ustar 00 """distutils.command.bdist_dumb Implements the Distutils 'bdist_dumb' command (create a "dumb" built distribution -- i.e., just an archive to be unpacked under $prefix or $exec_prefix).""" import os from distutils._log import log from typing import ClassVar from ..core import Command from ..dir_util import ensure_relative, remove_tree from ..errors import DistutilsPlatformError from ..sysconfig import get_python_version from ..util import get_platform class bdist_dumb(Command): description = "create a \"dumb\" built distribution" user_options = [ ('bdist-dir=', 'd', "temporary directory for creating the distribution"), ( 'plat-name=', 'p', "platform name to embed in generated filenames " f"[default: {get_platform()}]", ), ( 'format=', 'f', "archive format to create (tar, gztar, bztar, xztar, ztar, zip)", ), ( 'keep-temp', 'k', "keep the pseudo-installation tree around after creating the distribution archive", ), ('dist-dir=', 'd', "directory to put final built distributions in"), ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), ( 'relative', None, "build the archive using relative paths [default: false]", ), ( 'owner=', 'u', "Owner name used when creating a tar file [default: current user]", ), ( 'group=', 'g', "Group name used when creating a tar file [default: current group]", ), ] boolean_options: ClassVar[list[str]] = ['keep-temp', 'skip-build', 'relative'] default_format = {'posix': 'gztar', 'nt': 'zip'} def initialize_options(self): self.bdist_dir = None self.plat_name = None self.format = None self.keep_temp = False self.dist_dir = None self.skip_build = None self.relative = False self.owner = None self.group = None def finalize_options(self): if self.bdist_dir is None: bdist_base = self.get_finalized_command('bdist').bdist_base self.bdist_dir = os.path.join(bdist_base, 'dumb') if self.format is None: try: self.format = self.default_format[os.name] except KeyError: raise DistutilsPlatformError( "don't know how to create dumb built distributions " f"on platform {os.name}" ) self.set_undefined_options( 'bdist', ('dist_dir', 'dist_dir'), ('plat_name', 'plat_name'), ('skip_build', 'skip_build'), ) def run(self): if not self.skip_build: self.run_command('build') install = self.reinitialize_command('install', reinit_subcommands=True) install.root = self.bdist_dir install.skip_build = self.skip_build install.warn_dir = False log.info("installing to %s", self.bdist_dir) self.run_command('install') # And make an archive relative to the root of the # pseudo-installation tree. archive_basename = f"{self.distribution.get_fullname()}.{self.plat_name}" pseudoinstall_root = os.path.join(self.dist_dir, archive_basename) if not self.relative: archive_root = self.bdist_dir else: if self.distribution.has_ext_modules() and ( install.install_base != install.install_platbase ): raise DistutilsPlatformError( "can't make a dumb built distribution where " f"base and platbase are different ({install.install_base!r}, {install.install_platbase!r})" ) else: archive_root = os.path.join( self.bdist_dir, ensure_relative(install.install_base) ) # Make the archive filename = self.make_archive( pseudoinstall_root, self.format, root_dir=archive_root, owner=self.owner, group=self.group, ) if self.distribution.has_ext_modules(): pyversion = get_python_version() else: pyversion = 'any' self.distribution.dist_files.append(('bdist_dumb', pyversion, filename)) if not self.keep_temp: remove_tree(self.bdist_dir, dry_run=self.dry_run) _distutils/command/bdist.py 0000644 00000013336 15030122015 0012017 0 ustar 00 """distutils.command.bdist Implements the Distutils 'bdist' command (create a built [binary] distribution).""" from __future__ import annotations import os import warnings from collections.abc import Callable from typing import TYPE_CHECKING, ClassVar from ..core import Command from ..errors import DistutilsOptionError, DistutilsPlatformError from ..util import get_platform if TYPE_CHECKING: from typing_extensions import deprecated else: def deprecated(message): return lambda fn: fn def show_formats(): """Print list of available formats (arguments to "--format" option).""" from ..fancy_getopt import FancyGetopt formats = [ ("formats=" + format, None, bdist.format_commands[format][1]) for format in bdist.format_commands ] pretty_printer = FancyGetopt(formats) pretty_printer.print_help("List of available distribution formats:") class ListCompat(dict[str, tuple[str, str]]): # adapter to allow for Setuptools compatibility in format_commands @deprecated("format_commands is now a dict. append is deprecated.") def append(self, item: object) -> None: warnings.warn( "format_commands is now a dict. append is deprecated.", DeprecationWarning, stacklevel=2, ) class bdist(Command): description = "create a built (binary) distribution" user_options = [ ('bdist-base=', 'b', "temporary directory for creating built distributions"), ( 'plat-name=', 'p', "platform name to embed in generated filenames " f"[default: {get_platform()}]", ), ('formats=', None, "formats for distribution (comma-separated list)"), ( 'dist-dir=', 'd', "directory to put final built distributions in [default: dist]", ), ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), ( 'owner=', 'u', "Owner name used when creating a tar file [default: current user]", ), ( 'group=', 'g', "Group name used when creating a tar file [default: current group]", ), ] boolean_options: ClassVar[list[str]] = ['skip-build'] help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ ('help-formats', None, "lists available distribution formats", show_formats), ] # The following commands do not take a format option from bdist no_format_option: ClassVar[tuple[str, ...]] = ('bdist_rpm',) # This won't do in reality: will need to distinguish RPM-ish Linux, # Debian-ish Linux, Solaris, FreeBSD, ..., Windows, Mac OS. default_format: ClassVar[dict[str, str]] = {'posix': 'gztar', 'nt': 'zip'} # Define commands in preferred order for the --help-formats option format_commands = ListCompat({ 'rpm': ('bdist_rpm', "RPM distribution"), 'gztar': ('bdist_dumb', "gzip'ed tar file"), 'bztar': ('bdist_dumb', "bzip2'ed tar file"), 'xztar': ('bdist_dumb', "xz'ed tar file"), 'ztar': ('bdist_dumb', "compressed tar file"), 'tar': ('bdist_dumb', "tar file"), 'zip': ('bdist_dumb', "ZIP file"), }) # for compatibility until consumers only reference format_commands format_command = format_commands def initialize_options(self): self.bdist_base = None self.plat_name = None self.formats = None self.dist_dir = None self.skip_build = False self.group = None self.owner = None def finalize_options(self) -> None: # have to finalize 'plat_name' before 'bdist_base' if self.plat_name is None: if self.skip_build: self.plat_name = get_platform() else: self.plat_name = self.get_finalized_command('build').plat_name # 'bdist_base' -- parent of per-built-distribution-format # temporary directories (eg. we'll probably have # "build/bdist.<plat>/dumb", "build/bdist.<plat>/rpm", etc.) if self.bdist_base is None: build_base = self.get_finalized_command('build').build_base self.bdist_base = os.path.join(build_base, 'bdist.' + self.plat_name) self.ensure_string_list('formats') if self.formats is None: try: self.formats = [self.default_format[os.name]] except KeyError: raise DistutilsPlatformError( "don't know how to create built distributions " f"on platform {os.name}" ) if self.dist_dir is None: self.dist_dir = "dist" def run(self) -> None: # Figure out which sub-commands we need to run. commands = [] for format in self.formats: try: commands.append(self.format_commands[format][0]) except KeyError: raise DistutilsOptionError(f"invalid format '{format}'") # Reinitialize and run each command. for i in range(len(self.formats)): cmd_name = commands[i] sub_cmd = self.reinitialize_command(cmd_name) if cmd_name not in self.no_format_option: sub_cmd.format = self.formats[i] # passing the owner and group names for tar archiving if cmd_name == 'bdist_dumb': sub_cmd.owner = self.owner sub_cmd.group = self.group # If we're going to need to run this command again, tell it to # keep its temporary files around so subsequent runs go faster. if cmd_name in commands[i + 1 :]: sub_cmd.keep_temp = True self.run_command(cmd_name) _distutils/command/build_clib.py 0000644 00000017141 15030122015 0013000 0 ustar 00 """distutils.command.build_clib Implements the Distutils 'build_clib' command, to build a C/C++ library that is included in the module distribution and needed by an extension module.""" # XXX this module has *lots* of code ripped-off quite transparently from # build_ext.py -- not surprisingly really, as the work required to build # a static library from a collection of C source files is not really all # that different from what's required to build a shared object file from # a collection of C source files. Nevertheless, I haven't done the # necessary refactoring to account for the overlap in code between the # two modules, mainly because a number of subtle details changed in the # cut 'n paste. Sigh. from __future__ import annotations import os from collections.abc import Callable from distutils._log import log from typing import ClassVar from ..ccompiler import new_compiler, show_compilers from ..core import Command from ..errors import DistutilsSetupError from ..sysconfig import customize_compiler class build_clib(Command): description = "build C/C++ libraries used by Python extensions" user_options: ClassVar[list[tuple[str, str, str]]] = [ ('build-clib=', 'b', "directory to build C/C++ libraries to"), ('build-temp=', 't', "directory to put temporary build by-products"), ('debug', 'g', "compile with debugging information"), ('force', 'f', "forcibly build everything (ignore file timestamps)"), ('compiler=', 'c', "specify the compiler type"), ] boolean_options: ClassVar[list[str]] = ['debug', 'force'] help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ ('help-compiler', None, "list available compilers", show_compilers), ] def initialize_options(self): self.build_clib = None self.build_temp = None # List of libraries to build self.libraries = None # Compilation options for all libraries self.include_dirs = None self.define = None self.undef = None self.debug = None self.force = False self.compiler = None def finalize_options(self) -> None: # This might be confusing: both build-clib and build-temp default # to build-temp as defined by the "build" command. This is because # I think that C libraries are really just temporary build # by-products, at least from the point of view of building Python # extensions -- but I want to keep my options open. self.set_undefined_options( 'build', ('build_temp', 'build_clib'), ('build_temp', 'build_temp'), ('compiler', 'compiler'), ('debug', 'debug'), ('force', 'force'), ) self.libraries = self.distribution.libraries if self.libraries: self.check_library_list(self.libraries) if self.include_dirs is None: self.include_dirs = self.distribution.include_dirs or [] if isinstance(self.include_dirs, str): self.include_dirs = self.include_dirs.split(os.pathsep) # XXX same as for build_ext -- what about 'self.define' and # 'self.undef' ? def run(self) -> None: if not self.libraries: return self.compiler = new_compiler( compiler=self.compiler, dry_run=self.dry_run, force=self.force ) customize_compiler(self.compiler) if self.include_dirs is not None: self.compiler.set_include_dirs(self.include_dirs) if self.define is not None: # 'define' option is a list of (name,value) tuples for name, value in self.define: self.compiler.define_macro(name, value) if self.undef is not None: for macro in self.undef: self.compiler.undefine_macro(macro) self.build_libraries(self.libraries) def check_library_list(self, libraries) -> None: """Ensure that the list of libraries is valid. `library` is presumably provided as a command option 'libraries'. This method checks that it is a list of 2-tuples, where the tuples are (library_name, build_info_dict). Raise DistutilsSetupError if the structure is invalid anywhere; just returns otherwise. """ if not isinstance(libraries, list): raise DistutilsSetupError("'libraries' option must be a list of tuples") for lib in libraries: if not isinstance(lib, tuple) and len(lib) != 2: raise DistutilsSetupError("each element of 'libraries' must a 2-tuple") name, build_info = lib if not isinstance(name, str): raise DistutilsSetupError( "first element of each tuple in 'libraries' " "must be a string (the library name)" ) if '/' in name or (os.sep != '/' and os.sep in name): raise DistutilsSetupError( f"bad library name '{lib[0]}': may not contain directory separators" ) if not isinstance(build_info, dict): raise DistutilsSetupError( "second element of each tuple in 'libraries' " "must be a dictionary (build info)" ) def get_library_names(self): # Assume the library list is valid -- 'check_library_list()' is # called from 'finalize_options()', so it should be! if not self.libraries: return None lib_names = [] for lib_name, _build_info in self.libraries: lib_names.append(lib_name) return lib_names def get_source_files(self): self.check_library_list(self.libraries) filenames = [] for lib_name, build_info in self.libraries: sources = build_info.get('sources') if sources is None or not isinstance(sources, (list, tuple)): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'sources' must be present and must be " "a list of source filenames" ) filenames.extend(sources) return filenames def build_libraries(self, libraries) -> None: for lib_name, build_info in libraries: sources = build_info.get('sources') if sources is None or not isinstance(sources, (list, tuple)): raise DistutilsSetupError( f"in 'libraries' option (library '{lib_name}'), " "'sources' must be present and must be " "a list of source filenames" ) sources = list(sources) log.info("building '%s' library", lib_name) # First, compile the source code to object files in the library # directory. (This should probably change to putting object # files in a temporary build directory.) macros = build_info.get('macros') include_dirs = build_info.get('include_dirs') objects = self.compiler.compile( sources, output_dir=self.build_temp, macros=macros, include_dirs=include_dirs, debug=self.debug, ) # Now "link" the object files together into a static library. # (On Unix at least, this isn't really linking -- it just # builds an archive. Whatever.) self.compiler.create_static_lib( objects, lib_name, output_dir=self.build_clib, debug=self.debug ) _distutils/command/clean.py 0000644 00000005124 15030122015 0011770 0 ustar 00 """distutils.command.clean Implements the Distutils 'clean' command.""" # contributed by Bastian Kleineidam <calvin@cs.uni-sb.de>, added 2000-03-18 import os from distutils._log import log from typing import ClassVar from ..core import Command from ..dir_util import remove_tree class clean(Command): description = "clean up temporary files from 'build' command" user_options = [ ('build-base=', 'b', "base build directory [default: 'build.build-base']"), ( 'build-lib=', None, "build directory for all modules [default: 'build.build-lib']", ), ('build-temp=', 't', "temporary build directory [default: 'build.build-temp']"), ( 'build-scripts=', None, "build directory for scripts [default: 'build.build-scripts']", ), ('bdist-base=', None, "temporary directory for built distributions"), ('all', 'a', "remove all build output, not just temporary by-products"), ] boolean_options: ClassVar[list[str]] = ['all'] def initialize_options(self): self.build_base = None self.build_lib = None self.build_temp = None self.build_scripts = None self.bdist_base = None self.all = None def finalize_options(self): self.set_undefined_options( 'build', ('build_base', 'build_base'), ('build_lib', 'build_lib'), ('build_scripts', 'build_scripts'), ('build_temp', 'build_temp'), ) self.set_undefined_options('bdist', ('bdist_base', 'bdist_base')) def run(self): # remove the build/temp.<plat> directory (unless it's already # gone) if os.path.exists(self.build_temp): remove_tree(self.build_temp, dry_run=self.dry_run) else: log.debug("'%s' does not exist -- can't clean it", self.build_temp) if self.all: # remove build directories for directory in (self.build_lib, self.bdist_base, self.build_scripts): if os.path.exists(directory): remove_tree(directory, dry_run=self.dry_run) else: log.warning("'%s' does not exist -- can't clean it", directory) # just for the heck of it, try to remove the base build directory: # we might have emptied it right now, but if not we don't care if not self.dry_run: try: os.rmdir(self.build_base) log.info("removing '%s'", self.build_base) except OSError: pass _distutils/command/install_scripts.py 0000644 00000003722 15030122015 0014125 0 ustar 00 """distutils.command.install_scripts Implements the Distutils 'install_scripts' command, for installing Python scripts.""" # contributed by Bastian Kleineidam import os from distutils._log import log from stat import ST_MODE from typing import ClassVar from ..core import Command class install_scripts(Command): description = "install scripts (Python or otherwise)" user_options = [ ('install-dir=', 'd', "directory to install scripts to"), ('build-dir=', 'b', "build directory (where to install from)"), ('force', 'f', "force installation (overwrite existing files)"), ('skip-build', None, "skip the build steps"), ] boolean_options: ClassVar[list[str]] = ['force', 'skip-build'] def initialize_options(self): self.install_dir = None self.force = False self.build_dir = None self.skip_build = None def finalize_options(self) -> None: self.set_undefined_options('build', ('build_scripts', 'build_dir')) self.set_undefined_options( 'install', ('install_scripts', 'install_dir'), ('force', 'force'), ('skip_build', 'skip_build'), ) def run(self) -> None: if not self.skip_build: self.run_command('build_scripts') self.outfiles = self.copy_tree(self.build_dir, self.install_dir) if os.name == 'posix': # Set the executable bits (owner, group, and world) on # all the scripts we just installed. for file in self.get_outputs(): if self.dry_run: log.info("changing mode of %s", file) else: mode = ((os.stat(file)[ST_MODE]) | 0o555) & 0o7777 log.info("changing mode of %s to %o", file, mode) os.chmod(file, mode) def get_inputs(self): return self.distribution.scripts or [] def get_outputs(self): return self.outfiles or [] _distutils/command/bdist_rpm.py 0000644 00000052431 15030122015 0012674 0 ustar 00 """distutils.command.bdist_rpm Implements the Distutils 'bdist_rpm' command (create RPM source and binary distributions).""" import os import subprocess import sys from distutils._log import log from typing import ClassVar from ..core import Command from ..debug import DEBUG from ..errors import ( DistutilsExecError, DistutilsFileError, DistutilsOptionError, DistutilsPlatformError, ) from ..file_util import write_file from ..sysconfig import get_python_version class bdist_rpm(Command): description = "create an RPM distribution" user_options = [ ('bdist-base=', None, "base directory for creating built distributions"), ( 'rpm-base=', None, "base directory for creating RPMs (defaults to \"rpm\" under " "--bdist-base; must be specified for RPM 2)", ), ( 'dist-dir=', 'd', "directory to put final RPM files in (and .spec files if --spec-only)", ), ( 'python=', None, "path to Python interpreter to hard-code in the .spec file " "[default: \"python\"]", ), ( 'fix-python', None, "hard-code the exact path to the current Python interpreter in " "the .spec file", ), ('spec-only', None, "only regenerate spec file"), ('source-only', None, "only generate source RPM"), ('binary-only', None, "only generate binary RPM"), ('use-bzip2', None, "use bzip2 instead of gzip to create source distribution"), # More meta-data: too RPM-specific to put in the setup script, # but needs to go in the .spec file -- so we make these options # to "bdist_rpm". The idea is that packagers would put this # info in setup.cfg, although they are of course free to # supply it on the command line. ( 'distribution-name=', None, "name of the (Linux) distribution to which this " "RPM applies (*not* the name of the module distribution!)", ), ('group=', None, "package classification [default: \"Development/Libraries\"]"), ('release=', None, "RPM release number"), ('serial=', None, "RPM serial number"), ( 'vendor=', None, "RPM \"vendor\" (eg. \"Joe Blow <joe@example.com>\") " "[default: maintainer or author from setup script]", ), ( 'packager=', None, "RPM packager (eg. \"Jane Doe <jane@example.net>\") [default: vendor]", ), ('doc-files=', None, "list of documentation files (space or comma-separated)"), ('changelog=', None, "RPM changelog"), ('icon=', None, "name of icon file"), ('provides=', None, "capabilities provided by this package"), ('requires=', None, "capabilities required by this package"), ('conflicts=', None, "capabilities which conflict with this package"), ('build-requires=', None, "capabilities required to build this package"), ('obsoletes=', None, "capabilities made obsolete by this package"), ('no-autoreq', None, "do not automatically calculate dependencies"), # Actions to take when building RPM ('keep-temp', 'k', "don't clean up RPM build directory"), ('no-keep-temp', None, "clean up RPM build directory [default]"), ( 'use-rpm-opt-flags', None, "compile with RPM_OPT_FLAGS when building from source RPM", ), ('no-rpm-opt-flags', None, "do not pass any RPM CFLAGS to compiler"), ('rpm3-mode', None, "RPM 3 compatibility mode (default)"), ('rpm2-mode', None, "RPM 2 compatibility mode"), # Add the hooks necessary for specifying custom scripts ('prep-script=', None, "Specify a script for the PREP phase of RPM building"), ('build-script=', None, "Specify a script for the BUILD phase of RPM building"), ( 'pre-install=', None, "Specify a script for the pre-INSTALL phase of RPM building", ), ( 'install-script=', None, "Specify a script for the INSTALL phase of RPM building", ), ( 'post-install=', None, "Specify a script for the post-INSTALL phase of RPM building", ), ( 'pre-uninstall=', None, "Specify a script for the pre-UNINSTALL phase of RPM building", ), ( 'post-uninstall=', None, "Specify a script for the post-UNINSTALL phase of RPM building", ), ('clean-script=', None, "Specify a script for the CLEAN phase of RPM building"), ( 'verify-script=', None, "Specify a script for the VERIFY phase of the RPM build", ), # Allow a packager to explicitly force an architecture ('force-arch=', None, "Force an architecture onto the RPM build process"), ('quiet', 'q', "Run the INSTALL phase of RPM building in quiet mode"), ] boolean_options: ClassVar[list[str]] = [ 'keep-temp', 'use-rpm-opt-flags', 'rpm3-mode', 'no-autoreq', 'quiet', ] negative_opt: ClassVar[dict[str, str]] = { 'no-keep-temp': 'keep-temp', 'no-rpm-opt-flags': 'use-rpm-opt-flags', 'rpm2-mode': 'rpm3-mode', } def initialize_options(self): self.bdist_base = None self.rpm_base = None self.dist_dir = None self.python = None self.fix_python = None self.spec_only = None self.binary_only = None self.source_only = None self.use_bzip2 = None self.distribution_name = None self.group = None self.release = None self.serial = None self.vendor = None self.packager = None self.doc_files = None self.changelog = None self.icon = None self.prep_script = None self.build_script = None self.install_script = None self.clean_script = None self.verify_script = None self.pre_install = None self.post_install = None self.pre_uninstall = None self.post_uninstall = None self.prep = None self.provides = None self.requires = None self.conflicts = None self.build_requires = None self.obsoletes = None self.keep_temp = False self.use_rpm_opt_flags = True self.rpm3_mode = True self.no_autoreq = False self.force_arch = None self.quiet = False def finalize_options(self) -> None: self.set_undefined_options('bdist', ('bdist_base', 'bdist_base')) if self.rpm_base is None: if not self.rpm3_mode: raise DistutilsOptionError("you must specify --rpm-base in RPM 2 mode") self.rpm_base = os.path.join(self.bdist_base, "rpm") if self.python is None: if self.fix_python: self.python = sys.executable else: self.python = "python3" elif self.fix_python: raise DistutilsOptionError( "--python and --fix-python are mutually exclusive options" ) if os.name != 'posix': raise DistutilsPlatformError( f"don't know how to create RPM distributions on platform {os.name}" ) if self.binary_only and self.source_only: raise DistutilsOptionError( "cannot supply both '--source-only' and '--binary-only'" ) # don't pass CFLAGS to pure python distributions if not self.distribution.has_ext_modules(): self.use_rpm_opt_flags = False self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) self.finalize_package_data() def finalize_package_data(self) -> None: self.ensure_string('group', "Development/Libraries") self.ensure_string( 'vendor', f"{self.distribution.get_contact()} <{self.distribution.get_contact_email()}>", ) self.ensure_string('packager') self.ensure_string_list('doc_files') if isinstance(self.doc_files, list): for readme in ('README', 'README.txt'): if os.path.exists(readme) and readme not in self.doc_files: self.doc_files.append(readme) self.ensure_string('release', "1") self.ensure_string('serial') # should it be an int? self.ensure_string('distribution_name') self.ensure_string('changelog') # Format changelog correctly self.changelog = self._format_changelog(self.changelog) self.ensure_filename('icon') self.ensure_filename('prep_script') self.ensure_filename('build_script') self.ensure_filename('install_script') self.ensure_filename('clean_script') self.ensure_filename('verify_script') self.ensure_filename('pre_install') self.ensure_filename('post_install') self.ensure_filename('pre_uninstall') self.ensure_filename('post_uninstall') # XXX don't forget we punted on summaries and descriptions -- they # should be handled here eventually! # Now *this* is some meta-data that belongs in the setup script... self.ensure_string_list('provides') self.ensure_string_list('requires') self.ensure_string_list('conflicts') self.ensure_string_list('build_requires') self.ensure_string_list('obsoletes') self.ensure_string('force_arch') def run(self) -> None: # noqa: C901 if DEBUG: print("before _get_package_data():") print("vendor =", self.vendor) print("packager =", self.packager) print("doc_files =", self.doc_files) print("changelog =", self.changelog) # make directories if self.spec_only: spec_dir = self.dist_dir self.mkpath(spec_dir) else: rpm_dir = {} for d in ('SOURCES', 'SPECS', 'BUILD', 'RPMS', 'SRPMS'): rpm_dir[d] = os.path.join(self.rpm_base, d) self.mkpath(rpm_dir[d]) spec_dir = rpm_dir['SPECS'] # Spec file goes into 'dist_dir' if '--spec-only specified', # build/rpm.<plat> otherwise. spec_path = os.path.join(spec_dir, f"{self.distribution.get_name()}.spec") self.execute( write_file, (spec_path, self._make_spec_file()), f"writing '{spec_path}'" ) if self.spec_only: # stop if requested return # Make a source distribution and copy to SOURCES directory with # optional icon. saved_dist_files = self.distribution.dist_files[:] sdist = self.reinitialize_command('sdist') if self.use_bzip2: sdist.formats = ['bztar'] else: sdist.formats = ['gztar'] self.run_command('sdist') self.distribution.dist_files = saved_dist_files source = sdist.get_archive_files()[0] source_dir = rpm_dir['SOURCES'] self.copy_file(source, source_dir) if self.icon: if os.path.exists(self.icon): self.copy_file(self.icon, source_dir) else: raise DistutilsFileError(f"icon file '{self.icon}' does not exist") # build package log.info("building RPMs") rpm_cmd = ['rpmbuild'] if self.source_only: # what kind of RPMs? rpm_cmd.append('-bs') elif self.binary_only: rpm_cmd.append('-bb') else: rpm_cmd.append('-ba') rpm_cmd.extend(['--define', f'__python {self.python}']) if self.rpm3_mode: rpm_cmd.extend(['--define', f'_topdir {os.path.abspath(self.rpm_base)}']) if not self.keep_temp: rpm_cmd.append('--clean') if self.quiet: rpm_cmd.append('--quiet') rpm_cmd.append(spec_path) # Determine the binary rpm names that should be built out of this spec # file # Note that some of these may not be really built (if the file # list is empty) nvr_string = "%{name}-%{version}-%{release}" src_rpm = nvr_string + ".src.rpm" non_src_rpm = "%{arch}/" + nvr_string + ".%{arch}.rpm" q_cmd = rf"rpm -q --qf '{src_rpm} {non_src_rpm}\n' --specfile '{spec_path}'" out = os.popen(q_cmd) try: binary_rpms = [] source_rpm = None while True: line = out.readline() if not line: break ell = line.strip().split() assert len(ell) == 2 binary_rpms.append(ell[1]) # The source rpm is named after the first entry in the spec file if source_rpm is None: source_rpm = ell[0] status = out.close() if status: raise DistutilsExecError(f"Failed to execute: {q_cmd!r}") finally: out.close() self.spawn(rpm_cmd) if not self.dry_run: if self.distribution.has_ext_modules(): pyversion = get_python_version() else: pyversion = 'any' if not self.binary_only: srpm = os.path.join(rpm_dir['SRPMS'], source_rpm) assert os.path.exists(srpm) self.move_file(srpm, self.dist_dir) filename = os.path.join(self.dist_dir, source_rpm) self.distribution.dist_files.append(('bdist_rpm', pyversion, filename)) if not self.source_only: for rpm in binary_rpms: rpm = os.path.join(rpm_dir['RPMS'], rpm) if os.path.exists(rpm): self.move_file(rpm, self.dist_dir) filename = os.path.join(self.dist_dir, os.path.basename(rpm)) self.distribution.dist_files.append(( 'bdist_rpm', pyversion, filename, )) def _dist_path(self, path): return os.path.join(self.dist_dir, os.path.basename(path)) def _make_spec_file(self): # noqa: C901 """Generate the text of an RPM spec file and return it as a list of strings (one per line). """ # definitions and headers spec_file = [ '%define name ' + self.distribution.get_name(), '%define version ' + self.distribution.get_version().replace('-', '_'), '%define unmangled_version ' + self.distribution.get_version(), '%define release ' + self.release.replace('-', '_'), '', 'Summary: ' + (self.distribution.get_description() or "UNKNOWN"), ] # Workaround for #14443 which affects some RPM based systems such as # RHEL6 (and probably derivatives) vendor_hook = subprocess.getoutput('rpm --eval %{__os_install_post}') # Generate a potential replacement value for __os_install_post (whilst # normalizing the whitespace to simplify the test for whether the # invocation of brp-python-bytecompile passes in __python): vendor_hook = '\n'.join([ f' {line.strip()} \\' for line in vendor_hook.splitlines() ]) problem = "brp-python-bytecompile \\\n" fixed = "brp-python-bytecompile %{__python} \\\n" fixed_hook = vendor_hook.replace(problem, fixed) if fixed_hook != vendor_hook: spec_file.append('# Workaround for https://bugs.python.org/issue14443') spec_file.append('%define __os_install_post ' + fixed_hook + '\n') # put locale summaries into spec file # XXX not supported for now (hard to put a dictionary # in a config file -- arg!) # for locale in self.summaries.keys(): # spec_file.append('Summary(%s): %s' % (locale, # self.summaries[locale])) spec_file.extend([ 'Name: %{name}', 'Version: %{version}', 'Release: %{release}', ]) # XXX yuck! this filename is available from the "sdist" command, # but only after it has run: and we create the spec file before # running "sdist", in case of --spec-only. if self.use_bzip2: spec_file.append('Source0: %{name}-%{unmangled_version}.tar.bz2') else: spec_file.append('Source0: %{name}-%{unmangled_version}.tar.gz') spec_file.extend([ 'License: ' + (self.distribution.get_license() or "UNKNOWN"), 'Group: ' + self.group, 'BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-buildroot', 'Prefix: %{_prefix}', ]) if not self.force_arch: # noarch if no extension modules if not self.distribution.has_ext_modules(): spec_file.append('BuildArch: noarch') else: spec_file.append(f'BuildArch: {self.force_arch}') for field in ( 'Vendor', 'Packager', 'Provides', 'Requires', 'Conflicts', 'Obsoletes', ): val = getattr(self, field.lower()) if isinstance(val, list): spec_file.append('{}: {}'.format(field, ' '.join(val))) elif val is not None: spec_file.append(f'{field}: {val}') if self.distribution.get_url(): spec_file.append('Url: ' + self.distribution.get_url()) if self.distribution_name: spec_file.append('Distribution: ' + self.distribution_name) if self.build_requires: spec_file.append('BuildRequires: ' + ' '.join(self.build_requires)) if self.icon: spec_file.append('Icon: ' + os.path.basename(self.icon)) if self.no_autoreq: spec_file.append('AutoReq: 0') spec_file.extend([ '', '%description', self.distribution.get_long_description() or "", ]) # put locale descriptions into spec file # XXX again, suppressed because config file syntax doesn't # easily support this ;-( # for locale in self.descriptions.keys(): # spec_file.extend([ # '', # '%description -l ' + locale, # self.descriptions[locale], # ]) # rpm scripts # figure out default build script def_setup_call = f"{self.python} {os.path.basename(sys.argv[0])}" def_build = f"{def_setup_call} build" if self.use_rpm_opt_flags: def_build = 'env CFLAGS="$RPM_OPT_FLAGS" ' + def_build # insert contents of files # XXX this is kind of misleading: user-supplied options are files # that we open and interpolate into the spec file, but the defaults # are just text that we drop in as-is. Hmmm. install_cmd = f'{def_setup_call} install -O1 --root=$RPM_BUILD_ROOT --record=INSTALLED_FILES' script_options = [ ('prep', 'prep_script', "%setup -n %{name}-%{unmangled_version}"), ('build', 'build_script', def_build), ('install', 'install_script', install_cmd), ('clean', 'clean_script', "rm -rf $RPM_BUILD_ROOT"), ('verifyscript', 'verify_script', None), ('pre', 'pre_install', None), ('post', 'post_install', None), ('preun', 'pre_uninstall', None), ('postun', 'post_uninstall', None), ] for rpm_opt, attr, default in script_options: # Insert contents of file referred to, if no file is referred to # use 'default' as contents of script val = getattr(self, attr) if val or default: spec_file.extend([ '', '%' + rpm_opt, ]) if val: with open(val) as f: spec_file.extend(f.read().split('\n')) else: spec_file.append(default) # files section spec_file.extend([ '', '%files -f INSTALLED_FILES', '%defattr(-,root,root)', ]) if self.doc_files: spec_file.append('%doc ' + ' '.join(self.doc_files)) if self.changelog: spec_file.extend([ '', '%changelog', ]) spec_file.extend(self.changelog) return spec_file def _format_changelog(self, changelog): """Format the changelog correctly and convert it to a list of strings""" if not changelog: return changelog new_changelog = [] for line in changelog.strip().split('\n'): line = line.strip() if line[0] == '*': new_changelog.extend(['', line]) elif line[0] == '-': new_changelog.append(line) else: new_changelog.append(' ' + line) # strip trailing newline inserted by first changelog entry if not new_changelog[0]: del new_changelog[0] return new_changelog _distutils/command/__init__.py 0000644 00000000602 15030122015 0012441 0 ustar 00 """distutils.command Package containing implementation of all the standard Distutils commands.""" __all__ = [ 'build', 'build_py', 'build_ext', 'build_clib', 'build_scripts', 'clean', 'install', 'install_lib', 'install_headers', 'install_scripts', 'install_data', 'sdist', 'bdist', 'bdist_dumb', 'bdist_rpm', 'check', ] _distutils/cygwinccompiler.py 0000644 00000001122 15030122015 0012460 0 ustar 00 from .compilers.C import cygwin from .compilers.C.cygwin import ( CONFIG_H_NOTOK, CONFIG_H_OK, CONFIG_H_UNCERTAIN, check_config_h, get_msvcr, is_cygwincc, ) __all__ = [ 'CONFIG_H_NOTOK', 'CONFIG_H_OK', 'CONFIG_H_UNCERTAIN', 'CygwinCCompiler', 'Mingw32CCompiler', 'check_config_h', 'get_msvcr', 'is_cygwincc', ] CygwinCCompiler = cygwin.Compiler Mingw32CCompiler = cygwin.MinGW32Compiler get_versions = None """ A stand-in for the previous get_versions() function to prevent failures when monkeypatched. See pypa/setuptools#2969. """ _distutils/log.py 0000644 00000002260 15030122015 0010047 0 ustar 00 """ A simple log mechanism styled after PEP 282. Retained for compatibility and should not be used. """ import logging import warnings from ._log import log as _global_log DEBUG = logging.DEBUG INFO = logging.INFO WARN = logging.WARN ERROR = logging.ERROR FATAL = logging.FATAL log = _global_log.log debug = _global_log.debug info = _global_log.info warn = _global_log.warning error = _global_log.error fatal = _global_log.fatal def set_threshold(level): orig = _global_log.level _global_log.setLevel(level) return orig def set_verbosity(v): if v <= 0: set_threshold(logging.WARN) elif v == 1: set_threshold(logging.INFO) elif v >= 2: set_threshold(logging.DEBUG) class Log(logging.Logger): """distutils.log.Log is deprecated, please use an alternative from `logging`.""" def __init__(self, threshold=WARN): warnings.warn(Log.__doc__) # avoid DeprecationWarning to ensure warn is shown super().__init__(__name__, level=threshold) @property def threshold(self): return self.level @threshold.setter def threshold(self, level): self.setLevel(level) warn = logging.Logger.warning _distutils/__pycache__/dir_util.cpython-310.pyc 0000644 00000016114 15030122015 0015443 0 ustar 00 o �hD � @ s� d Z ddlZddlZddlZddlZddlmZ ddlmZ ddl m Z m Z G dd� de �Z e � jZejed d ejd dfdd���Zejd efdd��Zejd dd��Zd dd�Z d!dd�Zdd� Zdd� Zd"dd �Zd d � ZdS )#zWdistutils.dir_util Utility functions for manipulating directories and directory trees.� N� )� file_util)�log)�DistutilsFileError�DistutilsInternalErrorc s4 e Zd ZdZdd� Ze� fdd��Zdd� Z� ZS )�SkipRepeatAbsolutePathsz� Cache for mkpath. In addition to cheapening redundant calls, eliminates redundant "creating /foo/bar/baz" messages in dry-run mode. c C s | t _d S �N)r �instance)�self� r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/dir_util.py�__init__ s z SkipRepeatAbsolutePaths.__init__c s t | | j��� d S r )�superr �clear)�cls�� __class__r r r s z SkipRepeatAbsolutePaths.clearc s t �� �� �fdd��}|S )Nc s8 | � � �v rd S � | g|�R i |��}��| � � � |S r )�absolute�add)�path�args�kwargs�result��funcr r r �wrapper s z-SkipRepeatAbsolutePaths.wrap.<locals>.wrapper)� functools�wraps)r r r r r r �wrap s z SkipRepeatAbsolutePaths.wrap) �__name__� __module__� __qualname__�__doc__r � classmethodr r � __classcell__r r r r r s r � TF�name�returnc C sn |r | � � s t�d| � z|p| j|ddd� W dS W dS ty6 } z td| � d|jd � ���d}~ww )a� Create a directory and any missing ancestor directories. If the directory already exists (or if 'name' is the empty string, which means the current directory, which of course exists), then do nothing. Raise DistutilsFileError if unable to create some directory along the way (eg. some sub-path exists, but is a file rather than a directory). If 'verbose' is true, log the directory created. z creating %sT)�mode�parents�exist_okzcould not create '�': ���N)�is_dirr �info�mkdir�OSErrorr r )r& r( �verbose�dry_run�excr r r �mkpath. s "��r4 c O s t t�| �g|�R i |��S r )r4 �pathlib�Path�r& r r r r r �_B s r8 c O s t d| �d���)z. Detect a common bug -- name is None. z%mkpath: 'name' must be a string (got �))r r7 r r r r8 G s c s8 t � fdd�|D ��}t|�D ] }t||||d� qdS )a� Create all the empty directories under 'base_dir' needed to put 'files' there. 'base_dir' is just the name of a directory which doesn't necessarily exist yet; 'files' is a list of filenames to be interpreted relative to 'base_dir'. 'base_dir' + the directory portion of every file in 'files' will be created if it doesn't already exist. 'mode', 'verbose' and 'dry_run' flags are as for 'mkpath()'. c 3 s& � | ]}t j�� t j�|��V qd S r )�osr �join�dirname)�.0�file��base_dirr r � <genexpr>Z s �$ z create_tree.<locals>.<genexpr>�r1 r2 N)�set�sortedr4 )r@ �filesr( r1 r2 �need_dir�dirr r? r � create_treeO s �rH c C s� |st j�| �std| � d���zt �| �}W n" ty9 } z|r$g }n td| � d| j� ���W Y d} ~ nd} ~ ww |sBt||d� tj t | |||||||d� } t t j �t| |���S )a Copy an entire directory tree 'src' to a new location 'dst'. Both 'src' and 'dst' must be directory names. If 'src' is not a directory, raise DistutilsFileError. If 'dst' does not exist, it is created with 'mkpath()'. The end result of the copy is that every file in 'src' is copied to 'dst', and directories under 'src' are recursively copied to 'dst'. Return the list of files that were copied or might have been copied, using their output name. The return value is unaffected by 'update' or 'dry_run': it is simply the list of all files under 'src', with the names changed to be under 'dst'. 'preserve_mode' and 'preserve_times' are the same as for 'copy_file'; note that they only apply to regular files, not to directories. If 'preserve_symlinks' is true, symlinks will be copied as symlinks (on platforms that support them!); otherwise (the default), the destination of the symlink will be copied. 'update' and 'verbose' are the same as for 'copy_file'. zcannot copy tree 'z': not a directoryzerror listing files in 'r+ N)r1 )�src�dst�preserve_symlinksr1 r2 � preserve_mode�preserve_times�update)r: r �isdirr �listdirr0 �strerrorr4 r �partial� _copy_one�list� itertools�chain� from_iterable�map) rI rJ rL rM rK rN r1 r2 �names�e�copy_oner r r � copy_treea s2 ��� � r\ c c s� � t j�|| �} t j�|| �} | �d�rd S |r;t j�| �r;t �| �} |dkr.t�d| | � |s6t �| | � | V d S t j� | �rRt | | ||||||d�E d H d S t j | | |||||d� | V d S )Nz.nfsr zlinking %s -> %srB ) r: r r; � startswith�islink�readlinkr r. �symlinkrO r\ r � copy_file) r& rI rJ rK r1 r2 rL rM rN �src_name�dst_name� link_destr r r rS � sB � � � rS c C sf t �| �D ]#}t j�| |�}t j�|�r t j�|�s t||� q|�t j|f� q|�t j | f� dS )zHelper for remove_tree().N) r: rP r r; rO r^ �_build_cmdtuple�append�remove�rmdir)r � cmdtuples�f�real_fr r r re � s re c C s� |dkr t �d| � |rdS g }t| |� |D ])}z|d |d � t�� W q ty@ } z t �d| |� W Y d}~qd}~ww dS )z�Recursively remove an entire directory tree. Any errors are ignored (apart from being reported to stdout if 'verbose' is true). r z'removing '%s' (and everything under it)Nr zerror removing %s: %s)r r. re r r r0 �warning)� directoryr1 r2 ri �cmdr3 r r r � remove_tree� s ���ro c C s6 t j�| �\}} | dd� t jkr|| dd� } | S )z�Take the full path 'path', and make it a relative path. This is useful to make 'path' the second argument to os.path.join(). r r N)r: r � splitdrive�sep)r �driver r r �ensure_relative� s rs )r% TF)r& N)TTFFTF)TF) r" r rU r: r5 � r �_logr �errorsr r rC r r r �singledispatchr6 r4 �register�strr8 rH r\ rS re ro rs r r r r �<module> s: �83 _distutils/__pycache__/_macos_compat.cpython-310.pyc 0000644 00000000666 15030122015 0016441 0 ustar 00 o �h� � @ s: d dl Z d dlZdd� Zejdkre �d�jZdS eZdS )� Nc C s | S )N� )�cmd�argsr r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/_macos_compat.py�bypass_compiler_fixup s r �darwin� _osx_support)� importlib�sysr �platform� import_module�compiler_fixupr r r r �<module> s _distutils/__pycache__/_modified.cpython-310.pyc 0000644 00000007110 15030122015 0015543 0 ustar 00 o �h� � @ s� d Z ddlmZ ddlZddlZddlmZmZ ddl m Z m Z ddl m Z ddlmZ dd lmZ e d d d �Ze d d d �Zdd� Zd%dd�Zefd&d d �Z d'd(d"d#�Zejeed$�ZdS ))z2Timestamp comparison of files and groups of files.� )� annotationsN)�Callable�Iterable)�Literal�TypeVar)�splat� )� zip_strict)�DistutilsFileError� _SourcesT�3str | bytes | os.PathLike[str] | os.PathLike[bytes])�bound� _TargetsTc C s& t j�|� pt j�| �t j�|�kS �N)�os�path�exists�getmtime��source�target� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/_modified.py�_newer s �r r r �return�boolc C s. t j�| �stdt j�| ��d���t| |�S )z� Is source modified more recently than target. Returns True if 'source' is modified more recently than 'target' or if 'target' does not exist. Raises DistutilsFileError if 'source' does not exist. zfile z does not exist)r r r r �abspathr r r r r �newer s r �sources�Iterable[_SourcesT]�targets�Iterable[_TargetsT]�&Callable[[_SourcesT, _TargetsT], bool]�'tuple[list[_SourcesT], list[_TargetsT]]c C s. t t|�t| |��}tttt|� ��pg g fS )a1 Filter filenames where sources are newer than targets. Walk two filename iterables in parallel, testing if each source is newer than its corresponding target. Returns a pair of lists (sources, targets) where source is newer than target, according to the semantics of 'newer()'. )�filterr r �tuple�map�list�zip)r r r � newer_pairsr r r �newer_pairwise/ s r* �error�=Iterable[str | bytes | os.PathLike[str] | os.PathLike[bytes]]�missing�#Literal['error', 'ignore', 'newer']c sL � fdd��� dkrt jjnd}t j��� p%t��fdd�t|| �D ��S )a� Is target out-of-date with respect to any file in sources. Return True if 'target' is out-of-date with respect to any file listed in 'sources'. In other words, if 'target' exists and is newer than every file in 'sources', return False; otherwise return True. ``missing`` controls how to handle a missing source file: - error (default): allow the ``stat()`` call to fail. - ignore: silently disregard any missing source files. - newer: treat missing source files as "target out of date". This mode is handy in "dry-run" mode: it will pretend to carry out commands that wouldn't work because inputs are missing, but that doesn't matter because dry-run won't run the commands. c s � dko t j�| � S )Nr )r r r )r )r- r r �missing_as_newerU s z%newer_group.<locals>.missing_as_newer�ignoreNc 3 s" � | ] }� |�p t |��V qd S r )r )�.0r )r/ r r r � <genexpr>Y s � � �z newer_group.<locals>.<genexpr>)r r r �anyr$ )r r r- �ignoredr )r- r/ r r � newer_group@ s �r5 )r )r r r r r r )r r r r! r r" r r# )r+ )r r, r r r- r. r r )�__doc__� __future__r � functools�os.pathr �collections.abcr r �typingr r �jaraco.functoolsr � compat.py39r �errorsr r r r r r* r5 �partial�newer_pairwise_groupr r r r �<module> s, �� � � _distutils/__pycache__/spawn.cpython-310.pyc 0000644 00000010156 15030122015 0014760 0 ustar 00 o �h� � @ s d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z mZmZ ddlmZ ddlmZ dd lmZ e rLdd lmZ ed e d �Zd d� Zd-dd�Zed.dd��Zed/dd��Zd0dd�Z d1d2d%d&�Zd3d4d+d,�Z dS )5z�distutils.spawn Provides the 'spawn()' function, a front-end to various platform- specific functions for launching another program in a sub-process. � )� annotationsN)�Mapping�MutableSequence)� TYPE_CHECKING�TypeVar�overload� )�log��DEBUG)�DistutilsExecError)�_ENV� _MappingT)�boundc C s t r| S | d S )zE Render a subprocess command differently depending on DEBUG. r r )�cmd� r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/spawn.py�_debug s r �env�_MappingT | None�return�'_MappingT | dict[str, str | int] | Nonec C sF t �� dkr| S ddlm}m} |� }|r||ini }i t| ��|�S )N�Darwinr )�MACOSX_VERSION_VAR�get_macosx_target_ver)�platform�system�utilr r �_resolve)r r r � target_ver�updater r r �_inject_macos_ver$ s r! �None�os._Environ[str]c C � d S �Nr �r r r r r / � r c C r$ r% r r& r r r r 1 r' � _MappingT | os._Environ[str]c C s | d u rt jS | S r% )�os�environr& r r r r 3 s TFr �/MutableSequence[bytes | str | os.PathLike[str]]� search_path�bool�verbose�dry_run� _ENV | Nonec C s� t �t�| �� |r dS |r t�| d �}|dur || d< z tj| t|�d� W dS tyE } zt dt | ��d|j d � ��|�d}~w tj y_ } zt dt | ��d|j � ��|�d}~ww )a� Run another program, specified as a command list 'cmd', in a new process. 'cmd' is just the argument list for the new process, ie. cmd[0] is the program to run and cmd[1:] are the rest of its arguments. There is no way to run a program with a name different from that of its executable. If 'search_path' is true (the default), the system's executable search path will be used to find the program; otherwise, cmd[0] must be the exact path to the executable. If 'dry_run' is true, the command will not actually be run. Raise DistutilsExecError if running the program fails in any way; just return on success. Nr r& zcommand z failed: ���z failed with exit code )r �info� subprocess� list2cmdline�shutil�which� check_callr! �OSErrorr r �args�CalledProcessError� returncode)r r, r. r/ r � executable�exc�errr r r �spawn7 s0 �������r? r< �str�path� str | Nonec C s� t jdtdd� tj�| �\}}tjdkr |dkr | d } tj�| �r%| S |du rJtj � dd�}|du rJzt� d�}W n t t fyI tj}Y nw |sNdS |�tj�}|D ]}tj�|| �}tj�|�ri| S qVdS ) z�Tries to find 'executable' in the directories listed in 'path'. A string listing directories separated by 'os.pathsep'; defaults to os.environ['PATH']. Returns the complete filename or None if not found. z+Use shutil.which instead of find_executable� )� stacklevel�win32z.exeN�PATH�CS_PATH)�warnings�warn�DeprecationWarningr) rA �splitext�sysr �isfiler* �get�confstr�AttributeError� ValueError�defpath�split�pathsep�join)r< rA �_�ext�paths�p�fr r r �find_executableb s2 � � �r[ )r r r r )r r" r r# )r r r r )r r r r( )TFFN) r r+ r, r- r. r- r/ r- r r0 r r" r% )r< r@ rA rB r rB ) �__doc__� __future__r r) r r5 r3 rL rH �collections.abcr r �typingr r r �_logr �debugr �errorsr r r r r! r r? r[ r r r r �<module> s: �+ _distutils/__pycache__/util.cpython-310.pyc 0000644 00000033747 15030122015 0014620 0 ustar 00 o �h�F � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZmZ ddlmZmZ ddlmZ ddlmZ dd lmZ dd lm Z m Z dd l m Z erpdd l m Z m!Z! e d �Z"d^dd�Z#d^dd�Z$e j%dkr�da&dZ'dd� Z(dd� Z)dd� Z*d_d d �Z+ed`d"d#��Z,dad'd(�Z-ej.dbd*d+��Z/dcd.d/�Z0d0d1� Z1ddded6d7�Z2d a3 a4a5d8d9� Z6dfd;d<�Z7 = =dgdhdFdG�Z8didIdJ�Z9 = K = djdkdUdV�Z:dldXdY�Z;dmdZd[�Z<d\d]� Z=dS )nzudistutils.util Miscellaneous utility functions -- anything that doesn't fit into one of the other *util.py modules. � )� annotationsN)�Callable�Iterable�Mapping)� TYPE_CHECKING�AnyStr)� pass_none� )�log)�newer)�DistutilsByteCompileError�DistutilsPlatformError)�spawn)� TypeVarTuple�Unpack�_Ts�return�strc C s t �� S )z� Return a string that identifies the current platform. Use this function to distinguish platform-specific build directories and platform-specific built distributions. )� sysconfig� get_platform� r r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/util.py�get_host_platform# s r c C s: t jdkrddddd�} t j�d�}| �|�pt� S t� S )N�nt�win32z win-amd64z win-arm32z win-arm64)�x86�x64�arm�arm64�VSCMD_ARG_TGT_ARCH)�os�name�environ�getr )�TARGET_TO_PLAT�targetr r r r 1 s � r �darwin�MACOSX_DEPLOYMENT_TARGETc C s da dS )z For testing only. Do not call.N)�_syscfg_macosx_verr r r r �_clear_cached_macosx_verC s r) c C s. t du rddlm} | �t�pd}|r|a t S )z�Get the version of macOS latched in the Python interpreter configuration. Returns the version as a string or None if can't obtain one. Cached.Nr )r � )r( � distutilsr �get_config_var�MACOSX_VERSION_VAR)r �verr r r �!get_macosx_target_ver_from_syscfgI s r/ c C sd t � } tj�t�}|r0| r.t| �ddgkr.t|�ddgk r.dt d|� d| � d� }t|��|S | S )a Return the version of macOS for which we are building. The target version defaults to the version in sysconfig latched at time the Python interpreter was built, unless overridden by an environment variable. If neither source has a value, then None is returned� � �$z mismatch: now "z" but "z*" during configure; must use 10.3 or later)r/ r r" r# r- � split_versionr )� syscfg_ver�env_ver�my_msgr r r �get_macosx_target_verV s ����r7 �s� list[int]c C s dd� | � d�D �S )zEConvert a dot-separated string into a list of numbers for comparisonsc S s g | ]}t |��qS r )�int)�.0�nr r r � <listcomp>x s z!split_version.<locals>.<listcomp>�.)�split)r8 r r r r3 v s r3 �pathname�str | os.PathLike[str]c C s t �t�| ��S )a. Allow for pathlib.Path inputs, coax to a native path string. If None is passed, will just pass it through as Setuptools relies on this behavior. >>> convert_path(None) is None True Removes empty paths. >>> convert_path('foo/./bar').replace('\\', '/') 'foo/bar' )r �fspath�pathlib�PurePath)r@ r r r � convert_path{ s rE �new_root� AnyStr | os.PathLike[AnyStr]r c C s� t jdkr t j�|�st j�| |�S t j�| |dd� �S t jdkr>t j�|�\}}|d t jkr7|dd� }t j�| |�S tdt j� d���)a Return 'pathname' with 'new_root' prepended. If 'pathname' is relative, this is equivalent to "os.path.join(new_root,pathname)". Otherwise, it requires making 'pathname' relative and then joining the two, which is tricky on DOS/Windows and Mac OS. �posixr Nr r z nothing known about platform '�')r r! �path�isabs�join� splitdrive�sepr )rF r@ �driverJ r r r � change_root� s rP �Nonec C sn t jdkr(dt jvr(zddl} | �t �� �d t jd< W n ttfy' Y nw dt jvr5t� t jd< dS dS )aL Ensure that 'os.environ' has all the environment variables we guarantee that users can use in config files, command-line options, etc. Currently this includes: HOME - user's home directory (Unix only) PLAT - description of the current platform, including hardware and OS (see 'get_platform()') rH �HOMEr N� �PLAT) r r! r" �pwd�getpwuid�getuid� ImportError�KeyErrorr )rU r r r � check_environ� s � �rZ � local_vars�Mapping[str, object]c C s` t � ttj�}|�dd� |�� D �� zt| ��|�W S ty/ } zt d|� ���d}~ww )a� Perform variable substitution on 'string'. Variables are indicated by format-style braces ("{var}"). Variable is substituted by the value found in the 'local_vars' dictionary or in 'os.environ' if it's not in 'local_vars'. 'os.environ' is first checked/augmented to guarantee that it contains certain values: see 'check_environ()'. Raise ValueError for any variables not found in either 'local_vars' or 'os.environ'. c s s � | ] \}}|t |�fV qd S �N�r )r; r! �valuer r r � <genexpr>� s � z subst_vars.<locals>.<genexpr>zinvalid variable N) rZ �dictr r" �update�items� _subst_compat� format_maprY � ValueError)r8 r[ �lookup�varr r r � subst_vars� s ��ri c C s6 dd� }t �d|| �}|| krddl}|�dt� |S )zb Replace shell/Perl-style variable substitution with format-style. For compatibility. c S s d| � d�� d�S )N�{r �})�group)�matchr r r �_subst� s z _subst_compat.<locals>._substz\$([a-zA-Z_][a-zA-Z_0-9]*)r Nz-shell/Perl-style substitutions are deprecated)�re�sub�warnings�warn�DeprecationWarning)r8 rn �replrq r r r rd � s �rd �error: �exc�object�prefixc C s |t | � S r] r^ )rv rx r r r �grok_environment_error� s ry c C s, t �dtj� d��at �d�at �d�ad S )Nz[^\\\'\"z ]*z'(?:[^'\\]|\\.)*'z"(?:[^"\\]|\\.)*")ro �compile�string� whitespace� _wordchars_re� _squote_re� _dquote_rer r r r � _init_regex� s r� � list[str]c C s� t du rt� | �� } g }d}| r�t �| |�}|�� }|t| �kr-|�| d|� � |S | | tjv rH|�| d|� � | |d� � � } d}nm| | dkra| d|� | |d d� } |d }nT| | dkrnt �| |�}n| | dkr{t �| |�}n t d| | � d���|du r�t d | | � d ���|�� \}}| d|� | |d |d � | |d� } |�� d }|t| �kr�|�| � |S | s|S ) a Split a string up according to Unix shell-like rules for quotes and backslashes. In short: words are delimited by spaces, as long as those spaces are not escaped by a backslash, or inside a quoted string. Single and double quotes are equivalent, and the quote characters can be backslash-escaped. The backslash is stripped from any two-character escape sequence, leaving only the escaped character. The quote characters are stripped from any quoted string. Returns a list of words. Nr �\r rI �"z this can't happen (bad char 'z')zbad string (mismatched z quotes?)� )r} r� �striprm �end�len�appendr{ r| �lstripr~ r � RuntimeErrorrf �span)r8 �words�pos�mr� �begr r r � split_quoted� sF "� , �'r� F�func� Callable[[Unpack[_Ts]], object]�args�tuple[Unpack[_Ts]]�msg�verbose�bool�dry_runc C sT |du r| j � |��}|dd� dkr|dd� d }t�|� |s(| |� dS dS )a} Perform some action that affects the outside world (e.g. by writing to the filesystem). Such actions are special because they are disabled by the 'dry_run' flag. This method handles that complication; simply supply the function to call and an argument tuple for it (to embody the "external action" being performed) and an optional message to emit. N���z,)r �))�__name__r �info)r� r� r� r� r� r r r �execute7 s �r� �valc C s. | � � } | dv r dS | dv rdS td| ����)z�Convert a string representation of truth to true (1) or false (0). True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if 'val' is anything else. )�y�yes�t�true�on�1T)r< �no�f�false�off�0Fzinvalid truth value )�lowerrf )r� r r r � strtoboolQ s r� T�py_files� Iterable[str]�optimizer: �force� str | None�base_dir�direct� bool | Nonec C s t jrtd��|du r|dk}|s�t�d�\}} t�d| � |satj|ddd �} | �/ | � d � | � d � t t | ��d � | � d |�d|�d|�d|�d|�d� � W d � n1 s\w Y t j g} | �t�� � | �| � t| |d� ttj| fd| � �|d� dS ddlm} | D ]v} | dd� dkr�q�|dkr�|dkr�dn|}tjj| |d�}ntj�| �}| }|r�| dt|�� |kr�td| �d|����|t|�d� }|r�tj � ||�}tj � |�}|�r|s�t | |�r�t�d| |� |s�| | ||� q�t� d | |� q�dS ) a~ Byte-compile a collection of Python source files to .pyc files in a __pycache__ subdirectory. 'py_files' is a list of files to compile; any files that don't end in ".py" are silently skipped. 'optimize' must be one of the following: 0 - don't optimize 1 - normal optimization (like "python -O") 2 - extra optimization (like "python -OO") If 'force' is true, all files are recompiled regardless of timestamps. The source filename encoded in each bytecode file defaults to the filenames listed in 'py_files'; you can modify these with 'prefix' and 'basedir'. 'prefix' is a string that will be stripped off of each source filename, and 'base_dir' is a directory name that will be prepended (after 'prefix' is stripped). You can supply either or both (or neither) of 'prefix' and 'base_dir', as you wish. If 'dry_run' is true, doesn't actually do anything that would affect the filesystem. Byte-compilation is either done directly in this interpreter process with the standard py_compile module, or indirectly by writing a temporary script and executing it. Normally, you should let 'byte_compile()' figure out to use direct compilation or not (see the source for details). The 'direct' flag is used by the script generated in indirect mode; unless you know what you're doing, leave it set to None. zbyte-compiling is disabled.NTr z.pyz$writing byte-compilation script '%s'�wzutf-8)�encodingz2from distutils.util import byte_compile files = [ z, z] z byte_compile(files, optimize=z, force=z, prefix=z , base_dir=z, verbose=z+, dry_run=False, direct=True) )r� z removing )rz ���r* )� optimizationzinvalid prefix: filename z doesn't start with zbyte-compiling %s to %sz%skipping byte-compilation of %s to %s) �sys�dont_write_bytecoder �tempfile�mkstempr r� r �fdopen�writerL �map�repr� executable�extend� subprocess�"_optim_args_from_interpreter_flagsr� r r� �remove� py_compilerz � importlib�util�cache_from_sourcer� rf rJ �basenamer �debug)r� r� r� rx r� r� r� r� � script_fd� script_name�script�cmdrz �file�opt�cfile�dfile� cfile_baser r r � byte_compilea sx ( ������� � � ���r� �headerc C sF d}| j dd�}|o|d � � d |d k}|r|nd}|�|�| S )z�Return a version of the string escaped for inclusion in an RFC-822 header, by ensuring there are 8 spaces space after each newline. z T)�keepends���r r* )� splitlinesrL )r� �indent�lines�ends_in_newline�suffixr r r � rfc822_escape� s r� c C s t jdko t� �d�S )z�Returns True if the current platform is mingw. Python compiled with Mingw-w64 has sys.platform == 'win32' and get_platform() starts with 'mingw'. r �mingw)r� �platformr � startswithr r r r �is_mingw� s r� c C s t t�d��S )zKReturn True if the Python interpreter is built with free threading support.�Py_GIL_DISABLED)r� r r, r r r r �is_freethreaded s r� )r r )r8 r r r9 )r@ rA r r )rF rG r@ rG r r )r rQ )r[ r\ r r )ru )rv rw rx r r r )r8 r r r� )NFF) r� r� r� r� r� rw r� r� r� r� r rQ )r� r r r� )r FNNTFN)r� r� r� r: r� r� rx r� r� r� r� r� r� r� r� r� r rQ )r� r r r )r r� )>�__doc__� __future__r � functools�importlib.utilr� r rC ro r{ r� r� r r� �collections.abcr r r �typingr r �jaraco.functoolsr �_logr � _modifiedr �errorsr r r �typing_extensionsr r r r r r� r( r- r) r/ r7 r3 rE rP � lru_cacherZ ri rd ry r} r~ r r� r� r� r� r� r� r� r� r r r r �<module> sv E � � _distutils/__pycache__/core.cpython-310.pyc 0000644 00000016043 15030122015 0014561 0 ustar 00 o �h�$ � @ s� d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddl m Z ddl m Z dd lmZmZmZmZ dd lmZ g d �Zd Zd d� ZdadadZdZdd� Z dd� Z dddd�Z dS ) a# distutils.core The only module that needs to be imported to use the Distutils; provides the 'setup' function (which is to be called from the setup script). Also indirectly provides the Distribution and Command classes, although they are really defined in distutils.dist and distutils.cmd. � )� annotationsN)�Iterable� )�Command)�DEBUG)� Distribution)�CCompilerError�DistutilsArgError�DistutilsError�DistutilsSetupError)� Extension)r r r �setupz�usage: %(script)s [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] or: %(script)s --help [cmd1 cmd2 ...] or: %(script)s --help-commands or: %(script)s cmd --help c C s t j�| �}tt� S )N)�os�path�basename�USAGE�locals)� script_name�script� r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/core.py� gen_usage+ s r )� distclassr � script_args�options�name�version�author� author_email� maintainer�maintainer_email�url�license� description�long_description�keywords� platforms� classifiers� download_url�requires�provides� obsoletes)r �sources� include_dirs� define_macros� undef_macros� library_dirs� libraries�runtime_library_dirs� extra_objects�extra_compile_args�extra_link_args� swig_opts�export_symbols�depends�languagec K sL | � d�}|r | �d� nt}d| vr tj�tjd �| d< d| vr+tjdd� | d< z|| � a}W n! t yT } zd| vrFt d|� ���t d � | d |���d}~ww t d kr[|S |� � tritd � |�� t d kro|S z|�� }W n ty� } z t t|j�d |� � ��d}~ww tr�td� |�� t dkr�|S |r�t|�S |S )a� The gateway to the Distutils: do everything your setup script needs to do, in a highly flexible and user-driven way. Briefly: create a Distribution instance; find and parse config files; parse the command line; run each Distutils command found there, customized by the options supplied to 'setup()' (as keyword arguments), in config files, and on the command line. The Distribution instance might be an instance of a class supplied via the 'distclass' keyword argument to 'setup'; if no such class is supplied, then the Distribution class (in dist.py) is instantiated. All other arguments to 'setup' (except for 'cmdclass') are used to set attributes of the Distribution instance. The 'cmdclass' argument, if supplied, is a dictionary mapping command names to command classes. Each command encountered on the command line will be turned into a command class, which is in turn instantiated; any class found in 'cmdclass' is used in place of the default, which is (for command 'foo_bar') class 'foo_bar' in module 'distutils.command.foo_bar'. The command class must provide a 'user_options' attribute which is a list of option specifiers for 'distutils.fancy_getopt'. Any command-line options between the current and the next command are used to set attributes of the current command object. When the entire command-line has been successfully parsed, calls the 'run()' method on each command object in turn. This method will be driven entirely by the Distribution object (which each command object has a reference to, thanks to its constructor), and the command-specific options that became attributes of each command object. r r r r r Nr zerror in setup command: z error in {} setup command: {}�initz%options (after parsing config files):�configz error: z%options (after parsing command line):� commandline)�get�popr r r r �sys�argv�_setup_distributionr � SystemExit�format�_setup_stop_after�parse_config_filesr �print�dump_option_dicts�parse_command_liner r r � run_commands)�attrs�klass�dist�msg�okr r r r a sL % �� ��r c C s� z| � � W | S ty td�� ty1 } ztr&tj�d|� d�� � td|� ���d}~w tt fyI } z tr=� tdt |� ��d}~ww )z�Given a Distribution object run all the commands, raising ``SystemExit`` errors in the case of failure. This function assumes that either ``sys.argv`` or ``dist.script_args`` is already set accordingly. � interruptedzerror: � N) rI �KeyboardInterruptrB �OSErrorr r? �stderr�writer r �str)rL �excrM r r r rI � s" ����rI �runr �Iterable[str] | Nonec C s� |dvr t d|����|atj�� }| dd�}zBz9| tjd< |dur)|tjdd�< t�| ��}|�� �dd �}t ||� W d � n1 sFw Y W |t_dan|t_daw W n t yb Y nw t du rot d | � d ���t S ) a. Run a setup script in a somewhat controlled environment, and return the Distribution instance that drives things. This is useful if you need to find out the distribution meta-data (passed as keyword args from 'script' to 'setup()', or the contents of the config files or command-line. 'script_name' is a file that will be read and run with 'exec()'; 'sys.argv[0]' will be replaced with 'script' for the duration of the call. 'script_args' is a list of strings; if supplied, 'sys.argv[1:]' will be replaced by 'script_args' for the duration of the call. 'stop_after' tells 'setup()' when to stop processing; possible values: init stop after the Distribution instance has been created and populated with the keyword arguments to 'setup()' config stop after config files have been parsed (and their data stored in the Distribution instance) commandline stop after the command-line ('sys.argv[1:]' or 'script_args') have been parsed (and the data stored in the Distribution) run [default] stop after all commands have been run (the same as if 'setup()' had been called in the usual way Returns the Distribution instance, which provides all information used to drive the Distutils. )r: r; r< rW z invalid value for 'stop_after': �__main__)�__file__�__name__r Nr z\r\nz\nz6'distutils.core.setup()' was never called -- perhaps 'z"' is not a Distutils setup script?) � ValueErrorrD r? r@ �copy�tokenize�open�read�replace�execrB rA � RuntimeError)r r � stop_after� save_argv�g�f�coder r r � run_setup� s: ��� ���ri )NrW )r rX ) �__doc__� __future__r r r? r^ �collections.abcr �cmdr �debugr rL r �errorsr r r r � extensionr �__all__r r rD rA �setup_keywords�extension_keywordsr rI ri r r r r �<module> s* a _distutils/__pycache__/extension.cpython-310.pyc 0000644 00000016756 15030122015 0015660 0 ustar 00 o �h�+ � @ sF d Z ddlmZ ddlZddlZddlmZ G dd� d�Zdd� ZdS ) zmdistutils.extension Provides the Extension class, used to describe C/C++ extension modules in setup scripts.� )� annotationsN)�Iterablec @ s@ e Zd ZdZ d d dd�Zdd � ZdS ) � Extensiona� Just a collection of attributes that describes an extension module and everything needed to build it (hopefully in a portable way, but there are hooks that let you be as unportable as you need). Instance attributes: name : string the full name of the extension, including any packages -- ie. *not* a filename or pathname, but Python dotted name sources : Iterable[string | os.PathLike] iterable of source filenames (except strings, which could be misinterpreted as a single filename), relative to the distribution root (where the setup script lives), in Unix form (slash-separated) for portability. Can be any non-string iterable (list, tuple, set, etc.) containing strings or PathLike objects. Source files may be C, C++, SWIG (.i), platform-specific resource files, or whatever else is recognized by the "build_ext" command as source for a Python extension. include_dirs : [string] list of directories to search for C/C++ header files (in Unix form for portability) define_macros : [(name : string, value : string|None)] list of macros to define; each macro is defined using a 2-tuple, where 'value' is either the string to define it to or None to define it without a particular value (equivalent of "#define FOO" in source or -DFOO on Unix C compiler command line) undef_macros : [string] list of macros to undefine explicitly library_dirs : [string] list of directories to search for C/C++ libraries at link time libraries : [string] list of library names (not filenames or paths) to link against runtime_library_dirs : [string] list of directories to search for C/C++ libraries at run time (for shared extensions, this is when the extension is loaded) extra_objects : [string] list of extra files to link with (eg. object files not implied by 'sources', static library that must be explicitly specified, binary resource files, etc.) extra_compile_args : [string] any extra platform- and compiler-specific information to use when compiling the source files in 'sources'. For platforms and compilers where "command line" makes sense, this is typically a list of command-line arguments, but for other platforms it could be anything. extra_link_args : [string] any extra platform- and compiler-specific information to use when linking object files together to create the extension (or to create a new static Python interpreter). Similar interpretation as for 'extra_compile_args'. export_symbols : [string] list of symbols to be exported from a shared extension. Not used on all platforms, and not generally necessary for Python extensions, which typically export exactly one symbol: "init" + extension_name. swig_opts : [string] any extra options to pass to SWIG if a source file has the .i extension. depends : [string] list of files that the extension depends on language : string extension language (i.e. "c", "c++", "objc"). Will be detected from the source extensions if not provided. optional : boolean specifies that a build failure in the extension should not abort the build process, but simply not install the failing extension. N�name�str�sources� Iterable[str | os.PathLike[str]]� include_dirs�list[str] | None� define_macros�#list[tuple[str, str | None]] | None� undef_macros� library_dirs� libraries�runtime_library_dirs� extra_objects�extra_compile_args�extra_link_args�export_symbols� swig_opts�depends�language� str | None�optional� bool | Nonec K s t |t�s td��t |t�rtd��z tttj|��| _W n ty( td��w || _|p/g | _ |p4g | _ |p9g | _ |p>g | _ |pCg | _ |pHg | _| pMg | _| pRg | _| pWg | _| p\g | _| pag | _|pfg | _|| _|| _t|�dkr�dd� |D �}d�t|��}d|� �}t�|� d S d S ) Nz'name' must be a stringzJ'sources' must be an iterable of strings or PathLike objects, not a stringz<'sources' must be an iterable of strings or PathLike objectsr c S s g | ]}t |��qS � )�repr)�.0�optionr r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/extension.py� <listcomp>� s z&Extension.__init__.<locals>.<listcomp>z, zUnknown Extension options: ) � isinstancer � TypeError�list�map�os�fspathr r r r r r r r r r r r r r r r �len�join�sorted�warnings�warn)�selfr r r r r r r r r r r r r r r r �kw�options�msgr r r �__init__\ sD � �� �zExtension.__init__c C s. d| j j� d| j j� d| j�dt| �d�d� S )N�<�.�(z) at z#x�>)� __class__� __module__� __qualname__r �id)r, r r r �__repr__� s .zExtension.__repr__)NNNNNNNNNNNNNN) r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r )�__name__r6 r7 �__doc__r0 r9 r r r r r s$ H � <r c C s� ddl m}m}m} ddlm} ddlm} || �}|| dddddd�}�z0g } |�� } | du r3�n |� | �r9q(| d | d krGd krSn n |� d | � d �� q(|| |�} || �} | d } t | g �} d} | d d� D ]�}| dur{| � |� d} qmt j�|�d }|dd � }|d d� }|dv r�| j� |� qm|dkr�| j� |� qm|dkr�|�d�}|dkr�| j� |df� qm| j� |d|� ||d d� f� qm|dkr�| j� |� qm|dkr�| j� |� qm|dkr�| j� |� qm|dkr�| j� |� qm|dk�r| j� |� qm|dk�r| j} qm|dk�r| j} qm|dk�r!| j} qm|dk�r3| j� |� |�s2| j} qm|dv �r?| j� |� qm|� d |� d �� qm|� | � q)W |�� |S |�� w ) z3Reads a Setup file and returns Extension instances.r )� _variable_rx�expand_makefile_vars�parse_makefile)�TextFile)� split_quotedT)�strip_comments� skip_blanks� join_lines� lstrip_ws� rstrip_wsN����*�'z' lines not handled yet� � )z.cz.ccz.cppz.cxxz.c++z.mz.mmz-Iz-D�=z-Uz-Cz-lz-Lz-Rz-rpathz-Xlinkerz -Xcompilerz-u)z.az.soz.slz.oz.dylibzunrecognized argument ') �distutils.sysconfigr< r= r> �distutils.text_filer? �distutils.utilr@ �readline�matchr+ r �appendr% �path�splitextr r �findr r r r r r r r �close)�filenamer< r= r> r? r@ �vars�file� extensions�line�words�module�ext�append_next_word�word�suffix�switch�value�equalsr r r �read_setup_file� s� � & � �K �rd ) r; � __future__r r% r* �collections.abcr r rd r r r r �<module> s _distutils/__pycache__/version.cpython-310.pyc 0000644 00000017661 15030122015 0015325 0 ustar 00 o �hK1 � @ s\ d Z ddlZddlZddlZejdd� �ZG dd� d�ZG dd� de�ZG d d � d e�ZdS ) a� Provides classes to represent module version numbers (one class for each style of version numbering). There are currently two such classes implemented: StrictVersion and LooseVersion. Every version number class implements the following interface: * the 'parse' method takes a string and parses it to some internal representation; if the string is an invalid version number, 'parse' raises a ValueError exception * the class constructor takes an optional string argument which, if supplied, is passed to 'parse' * __str__ reconstructs the string that was passed to 'parse' (or an equivalent string -- ie. one that will generate an equivalent version number instance) * __repr__ generates Python code to recreate the version number instance * _cmp compares the current instance with either another instance of the same class or a string (which will be parsed to an instance of the same class, thus must follow the same rules) � Nc c sJ � t jdd��} t jdtdd� | V W d � d S 1 s w Y d S )NT)�record�defaultz)distutils Version classes are deprecated.)�action�category�message)�warnings�catch_warnings�filterwarnings�DeprecationWarning)�ctx� r �P/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/version.py�suppress_known_deprecation" s ��"�r c @ sJ e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dS )�Versionz�Abstract base class for version numbering classes. Just provides constructor (__init__) and reproducer (__repr__), because those seem to be the same for all version numbering classes; and route rich comparisons to _cmp. Nc C s" |r| � |� tjdtdd� d S )NzHdistutils Version classes are deprecated. Use packaging.version instead.� )� stacklevel)�parser �warnr ��self�vstringr r r �__init__4 s �zVersion.__init__c C s | j j� d| � d�S )Nz ('�'))� __class__�__name__�r r r r �__repr__= s zVersion.__repr__c C s | � |�}|tu r |S |dkS �Nr ��_cmp�NotImplemented�r �other�cr r r �__eq__@ � zVersion.__eq__c C s | � |�}|tu r |S |dk S r r r! r r r �__lt__F r% zVersion.__lt__c C s | � |�}|tu r |S |dkS r r r! r r r �__le__L r% zVersion.__le__c C s | � |�}|tu r |S |dkS r r r! r r r �__gt__R r% zVersion.__gt__c C s | � |�}|tu r |S |dkS r r r! r r r �__ge__X r% zVersion.__ge__�N) r � __module__� __qualname__�__doc__r r r$ r& r' r( r) r r r r r - s r c @ sD e Zd ZdZe�dejejB �Zdd� Z dd� Z dd� Z d d � Z d S ) � StrictVersiona? Version numbering for anal retentives and software idealists. Implements the standard interface for version number classes as described above. A version number consists of two or three dot-separated numeric components, with an optional "pre-release" tag on the end. The pre-release tag consists of the letter 'a' or 'b' followed by a number. If the numeric components of two version numbers are equal, then one with a pre-release tag will always be deemed earlier (lesser) than one without. The following are valid version numbers (shown in the order that would be obtained by sorting according to the supplied cmp function): 0.4 0.4.0 (these two are equivalent) 0.4.1 0.5a1 0.5b3 0.5 0.9.6 1.0 1.0.4a3 1.0.4b1 1.0.4 The following are examples of invalid version numbers: 1 2.7.2.2 1.3.a4 1.3pl1 1.3c4 The rationale for this version numbering system will be explained in the distutils documentation. z)^(\d+) \. (\d+) (\. (\d+))? ([ab](\d+))?$c C s� | j �|�}|std|� d���|�ddddd�\}}}}}|r,ttt|||g��| _n ttt||g��d | _|rE|d t|�f| _d S d | _d S ) Nzinvalid version number '�'� r � � � )r r ) � version_re�match� ValueError�group�tuple�map�int�version� prerelease)r r r5 �major�minor�patchr< �prerelease_numr r r r � s zStrictVersion.parsec C sb | j d dkrd�tt| j dd� ��}n d�tt| j ��}| jr/|| jd t| jd � }|S )Nr r �.r0 )r; �joinr9 �strr< r r r r �__str__� s zStrictVersion.__str__c C sr t |t�r t� � t|�}W d � n1 sw Y nt |t�s$tS | j|jkr/| �|�S | j|jk r7dS dS )N���r0 )� isinstancerC r r. r r; �_cmp_prerelease�r r" r r r r � s �� zStrictVersion._cmpc C sD | j r|j sdS | j s|j rdS | j |j krdS | j |j k r dS dS )z� case 1: self has prerelease, other doesn't; other is greater case 2: self doesn't have prerelease, other does: self is greater case 3: both or neither have prerelease: compare them! rE r0 r )r< rH r r r rG � s z StrictVersion._cmp_prereleaseN) r r+ r, r- �re�compile�VERBOSE�ASCIIr4 r rD r rG r r r r r. p s # � r. c @ s> e Zd ZdZe�dej�Zdd� Zdd� Z dd� Z d d � Z d S ) � LooseVersiona� Version numbering for anarchists and software realists. Implements the standard interface for version number classes as described above. A version number consists of a series of numbers, separated by either periods or strings of letters. When comparing version numbers, the numeric components will be compared numerically, and the alphabetic components lexically. The following are all valid version numbers, in no particular order: 1.5.1 1.5.2b2 161 3.10a 8.02 3.4j 1996.07.12 3.2.pl0 3.1.1.6 2g6 11g 0.960923 2.2beta29 1.13++ 5.5.kw 2.0b1pl0 In fact, there is no such thing as an invalid version number under this scheme; the rules for comparison are simple and predictable, but may not always give the results you want (for some definition of "want"). z(\d+ | [a-z]+ | \.)c C sZ || _ dd� | j�|�D �}t|�D ]\}}zt|�||< W q ty' Y qw || _d S )Nc S s g | ] }|r|d kr|�qS )rA r )�.0�xr r r � <listcomp>? s z&LooseVersion.parse.<locals>.<listcomp>)r � component_re�split� enumerater: r6 r; )r r � components�i�objr r r r : s � zLooseVersion.parsec C s | j S r* )r r r r r rD H s zLooseVersion.__str__c C s d| � d�S )NzLooseVersion ('r r r r r r r K s zLooseVersion.__repr__c C sV t |t�r t|�}nt |t�stS | j|jkrdS | j|jk r!dS | j|jkr)dS d S )Nr rE r0 )rF rC rM r r; rH r r r r N s �zLooseVersion._cmpN) r r+ r, r- rI rJ rK rQ r rD r r r r r r rM s rM ) r- � contextlibrI r �contextmanagerr r r. rM r r r r �<module> s C ) _distutils/__pycache__/__init__.cpython-310.pyc 0000644 00000000554 15030122015 0015370 0 ustar 00 o �hg � @ sH d dl Z d dlZej�d�\ZZZze �d� W dS ey# Y dS w )� N� �_distutils_system_mod)� importlib�sys�version� partition� __version__�_� import_module� ImportError� r r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/__init__.py�<module> s � _distutils/__pycache__/archive_util.cpython-310.pyc 0000644 00000016026 15030122015 0016310 0 ustar 00 o �h�" � @ s� d Z ddlmZ ddlZddlmZmZ zddlZW n ey% dZY nw ddl m Z ddl m Z ddl mZ dd lmZ zdd lmZ W n eyQ dZY nw zdd lmZ W n eye dZY nw d d � Zdd� Z d9d:d d �Z d;d<d!d"�Zed#gd$fed%gd&fed'gd(fed)gd*fed+gd,feg d-fd.�Zd/d0� Ze d=d>d4d5��Ze d?d@d7d5��Z d=dAd8d5�ZdS )Bzodistutils.archive_util Utility functions for creating archive files (tarballs, zip files, that sort of thing).� )� annotationsN)�Literal�overload� )�log)�mkpath)�DistutilsExecError)�spawn)�getpwnam)�getgrnamc C �L t du s| du r dS zt | �}W n ty d}Y nw |dur$|d S dS )z"Returns a gid, given a group name.N� )r �KeyError��name�result� r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/archive_util.py�_get_gid! � �r c C r )z"Returns an uid, given a user name.Nr )r r r r r r �_get_uid. r r �gzipF� base_name�str�base_dir�str | os.PathLike[str]�compress�%Literal['gzip', 'bzip2', 'xz'] | None�verbose�bool�dry_run�owner� str | None�group�returnc s� ddddd�}dddd �}|d ur||� � vrtd ��| d } | |�|d�7 } ttj�| �|d � dd l} t� d� t ���t ��� � ���fdd�} |sl| � | d|| � ��} z| j || d� W | �� | S | �� w | S )a� Create a (possibly compressed) tar file from all the files under 'base_dir'. 'compress' must be "gzip" (the default), "bzip2", "xz", or None. 'owner' and 'group' can be used to define an owner and a group for the archive that is being built. If not provided, the current owner and group will be used. The output tar file will be named 'base_dir' + ".tar", possibly plus the appropriate compression extension (".gz", ".bz2", ".xz" or ".Z"). Returns the output filename. �gz�bz2�xz� )r �bzip2r' Nz.gzz.bz2z.xz)r r) r' Nz=bad value for 'compress': must be None, 'gzip', 'bzip2', 'xz'z.tar�r r zCreating tar archivec s, � d ur � | _ �| _�d ur�| _�| _| S �N)�gid�gname�uid�uname)�tarinfo�r, r# r! r. r r � _set_uid_gidm s z"make_tarball.<locals>._set_uid_gidzw|)�filter)�keys� ValueError�getr �os�path�dirname�tarfiler �infor r �open�add�close) r r r r r r! r# �tar_compression� compress_ext� archive_namer: r2 �tarr r1 r � make_tarball; s4 � � �rC c C s� | d }t tj�|�|d� tdu r6|rd}nd}z td|||g|d� W |S ty5 td|� d���w t�d ||� |s�z tj |d tj d �}W n t y\ tj |d tj d �}Y nw |�o |tj kr|tj�tj�|d ��}|�||� t�d |� t�|�D ]D\}} } | D ]} tj�tj�|| d ��}|�||� t�d |� q�| D ] } tj�tj�|| ��}tj�|�r�|�||� t�d |� q�q�W d � |S 1 s�w Y |S )av Create a zip file from all the files under 'base_dir'. The output zip file will be named 'base_name' + ".zip". Uses either the "zipfile" Python module (if available) or the InfoZIP "zip" utility (if installed and found on the default search path). If neither tool is available, raises DistutilsExecError. Returns the name of the output zip file. z.zipr* Nz-rz-rq�zipzunable to create zip file 'zN': could neither import the 'zipfile' module nor find a standalone zip utilityz#creating '%s' and adding '%s' to it�w)� compressionr( z adding '%s')r r7 r8 r9 �zipfiler r r r; �ZipFile� ZIP_DEFLATED� RuntimeError� ZIP_STORED�curdir�normpath�join�write�walk�isfile) r r r r � zip_filename� zipoptionsrD r8 �dirpath�dirnames� filenamesr r r r � make_zipfile� sZ % � �� � � ��� ��rW )r r zgzip'ed tar-file)r r) zbzip2'ed tar-file)r r' zxz'ed tar-file)r r zcompressed tar file)r Nzuncompressed tar filezZIP file)�gztar�bztar�xztar�ztarrB rD c C s | D ] }|t vr | S qdS )zqReturns the first format from the 'format' list that is unknown. If all formats are known, returns None N)�ARCHIVE_FORMATS)�formats�formatr r r �check_archive_formats� s �r_ r^ �root_dir�:str | os.PathLike[str] | bytes | os.PathLike[bytes] | Nonec C � d S r+ r �r r^ r` r r r r! r# r r r � make_archive� � rd �3str | os.PathLike[str] | bytes | os.PathLike[bytes]c C rb r+ r rc r r r rd � re c C s t �� }|durt�d|� t j�| �} |st �|� |du r"t j}d|i} zt| } W n t y; t d|� d���w | d } | � | d � |dkrS|| d < || d < z| | |fi | ��} W |durmt�d |� t �|� | S |durt�d |� t �|� w w ) a� Create an archive file (eg. zip or tar). 'base_name' is the name of the file to create, minus any format-specific extension; 'format' is the archive format: one of "zip", "tar", "gztar", "bztar", "xztar", or "ztar". 'root_dir' is a directory that will be the root directory of the archive; ie. we typically chdir into 'root_dir' before creating the archive. 'base_dir' is the directory where we start archiving from; ie. 'base_dir' will be the common prefix of all files and directories in the archive. 'root_dir' and 'base_dir' both default to the current directory. Returns the name of the archive file. 'owner' and 'group' are used when creating a tar archive. By default, uses the current owner and group. Nzchanging into '%s'r zunknown archive format '�'r r rD r! r# zchanging back to '%s') r7 �getcwdr �debugr8 �abspath�chdirrL r\ r r5 �update) r r^ r` r r r r! r# �save_cwd�kwargs� format_info�func�filenamer r r rd � s: � � �)r FFNN)r r r r r r r r r r r! r" r# r" r$ r )FF) r r r r r r r r r$ r )NNFFNN)r r r^ r r` ra r r" r r r r r! r" r# r" r$ r )NFFNN)r r r^ r r` rf r r" r r r r r! r" r# r" r$ r )r r r^ r r` ra r r" r r r r r! r" r# r" r$ r )�__doc__� __future__r r7 �typingr r rG � ImportError�_logr �dir_utilr �errorsr r �pwdr �grpr r r rC rW r\ r_ rd r r r r �<module> s� � � � �H � C � � � � _distutils/__pycache__/unixccompiler.cpython-310.pyc 0000644 00000000506 15030122015 0016507 0 ustar 00 o �h� � @ s( d dl Z ddlmZ ejZe �d� dS )� N� )�unixzdistutils.ccompiler)� importlib� compilers.Cr �Compiler� UnixCCompiler� import_module� r r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/unixccompiler.py�<module> s _distutils/__pycache__/text_file.cpython-310.pyc 0000644 00000020106 15030122015 0015607 0 ustar 00 o �hE/ � @ s d Z ddlZG dd� d�ZdS )z�text_file provides the TextFile class, which gives an interface to text files that (optionally) takes care of stripping comments, ignoring blank lines, and joining lines with backslashes.� Nc @ st e Zd ZdZdddddddd�Zddd�Zd d � Zd d � Zdd d�Zddd�Z ddd�Z dd� Z dd� Z dd� Z dS )�TextFileae Provides a file-like object that takes care of all the things you commonly want to do when processing a text file that has some line-by-line syntax: strip comments (as long as "#" is your comment character), skip blank lines, join adjacent lines by escaping the newline (ie. backslash at end of line), strip leading and/or trailing whitespace. All of these are optional and independently controllable. Provides a 'warn()' method so you can generate warning messages that report physical line number, even if the logical line in question spans multiple physical lines. Also provides 'unreadline()' for implementing line-at-a-time lookahead. Constructor is called as: TextFile (filename=None, file=None, **options) It bombs (RuntimeError) if both 'filename' and 'file' are None; 'filename' should be a string, and 'file' a file object (or something that provides 'readline()' and 'close()' methods). It is recommended that you supply at least 'filename', so that TextFile can include it in warning messages. If 'file' is not supplied, TextFile creates its own using 'io.open()'. The options are all boolean, and affect the value returned by 'readline()': strip_comments [default: true] strip from "#" to end-of-line, as well as any whitespace leading up to the "#" -- unless it is escaped by a backslash lstrip_ws [default: false] strip leading whitespace from each line before returning it rstrip_ws [default: true] strip trailing whitespace (including line terminator!) from each line before returning it skip_blanks [default: true} skip lines that are empty *after* stripping comments and whitespace. (If both lstrip_ws and rstrip_ws are false, then some lines may consist of solely whitespace: these will *not* be skipped, even if 'skip_blanks' is true.) join_lines [default: false] if a backslash is the last non-newline character on a line after stripping comments and whitespace, join the following line to it to form one "logical line"; if N consecutive lines end with a backslash, then N+1 physical lines will be joined to form one logical line. collapse_join [default: false] strip leading whitespace from lines that are joined to their predecessor; only matters if (join_lines and not lstrip_ws) errors [default: 'strict'] error handler used to decode the file content Note that since 'rstrip_ws' can strip the trailing newline, the semantics of 'readline()' must differ from those of the builtin file object's 'readline()' method! In particular, 'readline()' returns None for end-of-file: an empty string might just be a blank line (or an all-whitespace line), if 'rstrip_ws' is true but 'skip_blanks' is not.� r �strict)�strip_comments� skip_blanks� lstrip_ws� rstrip_ws� join_lines� collapse_join�errorsNc K s� |du r |du r t d��| j�� D ]}||v r t| ||| � qt| || j| � q|�� D ]}|| jvr=td|� d���q.|du rH| �|� n || _|| _d| _g | _ dS )z�Construct a new TextFile object. At least one of 'filename' (a string) and 'file' (a file-like object) must be supplied. They keyword argument options are described above and affect the values returned by 'readline()'.Nz7you must supply either or both of 'filename' and 'file'zinvalid TextFile option '�'r ) � RuntimeError�default_options�keys�setattr�KeyError�open�filename�file� current_line�linebuf)�selfr r �options�opt� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/text_file.py�__init__O s$ � � zTextFile.__init__c C s$ || _ t| j | jdd�| _d| _dS )zvOpen a new file named 'filename'. This overrides both the 'filename' and 'file' arguments to the constructor.zutf-8)r �encodingr N)r r r r r )r r r r r r r s z TextFile.openc C s$ | j }d| _ d| _d| _|�� dS )zfClose the current file and forget everything we know about it (filename, current line number).N)r r r �close)r r r r r r y s zTextFile.closec C sp g }|d u r | j }|�| jd � t|ttf�r!|�dj|� � n |�dt|�� d�� |�t|�� d� |�S )Nz, z lines {}-{}: zline z: � ) r �appendr � isinstance�list�tuple�format�int�str�join)r �msg�line�outmsgr r r � gen_error� s zTextFile.gen_errorc C s t d| �||� ��)Nzerror: )� ValueErrorr+ �r r( r) r r r �error� s zTextFile.errorc C s t j�d| �||� d � dS )a� Print (to stderr) a warning message tied to the current logical line in the current file. If the current logical line in the file spans multiple physical lines, the warning refers to the whole range, eg. "lines 3-5". If 'line' supplied, it overrides the current line number; it may be a list or tuple to indicate a range of physical lines, or an integer for a single physical line.z warning: � N)�sys�stderr�writer+ r- r r r �warn� s z TextFile.warnc C s� | j r| j d }| j d= |S d} | j�� }|dkr d}| jrW|rW|�d�}|dkr+n,|dks7||d dkrQ|d d kr?d p@d}|d|� | }|�� dkrPqn|�d d�}| jr�|r�|du rg| �d � |S | j rn|� � }|| }t | j t �r�| j d d | j d< n%| j | j d g| _ n|du r�dS t | j t �r�| j d d | _ n| j d | _ | jr�| jr�|�� }n| jr�|� � }n| jr�|�� }|d v r�| jr�q| jr�|d dkr�|dd� }q|d d� dkr�|dd � d }q|S )a= Read and return a single logical line from the current file (or from an internal buffer if lines have previously been "unread" with 'unreadline()'). If the 'join_lines' option is true, this may involve reading multiple physical lines concatenated into a single string. Updates the current line number, so calling 'warn()' after 'readline()' emits a warning about the physical line(s) just read. Returns None on end-of-file, since the empty string can occur if 'rstrip_ws' is true but 'strip_blanks' is not.���r TN�#r r �\r/ z\#z2continuation line immediately precedes end-of-file)r r/ ���z\ )r r �readliner �find�strip�replacer r3 r �lstripr! r r" r r �rstripr )r r) � buildup_line�pos�eolr r r r8 � sf � zTextFile.readlinec C s& g } | � � }|du r |S |�|� q)zTRead and return the list of all logical lines remaining in the current file.TN)r8 r )r �linesr) r r r � readlines s �zTextFile.readlinesc C s | j �|� dS )z�Push 'line' (a string) onto an internal buffer that will be checked by future 'readline()' calls. Handy for implementing a parser with line-at-a-time lookahead.N)r r )r r) r r r � unreadline s zTextFile.unreadline)NN)N)�__name__� __module__� __qualname__�__doc__r r r r r+ r. r3 r8 rB rC r r r r r s& ;� # u r )rG r0 r r r r r �<module> s _distutils/__pycache__/_msvccompiler.cpython-310.pyc 0000644 00000001056 15030122015 0016471 0 ustar 00 o �hO � @ s, d dl Z ddlmZ dgZejZdd� ZdS )� N� )�msvc� MSVCCompilerc C s | dkr t �d� tjS t| ��)N� _get_vc_envz@_get_vc_env is private; find an alternative (pypa/distutils#340))�warnings�warnr r �AttributeError)�name� r �V/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/_msvccompiler.py� __getattr__ s �r )r � compilers.Cr �__all__�Compilerr r r r r r �<module> s _distutils/__pycache__/debug.cpython-310.pyc 0000644 00000000355 15030122015 0014716 0 ustar 00 o �h� � @ s d dl Z e j�d�ZdS )� N�DISTUTILS_DEBUG)�os�environ�get�DEBUG� r r �N/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/debug.py�<module> s _distutils/__pycache__/fancy_getopt.cpython-310.pyc 0000644 00000025177 15030122015 0016323 0 ustar 00 o �h�E � @ s d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m Z ddl m Z m Z dZe�d e� d ��Ze�d e� d e� d ��Ze�dd�ZG dd� d�Zd#dd�Zdd� ejD �Zdd� Zdd� ZG d d � d �Ze d kr�d Z d D ]Z e d!e � �� e d"� ee e ��� e � qtdS dS )$a6 distutils.fancy_getopt Wrapper around the standard getopt module that provides the following additional features: * short and long options are tied together * options have help strings, so fancy_getopt could potentially create a complete usage summary * options set attributes of a passed-in object � )� annotationsN)�Sequence)�Any� )�DistutilsArgError�DistutilsGetoptErrorz[a-zA-Z](?:[a-zA-Z0-9-]*)�^�$z^(z)=!(z)$�-�_c @ s� e Zd ZdZd!dd�Zdd� Zdd� Zd"d d �Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z d"d#dd�Zdd � Zd!d d �Zd"d d �ZdS )$� FancyGetopta� Wrapper around the standard 'getopt()' module that provides some handy extra functionality: * short and long options are tied together * options have help strings, and help text can be assembled from them * options set attributes of a passed-in object * boolean options can have "negative aliases" -- eg. if --quiet is the "negative alias" of --verbose, then "--quiet" on the command line sets 'verbose' to false Nc C sN || _ i | _| j r | �� i | _i | _g | _g | _i | _i | _i | _ g | _ d S �N) � option_table� option_index� _build_index�alias�negative_alias� short_opts� long_opts� short2long� attr_name� takes_arg� option_order��selfr � r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/fancy_getopt.py�__init__1 s zFancyGetopt.__init__c C s( | j �� | jD ] }|| j |d < qd S )Nr )r �clearr )r �optionr r r r Y s �zFancyGetopt._build_indexc C s || _ | �� d S r )r r r r r r �set_option_table^ s z FancyGetopt.set_option_tablec C s> || j v r td|� d���|||f}| j�|� || j |< d S )Nz$option conflict: already an option '�')r r r �append)r � long_option� short_option� help_stringr r r r � add_optionb s � zFancyGetopt.add_optionc C s || j v S )zcReturn true if the option table for this parser has an option with long name 'long_option'.)r �r r# r r r � has_optionl s zFancyGetopt.has_optionc C s |� t�S )z�Translate long option name 'long_option' to the form it has as an attribute of some object: ie., translate hyphens to underscores.�� translate� longopt_xlater' r r r � get_attr_nameq � zFancyGetopt.get_attr_namec C sp t |t�sJ �|�� D ]*\}}|| jvr"td|� d|� d|� d���|| jvr5td|� d|� d|� d���q d S )Nzinvalid z 'z ': option 'z ' not defined�': aliased option ')� isinstance�dict�itemsr r )r �aliases�whatr �optr r r �_check_alias_dictw s � ���z FancyGetopt._check_alias_dictc C � | � |d� || _dS )z'Set the aliases for this option parser.r N)r5 r )r r r r r � set_aliases� s zFancyGetopt.set_aliasesc C r6 )z�Set the negative aliases for this option parser. 'negative_alias' should be a dictionary mapping option names to option names, both the key and value must already be defined in the option table.znegative aliasN)r5 r )r r r r r �set_negative_aliases� s z FancyGetopt.set_negative_aliasesc C s� g | _ g | _| j�� i | _| jD ]�}t|�dkr!|\}}}d}nt|�dkr.|\}}}}ntd|����t|t �r@t|�dk rHt d|� d���|du s_t|t �rWt|�d ks_t d |� d ���|| j|< | j � |� |d d kr�|rv|d }|dd � }d| j |< n$| j �|�}|dur�| j | r�t d|� d|� d���|| j d < d| j |< | j�|�}|dur�| j | | j | kr�t d|� d|� d���t�|�s�t d|� d���| �|�| j|< |r�| j� |� || j|d < qdS )z�Populate the various data structures that keep tabs on the option table. Called by 'getopt()' before it can do anything worthwhile. � r � zinvalid option tuple: � zinvalid long option 'z"': must be a string of length >= 2Nr zinvalid short option 'z"': must a single character or None����=�:Tzinvalid negative alias 'r. z' takes a valueFzinvalid alias 'z%': inconsistent with aliased option 'z/' (one of them takes a value, the other doesn'tzinvalid long option name 'z)' (must be letters, numbers, hyphens only)r r r r �repeatr �len� ValueErrorr/ �strr r" r r �getr � longopt_re�matchr, r )r r �long�short�helpr? �alias_tor r r �_grok_option_table� sl � � �� �� � ��z FancyGetopt._grok_option_table�args�Sequence[str] | Nonec C s� |du r t jdd� }|du rt� }d}nd}| �� d�| j�}z t�||| j�\}}W n tjy> } zt |��d}~ww |D ]y\}}t |�dkrY|d dkrY| j |d }nt |�dkrg|dd� d ksiJ �|dd� }| j � |�} | ry| }| j| s�|d ks�J d ��| j� |�} | r�| }d}nd}| j| } |r�| j� | �dur�t|| d�d }t|| |� | j�||f� qA|r�||fS |S ) a Parse command-line options in args. Store as attributes on object. If 'args' is None or not supplied, uses 'sys.argv[1:]'. If 'object' is None or not supplied, creates a new OptionDummy object, stores option values there, and returns a tuple (args, object). If 'object' is supplied, it is modified in place and 'getopt()' just returns 'args'; in both cases, the returned 'args' is a modified copy of the passed-in 'args' list, which is left untouched. Nr TF� r; r r z--� z boolean option can't have value)�sys�argv� OptionDummyrJ �joinr �getoptr �errorr r@ r r rC r r r r? �getattr�setattrr r" ) r rK �object�created_objectr �opts�msgr4 �valr �attrr r r rS � sJ �� zFancyGetopt.getoptc C s | j du r td��| j S )z�Returns the list of (option, value) tuples processed by the previous run of 'getopt()'. Raises RuntimeError if 'getopt()' hasn't been called yet. Nz!'getopt()' hasn't been called yet)r � RuntimeError)r r r r �get_option_order s z FancyGetopt.get_option_orderc C s� d}| j D ]&}|d }|d }t|�}|d dkr |d }|dur%|d }||kr+|}q|d d d }d}|| } d | } |rD|g} nd g} | j D ]y}|dd � \}}} t| | �} |d dkrf|dd� }|du r�| r~| �d |d |� ��d| d � �� n5| �d |d |� ���� n(|� d|� d�}| r�| �d |d |� ��d| d � �� n | �d |d |� ���� | dd� D ] }| �| | � q�qJ| S )z�Generate help text (a list of strings, one per suggested line of output) from the option table for this FancyGetopt object. r r r< r= N� r; �N rM zOption summary:r9 z --�<z z (-�))r r@ � wrap_textr" )r �header�max_optr rF rG �ell� opt_width� line_width� text_width� big_indent�linesrH �text� opt_namesr r r � generate_help' sH � $$�zFancyGetopt.generate_helpc C s0 |d u rt j}| �|�D ] }|�|d � q d S )N� )rO �stdoutrn �write)r rd �file�liner r r � print_helpu s �zFancyGetopt.print_helpr )NN�rK rL )�__name__� __module__� __qualname__�__doc__r r r r& r( r, r5 r7 r8 rJ rS r^ rn rt r r r r r % s ( P= Nr rK rL c C s t | �}|�|� |�||�S r )r r8 rS )�options� negative_optrW rK �parserr r r � fancy_getopt| s r} c C s i | ]}t |�d �qS )rM )�ord)�.0�_wscharr r r � <dictcomp>� s r� c C s | du rg S t | �|kr| gS | �� } | �t�} t�d| �}dd� |D �}g }|r�g }d}|rZt |d �}|| |krJ|�|d � |d= || }n|rW|d d dkrW|d= n|s/|r�|dkru|�|d d|� � |d |d� |d< |d d dkr�|d= |�d�|�� |s)|S ) z�wrap_text(text : string, width : int) -> [string] Split 'text' into multiple lines of no more than 'width' characters each, and return the list of strings that results. Nz( +|-+)c S s g | ]}|r|�qS r r )r �chr r r � <listcomp>� s z wrap_text.<locals>.<listcomp>r r< rM rN )r@ � expandtabsr* �WS_TRANS�re�splitr" rR )rl �width�chunksrk �cur_line�cur_lenrf r r r rc � s> � �"rc c C s | � t�S )zXConvert a long option name to a valid Python identifier by changing "-" to "_". r) )r4 r r r �translate_longopt� r- r� c @ s e Zd ZdZg fddd�ZdS )rQ z_Dummy class just used as a place to hold command-line option values as instance attributes.rz � Sequence[Any]c C s |D ]}t | |d� qdS )zkCreate a new OptionDummy instance. The attributes listed in 'options' will be initialized to None.N)rV )r rz r4 r r r r � s �zOptionDummy.__init__N)rz r� )rv rw rx ry r r r r r rQ � s rQ �__main__z�Tra-la-la, supercalifragilisticexpialidocious. How *do* you spell that odd word, anyways? (Someone ask Mary -- she'll know [or she'll say, "How should I know?"].))� � � �( zwidth: ro ru )!ry � __future__r rS r� �stringrO �collections.abcr �typingr �errorsr r � longopt_pat�compilerD � neg_alias_rerB � maketransr+ r r} � whitespacer� rc r� rQ rv rl �w�printrR r r r r �<module> s: Y6 � _distutils/__pycache__/cmd.cpython-310.pyc 0000644 00000042065 15030122015 0014377 0 ustar 00 o �h�V � @ s� d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m Z m Z ddl m Z mZmZmZmZ ddlmZmZmZmZmZ dd lmZ dd lmZ e rbdd l m Z dd l m Z m Z e d �Z!eddd�Z"eddd�Z#eddd�Z$G dd� d�Z%dS )ztdistutils.cmd Provides the Command class, the base class for the command classes in the distutils.command package. � )� annotationsN)�abstractmethod)�Callable�MutableSequence)� TYPE_CHECKING�Any�ClassVar�TypeVar�overload� )� _modified� archive_util�dir_util� file_util�util��log)�DistutilsOptionError�� Distribution)� TypeVarTuple�Unpack�_Ts� _StrPathT�str | os.PathLike[str])�bound� _BytesPathT�bytes | os.PathLike[bytes]� _CommandT�Commandc @ sJ e Zd ZU dZg Zded< g Zded< d�d d �Zd d � Zd�dd�Z e d�dd��Z e d�dd��Z d�dd�Z e d�dd��Zejfd�d d �Zd�d d!�Zd�d"d#�Zd�d�d(d)�Zd�d*d+�Zd�d,d-�Zd�d.d/�Zd�d0d1�Zd�d2d3�Zd�d7d8�Zd�d�d=d>�Ze ?d�d�dAdB��Z e ?d�d�dDdB��Z ?d�d�dFdB�Z d�dGdH�Z d�dJdK�Z d�dLdM�Z Nd�d�dSdT�Z!d�d�dXdY�Z"e 9 9 Nd�d�dbdc��Z#e 9 9 Nd�d�dgdc��Z# 9 9 Nd�d�djdc�Z# 9 9 ? Nd�d�dldm�Z$e Nd�d�dqdr��Z%e Nd�d�dtdr��Z% Nd�d�dudr�Z% Nd�d�dydz�Z&e d�d�d�d���Z'e d�d�d�d���Z' d�d�d�d��Z' Nd�d�d�d��Z(dS )�r a} Abstract base class for defining command classes, the "worker bees" of the Distutils. A useful analogy for command classes is to think of them as subroutines with local variables called "options". The options are "declared" in 'initialize_options()' and "defined" (given their final values, aka "finalized") in 'finalize_options()', both of which must be defined by every command class. The distinction between the two is necessary because option values might come from the outside world (command line, config file, ...), and any options dependent on other options must be computed *after* these outside influences have been processed -- hence 'finalize_options()'. The "body" of the subroutine, where it does all its work based on the values of its options, is the 'run()' method, which must also be implemented by every command class. z8ClassVar[list[tuple[str, Callable[[Any], bool] | None]]]� sub_commandszHClassVar[list[tuple[str, str, str]] | list[tuple[str, str | None, str]]]� user_options�distr �return�Nonec C sb ddl m} t||�std��| jtu rtd��|| _| �� d| _ |j | _ d| _ d| _ d| _ dS )z�Create and initialize a new Command object. Most importantly, invokes the 'initialize_options()' method, which is the real initializer and depends on the actual command being instantiated. r r z$dist must be a Distribution instancez Command is an abstract classNF)�distutils.distr � isinstance� TypeError� __class__r � RuntimeError� distribution�initialize_options�_dry_run�verbose�force�help� finalized)�selfr" r � r2 �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/cmd.py�__init__K s zCommand.__init__c C s6 |dkrt | d| �}|d u rt | j|�S |S t|��)N�dry_run�_)�getattrr* �AttributeError)r1 �attr�myvalr2 r2 r3 � __getattr__{ s zCommand.__getattr__c C s | j s| �� d| _ d S )NT)r0 �finalize_options�r1 r2 r2 r3 �ensure_finalized� s zCommand.ensure_finalizedc C � t d| j� d���)a� Set default values for all the options that this command supports. Note that these defaults may be overridden by other commands, by the setup script, by config files, or by the command-line. Thus, this is not the place to code dependencies between options; generally, 'initialize_options()' implementations are just a bunch of "self.foo = None" assignments. This method must be implemented by all command classes. � abstract method -- subclass � must override�r) r( r= r2 r2 r3 r+ � � �zCommand.initialize_optionsc C r? )a Set final values for all the options that this command supports. This is always called as late as possible, ie. after any option assignments from the command-line or from other commands have been done. Thus, this is the place to code option dependencies: if 'foo' depends on 'bar', then it is safe to set 'foo' from 'bar' as long as 'foo' still has the same value it was assigned in 'initialize_options()'. This method must be implemented by all command classes. r@ rA rB r= r2 r2 r3 r< � s �zCommand.finalize_optionsN� c C s� ddl m} |d u rd| �� � d�}| j|| tjd� |d }| jD ]*\}}}|�|�}|d dkr9|d d� }t| |�}| j||� d |� � tjd� q#d S ) Nr )� longopt_xlatezcommand options for 'z':)�levelz ����=z = ) �distutils.fancy_getoptrE �get_command_name�announce�logging�INFOr! � translater7 )r1 �header�indentrE �optionr6 �valuer2 r2 r3 � dump_options� s �zCommand.dump_optionsc C r? )a� A command's raison d'etre: carry out the action it exists to perform, controlled by the options initialized in 'initialize_options()', customized by other commands, the setup script, the command-line, and config files, and finalized in 'finalize_options()'. All terminal output and filesystem interaction should be done by 'run()'. This method must be implemented by all command classes. r@ rA rB r= r2 r2 r3 �run� rC z Command.run�msg�objectrF �intc C s t � ||� d S �Nr )r1 rU rF r2 r2 r3 rK � s zCommand.announcec C s* ddl m} |rt|� tj�� dS dS )z~Print 'msg' to stdout if the global DEBUG (taken from the DISTUTILS_DEBUG environment variable) flag is true. r )�DEBUGN)�distutils.debugrY �print�sys�stdout�flush)r1 rU rY r2 r2 r3 � debug_print� s �zCommand.debug_printc C sL t | |�}|d u rt| ||� |S t|t�s$td|� d|� d|� d���|S )N�'z ' must be a z (got `z`))r7 �setattrr& �strr )r1 rQ �what�default�valr2 r2 r3 �_ensure_stringlike� s zCommand._ensure_stringlikerQ rb rd � str | Nonec C s | � |d|� dS )zWEnsure that 'option' is a string; if not defined, set it to 'default'. �stringN)rf )r1 rQ rd r2 r2 r3 � ensure_string� s zCommand.ensure_stringc C sx t | |�}|du r dS t|t�r t| |t�d|�� dS t|t�r+tdd� |D ��}nd}|s:td|� d|�d���dS ) z�Ensure that 'option' is a list of strings. If 'option' is currently a string, we split it either on /,\s*/ or /\s+/, so "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become ["foo", "bar", "baz"]. Nz,\s*|\s+c s s � | ]}t |t�V qd S rX )r& rb )�.0�vr2 r2 r3 � <genexpr> s � z-Command.ensure_string_list.<locals>.<genexpr>Fr` z!' must be a list of strings (got �)) r7 r& rb ra �re�split�list�allr )r1 rQ re �okr2 r2 r3 �ensure_string_list� s ��zCommand.ensure_string_listc C s: | � |||�}|d ur||�std| ||f ��d S d S )Nzerror in '%s' option: )rf r )r1 rQ �testerrc � error_fmtrd re r2 r2 r3 �_ensure_tested_string s ��z Command._ensure_tested_stringc C s | � |tjjdd� dS )z5Ensure that 'option' is the name of an existing file.�filenamez$'%s' does not exist or is not a fileN)rv �os�path�isfile�r1 rQ r2 r2 r3 �ensure_filename s �zCommand.ensure_filenamec C s | � |tjjdd� d S )Nzdirectory namez)'%s' does not exist or is not a directory)rv rx ry �isdirr{ r2 r2 r3 �ensure_dirname s �zCommand.ensure_dirnamec C s t | d�r| jS | jjS )N� command_name)�hasattrr r( �__name__r= r2 r2 r3 rJ ( s zCommand.get_command_name�src_cmd� option_pairs�tuple[str, str]c G sF | j �|�}|�� |D ]\}}t| |�du r t| |t||�� q dS )a> Set the values of any "undefined" options from corresponding option values in some other command object. "Undefined" here means "is None", which is the convention used to indicate that an option has not been changed between 'initialize_options()' and 'finalize_options()'. Usually called from 'finalize_options()' for options that depend on some other command rather than another option of the same command. 'src_cmd' is the other command from which option values will be taken (a command object will be created for it if necessary); the remaining arguments are '(src_option,dst_option)' tuples which mean "take the value of 'src_option' in the 'src_cmd' command object, and copy it to 'dst_option' in the current command object". N)r* �get_command_objr> r7 ra )r1 r� r� � src_cmd_obj� src_option� dst_optionr2 r2 r3 �set_undefined_options. s ��z Command.set_undefined_optionsT�command�create�boolc C s | j �||�}|�� |S )z�Wrapper around Distribution's 'get_command_obj()' method: find (create if necessary and 'create' is true) the command object for 'command', call its 'ensure_finalized()' method, and return the finalized command object. )r* r� r> )r1 r� r� �cmd_objr2 r2 r3 �get_finalized_commandG s z Command.get_finalized_commandF�reinit_subcommandsc C � d S rX r2 �r1 r� r� r2 r2 r3 �reinitialize_commandS � z Command.reinitialize_commandr c C r� rX r2 r� r2 r2 r3 r� W r� � str | Commandc C s | j �||�S rX )r* r� r� r2 r2 r3 r� [ s c C s | j �|� dS )z�Run some other command: uses the 'run_command()' method of Distribution, which creates and finalizes the command object if necessary and then invokes its 'run()' method. N)r* � run_command)r1 r� r2 r2 r3 r� ` s zCommand.run_command� list[str]c C s2 g }| j D ]\}}|du s|| �r|�|� q|S )ak Determine the sub-commands that are relevant in the current distribution (ie., that need to be run). This is based on the 'sub_commands' class attribute: each tuple in that list may include a method that we call to determine if the subcommand needs to be run for the current distribution. Return a list of command names. N)r �append)r1 �commands�cmd_name�methodr2 r2 r3 �get_sub_commandsg s �zCommand.get_sub_commandsc C s t �d| �� |� d S )Nzwarning: %s: %s )r �warningrJ )r1 rU r2 r2 r3 �warnv � z Command.warnr �func� Callable[[Unpack[_Ts]], object]�args�tuple[Unpack[_Ts]]c C s t j|||| jd� d S �N�r5 )r �executer5 )r1 r� r� rU rF r2 r2 r3 r� y s zCommand.execute� �name�modec C s t j||| jd� d S r� )r �mkpathr5 )r1 r� r� r2 r2 r3 r� � r� zCommand.mkpath�infiler �outfiler � preserve_mode�preserve_times�link� tuple[_StrPathT | str, bool]c C r� rX r2 �r1 r� r� r� r� r� rF r2 r2 r3 � copy_file� � zCommand.copy_filer r � tuple[_BytesPathT | bytes, bool]c C r� rX r2 r� r2 r2 r3 r� � r� �3str | os.PathLike[str] | bytes | os.PathLike[bytes]�@tuple[str | os.PathLike[str] | bytes | os.PathLike[bytes], bool]c C s t j||||| j || jd�S )z�Copy a file respecting verbose, dry-run and force flags. (The former two default to whatever is in the Distribution object, and the latter defaults to false for commands that don't define it.)r� )r r� r. r5 r� r2 r2 r3 r� � s ��preserve_symlinksc C s t j|||||| j | jd�S )z\Copy an entire directory tree respecting verbose, dry-run, and force flags. r� )r � copy_treer. r5 )r1 r� r� r� r� r� rF r2 r2 r3 r� � s �zCommand.copy_tree�src�dst�_StrPathT | strc C r� rX r2 �r1 r� r� rF r2 r2 r3 � move_file� r� zCommand.move_file�_BytesPathT | bytesc C r� rX r2 r� r2 r2 r3 r� � r� c C s t j||| jd�S )z$Move a file respecting dry-run flag.r� )r r� r5 r� r2 r2 r3 r� � s �cmd�MutableSequence[str]� search_pathc C s ddl m} |||| jd� dS )z2Spawn an external command respecting dry-run flag.r )�spawnr� N)�distutils.spawnr� r5 )r1 r� r� rF r� r2 r2 r3 r� � s z Command.spawn� base_name�format�root_dir�:str | os.PathLike[str] | bytes | os.PathLike[bytes] | None�base_dir�owner�groupc C r� rX r2 �r1 r� r� r� r� r� r� r2 r2 r3 � make_archive� r� zCommand.make_archivec C r� rX r2 r� r2 r2 r3 r� � r� c C s t j||||| j||d�S )N)r5 r� r� )r r� r5 r� r2 r2 r3 r� � s ��infiles�!str | list[str] | tuple[str, ...]�exec_msg�skip_msgc C s� |du r d|� d�}t |t�r|f}n t |ttf�s td��|du r+d�|d�|��}| js4t� ||�r>| � ||||� dS t � |� dS )a� Special case of 'execute()' for operations that process one or more input files and generate one output file. Works just like 'execute()', except the operation is skipped and a different message printed if 'outfile' already exists and is newer than all files listed in 'infiles'. If the command defined 'self.force', and it is true, then the command is unconditionally run -- does no timestamp checks. Nz skipping z (inputs unchanged)z9'infiles' must be a string, or a list or tuple of stringszgenerating {} from {}z, ) r& rb rp �tupler' r� �joinr. r � newer_groupr� r �debug)r1 r� r� r� r� r� r� rF r2 r2 r3 � make_file s zCommand.make_file)r" r r# r$ )r# r$ )NrD )rU rV rF rW r# r$ )rU rV r# r$ rX )rQ rb rd rg r# r$ )rQ rb r# r$ )r# rb )r� rb r� r� r# r$ )T)r� rb r� r� r# r )F)r� rb r� r� r# r )r� r r� r� r# r )r� r� r# r )r� rb r# r$ )r# r� )Nr ) r� r� r� r� rU rV rF rW r# r$ )r� )r� rb r� rW r# r$ )TTNr )r� r r� r r� r� r� r� r� rg rF rW r# r� )r� r r� r r� r� r� r� r� rg rF rW r# r� )r� r� r� r� r� r� r� r� r� rg rF rW r# r� )TTFr )r� r r� rb r� r� r� r� r� r� rF rW r# r� )r )r� r r� r rF rW r# r� )r� r r� r rF rW r# r� )r� r� r� r� rF rW r# r� )Tr )r� r� r� r� rF rW r# r$ )NNNN)r� rb r� rb r� r� r� rg r� rg r� rg r# rb )NNN)r� r r� rb r� r� r� rg r� rg r� rg r# rb )r� r r� rb r� r� r� rg r� rg r� rg r# rb )NNr )r� r� r� r� r� r� r� r� r� rV r� rV rF rW r# r$ ))r� � __module__� __qualname__�__doc__r �__annotations__r! r4 r; r> r r+ r< rS rT rL rY rK r_ rf ri rs rv r| r~ rJ r� r� r r� r� r� r� r� r� r� r� r� r� r� r� r2 r2 r2 r3 r " s� � � 0 �� � � � � � ��� � �� � ��)&r� � __future__r rL rx rn r\ �abcr �collections.abcr r �typingr r r r r rD r r r r r �_logr �errorsr r% r �typing_extensionsr r r r r r r r2 r2 r2 r3 �<module> s( _distutils/__pycache__/dep_util.cpython-310.pyc 0000644 00000001075 15030122015 0015435 0 ustar 00 o �h] � @ s d dl Z ddlmZ dd� ZdS )� N� )� _modifiedc C s* | dvrt | ��tjdtdd� tt| �S )N)�newer� newer_group�newer_pairwisez>dep_util is Deprecated. Use functions from setuptools instead.� )� stacklevel)�AttributeError�warnings�warn�DeprecationWarning�getattrr )�name� r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/dep_util.py� __getattr__ s � r )r � r r r r r r �<module> s _distutils/__pycache__/sysconfig.cpython-310.pyc 0000644 00000036563 15030122015 0015646 0 ustar 00 o �hM � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m Z m Z m Z ddl mZ ddlmZ ddlmZ dd lmZ dd lmZ e rQdd lmZ nd d � Zdejv Zej� ej �Z ej� ej �Z ej� ej!�Z"ej� ej#�Z$dej%v r�ej�&ej%d �Z'nej(r�ej�)ej�&ej(��Z'ne�*� Z'dd� Z+e,edd�Z-dd� Z.ej/dkr�edd� �Z0e0e'�Z'e0e-�Z-dd� Z1e1� Z2dZ3ze2s�ej4Z3W n e5y� Y nw dd � Z6d`dad$d%�Z7ed&d'� �Z8d(d)� Z9d*d+� Z:d,d-� Z;d.d/� Z<d0d1� Z=d2d3� Z> dbdcd5d6�Z?ej@d7d8� �ZAddd<d=�ZBded>d?�ZCded@dA�ZDdfdBdC�ZEe�FdD�ZGe�FdE�ZHe�FdF�ZIdfdGdH�ZJdIdJ� ZKdaLe dgdLdM��ZMe dhdQdM��ZMdidSdM�ZMe edT�djdXdY���ZNe dkdZdY��ZNdkd[dY�ZNedld^d_��ZOdS )ma� Provide access to Python's configuration information. The specific configuration variables available depend heavily on the platform and configuration. The values may be retrieved using get_config_var(name), and the list of variables is available via get_config_vars().keys(). Additional convenience functions are also available. Written by: Fred L. Drake, Jr. Email: <fdrake@acm.org> � )� annotationsN)� TYPE_CHECKING�Literal�overload)� pass_none� )� CCompiler)�py39)�DistutilsPlatformError)�is_mingw)� deprecatedc C s dd� S )Nc S s | S �N� )�fnr r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/sysconfig.py�<lambda>" s z deprecated.<locals>.<lambda>r )�messager r r r ! s r �__pypy__�_PYTHON_PROJECT_BASEc s& t �| ��d�� t� fdd�dD ��S )z] Return True if the target directory appears to point to an un-installed Python. �Modulesc 3 s � | ] }� � |��� V qd S r )�joinpath�is_file)�.0r ��modulesr r � <genexpr>A s � z(_is_python_source_dir.<locals>.<genexpr>)�Setupz Setup.local)�pathlib�Pathr �any��dr r r �_is_python_source_dir; s r" �_homec C s t j�| ��t j�|��S )z, Return True if a is a parent of b. )�os�path�normcase� startswith)�dir_a�dir_br r r � _is_parentG s r* �ntc s$ t tf}� fdd�|D �}t|� �S )Nc 3 s( � | ]}t � tj�|d ��r|V qdS )�PCbuildN)r* r$ r% �join)r �prefixr r r r T s � � �z _fix_pcbuild.<locals>.<genexpr>)�PREFIX� BASE_PREFIX�next)r! �prefixes�matchedr r r � _fix_pcbuildP s � r4 c C s t rtt �S tt�S r )� _sys_homer" � project_baser r r r � _python_build_ s r7 � c C s t jj� dt jj� �S )z�Return a string containing the major and minor Python version, leaving off the patchlevel. Sample return values could be '1.5' or '2.2'. �.)�sys� version_info�major�minorr r r r �get_python_versionu s r> F� plat_specific�boolr. � str | None�return�strc C sn | rt nt}|dur |n|}t� rdntj}z t� d|� � }W n ty0 tdtj� d���w |||| �S )a� Return the directory containing installed Python header files. If 'plat_specific' is false (the default), this is the path to the non-platform-specific header files, i.e. Python.h and so on; otherwise, this is the path to platform-specific header files (namely pyconfig.h). If 'prefix' is supplied, use it instead of sys.base_prefix or sys.base_exec_prefix -- i.e., ignore 'plat_specific'. N�posix�_get_python_inc_zCI don't know where Python installs its C header files on platform '�')�BASE_EXEC_PREFIXr0 r r$ �name�globals�KeyErrorr )r? r. �default_prefix�resolved_prefix�os_name�getterr r r �get_python_inc} s ��� rO c C s t j�| �r| S dS )z5 Replace path with None if it doesn't exist. N)r$ r% �exists)r% r r r �_extant� s rQ c C s t |�ptt||��pt| �S r )� _get_python_inc_posix_pythonrQ �_get_python_inc_from_config� _get_python_inc_posix_prefix�r. � spec_prefixr? r r r �_get_python_inc_posix� s ��rW c C s2 t sdS | r tp tS tj�td�d�}tj�|�S )z� Assume the executable is in the build directory. The pyconfig.h file should be in the same directory. Since the build directory may not be the source directory, use "srcdir" from the makefile to find the "Include" directory. N�srcdir�Include)� python_buildr5 r6 r$ r% r- �get_config_var�normpath)r? �incdirr r r rR � s rR c C s |du r t d| d �S dS )aj If no prefix was explicitly specified, provide the include directory from the config vars. Useful when cross-compiling, since the config vars may come from the host platform Python installation, while the current Python executable is from the build platform installation. >>> monkeypatch = getfixture('monkeypatch') >>> gpifc = _get_python_inc_from_config >>> monkeypatch.setitem(gpifc.__globals__, 'get_config_var', str.lower) >>> gpifc(False, '/usr/bin/') >>> gpifc(False, '') >>> gpifc(False, None) 'includepy' >>> gpifc(True, None) 'confincludepy' N�CONF� INCLUDEPY)r[ )r? rV r r r rS � s �rS c C s* t rdnd}|t� t }tj�| d|�S )N�pypy�python�include)�IS_PYPYr> � build_flagsr$ r% r- )r. �implementation� python_dirr r r rT � s rT c C s8 t rtj�| d�tjj tj�t�� � S tj�| d�S )Nrb )rZ r$ r% r- �pathsep�dirname� sysconfig�get_config_h_filenamerU r r r �_get_python_inc_nt� s ���rk c C s | r|S t j�|d�S )N� site-packages)r$ r% r- )� standard_lib� libpython� early_prefixr. r r r � _posix_lib� s rp rm c C s� |}|du r|r| r t p t}n| rtpt}tjdks t� rB| s!|r(ttdd�}nd}t r.dnd}tj � |||t � �}t ||||�S tjdkrX|rPtj � |d�S tj � |dd �S td tj� d ���) aS Return the directory containing the Python library (standard or site additions). If 'plat_specific' is true, return the directory containing platform-specific modules, i.e. any module from a non-pure-Python module distribution; otherwise, return the platform-shared library directory. If 'standard_lib' is true, return the directory containing standard Python library modules; otherwise, return the directory for site-specific modules. If 'prefix' is supplied, use it instead of sys.base_prefix or sys.base_exec_prefix -- i.e., ignore 'plat_specific'. NrD � platlibdir�libr` ra r+ �Librl z<I don't know where Python installs its library on platform 'rF )rG r0 � EXEC_PREFIXr/ r$ rH r �getattrr: rc r% r- r> rp r )r? rm r. ro �libdirre rn r r r �get_python_lib� s& �rw c C s$ t jdkotd��t� � dS dS )a� Perform first-time customization of compiler-related config vars on macOS. Use after a compiler is known to be needed. This customization exists primarily to support Pythons from binary installers. The kind and paths to build tools on the user system may vary significantly from the system that Python itself was built on. Also the user OS version and build tools may not support the same set of CPU architectures for universal builds. �darwin� _osx_supportN)r: �platform� __import__�customize_compiler�get_config_varsr r r r �_customize_macos s �r~ �compilerr �Nonec C s� | j dv s | j dkr�t� r�t� tddddddd d d � \ }}}}}}}}} |} dtjv rGtjd } dtjvrE|�|�rE| |t|�d � }| }tj�d|�}tj�d|�}tj�d|�}tj�d |d �} t |d�}t |d�}tj�d|�}t |d�}tj�d| �} t |d�}t | d �} t |d �}t | d �} t |d �}t |d �}tj�d |�}|d tj�d | � } |d | }|d | }| j | ||d | ||d | ||||| d� dtjv r�| j �dd �r�| j tjd d� || _ d S d S d S )z�Do any platform-specific customization of a CCompiler instance. Mainly needed on Unix, so we can plug in the information that varies across Unices and is stored in Python's Makefile. )�unix�cygwin�mingw32�CC�CXX�CFLAGS�CCSHARED�LDSHARED� LDCXXSHARED� SHLIB_SUFFIX�AR�ARFLAGSN�CPPz -E�LD�C�CXXFLAGS� ) � preprocessorr � compiler_so� compiler_cxx�compiler_so_cxx� linker_so� linker_so_cxx� linker_exe�linker_exe_cxx�archiver�RANLIB�ranlib)r� ) � compiler_typer r~ r} r$ �environr' �len�get� _add_flags�set_executables� executables�shared_lib_extension)r �cc�cxx�cflags�ccshared�ldshared� ldcxxshared� shlib_suffix�ar�ar_flags�cxxflags�newcc�cppr� �cc_cmd�cxx_cmdr r r r| ' s� �� � � �r| c C � t �� S )z2Return full pathname of installed pyconfig.h file.)ri rj r r r r rj ~ � rj c C r� )zAReturn full pathname of installed Makefile from the Python build.)ri �get_makefile_filenamer r r r r� � r� r� c C s t j| |d�S )z�Parse a config.h-style file. A dictionary containing name/value pairs is returned. If an optional dictionary is passed in as the second argument, it is used instead of a new dictionary. )�vars)ri �parse_config_h)�fp�gr r r r� � s r� z"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)z \$\(([A-Za-z][A-Za-z0-9_]*)\)z\${([A-Za-z][A-Za-z0-9_]*)}c C s� ddl m} || ddddd�}|du ri }i }i } |�� }|du r#n?t�|�}|ra|�dd�\}} | �� } | �d d �} d | v rE| ||< n zt| �} W n t y\ | �d d �||< Y nw | ||< qd } |�r1t |�D ]�} || } t � | �pzt � | �}|�r+|�d�}d}||v r�t|| �}n>||v r�d }n7|tjv r�tj| }n,|| v r�| �d�r�| dd� | v r�d }nd| |v r�d }nt|d| �}nd ||< }|�r*| |�� d� }| d|�� � | | } d |v r�| || < qkzt| �} W n t �y | �� || < Y nw | || < || = | �d��r*| dd� | v �r*| dd� } | |v�r*| || < qk|| = qk|sg|�� |�� D ]\}} t| t��rI| �� ||< �q9|�|� |S )z�Parse a Makefile-style file. A dictionary containing name/value pairs is returned. If an optional dictionary is passed in as the second argument, it is used instead of a new dictionary. r )�TextFileT�surrogateescape)�strip_comments� skip_blanks� join_lines�errorsNr � z$$r8 �$)r� �LDFLAGS�CPPFLAGSF�PY_� )�distutils.text_filer� �readline� _variable_rx�match�group�strip�replace�int� ValueError�list� _findvar1_rx�search� _findvar2_rxrC r$ r� r' �end�start�close�items� isinstance�update)r r� r� r� �done�notdone�line�m�n�v�tmpv�renamed_variablesrH �value�found�item�after�kr r r �parse_makefile� s� � �� � ��1 � r� c C sX t �| �p t�| �}|r(|�� \}}| d|� |�|�d�� | |d� } n | S q)a� Expand Makefile-style variables -- "${foo}" or "$(foo)" -- in 'string' according to 'vars' (a dictionary mapping variable names to values). Variables not present in 'vars' are silently expanded to the empty string. The variable values in 'vars' should not contain further variable expansions; if 'vars' is the output of 'parse_makefile()', you're fine. Returns a variable-expanded version of 's'. Tr r N)r� r� r� �spanr� r� )�sr� r� �begr� r r r �expand_makefile_vars s *�r� �dict[str, str | int]c C � d S r r r r r r r} % � r} �arg�args�list[str | int]c G r� r r )r� r� r r r r} ' r� �&list[str | int] | dict[str, str | int]c G s4 t du rt�� �� a t�t � | rdd� | D �S t S )a� 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 extensions. On Unix, this means every variable defined in Python's installed Makefile; on Windows it's a much smaller set. With arguments, return a list of values that result from looking up each argument in the configuration variable dictionary. Nc S s g | ]}t �|��qS r )� _config_varsr� )r rH r r r � <listcomp>8 s z#get_config_vars.<locals>.<listcomp>)r� ri r} �copyr �add_ext_suffix)r� r r r r} ) s zrSO is deprecated, use EXT_SUFFIX. Support will be removed when this module is synchronized with stdlib Python 3.11rH � Literal['SO']�int | str | Nonec C r� r r �rH r r r r[ ; s r[ c C r� r r r� r r r r[ @ r� c C s* | dkrddl }|�dtd� t� �| �S )z�Return the value of a single variable using the dictionary returned by 'get_config_vars()'. Equivalent to get_config_vars().get(name) �SOr Nz SO is deprecated, use EXT_SUFFIXr� )�warnings�warn�DeprecationWarningr} r� )rH r� r r r r[ B s r� �typec C s( t j�|� d��}|r| � d|� �S | S )z� Add any flags from the environment for the given type. type is the prefix to FLAGS in the environment key (e.g. "C" for "CFLAGS"). �FLAGSr� )r$ r� r� )r� r� �flagsr r r r� N s r� )FN)r? r@ r. rA rB rC )FFN)r? r@ rm r@ r. rA rB rC )r r rB r� )rB rC r )rB r� )r� rC r� rC rB r� )r� rC rB r� )rH r� rB r� )rH rC rB r� )r� rC r� rC rB rC )P�__doc__� __future__r � functoolsr$ r �rer: ri �typingr r r �jaraco.functoolsr � ccompilerr �compatr r� r �utilr �typing_extensionsr �builtin_module_namesrc r% r\ r. r/ � exec_prefixrt � base_prefixr0 �base_exec_prefixrG r� �abspathr6 � executablerh �getcwdr" ru r5 r* rH r4 r7 rZ rd �abiflags�AttributeErrorr> rO rQ rW rR rS rT rk rp rw � lru_cacher~ r| rj r� r� �compiler� r� r� r� r� r� r} r[ r� r r r r �<module> s� � � �/ W p � _distutils/__pycache__/errors.cpython-310.pyc 0000644 00000007606 15030122015 0015152 0 ustar 00 o �h � @ s( d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ eZ e Z G dd � d e �Z G d d � d e �ZG d d � d e �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG d d � d e �ZG d d � d e �ZG d d!� d!e �Zd"S )#z� Exceptions used by the Distutils modules. Distutils modules may raise these or standard exceptions, including :exc:`SystemExit`. � )� CompileError)�Error)�LibError)� LinkError)�PreprocessError)�UnknownFileTypec @ � e Zd ZdZdS )�DistutilsErrorz The root of all Distutils evil.N��__name__� __module__� __qualname__�__doc__� r r �O/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/errors.pyr � r c @ r )�DistutilsModuleErrorz�Unable to load an expected module, or to find an expected class within some module (in particular, command modules and classes).Nr r r r r r � r c @ r )�DistutilsClassErrorz�Some command class (or possibly distribution class, if anyone feels a need to subclass Distribution) is found not to be holding up its end of the bargain, ie. implementing some part of the "command "interface.Nr r r r r r ! s r c @ r )�DistutilsGetoptErrorz7The option table provided to 'fancy_getopt()' is bogus.Nr r r r r r * r r c @ r )�DistutilsArgErrorzaRaised by fancy_getopt in response to getopt.error -- ie. an error in the command line usage.Nr r r r r r 0 r r c @ r )�DistutilsFileErrorz�Any problems in the filesystem: expected file not found, etc. Typically this is for problems that we detect before OSError could be raised.Nr r r r r r 7 � r c @ r )�DistutilsOptionErrora� Syntactic/semantic errors in command options, such as use of mutually conflicting options, or inconsistent options, badly-spelled values, etc. No distinction is made between option values originating in the setup script, the command line, config files, or what-have-you -- but if we *know* something originated in the setup script, we'll raise DistutilsSetupError instead.Nr r r r r r ? s r c @ r )�DistutilsSetupErrorzqFor errors that can be definitely blamed on the setup script, such as invalid keyword arguments to 'setup()'.Nr r r r r r J r r c @ r )�DistutilsPlatformErrorz�We don't know how to do something on the current platform (but we do know how to do it on some platform) -- eg. trying to compile C files on a platform not supported by a CCompiler subclass.Nr r r r r r Q r r c @ r )�DistutilsExecErrorz`Any problems executing an external program (such as the C compiler, when compiling C files).Nr r r r r r Y r r c @ r )�DistutilsInternalErrorzoInternal inconsistencies or impossibilities (obviously, this should never be seen if the code is working!).Nr r r r r r ` r r c @ r )�DistutilsTemplateErrorz%Syntax error in a file list template.Nr r r r r r g � r c @ r )�DistutilsByteCompileErrorzByte compile error.Nr r r r r r k r r N)r �compilers.C.errorsr r �_Errorr r r r �_UnknownFileType�CCompilerError�UnknownFileError� Exceptionr r r r r r r r r r r r r r r r r �<module> s, _distutils/__pycache__/zosccompiler.cpython-310.pyc 0000644 00000000371 15030122015 0016337 0 ustar 00 o �h: � @ s d dl mZ ejZdS )� )�zosN)� compilers.Cr �Compiler� zOSCCompiler� r r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/zosccompiler.py�<module> s _distutils/__pycache__/filelist.cpython-310.pyc 0000644 00000027627 15030122015 0015456 0 ustar 00 o �h�; � @ s� d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m Z m Z ddl m Z ddlmZmZ dd lmZ G d d � d �Zd d � ZG dd� de�Zejfddd�Zdd� Zddd�ZdS ) zsdistutils.filelist Provides the FileList class, used for poking about the filesystem and building lists of files. � )� annotationsN)�Iterable)�Literal�overload� )�log)�DistutilsInternalError�DistutilsTemplateError�� convert_pathc @ s e Zd ZdZd;d<dd �Zd=d d �Zejfd>dd�Zd?dd�Z d@dd�Z dAdd�Z dBd d �Z dBd d �Z d d!� ZdCd#d$�Ze % &dDdEd.d/��Ze % dFdGd2d/��ZedGd3d/��Z % &dDdHd5d/�Ze % &dDdEd6d7��Ze % dFdGd8d7��ZedGd9d7��Z % &dDdHd:d7�ZdS )I�FileLista� A list of files built by on exploring the filesystem and filtered by applying various patterns to what we find there. Instance attributes: dir directory from which files will be taken -- only used if 'allfiles' not supplied to constructor files list of filenames currently being built/filtered/manipulated allfiles complete list of files under consideration (ie. without any filtering applied) N�warn�object� debug_print�return�Nonec C s d | _ g | _d S �N)�allfiles�files)�selfr r � r �Q/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/filelist.py�__init__$ s zFileList.__init__r � Iterable[str]c C s || _ d S r )r )r r r r r � set_allfiles* s zFileList.set_allfiles�dir�str | os.PathLike[str]c C s t |�| _d S r )�findallr )r r r r r r - s zFileList.findall�msgc C s ddl m} |rt|� dS dS )z~Print 'msg' to stdout if the global DEBUG (taken from the DISTUTILS_DEBUG environment variable) flag is true. r )�DEBUGN)�distutils.debugr �print)r r r r r r r 0 s �zFileList.debug_print�item�strc C � | j �|� d S r )r �append)r r" r r r r% ; � zFileList.append�itemsc C r$ r )r �extend)r r' r r r r( > r& zFileList.extendc C s< t ttjj| j��}g | _|D ] }| j�tjj|� � qd S r )�sorted�map�os�path�splitr r% �join)r �sortable_files� sort_tupler r r �sortA s �z FileList.sortc C s@ t t| j�d dd�D ]}| j| | j|d kr | j|= q d S )Nr r ���)�range�lenr )r �ir r r �remove_duplicatesJ s ��zFileList.remove_duplicatesc C s� |� � }|d }d } }}|dv r,t|�dk r td|� d���dd� |dd � D �}nE|d v rPt|�d k r>td|� d ���t|d �}d d� |dd � D �}n!|d v rit|�dkrbtd|� d���t|d �}ntd|� d���||||fS )Nr )�include�exclude�global-include�global-exclude� �'z#' expects <pattern1> <pattern2> ...c S � g | ]}t |��qS r r ��.0�wr r r � <listcomp>] � z1FileList._parse_template_line.<locals>.<listcomp>r )�recursive-include�recursive-exclude� z)' expects <dir> <pattern1> <pattern2> ...c S r= r r r> r r r rA d rB )�graft�prunez ' expects a single <dir_pattern>zunknown action ')r- r4 r r )r �line�words�action�patternsr � dir_patternr r r �_parse_template_lineR s0 � � � z FileList._parse_template_linerH c C s> | � |�\}}}}|dkr+| �dd�|� � |D ]}| j|dd�s(t�d|� qd S |dkrM| �dd�|� � |D ]}| j|dd�sJt�d |� q;d S |d kro| �d d�|� � |D ]}| j|d d�slt�d |� q]d S |dkr�| �dd�|� � |D ]}| j|d d�s�t�d|� qd S |dkr�| �d�|d�|��� |D ]}| j||d�s�d}t�|||� q�d S |dkr�| �d�|d�|��� |D ]}| j||d�s�t�d||� q�d S |dkr�| �d| � | jd |d�s�t�d|� d S d S |dk�r| �d | � | jd |d��st�d |� d S d S td |� d ���) Nr7 zinclude � T)�anchorz%warning: no files found matching '%s'r8 zexclude z9warning: no previously-included files found matching '%s'r9 zglobal-include Fz>warning: no files found matching '%s' anywhere in distributionr: zglobal-exclude zRwarning: no previously-included files matching '%s' found anywhere in distributionrC zrecursive-include {} {})�prefixz:warning: no files found matching '%s' under directory '%s'rD zrecursive-exclude {} {}zNwarning: no previously-included files matching '%s' found under directory '%s'rF zgraft z+warning: no directories found matching '%s'rG zprune z6no previously-included directories found matching '%s'z$this cannot happen: invalid action 'r< ) rM r r. �include_patternr �warning�exclude_pattern�formatr )r rH rJ rK r rL �patternr r r r �process_template_linep s� �������� ��� ����� � �� �z FileList.process_template_lineTFrU rO �boolrP � str | None�is_regex�Literal[False]c C � d S r r �r rU rO rP rY r r r rQ � � zFileList.include_pattern�str | re.Pattern[str]� Literal[True]c C r[ r r r\ r r r rQ � � c C r[ r r r\ r r r rQ � r] �str | re.Patternc C sp d}t ||||�}| �d|j� d�� | jdu r | �� | jD ]}|�|�r5| �d| � | j�|� d}q |S )a� 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: '*' and '?' match non-special characters, where "special" is platform- dependent: slash on Unix; colon, slash, and backslash on DOS/Windows; and colon on Mac OS. If 'anchor' is true (the default), then the pattern match is more stringent: "*.py" will match "foo.py" but not "foo/bar.py". If 'anchor' is false, both of these will match. If 'prefix' is supplied, then only filenames starting with 'prefix' (itself a pattern) and ending with 'pattern', with anything in between them, will match. 'anchor' is ignored in this case. If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and 'pattern' is assumed to be either a string containing a regex or a regex object -- no translation is done, the regex is just compiled and used as-is. Selected strings will be added to self.files. Return True if files are found, False otherwise. Fz"include_pattern: applying regex r'r< Nz adding T)�translate_patternr rU r r �searchr r% )r rU rO rP rY � files_found� pattern_re�namer r r rQ � s �c C r[ r r r\ r r r rS r] zFileList.exclude_patternc C r[ r r r\ r r r rS r` c C r[ r r r\ r r r rS ! r] c C sv d}t ||||�}| �d|j� d�� tt| j�d dd�D ]}|�| j| �r8| �d| j| � | j|= d}q |S )a Remove strings (presumably filenames) from 'files' that match 'pattern'. Other parameters are the same as for 'include_pattern()', above. The list 'self.files' is modified in place. Return True if files are found, False otherwise. Fz"exclude_pattern: applying regex r'r< r r2 z removing T)rb r rU r3 r4 r rc )r rU rO rP rY rd re r5 r r r rS ) s �)NN)r r r r r r )r r r r )r r r r )r r r r )r" r# r r )r' r r r )r r )rH r# r r �TNF) rU r# rO rW rP rX rY rZ r rW )TN) rU r^ rO rW rP rX rY r_ r rW ) rU ra rO rW rP rX rY rW r rW )�__name__� __module__� __qualname__�__doc__r r r+ �curdirr r r% r( r1 r6 rM rV r rQ rS r r r r r sT X�� �/�� �r c C s0 t �tj| dd��}dd� |D �}ttjj|�S )z% Find all files under 'path' T)� followlinksc s s. � | ]\}}}|D ] }t j�||�V q qd S r )r+ r, r. )r? �base�dirsr �filer r r � <genexpr>I s � � �z#_find_all_simple.<locals>.<genexpr>)� _UniqueDirs�filterr+ �walkr, �isfile)r, � all_unique�resultsr r r �_find_all_simpleD s �rx c @ s$ e Zd ZdZdd� Zedd� �ZdS )rr z� Exclude previously-seen dirs from walk results, avoiding infinite recursion. Ref https://bugs.python.org/issue44497. c C sF |\}}}t �|�}|j|jf}|| v }|r|dd�= | �|� | S )z� Given an item from an os.walk result, determine if the item represents a unique dir for this instance and if not, prevent further traversal. N)r+ �stat�st_dev�st_ino�add)r � walk_itemrn ro r ry � candidate�foundr r r �__call__V s z_UniqueDirs.__call__c C s t | � |�S r )rs )�clsr' r r r rs e s z_UniqueDirs.filterN)rh ri rj rk r� � classmethodrs r r r r rr O s rr r r c C s6 t | �}| tjkrtjtjj| d�}t||�}t|�S )z� Find all files under 'dir' and return the list of full filenames. Unless dir is '.', return full filenames with dir prepended. )�start) rx r+ rl � functools�partialr, �relpathr* �list)r r �make_relr r r r j s r c C s< t �| �}tj}tjdkrd}d|� d�}t�d||�}|S )z�Translate a shell-like glob pattern to a regular expression; return a string containing the regex. Differs from 'fnmatch.translate()' in that '*' does not match "special characters" (which are platform-specific). �\z\\\\z\1[^�]z((?<!\\)(\\\\)*)\.)�fnmatch� translater+ �sep�re�sub)rU re r� �escapedr r r � glob_to_rev s r� TFc C s |rt | t�r t�| �S | S td��d�\}}}| r+t| �}|�|�r(|�|�s*J �nd}|durvt|�}|�|�r?|�|�sAJ �|t|�t|�t|� � }t j } t j dkrYd} |t|�t|�t|� � }|� d|� | � d|� |� �}n|r�|� d|t|�d� � �}t�|�S )a Translate a shell-like wildcard pattern to a compiled regular expression. Return the compiled regex. If 'is_regex' true, then 'pattern' is directly compiled to a regex (if it's a string) or just returned as-is (assumes it's a regex object). �_� Nr� z\\z\Az.*) � isinstancer# r� �compiler� � partition� startswith�endswithr4 r+ r� ) rU rO rP rY r� r� �endre � prefix_rer� r r r rb � s* rb )r r rg )rk � __future__r r� r� r+ r� �collections.abcr �typingr r �_logr �errorsr r �utilr r rx �setrr rl r r� rb r r r r �<module> s& 1 _distutils/__pycache__/versionpredicate.cpython-310.pyc 0000644 00000012246 15030122015 0017200 0 ustar 00 o �hU � @ s� d Z ddlZddlZddlmZ e�dej�Ze�d�Ze�d�Z dd � Z ej ej ej ejejejd �ZG d d � d �Zdad d� ZdS )zAModule for parsing and testing package version predicate strings.� N� )�versionz'(?i)^\s*([a-z_]\w*(?:\.[a-z_]\w*)*)(.*)z^\s*\((.*)\)\s*$z%^\s*(<=|>=|<|>|!=|==)\s*([^\s,]+)\s*$c C sh t �| �}|std| ����|�� \}}t�� � t�|�}W d � ||fS 1 s+w Y ||fS )zVParse a single version comparison. Return (comparison string, StrictVersion) z bad package restriction syntax: N)�re_splitComparison�match� ValueError�groupsr �suppress_known_deprecation� StrictVersion)�pred�res�comp�verStr�other� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/versionpredicate.py�splitUp s ��r )�<z<=z==�>z>=z!=c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �VersionPredicatea� Parse and test package version predicates. >>> v = VersionPredicate('pyepat.abc (>1.0, <3333.3a1, !=1555.1b3)') The `name` attribute provides the full dotted name that is given:: >>> v.name 'pyepat.abc' The str() of a `VersionPredicate` provides a normalized human-readable version of the expression:: >>> print(v) pyepat.abc (> 1.0, < 3333.3a1, != 1555.1b3) The `satisfied_by()` method can be used to determine with a given version number is included in the set described by the version restrictions:: >>> v.satisfied_by('1.1') True >>> v.satisfied_by('1.4') True >>> v.satisfied_by('1.0') False >>> v.satisfied_by('4444.4') False >>> v.satisfied_by('1555.1b3') False `VersionPredicate` is flexible in accepting extra whitespace:: >>> v = VersionPredicate(' pat( == 0.1 ) ') >>> v.name 'pat' >>> v.satisfied_by('0.1') True >>> v.satisfied_by('0.2') False If any version numbers passed in do not conform to the restrictions of `StrictVersion`, a `ValueError` is raised:: >>> v = VersionPredicate('p1.p2.p3.p4(>=1.0, <=1.3a1, !=1.2zb3)') Traceback (most recent call last): ... ValueError: invalid version number '1.2zb3' It the module or package name given does not conform to what's allowed as a legal module or package name, `ValueError` is raised:: >>> v = VersionPredicate('foo-bar') Traceback (most recent call last): ... ValueError: expected parenthesized list: '-bar' >>> v = VersionPredicate('foo bar (12.21)') Traceback (most recent call last): ... ValueError: expected parenthesized list: 'bar (12.21)' c C s� |� � }|s td��t�|�}|std|����|�� \| _}|� � }|rPt�|�}|s3td|����|�� d }dd� |�d�D �| _| jsNtd|����d S g | _d S ) z!Parse a version predicate string.zempty package restrictionzbad package name in z expected parenthesized list: r c S s g | ]}t |��qS r )r )�.0�aPredr r r � <listcomp>| s z-VersionPredicate.__init__.<locals>.<listcomp>�,z empty parenthesized list in N) �stripr �re_validPackager r �name�re_paren�splitr )�self�versionPredicateStrr �paren�strr r r �__init__i s$ � zVersionPredicate.__init__c C s4 | j rdd� | j D �}| jd d�|� d S | jS )Nc S s g | ] \}}|d t |� �qS )� )r! )r �cond�verr r r r � s z,VersionPredicate.__str__.<locals>.<listcomp>z (z, �))r r �join)r �seqr r r �__str__� s zVersionPredicate.__str__c C s( | j D ]\}}t| ||�s dS qdS )z�True if version is compatible with all the predicates in self. The parameter version must be acceptable to the StrictVersion constructor. It may be either a string or StrictVersion. FT)r �compmap)r r r$ r% r r r � satisfied_by� s �z VersionPredicate.satisfied_byN)�__name__� __module__� __qualname__�__doc__r" r) r+ r r r r r ( s @ r c C s� t du r t�dtj�a | �� } t �| �}|s td| ����|�d�p#d}|r?t� � � t� |�}W d � n1 s:w Y |�d�|fS )a9 Return the name and optional version number of a provision. The version number, if given, will be returned as a `StrictVersion` instance, otherwise it will be `None`. >>> split_provision('mypkg') ('mypkg', None) >>> split_provision(' mypkg( 1.2 ) ') ('mypkg', StrictVersion ('1.2')) Nz=([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*)(?:\s*\(\s*([^)\s]+)\s*\))?$z illegal provides specification: � r ) � _provision_rx�re�compile�ASCIIr r r �groupr r r )�value�mr% r r r �split_provision� s � �r8 )r/ �operatorr2 � r r3 r4 r r r r �lt�le�eq�gt�ge�ner* r r1 r8 r r r r �<module> s$ � l _distutils/__pycache__/_log.cpython-310.pyc 0000644 00000000327 15030122015 0014547 0 ustar 00 o �h* � @ s d dl Z e �� ZdS )� N)�logging� getLogger�log� r r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/_log.py�<module> s _distutils/__pycache__/dist.cpython-310.pyc 0000644 00000114006 15030122015 0014572 0 ustar 00 o �h�� � @ s� U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z ddl mZ ddlmZmZmZmZmZmZmZmZ ddlmZmZ dd lm Z dd l m Z dd l m Z m!Z!m"Z"m#Z# dd l$m%Z%m&Z& dd l'm(Z(m)Z)m*Z* er�ddl+m,Z, ddl-m.Z. ddl/m0Z0 eddd�Z1e2ee3e4ee4df e4e5f e3e4ee4df e4f f Z6de7d< e�8d�Z9d#dd �Z:G d d � d �Z;G d d � d �Z<d!d"� Z=dS )$z}distutils.dist Provides the Distribution class, which represents the module distribution being built/installed/distributed. � )� annotationsN)�Iterable�MutableMapping)�message_from_file)�IO� TYPE_CHECKING�Any�ClassVar�Literal�TypeVar�Union�overload)�canonicalize_name�canonicalize_version� ��log)�DEBUG)�DistutilsArgError�DistutilsClassError�DistutilsModuleError�DistutilsOptionError)� FancyGetopt�translate_longopt)� check_environ� rfc822_escape� strtobool)� SupportsWrite)� TypeAlias��Command� _CommandTr )�boundr � _OptionsListz^[a-zA-Z]([a-zA-Z0-9_]*)$�value�str | Iterable[str]�return�str | list[str]c C sP t | t�r | S t | t�s&t| �j}d}|jdi t� ��}t�|� t| �} | S )Nz>Warning: '{fieldname}' should be a list, got type '{typename}'� ) � isinstance�str�list�type�__name__�format�localsr �warning)r$ � fieldname�typename�msgr( r( �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/dist.py� _ensure_list> s � r5 c @ s� e Zd ZU dZg d�Zded< dZded< g d�Zded < d d � eD �Zd ed < ddiZ ded< d�d�dd�Z dd� Z d�d�d d �Z d d!� Z d"d#� Zd�d$d%�Zd&d'� Zd(d)� Zd*d+� Zd�d,d-�Z /d�d�d2d3�Zd4d5� Zd�d6d7�Zd�d8d9�Zd:d;� Zd<d=� Zd�d@dA�Ze .d�d�dEdF��Z ed�dIdF��Z d�d�dKdF�Z d�dLdM�Z e Nd�d�dPdQ��Z e Nd�d�dSdQ��Z Nd�d�dUdQ�Z e j fd�dXdY�Z!d�dZd[�Z"d�d\d]�Z#d�d^d_�Z$d�d`da�Z%d�dbdc�Z&d�ddde�Z'd�dfdg�Z(d�dhdi�Z)d�djdk�Z*d�dldm�Z+e,�rLd�dndo�Z-dJedp< dqedr< dqeds< dqedt< dqedu< dqedv< dqedw< dqedx< dqedy< dqedz< dqed{< dqed|< dqed}< dqed~< dqed< d�ed�< d�ed�< d�ed�< d�ed�< d�ed�< d�ed�< dS dS )�� Distributiona� The core of the Distutils. Most of the work hiding behind 'setup' is really done within a Distribution instance, which farms the work out to the Distutils commands specified on the command line. Setup scripts will almost never instantiate Distribution directly, unless the 'setup()' function is totally inadequate to their needs. However, it is conceivable that a setup script might wish to subclass Distribution for some specialized purpose, and then pass the subclass to 'setup()' as the 'distclass' keyword argument. If so, it is necessary to respect the expectations that 'setup' has of Distribution. See the code for 'setup()', in core.py, for details. ))�verbose�vzrun verbosely (default)r )�quiet�qz!run quietly (turns verbosity off))zdry-run�nzdon't actually do anything)�help�hzshow detailed help message)z no-user-cfgNz-ignore pydistutils.cfg in your home directoryzClassVar[_OptionsList]�global_optionsz�Common commands: (see '--help-commands' for more) setup.py build will build the package underneath 'build/' setup.py install will install the package z ClassVar[str]� common_usage))z help-commandsNzlist all available commands)�nameNzprint package name)�version�Vzprint package version)�fullnameNz print <package name>-<version>)�authorNzprint the author's name)� author-emailNz print the author's email address)� maintainerNzprint the maintainer's name)zmaintainer-emailNz$print the maintainer's email address)�contactNz7print the maintainer's name if known, else the author's)z contact-emailNz@print the maintainer's email address if known, else the author's)�urlNz print the URL for this package)�licenseNz print the license of the package)�licenceNzalias for --license)� descriptionNz print the package description)zlong-descriptionNz"print the long package description)� platformsNzprint the list of platforms)� classifiersNz print the list of classifiers)�keywordsNzprint the list of keywords)�providesNz+print the list of packages/modules provided)�requiresNz+print the list of packages/modules required)� obsoletesNz0print the list of packages/modules made obsolete�display_optionsc C s g | ]}t |d ��qS )r �r )�.0�xr( r( r4 � <listcomp>� s �zDistribution.<listcomp>zClassVar[list[str]]�display_option_namesr9 r7 zClassVar[dict[str, str]]� negative_optN�attrs� MutableMapping[str, Any] | Noner& �Nonec C s2 d| _ d| _d| _| jD ]}t| |d� q t� | _| jjD ]}d| }t| |t| j|�� q i | _ d| _ d| _ d| _ i | _ g | _d| _i | _d| _d| _d| _d| _d| _d| _d| _d| _d| _d| _d| _i | _ i | _ |r�|� d�}|dur�|d= |� � D ]\}}| � |�}|� � D ] \} } d| f|| < q�qd|v r�|d |d < |d= d } t!�"| � |� � D ];\} } t#| jd | �r�t| jd | �| � q�t#| j| �r�t| j| | � q�t#| | �r�t| | | � q�d | ��} t!�"| � q�d| _$| j du�rt%| j �| _ | j D ]} | �&d ��s n | dk�rd| _$ nq�| �'� dS )a0 Construct a new Distribution instance: initialize all the attributes of a Distribution, and then use 'attrs' (a dictionary mapping attribute names to values) to assign some of those attributes their "real" values. (Any attributes not mentioned in 'attrs' will be assigned to some null value: 0, None, an empty list or dictionary, etc.) Most importantly, initialize the 'command_obj' attribute to the empty dictionary; this will be filled in with real command objects by 'parse_command_line()'. TF�get_N� �optionsz setup scriptrJ rI z:'licence' distribution option is deprecated; use 'license'�set_z Unknown distribution option: �-z --no-user-cfg)(r7 �dry_runr< rW �setattr�DistributionMetadata�metadata�_METHOD_BASENAMES�getattr�cmdclass�command_packages� script_name� script_args�command_options� dist_files�packages� package_data� package_dir� py_modules� libraries�headers� ext_modules� ext_package� include_dirs� extra_path�scripts� data_files�password� command_obj�have_run�get�items�get_option_dict�warnings�warn�hasattr� want_user_cfgr+ � startswith�finalize_options)�selfrY �attr�basename� method_namer^ �command� cmd_options�opt_dict�opt�valr3 �key�argr( r( r4 �__init__� s� � � zDistribution.__init__c C s& | j �|�}|du ri }| j |< |S )z�Get the option dictionary for a given command. If that command's option dictionary hasn't been created yet, then create it and return the new dictionary; otherwise, return the existing option dictionary. N)rk r| )r� r� �dictr( r( r4 r~ 7 s z Distribution.get_option_dictr] �indentr* c C s� ddl m} |d u rt| j�� �}|d ur | �|| � |d }|s+| �|d � d S |D ]8}| j�|�}|d u rE| �|d|� d� � q-| �|d|� d� � ||�}|�d �D ] }| �|d | � qYq-d S ) Nr )�pformat� zno commands known yetzno option dict for 'z ' commandzoption dict for '� ' command:� )�pprintr� �sortedrk �keys�announcer| �split) r� �header�commandsr� r� �cmd_namer� �out�liner( r( r4 �dump_option_dictsB s& ��z Distribution.dump_option_dictsc C s6 t � dd� | �� D �}tr| �d�d�|��� |S )a� Find as many configuration files as should be processed for this platform, and return a list of filenames in the order in which they should be parsed. The filenames returned are guaranteed to exist (modulo nasty race conditions). There are multiple possible config files: - distutils.cfg in the Distutils installation directory (i.e. where the top-level Distutils __inst__.py file lives) - a file in the user's home directory named .pydistutils.cfg on Unix and pydistutils.cfg on Windows/Mac; may be disabled with the ``--no-user-cfg`` option - setup.cfg in the current directory - a file named by an environment variable c S s g | ] }t j�|�rt|��qS r( )�os�path�isfiler* )rT r� r( r( r4 rV l s z2Distribution.find_config_files.<locals>.<listcomp>zusing config files: {}z, )r � _gen_pathsr r� r. �join)r� �filesr( r( r4 �find_config_files\ s z Distribution.find_config_filesc c s� � t �tjd j�j}|d V dtjdk }|d }| jr=t � t �� t �d�� � | V W d � n1 s8w Y t �d�V t � t �� t �t�d��V W d � d S 1 s]w Y d S ) N� distutilsz distutils.cfg�.�posixzpydistutils.cfg�~z setup.cfg�DIST_EXTRA_CONFIG)�pathlib�Path�sys�modules�__file__�parentr� r@ r� � contextlib�suppress� RuntimeError� expanduser� TypeError�getenv)r� �sys_dir�prefix�filenamer( r( r4 r� s s � � "�zDistribution._gen_pathsc C s� ddl m} tjtjkrg d�}ng }t|�}|d u r | �� }tr&| �d� |� }|D ]G}tr7| �d|� �� |j |dd� |� � D ]+}|� |�}| � |�}|D ] } | dkrl| |vrl|� || �} | �d d �} || f|| < qPqB|�� q+d | jv r�| jd �� D ]?\} \} } | j� | �} z!| r�t| | t| � � n| d v r�t| | t| �� nt| | | � W q ty� } zt| ��d } ~ ww d S d S ) Nr )� ConfigParser) z install-basezinstall-platbasez install-libzinstall-platlibzinstall-purelibzinstall-headerszinstall-scriptsz install-datar� z exec-prefix�home�user�rootz"Distribution.parse_config_files():z reading zutf-8��encodingr- r` �_�global)r7 ra )� configparserr� r� r� � base_prefix� frozensetr� r r� �read�sectionsr^ r~ r| �replacer� rk r} rX rb r � ValueErrorr )r� � filenamesr� �ignore_options�parserr� �sectionr^ r� r� r� �_src�aliasr3 r( r( r4 �parse_config_files� sR �� ����z Distribution.parse_config_filesc C s� | � � }g | _t|| j �}|�| j� |�ddi� |j| j| d�}|� � }t � � � t j d| j � | �|�r;dS |rK| �||�}|du rIdS |s=| jr^| j|t| j�dk| jd� dS | jsetd��d S ) a� Parse the setup script's command line, taken from the 'script_args' instance attribute (which defaults to 'sys.argv[1:]' -- see 'setup()' in core.py). This list is first processed for "global options" -- options that set attributes of the Distribution instance. Then, it is alternately scanned for Distutils commands and options for that command. Each new command terminates the options for the previous command. The allowed options for a command are determined by the 'user_options' attribute of the command class -- thus, we have to be able to load command classes in order to parse the command line. Any error in that 'options' attribute raises DistutilsGetoptError; any error on the command-line raises DistutilsArgError. If no Distutils commands were found on the command line, raises DistutilsArgError. Return true if command-line was successfully parsed and we should carry on with executing commands; false if no errors but we shouldn't execute commands (currently, this only happens if user asks for help). rJ rI )�args�object� Nr �rR r� zno commands suppliedT)�_get_toplevel_optionsr� r rR �set_negative_aliasesrX � set_aliases�getoptrj �get_option_order�logging� getLogger�setLevel�WARNr7 �handle_display_options�_parse_command_optsr< � _show_help�lenr )r� �toplevel_optionsr� r� � option_orderr( r( r4 �parse_command_line� s. � �z Distribution.parse_command_linec C s | j dg S )z�Return the non-display options recognized at the top level. This includes options that are recognized *only* at the top level as well as options recognized for commands. )zcommand-packages=Nz0list of packages that provide distutils commands)r> �r� r( r( r4 r� s �z"Distribution._get_toplevel_optionsc C s� ddl m} |d }t�|�std|� d���| j�|� z| �|�}W n ty4 } zt |��d}~ww t ||�sBt d|� d���t |d�rMt |jt�sUd }t || ��| j}t |d �rg|�� }|�|j� t |d �rxt |jt�rxt|j�}ng }|�| j|j | � |�|� |�|d d� �\}} t | d �r�| jr�| j|d|gd� dS t |d �r�t |jt�r�d} |jD ]#\} } } }t | |�| ��r�d } t |�r�|� q�t d|�d| � d���q�| r�dS | � |�}t | �� � D ] \}}d|f||< q�|S )a� Parse the command-line options for a single command. 'parser' must be a FancyGetopt instance; 'args' must be the list of arguments, starting with the current command (whose options we are about to parse). Returns a new version of 'args' with the next command at the front of the list; will be the empty list if there are no more commands on the command line. Returns None if the user asked for help on this command. r r zinvalid command name '�'Nzcommand class z must subclass Command� user_optionszIcommand class %s must provide 'user_options' attribute (a list of tuples)rX � help_optionsr r< Fr� zinvalid help function z for help option 'z-': must be a callable object (function, etc.)z command line) � distutils.cmdr � command_re�match� SystemExitr� �append�get_command_classr r � issubclassr r� r) r� r+ rX �copy�updater� �fix_help_options�set_option_tabler> r� r� r< r� � get_attr_name�callabler~ �varsr} )r� r� r� r r� � cmd_classr3 rX r� �opts�help_option_found� help_option�_short�_desc�funcr� r@ r$ r( r( r4 r� st �� �� �� � � ��� z Distribution._parse_command_optsc C sP dD ]#}t | j|�}|du rqt|t�r%dd� |�d�D �}t| j||� qdS )z�Set final values for all the options on the Distribution instance, analogous to the .finalize_options() method of Command objects. �rN rL Nc S � g | ]}|� � �qS r( ��strip)rT �elmr( r( r4 rV � � z1Distribution.finalize_options.<locals>.<listcomp>�,)rf rd r) r* r� rb )r� r� r$ r( r( r4 r� } s ��z Distribution.finalize_optionsTr( r� r c C s ddl m} ddlm} |r(|r| �� }n| j}|�|� |�| jd � t � |r8|�| j � |�d� t � |D ]>}t |t �rIt ||�rI|} n| �|�} t| d�ret | jt�re|�| jt| j� � n|�| j� |�d| j� d�� t � q:t || j�� d S ) ab Show help for the setup script command-line in the form of several lists of command-line options. 'parser' should be a FancyGetopt instance; do not expect it to be returned in the same state, as its option table will be reset to make it generate the correct help text. If 'global_options' is true, lists the global options: --verbose, --dry-run, etc. If 'display_options' is true, lists the "display-only" options: --name, --version, etc. Finally, lists per-command help for every command name or command class in 'commands'. r r �� gen_usagez Global options:zKInformation display options (just display information, ignore any commands)r� z Options for 'r� N)r� r �distutils.corer r� r> r� � print_helpr? �printrR r) r, r� r� r� r� r+ r� r� r- ri ) r� r� r> rR r� r r r^ r� �klassr( r( r4 r� � s6 � � zDistribution._show_helpc C s� ddl m} | jr| �� t� t|| j�� dS d}t� }| jD ] }|�|d � q!|D ]5\}}|rb||v rbt |�}t | j d| �� }|dv rPtd� |�� n|dv r\td� |�� nt|� d}q-|S ) z�If there were any non-global "display-only" options (--help-commands or the metadata display options) on the command line, display the requested info and return true; else return false. r r r r\ r r )rM rO rP rQ r� ) r r � help_commands�print_commandsr ri �setrR �addr rf rd r� ) r� r� r �any_display_options�is_display_option�optionr� r� r$ r( r( r4 r� � s, �z#Distribution.handle_display_optionsc C sr t |d � |D ].}| j�|�}|s| �|�}z|j}W n ty' d}Y nw t d|d|� ��d|� �� qdS )zZPrint a subset of the list of all commands -- used by 'print_commands()'. �:�(no description available)r� �<N)r rg r| r� rK �AttributeError)r� r� r� � max_length�cmdr rK r( r( r4 �print_command_list� s � �z Distribution.print_command_listc s� ddl }|jj}t|�� � fdd�| j�� D �}d}|| D ] }t|�|kr*t|�}q | �|d|� |r@t� | �|d|� dS dS )an Print out a help message listing all available commands with a description of each. The list is divided into "standard commands" (listed in distutils.command.__all__) and "extra commands" (mentioned in self.cmdclass, but not a standard command). The descriptions come from the command class attribute 'description'. r Nc � g | ]}|� vr|�qS r( r( �rT r ��is_stdr( r4 rV � z/Distribution.print_commands.<locals>.<listcomp>zStandard commandszExtra commands) �distutils.commandr� �__all__r rg r� r� r r )r� r� � std_commands�extra_commandsr r r( r r4 r � s ��zDistribution.print_commandsc s� ddl }|jj}t|�� � fdd�| j�� D �}g }|| D ]'}| j�|�}|s-| �|�}z|j}W n t y= d}Y nw |� ||f� q |S )a> Get a list of (command, description) tuples. The list is divided into "standard commands" (listed in distutils.command.__all__) and "extra commands" (mentioned in self.cmdclass, but not a standard command). The descriptions come from the command class attribute 'description'. r Nc r r( r( r r r( r4 rV r z1Distribution.get_command_list.<locals>.<listcomp>r ) r r� r! r rg r� r| r� rK r r� )r� r� r" r# �rvr r rK r( r r4 �get_command_list s �z Distribution.get_command_listc C sN | j }t|t�s%|du rd}dd� |�d�D �}d|vr"|�dd� || _ |S )z9Return a list of packages from which commands are loaded.Nr] c S s g | ] }|d kr|� � �qS )r] r )rT �pkgr( r( r4 rV 2 s z5Distribution.get_command_packages.<locals>.<listcomp>r zdistutils.commandr )rh r) r+ r� �insert)r� �pkgsr( r( r4 �get_command_packages, s z!Distribution.get_command_packagesr� � type[Command]c C s� | j �|�}|r |S | �� D ]E}|� d|� �}|}z t|� tj| }W n ty- Y qw zt||�}W n tyJ t d|� d|� d|� d���w || j |< | S t d|� d���)ao Return the class that implements the Distutils command named by 'command'. First we check the 'cmdclass' dictionary; if the command is mentioned there, we fetch the class object from the dictionary and return it. Otherwise we load the command module ("distutils.command." + command) and fetch the command class from the module. The loaded class is also stored in 'cmdclass' to speed future calls to 'get_command_class()'. Raises DistutilsModuleError if the expected module could not be found, or if that module does not define the expected class. r� zinvalid command 'z ' (no class 'z ' in module 'z')r� ) rg r| r) � __import__r� r� � ImportErrorrf r r )r� r� r �pkgname� module_name� klass_name�moduler( r( r4 r� 8 s, � �� z Distribution.get_command_class�create� Literal[True]r c C � d S �Nr( �r� r� r1 r( r( r4 �get_command_obj^ � z Distribution.get_command_obj�Literal[False]�Command | Nonec C r3 r4 r( r5 r( r( r4 r6 b r7 �boolc C sp | j �|�}|s6|r6tr| �d|� d�� | �|�}|| � }| j |< d| j|< | j�|�}|r6| �||� |S )a Return the command object for 'command'. Normally this object is cached on a previous call to 'get_command_obj()'; if no command object for 'command' is in the cache, then we either create and return it (if 'create' is true) or return None. z*Distribution.get_command_obj(): creating 'z' command objectF)rz r| r r� r� r{ rk �_set_command_options)r� r� r1 �cmd_objr r^ r( r( r4 r6 f s �� c C s^ |� � }|du r | �|�}tr| �d|� d�� |�� D ]�\}\}}tr3| �d|� d|� d|� d�� z dd � |jD �}W n tyH g }Y nw z|j}W n tyY i }Y nw zBt|t �} ||v rr| rrt ||| t |� � n)||v r�| r�t ||t |�� nt ||�r�t |||� nt d |� d |� d |� d ���W q ty� } zt | ��d} ~ ww dS )ay Set the options for 'command_obj' from 'option_dict'. Basically this means copying elements of a dictionary ('option_dict') to attributes of an instance ('command'). 'command_obj' must be a Command instance. If 'option_dict' is not supplied, uses the standard option dictionary for this command (from 'self.command_options'). Nz setting options for 'r� z z = z (from �)c S s g | ]}t |��qS r( rS )rT �or( r( r4 rV � r z5Distribution._set_command_options.<locals>.<listcomp>z error in z : command 'z' has no such option 'r� )�get_command_namer~ r r� r} �boolean_optionsr rX r) r* rb r r� r r� ) r� rz � option_dict� command_namer �sourcer$ � bool_opts�neg_opt� is_stringr3 r( r( r4 r; � sF � � �����z!Distribution._set_command_optionsF�reinit_subcommandsc C r3 r4 r( �r� r� rG r( r( r4 �reinitialize_command� r7 z!Distribution.reinitialize_commandr! c C r3 r4 r( rH r( r( r4 rI � r7 � str | Commandc C s| ddl m} t||�s|}| �|�}n|�� }|js |S |�� d|_d| j|< | �|� |r<|� � D ]}| � ||� q3|S )a� Reinitializes a command to the state it was in when first returned by 'get_command_obj()': ie., initialized but not yet finalized. This provides the opportunity to sneak option values in programmatically, overriding or supplementing user-supplied values from the config files and command line. You'll have to re-finalize the command object (by calling 'finalize_options()' or 'ensure_finalized()') before using it for real. 'command' should be a command name (string) or command object. If 'reinit_subcommands' is true, also reinitializes the command's sub-commands, as declared by the 'sub_commands' class attribute (if it has one). See the "install" command for an example. Only reinitializes the sub-commands that actually matter, ie. those whose test predicates return true. Returns the reinitialized command object. r r F) r� r r) r6 r? � finalized�initialize_optionsr{ r; �get_sub_commandsrI )r� r� rG r rB �subr( r( r4 rI � s �level�intc C s t � ||� d S r4 r )r� r3 rO r( r( r4 r� � � zDistribution.announcec C s | j D ]}| �|� qdS )z�Run each command that was seen on the setup script command line. Uses the list of commands found and cache of command objects created by 'get_command_obj()'. N)r� � run_command)r� r r( r( r4 � run_commands� s �zDistribution.run_commandsc C sD | j �|�rdS t�d|� | �|�}|�� |�� d| j |< dS )a� Do whatever it takes to run a command (including nothing at all, if the command has already been run). Specifically: if we have already created and run the command named by 'command', return silently without doing anything. If the command named by 'command' doesn't even have a command object yet, create one. Then invoke 'run()' on that command object (or an existing one). Nz running %sT)r{ r| r �infor6 �ensure_finalized�run)r� r� r< r( r( r4 rR � s zDistribution.run_commandc C s t | jp| jpg �dkS �Nr )r� rm rp r� r( r( r4 �has_pure_modules s z Distribution.has_pure_modulesc C � | j o t| j �dkS rW )rs r� r� r( r( r4 �has_ext_modules � z Distribution.has_ext_modulesc C rY rW )rq r� r� r( r( r4 �has_c_libraries r[ z Distribution.has_c_librariesc C s | � � p| �� S r4 )rX rZ r� r( r( r4 � has_modules rQ zDistribution.has_modulesc C rY rW )rr r� r� r( r( r4 � has_headers r[ zDistribution.has_headersc C rY rW )rw r� r� r( r( r4 � has_scripts r[ zDistribution.has_scriptsc C rY rW )rx r� r� r( r( r4 �has_data_files r[ zDistribution.has_data_filesc C s | � � o | �� o | �� S r4 )rX rZ r\ r� r( r( r4 �is_pure s ��zDistribution.is_purec C s� | j j| _| j j| _| j j| _| j j| _| j j| _| j j| _| j j| _| j j| _| j j | _ | j j | _ | j j | _ | j j | _ | j j | _ | j j| _| j j| _| j j| _| j j| _| j j| _| j j| _| j j| _| j j| _d S r4 )rd �get_name� get_version� get_fullname� get_author�get_author_email�get_maintainer�get_maintainer_email� get_contact�get_contact_email�get_url� get_license� get_licence�get_description�get_long_description� get_keywords� get_platforms�get_classifiers�get_download_url� get_requires� get_provides� get_obsoletesr� r( r( r4 r� & s* zDistribution._r zstr | Literal[False]r@ rA rC rD � author_emailrF �maintainer_emailrG � contact_emailrH rI rJ rK �long_descriptionz str | list[str] | Literal[False]rL rM rN zlist[str] | Literal[False]rO rP rQ r4 )rY rZ r& r[ )NNr] )r� r* r& r[ )r& r[ )TTr( )r� r )r� r* r& r* )T)r� r* r1 r2 r& r )r� r* r1 r8 r& r9 )r� r* r1 r: r& r9 )F)r� r* rG r: r& r )r� r! rG r: r& r! )r� rJ r& r )rO rP r& r[ )r� r* r& r[ )r& r: ).r- � __module__� __qualname__�__doc__r> �__annotations__r? rR rW rX r� r~ r� r� r� r� r� r� r� r� r� r� r r r% r) r� r r6 r; rI r� �INFOr� rS rR rX rZ r\ r] r^ r_ r` ra r r� r( r( r( r4 r6 M s� � DC b �3 ' &� *�� �, �r6 c @ s^ e Zd ZdZdZ dVdWdd �ZdXd d �ZdYdd�ZdZdd�Zdd� Z d[dd�Z d[dd�Z d[d d �Z e d\d d!��Zd]d#d$�Zd]d%d&�Zd]d'd(�Zd]d)d*�Zd]d+d,�Zd]d-d.�Zd]d/d0�Zd]d1d2�ZeZd]d3d4�Zd]d5d6�Zd^d8d9�Zd_d<d=�Zd`d?d@�Z d_dAdB�Z d^dCdD�Z d_dEdF�Z d]dGdH�Z d^dIdJ�Z!dadLdM�Z"d^dNdO�Z#dadPdQ�Z$d^dRdS�Z%dadTdU�Z&dS )brc z]Dummy class to hold the distribution meta-data: name, version, author, and so forth. )r@ rA rD rw rF rx rH rI rK rz rN rL rC rG ry rM � download_urlrO rP rQ Nr� �:str | bytes | os.PathLike[str] | os.PathLike[bytes] | Noner& r[ c C s� |d ur | � t|�� d S d | _d | _d | _d | _d | _d | _d | _d | _ d | _ d | _ d | _ d | _ d | _d | _d | _d | _d | _d S r4 )� read_pkg_file�openr@ rA rD rw rF rx rH rI rK rz rN rL rM r� rO rP rQ )r� r� r( r( r4 r� r s& z DistributionMetadata.__init__�file�IO[str]c s t |�� d� fdd� }� fdd�}� d }|d�| _|d �| _|d �| _|d �| _d | _|d�| _d | _|d�| _|d�| _ d� v rH|d�| _ nd | _ |d�| _ |d �| _d� v ra|d�� d�| _ |d�| _|d�| _|dkr�|d�| _|d�| _|d�| _d S d | _d | _d | _d S ) z-Reads the metadata values from a file object.r@ r* r& � str | Nonec s � | }|r |dkr |S d S �N�UNKNOWNr( )r@ r$ �r3 r( r4 � _read_field� s z7DistributionMetadata.read_pkg_file.<locals>._read_fieldc s � � | d �}|g kr d S |S r4 )�get_all)r@ �valuesr� r( r4 � _read_list� s z6DistributionMetadata.read_pkg_file.<locals>._read_listzmetadata-versionrA �summaryrD NrE z home-pagerI z download-urlrK rN r �platform� classifier�1.1rP rO rQ )r@ r* r& r� )r r@ rA rK rD rF rw rx rH rI r� rz r� rN rL rM rP rO rQ )r� r� r� r� �metadata_versionr( r� r4 r� � s: z"DistributionMetadata.read_pkg_file�base_dir�str | os.PathLike[str]c C sH t tj�|d�ddd��}| �|� W d � dS 1 s w Y dS )z.Write the PKG-INFO file into the release tree.zPKG-INFO�wzUTF-8r� N)r� r� r� r� �write_pkg_file)r� r� �pkg_infor( r( r4 �write_pkg_info� s � "�z#DistributionMetadata.write_pkg_info�SupportsWrite[str]c sJ d}| j s| js| js| js| jrd}� �d|� d�� � �d| �� � d�� � �d| �� � d�� � fdd�}|d | �� � |d | � � � |d | � � � |d | � � � |d | � � � |d| j� |dt | �� pid�� |dd�| �� �� | �� d| �� � | �� d| �� � | �� d| �� � | �� d| �� � | �� d| �� � dS )z0Write the PKG-INFO format data to a file object.z1.0r� zMetadata-Version: r� zName: z Version: c s" |r� � | � d|� d�� d S d S �Nz: r� ��write)r� r� �r� r( r4 � maybe_write� s �z8DistributionMetadata.write_pkg_file.<locals>.maybe_write�Summaryz Home-page�Authorz Author-email�Licensez Download-URL� Descriptionr] �Keywordsr �Platform� Classifier�Requires�Provides� ObsoletesN)rO rP rQ rM r� r� rb rc rn rk ri rj rl r ro r� rp � _write_listrq rr rt ru rv )r� r� rA r� r( r� r4 r� � s: ����� z#DistributionMetadata.write_pkg_filec C s, |pg }|D ] }|� |� d|� d�� qd S r� r� )r� r� r@ r� r$ r( r( r4 r� � s �z DistributionMetadata._write_listr* c C � | j pdS r� )r@ r� r( r( r4 rb � � z DistributionMetadata.get_namec C r� )Nz0.0.0)rA r� r( r( r4 rc � r� z DistributionMetadata.get_versionc C s | � | �� | �� �S r4 )� _fullnamerb rc r� r( r( r4 rd � r[ z!DistributionMetadata.get_fullnamer@ rA c C s d� t| ��dd�t|dd��S )a >>> DistributionMetadata._fullname('setup.tools', '1.0-2') 'setup_tools-1.0.post2' >>> DistributionMetadata._fullname('setup-tools', '1.2post2') 'setup_tools-1.2.post2' >>> DistributionMetadata._fullname('setup-tools', '1.0-r2') 'setup_tools-1.0.post2' >>> DistributionMetadata._fullname('setup.tools', '1.0.post') 'setup_tools-1.0.post0' >>> DistributionMetadata._fullname('setup.tools', '1.0+ubuntu-1') 'setup_tools-1.0+ubuntu.1' z{}-{}r` r� F)�strip_trailing_zero)r. r r� r )r@ rA r( r( r4 r� � s �z DistributionMetadata._fullnamer� c C � | j S r4 )rD r� r( r( r4 re � z DistributionMetadata.get_authorc C r� r4 )rw r� r( r( r4 rf r� z%DistributionMetadata.get_author_emailc C r� r4 )rF r� r( r( r4 rg r� z#DistributionMetadata.get_maintainerc C r� r4 )rx r� r( r( r4 rh r� z)DistributionMetadata.get_maintainer_emailc C � | j p| jS r4 )rF rD r� r( r( r4 ri � z DistributionMetadata.get_contactc C r� r4 )rx rw r� r( r( r4 rj r� z&DistributionMetadata.get_contact_emailc C r� r4 )rH r� r( r( r4 rk " r� z DistributionMetadata.get_urlc C r� r4 )rI r� r( r( r4 rl % r� z DistributionMetadata.get_licensec C r� r4 )rK r� r( r( r4 rn * r� z$DistributionMetadata.get_descriptionc C r� r4 )rz r� r( r( r4 ro - r� z)DistributionMetadata.get_long_descriptionr' c C � | j pg S r4 )rN r� r( r( r4 rp 0 r� z!DistributionMetadata.get_keywordsr$ r% c C � t |d�| _d S )NrN )r5 rN �r� r$ r( r( r4 � set_keywords3 rQ z!DistributionMetadata.set_keywords�str | list[str] | Nonec C r� r4 )rL r� r( r( r4 rq 6 r� z"DistributionMetadata.get_platformsc C r� )NrL )r5 rL r� r( r( r4 � set_platforms9 rQ z"DistributionMetadata.set_platformsc C r� r4 )rM r� r( r( r4 rr < r� z$DistributionMetadata.get_classifiersc C r� )NrM )r5 rM r� r( r( r4 �set_classifiers? rQ z$DistributionMetadata.set_classifiersc C r� r4 )r� r� r( r( r4 rs B r� z%DistributionMetadata.get_download_urlc C r� r4 )rP r� r( r( r4 rt F r� z!DistributionMetadata.get_requires� Iterable[str]c C �, dd l }|D ]}|j�|� qt|�| _d S rW )�distutils.versionpredicate�versionpredicate�VersionPredicater+ rP �r� r$ r� r8 r( r( r4 � set_requiresI � z!DistributionMetadata.set_requiresc C r� r4 )rO r� r( r( r4 ru P r� z!DistributionMetadata.get_providesc C s6 dd� |D �}|D ] }dd l }|j�|� q || _d S )Nc S r r( r )rT r8 r( r( r4 rV T r z5DistributionMetadata.set_provides.<locals>.<listcomp>r )r� r� �split_provisionrO )r� r$ r8 r� r( r( r4 � set_providesS s z!DistributionMetadata.set_providesc C r� r4 )rQ r� r( r( r4 rv [ r� z"DistributionMetadata.get_obsoletesc C r� rW )r� r� r� r+ rQ r� r( r( r4 � set_obsoletes^ r� z"DistributionMetadata.set_obsoletesr4 )r� r� r& r[ )r� r� r& r[ )r� r� r& r[ )r� r� r& r[ )r& r* )r@ r* rA r* r& r* )r& r� )r& r' )r$ r% r& r[ )r& r� )r$ r� r& r[ )'r- r{ r| r} re r� r� r� r� r� rb rc rd � staticmethodr� re rf rg rh ri rj rk rl rm rn ro rp r� rq r� rr r� rs rt r� ru r� rv r� r( r( r( r4 rc U sL � 4 ' rc c C s dd� | D �S )zConvert a 4-tuple 'help_options' list as found in various command classes to the 3-tuple form required by FancyGetopt. c S s g | ]}|d d� �qS )r � r( )rT r� r( r( r4 rV j r z$fix_help_options.<locals>.<listcomp>r( )r^ r( r( r4 r� f s r� )r$ r% r& r' )>r} � __future__r r� r� r� r� �rer� r �collections.abcr r �emailr �typingr r r r r r r r �packaging.utilsr r �_logr �debugr �errorsr r r r � fancy_getoptr r �utilr r r � _typeshedr �typing_extensionsr r r r! r+ �tupler* rP r# r~ �compiler� r5 r6 rc r� r( r( r( r4 �<module> sR ( 0 � _distutils/__pycache__/cygwinccompiler.cpython-310.pyc 0000644 00000001057 15030122015 0017026 0 ustar 00 o �hR � @ sH d dl mZ d dlmZmZmZmZmZmZ g d�Z ej Z ej Z dZdS )� )�cygwin)�CONFIG_H_NOTOK� CONFIG_H_OK�CONFIG_H_UNCERTAIN�check_config_h� get_msvcr� is_cygwincc)r r r �CygwinCCompiler�Mingw32CCompilerr r r N)� compilers.Cr �compilers.C.cygwinr r r r r r �__all__�Compilerr �MinGW32Compilerr � get_versions� r r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/cygwinccompiler.py�<module> s _distutils/__pycache__/ccompiler.cpython-310.pyc 0000644 00000001157 15030122015 0015606 0 ustar 00 o �h � @ sZ d dl mZmZ d dlmZ d dlmZmZmZm Z m Z d dl m Z m Z g d�ZejZdS )� )�_default_compilers�compiler_class)�base)�gen_lib_options�gen_preprocess_options�get_default_compiler� new_compiler�show_compilers)� CompileError� LinkError)r r r r r r r N)� compat.numpyr r � compilers.Cr �compilers.C.baser r r r r �compilers.C.errorsr r �__all__�Compiler� CCompiler� r r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/ccompiler.py�<module> s _distutils/__pycache__/file_util.cpython-310.pyc 0000644 00000013613 15030122015 0015605 0 ustar 00 o �h* � @ sf d Z ddlZddlmZ ddlmZ dddd �Zdd d �Z ddd�Zddd�Z dd� Z dS )zFdistutils.file_util Utility functions for operating on single files. � N� )�log)�DistutilsFileError�copyingz hard linkingzsymbolically linking)N�hard�sym� @ c C s� d}d}z�zt | d�}W n ty# } z td| � d|j� ���d}~ww tj�|�rIzt�|� W n tyH } z td|� d|j� ���d}~ww zt |d�}W n tyg } z td|� d|j� ���d}~ww z|�|�}W n ty� } z td | � d|j� ���d}~ww |s�n z|� |� W n ty� } z td |� d|j� ���d}~ww qiW |r�|� � |r�|� � dS dS |r�|� � |r�|� � w w ) a5 Copy the file 'src' to 'dst'; both must be filenames. Any error opening either file, reading from 'src', or writing to 'dst', raises DistutilsFileError. Data is read/written in chunks of 'buffer_size' bytes (default 16k). No attempt is made to handle anything apart from regular files. N�rbzcould not open '�': zcould not delete '�wbzcould not create 'Tzcould not read from 'zcould not write to ') �open�OSErrorr �strerror�os�path�exists�unlink�read�write�close)�src�dst� buffer_size�fsrc�fdst�e�buf� r �R/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/file_util.py�_copy_file_contents sb �� ��������� �� �r TFc C s� ddl m} ddlm} m} m} m} tj� | �s t d| � d���tj� |�r4|} tj� |tj� | ��}ntj�|�} |rO|| |�sO|dkrKt�d| � |dfS zt| }W n tyd td |� d ���w |dkr�tj� |�tj� | �kr~t�d || | � nt�d || |� |r�|d fS |d kr�tj�|�r�tj�| |�s�z t�| |� W |d fS ty� Y n w n|dkr�tj�|�r�tj�| |�s�t�| |� |d fS t| |� |s�|r�t�| �}|r�t�||| || f� |r�t� || || �� |d fS )a Copy a file 'src' to 'dst'. If 'dst' is a directory, then 'src' is copied there with the same name; otherwise, it must be a filename. (If the file exists, it will be ruthlessly clobbered.) If 'preserve_mode' is true (the default), the file's mode (type and permission bits, or whatever is analogous on the current platform) is copied. If 'preserve_times' is true (the default), the last-modified and last-access times are copied as well. If 'update' is true, 'src' will only be copied if 'dst' does not exist, or if 'dst' does exist but is older than 'src'. 'link' allows you to make hard links (os.link) or symbolic links (os.symlink) instead of copying: set it to "hard" or "sym"; if it is None (the default), files are copied. Don't set 'link' on systems that don't support it: 'copy_file()' doesn't check if hard or symbolic linking is available. If hardlink fails, falls back to _copy_file_contents(). Under Mac OS, uses the native file copy function in macostools; on other systems, uses '_copy_file_contents()' to copy file contents. Return a tuple (dest_name, copied): 'dest_name' is the actual name of the output file, and 'copied' is true if the file was copied (or would have been copied, if 'dry_run' true). r )�newer)�S_IMODE�ST_ATIME�ST_MODE�ST_MTIMEz can't copy 'z&': doesn't exist or not a regular filer z"not copying %s (output up-to-date)Fzinvalid value 'z' for 'link' argumentz %s %s -> %sTr r ) �distutils._modifiedr �statr! r" r# r$ r r �isfiler �isdir�join�basename�dirnamer �debug� _copy_action�KeyError� ValueError�infor �samefile�linkr �symlinkr �utime�chmod)r r � preserve_mode�preserve_times�updater2 �verbose�dry_runr r! r" r# r$ �dir�action�str r r � copy_file? s\ ) � � ��� r> c C s� ddl }ddlm}m}m}m}m} |dkr t�d| |� |r!|S | | �s-t d| � d���||�r;t j � ||| ��}n||�rJt d| � d|� d ���|||��s[t d| � d|� d ���d } zt � | |� W n, ty� } z | j\} } | |jkrzd } n t d | � d|� d| � ���W Y d} ~ nd} ~ ww | r�t| ||d� zt �| � W |S ty� } z&| j\} } zt �|� W n ty� Y nw t d | � d|� d| � d| � ���d} ~ ww |S )a% Move a file 'src' to 'dst'. If 'dst' is a directory, the file will be moved into it with the same name; otherwise, 'src' is just renamed to 'dst'. Return the new full name of the file. Handles cross-device moves on Unix using 'copy_file()'. What about other systems??? r N)r* r+ r r( r' r zmoving %s -> %sz can't move 'z': not a regular filez': destination 'z' already existsz' not a valid pathFTzcouldn't move 'z' to 'r )r9 z' by copy/delete: delete 'z ' failed: )�errno�os.pathr* r+ r r( r' r r0 r r r r) �renamer �args�EXDEVr> r )r r r9 r: r? r* r+ r r( r' �copy_itr �num�msgr r r � move_file� sf � � ��� � ������ rG c C sH t | ddd��}|�dd� |D �� W d � dS 1 s w Y dS )z{Create a file with the specified name and write 'contents' (a sequence of strings without line terminators) to it. �wzutf-8)�encodingc s s � | ]}|d V qdS )� Nr )�.0�liner r r � <genexpr>� s � z write_file.<locals>.<genexpr>N)r � writelines)�filename�contents�fr r r � write_file� s "�rR )r )TTFNTF)TF) �__doc__r �_logr �errorsr r- r r> rG rR r r r r �<module> s 3 � m ; _distutils/__pycache__/log.cpython-310.pyc 0000644 00000003224 15030122015 0014407 0 ustar 00 o �h� � @ s� d Z ddlZddlZddlmZ ejZejZejZej Z ej Z ejZej Z ej Z ej ZejZejZdd� Zdd� ZG d d � d ej�ZdS ) zb A simple log mechanism styled after PEP 282. Retained for compatibility and should not be used. � N� )�logc C s t j}t �| � |S �N)� _global_log�level�setLevel)r �orig� r �L/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/log.py� set_threshold s r c C sF | dkr t tj� d S | dkrt tj� d S | dkr!t tj� d S d S )Nr r � )r �logging�WARN�INFO�DEBUG)�vr r r � set_verbosity s �r c sF e Zd ZdZef� fdd� Zedd� �Zejdd� �Ze j j Z � Z S )�LogzJdistutils.log.Log is deprecated, please use an alternative from `logging`.c s t �tj� t� jt|d� d S )N�r )�warnings�warnr �__doc__�super�__init__�__name__)�self� threshold�� __class__r r r , s z Log.__init__c C s | j S r r )r r r r r 0 s z Log.thresholdc C s | � |� d S r )r )r r r r r r 4 s )r � __module__� __qualname__r r r �propertyr �setterr �Logger�warningr � __classcell__r r r r r ) s r )r r r �_logr r r r r �ERROR�FATAL�debug�infor$ r �error�fatalr r r# r r r r r �<module> s$ _distutils/core.py 0000644 00000022224 15030122015 0010220 0 ustar 00 """distutils.core The only module that needs to be imported to use the Distutils; provides the 'setup' function (which is to be called from the setup script). Also indirectly provides the Distribution and Command classes, although they are really defined in distutils.dist and distutils.cmd. """ from __future__ import annotations import os import sys import tokenize from collections.abc import Iterable from .cmd import Command from .debug import DEBUG # Mainly import these so setup scripts can "from distutils.core import" them. from .dist import Distribution from .errors import ( CCompilerError, DistutilsArgError, DistutilsError, DistutilsSetupError, ) from .extension import Extension __all__ = ['Distribution', 'Command', 'Extension', 'setup'] # This is a barebones help message generated displayed when the user # runs the setup script with no arguments at all. More useful help # is generated with various --help options: global help, list commands, # and per-command help. USAGE = """\ usage: %(script)s [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] or: %(script)s --help [cmd1 cmd2 ...] or: %(script)s --help-commands or: %(script)s cmd --help """ def gen_usage(script_name): script = os.path.basename(script_name) return USAGE % locals() # Some mild magic to control the behaviour of 'setup()' from 'run_setup()'. _setup_stop_after = None _setup_distribution = None # Legal keyword arguments for the setup() function setup_keywords = ( 'distclass', 'script_name', 'script_args', 'options', 'name', 'version', 'author', 'author_email', 'maintainer', 'maintainer_email', 'url', 'license', 'description', 'long_description', 'keywords', 'platforms', 'classifiers', 'download_url', 'requires', 'provides', 'obsoletes', ) # Legal keyword arguments for the Extension constructor extension_keywords = ( 'name', 'sources', 'include_dirs', 'define_macros', 'undef_macros', 'library_dirs', 'libraries', 'runtime_library_dirs', 'extra_objects', 'extra_compile_args', 'extra_link_args', 'swig_opts', 'export_symbols', 'depends', 'language', ) def setup(**attrs): # noqa: C901 """The gateway to the Distutils: do everything your setup script needs to do, in a highly flexible and user-driven way. Briefly: create a Distribution instance; find and parse config files; parse the command line; run each Distutils command found there, customized by the options supplied to 'setup()' (as keyword arguments), in config files, and on the command line. The Distribution instance might be an instance of a class supplied via the 'distclass' keyword argument to 'setup'; if no such class is supplied, then the Distribution class (in dist.py) is instantiated. All other arguments to 'setup' (except for 'cmdclass') are used to set attributes of the Distribution instance. The 'cmdclass' argument, if supplied, is a dictionary mapping command names to command classes. Each command encountered on the command line will be turned into a command class, which is in turn instantiated; any class found in 'cmdclass' is used in place of the default, which is (for command 'foo_bar') class 'foo_bar' in module 'distutils.command.foo_bar'. The command class must provide a 'user_options' attribute which is a list of option specifiers for 'distutils.fancy_getopt'. Any command-line options between the current and the next command are used to set attributes of the current command object. When the entire command-line has been successfully parsed, calls the 'run()' method on each command object in turn. This method will be driven entirely by the Distribution object (which each command object has a reference to, thanks to its constructor), and the command-specific options that became attributes of each command object. """ global _setup_stop_after, _setup_distribution # Determine the distribution class -- either caller-supplied or # our Distribution (see below). klass = attrs.get('distclass') if klass: attrs.pop('distclass') else: klass = Distribution if 'script_name' not in attrs: attrs['script_name'] = os.path.basename(sys.argv[0]) if 'script_args' not in attrs: attrs['script_args'] = sys.argv[1:] # Create the Distribution instance, using the remaining arguments # (ie. everything except distclass) to initialize it try: _setup_distribution = dist = klass(attrs) except DistutilsSetupError as msg: if 'name' not in attrs: raise SystemExit(f"error in setup command: {msg}") else: raise SystemExit("error in {} setup command: {}".format(attrs['name'], msg)) if _setup_stop_after == "init": return dist # Find and parse the config file(s): they will override options from # the setup script, but be overridden by the command line. dist.parse_config_files() if DEBUG: print("options (after parsing config files):") dist.dump_option_dicts() if _setup_stop_after == "config": return dist # Parse the command line and override config files; any # command-line errors are the end user's fault, so turn them into # SystemExit to suppress tracebacks. try: ok = dist.parse_command_line() except DistutilsArgError as msg: raise SystemExit(gen_usage(dist.script_name) + f"\nerror: {msg}") if DEBUG: print("options (after parsing command line):") dist.dump_option_dicts() if _setup_stop_after == "commandline": return dist # And finally, run all the commands found on the command line. if ok: return run_commands(dist) return dist # setup () def run_commands(dist): """Given a Distribution object run all the commands, raising ``SystemExit`` errors in the case of failure. This function assumes that either ``sys.argv`` or ``dist.script_args`` is already set accordingly. """ try: dist.run_commands() except KeyboardInterrupt: raise SystemExit("interrupted") except OSError as exc: if DEBUG: sys.stderr.write(f"error: {exc}\n") raise else: raise SystemExit(f"error: {exc}") except (DistutilsError, CCompilerError) as msg: if DEBUG: raise else: raise SystemExit("error: " + str(msg)) return dist def run_setup(script_name, script_args: Iterable[str] | None = None, stop_after="run"): """Run a setup script in a somewhat controlled environment, and return the Distribution instance that drives things. This is useful if you need to find out the distribution meta-data (passed as keyword args from 'script' to 'setup()', or the contents of the config files or command-line. 'script_name' is a file that will be read and run with 'exec()'; 'sys.argv[0]' will be replaced with 'script' for the duration of the call. 'script_args' is a list of strings; if supplied, 'sys.argv[1:]' will be replaced by 'script_args' for the duration of the call. 'stop_after' tells 'setup()' when to stop processing; possible values: init stop after the Distribution instance has been created and populated with the keyword arguments to 'setup()' config stop after config files have been parsed (and their data stored in the Distribution instance) commandline stop after the command-line ('sys.argv[1:]' or 'script_args') have been parsed (and the data stored in the Distribution) run [default] stop after all commands have been run (the same as if 'setup()' had been called in the usual way Returns the Distribution instance, which provides all information used to drive the Distutils. """ if stop_after not in ('init', 'config', 'commandline', 'run'): raise ValueError(f"invalid value for 'stop_after': {stop_after!r}") global _setup_stop_after, _setup_distribution _setup_stop_after = stop_after save_argv = sys.argv.copy() g = {'__file__': script_name, '__name__': '__main__'} try: try: sys.argv[0] = script_name if script_args is not None: sys.argv[1:] = script_args # tokenize.open supports automatic encoding detection with tokenize.open(script_name) as f: code = f.read().replace(r'\r\n', r'\n') exec(code, g) finally: sys.argv = save_argv _setup_stop_after = None except SystemExit: # Hmm, should we do something if exiting with a non-zero code # (ie. error)? pass if _setup_distribution is None: raise RuntimeError( "'distutils.core.setup()' was never called -- " f"perhaps '{script_name}' is not a Distutils setup script?" ) # I wonder if the setup script's namespace -- g and l -- would be of # any interest to callers? # print "_setup_distribution:", _setup_distribution return _setup_distribution # run_setup () _distutils/_modified.py 0000644 00000006213 15030122015 0011207 0 ustar 00 """Timestamp comparison of files and groups of files.""" from __future__ import annotations import functools import os.path from collections.abc import Callable, Iterable from typing import Literal, TypeVar from jaraco.functools import splat from .compat.py39 import zip_strict from .errors import DistutilsFileError _SourcesT = TypeVar( "_SourcesT", bound="str | bytes | os.PathLike[str] | os.PathLike[bytes]" ) _TargetsT = TypeVar( "_TargetsT", bound="str | bytes | os.PathLike[str] | os.PathLike[bytes]" ) def _newer(source, target): return not os.path.exists(target) or ( os.path.getmtime(source) > os.path.getmtime(target) ) def newer( source: str | bytes | os.PathLike[str] | os.PathLike[bytes], target: str | bytes | os.PathLike[str] | os.PathLike[bytes], ) -> bool: """ Is source modified more recently than target. Returns True if 'source' is modified more recently than 'target' or if 'target' does not exist. Raises DistutilsFileError if 'source' does not exist. """ if not os.path.exists(source): raise DistutilsFileError(f"file {os.path.abspath(source)!r} does not exist") return _newer(source, target) def newer_pairwise( sources: Iterable[_SourcesT], targets: Iterable[_TargetsT], newer: Callable[[_SourcesT, _TargetsT], bool] = newer, ) -> tuple[list[_SourcesT], list[_TargetsT]]: """ Filter filenames where sources are newer than targets. Walk two filename iterables in parallel, testing if each source is newer than its corresponding target. Returns a pair of lists (sources, targets) where source is newer than target, according to the semantics of 'newer()'. """ newer_pairs = filter(splat(newer), zip_strict(sources, targets)) return tuple(map(list, zip(*newer_pairs))) or ([], []) def newer_group( sources: Iterable[str | bytes | os.PathLike[str] | os.PathLike[bytes]], target: str | bytes | os.PathLike[str] | os.PathLike[bytes], missing: Literal["error", "ignore", "newer"] = "error", ) -> bool: """ Is target out-of-date with respect to any file in sources. Return True if 'target' is out-of-date with respect to any file listed in 'sources'. In other words, if 'target' exists and is newer than every file in 'sources', return False; otherwise return True. ``missing`` controls how to handle a missing source file: - error (default): allow the ``stat()`` call to fail. - ignore: silently disregard any missing source files. - newer: treat missing source files as "target out of date". This mode is handy in "dry-run" mode: it will pretend to carry out commands that wouldn't work because inputs are missing, but that doesn't matter because dry-run won't run the commands. """ def missing_as_newer(source): return missing == 'newer' and not os.path.exists(source) ignored = os.path.exists if missing == 'ignore' else None return not os.path.exists(target) or any( missing_as_newer(source) or _newer(source, target) for source in filter(ignored, sources) ) newer_pairwise_group = functools.partial(newer_pairwise, newer=newer_group) _distutils/archive_util.py 0000644 00000021264 15030122015 0011751 0 ustar 00 """distutils.archive_util Utility functions for creating archive files (tarballs, zip files, that sort of thing).""" from __future__ import annotations import os from typing import Literal, overload try: import zipfile except ImportError: zipfile = None from ._log import log from .dir_util import mkpath from .errors import DistutilsExecError from .spawn import spawn try: from pwd import getpwnam except ImportError: getpwnam = None try: from grp import getgrnam except ImportError: getgrnam = None def _get_gid(name): """Returns a gid, given a group name.""" if getgrnam is None or name is None: return None try: result = getgrnam(name) except KeyError: result = None if result is not None: return result[2] return None def _get_uid(name): """Returns an uid, given a user name.""" if getpwnam is None or name is None: return None try: result = getpwnam(name) except KeyError: result = None if result is not None: return result[2] return None def make_tarball( base_name: str, base_dir: str | os.PathLike[str], compress: Literal["gzip", "bzip2", "xz"] | None = "gzip", verbose: bool = False, dry_run: bool = False, owner: str | None = None, group: str | None = None, ) -> str: """Create a (possibly compressed) tar file from all the files under 'base_dir'. 'compress' must be "gzip" (the default), "bzip2", "xz", or None. 'owner' and 'group' can be used to define an owner and a group for the archive that is being built. If not provided, the current owner and group will be used. The output tar file will be named 'base_dir' + ".tar", possibly plus the appropriate compression extension (".gz", ".bz2", ".xz" or ".Z"). Returns the output filename. """ tar_compression = { 'gzip': 'gz', 'bzip2': 'bz2', 'xz': 'xz', None: '', } compress_ext = {'gzip': '.gz', 'bzip2': '.bz2', 'xz': '.xz'} # flags for compression program, each element of list will be an argument if compress is not None and compress not in compress_ext.keys(): raise ValueError( "bad value for 'compress': must be None, 'gzip', 'bzip2', 'xz'" ) archive_name = base_name + '.tar' archive_name += compress_ext.get(compress, '') mkpath(os.path.dirname(archive_name), dry_run=dry_run) # creating the tarball import tarfile # late import so Python build itself doesn't break log.info('Creating tar archive') uid = _get_uid(owner) gid = _get_gid(group) def _set_uid_gid(tarinfo): if gid is not None: tarinfo.gid = gid tarinfo.gname = group if uid is not None: tarinfo.uid = uid tarinfo.uname = owner return tarinfo if not dry_run: tar = tarfile.open(archive_name, f'w|{tar_compression[compress]}') try: tar.add(base_dir, filter=_set_uid_gid) finally: tar.close() return archive_name def make_zipfile( # noqa: C901 base_name: str, base_dir: str | os.PathLike[str], verbose: bool = False, dry_run: bool = False, ) -> str: """Create a zip file from all the files under 'base_dir'. The output zip file will be named 'base_name' + ".zip". Uses either the "zipfile" Python module (if available) or the InfoZIP "zip" utility (if installed and found on the default search path). If neither tool is available, raises DistutilsExecError. Returns the name of the output zip file. """ zip_filename = base_name + ".zip" mkpath(os.path.dirname(zip_filename), dry_run=dry_run) # If zipfile module is not available, try spawning an external # 'zip' command. if zipfile is None: if verbose: zipoptions = "-r" else: zipoptions = "-rq" try: spawn(["zip", zipoptions, zip_filename, base_dir], dry_run=dry_run) except DistutilsExecError: # XXX really should distinguish between "couldn't find # external 'zip' command" and "zip failed". raise DistutilsExecError( f"unable to create zip file '{zip_filename}': " "could neither import the 'zipfile' module nor " "find a standalone zip utility" ) else: log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) if not dry_run: try: zip = zipfile.ZipFile( zip_filename, "w", compression=zipfile.ZIP_DEFLATED ) except RuntimeError: zip = zipfile.ZipFile(zip_filename, "w", compression=zipfile.ZIP_STORED) with zip: if base_dir != os.curdir: path = os.path.normpath(os.path.join(base_dir, '')) zip.write(path, path) log.info("adding '%s'", path) for dirpath, dirnames, filenames in os.walk(base_dir): for name in dirnames: path = os.path.normpath(os.path.join(dirpath, name, '')) zip.write(path, path) log.info("adding '%s'", path) for name in filenames: path = os.path.normpath(os.path.join(dirpath, name)) if os.path.isfile(path): zip.write(path, path) log.info("adding '%s'", path) return zip_filename ARCHIVE_FORMATS = { 'gztar': (make_tarball, [('compress', 'gzip')], "gzip'ed tar-file"), 'bztar': (make_tarball, [('compress', 'bzip2')], "bzip2'ed tar-file"), 'xztar': (make_tarball, [('compress', 'xz')], "xz'ed tar-file"), 'ztar': (make_tarball, [('compress', 'compress')], "compressed tar file"), 'tar': (make_tarball, [('compress', None)], "uncompressed tar file"), 'zip': (make_zipfile, [], "ZIP file"), } def check_archive_formats(formats): """Returns the first format from the 'format' list that is unknown. If all formats are known, returns None """ for format in formats: if format not in ARCHIVE_FORMATS: return format return None @overload def make_archive( base_name: str, format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, base_dir: str | None = None, verbose: bool = False, dry_run: bool = False, owner: str | None = None, group: str | None = None, ) -> str: ... @overload def make_archive( base_name: str | os.PathLike[str], format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes], base_dir: str | None = None, verbose: bool = False, dry_run: bool = False, owner: str | None = None, group: str | None = None, ) -> str: ... def make_archive( base_name: str | os.PathLike[str], format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, base_dir: str | None = None, verbose: bool = False, dry_run: bool = False, owner: str | None = None, group: str | None = None, ) -> str: """Create an archive file (eg. zip or tar). 'base_name' is the name of the file to create, minus any format-specific extension; 'format' is the archive format: one of "zip", "tar", "gztar", "bztar", "xztar", or "ztar". 'root_dir' is a directory that will be the root directory of the archive; ie. we typically chdir into 'root_dir' before creating the archive. 'base_dir' is the directory where we start archiving from; ie. 'base_dir' will be the common prefix of all files and directories in the archive. 'root_dir' and 'base_dir' both default to the current directory. Returns the name of the archive file. 'owner' and 'group' are used when creating a tar archive. By default, uses the current owner and group. """ save_cwd = os.getcwd() if root_dir is not None: log.debug("changing into '%s'", root_dir) base_name = os.path.abspath(base_name) if not dry_run: os.chdir(root_dir) if base_dir is None: base_dir = os.curdir kwargs = {'dry_run': dry_run} try: format_info = ARCHIVE_FORMATS[format] except KeyError: raise ValueError(f"unknown archive format '{format}'") func = format_info[0] kwargs.update(format_info[1]) if format != 'zip': kwargs['owner'] = owner kwargs['group'] = group try: filename = func(base_name, base_dir, **kwargs) finally: if root_dir is not None: log.debug("changing back to '%s'", save_cwd) os.chdir(save_cwd) return filename _distutils/zosccompiler.py 0000644 00000000072 15030122015 0011776 0 ustar 00 from .compilers.C import zos zOSCCompiler = zos.Compiler _distutils/file_util.py 0000644 00000017452 15030122015 0011253 0 ustar 00 """distutils.file_util Utility functions for operating on single files. """ import os from ._log import log from .errors import DistutilsFileError # for generating verbose output in 'copy_file()' _copy_action = {None: 'copying', 'hard': 'hard linking', 'sym': 'symbolically linking'} def _copy_file_contents(src, dst, buffer_size=16 * 1024): # noqa: C901 """Copy the file 'src' to 'dst'; both must be filenames. Any error opening either file, reading from 'src', or writing to 'dst', raises DistutilsFileError. Data is read/written in chunks of 'buffer_size' bytes (default 16k). No attempt is made to handle anything apart from regular files. """ # Stolen from shutil module in the standard library, but with # custom error-handling added. fsrc = None fdst = None try: try: fsrc = open(src, 'rb') except OSError as e: raise DistutilsFileError(f"could not open '{src}': {e.strerror}") if os.path.exists(dst): try: os.unlink(dst) except OSError as e: raise DistutilsFileError(f"could not delete '{dst}': {e.strerror}") try: fdst = open(dst, 'wb') except OSError as e: raise DistutilsFileError(f"could not create '{dst}': {e.strerror}") while True: try: buf = fsrc.read(buffer_size) except OSError as e: raise DistutilsFileError(f"could not read from '{src}': {e.strerror}") if not buf: break try: fdst.write(buf) except OSError as e: raise DistutilsFileError(f"could not write to '{dst}': {e.strerror}") finally: if fdst: fdst.close() if fsrc: fsrc.close() def copy_file( # noqa: C901 src, dst, preserve_mode=True, preserve_times=True, update=False, link=None, verbose=True, dry_run=False, ): """Copy a file 'src' to 'dst'. If 'dst' is a directory, then 'src' is copied there with the same name; otherwise, it must be a filename. (If the file exists, it will be ruthlessly clobbered.) If 'preserve_mode' is true (the default), the file's mode (type and permission bits, or whatever is analogous on the current platform) is copied. If 'preserve_times' is true (the default), the last-modified and last-access times are copied as well. If 'update' is true, 'src' will only be copied if 'dst' does not exist, or if 'dst' does exist but is older than 'src'. 'link' allows you to make hard links (os.link) or symbolic links (os.symlink) instead of copying: set it to "hard" or "sym"; if it is None (the default), files are copied. Don't set 'link' on systems that don't support it: 'copy_file()' doesn't check if hard or symbolic linking is available. If hardlink fails, falls back to _copy_file_contents(). Under Mac OS, uses the native file copy function in macostools; on other systems, uses '_copy_file_contents()' to copy file contents. Return a tuple (dest_name, copied): 'dest_name' is the actual name of the output file, and 'copied' is true if the file was copied (or would have been copied, if 'dry_run' true). """ # XXX if the destination file already exists, we clobber it if # copying, but blow up if linking. Hmmm. And I don't know what # macostools.copyfile() does. Should definitely be consistent, and # should probably blow up if destination exists and we would be # changing it (ie. it's not already a hard/soft link to src OR # (not update) and (src newer than dst). from distutils._modified import newer from stat import S_IMODE, ST_ATIME, ST_MODE, ST_MTIME if not os.path.isfile(src): raise DistutilsFileError( f"can't copy '{src}': doesn't exist or not a regular file" ) if os.path.isdir(dst): dir = dst dst = os.path.join(dst, os.path.basename(src)) else: dir = os.path.dirname(dst) if update and not newer(src, dst): if verbose >= 1: log.debug("not copying %s (output up-to-date)", src) return (dst, False) try: action = _copy_action[link] except KeyError: raise ValueError(f"invalid value '{link}' for 'link' argument") if verbose >= 1: if os.path.basename(dst) == os.path.basename(src): log.info("%s %s -> %s", action, src, dir) else: log.info("%s %s -> %s", action, src, dst) if dry_run: return (dst, True) # If linking (hard or symbolic), use the appropriate system call # (Unix only, of course, but that's the caller's responsibility) elif link == 'hard': if not (os.path.exists(dst) and os.path.samefile(src, dst)): try: os.link(src, dst) except OSError: # If hard linking fails, fall back on copying file # (some special filesystems don't support hard linking # even under Unix, see issue #8876). pass else: return (dst, True) elif link == 'sym': if not (os.path.exists(dst) and os.path.samefile(src, dst)): os.symlink(src, dst) return (dst, True) # Otherwise (non-Mac, not linking), copy the file contents and # (optionally) copy the times and mode. _copy_file_contents(src, dst) if preserve_mode or preserve_times: st = os.stat(src) # According to David Ascher <da@ski.org>, utime() should be done # before chmod() (at least under NT). if preserve_times: os.utime(dst, (st[ST_ATIME], st[ST_MTIME])) if preserve_mode: os.chmod(dst, S_IMODE(st[ST_MODE])) return (dst, True) # XXX I suspect this is Unix-specific -- need porting help! def move_file(src, dst, verbose=True, dry_run=False): # noqa: C901 """Move a file 'src' to 'dst'. If 'dst' is a directory, the file will be moved into it with the same name; otherwise, 'src' is just renamed to 'dst'. Return the new full name of the file. Handles cross-device moves on Unix using 'copy_file()'. What about other systems??? """ import errno from os.path import basename, dirname, exists, isdir, isfile if verbose >= 1: log.info("moving %s -> %s", src, dst) if dry_run: return dst if not isfile(src): raise DistutilsFileError(f"can't move '{src}': not a regular file") if isdir(dst): dst = os.path.join(dst, basename(src)) elif exists(dst): raise DistutilsFileError( f"can't move '{src}': destination '{dst}' already exists" ) if not isdir(dirname(dst)): raise DistutilsFileError( f"can't move '{src}': destination '{dst}' not a valid path" ) copy_it = False try: os.rename(src, dst) except OSError as e: (num, msg) = e.args if num == errno.EXDEV: copy_it = True else: raise DistutilsFileError(f"couldn't move '{src}' to '{dst}': {msg}") if copy_it: copy_file(src, dst, verbose=verbose) try: os.unlink(src) except OSError as e: (num, msg) = e.args try: os.unlink(dst) except OSError: pass raise DistutilsFileError( f"couldn't move '{src}' to '{dst}' by copy/delete: " f"delete '{src}' failed: {msg}" ) return dst def write_file(filename, contents): """Create a file with the specified name and write 'contents' (a sequence of strings without line terminators) to it. """ with open(filename, 'w', encoding='utf-8') as f: f.writelines(line + '\n' for line in contents) _distutils/dep_util.py 0000644 00000000535 15030122015 0011076 0 ustar 00 import warnings from . import _modified def __getattr__(name): if name not in ['newer', 'newer_group', 'newer_pairwise']: raise AttributeError(name) warnings.warn( "dep_util is Deprecated. Use functions from setuptools instead.", DeprecationWarning, stacklevel=2, ) return getattr(_modified, name) _distutils/fancy_getopt.py 0000644 00000042747 15030122015 0011766 0 ustar 00 """distutils.fancy_getopt Wrapper around the standard getopt module that provides the following additional features: * short and long options are tied together * options have help strings, so fancy_getopt could potentially create a complete usage summary * options set attributes of a passed-in object """ from __future__ import annotations import getopt import re import string import sys from collections.abc import Sequence from typing import Any from .errors import DistutilsArgError, DistutilsGetoptError # Much like command_re in distutils.core, this is close to but not quite # the same as a Python NAME -- except, in the spirit of most GNU # utilities, we use '-' in place of '_'. (The spirit of LISP lives on!) # The similarities to NAME are again not a coincidence... longopt_pat = r'[a-zA-Z](?:[a-zA-Z0-9-]*)' longopt_re = re.compile(rf'^{longopt_pat}$') # For recognizing "negative alias" options, eg. "quiet=!verbose" neg_alias_re = re.compile(f"^({longopt_pat})=!({longopt_pat})$") # This is used to translate long options to legitimate Python identifiers # (for use as attributes of some object). longopt_xlate = str.maketrans('-', '_') class FancyGetopt: """Wrapper around the standard 'getopt()' module that provides some handy extra functionality: * short and long options are tied together * options have help strings, and help text can be assembled from them * options set attributes of a passed-in object * boolean options can have "negative aliases" -- eg. if --quiet is the "negative alias" of --verbose, then "--quiet" on the command line sets 'verbose' to false """ def __init__(self, option_table=None): # The option table is (currently) a list of tuples. The # tuples may have 3 or four values: # (long_option, short_option, help_string [, repeatable]) # if an option takes an argument, its long_option should have '=' # appended; short_option should just be a single character, no ':' # in any case. If a long_option doesn't have a corresponding # short_option, short_option should be None. All option tuples # must have long options. self.option_table = option_table # 'option_index' maps long option names to entries in the option # table (ie. those 3-tuples). self.option_index = {} if self.option_table: self._build_index() # 'alias' records (duh) alias options; {'foo': 'bar'} means # --foo is an alias for --bar self.alias = {} # 'negative_alias' keeps track of options that are the boolean # opposite of some other option self.negative_alias = {} # These keep track of the information in the option table. We # don't actually populate these structures until we're ready to # parse the command-line, since the 'option_table' passed in here # isn't necessarily the final word. self.short_opts = [] self.long_opts = [] self.short2long = {} self.attr_name = {} self.takes_arg = {} # And 'option_order' is filled up in 'getopt()'; it records the # original order of options (and their values) on the command-line, # but expands short options, converts aliases, etc. self.option_order = [] def _build_index(self): self.option_index.clear() for option in self.option_table: self.option_index[option[0]] = option def set_option_table(self, option_table): self.option_table = option_table self._build_index() def add_option(self, long_option, short_option=None, help_string=None): if long_option in self.option_index: raise DistutilsGetoptError( f"option conflict: already an option '{long_option}'" ) else: option = (long_option, short_option, help_string) self.option_table.append(option) self.option_index[long_option] = option def has_option(self, long_option): """Return true if the option table for this parser has an option with long name 'long_option'.""" return long_option in self.option_index def get_attr_name(self, long_option): """Translate long option name 'long_option' to the form it has as an attribute of some object: ie., translate hyphens to underscores.""" return long_option.translate(longopt_xlate) def _check_alias_dict(self, aliases, what): assert isinstance(aliases, dict) for alias, opt in aliases.items(): if alias not in self.option_index: raise DistutilsGetoptError( f"invalid {what} '{alias}': option '{alias}' not defined" ) if opt not in self.option_index: raise DistutilsGetoptError( f"invalid {what} '{alias}': aliased option '{opt}' not defined" ) def set_aliases(self, alias): """Set the aliases for this option parser.""" self._check_alias_dict(alias, "alias") self.alias = alias def set_negative_aliases(self, negative_alias): """Set the negative aliases for this option parser. 'negative_alias' should be a dictionary mapping option names to option names, both the key and value must already be defined in the option table.""" self._check_alias_dict(negative_alias, "negative alias") self.negative_alias = negative_alias def _grok_option_table(self): # noqa: C901 """Populate the various data structures that keep tabs on the option table. Called by 'getopt()' before it can do anything worthwhile. """ self.long_opts = [] self.short_opts = [] self.short2long.clear() self.repeat = {} for option in self.option_table: if len(option) == 3: long, short, help = option repeat = 0 elif len(option) == 4: long, short, help, repeat = option else: # the option table is part of the code, so simply # assert that it is correct raise ValueError(f"invalid option tuple: {option!r}") # Type- and value-check the option names if not isinstance(long, str) or len(long) < 2: raise DistutilsGetoptError( f"invalid long option '{long}': must be a string of length >= 2" ) if not ((short is None) or (isinstance(short, str) and len(short) == 1)): raise DistutilsGetoptError( f"invalid short option '{short}': must a single character or None" ) self.repeat[long] = repeat self.long_opts.append(long) if long[-1] == '=': # option takes an argument? if short: short = short + ':' long = long[0:-1] self.takes_arg[long] = True else: # Is option is a "negative alias" for some other option (eg. # "quiet" == "!verbose")? alias_to = self.negative_alias.get(long) if alias_to is not None: if self.takes_arg[alias_to]: raise DistutilsGetoptError( f"invalid negative alias '{long}': " f"aliased option '{alias_to}' takes a value" ) self.long_opts[-1] = long # XXX redundant?! self.takes_arg[long] = False # If this is an alias option, make sure its "takes arg" flag is # the same as the option it's aliased to. alias_to = self.alias.get(long) if alias_to is not None: if self.takes_arg[long] != self.takes_arg[alias_to]: raise DistutilsGetoptError( f"invalid alias '{long}': inconsistent with " f"aliased option '{alias_to}' (one of them takes a value, " "the other doesn't" ) # Now enforce some bondage on the long option name, so we can # later translate it to an attribute name on some object. Have # to do this a bit late to make sure we've removed any trailing # '='. if not longopt_re.match(long): raise DistutilsGetoptError( f"invalid long option name '{long}' " "(must be letters, numbers, hyphens only" ) self.attr_name[long] = self.get_attr_name(long) if short: self.short_opts.append(short) self.short2long[short[0]] = long def getopt(self, args: Sequence[str] | None = None, object=None): # noqa: C901 """Parse command-line options in args. Store as attributes on object. If 'args' is None or not supplied, uses 'sys.argv[1:]'. If 'object' is None or not supplied, creates a new OptionDummy object, stores option values there, and returns a tuple (args, object). If 'object' is supplied, it is modified in place and 'getopt()' just returns 'args'; in both cases, the returned 'args' is a modified copy of the passed-in 'args' list, which is left untouched. """ if args is None: args = sys.argv[1:] if object is None: object = OptionDummy() created_object = True else: created_object = False self._grok_option_table() short_opts = ' '.join(self.short_opts) try: opts, args = getopt.getopt(args, short_opts, self.long_opts) except getopt.error as msg: raise DistutilsArgError(msg) for opt, val in opts: if len(opt) == 2 and opt[0] == '-': # it's a short option opt = self.short2long[opt[1]] else: assert len(opt) > 2 and opt[:2] == '--' opt = opt[2:] alias = self.alias.get(opt) if alias: opt = alias if not self.takes_arg[opt]: # boolean option? assert val == '', "boolean option can't have value" alias = self.negative_alias.get(opt) if alias: opt = alias val = 0 else: val = 1 attr = self.attr_name[opt] # The only repeating option at the moment is 'verbose'. # It has a negative option -q quiet, which should set verbose = False. if val and self.repeat.get(attr) is not None: val = getattr(object, attr, 0) + 1 setattr(object, attr, val) self.option_order.append((opt, val)) # for opts if created_object: return args, object else: return args def get_option_order(self): """Returns the list of (option, value) tuples processed by the previous run of 'getopt()'. Raises RuntimeError if 'getopt()' hasn't been called yet. """ if self.option_order is None: raise RuntimeError("'getopt()' hasn't been called yet") else: return self.option_order def generate_help(self, header=None): # noqa: C901 """Generate help text (a list of strings, one per suggested line of output) from the option table for this FancyGetopt object. """ # Blithely assume the option table is good: probably wouldn't call # 'generate_help()' unless you've already called 'getopt()'. # First pass: determine maximum length of long option names max_opt = 0 for option in self.option_table: long = option[0] short = option[1] ell = len(long) if long[-1] == '=': ell = ell - 1 if short is not None: ell = ell + 5 # " (-x)" where short == 'x' if ell > max_opt: max_opt = ell opt_width = max_opt + 2 + 2 + 2 # room for indent + dashes + gutter # Typical help block looks like this: # --foo controls foonabulation # Help block for longest option looks like this: # --flimflam set the flim-flam level # and with wrapped text: # --flimflam set the flim-flam level (must be between # 0 and 100, except on Tuesdays) # Options with short names will have the short name shown (but # it doesn't contribute to max_opt): # --foo (-f) controls foonabulation # If adding the short option would make the left column too wide, # we push the explanation off to the next line # --flimflam (-l) # set the flim-flam level # Important parameters: # - 2 spaces before option block start lines # - 2 dashes for each long option name # - min. 2 spaces between option and explanation (gutter) # - 5 characters (incl. space) for short option name # Now generate lines of help text. (If 80 columns were good enough # for Jesus, then 78 columns are good enough for me!) line_width = 78 text_width = line_width - opt_width big_indent = ' ' * opt_width if header: lines = [header] else: lines = ['Option summary:'] for option in self.option_table: long, short, help = option[:3] text = wrap_text(help, text_width) if long[-1] == '=': long = long[0:-1] # Case 1: no short option at all (makes life easy) if short is None: if text: lines.append(f" --{long:<{max_opt}} {text[0]}") else: lines.append(f" --{long:<{max_opt}}") # Case 2: we have a short option, so we have to include it # just after the long option else: opt_names = f"{long} (-{short})" if text: lines.append(f" --{opt_names:<{max_opt}} {text[0]}") else: lines.append(f" --{opt_names:<{max_opt}}") for ell in text[1:]: lines.append(big_indent + ell) return lines def print_help(self, header=None, file=None): if file is None: file = sys.stdout for line in self.generate_help(header): file.write(line + "\n") def fancy_getopt(options, negative_opt, object, args: Sequence[str] | None): parser = FancyGetopt(options) parser.set_negative_aliases(negative_opt) return parser.getopt(args, object) WS_TRANS = {ord(_wschar): ' ' for _wschar in string.whitespace} def wrap_text(text, width): """wrap_text(text : string, width : int) -> [string] Split 'text' into multiple lines of no more than 'width' characters each, and return the list of strings that results. """ if text is None: return [] if len(text) <= width: return [text] text = text.expandtabs() text = text.translate(WS_TRANS) chunks = re.split(r'( +|-+)', text) chunks = [ch for ch in chunks if ch] # ' - ' results in empty strings lines = [] while chunks: cur_line = [] # list of chunks (to-be-joined) cur_len = 0 # length of current line while chunks: ell = len(chunks[0]) if cur_len + ell <= width: # can squeeze (at least) this chunk in cur_line.append(chunks[0]) del chunks[0] cur_len = cur_len + ell else: # this line is full # drop last chunk if all space if cur_line and cur_line[-1][0] == ' ': del cur_line[-1] break if chunks: # any chunks left to process? # if the current line is still empty, then we had a single # chunk that's too big too fit on a line -- so we break # down and break it up at the line width if cur_len == 0: cur_line.append(chunks[0][0:width]) chunks[0] = chunks[0][width:] # all-whitespace chunks at the end of a line can be discarded # (and we know from the re.split above that if a chunk has # *any* whitespace, it is *all* whitespace) if chunks[0][0] == ' ': del chunks[0] # and store this line in the list-of-all-lines -- as a single # string, of course! lines.append(''.join(cur_line)) return lines def translate_longopt(opt): """Convert a long option name to a valid Python identifier by changing "-" to "_". """ return opt.translate(longopt_xlate) class OptionDummy: """Dummy class just used as a place to hold command-line option values as instance attributes.""" def __init__(self, options: Sequence[Any] = []): """Create a new OptionDummy instance. The attributes listed in 'options' will be initialized to None.""" for opt in options: setattr(self, opt, None) if __name__ == "__main__": text = """\ Tra-la-la, supercalifragilisticexpialidocious. How *do* you spell that odd word, anyways? (Someone ask Mary -- she'll know [or she'll say, "How should I know?"].)""" for w in (10, 20, 30, 40): print(f"width: {w}") print("\n".join(wrap_text(text, w))) print() _distutils/dist.py 0000644 00000154762 15030122015 0010250 0 ustar 00 """distutils.dist Provides the Distribution class, which represents the module distribution being built/installed/distributed. """ from __future__ import annotations import contextlib import logging import os import pathlib import re import sys import warnings from collections.abc import Iterable, MutableMapping from email import message_from_file from typing import ( IO, TYPE_CHECKING, Any, ClassVar, Literal, TypeVar, Union, overload, ) from packaging.utils import canonicalize_name, canonicalize_version from ._log import log from .debug import DEBUG from .errors import ( DistutilsArgError, DistutilsClassError, DistutilsModuleError, DistutilsOptionError, ) from .fancy_getopt import FancyGetopt, translate_longopt from .util import check_environ, rfc822_escape, strtobool if TYPE_CHECKING: from _typeshed import SupportsWrite from typing_extensions import TypeAlias # type-only import because of mutual dependence between these modules from .cmd import Command _CommandT = TypeVar("_CommandT", bound="Command") _OptionsList: TypeAlias = list[ Union[tuple[str, Union[str, None], str, int], tuple[str, Union[str, None], str]] ] # Regex to define acceptable Distutils command names. This is not *quite* # the same as a Python NAME -- I don't allow leading underscores. The fact # that they're very similar is no coincidence; the default naming scheme is # to look for a Python module named after the command. command_re = re.compile(r'^[a-zA-Z]([a-zA-Z0-9_]*)$') def _ensure_list(value: str | Iterable[str], fieldname) -> str | list[str]: if isinstance(value, str): # a string containing comma separated values is okay. It will # be converted to a list by Distribution.finalize_options(). pass elif not isinstance(value, list): # passing a tuple or an iterator perhaps, warn and convert typename = type(value).__name__ msg = "Warning: '{fieldname}' should be a list, got type '{typename}'" msg = msg.format(**locals()) log.warning(msg) value = list(value) return value class Distribution: """The core of the Distutils. Most of the work hiding behind 'setup' is really done within a Distribution instance, which farms the work out to the Distutils commands specified on the command line. Setup scripts will almost never instantiate Distribution directly, unless the 'setup()' function is totally inadequate to their needs. However, it is conceivable that a setup script might wish to subclass Distribution for some specialized purpose, and then pass the subclass to 'setup()' as the 'distclass' keyword argument. If so, it is necessary to respect the expectations that 'setup' has of Distribution. See the code for 'setup()', in core.py, for details. """ # 'global_options' describes the command-line options that may be # supplied to the setup script prior to any actual commands. # Eg. "./setup.py -n" or "./setup.py --quiet" both take advantage of # these global options. This list should be kept to a bare minimum, # since every global option is also valid as a command option -- and we # don't want to pollute the commands with too many options that they # have minimal control over. # The fourth entry for verbose means that it can be repeated. global_options: ClassVar[_OptionsList] = [ ('verbose', 'v', "run verbosely (default)", 1), ('quiet', 'q', "run quietly (turns verbosity off)"), ('dry-run', 'n', "don't actually do anything"), ('help', 'h', "show detailed help message"), ('no-user-cfg', None, 'ignore pydistutils.cfg in your home directory'), ] # 'common_usage' is a short (2-3 line) string describing the common # usage of the setup script. common_usage: ClassVar[str] = """\ Common commands: (see '--help-commands' for more) setup.py build will build the package underneath 'build/' setup.py install will install the package """ # options that are not propagated to the commands display_options: ClassVar[_OptionsList] = [ ('help-commands', None, "list all available commands"), ('name', None, "print package name"), ('version', 'V', "print package version"), ('fullname', None, "print <package name>-<version>"), ('author', None, "print the author's name"), ('author-email', None, "print the author's email address"), ('maintainer', None, "print the maintainer's name"), ('maintainer-email', None, "print the maintainer's email address"), ('contact', None, "print the maintainer's name if known, else the author's"), ( 'contact-email', None, "print the maintainer's email address if known, else the author's", ), ('url', None, "print the URL for this package"), ('license', None, "print the license of the package"), ('licence', None, "alias for --license"), ('description', None, "print the package description"), ('long-description', None, "print the long package description"), ('platforms', None, "print the list of platforms"), ('classifiers', None, "print the list of classifiers"), ('keywords', None, "print the list of keywords"), ('provides', None, "print the list of packages/modules provided"), ('requires', None, "print the list of packages/modules required"), ('obsoletes', None, "print the list of packages/modules made obsolete"), ] display_option_names: ClassVar[list[str]] = [ translate_longopt(x[0]) for x in display_options ] # negative options are options that exclude other options negative_opt: ClassVar[dict[str, str]] = {'quiet': 'verbose'} # -- Creation/initialization methods ------------------------------- # Can't Unpack a TypedDict with optional properties, so using Any instead def __init__(self, attrs: MutableMapping[str, Any] | None = None) -> None: # noqa: C901 """Construct a new Distribution instance: initialize all the attributes of a Distribution, and then use 'attrs' (a dictionary mapping attribute names to values) to assign some of those attributes their "real" values. (Any attributes not mentioned in 'attrs' will be assigned to some null value: 0, None, an empty list or dictionary, etc.) Most importantly, initialize the 'command_obj' attribute to the empty dictionary; this will be filled in with real command objects by 'parse_command_line()'. """ # Default values for our command-line options self.verbose = True self.dry_run = False self.help = False for attr in self.display_option_names: setattr(self, attr, False) # Store the distribution meta-data (name, version, author, and so # forth) in a separate object -- we're getting to have enough # information here (and enough command-line options) that it's # worth it. Also delegate 'get_XXX()' methods to the 'metadata' # object in a sneaky and underhanded (but efficient!) way. self.metadata = DistributionMetadata() for basename in self.metadata._METHOD_BASENAMES: method_name = "get_" + basename setattr(self, method_name, getattr(self.metadata, method_name)) # 'cmdclass' maps command names to class objects, so we # can 1) quickly figure out which class to instantiate when # we need to create a new command object, and 2) have a way # for the setup script to override command classes self.cmdclass: dict[str, type[Command]] = {} # 'command_packages' is a list of packages in which commands # are searched for. The factory for command 'foo' is expected # to be named 'foo' in the module 'foo' in one of the packages # named here. This list is searched from the left; an error # is raised if no named package provides the command being # searched for. (Always access using get_command_packages().) self.command_packages: str | list[str] | None = None # 'script_name' and 'script_args' are usually set to sys.argv[0] # and sys.argv[1:], but they can be overridden when the caller is # not necessarily a setup script run from the command-line. self.script_name: str | os.PathLike[str] | None = None self.script_args: list[str] | None = None # 'command_options' is where we store command options between # parsing them (from config files, the command-line, etc.) and when # they are actually needed -- ie. when the command in question is # instantiated. It is a dictionary of dictionaries of 2-tuples: # command_options = { command_name : { option : (source, value) } } self.command_options: dict[str, dict[str, tuple[str, str]]] = {} # 'dist_files' is the list of (command, pyversion, file) that # have been created by any dist commands run so far. This is # filled regardless of whether the run is dry or not. pyversion # gives sysconfig.get_python_version() if the dist file is # specific to a Python version, 'any' if it is good for all # Python versions on the target platform, and '' for a source # file. pyversion should not be used to specify minimum or # maximum required Python versions; use the metainfo for that # instead. self.dist_files: list[tuple[str, str, str]] = [] # These options are really the business of various commands, rather # than of the Distribution itself. We provide aliases for them in # Distribution as a convenience to the developer. self.packages = None self.package_data: dict[str, list[str]] = {} self.package_dir = None self.py_modules = None self.libraries = None self.headers = None self.ext_modules = None self.ext_package = None self.include_dirs = None self.extra_path = None self.scripts = None self.data_files = None self.password = '' # And now initialize bookkeeping stuff that can't be supplied by # the caller at all. 'command_obj' maps command names to # Command instances -- that's how we enforce that every command # class is a singleton. self.command_obj: dict[str, Command] = {} # 'have_run' maps command names to boolean values; it keeps track # of whether we have actually run a particular command, to make it # cheap to "run" a command whenever we think we might need to -- if # it's already been done, no need for expensive filesystem # operations, we just check the 'have_run' dictionary and carry on. # It's only safe to query 'have_run' for a command class that has # been instantiated -- a false value will be inserted when the # command object is created, and replaced with a true value when # the command is successfully run. Thus it's probably best to use # '.get()' rather than a straight lookup. self.have_run: dict[str, bool] = {} # Now we'll use the attrs dictionary (ultimately, keyword args from # the setup script) to possibly override any or all of these # distribution options. if attrs: # Pull out the set of command options and work on them # specifically. Note that this order guarantees that aliased # command options will override any supplied redundantly # through the general options dictionary. options = attrs.get('options') if options is not None: del attrs['options'] for command, cmd_options in options.items(): opt_dict = self.get_option_dict(command) for opt, val in cmd_options.items(): opt_dict[opt] = ("setup script", val) if 'licence' in attrs: attrs['license'] = attrs['licence'] del attrs['licence'] msg = "'licence' distribution option is deprecated; use 'license'" warnings.warn(msg) # Now work on the rest of the attributes. Any attribute that's # not already defined is invalid! for key, val in attrs.items(): if hasattr(self.metadata, "set_" + key): getattr(self.metadata, "set_" + key)(val) elif hasattr(self.metadata, key): setattr(self.metadata, key, val) elif hasattr(self, key): setattr(self, key, val) else: msg = f"Unknown distribution option: {key!r}" warnings.warn(msg) # no-user-cfg is handled before other command line args # because other args override the config files, and this # one is needed before we can load the config files. # If attrs['script_args'] wasn't passed, assume false. # # This also make sure we just look at the global options self.want_user_cfg = True if self.script_args is not None: # Coerce any possible iterable from attrs into a list self.script_args = list(self.script_args) for arg in self.script_args: if not arg.startswith('-'): break if arg == '--no-user-cfg': self.want_user_cfg = False break self.finalize_options() def get_option_dict(self, command): """Get the option dictionary for a given command. If that command's option dictionary hasn't been created yet, then create it and return the new dictionary; otherwise, return the existing option dictionary. """ dict = self.command_options.get(command) if dict is None: dict = self.command_options[command] = {} return dict def dump_option_dicts(self, header=None, commands=None, indent: str = "") -> None: from pprint import pformat if commands is None: # dump all command option dicts commands = sorted(self.command_options.keys()) if header is not None: self.announce(indent + header) indent = indent + " " if not commands: self.announce(indent + "no commands known yet") return for cmd_name in commands: opt_dict = self.command_options.get(cmd_name) if opt_dict is None: self.announce(indent + f"no option dict for '{cmd_name}' command") else: self.announce(indent + f"option dict for '{cmd_name}' command:") out = pformat(opt_dict) for line in out.split('\n'): self.announce(indent + " " + line) # -- Config file finding/parsing methods --------------------------- def find_config_files(self): """Find as many configuration files as should be processed for this platform, and return a list of filenames in the order in which they should be parsed. The filenames returned are guaranteed to exist (modulo nasty race conditions). There are multiple possible config files: - distutils.cfg in the Distutils installation directory (i.e. where the top-level Distutils __inst__.py file lives) - a file in the user's home directory named .pydistutils.cfg on Unix and pydistutils.cfg on Windows/Mac; may be disabled with the ``--no-user-cfg`` option - setup.cfg in the current directory - a file named by an environment variable """ check_environ() files = [str(path) for path in self._gen_paths() if os.path.isfile(path)] if DEBUG: self.announce("using config files: {}".format(', '.join(files))) return files def _gen_paths(self): # The system-wide Distutils config file sys_dir = pathlib.Path(sys.modules['distutils'].__file__).parent yield sys_dir / "distutils.cfg" # The per-user config file prefix = '.' * (os.name == 'posix') filename = prefix + 'pydistutils.cfg' if self.want_user_cfg: with contextlib.suppress(RuntimeError): yield pathlib.Path('~').expanduser() / filename # All platforms support local setup.cfg yield pathlib.Path('setup.cfg') # Additional config indicated in the environment with contextlib.suppress(TypeError): yield pathlib.Path(os.getenv("DIST_EXTRA_CONFIG")) def parse_config_files(self, filenames=None): # noqa: C901 from configparser import ConfigParser # Ignore install directory options if we have a venv if sys.prefix != sys.base_prefix: ignore_options = [ 'install-base', 'install-platbase', 'install-lib', 'install-platlib', 'install-purelib', 'install-headers', 'install-scripts', 'install-data', 'prefix', 'exec-prefix', 'home', 'user', 'root', ] else: ignore_options = [] ignore_options = frozenset(ignore_options) if filenames is None: filenames = self.find_config_files() if DEBUG: self.announce("Distribution.parse_config_files():") parser = ConfigParser() for filename in filenames: if DEBUG: self.announce(f" reading {filename}") parser.read(filename, encoding='utf-8') for section in parser.sections(): options = parser.options(section) opt_dict = self.get_option_dict(section) for opt in options: if opt != '__name__' and opt not in ignore_options: val = parser.get(section, opt) opt = opt.replace('-', '_') opt_dict[opt] = (filename, val) # Make the ConfigParser forget everything (so we retain # the original filenames that options come from) parser.__init__() # If there was a "global" section in the config file, use it # to set Distribution options. if 'global' in self.command_options: for opt, (_src, val) in self.command_options['global'].items(): alias = self.negative_opt.get(opt) try: if alias: setattr(self, alias, not strtobool(val)) elif opt in ('verbose', 'dry_run'): # ugh! setattr(self, opt, strtobool(val)) else: setattr(self, opt, val) except ValueError as msg: raise DistutilsOptionError(msg) # -- Command-line parsing methods ---------------------------------- def parse_command_line(self): """Parse the setup script's command line, taken from the 'script_args' instance attribute (which defaults to 'sys.argv[1:]' -- see 'setup()' in core.py). This list is first processed for "global options" -- options that set attributes of the Distribution instance. Then, it is alternately scanned for Distutils commands and options for that command. Each new command terminates the options for the previous command. The allowed options for a command are determined by the 'user_options' attribute of the command class -- thus, we have to be able to load command classes in order to parse the command line. Any error in that 'options' attribute raises DistutilsGetoptError; any error on the command-line raises DistutilsArgError. If no Distutils commands were found on the command line, raises DistutilsArgError. Return true if command-line was successfully parsed and we should carry on with executing commands; false if no errors but we shouldn't execute commands (currently, this only happens if user asks for help). """ # # We now have enough information to show the Macintosh dialog # that allows the user to interactively specify the "command line". # toplevel_options = self._get_toplevel_options() # We have to parse the command line a bit at a time -- global # options, then the first command, then its options, and so on -- # because each command will be handled by a different class, and # the options that are valid for a particular class aren't known # until we have loaded the command class, which doesn't happen # until we know what the command is. self.commands = [] parser = FancyGetopt(toplevel_options + self.display_options) parser.set_negative_aliases(self.negative_opt) parser.set_aliases({'licence': 'license'}) args = parser.getopt(args=self.script_args, object=self) option_order = parser.get_option_order() logging.getLogger().setLevel(logging.WARN - 10 * self.verbose) # for display options we return immediately if self.handle_display_options(option_order): return while args: args = self._parse_command_opts(parser, args) if args is None: # user asked for help (and got it) return # Handle the cases of --help as a "global" option, ie. # "setup.py --help" and "setup.py --help command ...". For the # former, we show global options (--verbose, --dry-run, etc.) # and display-only options (--name, --version, etc.); for the # latter, we omit the display-only options and show help for # each command listed on the command line. if self.help: self._show_help( parser, display_options=len(self.commands) == 0, commands=self.commands ) return # Oops, no commands found -- an end-user error if not self.commands: raise DistutilsArgError("no commands supplied") # All is well: return true return True def _get_toplevel_options(self): """Return the non-display options recognized at the top level. This includes options that are recognized *only* at the top level as well as options recognized for commands. """ return self.global_options + [ ( "command-packages=", None, "list of packages that provide distutils commands", ), ] def _parse_command_opts(self, parser, args): # noqa: C901 """Parse the command-line options for a single command. 'parser' must be a FancyGetopt instance; 'args' must be the list of arguments, starting with the current command (whose options we are about to parse). Returns a new version of 'args' with the next command at the front of the list; will be the empty list if there are no more commands on the command line. Returns None if the user asked for help on this command. """ # late import because of mutual dependence between these modules from distutils.cmd import Command # Pull the current command from the head of the command line command = args[0] if not command_re.match(command): raise SystemExit(f"invalid command name '{command}'") self.commands.append(command) # Dig up the command class that implements this command, so we # 1) know that it's a valid command, and 2) know which options # it takes. try: cmd_class = self.get_command_class(command) except DistutilsModuleError as msg: raise DistutilsArgError(msg) # Require that the command class be derived from Command -- want # to be sure that the basic "command" interface is implemented. if not issubclass(cmd_class, Command): raise DistutilsClassError( f"command class {cmd_class} must subclass Command" ) # Also make sure that the command object provides a list of its # known options. if not ( hasattr(cmd_class, 'user_options') and isinstance(cmd_class.user_options, list) ): msg = ( "command class %s must provide " "'user_options' attribute (a list of tuples)" ) raise DistutilsClassError(msg % cmd_class) # If the command class has a list of negative alias options, # merge it in with the global negative aliases. negative_opt = self.negative_opt if hasattr(cmd_class, 'negative_opt'): negative_opt = negative_opt.copy() negative_opt.update(cmd_class.negative_opt) # Check for help_options in command class. They have a different # format (tuple of four) so we need to preprocess them here. if hasattr(cmd_class, 'help_options') and isinstance( cmd_class.help_options, list ): help_options = fix_help_options(cmd_class.help_options) else: help_options = [] # All commands support the global options too, just by adding # in 'global_options'. parser.set_option_table( self.global_options + cmd_class.user_options + help_options ) parser.set_negative_aliases(negative_opt) (args, opts) = parser.getopt(args[1:]) if hasattr(opts, 'help') and opts.help: self._show_help(parser, display_options=False, commands=[cmd_class]) return if hasattr(cmd_class, 'help_options') and isinstance( cmd_class.help_options, list ): help_option_found = 0 for help_option, _short, _desc, func in cmd_class.help_options: if hasattr(opts, parser.get_attr_name(help_option)): help_option_found = 1 if callable(func): func() else: raise DistutilsClassError( f"invalid help function {func!r} for help option '{help_option}': " "must be a callable object (function, etc.)" ) if help_option_found: return # Put the options from the command-line into their official # holding pen, the 'command_options' dictionary. opt_dict = self.get_option_dict(command) for name, value in vars(opts).items(): opt_dict[name] = ("command line", value) return args def finalize_options(self) -> None: """Set final values for all the options on the Distribution instance, analogous to the .finalize_options() method of Command objects. """ for attr in ('keywords', 'platforms'): value = getattr(self.metadata, attr) if value is None: continue if isinstance(value, str): value = [elm.strip() for elm in value.split(',')] setattr(self.metadata, attr, value) def _show_help( self, parser, global_options=True, display_options=True, commands: Iterable = () ): """Show help for the setup script command-line in the form of several lists of command-line options. 'parser' should be a FancyGetopt instance; do not expect it to be returned in the same state, as its option table will be reset to make it generate the correct help text. If 'global_options' is true, lists the global options: --verbose, --dry-run, etc. If 'display_options' is true, lists the "display-only" options: --name, --version, etc. Finally, lists per-command help for every command name or command class in 'commands'. """ # late import because of mutual dependence between these modules from distutils.cmd import Command from distutils.core import gen_usage if global_options: if display_options: options = self._get_toplevel_options() else: options = self.global_options parser.set_option_table(options) parser.print_help(self.common_usage + "\nGlobal options:") print() if display_options: parser.set_option_table(self.display_options) parser.print_help( "Information display options (just display information, ignore any commands)" ) print() for command in commands: if isinstance(command, type) and issubclass(command, Command): klass = command else: klass = self.get_command_class(command) if hasattr(klass, 'help_options') and isinstance(klass.help_options, list): parser.set_option_table( klass.user_options + fix_help_options(klass.help_options) ) else: parser.set_option_table(klass.user_options) parser.print_help(f"Options for '{klass.__name__}' command:") print() print(gen_usage(self.script_name)) def handle_display_options(self, option_order): """If there were any non-global "display-only" options (--help-commands or the metadata display options) on the command line, display the requested info and return true; else return false. """ from distutils.core import gen_usage # User just wants a list of commands -- we'll print it out and stop # processing now (ie. if they ran "setup --help-commands foo bar", # we ignore "foo bar"). if self.help_commands: self.print_commands() print() print(gen_usage(self.script_name)) return 1 # If user supplied any of the "display metadata" options, then # display that metadata in the order in which the user supplied the # metadata options. any_display_options = 0 is_display_option = set() for option in self.display_options: is_display_option.add(option[0]) for opt, val in option_order: if val and opt in is_display_option: opt = translate_longopt(opt) value = getattr(self.metadata, "get_" + opt)() if opt in ('keywords', 'platforms'): print(','.join(value)) elif opt in ('classifiers', 'provides', 'requires', 'obsoletes'): print('\n'.join(value)) else: print(value) any_display_options = 1 return any_display_options def print_command_list(self, commands, header, max_length) -> None: """Print a subset of the list of all commands -- used by 'print_commands()'. """ print(header + ":") for cmd in commands: klass = self.cmdclass.get(cmd) if not klass: klass = self.get_command_class(cmd) try: description = klass.description except AttributeError: description = "(no description available)" print(f" {cmd:<{max_length}} {description}") def print_commands(self) -> None: """Print out a help message listing all available commands with a description of each. The list is divided into "standard commands" (listed in distutils.command.__all__) and "extra commands" (mentioned in self.cmdclass, but not a standard command). The descriptions come from the command class attribute 'description'. """ import distutils.command std_commands = distutils.command.__all__ is_std = set(std_commands) extra_commands = [cmd for cmd in self.cmdclass.keys() if cmd not in is_std] max_length = 0 for cmd in std_commands + extra_commands: if len(cmd) > max_length: max_length = len(cmd) self.print_command_list(std_commands, "Standard commands", max_length) if extra_commands: print() self.print_command_list(extra_commands, "Extra commands", max_length) def get_command_list(self): """Get a list of (command, description) tuples. The list is divided into "standard commands" (listed in distutils.command.__all__) and "extra commands" (mentioned in self.cmdclass, but not a standard command). The descriptions come from the command class attribute 'description'. """ # Currently this is only used on Mac OS, for the Mac-only GUI # Distutils interface (by Jack Jansen) import distutils.command std_commands = distutils.command.__all__ is_std = set(std_commands) extra_commands = [cmd for cmd in self.cmdclass.keys() if cmd not in is_std] rv = [] for cmd in std_commands + extra_commands: klass = self.cmdclass.get(cmd) if not klass: klass = self.get_command_class(cmd) try: description = klass.description except AttributeError: description = "(no description available)" rv.append((cmd, description)) return rv # -- Command class/object methods ---------------------------------- def get_command_packages(self): """Return a list of packages from which commands are loaded.""" pkgs = self.command_packages if not isinstance(pkgs, list): if pkgs is None: pkgs = '' pkgs = [pkg.strip() for pkg in pkgs.split(',') if pkg != ''] if "distutils.command" not in pkgs: pkgs.insert(0, "distutils.command") self.command_packages = pkgs return pkgs def get_command_class(self, command: str) -> type[Command]: """Return the class that implements the Distutils command named by 'command'. First we check the 'cmdclass' dictionary; if the command is mentioned there, we fetch the class object from the dictionary and return it. Otherwise we load the command module ("distutils.command." + command) and fetch the command class from the module. The loaded class is also stored in 'cmdclass' to speed future calls to 'get_command_class()'. Raises DistutilsModuleError if the expected module could not be found, or if that module does not define the expected class. """ klass = self.cmdclass.get(command) if klass: return klass for pkgname in self.get_command_packages(): module_name = f"{pkgname}.{command}" klass_name = command try: __import__(module_name) module = sys.modules[module_name] except ImportError: continue try: klass = getattr(module, klass_name) except AttributeError: raise DistutilsModuleError( f"invalid command '{command}' (no class '{klass_name}' in module '{module_name}')" ) self.cmdclass[command] = klass return klass raise DistutilsModuleError(f"invalid command '{command}'") @overload def get_command_obj( self, command: str, create: Literal[True] = True ) -> Command: ... @overload def get_command_obj( self, command: str, create: Literal[False] ) -> Command | None: ... def get_command_obj(self, command: str, create: bool = True) -> Command | None: """Return the command object for 'command'. Normally this object is cached on a previous call to 'get_command_obj()'; if no command object for 'command' is in the cache, then we either create and return it (if 'create' is true) or return None. """ cmd_obj = self.command_obj.get(command) if not cmd_obj and create: if DEBUG: self.announce( "Distribution.get_command_obj(): " f"creating '{command}' command object" ) klass = self.get_command_class(command) cmd_obj = self.command_obj[command] = klass(self) self.have_run[command] = False # Set any options that were supplied in config files # or on the command line. (NB. support for error # reporting is lame here: any errors aren't reported # until 'finalize_options()' is called, which means # we won't report the source of the error.) options = self.command_options.get(command) if options: self._set_command_options(cmd_obj, options) return cmd_obj def _set_command_options(self, command_obj, option_dict=None): # noqa: C901 """Set the options for 'command_obj' from 'option_dict'. Basically this means copying elements of a dictionary ('option_dict') to attributes of an instance ('command'). 'command_obj' must be a Command instance. If 'option_dict' is not supplied, uses the standard option dictionary for this command (from 'self.command_options'). """ command_name = command_obj.get_command_name() if option_dict is None: option_dict = self.get_option_dict(command_name) if DEBUG: self.announce(f" setting options for '{command_name}' command:") for option, (source, value) in option_dict.items(): if DEBUG: self.announce(f" {option} = {value} (from {source})") try: bool_opts = [translate_longopt(o) for o in command_obj.boolean_options] except AttributeError: bool_opts = [] try: neg_opt = command_obj.negative_opt except AttributeError: neg_opt = {} try: is_string = isinstance(value, str) if option in neg_opt and is_string: setattr(command_obj, neg_opt[option], not strtobool(value)) elif option in bool_opts and is_string: setattr(command_obj, option, strtobool(value)) elif hasattr(command_obj, option): setattr(command_obj, option, value) else: raise DistutilsOptionError( f"error in {source}: command '{command_name}' has no such option '{option}'" ) except ValueError as msg: raise DistutilsOptionError(msg) @overload def reinitialize_command( self, command: str, reinit_subcommands: bool = False ) -> Command: ... @overload def reinitialize_command( self, command: _CommandT, reinit_subcommands: bool = False ) -> _CommandT: ... def reinitialize_command( self, command: str | Command, reinit_subcommands=False ) -> Command: """Reinitializes a command to the state it was in when first returned by 'get_command_obj()': ie., initialized but not yet finalized. This provides the opportunity to sneak option values in programmatically, overriding or supplementing user-supplied values from the config files and command line. You'll have to re-finalize the command object (by calling 'finalize_options()' or 'ensure_finalized()') before using it for real. 'command' should be a command name (string) or command object. If 'reinit_subcommands' is true, also reinitializes the command's sub-commands, as declared by the 'sub_commands' class attribute (if it has one). See the "install" command for an example. Only reinitializes the sub-commands that actually matter, ie. those whose test predicates return true. Returns the reinitialized command object. """ from distutils.cmd import Command if not isinstance(command, Command): command_name = command command = self.get_command_obj(command_name) else: command_name = command.get_command_name() if not command.finalized: return command command.initialize_options() command.finalized = False self.have_run[command_name] = False self._set_command_options(command) if reinit_subcommands: for sub in command.get_sub_commands(): self.reinitialize_command(sub, reinit_subcommands) return command # -- Methods that operate on the Distribution ---------------------- def announce(self, msg, level: int = logging.INFO) -> None: log.log(level, msg) def run_commands(self) -> None: """Run each command that was seen on the setup script command line. Uses the list of commands found and cache of command objects created by 'get_command_obj()'. """ for cmd in self.commands: self.run_command(cmd) # -- Methods that operate on its Commands -------------------------- def run_command(self, command: str) -> None: """Do whatever it takes to run a command (including nothing at all, if the command has already been run). Specifically: if we have already created and run the command named by 'command', return silently without doing anything. If the command named by 'command' doesn't even have a command object yet, create one. Then invoke 'run()' on that command object (or an existing one). """ # Already been here, done that? then return silently. if self.have_run.get(command): return log.info("running %s", command) cmd_obj = self.get_command_obj(command) cmd_obj.ensure_finalized() cmd_obj.run() self.have_run[command] = True # -- Distribution query methods ------------------------------------ def has_pure_modules(self) -> bool: return len(self.packages or self.py_modules or []) > 0 def has_ext_modules(self) -> bool: return self.ext_modules and len(self.ext_modules) > 0 def has_c_libraries(self) -> bool: return self.libraries and len(self.libraries) > 0 def has_modules(self) -> bool: return self.has_pure_modules() or self.has_ext_modules() def has_headers(self) -> bool: return self.headers and len(self.headers) > 0 def has_scripts(self) -> bool: return self.scripts and len(self.scripts) > 0 def has_data_files(self) -> bool: return self.data_files and len(self.data_files) > 0 def is_pure(self) -> bool: return ( self.has_pure_modules() and not self.has_ext_modules() and not self.has_c_libraries() ) # -- Metadata query methods ---------------------------------------- # If you're looking for 'get_name()', 'get_version()', and so forth, # they are defined in a sneaky way: the constructor binds self.get_XXX # to self.metadata.get_XXX. The actual code is in the # DistributionMetadata class, below. if TYPE_CHECKING: # Unfortunately this means we need to specify them manually or not expose statically def _(self) -> None: self.get_name = self.metadata.get_name self.get_version = self.metadata.get_version self.get_fullname = self.metadata.get_fullname self.get_author = self.metadata.get_author self.get_author_email = self.metadata.get_author_email self.get_maintainer = self.metadata.get_maintainer self.get_maintainer_email = self.metadata.get_maintainer_email self.get_contact = self.metadata.get_contact self.get_contact_email = self.metadata.get_contact_email self.get_url = self.metadata.get_url self.get_license = self.metadata.get_license self.get_licence = self.metadata.get_licence self.get_description = self.metadata.get_description self.get_long_description = self.metadata.get_long_description self.get_keywords = self.metadata.get_keywords self.get_platforms = self.metadata.get_platforms self.get_classifiers = self.metadata.get_classifiers self.get_download_url = self.metadata.get_download_url self.get_requires = self.metadata.get_requires self.get_provides = self.metadata.get_provides self.get_obsoletes = self.metadata.get_obsoletes # Default attributes generated in __init__ from self.display_option_names help_commands: bool name: str | Literal[False] version: str | Literal[False] fullname: str | Literal[False] author: str | Literal[False] author_email: str | Literal[False] maintainer: str | Literal[False] maintainer_email: str | Literal[False] contact: str | Literal[False] contact_email: str | Literal[False] url: str | Literal[False] license: str | Literal[False] licence: str | Literal[False] description: str | Literal[False] long_description: str | Literal[False] platforms: str | list[str] | Literal[False] classifiers: str | list[str] | Literal[False] keywords: str | list[str] | Literal[False] provides: list[str] | Literal[False] requires: list[str] | Literal[False] obsoletes: list[str] | Literal[False] class DistributionMetadata: """Dummy class to hold the distribution meta-data: name, version, author, and so forth. """ _METHOD_BASENAMES = ( "name", "version", "author", "author_email", "maintainer", "maintainer_email", "url", "license", "description", "long_description", "keywords", "platforms", "fullname", "contact", "contact_email", "classifiers", "download_url", # PEP 314 "provides", "requires", "obsoletes", ) def __init__( self, path: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None ) -> None: if path is not None: self.read_pkg_file(open(path)) else: self.name: str | None = None self.version: str | None = None self.author: str | None = None self.author_email: str | None = None self.maintainer: str | None = None self.maintainer_email: str | None = None self.url: str | None = None self.license: str | None = None self.description: str | None = None self.long_description: str | None = None self.keywords: str | list[str] | None = None self.platforms: str | list[str] | None = None self.classifiers: str | list[str] | None = None self.download_url: str | None = None # PEP 314 self.provides: str | list[str] | None = None self.requires: str | list[str] | None = None self.obsoletes: str | list[str] | None = None def read_pkg_file(self, file: IO[str]) -> None: """Reads the metadata values from a file object.""" msg = message_from_file(file) def _read_field(name: str) -> str | None: value = msg[name] if value and value != "UNKNOWN": return value return None def _read_list(name): values = msg.get_all(name, None) if values == []: return None return values metadata_version = msg['metadata-version'] self.name = _read_field('name') self.version = _read_field('version') self.description = _read_field('summary') # we are filling author only. self.author = _read_field('author') self.maintainer = None self.author_email = _read_field('author-email') self.maintainer_email = None self.url = _read_field('home-page') self.license = _read_field('license') if 'download-url' in msg: self.download_url = _read_field('download-url') else: self.download_url = None self.long_description = _read_field('description') self.description = _read_field('summary') if 'keywords' in msg: self.keywords = _read_field('keywords').split(',') self.platforms = _read_list('platform') self.classifiers = _read_list('classifier') # PEP 314 - these fields only exist in 1.1 if metadata_version == '1.1': self.requires = _read_list('requires') self.provides = _read_list('provides') self.obsoletes = _read_list('obsoletes') else: self.requires = None self.provides = None self.obsoletes = None def write_pkg_info(self, base_dir: str | os.PathLike[str]) -> None: """Write the PKG-INFO file into the release tree.""" with open( os.path.join(base_dir, 'PKG-INFO'), 'w', encoding='UTF-8' ) as pkg_info: self.write_pkg_file(pkg_info) def write_pkg_file(self, file: SupportsWrite[str]) -> None: """Write the PKG-INFO format data to a file object.""" version = '1.0' if ( self.provides or self.requires or self.obsoletes or self.classifiers or self.download_url ): version = '1.1' # required fields file.write(f'Metadata-Version: {version}\n') file.write(f'Name: {self.get_name()}\n') file.write(f'Version: {self.get_version()}\n') def maybe_write(header, val): if val: file.write(f"{header}: {val}\n") # optional fields maybe_write("Summary", self.get_description()) maybe_write("Home-page", self.get_url()) maybe_write("Author", self.get_contact()) maybe_write("Author-email", self.get_contact_email()) maybe_write("License", self.get_license()) maybe_write("Download-URL", self.download_url) maybe_write("Description", rfc822_escape(self.get_long_description() or "")) maybe_write("Keywords", ",".join(self.get_keywords())) self._write_list(file, 'Platform', self.get_platforms()) self._write_list(file, 'Classifier', self.get_classifiers()) # PEP 314 self._write_list(file, 'Requires', self.get_requires()) self._write_list(file, 'Provides', self.get_provides()) self._write_list(file, 'Obsoletes', self.get_obsoletes()) def _write_list(self, file, name, values): values = values or [] for value in values: file.write(f'{name}: {value}\n') # -- Metadata query methods ---------------------------------------- def get_name(self) -> str: return self.name or "UNKNOWN" def get_version(self) -> str: return self.version or "0.0.0" def get_fullname(self) -> str: return self._fullname(self.get_name(), self.get_version()) @staticmethod def _fullname(name: str, version: str) -> str: """ >>> DistributionMetadata._fullname('setup.tools', '1.0-2') 'setup_tools-1.0.post2' >>> DistributionMetadata._fullname('setup-tools', '1.2post2') 'setup_tools-1.2.post2' >>> DistributionMetadata._fullname('setup-tools', '1.0-r2') 'setup_tools-1.0.post2' >>> DistributionMetadata._fullname('setup.tools', '1.0.post') 'setup_tools-1.0.post0' >>> DistributionMetadata._fullname('setup.tools', '1.0+ubuntu-1') 'setup_tools-1.0+ubuntu.1' """ return "{}-{}".format( canonicalize_name(name).replace('-', '_'), canonicalize_version(version, strip_trailing_zero=False), ) def get_author(self) -> str | None: return self.author def get_author_email(self) -> str | None: return self.author_email def get_maintainer(self) -> str | None: return self.maintainer def get_maintainer_email(self) -> str | None: return self.maintainer_email def get_contact(self) -> str | None: return self.maintainer or self.author def get_contact_email(self) -> str | None: return self.maintainer_email or self.author_email def get_url(self) -> str | None: return self.url def get_license(self) -> str | None: return self.license get_licence = get_license def get_description(self) -> str | None: return self.description def get_long_description(self) -> str | None: return self.long_description def get_keywords(self) -> str | list[str]: return self.keywords or [] def set_keywords(self, value: str | Iterable[str]) -> None: self.keywords = _ensure_list(value, 'keywords') def get_platforms(self) -> str | list[str] | None: return self.platforms def set_platforms(self, value: str | Iterable[str]) -> None: self.platforms = _ensure_list(value, 'platforms') def get_classifiers(self) -> str | list[str]: return self.classifiers or [] def set_classifiers(self, value: str | Iterable[str]) -> None: self.classifiers = _ensure_list(value, 'classifiers') def get_download_url(self) -> str | None: return self.download_url # PEP 314 def get_requires(self) -> str | list[str]: return self.requires or [] def set_requires(self, value: Iterable[str]) -> None: import distutils.versionpredicate for v in value: distutils.versionpredicate.VersionPredicate(v) self.requires = list(value) def get_provides(self) -> str | list[str]: return self.provides or [] def set_provides(self, value: Iterable[str]) -> None: value = [v.strip() for v in value] for v in value: import distutils.versionpredicate distutils.versionpredicate.split_provision(v) self.provides = value def get_obsoletes(self) -> str | list[str]: return self.obsoletes or [] def set_obsoletes(self, value: Iterable[str]) -> None: import distutils.versionpredicate for v in value: distutils.versionpredicate.VersionPredicate(v) self.obsoletes = list(value) def fix_help_options(options): """Convert a 4-tuple 'help_options' list as found in various command classes to the 3-tuple form required by FancyGetopt. """ return [opt[0:3] for opt in options] _distutils/version.py 0000644 00000030513 15030122015 0010755 0 ustar 00 # # distutils/version.py # # Implements multiple version numbering conventions for the # Python Module Distribution Utilities. # # $Id$ # """Provides classes to represent module version numbers (one class for each style of version numbering). There are currently two such classes implemented: StrictVersion and LooseVersion. Every version number class implements the following interface: * the 'parse' method takes a string and parses it to some internal representation; if the string is an invalid version number, 'parse' raises a ValueError exception * the class constructor takes an optional string argument which, if supplied, is passed to 'parse' * __str__ reconstructs the string that was passed to 'parse' (or an equivalent string -- ie. one that will generate an equivalent version number instance) * __repr__ generates Python code to recreate the version number instance * _cmp compares the current instance with either another instance of the same class or a string (which will be parsed to an instance of the same class, thus must follow the same rules) """ import contextlib import re import warnings @contextlib.contextmanager def suppress_known_deprecation(): with warnings.catch_warnings(record=True) as ctx: warnings.filterwarnings( action='default', category=DeprecationWarning, message="distutils Version classes are deprecated.", ) yield ctx class Version: """Abstract base class for version numbering classes. Just provides constructor (__init__) and reproducer (__repr__), because those seem to be the same for all version numbering classes; and route rich comparisons to _cmp. """ def __init__(self, vstring=None): if vstring: self.parse(vstring) warnings.warn( "distutils Version classes are deprecated. Use packaging.version instead.", DeprecationWarning, stacklevel=2, ) def __repr__(self): return f"{self.__class__.__name__} ('{self}')" def __eq__(self, other): c = self._cmp(other) if c is NotImplemented: return c return c == 0 def __lt__(self, other): c = self._cmp(other) if c is NotImplemented: return c return c < 0 def __le__(self, other): c = self._cmp(other) if c is NotImplemented: return c return c <= 0 def __gt__(self, other): c = self._cmp(other) if c is NotImplemented: return c return c > 0 def __ge__(self, other): c = self._cmp(other) if c is NotImplemented: return c return c >= 0 # Interface for version-number classes -- must be implemented # by the following classes (the concrete ones -- Version should # be treated as an abstract class). # __init__ (string) - create and take same action as 'parse' # (string parameter is optional) # parse (string) - convert a string representation to whatever # internal representation is appropriate for # this style of version numbering # __str__ (self) - convert back to a string; should be very similar # (if not identical to) the string supplied to parse # __repr__ (self) - generate Python code to recreate # the instance # _cmp (self, other) - compare two version numbers ('other' may # be an unparsed version string, or another # instance of your version class) class StrictVersion(Version): """Version numbering for anal retentives and software idealists. Implements the standard interface for version number classes as described above. A version number consists of two or three dot-separated numeric components, with an optional "pre-release" tag on the end. The pre-release tag consists of the letter 'a' or 'b' followed by a number. If the numeric components of two version numbers are equal, then one with a pre-release tag will always be deemed earlier (lesser) than one without. The following are valid version numbers (shown in the order that would be obtained by sorting according to the supplied cmp function): 0.4 0.4.0 (these two are equivalent) 0.4.1 0.5a1 0.5b3 0.5 0.9.6 1.0 1.0.4a3 1.0.4b1 1.0.4 The following are examples of invalid version numbers: 1 2.7.2.2 1.3.a4 1.3pl1 1.3c4 The rationale for this version numbering system will be explained in the distutils documentation. """ version_re = re.compile( r'^(\d+) \. (\d+) (\. (\d+))? ([ab](\d+))?$', re.VERBOSE | re.ASCII ) def parse(self, vstring): match = self.version_re.match(vstring) if not match: raise ValueError(f"invalid version number '{vstring}'") (major, minor, patch, prerelease, prerelease_num) = match.group(1, 2, 4, 5, 6) if patch: self.version = tuple(map(int, [major, minor, patch])) else: self.version = tuple(map(int, [major, minor])) + (0,) if prerelease: self.prerelease = (prerelease[0], int(prerelease_num)) else: self.prerelease = None def __str__(self): if self.version[2] == 0: vstring = '.'.join(map(str, self.version[0:2])) else: vstring = '.'.join(map(str, self.version)) if self.prerelease: vstring = vstring + self.prerelease[0] + str(self.prerelease[1]) return vstring def _cmp(self, other): if isinstance(other, str): with suppress_known_deprecation(): other = StrictVersion(other) elif not isinstance(other, StrictVersion): return NotImplemented if self.version == other.version: # versions match; pre-release drives the comparison return self._cmp_prerelease(other) return -1 if self.version < other.version else 1 def _cmp_prerelease(self, other): """ case 1: self has prerelease, other doesn't; other is greater case 2: self doesn't have prerelease, other does: self is greater case 3: both or neither have prerelease: compare them! """ if self.prerelease and not other.prerelease: return -1 elif not self.prerelease and other.prerelease: return 1 if self.prerelease == other.prerelease: return 0 elif self.prerelease < other.prerelease: return -1 else: return 1 # end class StrictVersion # The rules according to Greg Stein: # 1) a version number has 1 or more numbers separated by a period or by # sequences of letters. If only periods, then these are compared # left-to-right to determine an ordering. # 2) sequences of letters are part of the tuple for comparison and are # compared lexicographically # 3) recognize the numeric components may have leading zeroes # # The LooseVersion class below implements these rules: a version number # string is split up into a tuple of integer and string components, and # comparison is a simple tuple comparison. This means that version # numbers behave in a predictable and obvious way, but a way that might # not necessarily be how people *want* version numbers to behave. There # wouldn't be a problem if people could stick to purely numeric version # numbers: just split on period and compare the numbers as tuples. # However, people insist on putting letters into their version numbers; # the most common purpose seems to be: # - indicating a "pre-release" version # ('alpha', 'beta', 'a', 'b', 'pre', 'p') # - indicating a post-release patch ('p', 'pl', 'patch') # but of course this can't cover all version number schemes, and there's # no way to know what a programmer means without asking him. # # The problem is what to do with letters (and other non-numeric # characters) in a version number. The current implementation does the # obvious and predictable thing: keep them as strings and compare # lexically within a tuple comparison. This has the desired effect if # an appended letter sequence implies something "post-release": # eg. "0.99" < "0.99pl14" < "1.0", and "5.001" < "5.001m" < "5.002". # # However, if letters in a version number imply a pre-release version, # the "obvious" thing isn't correct. Eg. you would expect that # "1.5.1" < "1.5.2a2" < "1.5.2", but under the tuple/lexical comparison # implemented here, this just isn't so. # # Two possible solutions come to mind. The first is to tie the # comparison algorithm to a particular set of semantic rules, as has # been done in the StrictVersion class above. This works great as long # as everyone can go along with bondage and discipline. Hopefully a # (large) subset of Python module programmers will agree that the # particular flavour of bondage and discipline provided by StrictVersion # provides enough benefit to be worth using, and will submit their # version numbering scheme to its domination. The free-thinking # anarchists in the lot will never give in, though, and something needs # to be done to accommodate them. # # Perhaps a "moderately strict" version class could be implemented that # lets almost anything slide (syntactically), and makes some heuristic # assumptions about non-digits in version number strings. This could # sink into special-case-hell, though; if I was as talented and # idiosyncratic as Larry Wall, I'd go ahead and implement a class that # somehow knows that "1.2.1" < "1.2.2a2" < "1.2.2" < "1.2.2pl3", and is # just as happy dealing with things like "2g6" and "1.13++". I don't # think I'm smart enough to do it right though. # # In any case, I've coded the test suite for this module (see # ../test/test_version.py) specifically to fail on things like comparing # "1.2a2" and "1.2". That's not because the *code* is doing anything # wrong, it's because the simple, obvious design doesn't match my # complicated, hairy expectations for real-world version numbers. It # would be a snap to fix the test suite to say, "Yep, LooseVersion does # the Right Thing" (ie. the code matches the conception). But I'd rather # have a conception that matches common notions about version numbers. class LooseVersion(Version): """Version numbering for anarchists and software realists. Implements the standard interface for version number classes as described above. A version number consists of a series of numbers, separated by either periods or strings of letters. When comparing version numbers, the numeric components will be compared numerically, and the alphabetic components lexically. The following are all valid version numbers, in no particular order: 1.5.1 1.5.2b2 161 3.10a 8.02 3.4j 1996.07.12 3.2.pl0 3.1.1.6 2g6 11g 0.960923 2.2beta29 1.13++ 5.5.kw 2.0b1pl0 In fact, there is no such thing as an invalid version number under this scheme; the rules for comparison are simple and predictable, but may not always give the results you want (for some definition of "want"). """ component_re = re.compile(r'(\d+ | [a-z]+ | \.)', re.VERBOSE) def parse(self, vstring): # I've given up on thinking I can reconstruct the version string # from the parsed tuple -- so I just store the string here for # use by __str__ self.vstring = vstring components = [x for x in self.component_re.split(vstring) if x and x != '.'] for i, obj in enumerate(components): try: components[i] = int(obj) except ValueError: pass self.version = components def __str__(self): return self.vstring def __repr__(self): return f"LooseVersion ('{self}')" def _cmp(self, other): if isinstance(other, str): other = LooseVersion(other) elif not isinstance(other, LooseVersion): return NotImplemented if self.version == other.version: return 0 if self.version < other.version: return -1 if self.version > other.version: return 1 # end class LooseVersion _distutils/spawn.py 0000644 00000007766 15030122015 0010436 0 ustar 00 """distutils.spawn Provides the 'spawn()' function, a front-end to various platform- specific functions for launching another program in a sub-process. """ from __future__ import annotations import os import platform import shutil import subprocess import sys import warnings 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): """ Render a subprocess command differently depending on DEBUG. """ return cmd if DEBUG else cmd[0] def _inject_macos_ver(env: _MappingT | None) -> _MappingT | dict[str, str | int] | None: if platform.system() != 'Darwin': return env from .util import MACOSX_VERSION_VAR, get_macosx_target_ver target_ver = get_macosx_target_ver() update = {MACOSX_VERSION_VAR: target_ver} if target_ver else {} return {**_resolve(env), **update} @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: 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. cmd[0] is the program to run and cmd[1:] are the rest of its arguments. There is no way to run a program with a name different from that of its executable. If 'search_path' is true (the default), the system's executable search path will be used to find the program; otherwise, cmd[0] must be the exact path to the executable. If 'dry_run' is true, the command will not actually be run. Raise DistutilsExecError if running the program fails in any way; just return on success. """ log.info(subprocess.list2cmdline(cmd)) if dry_run: return if search_path: executable = shutil.which(cmd[0]) if executable is not None: cmd[0] = executable try: subprocess.check_call(cmd, env=_inject_macos_ver(env)) except OSError as exc: raise DistutilsExecError( f"command {_debug(cmd)!r} failed: {exc.args[-1]}" ) from exc except subprocess.CalledProcessError as err: raise DistutilsExecError( f"command {_debug(cmd)!r} failed with exit code {err.returncode}" ) from err 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 os.environ['PATH']. Returns the complete filename or None if not found. """ warnings.warn( 'Use shutil.which instead of find_executable', DeprecationWarning, stacklevel=2 ) _, ext = os.path.splitext(executable) if (sys.platform == 'win32') and (ext != '.exe'): executable = executable + '.exe' if os.path.isfile(executable): return executable if path is None: path = os.environ.get('PATH', None) # bpo-35755: Don't fall through if PATH is the empty string if path is None: try: path = os.confstr("CS_PATH") except (AttributeError, ValueError): # os.confstr() or CS_PATH is not available path = os.defpath # PATH='' doesn't match, whereas PATH=':' looks in the current directory if not path: return None paths = path.split(os.pathsep) for p in paths: f = os.path.join(p, executable) if os.path.isfile(f): # the file exists, we have a shot at spawn working return f return None _distutils/_msvccompiler.py 0000644 00000000517 15030122015 0012133 0 ustar 00 import warnings from .compilers.C import msvc __all__ = ["MSVCCompiler"] MSVCCompiler = msvc.Compiler def __getattr__(name): if name == '_get_vc_env': warnings.warn( "_get_vc_env is private; find an alternative (pypa/distutils#340)" ) return msvc._get_vc_env raise AttributeError(name) _distutils/compat/__pycache__/__init__.cpython-310.pyc 0000644 00000001750 15030122015 0016652 0 ustar 00 o �h � @ s> d dl mZ d dlmZ d dlmZ eddd�Zd d d �Zd S )� )� annotations)�Iterable)�TypeVar� _IterableTz Iterable[str])�bound�args�return�_IterableT | strc C s. t dd� | D ��s | S dd�dd� | D �� S )z� Ensure the return value is a string for backward compatibility. Retain until at least 2025-04-31. See pypa/distutils#246 c s � � | ]}|� d �V qdS ��-Wl,N)� startswith��.0�arg� r �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compat/__init__.py� <genexpr> � � z*consolidate_linker_args.<locals>.<genexpr>r �,c s r r )� removeprefixr r r r r r )�all�join)r r r r �consolidate_linker_args s r N)r r r r )� __future__r �collections.abcr �typingr r r r r r r �<module> s _distutils/compat/__pycache__/numpy.cpython-310.pyc 0000644 00000000406 15030122015 0016260 0 ustar 00 o �h� � @ s d dl mZmZ dS )� )�_default_compilers�compiler_classN)�compilers.C.baser r � r r �U/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compat/numpy.py�<module> s _distutils/compat/__pycache__/py39.cpython-310.pyc 0000644 00000003577 15030122015 0015730 0 ustar 00 o �h� � @ s� d dl Z d dlZd dlZd dlZdd� Zejdk o e�� dkZer#endd� ZG dd � d e �Z d d � Z d d � Z ejdk r@e ZdS e j edd�ZdS )� Nc C s& ddl }|�� d }| j||d� dS )z? Ensure vars contains 'EXT_SUFFIX'. pypa/distutils#130 r N)� EXT_SUFFIX�SO)�_imp�extension_suffixes�update)�varsr � ext_suffix� r �T/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compat/py39.py�add_ext_suffix_39 s �r )� � �Windowsc C s d S �Nr )r r r r �<lambda> s r c s e Zd Zd� fdd� Z� ZS )�UnequalIterablesErrorNc s* d}|d ur |dj |� 7 }t� �|� d S )Nz Iterables have different lengthsz/: index 0 has length {}; index {} has length {})�format�super�__init__)�self�details�msg�� __class__r r r s z UnequalIterablesError.__init__r )�__name__� __module__� __qualname__r � __classcell__r r r r r s r c c s@ � t � }tj| d|i�D ]}|D ] }||u rt� �q|V q d S )N� fillvalue)�object� itertools� zip_longestr )� iterables�_marker�combo�valr r r �_zip_equal_generator& s ���r& c G sn z)t | d �}t| dd � d�D ]\}}t |�}||kr$t|||fd��qt| � W S ty6 t| � Y S w )Nr � )r )�len� enumerater �zip� TypeErrorr& )r" � first_size�i�it�sizer r r � _zip_equal0 s � �r0 T)�strict)� functoolsr �platform�sysr � version_info�system�needs_ext_suffix�add_ext_suffix� ValueErrorr r& r0 �partialr* � zip_strictr r r r �<module> s � � _distutils/compat/py39.py 0000644 00000003654 15030122015 0011365 0 ustar 00 import functools import itertools import platform import sys def add_ext_suffix_39(vars): """ Ensure vars contains 'EXT_SUFFIX'. pypa/distutils#130 """ import _imp ext_suffix = _imp.extension_suffixes()[0] vars.update( EXT_SUFFIX=ext_suffix, # sysconfig sets SO to match EXT_SUFFIX, so maintain # that expectation. # https://github.com/python/cpython/blob/785cc6770588de087d09e89a69110af2542be208/Lib/sysconfig.py#L671-L673 SO=ext_suffix, ) needs_ext_suffix = sys.version_info < (3, 10) and platform.system() == 'Windows' add_ext_suffix = add_ext_suffix_39 if needs_ext_suffix else lambda vars: None # from more_itertools class UnequalIterablesError(ValueError): def __init__(self, details=None): msg = 'Iterables have different lengths' if details is not None: msg += (': index 0 has length {}; index {} has length {}').format(*details) super().__init__(msg) # from more_itertools def _zip_equal_generator(iterables): _marker = object() for combo in itertools.zip_longest(*iterables, fillvalue=_marker): for val in combo: if val is _marker: raise UnequalIterablesError() yield combo # from more_itertools def _zip_equal(*iterables): # Check whether the iterables are all the same size. try: first_size = len(iterables[0]) for i, it in enumerate(iterables[1:], 1): size = len(it) if size != first_size: raise UnequalIterablesError(details=(first_size, i, size)) # All sizes are equal, we can use the built-in zip. return zip(*iterables) # If any one of the iterables didn't have a length, start reading # them until one runs out. except TypeError: return _zip_equal_generator(iterables) zip_strict = ( _zip_equal if sys.version_info < (3, 10) else functools.partial(zip, strict=True) ) _distutils/compat/numpy.py 0000644 00000000247 15030122015 0011724 0 ustar 00 # required for older numpy versions on Pythons prior to 3.12; see pypa/setuptools#4876 from ..compilers.C.base import _default_compilers, compiler_class # noqa: F401 _distutils/compat/__init__.py 0000644 00000001012 15030122015 0012302 0 ustar 00 from __future__ import annotations from collections.abc import Iterable from typing import TypeVar _IterableT = TypeVar("_IterableT", bound="Iterable[str]") def consolidate_linker_args(args: _IterableT) -> _IterableT | str: """ Ensure the return value is a string for backward compatibility. Retain until at least 2025-04-31. See pypa/distutils#246 """ if not all(arg.startswith('-Wl,') for arg in args): return args return '-Wl,' + ','.join(arg.removeprefix('-Wl,') for arg in args) _distutils/debug.py 0000644 00000000213 15030122015 0010350 0 ustar 00 import os # If DISTUTILS_DEBUG is anything other than the empty string, we run in # debug mode. DEBUG = os.environ.get('DISTUTILS_DEBUG') _distutils/util.py 0000644 00000043256 15030122015 0010255 0 ustar 00 """distutils.util Miscellaneous utility functions -- anything that doesn't fit into one of the other *util.py modules. """ from __future__ import annotations import functools import importlib.util import os import pathlib import re import string import subprocess import sys import sysconfig import tempfile from collections.abc import Callable, Iterable, Mapping from typing import TYPE_CHECKING, AnyStr from jaraco.functools import pass_none from ._log import log from ._modified import newer from .errors import DistutilsByteCompileError, DistutilsPlatformError from .spawn import spawn if TYPE_CHECKING: from typing_extensions import TypeVarTuple, Unpack _Ts = TypeVarTuple("_Ts") def get_host_platform() -> str: """ Return a string that identifies the current platform. Use this function to distinguish platform-specific build directories and platform-specific built distributions. """ # This function initially exposed platforms as defined in Python 3.9 # even with older Python versions when distutils was split out. # Now it delegates to stdlib sysconfig. return sysconfig.get_platform() def get_platform() -> str: if os.name == 'nt': TARGET_TO_PLAT = { 'x86': 'win32', 'x64': 'win-amd64', 'arm': 'win-arm32', 'arm64': 'win-arm64', } target = os.environ.get('VSCMD_ARG_TGT_ARCH') return TARGET_TO_PLAT.get(target) or get_host_platform() return get_host_platform() if sys.platform == 'darwin': _syscfg_macosx_ver = None # cache the version pulled from sysconfig MACOSX_VERSION_VAR = 'MACOSX_DEPLOYMENT_TARGET' def _clear_cached_macosx_ver(): """For testing only. Do not call.""" global _syscfg_macosx_ver _syscfg_macosx_ver = None def get_macosx_target_ver_from_syscfg(): """Get the version of macOS latched in the Python interpreter configuration. Returns the version as a string or None if can't obtain one. Cached.""" global _syscfg_macosx_ver if _syscfg_macosx_ver is None: from distutils import sysconfig ver = sysconfig.get_config_var(MACOSX_VERSION_VAR) or '' if ver: _syscfg_macosx_ver = ver return _syscfg_macosx_ver def get_macosx_target_ver(): """Return the version of macOS for which we are building. The target version defaults to the version in sysconfig latched at time the Python interpreter was built, unless overridden by an environment variable. If neither source has a value, then None is returned""" syscfg_ver = get_macosx_target_ver_from_syscfg() env_ver = os.environ.get(MACOSX_VERSION_VAR) if env_ver: # Validate overridden version against sysconfig version, if have both. # Ensure that the deployment target of the build process is not less # than 10.3 if the interpreter was built for 10.3 or later. This # ensures extension modules are built with correct compatibility # values, specifically LDSHARED which can use # '-undefined dynamic_lookup' which only works on >= 10.3. if ( syscfg_ver and split_version(syscfg_ver) >= [10, 3] and split_version(env_ver) < [10, 3] ): my_msg = ( '$' + MACOSX_VERSION_VAR + ' mismatch: ' f'now "{env_ver}" but "{syscfg_ver}" during configure; ' 'must use 10.3 or later' ) raise DistutilsPlatformError(my_msg) return env_ver return syscfg_ver def split_version(s: str) -> list[int]: """Convert a dot-separated string into a list of numbers for comparisons""" return [int(n) for n in s.split('.')] @pass_none def convert_path(pathname: str | os.PathLike[str]) -> str: r""" Allow for pathlib.Path inputs, coax to a native path string. If None is passed, will just pass it through as Setuptools relies on this behavior. >>> convert_path(None) is None True Removes empty paths. >>> convert_path('foo/./bar').replace('\\', '/') 'foo/bar' """ return os.fspath(pathlib.PurePath(pathname)) def change_root( new_root: AnyStr | os.PathLike[AnyStr], pathname: AnyStr | os.PathLike[AnyStr] ) -> AnyStr: """Return 'pathname' with 'new_root' prepended. If 'pathname' is relative, this is equivalent to "os.path.join(new_root,pathname)". Otherwise, it requires making 'pathname' relative and then joining the two, which is tricky on DOS/Windows and Mac OS. """ if os.name == 'posix': if not os.path.isabs(pathname): return os.path.join(new_root, pathname) else: return os.path.join(new_root, pathname[1:]) elif os.name == 'nt': (drive, path) = os.path.splitdrive(pathname) if path[0] == os.sep: path = path[1:] return os.path.join(new_root, path) raise DistutilsPlatformError(f"nothing known about platform '{os.name}'") @functools.lru_cache def check_environ() -> None: """Ensure that 'os.environ' has all the environment variables we guarantee that users can use in config files, command-line options, etc. Currently this includes: HOME - user's home directory (Unix only) PLAT - description of the current platform, including hardware and OS (see 'get_platform()') """ if os.name == 'posix' and 'HOME' not in os.environ: try: import pwd os.environ['HOME'] = pwd.getpwuid(os.getuid())[5] except (ImportError, KeyError): # bpo-10496: if the current user identifier doesn't exist in the # password database, do nothing pass if 'PLAT' not in os.environ: os.environ['PLAT'] = get_platform() def subst_vars(s, local_vars: Mapping[str, object]) -> str: """ Perform variable substitution on 'string'. Variables are indicated by format-style braces ("{var}"). Variable is substituted by the value found in the 'local_vars' dictionary or in 'os.environ' if it's not in 'local_vars'. 'os.environ' is first checked/augmented to guarantee that it contains certain values: see 'check_environ()'. Raise ValueError for any variables not found in either 'local_vars' or 'os.environ'. """ check_environ() lookup = dict(os.environ) lookup.update((name, str(value)) for name, value in local_vars.items()) try: return _subst_compat(s).format_map(lookup) except KeyError as var: raise ValueError(f"invalid variable {var}") def _subst_compat(s): """ Replace shell/Perl-style variable substitution with format-style. For compatibility. """ def _subst(match): return f'{{{match.group(1)}}}' repl = re.sub(r'\$([a-zA-Z_][a-zA-Z_0-9]*)', _subst, s) if repl != s: import warnings warnings.warn( "shell/Perl-style substitutions are deprecated", DeprecationWarning, ) return repl def grok_environment_error(exc: object, prefix: str = "error: ") -> str: # Function kept for backward compatibility. # Used to try clever things with EnvironmentErrors, # but nowadays str(exception) produces good messages. return prefix + str(exc) # Needed by 'split_quoted()' _wordchars_re = _squote_re = _dquote_re = None def _init_regex(): global _wordchars_re, _squote_re, _dquote_re _wordchars_re = re.compile(rf'[^\\\'\"{string.whitespace} ]*') _squote_re = re.compile(r"'(?:[^'\\]|\\.)*'") _dquote_re = re.compile(r'"(?:[^"\\]|\\.)*"') def split_quoted(s: str) -> list[str]: """Split a string up according to Unix shell-like rules for quotes and backslashes. In short: words are delimited by spaces, as long as those spaces are not escaped by a backslash, or inside a quoted string. Single and double quotes are equivalent, and the quote characters can be backslash-escaped. The backslash is stripped from any two-character escape sequence, leaving only the escaped character. The quote characters are stripped from any quoted string. Returns a list of words. """ # This is a nice algorithm for splitting up a single string, since it # doesn't require character-by-character examination. It was a little # bit of a brain-bender to get it working right, though... if _wordchars_re is None: _init_regex() s = s.strip() words = [] pos = 0 while s: m = _wordchars_re.match(s, pos) end = m.end() if end == len(s): words.append(s[:end]) break if s[end] in string.whitespace: # unescaped, unquoted whitespace: now # we definitely have a word delimiter words.append(s[:end]) s = s[end:].lstrip() pos = 0 elif s[end] == '\\': # preserve whatever is being escaped; # will become part of the current word s = s[:end] + s[end + 1 :] pos = end + 1 else: if s[end] == "'": # slurp singly-quoted string m = _squote_re.match(s, end) elif s[end] == '"': # slurp doubly-quoted string m = _dquote_re.match(s, end) else: raise RuntimeError(f"this can't happen (bad char '{s[end]}')") if m is None: raise ValueError(f"bad string (mismatched {s[end]} quotes?)") (beg, end) = m.span() s = s[:beg] + s[beg + 1 : end - 1] + s[end:] pos = m.end() - 2 if pos >= len(s): words.append(s) break return words # split_quoted () def execute( func: Callable[[Unpack[_Ts]], object], args: tuple[Unpack[_Ts]], msg: object = None, verbose: bool = False, dry_run: bool = False, ) -> None: """ Perform some action that affects the outside world (e.g. by writing to the filesystem). Such actions are special because they are disabled by the 'dry_run' flag. This method handles that complication; simply supply the function to call and an argument tuple for it (to embody the "external action" being performed) and an optional message to emit. """ if msg is None: msg = f"{func.__name__}{args!r}" if msg[-2:] == ',)': # correct for singleton tuple msg = msg[0:-2] + ')' log.info(msg) if not dry_run: func(*args) def strtobool(val: str) -> bool: """Convert a string representation of truth to true (1) or false (0). True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if 'val' is anything else. """ val = val.lower() if val in ('y', 'yes', 't', 'true', 'on', '1'): return True elif val in ('n', 'no', 'f', 'false', 'off', '0'): return False else: raise ValueError(f"invalid truth value {val!r}") def byte_compile( # noqa: C901 py_files: Iterable[str], optimize: int = 0, force: bool = False, prefix: str | None = None, base_dir: str | None = None, verbose: bool = True, dry_run: bool = False, direct: bool | None = None, ) -> None: """Byte-compile a collection of Python source files to .pyc files in a __pycache__ subdirectory. 'py_files' is a list of files to compile; any files that don't end in ".py" are silently skipped. 'optimize' must be one of the following: 0 - don't optimize 1 - normal optimization (like "python -O") 2 - extra optimization (like "python -OO") If 'force' is true, all files are recompiled regardless of timestamps. The source filename encoded in each bytecode file defaults to the filenames listed in 'py_files'; you can modify these with 'prefix' and 'basedir'. 'prefix' is a string that will be stripped off of each source filename, and 'base_dir' is a directory name that will be prepended (after 'prefix' is stripped). You can supply either or both (or neither) of 'prefix' and 'base_dir', as you wish. If 'dry_run' is true, doesn't actually do anything that would affect the filesystem. Byte-compilation is either done directly in this interpreter process with the standard py_compile module, or indirectly by writing a temporary script and executing it. Normally, you should let 'byte_compile()' figure out to use direct compilation or not (see the source for details). The 'direct' flag is used by the script generated in indirect mode; unless you know what you're doing, leave it set to None. """ # nothing is done if sys.dont_write_bytecode is True if sys.dont_write_bytecode: raise DistutilsByteCompileError('byte-compiling is disabled.') # First, if the caller didn't force us into direct or indirect mode, # figure out which mode we should be in. We take a conservative # approach: choose direct mode *only* if the current interpreter is # in debug mode and optimize is 0. If we're not in debug mode (-O # or -OO), we don't know which level of optimization this # interpreter is running with, so we can't do direct # byte-compilation and be certain that it's the right thing. Thus, # always compile indirectly if the current interpreter is in either # optimize mode, or if either optimization level was requested by # the caller. if direct is None: direct = __debug__ and optimize == 0 # "Indirect" byte-compilation: write a temporary script and then # run it with the appropriate flags. if not direct: (script_fd, script_name) = tempfile.mkstemp(".py") log.info("writing byte-compilation script '%s'", script_name) if not dry_run: script = os.fdopen(script_fd, "w", encoding='utf-8') with script: script.write( """\ from distutils.util import byte_compile files = [ """ ) # XXX would be nice to write absolute filenames, just for # safety's sake (script should be more robust in the face of # chdir'ing before running it). But this requires abspath'ing # 'prefix' as well, and that breaks the hack in build_lib's # 'byte_compile()' method that carefully tacks on a trailing # slash (os.sep really) to make sure the prefix here is "just # right". This whole prefix business is rather delicate -- the # problem is that it's really a directory, but I'm treating it # as a dumb string, so trailing slashes and so forth matter. script.write(",\n".join(map(repr, py_files)) + "]\n") script.write( f""" byte_compile(files, optimize={optimize!r}, force={force!r}, prefix={prefix!r}, base_dir={base_dir!r}, verbose={verbose!r}, dry_run=False, direct=True) """ ) cmd = [sys.executable] cmd.extend(subprocess._optim_args_from_interpreter_flags()) cmd.append(script_name) spawn(cmd, dry_run=dry_run) execute(os.remove, (script_name,), f"removing {script_name}", dry_run=dry_run) # "Direct" byte-compilation: use the py_compile module to compile # right here, right now. Note that the script generated in indirect # mode simply calls 'byte_compile()' in direct mode, a weird sort of # cross-process recursion. Hey, it works! else: from py_compile import compile for file in py_files: if file[-3:] != ".py": # This lets us be lazy and not filter filenames in # the "install_lib" command. continue # Terminology from the py_compile module: # cfile - byte-compiled file # dfile - purported source filename (same as 'file' by default) if optimize >= 0: opt = '' if optimize == 0 else optimize cfile = importlib.util.cache_from_source(file, optimization=opt) else: cfile = importlib.util.cache_from_source(file) dfile = file if prefix: if file[: len(prefix)] != prefix: raise ValueError( f"invalid prefix: filename {file!r} doesn't start with {prefix!r}" ) dfile = dfile[len(prefix) :] if base_dir: dfile = os.path.join(base_dir, dfile) cfile_base = os.path.basename(cfile) if direct: if force or newer(file, cfile): log.info("byte-compiling %s to %s", file, cfile_base) if not dry_run: compile(file, cfile, dfile) else: log.debug("skipping byte-compilation of %s to %s", file, cfile_base) def rfc822_escape(header: str) -> str: """Return a version of the string escaped for inclusion in an RFC-822 header, by ensuring there are 8 spaces space after each newline. """ indent = 8 * " " lines = header.splitlines(keepends=True) # Emulate the behaviour of `str.split` # (the terminal line break in `splitlines` does not result in an extra line): ends_in_newline = lines and lines[-1].splitlines()[0] != lines[-1] suffix = indent if ends_in_newline else "" return indent.join(lines) + suffix def is_mingw() -> bool: """Returns True if the current platform is mingw. Python compiled with Mingw-w64 has sys.platform == 'win32' and get_platform() starts with 'mingw'. """ return sys.platform == 'win32' and get_platform().startswith('mingw') def is_freethreaded(): """Return True if the Python interpreter is built with free threading support.""" return bool(sysconfig.get_config_var('Py_GIL_DISABLED')) _distutils/versionpredicate.py 0000644 00000012125 15030122015 0012635 0 ustar 00 """Module for parsing and testing package version predicate strings.""" import operator import re from . import version re_validPackage = re.compile(r"(?i)^\s*([a-z_]\w*(?:\.[a-z_]\w*)*)(.*)", re.ASCII) # (package) (rest) re_paren = re.compile(r"^\s*\((.*)\)\s*$") # (list) inside of parentheses re_splitComparison = re.compile(r"^\s*(<=|>=|<|>|!=|==)\s*([^\s,]+)\s*$") # (comp) (version) def splitUp(pred): """Parse a single version comparison. Return (comparison string, StrictVersion) """ res = re_splitComparison.match(pred) if not res: raise ValueError(f"bad package restriction syntax: {pred!r}") comp, verStr = res.groups() with version.suppress_known_deprecation(): other = version.StrictVersion(verStr) return (comp, other) compmap = { "<": operator.lt, "<=": operator.le, "==": operator.eq, ">": operator.gt, ">=": operator.ge, "!=": operator.ne, } class VersionPredicate: """Parse and test package version predicates. >>> v = VersionPredicate('pyepat.abc (>1.0, <3333.3a1, !=1555.1b3)') The `name` attribute provides the full dotted name that is given:: >>> v.name 'pyepat.abc' The str() of a `VersionPredicate` provides a normalized human-readable version of the expression:: >>> print(v) pyepat.abc (> 1.0, < 3333.3a1, != 1555.1b3) The `satisfied_by()` method can be used to determine with a given version number is included in the set described by the version restrictions:: >>> v.satisfied_by('1.1') True >>> v.satisfied_by('1.4') True >>> v.satisfied_by('1.0') False >>> v.satisfied_by('4444.4') False >>> v.satisfied_by('1555.1b3') False `VersionPredicate` is flexible in accepting extra whitespace:: >>> v = VersionPredicate(' pat( == 0.1 ) ') >>> v.name 'pat' >>> v.satisfied_by('0.1') True >>> v.satisfied_by('0.2') False If any version numbers passed in do not conform to the restrictions of `StrictVersion`, a `ValueError` is raised:: >>> v = VersionPredicate('p1.p2.p3.p4(>=1.0, <=1.3a1, !=1.2zb3)') Traceback (most recent call last): ... ValueError: invalid version number '1.2zb3' It the module or package name given does not conform to what's allowed as a legal module or package name, `ValueError` is raised:: >>> v = VersionPredicate('foo-bar') Traceback (most recent call last): ... ValueError: expected parenthesized list: '-bar' >>> v = VersionPredicate('foo bar (12.21)') Traceback (most recent call last): ... ValueError: expected parenthesized list: 'bar (12.21)' """ def __init__(self, versionPredicateStr): """Parse a version predicate string.""" # Fields: # name: package name # pred: list of (comparison string, StrictVersion) versionPredicateStr = versionPredicateStr.strip() if not versionPredicateStr: raise ValueError("empty package restriction") match = re_validPackage.match(versionPredicateStr) if not match: raise ValueError(f"bad package name in {versionPredicateStr!r}") self.name, paren = match.groups() paren = paren.strip() if paren: match = re_paren.match(paren) if not match: raise ValueError(f"expected parenthesized list: {paren!r}") str = match.groups()[0] self.pred = [splitUp(aPred) for aPred in str.split(",")] if not self.pred: raise ValueError(f"empty parenthesized list in {versionPredicateStr!r}") else: self.pred = [] def __str__(self): if self.pred: seq = [cond + " " + str(ver) for cond, ver in self.pred] return self.name + " (" + ", ".join(seq) + ")" else: return self.name def satisfied_by(self, version): """True if version is compatible with all the predicates in self. The parameter version must be acceptable to the StrictVersion constructor. It may be either a string or StrictVersion. """ for cond, ver in self.pred: if not compmap[cond](version, ver): return False return True _provision_rx = None def split_provision(value): """Return the name and optional version number of a provision. The version number, if given, will be returned as a `StrictVersion` instance, otherwise it will be `None`. >>> split_provision('mypkg') ('mypkg', None) >>> split_provision(' mypkg( 1.2 ) ') ('mypkg', StrictVersion ('1.2')) """ global _provision_rx if _provision_rx is None: _provision_rx = re.compile( r"([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*)(?:\s*\(\s*([^)\s]+)\s*\))?$", re.ASCII ) value = value.strip() m = _provision_rx.match(value) if not m: raise ValueError(f"illegal provides specification: {value!r}") ver = m.group(2) or None if ver: with version.suppress_known_deprecation(): ver = version.StrictVersion(ver) return m.group(1), ver _distutils/ccompiler.py 0000644 00000001014 15030122015 0011237 0 ustar 00 from .compat.numpy import ( # noqa: F401 _default_compilers, compiler_class, ) from .compilers.C import base from .compilers.C.base import ( gen_lib_options, gen_preprocess_options, get_default_compiler, new_compiler, show_compilers, ) from .compilers.C.errors import CompileError, LinkError __all__ = [ 'CompileError', 'LinkError', 'gen_lib_options', 'gen_preprocess_options', 'get_default_compiler', 'new_compiler', 'show_compilers', ] CCompiler = base.Compiler _distutils/dir_util.py 0000644 00000016104 15030122015 0011103 0 ustar 00 """distutils.dir_util Utility functions for manipulating directories and directory trees.""" import functools import itertools import os import pathlib from . import file_util from ._log import log from .errors import DistutilsFileError, DistutilsInternalError class SkipRepeatAbsolutePaths(set): """ Cache for mkpath. In addition to cheapening redundant calls, eliminates redundant "creating /foo/bar/baz" messages in dry-run mode. """ def __init__(self): SkipRepeatAbsolutePaths.instance = self @classmethod def clear(cls): super(cls, cls.instance).clear() def wrap(self, func): @functools.wraps(func) def wrapper(path, *args, **kwargs): if path.absolute() in self: return result = func(path, *args, **kwargs) self.add(path.absolute()) return result return wrapper # Python 3.8 compatibility wrapper = SkipRepeatAbsolutePaths().wrap @functools.singledispatch @wrapper def mkpath(name: pathlib.Path, mode=0o777, verbose=True, dry_run=False) -> None: """Create a directory and any missing ancestor directories. If the directory already exists (or if 'name' is the empty string, which means the current directory, which of course exists), then do nothing. Raise DistutilsFileError if unable to create some directory along the way (eg. some sub-path exists, but is a file rather than a directory). If 'verbose' is true, log the directory created. """ if verbose and not name.is_dir(): log.info("creating %s", name) try: dry_run or name.mkdir(mode=mode, parents=True, exist_ok=True) except OSError as exc: raise DistutilsFileError(f"could not create '{name}': {exc.args[-1]}") @mkpath.register def _(name: str, *args, **kwargs): return mkpath(pathlib.Path(name), *args, **kwargs) @mkpath.register def _(name: None, *args, **kwargs): """ Detect a common bug -- name is None. """ raise DistutilsInternalError(f"mkpath: 'name' must be a string (got {name!r})") def create_tree(base_dir, files, mode=0o777, verbose=True, dry_run=False): """Create all the empty directories under 'base_dir' needed to put 'files' there. 'base_dir' is just the name of a directory which doesn't necessarily exist yet; 'files' is a list of filenames to be interpreted relative to 'base_dir'. 'base_dir' + the directory portion of every file in 'files' will be created if it doesn't already exist. 'mode', 'verbose' and 'dry_run' flags are as for 'mkpath()'. """ # First get the list of directories to create need_dir = set(os.path.join(base_dir, os.path.dirname(file)) for file in files) # Now create them for dir in sorted(need_dir): mkpath(dir, mode, verbose=verbose, dry_run=dry_run) def copy_tree( src, dst, preserve_mode=True, preserve_times=True, preserve_symlinks=False, update=False, verbose=True, dry_run=False, ): """Copy an entire directory tree 'src' to a new location 'dst'. Both 'src' and 'dst' must be directory names. If 'src' is not a directory, raise DistutilsFileError. If 'dst' does not exist, it is created with 'mkpath()'. The end result of the copy is that every file in 'src' is copied to 'dst', and directories under 'src' are recursively copied to 'dst'. Return the list of files that were copied or might have been copied, using their output name. The return value is unaffected by 'update' or 'dry_run': it is simply the list of all files under 'src', with the names changed to be under 'dst'. 'preserve_mode' and 'preserve_times' are the same as for 'copy_file'; note that they only apply to regular files, not to directories. If 'preserve_symlinks' is true, symlinks will be copied as symlinks (on platforms that support them!); otherwise (the default), the destination of the symlink will be copied. 'update' and 'verbose' are the same as for 'copy_file'. """ if not dry_run and not os.path.isdir(src): raise DistutilsFileError(f"cannot copy tree '{src}': not a directory") try: names = os.listdir(src) except OSError as e: if dry_run: names = [] else: raise DistutilsFileError(f"error listing files in '{src}': {e.strerror}") if not dry_run: mkpath(dst, verbose=verbose) copy_one = functools.partial( _copy_one, src=src, dst=dst, preserve_symlinks=preserve_symlinks, verbose=verbose, dry_run=dry_run, preserve_mode=preserve_mode, preserve_times=preserve_times, update=update, ) return list(itertools.chain.from_iterable(map(copy_one, names))) def _copy_one( name, *, src, dst, preserve_symlinks, verbose, dry_run, preserve_mode, preserve_times, update, ): src_name = os.path.join(src, name) dst_name = os.path.join(dst, name) if name.startswith('.nfs'): # skip NFS rename files return if preserve_symlinks and os.path.islink(src_name): link_dest = os.readlink(src_name) if verbose >= 1: log.info("linking %s -> %s", dst_name, link_dest) if not dry_run: os.symlink(link_dest, dst_name) yield dst_name elif os.path.isdir(src_name): yield from copy_tree( src_name, dst_name, preserve_mode, preserve_times, preserve_symlinks, update, verbose=verbose, dry_run=dry_run, ) else: file_util.copy_file( src_name, dst_name, preserve_mode, preserve_times, update, verbose=verbose, dry_run=dry_run, ) yield dst_name def _build_cmdtuple(path, cmdtuples): """Helper for remove_tree().""" for f in os.listdir(path): real_f = os.path.join(path, f) if os.path.isdir(real_f) and not os.path.islink(real_f): _build_cmdtuple(real_f, cmdtuples) else: cmdtuples.append((os.remove, real_f)) cmdtuples.append((os.rmdir, path)) def remove_tree(directory, verbose=True, dry_run=False): """Recursively remove an entire directory tree. Any errors are ignored (apart from being reported to stdout if 'verbose' is true). """ if verbose >= 1: log.info("removing '%s' (and everything under it)", directory) if dry_run: return cmdtuples = [] _build_cmdtuple(directory, cmdtuples) for cmd in cmdtuples: try: cmd[0](cmd[1]) # Clear the cache SkipRepeatAbsolutePaths.clear() except OSError as exc: log.warning("error removing %s: %s", directory, exc) def ensure_relative(path): """Take the full path 'path', and make it a relative path. This is useful to make 'path' the second argument to os.path.join(). """ drive, path = os.path.splitdrive(path) if path[0:1] == os.sep: path = drive + path[1:] return path _distutils/sysconfig.py 0000644 00000046420 15030122015 0011300 0 ustar 00 """Provide access to Python's configuration information. The specific configuration variables available depend heavily on the platform and configuration. The values may be retrieved using get_config_var(name), and the list of variables is available via get_config_vars().keys(). Additional convenience functions are also available. 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. PREFIX = os.path.normpath(sys.prefix) EXEC_PREFIX = os.path.normpath(sys.exec_prefix) BASE_PREFIX = os.path.normpath(sys.base_prefix) BASE_EXEC_PREFIX = os.path.normpath(sys.base_exec_prefix) # Path to the base directory of the project. On Windows the binary may # live in project/PCbuild/win32 or project/PCbuild/amd64. # set for cross builds if "_PYTHON_PROJECT_BASE" in os.environ: project_base = os.path.abspath(os.environ["_PYTHON_PROJECT_BASE"]) else: if sys.executable: project_base = os.path.dirname(os.path.abspath(sys.executable)) else: # sys.executable can be empty if argv[0] has been changed and Python is # unable to retrieve the real program name project_base = os.getcwd() def _is_python_source_dir(d): """ Return True if the target directory appears to point to an un-installed Python. """ modules = pathlib.Path(d).joinpath('Modules') return any(modules.joinpath(fn).is_file() for fn in ('Setup', 'Setup.local')) _sys_home = getattr(sys, '_home', None) def _is_parent(dir_a, dir_b): """ Return True if a is a parent of b. """ return os.path.normcase(dir_a).startswith(os.path.normcase(dir_b)) if os.name == 'nt': @pass_none def _fix_pcbuild(d): # In a venv, sys._home will be inside BASE_PREFIX rather than PREFIX. prefixes = PREFIX, BASE_PREFIX matched = ( prefix for prefix in prefixes if _is_parent(d, os.path.join(prefix, "PCbuild")) ) return next(matched, d) project_base = _fix_pcbuild(project_base) _sys_home = _fix_pcbuild(_sys_home) def _python_build(): if _sys_home: return _is_python_source_dir(_sys_home) return _is_python_source_dir(project_base) python_build = _python_build() # Calculate the build qualifier flags if they are defined. Adding the flags # to the include and lib directories only makes sense for an installation, not # an in-source build. build_flags = '' try: if not python_build: build_flags = sys.abiflags except AttributeError: # It's not a configure-based build, so the sys module doesn't have # this attribute, which is fine. pass def get_python_version(): """Return a string containing the major and minor Python version, leaving off the patchlevel. Sample return values could be '1.5' or '2.2'. """ return f'{sys.version_info.major}.{sys.version_info.minor}' 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 non-platform-specific header files, i.e. Python.h and so on; otherwise, this is the path to platform-specific header files (namely pyconfig.h). If 'prefix' is supplied, use it instead of sys.base_prefix or sys.base_exec_prefix -- i.e., ignore 'plat_specific'. """ default_prefix = BASE_EXEC_PREFIX if plat_specific else BASE_PREFIX resolved_prefix = prefix if prefix is not None else default_prefix # MinGW imitates posix like layout, but os.name != posix os_name = "posix" if is_mingw() else os.name try: getter = globals()[f'_get_python_inc_{os_name}'] except KeyError: raise DistutilsPlatformError( "I don't know where Python installs its C header files " f"on platform '{os.name}'" ) return getter(resolved_prefix, prefix, plat_specific) @pass_none def _extant(path): """ Replace path with None if it doesn't exist. """ return path if os.path.exists(path) else None def _get_python_inc_posix(prefix, spec_prefix, plat_specific): return ( _get_python_inc_posix_python(plat_specific) or _extant(_get_python_inc_from_config(plat_specific, spec_prefix)) or _get_python_inc_posix_prefix(prefix) ) def _get_python_inc_posix_python(plat_specific): """ Assume the executable is in the build directory. The pyconfig.h file should be in the same directory. Since the build directory may not be the source directory, use "srcdir" from the makefile to find the "Include" directory. """ if not python_build: return if plat_specific: return _sys_home or project_base incdir = os.path.join(get_config_var('srcdir'), 'Include') return os.path.normpath(incdir) def _get_python_inc_from_config(plat_specific, spec_prefix): """ If no prefix was explicitly specified, provide the include directory from the config vars. Useful when cross-compiling, since the config vars may come from the host platform Python installation, while the current Python executable is from the build platform installation. >>> monkeypatch = getfixture('monkeypatch') >>> gpifc = _get_python_inc_from_config >>> monkeypatch.setitem(gpifc.__globals__, 'get_config_var', str.lower) >>> gpifc(False, '/usr/bin/') >>> gpifc(False, '') >>> gpifc(False, None) 'includepy' >>> gpifc(True, None) 'confincludepy' """ if spec_prefix is None: return get_config_var('CONF' * plat_specific + 'INCLUDEPY') def _get_python_inc_posix_prefix(prefix): implementation = 'pypy' if IS_PYPY else 'python' python_dir = implementation + get_python_version() + build_flags return os.path.join(prefix, "include", python_dir) def _get_python_inc_nt(prefix, spec_prefix, plat_specific): if python_build: # Include both include dirs to ensure we can find pyconfig.h return ( os.path.join(prefix, "include") + os.path.pathsep + os.path.dirname(sysconfig.get_config_h_filename()) ) return os.path.join(prefix, "include") # allow this behavior to be monkey-patched. Ref pypa/distutils#2. def _posix_lib(standard_lib, libpython, early_prefix, prefix): if standard_lib: return libpython else: return os.path.join(libpython, "site-packages") 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). If 'plat_specific' is true, return the directory containing platform-specific modules, i.e. any module from a non-pure-Python module distribution; otherwise, return the platform-shared library directory. If 'standard_lib' is true, return the directory containing standard Python library modules; otherwise, return the directory for site-specific modules. If 'prefix' is supplied, use it instead of sys.base_prefix or sys.base_exec_prefix -- i.e., ignore 'plat_specific'. """ early_prefix = prefix if prefix is None: if standard_lib: prefix = plat_specific and BASE_EXEC_PREFIX or BASE_PREFIX else: prefix = plat_specific and EXEC_PREFIX or PREFIX if os.name == "posix" or is_mingw(): if plat_specific or standard_lib: # Platform-specific modules (any module from a non-pure-Python # module distribution) or standard Python library modules. libdir = getattr(sys, "platlibdir", "lib") else: # Pure Python libdir = "lib" implementation = 'pypy' if IS_PYPY else 'python' libpython = os.path.join(prefix, libdir, implementation + get_python_version()) return _posix_lib(standard_lib, libpython, early_prefix, prefix) elif os.name == "nt": if standard_lib: return os.path.join(prefix, "Lib") else: return os.path.join(prefix, "Lib", "site-packages") else: raise DistutilsPlatformError( f"I don't know where Python installs its library on platform '{os.name}'" ) @functools.lru_cache def _customize_macos(): """ Perform first-time customization of compiler-related config vars on macOS. Use after a compiler is known to be needed. This customization exists primarily to support Pythons from binary installers. The kind and paths to build tools on the user system may vary significantly from the system that Python itself was built on. Also the user OS version and build tools may not support the same set of CPU architectures for universal builds. """ sys.platform == "darwin" and __import__('_osx_support').customize_compiler( get_config_vars() ) 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 varies across Unices and is stored in Python's Makefile. """ if compiler.compiler_type in ["unix", "cygwin"] or ( compiler.compiler_type == "mingw32" and is_mingw() ): _customize_macos() ( cc, cxx, cflags, ccshared, ldshared, ldcxxshared, shlib_suffix, ar, ar_flags, ) = get_config_vars( 'CC', 'CXX', 'CFLAGS', 'CCSHARED', 'LDSHARED', 'LDCXXSHARED', 'SHLIB_SUFFIX', 'AR', 'ARFLAGS', ) cxxflags = cflags if 'CC' in os.environ: newcc = os.environ['CC'] if 'LDSHARED' not in os.environ and ldshared.startswith(cc): # If CC is overridden, use that as the default # command for LDSHARED as well ldshared = newcc + ldshared[len(cc) :] cc = newcc cxx = os.environ.get('CXX', cxx) ldshared = os.environ.get('LDSHARED', ldshared) ldcxxshared = os.environ.get('LDCXXSHARED', ldcxxshared) cpp = os.environ.get( 'CPP', cc + " -E", # not always ) ldshared = _add_flags(ldshared, 'LD') ldcxxshared = _add_flags(ldcxxshared, 'LD') cflags = os.environ.get('CFLAGS', cflags) ldshared = _add_flags(ldshared, 'C') cxxflags = os.environ.get('CXXFLAGS', cxxflags) ldcxxshared = _add_flags(ldcxxshared, 'CXX') cpp = _add_flags(cpp, 'CPP') cflags = _add_flags(cflags, 'CPP') cxxflags = _add_flags(cxxflags, 'CPP') ldshared = _add_flags(ldshared, 'CPP') ldcxxshared = _add_flags(ldcxxshared, 'CPP') ar = os.environ.get('AR', ar) archiver = ar + ' ' + os.environ.get('ARFLAGS', ar_flags) cc_cmd = cc + ' ' + cflags cxx_cmd = cxx + ' ' + cxxflags compiler.set_executables( preprocessor=cpp, compiler=cc_cmd, compiler_so=cc_cmd + ' ' + ccshared, compiler_cxx=cxx_cmd, compiler_so_cxx=cxx_cmd + ' ' + ccshared, linker_so=ldshared, linker_so_cxx=ldcxxshared, linker_exe=cc, linker_exe_cxx=cxx, archiver=archiver, ) if 'RANLIB' in os.environ and compiler.executables.get('ranlib', None): compiler.set_executables(ranlib=os.environ['RANLIB']) compiler.shared_lib_extension = shlib_suffix def get_config_h_filename() -> str: """Return full pathname of installed pyconfig.h file.""" return sysconfig.get_config_h_filename() def get_makefile_filename() -> str: """Return full pathname of installed Makefile from the Python build.""" return sysconfig.get_makefile_filename() def parse_config_h(fp, g=None): """Parse a config.h-style file. A dictionary containing name/value pairs is returned. If an optional dictionary is passed in as the second argument, it is used instead of a new dictionary. """ return sysconfig.parse_config_h(fp, vars=g) # Regexes needed for parsing Makefile (and similar syntaxes, # like old-style Setup files). _variable_rx = re.compile(r"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)") _findvar1_rx = re.compile(r"\$\(([A-Za-z][A-Za-z0-9_]*)\)") _findvar2_rx = re.compile(r"\${([A-Za-z][A-Za-z0-9_]*)}") def parse_makefile(fn, g=None): # noqa: C901 """Parse a Makefile-style file. A dictionary containing name/value pairs is returned. If an optional dictionary is passed in as the second argument, it is used instead of a new dictionary. """ from distutils.text_file import TextFile fp = TextFile( fn, strip_comments=True, skip_blanks=True, join_lines=True, errors="surrogateescape", ) if g is None: g = {} done = {} notdone = {} while True: line = fp.readline() if line is None: # eof break m = _variable_rx.match(line) if m: n, v = m.group(1, 2) v = v.strip() # `$$' is a literal `$' in make tmpv = v.replace('$$', '') if "$" in tmpv: notdone[n] = v else: try: v = int(v) except ValueError: # insert literal `$' done[n] = v.replace('$$', '$') else: done[n] = v # Variables with a 'PY_' prefix in the makefile. These need to # be made available without that prefix through sysconfig. # Special care is needed to ensure that variable expansion works, even # if the expansion uses the name without a prefix. renamed_variables = ('CFLAGS', 'LDFLAGS', 'CPPFLAGS') # do variable interpolation here while notdone: for name in list(notdone): value = notdone[name] m = _findvar1_rx.search(value) or _findvar2_rx.search(value) if m: n = m.group(1) found = True if n in done: item = str(done[n]) elif n in notdone: # get it on a subsequent round found = False elif n in os.environ: # do it like make: fall back to environment item = os.environ[n] elif n in renamed_variables: if name.startswith('PY_') and name[3:] in renamed_variables: item = "" elif 'PY_' + n in notdone: found = False else: item = str(done['PY_' + n]) else: done[n] = item = "" if found: after = value[m.end() :] value = value[: m.start()] + item + after if "$" in after: notdone[name] = value else: try: value = int(value) except ValueError: done[name] = value.strip() else: done[name] = value del notdone[name] if name.startswith('PY_') and name[3:] in renamed_variables: name = name[3:] if name not in done: done[name] = value else: # bogus variable reference; just drop it since we can't deal del notdone[name] fp.close() # strip spurious spaces for k, v in done.items(): if isinstance(v, str): done[k] = v.strip() # save the results in the global dictionary g.update(done) return g def expand_makefile_vars(s, vars): """Expand Makefile-style variables -- "${foo}" or "$(foo)" -- in 'string' according to 'vars' (a dictionary mapping variable names to values). Variables not present in 'vars' are silently expanded to the empty string. The variable values in 'vars' should not contain further variable expansions; if 'vars' is the output of 'parse_makefile()', you're fine. Returns a variable-expanded version of 's'. """ # This algorithm does multiple expansion, so if vars['foo'] contains # "${bar}", it will expand ${foo} to ${bar}, and then expand # ${bar}... and so forth. This is fine as long as 'vars' comes from # 'parse_makefile()', which takes care of such expansions eagerly, # according to make's variable expansion semantics. while True: m = _findvar1_rx.search(s) or _findvar2_rx.search(s) if m: (beg, end) = m.span() s = s[0:beg] + vars.get(m.group(1)) + s[end:] else: break return s _config_vars = None @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 extensions. On Unix, this means every variable defined in Python's installed Makefile; on Windows it's a much smaller set. With arguments, return a list of values that result from looking up each argument in the configuration variable dictionary. """ global _config_vars if _config_vars is None: _config_vars = sysconfig.get_config_vars().copy() py39.add_ext_suffix(_config_vars) return [_config_vars.get(name) for name in args] if args else _config_vars @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) """ if name == 'SO': import warnings warnings.warn('SO is deprecated, use EXT_SUFFIX', DeprecationWarning, 2) return get_config_vars().get(name) @pass_none def _add_flags(value: str, type: str) -> str: """ Add any flags from the environment for the given type. type is the prefix to FLAGS in the environment key (e.g. "C" for "CFLAGS"). """ flags = os.environ.get(f'{type}FLAGS') return f'{value} {flags}' if flags else value _distutils/unixccompiler.py 0000644 00000000324 15030122015 0012146 0 ustar 00 import importlib from .compilers.C import unix UnixCCompiler = unix.Compiler # ensure import of unixccompiler implies ccompiler imported # (pypa/setuptools#4871) importlib.import_module('distutils.ccompiler') _distutils/compilers/C/tests/__pycache__/test_unix.cpython-310.pyc 0000644 00000022235 15030122015 0021174 0 ustar 00 o �h:. � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl m Z ddl m Z ddl mZ ddlmZ ddlZd d lmZ ejd d �d d� �Zejd d �dd� �ZG dd� de j�ZdS )z"Tests for distutils.unixccompiler.� N)� sysconfig)�consolidate_linker_args)�DistutilsPlatformError)�support)�EnvironmentVarGuard)�_clear_cached_macosx_ver� )�unixT)�autousec C s4 | � tdtj� | � tdtj� | � tdtj� d S )N�platform�get_config_var�get_config_vars)�setattr�sysr r r r )� monkeypatch� r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py� save_values s r c C s G dd� dt j�}|� | j_d S )Nc @ s e Zd Zdd� ZdS )z)compiler_wrapper.<locals>.CompilerWrapperc S s | � d�S )Nz/foo)�runtime_library_dir_option��selfr r r � rpath_foo s z3compiler_wrapper.<locals>.CompilerWrapper.rpath_fooN)�__name__� __module__� __qualname__r r r r r �CompilerWrapper s r )r �Compiler�instance�cc)�requestr r r r �compiler_wrapper s r c @ sx e Zd Zej�d�dd� �Zej�d�dd� �Zej�d�ej�d�dd� ��Z ej�d�d d � �Z d d � Z d d� Z dS )�TestUnixCCompilerz platform.system == "Windows"c sb dt _d� d}d}d|fd|fd|fd|fd |fd |fd |fd |fd |fd|fd|fdg }� fdd��� ��fdd�}|D ]0\}}|\}}||||� |d u rU|d||� |d u r_||d|� |d u rm|d u rm|dd|� q=tj} dt _dd� } | t_�j�� ddgks�J �dd� } | t_�j�� ddgks�J �d d� } | t_�j�� ddgks�J �| t_d t _d d� } | t_�j�� td dg�ks�J �d d� } | t_�j�� td dg�ks�J �d t _d!d� } | t_�j�� d"ks�J �d t _d#d� } | t_�j�� td dg�k�sJ �d t _d$d� } | t_�j�� td dg�k�sJ �d t _d%d� } | t_�j�� d"k�s/J �d S )&N�darwin�MACOSX_DEPLOYMENT_TARGETz-Wl,-rpath,/fooz-L/foo)NN)N�11)�10N)�10.3N)z10.3.1N)�10.5N)z10.5.1N)r& r& )r& r' )r' r& )r' r$ ))z10.4r% Nc s �� fdd�}|S )Nc s | � kr�S dS �N�xxxr )�var)�darwin_ver_var�syscfg_macosx_verr r �gcvC � zRTestUnixCCompiler.test_runtime_libdir_option.<locals>.make_darwin_gcv.<locals>.gcvr )r, r- )r+ )r, r �make_darwin_gcvB s zETestUnixCCompiler.test_runtime_libdir_option.<locals>.make_darwin_gcvc s� t j}d| �d|�d�}tj}|�� �}t� �| �t_|d ur%||� < n � |v r.|�� � |d ur>�j�� |ks=J |��n t j t � d d�� �j�� W d � n1 sWw Y |d ure||� < n � |v rn|�� � |t_t� d S )NzmacOS version = (sysconfig=z, env=�)z mismatch)�match) �os�environr r �getr �popr r �pytest�raisesr )r, �env_macosx_ver� expected_flag�env�msg�old_gcv�old_env_macosx_ver�r+ r/ r r r �do_darwin_testJ s. � � zDTestUnixCCompiler.test_runtime_libdir_option.<locals>.do_darwin_test� zhp-uxc S � dS r( r ��vr r r r- { � z9TestUnixCCompiler.test_runtime_libdir_option.<locals>.gcvz+sc S rA )N�gccr rB r r r r- � rD z-Wl,+sc S rA )Nzg++r rB r r r r- � rD �barc S � | dkrdS | dkr dS d S )N�CCrE �GNULD�yesr rB r r r r- � � �z-Wl,--enable-new-dtagsc S rG )NrH zgcc -pthread -B /barrI rJ r rB r r r r- � rK c S rG )NrH rE rI �nor rB r r r r- � rK z -Wl,-R/fooc S rG )NrH z x86_64-pc-linux-gnu-gcc-4.4.2rI rJ r rB r r r r- � rK c S rG )NrH r rI rJ r rB r r r r- � rK c S rG )NrH r rI rL r rB r r r r- � rK )r r r r r r r ) r �darwin_rpath_flag�darwin_lib_flag�darwin_test_casesr? � macosx_versr9 r, r8 r< r- r r> r �test_runtime_libdir_option# s� � ! � � � � �z,TestUnixCCompiler.test_runtime_libdir_optionc C s| dd� }t jd�dd�}|t _|t _t� �}d|d< |d= t �| j� W d � n1 s-w Y | jjd dks<J �d S ) Nc S � | dkrdS dS �N�LDSHARED�*gcc-4.2 -bundle -undefined dynamic_lookup �gcc-4.2r rB r r r r- � r. z9TestUnixCCompiler.test_cc_overrides_ldshared.<locals>.gcv��_origc W � |r t ttj|��S | � S �N��list�mapr r �rX �argsr r r �gcvs� � z:TestUnixCCompiler.test_cc_overrides_ldshared.<locals>.gcvs�my_ccrH rT r �r r r r �customize_compilerr � linker_so�r r- r` r: r r r �test_cc_overrides_ldshared� s �z,TestUnixCCompiler.test_cc_overrides_ldshared�disable_macos_customizationc C sx dd� }t jd�dd�}|t _|t _tjj| jddd���}tjj| jd d d��s tjj| jd dd��Y t� �F}d |d < d|d< |d= t �| j� | jj dd� ddgksVJ �| jj dg ddd� |j d d }g d�}|dd� |ksuJ �W d � n1 sw Y W d � n1 s�w Y W d � n1 s�w Y W d � dS W d � dS 1 s�w Y dS )z� Ensure that setting CC env variable also changes default linker correctly when building C++ extensions. pypa/distutils#126 c S s4 | dkrdS | dkr dS | dkrdS | dkrdS d S ) NrT rU � LDCXXSHAREDz*g++-4.2 -bundle -undefined dynamic_lookup �CXXzg++-4.2rH rV r@ r rB r r r r- s zKTestUnixCCompiler.test_cc_overrides_ldshared_for_cxx_correctly.<locals>.gcvrW c W rY rZ r[ r^ r r r r` ra zLTestUnixCCompiler.test_cc_overrides_ldshared_for_cxx_correctly.<locals>.gcvs�spawnN)� return_value� _need_linkT�mkpathz ccache my_ccrH �my_cxxrj rT r r �ccacherb za.outzc++)� target_lang)ro z-bundlez -undefined�dynamic_lookup� ) r r r �mock�patch�objectr r rd re �link� call_args)r r- r` � mock_spawnr: rx �expectedr r r �,test_cc_overrides_ldshared_for_cxx_correctly� s8 ���� �� �P z>TestUnixCCompiler.test_cc_overrides_ldshared_for_cxx_correctlyc C s~ dd� }t jd�dd�}|t _|t _t� �}d|d< d|d < t �| j� W d � n1 s.w Y | jjd d ks=J �d S ) Nc S rR rS r rB r r r r- ( r. z5TestUnixCCompiler.test_explicit_ldshared.<locals>.gcvrW c W rY rZ r[ r^ r r r r` - ra z6TestUnixCCompiler.test_explicit_ldshared.<locals>.gcvsrb rH zmy_ld -bundle -dynamicrT r �my_ldrc rf r r r �test_explicit_ldshared# s �z(TestUnixCCompiler.test_explicit_ldsharedc C s& d| j _t�| �� � | j �d� d S )N�scratch�abort)r � output_dirr2 �chdir�mkdtemp� has_functionr r r r �test_has_function: s z#TestUnixCCompiler.test_has_functionc C s� t �� }dd� |_|�tjddd� � tjdkrdnd}d}|�|d �� d d �d |� �ks/J �|�t |�d �� d d �d |� �ksBJ �|�tjdd d� � |�|d �� d d �dksZJ �|�t |�d �� d d �dksjJ �d S )Nc S s | S rZ r )�dirr r r �<lambda>D s z:TestUnixCCompiler.test_find_library_file.<locals>.<lambda>�existsc S s d| v S )N�existingr ��dr r r r� E s �cygwinz libabc.dylibz cygabc.dll)z/foo/bar/missingz/foo/bar/existing�abc�\�/z/foo/bar/existing/c S s d| v o d| v o d| vS )Nr� z.az.dll.ar r� r r r r� U s z/foo/bar/existing/libabc.a) r r � _library_rootr r2 �pathr r �find_library_file�replace�reversed)r r �compiler�libname�dirsr r r �test_find_library_fileB s, ���� �z(TestUnixCCompiler.test_find_library_fileN) r r r r6 �mark�skipifrQ rg � usefixturesr{ r} r� r� r r r r r! " s > * r! )�__doc__r2 r � unittest.mockrt � distutilsr �distutils.compatr �distutils.errorsr �distutils.testsr �distutils.tests.compat.py39r �distutils.utilr r6 r@ r �fixturer r �TempdirManagerr! r r r r �<module> s" _distutils/compilers/C/tests/__pycache__/test_mingw.cpython-310.pyc 0000644 00000004622 15030122015 0021332 0 ustar 00 o �hl � @ sR d dl mZ d dlmZ d dlmZmZ d dlZddlm Z m Z G dd� d�Z dS ) � )� sysconfig)�DistutilsPlatformError)�is_mingw� split_quotedN� )�cygwin�errorsc @ s� e Zd Zejje� dd�dd� �Zejje� dd�dd� �Zejje� dd�dd� �Z ejje� dd�d d � �Z ej�d �d d � �Z dS )�TestMinGW32Compilerz not on mingw)�reasonc C s t �� }|jdks J �d S )N�mingw32)r �MinGW32Compiler� compiler_type��self�compiler� r �e/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py�test_compiler_type s z&TestMinGW32Compiler.test_compiler_typec C s~ |� dd� |� dd� t�� }|jtd�ksJ �|jtd�ks"J �|jtd�ks+J �|jtd�ks4J �|jtd�ks=J �d S ) N�CC�cc�CXXzc++z cc -O -Wallzcc -shared -O -Wallz c++ -O -Wallz cc -shared) �setenvr r r r � compiler_so� compiler_cxx� linker_exe� linker_so)r � monkeypatchr r r r �test_set_executables s z(TestMinGW32Compiler.test_set_executablesc C sB t �� }t�t�� |�d� W d � d S 1 sw Y d S )Nz/usr/lib)r r �pytest�raisesr �runtime_library_dir_optionr r r r � test_runtime_library_dir_option s "�z3TestMinGW32Compiler.test_runtime_library_dir_optionc C sL |� tddd� � t�tj�� t�� W d � d S 1 s w Y d S )N� is_cygwinccc S s dS )NTr )�_r r r �<lambda>% s z9TestMinGW32Compiler.test_cygwincc_error.<locals>.<lambda>)�setattrr r r r �Errorr )r r r r r �test_cygwincc_error# s "�z'TestMinGW32Compiler.test_cygwincc_errorzsys.platform == "cygwin"c C s t �� }t�|� d S )N)r r r �customize_compilerr r r r �(test_customize_compiler_with_msvc_python* s z<TestMinGW32Compiler.test_customize_compiler_with_msvc_pythonN) �__name__� __module__� __qualname__r �mark�skipifr r r r! r' r) r r r r r s r ) � distutilsr �distutils.errorsr �distutils.utilr r r � r r r r r r r �<module> s _distutils/compilers/C/tests/__pycache__/test_base.cpython-310.pyc 0000644 00000004575 15030122015 0021132 0 ustar 00 o �h� � @ sb d dl Z d dlZd dlZd dlZddlmZ ej�d�Zej dd� �Z dd� Z d d � Z d d � Z dS ) � N� )�base�suppress_path_manglec C sd | d }d}t �� dk}d| }|| }d�dd� |D ��}t�d��� �d |�}|j|d d � |S ) Nzfoo.c)zPython.h�Windows)z windows.h� c s s � | ] }d |� d�V qdS )z #include <z> N� )�.0�headerr r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py� <genexpr> s � zc_file.<locals>.<genexpr>z; #headers void PyInit_foo(void) {} z#headerszutf-8)�encoding)�platform�system�join�textwrap�dedent�lstrip�replace� write_text)�tmp_path�c_file� gen_headers� is_windows� plat_headers� all_headers�headers�payloadr r r r s �� r c C sH t �� }t�� d }|�|g� |�| g� |�|g� |�| g� dS )z� Extensions should build even if set_include_dirs is invoked. In particular, compiler-specific paths should not be overridden. �includeN)r � new_compiler� sysconfig� get_paths�set_include_dirs�compile�r �compiler�pythonr r r �test_set_include_dirs" s r& c C s� t �� } | �d�s J �| �d�sJ �tjdd�� | jddgd�s#J �W d � n1 s-w Y tjdd�� | jddgd�rCJ �W d � n1 sMw Y | �d�rYJ �tjdd�� | jddgd�rjJ �W d � d S 1 suw Y d S ) N�abort�exitzincludes is deprecated)�matchzstdlib.h)�includes�setuptools_does_not_existzstdio.h)r r � has_function�pytest�deprecated_call)r$ r r r �test_has_function_prototype1 s � � �"�r/ c C s\ t �� }t�� d }|�|g� |�| g� |j|gks J �|�| g� |j|gks,J �dS )z} Calling compile multiple times should not change the include dirs (regression test for setuptools issue #3591). r N)r r r r r! r" � include_dirsr# r r r �.test_include_dirs_after_multiple_compile_callsH s r1 )r r r r- � r �mark� usefixtures� pytestmark�fixturer r& r/ r1 r r r r �<module> s _distutils/compilers/C/tests/__pycache__/test_msvc.cpython-310.pyc 0000644 00000012007 15030122015 0021155 0 ustar 00 o �h7 � @ s� d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z d dl m Z d dl Z ddl mZ e j�d�ZG dd � d e j�ZG d d � d ej�ZG d d � d �ZdS )� N)�DistutilsPlatformError)�support)� get_platform� )�msvcznot hasattr(msvc, "winreg")c @ sx e Zd Zdd� Zejje�� � d� dd�ej� dddd e� fg�d d � ��Z e d d � �Z e ej� dd�dd� ��Zd S )�Testmsvccompilerc C sP dd� }|� td|� t�t�� t�d� W d � d S 1 s!w Y d S )Nc S s dS )N)NN� )� plat_specr r �d/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py�_find_vcvarsall s z:Testmsvccompiler.test_no_compiler.<locals>._find_vcvarsallr zwont find this version)�setattrr �pytest�raisesr � _get_vc_env)�self� monkeypatchr r r r �test_no_compiler s �"�z!Testmsvccompiler.test_no_compiler�winz-Only run test for non-mingw Windows platforms)�reasonzplat_name, expected)� win-arm64r )� win-amd64r Nc s0 t �� }� fdd�}|�t d|� |�|� dS )zS Ensure a specified target platform is passed to _get_vcvars_spec. c s |� ksJ �d S �Nr )� host_platform�platform��expectedr r �_get_vcvars_spec2 s zPTestmsvccompiler.test_cross_platform_compilation_paths.<locals>._get_vcvars_specr N)r �Compilerr � initialize)r r � plat_namer �compilerr r r r �%test_cross_platform_compilation_paths s z6Testmsvccompiler.test_cross_platform_compilation_pathsc C s� d}d}t j�dd �}|t j|< z)t�d�}|�� |v s J �|||�� ks(J �W t j�|� |r8|t jd< d S d S t j�|� |rG|t jd< w )Nu ṰḖṤṪ┅ṼẨṜu ₃⁴₅�DISTUTILS_USE_SDK�x86)�os�environ�popr r �lower)r �test_var� test_value�old_distutils_use_sdk�envr r r �test_get_vc_env_unicode8 s � � z(Testmsvccompiler.test_get_vc_env_unicode�ver�i� i� c C s^ t td|� ��}ddd�| }|� \}}|s t�d|� d�� ||ks%J �tj�|�s-J �d S )N�_find_vc� � r. zVS z is not installed)�getattrr r �skipr$ �path�isdir)r r- �lookup�expected_version�versionr4 r r r � test_get_vcI s z Testmsvccompiler.test_get_vc)�__name__� __module__� __qualname__r r �mark�skipif� sysconfigr � startswith� parametrizer! � needs_winregr, r9 r r r r r s& ��� r c s( e Zd ZdZ� fdd�Zdd� Z� ZS )� CheckThreadNc s0 zt � �� W d S ty t�� | _Y d S w r )�super�run� Exception�sys�exc_info�r �� __class__r r rE Z s �zCheckThread.runc C s | j S r )rH rI r r r �__bool__` s zCheckThread.__bool__)r: r; r< rH rE rL � __classcell__r r rJ r rC W s rC c @ s e Zd Zdd� Zdd� ZdS )� TestSpawnc sj t �� �d�_d}tjd|g� � �fdd�td�D �}|D ]}|�� q |D ]}|�� q&t|�s3J �dS )zK Concurrent calls to spawn should have consistent results. r z2import os; assert os.environ["PATH"] == "expected"z-cc s g | ] }t �j� gd ��qS ))�target�args)rC �spawn)�.0�n��commandr r r � <listcomp>n s �z2TestSpawn.test_concurrent_safe.<locals>.<listcomp>�d N) r r �_pathsrG � executable�range�start�join�all)r � inner_cmd�threads�threadr rT r �test_concurrent_safee s � z TestSpawn.test_concurrent_safec C sx ddl m} t�� }d|_dd� }tj�|jd|�� |� dg� W d � n1 s+w Y t j � d �dks:J �dS ) zy If CCompiler.spawn has been monkey-patched without support for an env, it should still execute. r )� ccompilerr c S s t jd dks J �dS )z A spawn without an env argument.�PATHr N)r$ r% )r �cmdr r r �CCompiler_spawn� s z@TestSpawn.test_concurrent_safe_fallback.<locals>.CCompiler_spawnrQ zn/aNrc ) � distutilsrb r r rX �mock�patch�object� CCompilerrQ r$ r% �get)r rb r re r r r � test_concurrent_safe_fallbackw s �z'TestSpawn.test_concurrent_safe_fallbackN)r: r; r< ra rl r r r r rN d s rN )r$ rG r? � threading� unittest.mockrg �distutils.errorsr �distutils.testsr �distutils.utilr r � r r= r> rB �TempdirManagerr �ThreadrC rN r r r r �<module> s F _distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-310.pyc 0000644 00000005561 15030122015 0021514 0 ustar 00 o �h� � @ sj d Z ddlZddlZddlmZ ddlmZ ddlZddlm Z ej dd�d d � �Z G d d � d ej �Z dS ) z$Tests for distutils.cygwinccompiler.� N)� sysconfig)�support� )�cygwinT)�autousec C s> | j }tj�|�� d�|_|�td|j� |�t dt j � d S )Nzpython.h�get_config_h_filename�version) �instance�os�path�join�mkdtemp�python_h�setattrr �_get_config_h_filename�sysr )�request� monkeypatch�distutils_managed_tempdir�self� r �f/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py�stuff s r c @ sl e Zd Zdd� Zej�d�ej�d�dd� ��Zej�d�dd� �Zd d � Z d d � Z ej�d�d d� �Z dS )�TestCygwinCCompilerc C s | j S �N)r �r r r r r s z*TestCygwinCCompiler._get_config_h_filenamezsys.platform != "cygwin"z,not os.path.exists("/usr/lib/libbash.dll.a")c C sZ ddl m} |� }d}|�dg|�}|d usJ �tj�|�s J �|d|d�d�ks+J �d S )Nr ��CygwinCCompiler�bashz/usr/libz /usr/lib/lib�sz.dll.a)�distutils.cygwinccompilerr �find_library_filer r �exists)r r �compiler� link_name� linkable_filer r r �test_find_library_file s z*TestCygwinCCompiler.test_find_library_filec C s( ddl m} |� }|�d�g ksJ �d S )Nr r z/foo)r r �runtime_library_dir_option�r r r# r r r � test_runtime_library_dir_option% s z3TestCygwinCCompiler.test_runtime_library_dir_optionc C s� dt _t�� d tjksJ �dt _t�� d tjks J �| �| jd� t�� d tjks.J �| �| jd� t�� d tjks@J �d S )NzX2.6.1 (r261:67515, Dec 6 2008, 16:42:21) [GCC 4.0.1 (Apple Computer, Inc. build 5370)]r z something without the *CC word�xxxzxxx __GNUC__ xxx) r r r �check_config_h� CONFIG_H_OK�CONFIG_H_UNCERTAIN� write_filer �CONFIG_H_NOTOKr r r r �test_check_config_h, s �z'TestCygwinCCompiler.test_check_config_hc C s t �� g ksJ �d S r )r � get_msvcrr r r r �test_get_msvcrD s z"TestCygwinCCompiler.test_get_msvcrc C s$ ddl m} |� }|jd usJ �d S )Nr r )r r � dll_librariesr( r r r �test_dll_libraries_not_noneG s z/TestCygwinCCompiler.test_dll_libraries_not_noneN) �__name__� __module__� __qualname__r �pytest�mark�skipifr& r) r0 r2 r4 r r r r r s r )�__doc__r r � distutilsr �distutils.testsr r8 � r �fixturer �TempdirManagerr r r r r �<module> s _distutils/compilers/C/tests/test_cygwin.py 0000644 00000005215 15030122015 0015151 0 ustar 00 """Tests for distutils.cygwinccompiler.""" import os import sys from distutils import sysconfig from distutils.tests import support import pytest from .. import cygwin @pytest.fixture(autouse=True) def stuff(request, monkeypatch, distutils_managed_tempdir): self = request.instance self.python_h = os.path.join(self.mkdtemp(), 'python.h') monkeypatch.setattr(sysconfig, 'get_config_h_filename', self._get_config_h_filename) monkeypatch.setattr(sys, 'version', sys.version) class TestCygwinCCompiler(support.TempdirManager): def _get_config_h_filename(self): return self.python_h @pytest.mark.skipif('sys.platform != "cygwin"') @pytest.mark.skipif('not os.path.exists("/usr/lib/libbash.dll.a")') def test_find_library_file(self): from distutils.cygwinccompiler import CygwinCCompiler compiler = CygwinCCompiler() link_name = "bash" linkable_file = compiler.find_library_file(["/usr/lib"], link_name) assert linkable_file is not None assert os.path.exists(linkable_file) assert linkable_file == f"/usr/lib/lib{link_name:s}.dll.a" @pytest.mark.skipif('sys.platform != "cygwin"') def test_runtime_library_dir_option(self): from distutils.cygwinccompiler import CygwinCCompiler compiler = CygwinCCompiler() assert compiler.runtime_library_dir_option('/foo') == [] def test_check_config_h(self): # check_config_h looks for "GCC" in sys.version first # returns CONFIG_H_OK if found sys.version = ( '2.6.1 (r261:67515, Dec 6 2008, 16:42:21) \n[GCC ' '4.0.1 (Apple Computer, Inc. build 5370)]' ) assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_OK # then it tries to see if it can find "__GNUC__" in pyconfig.h sys.version = 'something without the *CC word' # if the file doesn't exist it returns CONFIG_H_UNCERTAIN assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_UNCERTAIN # if it exists but does not contain __GNUC__, it returns CONFIG_H_NOTOK self.write_file(self.python_h, 'xxx') assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_NOTOK # and CONFIG_H_OK if __GNUC__ is found self.write_file(self.python_h, 'xxx __GNUC__ xxx') assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_OK def test_get_msvcr(self): assert cygwin.get_msvcr() == [] @pytest.mark.skipif('sys.platform != "cygwin"') def test_dll_libraries_not_none(self): from distutils.cygwinccompiler import CygwinCCompiler compiler = CygwinCCompiler() assert compiler.dll_libraries is not None _distutils/compilers/C/tests/test_base.py 0000644 00000005222 15030122015 0014561 0 ustar 00 import platform import sysconfig import textwrap import pytest from .. import base pytestmark = pytest.mark.usefixtures('suppress_path_mangle') @pytest.fixture def c_file(tmp_path): c_file = tmp_path / 'foo.c' gen_headers = ('Python.h',) is_windows = platform.system() == "Windows" plat_headers = ('windows.h',) * is_windows all_headers = gen_headers + plat_headers headers = '\n'.join(f'#include <{header}>\n' for header in all_headers) payload = ( textwrap.dedent( """ #headers void PyInit_foo(void) {} """ ) .lstrip() .replace('#headers', headers) ) c_file.write_text(payload, encoding='utf-8') return c_file def test_set_include_dirs(c_file): """ Extensions should build even if set_include_dirs is invoked. In particular, compiler-specific paths should not be overridden. """ compiler = base.new_compiler() python = sysconfig.get_paths()['include'] compiler.set_include_dirs([python]) compiler.compile([c_file]) # do it again, setting include dirs after any initialization compiler.set_include_dirs([python]) compiler.compile([c_file]) def test_has_function_prototype(): # Issue https://github.com/pypa/setuptools/issues/3648 # Test prototype-generating behavior. compiler = base.new_compiler() # Every C implementation should have these. assert compiler.has_function('abort') assert compiler.has_function('exit') with pytest.deprecated_call(match='includes is deprecated'): # abort() is a valid expression with the <stdlib.h> prototype. assert compiler.has_function('abort', includes=['stdlib.h']) with pytest.deprecated_call(match='includes is deprecated'): # But exit() is not valid with the actual prototype in scope. assert not compiler.has_function('exit', includes=['stdlib.h']) # And setuptools_does_not_exist is not declared or defined at all. assert not compiler.has_function('setuptools_does_not_exist') with pytest.deprecated_call(match='includes is deprecated'): assert not compiler.has_function( 'setuptools_does_not_exist', includes=['stdio.h'] ) def test_include_dirs_after_multiple_compile_calls(c_file): """ Calling compile multiple times should not change the include dirs (regression test for setuptools issue #3591). """ compiler = base.new_compiler() python = sysconfig.get_paths()['include'] compiler.set_include_dirs([python]) compiler.compile([c_file]) assert compiler.include_dirs == [python] compiler.compile([c_file]) assert compiler.include_dirs == [python] _distutils/compilers/C/tests/test_mingw.py 0000644 00000003554 15030122015 0014776 0 ustar 00 from distutils import sysconfig from distutils.errors import DistutilsPlatformError from distutils.util import is_mingw, split_quoted import pytest from .. import cygwin, errors class TestMinGW32Compiler: @pytest.mark.skipif(not is_mingw(), reason='not on mingw') def test_compiler_type(self): compiler = cygwin.MinGW32Compiler() assert compiler.compiler_type == 'mingw32' @pytest.mark.skipif(not is_mingw(), reason='not on mingw') def test_set_executables(self, monkeypatch): monkeypatch.setenv('CC', 'cc') monkeypatch.setenv('CXX', 'c++') compiler = cygwin.MinGW32Compiler() assert compiler.compiler == split_quoted('cc -O -Wall') assert compiler.compiler_so == split_quoted('cc -shared -O -Wall') assert compiler.compiler_cxx == split_quoted('c++ -O -Wall') assert compiler.linker_exe == split_quoted('cc') assert compiler.linker_so == split_quoted('cc -shared') @pytest.mark.skipif(not is_mingw(), reason='not on mingw') def test_runtime_library_dir_option(self): compiler = cygwin.MinGW32Compiler() with pytest.raises(DistutilsPlatformError): compiler.runtime_library_dir_option('/usr/lib') @pytest.mark.skipif(not is_mingw(), reason='not on mingw') def test_cygwincc_error(self, monkeypatch): monkeypatch.setattr(cygwin, 'is_cygwincc', lambda _: True) with pytest.raises(errors.Error): cygwin.MinGW32Compiler() @pytest.mark.skipif('sys.platform == "cygwin"') def test_customize_compiler_with_msvc_python(self): # In case we have an MSVC Python build, but still want to use # MinGW32Compiler, then customize_compiler() shouldn't fail at least. # https://github.com/pypa/setuptools/issues/4456 compiler = cygwin.MinGW32Compiler() sysconfig.customize_compiler(compiler) _distutils/compilers/C/tests/test_unix.py 0000644 00000027072 15030122015 0014641 0 ustar 00 """Tests for distutils.unixccompiler.""" import os import sys import unittest.mock as mock from distutils import sysconfig from distutils.compat import consolidate_linker_args from distutils.errors import DistutilsPlatformError from distutils.tests import support from distutils.tests.compat.py39 import EnvironmentVarGuard from distutils.util import _clear_cached_macosx_ver import pytest from .. import unix @pytest.fixture(autouse=True) def save_values(monkeypatch): monkeypatch.setattr(sys, 'platform', sys.platform) monkeypatch.setattr(sysconfig, 'get_config_var', sysconfig.get_config_var) monkeypatch.setattr(sysconfig, 'get_config_vars', sysconfig.get_config_vars) @pytest.fixture(autouse=True) def compiler_wrapper(request): class CompilerWrapper(unix.Compiler): def rpath_foo(self): return self.runtime_library_dir_option('/foo') request.instance.cc = CompilerWrapper() class TestUnixCCompiler(support.TempdirManager): @pytest.mark.skipif('platform.system == "Windows"') def test_runtime_libdir_option(self): # noqa: C901 # Issue #5900; GitHub Issue #37 # # Ensure RUNPATH is added to extension modules with RPATH if # GNU ld is used # darwin sys.platform = 'darwin' darwin_ver_var = 'MACOSX_DEPLOYMENT_TARGET' darwin_rpath_flag = '-Wl,-rpath,/foo' darwin_lib_flag = '-L/foo' # (macOS version from syscfg, macOS version from env var) -> flag # Version value of None generates two tests: as None and as empty string # Expected flag value of None means an mismatch exception is expected darwin_test_cases = [ ((None, None), darwin_lib_flag), ((None, '11'), darwin_rpath_flag), (('10', None), darwin_lib_flag), (('10.3', None), darwin_lib_flag), (('10.3.1', None), darwin_lib_flag), (('10.5', None), darwin_rpath_flag), (('10.5.1', None), darwin_rpath_flag), (('10.3', '10.3'), darwin_lib_flag), (('10.3', '10.5'), darwin_rpath_flag), (('10.5', '10.3'), darwin_lib_flag), (('10.5', '11'), darwin_rpath_flag), (('10.4', '10'), None), ] def make_darwin_gcv(syscfg_macosx_ver): def gcv(var): if var == darwin_ver_var: return syscfg_macosx_ver return "xxx" return gcv def do_darwin_test(syscfg_macosx_ver, env_macosx_ver, expected_flag): env = os.environ msg = f"macOS version = (sysconfig={syscfg_macosx_ver!r}, env={env_macosx_ver!r})" # Save old_gcv = sysconfig.get_config_var old_env_macosx_ver = env.get(darwin_ver_var) # Setup environment _clear_cached_macosx_ver() sysconfig.get_config_var = make_darwin_gcv(syscfg_macosx_ver) if env_macosx_ver is not None: env[darwin_ver_var] = env_macosx_ver elif darwin_ver_var in env: env.pop(darwin_ver_var) # Run the test if expected_flag is not None: assert self.cc.rpath_foo() == expected_flag, msg else: with pytest.raises( DistutilsPlatformError, match=darwin_ver_var + r' mismatch' ): self.cc.rpath_foo() # Restore if old_env_macosx_ver is not None: env[darwin_ver_var] = old_env_macosx_ver elif darwin_ver_var in env: env.pop(darwin_ver_var) sysconfig.get_config_var = old_gcv _clear_cached_macosx_ver() for macosx_vers, expected_flag in darwin_test_cases: syscfg_macosx_ver, env_macosx_ver = macosx_vers do_darwin_test(syscfg_macosx_ver, env_macosx_ver, expected_flag) # Bonus test cases with None interpreted as empty string if syscfg_macosx_ver is None: do_darwin_test("", env_macosx_ver, expected_flag) if env_macosx_ver is None: do_darwin_test(syscfg_macosx_ver, "", expected_flag) if syscfg_macosx_ver is None and env_macosx_ver is None: do_darwin_test("", "", expected_flag) old_gcv = sysconfig.get_config_var # hp-ux sys.platform = 'hp-ux' def gcv(v): return 'xxx' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == ['+s', '-L/foo'] def gcv(v): return 'gcc' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == ['-Wl,+s', '-L/foo'] def gcv(v): return 'g++' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == ['-Wl,+s', '-L/foo'] sysconfig.get_config_var = old_gcv # GCC GNULD sys.platform = 'bar' def gcv(v): if v == 'CC': return 'gcc' elif v == 'GNULD': return 'yes' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == consolidate_linker_args([ '-Wl,--enable-new-dtags', '-Wl,-rpath,/foo', ]) def gcv(v): if v == 'CC': return 'gcc -pthread -B /bar' elif v == 'GNULD': return 'yes' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == consolidate_linker_args([ '-Wl,--enable-new-dtags', '-Wl,-rpath,/foo', ]) # GCC non-GNULD sys.platform = 'bar' def gcv(v): if v == 'CC': return 'gcc' elif v == 'GNULD': return 'no' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == '-Wl,-R/foo' # GCC GNULD with fully qualified configuration prefix # see #7617 sys.platform = 'bar' def gcv(v): if v == 'CC': return 'x86_64-pc-linux-gnu-gcc-4.4.2' elif v == 'GNULD': return 'yes' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == consolidate_linker_args([ '-Wl,--enable-new-dtags', '-Wl,-rpath,/foo', ]) # non-GCC GNULD sys.platform = 'bar' def gcv(v): if v == 'CC': return 'cc' elif v == 'GNULD': return 'yes' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == consolidate_linker_args([ '-Wl,--enable-new-dtags', '-Wl,-rpath,/foo', ]) # non-GCC non-GNULD sys.platform = 'bar' def gcv(v): if v == 'CC': return 'cc' elif v == 'GNULD': return 'no' sysconfig.get_config_var = gcv assert self.cc.rpath_foo() == '-Wl,-R/foo' @pytest.mark.skipif('platform.system == "Windows"') def test_cc_overrides_ldshared(self): # Issue #18080: # ensure that setting CC env variable also changes default linker def gcv(v): if v == 'LDSHARED': return 'gcc-4.2 -bundle -undefined dynamic_lookup ' return 'gcc-4.2' def gcvs(*args, _orig=sysconfig.get_config_vars): if args: return list(map(sysconfig.get_config_var, args)) return _orig() sysconfig.get_config_var = gcv sysconfig.get_config_vars = gcvs with EnvironmentVarGuard() as env: env['CC'] = 'my_cc' del env['LDSHARED'] sysconfig.customize_compiler(self.cc) assert self.cc.linker_so[0] == 'my_cc' @pytest.mark.skipif('platform.system == "Windows"') @pytest.mark.usefixtures('disable_macos_customization') def test_cc_overrides_ldshared_for_cxx_correctly(self): """ Ensure that setting CC env variable also changes default linker correctly when building C++ extensions. pypa/distutils#126 """ def gcv(v): if v == 'LDSHARED': return 'gcc-4.2 -bundle -undefined dynamic_lookup ' elif v == 'LDCXXSHARED': return 'g++-4.2 -bundle -undefined dynamic_lookup ' elif v == 'CXX': return 'g++-4.2' elif v == 'CC': return 'gcc-4.2' return '' def gcvs(*args, _orig=sysconfig.get_config_vars): if args: return list(map(sysconfig.get_config_var, args)) return _orig() sysconfig.get_config_var = gcv sysconfig.get_config_vars = gcvs with ( mock.patch.object(self.cc, 'spawn', return_value=None) as mock_spawn, mock.patch.object(self.cc, '_need_link', return_value=True), mock.patch.object(self.cc, 'mkpath', return_value=None), EnvironmentVarGuard() as env, ): env['CC'] = 'ccache my_cc' env['CXX'] = 'my_cxx' del env['LDSHARED'] sysconfig.customize_compiler(self.cc) assert self.cc.linker_so[0:2] == ['ccache', 'my_cc'] self.cc.link(None, [], 'a.out', target_lang='c++') call_args = mock_spawn.call_args[0][0] expected = ['my_cxx', '-bundle', '-undefined', 'dynamic_lookup'] assert call_args[:4] == expected @pytest.mark.skipif('platform.system == "Windows"') def test_explicit_ldshared(self): # Issue #18080: # ensure that setting CC env variable does not change # explicit LDSHARED setting for linker def gcv(v): if v == 'LDSHARED': return 'gcc-4.2 -bundle -undefined dynamic_lookup ' return 'gcc-4.2' def gcvs(*args, _orig=sysconfig.get_config_vars): if args: return list(map(sysconfig.get_config_var, args)) return _orig() sysconfig.get_config_var = gcv sysconfig.get_config_vars = gcvs with EnvironmentVarGuard() as env: env['CC'] = 'my_cc' env['LDSHARED'] = 'my_ld -bundle -dynamic' sysconfig.customize_compiler(self.cc) assert self.cc.linker_so[0] == 'my_ld' def test_has_function(self): # Issue https://github.com/pypa/distutils/issues/64: # ensure that setting output_dir does not raise # FileNotFoundError: [Errno 2] No such file or directory: 'a.out' self.cc.output_dir = 'scratch' os.chdir(self.mkdtemp()) self.cc.has_function('abort') def test_find_library_file(self, monkeypatch): compiler = unix.Compiler() compiler._library_root = lambda dir: dir monkeypatch.setattr(os.path, 'exists', lambda d: 'existing' in d) libname = 'libabc.dylib' if sys.platform != 'cygwin' else 'cygabc.dll' dirs = ('/foo/bar/missing', '/foo/bar/existing') assert ( compiler.find_library_file(dirs, 'abc').replace('\\', '/') == f'/foo/bar/existing/{libname}' ) assert ( compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/') == f'/foo/bar/existing/{libname}' ) monkeypatch.setattr( os.path, 'exists', lambda d: 'existing' in d and '.a' in d and '.dll.a' not in d, ) assert ( compiler.find_library_file(dirs, 'abc').replace('\\', '/') == '/foo/bar/existing/libabc.a' ) assert ( compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/') == '/foo/bar/existing/libabc.a' ) _distutils/compilers/C/tests/test_msvc.py 0000644 00000010067 15030122015 0014622 0 ustar 00 import os import sys import sysconfig import threading import unittest.mock as mock from distutils.errors import DistutilsPlatformError from distutils.tests import support from distutils.util import get_platform import pytest from .. import msvc needs_winreg = pytest.mark.skipif('not hasattr(msvc, "winreg")') class Testmsvccompiler(support.TempdirManager): def test_no_compiler(self, monkeypatch): # makes sure query_vcvarsall raises # a DistutilsPlatformError if the compiler # is not found def _find_vcvarsall(plat_spec): return None, None monkeypatch.setattr(msvc, '_find_vcvarsall', _find_vcvarsall) with pytest.raises(DistutilsPlatformError): msvc._get_vc_env( 'wont find this version', ) @pytest.mark.skipif( not sysconfig.get_platform().startswith("win"), reason="Only run test for non-mingw Windows platforms", ) @pytest.mark.parametrize( "plat_name, expected", [ ("win-arm64", "win-arm64"), ("win-amd64", "win-amd64"), (None, get_platform()), ], ) def test_cross_platform_compilation_paths(self, monkeypatch, plat_name, expected): """ Ensure a specified target platform is passed to _get_vcvars_spec. """ compiler = msvc.Compiler() def _get_vcvars_spec(host_platform, platform): assert platform == expected monkeypatch.setattr(msvc, '_get_vcvars_spec', _get_vcvars_spec) compiler.initialize(plat_name) @needs_winreg def test_get_vc_env_unicode(self): test_var = 'ṰḖṤṪ┅ṼẨṜ' test_value = '₃⁴₅' # Ensure we don't early exit from _get_vc_env old_distutils_use_sdk = os.environ.pop('DISTUTILS_USE_SDK', None) os.environ[test_var] = test_value try: env = msvc._get_vc_env('x86') assert test_var.lower() in env assert test_value == env[test_var.lower()] finally: os.environ.pop(test_var) if old_distutils_use_sdk: os.environ['DISTUTILS_USE_SDK'] = old_distutils_use_sdk @needs_winreg @pytest.mark.parametrize('ver', (2015, 2017)) def test_get_vc(self, ver): # This function cannot be mocked, so pass if VC is found # and skip otherwise. lookup = getattr(msvc, f'_find_vc{ver}') expected_version = {2015: 14, 2017: 15}[ver] version, path = lookup() if not version: pytest.skip(f"VS {ver} is not installed") assert version >= expected_version assert os.path.isdir(path) class CheckThread(threading.Thread): exc_info = None def run(self): try: super().run() except Exception: self.exc_info = sys.exc_info() def __bool__(self): return not self.exc_info class TestSpawn: def test_concurrent_safe(self): """ Concurrent calls to spawn should have consistent results. """ compiler = msvc.Compiler() compiler._paths = "expected" inner_cmd = 'import os; assert os.environ["PATH"] == "expected"' command = [sys.executable, '-c', inner_cmd] threads = [ CheckThread(target=compiler.spawn, args=[command]) for n in range(100) ] for thread in threads: thread.start() for thread in threads: thread.join() assert all(threads) def test_concurrent_safe_fallback(self): """ If CCompiler.spawn has been monkey-patched without support for an env, it should still execute. """ from distutils import ccompiler compiler = msvc.Compiler() compiler._paths = "expected" def CCompiler_spawn(self, cmd): "A spawn without an env argument." assert os.environ["PATH"] == "expected" with mock.patch.object(ccompiler.CCompiler, 'spawn', CCompiler_spawn): compiler.spawn(["n/a"]) assert os.environ.get("PATH") != "expected" _distutils/compilers/C/base.py 0000644 00000153134 15030122015 0012366 0 ustar 00 """distutils.ccompiler Contains Compiler, an abstract base class that defines the interface for the Distutils compiler abstraction model.""" from __future__ import annotations import os import pathlib import re import sys import warnings from collections.abc import Callable, Iterable, MutableSequence, Sequence from typing import ( TYPE_CHECKING, ClassVar, Literal, TypeVar, Union, overload, ) from more_itertools import always_iterable from ..._log import log from ..._modified import newer_group from ...dir_util import mkpath from ...errors import ( DistutilsModuleError, DistutilsPlatformError, ) from ...file_util import move_file from ...spawn import spawn from ...util import execute, is_mingw, split_quoted from .errors import ( CompileError, LinkError, UnknownFileType, ) if TYPE_CHECKING: from typing_extensions import TypeAlias, TypeVarTuple, Unpack _Ts = TypeVarTuple("_Ts") _Macro: TypeAlias = Union[tuple[str], tuple[str, Union[str, None]]] _StrPathT = TypeVar("_StrPathT", bound="str | os.PathLike[str]") _BytesPathT = TypeVar("_BytesPathT", bound="bytes | os.PathLike[bytes]") class Compiler: """Abstract base class to define the interface that must be implemented by real compiler classes. Also has some utility methods used by several compiler classes. The basic idea behind a compiler abstraction class is that each instance can be used for all the compile/link steps in building a single project. Thus, attributes common to all of those compile and link steps -- include directories, macros to define, libraries to link against, etc. -- are attributes of the compiler instance. To allow for variability in how individual files are treated, most of those attributes may be varied on a per-compilation or per-link basis. """ # 'compiler_type' is a class attribute that identifies this class. It # keeps code that wants to know what kind of compiler it's dealing with # from having to import all possible compiler classes just to do an # 'isinstance'. In concrete CCompiler subclasses, 'compiler_type' # should really, really be one of the keys of the 'compiler_class' # dictionary (see below -- used by the 'new_compiler()' factory # function) -- authors of new compiler interface classes are # responsible for updating 'compiler_class'! compiler_type: ClassVar[str] = None # type: ignore[assignment] # XXX things not handled by this compiler abstraction model: # * client can't provide additional options for a compiler, # e.g. warning, optimization, debugging flags. Perhaps this # should be the domain of concrete compiler abstraction classes # (UnixCCompiler, MSVCCompiler, etc.) -- or perhaps the base # class should have methods for the common ones. # * can't completely override the include or library searchg # path, ie. no "cc -I -Idir1 -Idir2" or "cc -L -Ldir1 -Ldir2". # I'm not sure how widely supported this is even by Unix # compilers, much less on other platforms. And I'm even less # sure how useful it is; maybe for cross-compiling, but # support for that is a ways off. (And anyways, cross # compilers probably have a dedicated binary with the # right paths compiled in. I hope.) # * can't do really freaky things with the library list/library # dirs, e.g. "-Ldir1 -lfoo -Ldir2 -lfoo" to link against # different versions of libfoo.a in different locations. I # think this is useless without the ability to null out the # library search path anyways. executables: ClassVar[dict] # Subclasses that rely on the standard filename generation methods # implemented below should override these; see the comment near # those methods ('object_filenames()' et. al.) for details: src_extensions: ClassVar[list[str] | None] = None obj_extension: ClassVar[str | None] = None static_lib_extension: ClassVar[str | None] = None shared_lib_extension: ClassVar[str | None] = None static_lib_format: ClassVar[str | None] = None # format string shared_lib_format: ClassVar[str | None] = None # prob. same as static_lib_format exe_extension: ClassVar[str | None] = None # Default language settings. language_map is used to detect a source # file or Extension target language, checking source filenames. # language_order is used to detect the language precedence, when deciding # what language to use when mixing source types. For example, if some # extension has two files with ".c" extension, and one with ".cpp", it # is still linked as c++. language_map: ClassVar[dict[str, str]] = { ".c": "c", ".cc": "c++", ".cpp": "c++", ".cxx": "c++", ".m": "objc", } language_order: ClassVar[list[str]] = ["c++", "objc", "c"] include_dirs: list[str] = [] """ include dirs specific to this compiler class """ library_dirs: list[str] = [] """ library dirs specific to this compiler class """ def __init__( self, verbose: bool = False, dry_run: bool = False, force: bool = False ) -> None: self.dry_run = dry_run self.force = force self.verbose = verbose # 'output_dir': a common output directory for object, library, # shared object, and shared library files self.output_dir: str | None = None # 'macros': a list of macro definitions (or undefinitions). A # macro definition is a 2-tuple (name, value), where the value is # either a string or None (no explicit value). A macro # undefinition is a 1-tuple (name,). self.macros: list[_Macro] = [] # 'include_dirs': a list of directories to search for include files self.include_dirs = [] # 'libraries': a list of libraries to include in any link # (library names, not filenames: eg. "foo" not "libfoo.a") self.libraries: list[str] = [] # 'library_dirs': a list of directories to search for libraries self.library_dirs = [] # 'runtime_library_dirs': a list of directories to search for # shared libraries/objects at runtime self.runtime_library_dirs: list[str] = [] # 'objects': a list of object files (or similar, such as explicitly # named library files) to include on any link self.objects: list[str] = [] for key in self.executables.keys(): self.set_executable(key, self.executables[key]) def set_executables(self, **kwargs: str) -> None: """Define the executables (and options for them) that will be run to perform the various stages of compilation. The exact set of executables that may be specified here depends on the compiler class (via the 'executables' class attribute), but most will have: compiler the C/C++ compiler linker_so linker used to create shared objects and libraries linker_exe linker used to create binary executables archiver static library creator On platforms with a command-line (Unix, DOS/Windows), each of these is a string that will be split into executable name and (optional) list of arguments. (Splitting the string is done similarly to how Unix shells operate: words are delimited by spaces, but quotes and backslashes can override this. See 'distutils.util.split_quoted()'.) """ # Note that some CCompiler implementation classes will define class # attributes 'cpp', 'cc', etc. with hard-coded executable names; # this is appropriate when a compiler class is for exactly one # compiler/OS combination (eg. MSVCCompiler). Other compiler # classes (UnixCCompiler, in particular) are driven by information # discovered at run-time, since there are many different ways to do # basically the same things with Unix C compilers. for key in kwargs: if key not in self.executables: raise ValueError( f"unknown executable '{key}' for class {self.__class__.__name__}" ) self.set_executable(key, kwargs[key]) def set_executable(self, key, value): if isinstance(value, str): setattr(self, key, split_quoted(value)) else: setattr(self, key, value) def _find_macro(self, name): i = 0 for defn in self.macros: if defn[0] == name: return i i += 1 return None def _check_macro_definitions(self, definitions): """Ensure that every element of 'definitions' is valid.""" for defn in definitions: self._check_macro_definition(*defn) def _check_macro_definition(self, defn): """ Raise a TypeError if defn is not valid. A valid definition is either a (name, value) 2-tuple or a (name,) tuple. """ if not isinstance(defn, tuple) or not self._is_valid_macro(*defn): raise TypeError( f"invalid macro definition '{defn}': " "must be tuple (string,), (string, string), or (string, None)" ) @staticmethod def _is_valid_macro(name, value=None): """ A valid macro is a ``name : str`` and a ``value : str | None``. >>> Compiler._is_valid_macro('foo', None) True """ return isinstance(name, str) and isinstance(value, (str, type(None))) # -- Bookkeeping methods ------------------------------------------- def define_macro(self, name: str, value: str | None = None) -> None: """Define a preprocessor macro for all compilations driven by this compiler object. The optional parameter 'value' should be a string; if it is not supplied, then the macro will be defined without an explicit value and the exact outcome depends on the compiler used (XXX true? does ANSI say anything about this?) """ # Delete from the list of macro definitions/undefinitions if # already there (so that this one will take precedence). i = self._find_macro(name) if i is not None: del self.macros[i] self.macros.append((name, value)) def undefine_macro(self, name: str) -> None: """Undefine a preprocessor macro for all compilations driven by this compiler object. If the same macro is defined by 'define_macro()' and undefined by 'undefine_macro()' the last call takes precedence (including multiple redefinitions or undefinitions). If the macro is redefined/undefined on a per-compilation basis (ie. in the call to 'compile()'), then that takes precedence. """ # Delete from the list of macro definitions/undefinitions if # already there (so that this one will take precedence). i = self._find_macro(name) if i is not None: del self.macros[i] undefn = (name,) self.macros.append(undefn) def add_include_dir(self, dir: str) -> None: """Add 'dir' to the list of directories that will be searched for header files. The compiler is instructed to search directories in the order in which they are supplied by successive calls to 'add_include_dir()'. """ self.include_dirs.append(dir) def set_include_dirs(self, dirs: list[str]) -> None: """Set the list of directories that will be searched to 'dirs' (a list of strings). Overrides any preceding calls to 'add_include_dir()'; subsequence calls to 'add_include_dir()' add to the list passed to 'set_include_dirs()'. This does not affect any list of standard include directories that the compiler may search by default. """ self.include_dirs = dirs[:] def add_library(self, libname: str) -> None: """Add 'libname' to the list of libraries that will be included in all links driven by this compiler object. Note that 'libname' should *not* be the name of a file containing a library, but the name of the library itself: the actual filename will be inferred by the linker, the compiler, or the compiler class (depending on the platform). The linker will be instructed to link against libraries in the order they were supplied to 'add_library()' and/or 'set_libraries()'. It is perfectly valid to duplicate library names; the linker will be instructed to link against libraries as many times as they are mentioned. """ self.libraries.append(libname) def set_libraries(self, libnames: list[str]) -> None: """Set the list of libraries to be included in all links driven by this compiler object to 'libnames' (a list of strings). This does not affect any standard system libraries that the linker may include by default. """ self.libraries = libnames[:] def add_library_dir(self, dir: str) -> None: """Add 'dir' to the list of directories that will be searched for libraries specified to 'add_library()' and 'set_libraries()'. The linker will be instructed to search for libraries in the order they are supplied to 'add_library_dir()' and/or 'set_library_dirs()'. """ self.library_dirs.append(dir) def set_library_dirs(self, dirs: list[str]) -> None: """Set the list of library search directories to 'dirs' (a list of strings). This does not affect any standard library search path that the linker may search by default. """ self.library_dirs = dirs[:] def add_runtime_library_dir(self, dir: str) -> None: """Add 'dir' to the list of directories that will be searched for shared libraries at runtime. """ self.runtime_library_dirs.append(dir) def set_runtime_library_dirs(self, dirs: list[str]) -> None: """Set the list of directories to search for shared libraries at runtime to 'dirs' (a list of strings). This does not affect any standard search path that the runtime linker may search by default. """ self.runtime_library_dirs = dirs[:] def add_link_object(self, object: str) -> None: """Add 'object' to the list of object files (or analogues, such as explicitly named library files or the output of "resource compilers") to be included in every link driven by this compiler object. """ self.objects.append(object) def set_link_objects(self, objects: list[str]) -> None: """Set the list of object files (or analogues) to be included in every link to 'objects'. This does not affect any standard object files that the linker may include by default (such as system libraries). """ self.objects = objects[:] # -- Private utility methods -------------------------------------- # (here for the convenience of subclasses) # Helper method to prep compiler in subclass compile() methods def _setup_compile( self, outdir: str | None, macros: list[_Macro] | None, incdirs: list[str] | tuple[str, ...] | None, sources, depends, extra, ): """Process arguments and decide which source files to compile.""" outdir, macros, incdirs = self._fix_compile_args(outdir, macros, incdirs) if extra is None: extra = [] # Get the list of expected output (object) files objects = self.object_filenames(sources, strip_dir=False, output_dir=outdir) assert len(objects) == len(sources) pp_opts = gen_preprocess_options(macros, incdirs) build = {} for i in range(len(sources)): src = sources[i] obj = objects[i] ext = os.path.splitext(src)[1] self.mkpath(os.path.dirname(obj)) build[obj] = (src, ext) return macros, objects, extra, pp_opts, build def _get_cc_args(self, pp_opts, debug, before): # works for unixccompiler, cygwinccompiler cc_args = pp_opts + ['-c'] if debug: cc_args[:0] = ['-g'] if before: cc_args[:0] = before return cc_args def _fix_compile_args( self, output_dir: str | None, macros: list[_Macro] | None, include_dirs: list[str] | tuple[str, ...] | None, ) -> tuple[str, list[_Macro], list[str]]: """Typecheck and fix-up some of the arguments to the 'compile()' method, and return fixed-up values. Specifically: if 'output_dir' is None, replaces it with 'self.output_dir'; ensures that 'macros' is a list, and augments it with 'self.macros'; ensures that 'include_dirs' is a list, and augments it with 'self.include_dirs'. Guarantees that the returned values are of the correct type, i.e. for 'output_dir' either string or None, and for 'macros' and 'include_dirs' either list or None. """ if output_dir is None: output_dir = self.output_dir elif not isinstance(output_dir, str): raise TypeError("'output_dir' must be a string or None") if macros is None: macros = list(self.macros) elif isinstance(macros, list): macros = macros + (self.macros or []) else: raise TypeError("'macros' (if supplied) must be a list of tuples") if include_dirs is None: include_dirs = list(self.include_dirs) elif isinstance(include_dirs, (list, tuple)): include_dirs = list(include_dirs) + (self.include_dirs or []) else: raise TypeError("'include_dirs' (if supplied) must be a list of strings") # add include dirs for class include_dirs += self.__class__.include_dirs return output_dir, macros, include_dirs def _prep_compile(self, sources, output_dir, depends=None): """Decide which source files must be recompiled. Determine the list of object files corresponding to 'sources', and figure out which ones really need to be recompiled. Return a list of all object files and a dictionary telling which source files can be skipped. """ # Get the list of expected output (object) files objects = self.object_filenames(sources, output_dir=output_dir) assert len(objects) == len(sources) # Return an empty dict for the "which source files can be skipped" # return value to preserve API compatibility. return objects, {} def _fix_object_args( self, objects: list[str] | tuple[str, ...], output_dir: str | None ) -> tuple[list[str], str]: """Typecheck and fix up some arguments supplied to various methods. Specifically: ensure that 'objects' is a list; if output_dir is None, replace with self.output_dir. Return fixed versions of 'objects' and 'output_dir'. """ if not isinstance(objects, (list, tuple)): raise TypeError("'objects' must be a list or tuple of strings") objects = list(objects) if output_dir is None: output_dir = self.output_dir elif not isinstance(output_dir, str): raise TypeError("'output_dir' must be a string or None") return (objects, output_dir) def _fix_lib_args( self, libraries: list[str] | tuple[str, ...] | None, library_dirs: list[str] | tuple[str, ...] | None, runtime_library_dirs: list[str] | tuple[str, ...] | None, ) -> tuple[list[str], list[str], list[str]]: """Typecheck and fix up some of the arguments supplied to the 'link_*' methods. Specifically: ensure that all arguments are lists, and augment them with their permanent versions (eg. 'self.libraries' augments 'libraries'). Return a tuple with fixed versions of all arguments. """ if libraries is None: libraries = list(self.libraries) elif isinstance(libraries, (list, tuple)): libraries = list(libraries) + (self.libraries or []) else: raise TypeError("'libraries' (if supplied) must be a list of strings") if library_dirs is None: library_dirs = list(self.library_dirs) elif isinstance(library_dirs, (list, tuple)): library_dirs = list(library_dirs) + (self.library_dirs or []) else: raise TypeError("'library_dirs' (if supplied) must be a list of strings") # add library dirs for class library_dirs += self.__class__.library_dirs if runtime_library_dirs is None: runtime_library_dirs = list(self.runtime_library_dirs) elif isinstance(runtime_library_dirs, (list, tuple)): runtime_library_dirs = list(runtime_library_dirs) + ( self.runtime_library_dirs or [] ) else: raise TypeError( "'runtime_library_dirs' (if supplied) must be a list of strings" ) return (libraries, library_dirs, runtime_library_dirs) def _need_link(self, objects, output_file): """Return true if we need to relink the files listed in 'objects' to recreate 'output_file'. """ if self.force: return True else: if self.dry_run: newer = newer_group(objects, output_file, missing='newer') else: newer = newer_group(objects, output_file) return newer def detect_language(self, sources: str | list[str]) -> str | None: """Detect the language of a given file, or list of files. Uses language_map, and language_order to do the job. """ if not isinstance(sources, list): sources = [sources] lang = None index = len(self.language_order) for source in sources: base, ext = os.path.splitext(source) extlang = self.language_map.get(ext) try: extindex = self.language_order.index(extlang) if extindex < index: lang = extlang index = extindex except ValueError: pass return lang # -- Worker methods ------------------------------------------------ # (must be implemented by subclasses) def preprocess( self, source: str | os.PathLike[str], output_file: str | os.PathLike[str] | None = None, macros: list[_Macro] | None = None, include_dirs: list[str] | tuple[str, ...] | None = None, extra_preargs: list[str] | None = None, extra_postargs: Iterable[str] | None = None, ): """Preprocess a single C/C++ source file, named in 'source'. Output will be written to file named 'output_file', or stdout if 'output_file' not supplied. 'macros' is a list of macro definitions as for 'compile()', which will augment the macros set with 'define_macro()' and 'undefine_macro()'. 'include_dirs' is a list of directory names that will be added to the default list. Raises PreprocessError on failure. """ pass def compile( self, sources: Sequence[str | os.PathLike[str]], output_dir: str | None = None, macros: list[_Macro] | None = None, include_dirs: list[str] | tuple[str, ...] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: list[str] | None = None, depends: list[str] | tuple[str, ...] | None = None, ) -> list[str]: """Compile one or more source files. 'sources' must be a list of filenames, most likely C/C++ files, but in reality anything that can be handled by a particular compiler and compiler class (eg. MSVCCompiler can handle resource files in 'sources'). Return a list of object filenames, one per source filename in 'sources'. Depending on the implementation, not all source files will necessarily be compiled, but all corresponding object filenames will be returned. If 'output_dir' is given, object files will be put under it, while retaining their original path component. That is, "foo/bar.c" normally compiles to "foo/bar.o" (for a Unix implementation); if 'output_dir' is "build", then it would compile to "build/foo/bar.o". 'macros', if given, must be a list of macro definitions. A macro definition is either a (name, value) 2-tuple or a (name,) 1-tuple. The former defines a macro; if the value is None, the macro is defined without an explicit value. The 1-tuple case undefines a macro. Later definitions/redefinitions/ undefinitions take precedence. 'include_dirs', if given, must be a list of strings, the directories to add to the default include file search path for this compilation only. 'debug' is a boolean; if true, the compiler will be instructed to output debug symbols in (or alongside) the object file(s). 'extra_preargs' and 'extra_postargs' are implementation- dependent. On platforms that have the notion of a command-line (e.g. Unix, DOS/Windows), they are most likely lists of strings: extra command-line arguments to prepend/append to the compiler command line. On other platforms, consult the implementation class documentation. In any event, they are intended as an escape hatch for those occasions when the abstract compiler framework doesn't cut the mustard. 'depends', if given, is a list of filenames that all targets depend on. If a source file is older than any file in depends, then the source file will be recompiled. This supports dependency tracking, but only at a coarse granularity. Raises CompileError on failure. """ # A concrete compiler class can either override this method # entirely or implement _compile(). macros, objects, extra_postargs, pp_opts, build = self._setup_compile( output_dir, macros, include_dirs, sources, depends, extra_postargs ) cc_args = self._get_cc_args(pp_opts, debug, extra_preargs) for obj in objects: try: src, ext = build[obj] except KeyError: continue self._compile(obj, src, ext, cc_args, extra_postargs, pp_opts) # Return *all* object filenames, not just the ones we just built. return objects def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): """Compile 'src' to product 'obj'.""" # A concrete compiler class that does not override compile() # should implement _compile(). pass def create_static_lib( self, objects: list[str] | tuple[str, ...], output_libname: str, output_dir: str | None = None, debug: bool = False, target_lang: str | None = None, ) -> None: """Link a bunch of stuff together to create a static library file. The "bunch of stuff" consists of the list of object files supplied as 'objects', the extra object files supplied to 'add_link_object()' and/or 'set_link_objects()', the libraries supplied to 'add_library()' and/or 'set_libraries()', and the libraries supplied as 'libraries' (if any). 'output_libname' should be a library name, not a filename; the filename will be inferred from the library name. 'output_dir' is the directory where the library file will be put. 'debug' is a boolean; if true, debugging information will be included in the library (note that on most platforms, it is the compile step where this matters: the 'debug' flag is included here just for consistency). 'target_lang' is the target language for which the given objects are being compiled. This allows specific linkage time treatment of certain languages. Raises LibError on failure. """ pass # values for target_desc parameter in link() SHARED_OBJECT = "shared_object" SHARED_LIBRARY = "shared_library" EXECUTABLE = "executable" def link( self, target_desc: str, objects: list[str] | tuple[str, ...], output_filename: str, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, export_symbols: Iterable[str] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: list[str] | None = None, build_temp: str | os.PathLike[str] | None = None, target_lang: str | None = None, ): """Link a bunch of stuff together to create an executable or shared library file. The "bunch of stuff" consists of the list of object files supplied as 'objects'. 'output_filename' should be a filename. If 'output_dir' is supplied, 'output_filename' is relative to it (i.e. 'output_filename' can provide directory components if needed). 'libraries' is a list of libraries to link against. These are library names, not filenames, since they're translated into filenames in a platform-specific way (eg. "foo" becomes "libfoo.a" on Unix and "foo.lib" on DOS/Windows). However, they can include a directory component, which means the linker will look in that specific directory rather than searching all the normal locations. 'library_dirs', if supplied, should be a list of directories to search for libraries that were specified as bare library names (ie. no directory component). These are on top of the system default and those supplied to 'add_library_dir()' and/or 'set_library_dirs()'. 'runtime_library_dirs' is a list of directories that will be embedded into the shared library and used to search for other shared libraries that *it* depends on at run-time. (This may only be relevant on Unix.) 'export_symbols' is a list of symbols that the shared library will export. (This appears to be relevant only on Windows.) 'debug' is as for 'compile()' and 'create_static_lib()', with the slight distinction that it actually matters on most platforms (as opposed to 'create_static_lib()', which includes a 'debug' flag mostly for form's sake). 'extra_preargs' and 'extra_postargs' are as for 'compile()' (except of course that they supply command-line arguments for the particular linker being used). 'target_lang' is the target language for which the given objects are being compiled. This allows specific linkage time treatment of certain languages. Raises LinkError on failure. """ raise NotImplementedError # Old 'link_*()' methods, rewritten to use the new 'link()' method. def link_shared_lib( self, objects: list[str] | tuple[str, ...], output_libname: str, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, export_symbols: Iterable[str] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: list[str] | None = None, build_temp: str | os.PathLike[str] | None = None, target_lang: str | None = None, ): self.link( Compiler.SHARED_LIBRARY, objects, self.library_filename(output_libname, lib_type='shared'), output_dir, libraries, library_dirs, runtime_library_dirs, export_symbols, debug, extra_preargs, extra_postargs, build_temp, target_lang, ) def link_shared_object( self, objects: list[str] | tuple[str, ...], output_filename: str, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, export_symbols: Iterable[str] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: list[str] | None = None, build_temp: str | os.PathLike[str] | None = None, target_lang: str | None = None, ): self.link( Compiler.SHARED_OBJECT, objects, output_filename, output_dir, libraries, library_dirs, runtime_library_dirs, export_symbols, debug, extra_preargs, extra_postargs, build_temp, target_lang, ) def link_executable( self, objects: list[str] | tuple[str, ...], output_progname: str, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: list[str] | None = None, target_lang: str | None = None, ): self.link( Compiler.EXECUTABLE, objects, self.executable_filename(output_progname), output_dir, libraries, library_dirs, runtime_library_dirs, None, debug, extra_preargs, extra_postargs, None, target_lang, ) # -- Miscellaneous methods ----------------------------------------- # These are all used by the 'gen_lib_options() function; there is # no appropriate default implementation so subclasses should # implement all of these. def library_dir_option(self, dir: str) -> str: """Return the compiler option to add 'dir' to the list of directories searched for libraries. """ raise NotImplementedError def runtime_library_dir_option(self, dir: str) -> str: """Return the compiler option to add 'dir' to the list of directories searched for runtime libraries. """ raise NotImplementedError def library_option(self, lib: str) -> str: """Return the compiler option to add 'lib' to the list of libraries linked into the shared library or executable. """ raise NotImplementedError def has_function( # noqa: C901 self, funcname: str, includes: Iterable[str] | None = None, include_dirs: list[str] | tuple[str, ...] | None = None, libraries: list[str] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, ) -> bool: """Return a boolean indicating whether funcname is provided as a symbol on the current platform. The optional arguments can be used to augment the compilation environment. The libraries argument is a list of flags to be passed to the linker to make additional symbol definitions available for linking. The includes and include_dirs arguments are deprecated. Usually, supplying include files with function declarations will cause function detection to fail even in cases where the symbol is available for linking. """ # this can't be included at module scope because it tries to # import math which might not be available at that point - maybe # the necessary logic should just be inlined? import tempfile if includes is None: includes = [] else: warnings.warn("includes is deprecated", DeprecationWarning) if include_dirs is None: include_dirs = [] else: warnings.warn("include_dirs is deprecated", DeprecationWarning) if libraries is None: libraries = [] if library_dirs is None: library_dirs = [] fd, fname = tempfile.mkstemp(".c", funcname, text=True) with os.fdopen(fd, "w", encoding='utf-8') as f: for incl in includes: f.write(f"""#include "{incl}"\n""") if not includes: # Use "char func(void);" as the prototype to follow # what autoconf does. This prototype does not match # any well-known function the compiler might recognize # as a builtin, so this ends up as a true link test. # Without a fake prototype, the test would need to # know the exact argument types, and the has_function # interface does not provide that level of information. f.write( f"""\ #ifdef __cplusplus extern "C" #endif char {funcname}(void); """ ) f.write( f"""\ int main (int argc, char **argv) {{ {funcname}(); return 0; }} """ ) try: objects = self.compile([fname], include_dirs=include_dirs) except CompileError: return False finally: os.remove(fname) try: self.link_executable( objects, "a.out", libraries=libraries, library_dirs=library_dirs ) except (LinkError, TypeError): return False else: os.remove( self.executable_filename("a.out", output_dir=self.output_dir or '') ) finally: for fn in objects: os.remove(fn) return True def find_library_file( self, dirs: Iterable[str], lib: str, debug: bool = False ) -> str | None: """Search the specified list of directories for a static or shared library file 'lib' and return the full path to that file. If 'debug' true, look for a debugging version (if that makes sense on the current platform). Return None if 'lib' wasn't found in any of the specified directories. """ raise NotImplementedError # -- Filename generation methods ----------------------------------- # The default implementation of the filename generating methods are # prejudiced towards the Unix/DOS/Windows view of the world: # * object files are named by replacing the source file extension # (eg. .c/.cpp -> .o/.obj) # * library files (shared or static) are named by plugging the # library name and extension into a format string, eg. # "lib%s.%s" % (lib_name, ".a") for Unix static libraries # * executables are named by appending an extension (possibly # empty) to the program name: eg. progname + ".exe" for # Windows # # To reduce redundant code, these methods expect to find # several attributes in the current object (presumably defined # as class attributes): # * src_extensions - # list of C/C++ source file extensions, eg. ['.c', '.cpp'] # * obj_extension - # object file extension, eg. '.o' or '.obj' # * static_lib_extension - # extension for static library files, eg. '.a' or '.lib' # * shared_lib_extension - # extension for shared library/object files, eg. '.so', '.dll' # * static_lib_format - # format string for generating static library filenames, # eg. 'lib%s.%s' or '%s.%s' # * shared_lib_format # format string for generating shared library filenames # (probably same as static_lib_format, since the extension # is one of the intended parameters to the format string) # * exe_extension - # extension for executable files, eg. '' or '.exe' def object_filenames( self, source_filenames: Iterable[str | os.PathLike[str]], strip_dir: bool = False, output_dir: str | os.PathLike[str] | None = '', ) -> list[str]: if output_dir is None: output_dir = '' return list( self._make_out_path(output_dir, strip_dir, src_name) for src_name in source_filenames ) @property def out_extensions(self): return dict.fromkeys(self.src_extensions, self.obj_extension) def _make_out_path(self, output_dir, strip_dir, src_name): return self._make_out_path_exts( output_dir, strip_dir, src_name, self.out_extensions ) @classmethod def _make_out_path_exts(cls, output_dir, strip_dir, src_name, extensions): r""" >>> exts = {'.c': '.o'} >>> Compiler._make_out_path_exts('.', False, '/foo/bar.c', exts).replace('\\', '/') './foo/bar.o' >>> Compiler._make_out_path_exts('.', True, '/foo/bar.c', exts).replace('\\', '/') './bar.o' """ src = pathlib.PurePath(src_name) # Ensure base is relative to honor output_dir (python/cpython#37775). base = cls._make_relative(src) try: new_ext = extensions[src.suffix] except LookupError: raise UnknownFileType(f"unknown file type '{src.suffix}' (from '{src}')") if strip_dir: base = pathlib.PurePath(base.name) return os.path.join(output_dir, base.with_suffix(new_ext)) @staticmethod def _make_relative(base: pathlib.Path): return base.relative_to(base.anchor) @overload def shared_object_filename( self, basename: str, strip_dir: Literal[False] = False, output_dir: str | os.PathLike[str] = "", ) -> str: ... @overload def shared_object_filename( self, basename: str | os.PathLike[str], strip_dir: Literal[True], output_dir: str | os.PathLike[str] = "", ) -> str: ... def shared_object_filename( self, basename: str | os.PathLike[str], strip_dir: bool = False, output_dir: str | os.PathLike[str] = '', ) -> str: assert output_dir is not None if strip_dir: basename = os.path.basename(basename) return os.path.join(output_dir, basename + self.shared_lib_extension) @overload def executable_filename( self, basename: str, strip_dir: Literal[False] = False, output_dir: str | os.PathLike[str] = "", ) -> str: ... @overload def executable_filename( self, basename: str | os.PathLike[str], strip_dir: Literal[True], output_dir: str | os.PathLike[str] = "", ) -> str: ... def executable_filename( self, basename: str | os.PathLike[str], strip_dir: bool = False, output_dir: str | os.PathLike[str] = '', ) -> str: assert output_dir is not None if strip_dir: basename = os.path.basename(basename) return os.path.join(output_dir, basename + (self.exe_extension or '')) def library_filename( self, libname: str, lib_type: str = "static", strip_dir: bool = False, output_dir: str | os.PathLike[str] = "", # or 'shared' ): assert output_dir is not None expected = '"static", "shared", "dylib", "xcode_stub"' if lib_type not in eval(expected): raise ValueError(f"'lib_type' must be {expected}") fmt = getattr(self, lib_type + "_lib_format") ext = getattr(self, lib_type + "_lib_extension") dir, base = os.path.split(libname) filename = fmt % (base, ext) if strip_dir: dir = '' return os.path.join(output_dir, dir, filename) # -- Utility methods ----------------------------------------------- def announce(self, msg: object, level: int = 1) -> None: log.debug(msg) def debug_print(self, msg: object) -> None: from distutils.debug import DEBUG if DEBUG: print(msg) def warn(self, msg: object) -> None: sys.stderr.write(f"warning: {msg}\n") def execute( self, func: Callable[[Unpack[_Ts]], object], args: tuple[Unpack[_Ts]], msg: object = None, level: int = 1, ) -> None: execute(func, args, msg, self.dry_run) def spawn( self, cmd: MutableSequence[bytes | str | os.PathLike[str]], **kwargs ) -> None: spawn(cmd, dry_run=self.dry_run, **kwargs) @overload def move_file( self, src: str | os.PathLike[str], dst: _StrPathT ) -> _StrPathT | str: ... @overload def move_file( self, src: bytes | os.PathLike[bytes], dst: _BytesPathT ) -> _BytesPathT | bytes: ... def move_file( self, src: str | os.PathLike[str] | bytes | os.PathLike[bytes], dst: str | os.PathLike[str] | bytes | os.PathLike[bytes], ) -> str | os.PathLike[str] | bytes | os.PathLike[bytes]: return move_file(src, dst, dry_run=self.dry_run) def mkpath(self, name, mode=0o777): mkpath(name, mode, dry_run=self.dry_run) # Map a sys.platform/os.name ('posix', 'nt') to the default compiler # type for that platform. Keys are interpreted as re match # patterns. Order is important; platform mappings are preferred over # OS names. _default_compilers = ( # Platform string mappings # on a cygwin built python we can use gcc like an ordinary UNIXish # compiler ('cygwin.*', 'unix'), ('zos', 'zos'), # OS name mappings ('posix', 'unix'), ('nt', 'msvc'), ) def get_default_compiler(osname: str | None = None, platform: str | None = None) -> str: """Determine the default compiler to use for the given platform. osname should be one of the standard Python OS names (i.e. the ones returned by os.name) and platform the common value returned by sys.platform for the platform in question. The default values are os.name and sys.platform in case the parameters are not given. """ if osname is None: osname = os.name if platform is None: platform = sys.platform # Mingw is a special case where sys.platform is 'win32' but we # want to use the 'mingw32' compiler, so check it first if is_mingw(): return 'mingw32' for pattern, compiler in _default_compilers: if ( re.match(pattern, platform) is not None or re.match(pattern, osname) is not None ): return compiler # Default to Unix compiler return 'unix' # Map compiler types to (module_name, class_name) pairs -- ie. where to # find the code that implements an interface to this compiler. (The module # is assumed to be in the 'distutils' package.) compiler_class = { 'unix': ('unixccompiler', 'UnixCCompiler', "standard UNIX-style compiler"), 'msvc': ('_msvccompiler', 'MSVCCompiler', "Microsoft Visual C++"), 'cygwin': ( 'cygwinccompiler', 'CygwinCCompiler', "Cygwin port of GNU C Compiler for Win32", ), 'mingw32': ( 'cygwinccompiler', 'Mingw32CCompiler', "Mingw32 port of GNU C Compiler for Win32", ), 'bcpp': ('bcppcompiler', 'BCPPCompiler', "Borland C++ Compiler"), 'zos': ('zosccompiler', 'zOSCCompiler', 'IBM XL C/C++ Compilers'), } def show_compilers() -> None: """Print list of available compilers (used by the "--help-compiler" options to "build", "build_ext", "build_clib"). """ # XXX this "knows" that the compiler option it's describing is # "--compiler", which just happens to be the case for the three # commands that use it. from distutils.fancy_getopt import FancyGetopt compilers = sorted( ("compiler=" + compiler, None, compiler_class[compiler][2]) for compiler in compiler_class.keys() ) pretty_printer = FancyGetopt(compilers) pretty_printer.print_help("List of available compilers:") def new_compiler( plat: str | None = None, compiler: str | None = None, verbose: bool = False, dry_run: bool = False, force: bool = False, ) -> Compiler: """Generate an instance of some CCompiler subclass for the supplied platform/compiler combination. 'plat' defaults to 'os.name' (eg. 'posix', 'nt'), and 'compiler' defaults to the default compiler for that platform. Currently only 'posix' and 'nt' are supported, and the default compilers are "traditional Unix interface" (UnixCCompiler class) and Visual C++ (MSVCCompiler class). Note that it's perfectly possible to ask for a Unix compiler object under Windows, and a Microsoft compiler object under Unix -- if you supply a value for 'compiler', 'plat' is ignored. """ if plat is None: plat = os.name try: if compiler is None: compiler = get_default_compiler(plat) (module_name, class_name, long_description) = compiler_class[compiler] except KeyError: msg = f"don't know how to compile C/C++ code on platform '{plat}'" if compiler is not None: msg = msg + f" with '{compiler}' compiler" raise DistutilsPlatformError(msg) try: module_name = "distutils." + module_name __import__(module_name) module = sys.modules[module_name] klass = vars(module)[class_name] except ImportError: raise DistutilsModuleError( f"can't compile C/C++ code: unable to load module '{module_name}'" ) except KeyError: raise DistutilsModuleError( f"can't compile C/C++ code: unable to find class '{class_name}' " f"in module '{module_name}'" ) # XXX The None is necessary to preserve backwards compatibility # with classes that expect verbose to be the first positional # argument. return klass(None, dry_run, force) def gen_preprocess_options( macros: Iterable[_Macro], include_dirs: Iterable[str] ) -> list[str]: """Generate C pre-processor options (-D, -U, -I) as used by at least two types of compilers: the typical Unix compiler and Visual C++. 'macros' is the usual thing, a list of 1- or 2-tuples, where (name,) means undefine (-U) macro 'name', and (name,value) means define (-D) macro 'name' to 'value'. 'include_dirs' is just a list of directory names to be added to the header file search path (-I). Returns a list of command-line options suitable for either Unix compilers or Visual C++. """ # XXX it would be nice (mainly aesthetic, and so we don't generate # stupid-looking command lines) to go over 'macros' and eliminate # redundant definitions/undefinitions (ie. ensure that only the # latest mention of a particular macro winds up on the command # line). I don't think it's essential, though, since most (all?) # Unix C compilers only pay attention to the latest -D or -U # mention of a macro on their command line. Similar situation for # 'include_dirs'. I'm punting on both for now. Anyways, weeding out # redundancies like this should probably be the province of # CCompiler, since the data structures used are inherited from it # and therefore common to all CCompiler classes. pp_opts = [] for macro in macros: if not (isinstance(macro, tuple) and 1 <= len(macro) <= 2): raise TypeError( f"bad macro definition '{macro}': " "each element of 'macros' list must be a 1- or 2-tuple" ) if len(macro) == 1: # undefine this macro pp_opts.append(f"-U{macro[0]}") elif len(macro) == 2: if macro[1] is None: # define with no explicit value pp_opts.append(f"-D{macro[0]}") else: # XXX *don't* need to be clever about quoting the # macro value here, because we're going to avoid the # shell at all costs when we spawn the command! pp_opts.append("-D{}={}".format(*macro)) pp_opts.extend(f"-I{dir}" for dir in include_dirs) return pp_opts def gen_lib_options( compiler: Compiler, library_dirs: Iterable[str], runtime_library_dirs: Iterable[str], libraries: Iterable[str], ) -> list[str]: """Generate linker options for searching library directories and linking with specific libraries. 'libraries' and 'library_dirs' are, respectively, lists of library names (not filenames!) and search directories. Returns a list of command-line options suitable for use with some compiler (depending on the two format strings passed in). """ lib_opts = [compiler.library_dir_option(dir) for dir in library_dirs] for dir in runtime_library_dirs: lib_opts.extend(always_iterable(compiler.runtime_library_dir_option(dir))) # XXX it's important that we *not* remove redundant library mentions! # sometimes you really do have to say "-lfoo -lbar -lfoo" in order to # resolve all symbols. I just hope we never have to say "-lfoo obj.o # -lbar" to get things to work -- that's certainly a possibility, but a # pretty nasty way to arrange your C code. for lib in libraries: (lib_dir, lib_name) = os.path.split(lib) if lib_dir: lib_file = compiler.find_library_file([lib_dir], lib_name) if lib_file: lib_opts.append(lib_file) else: compiler.warn( f"no library file corresponding to '{lib}' found (skipping)" ) else: lib_opts.append(compiler.library_option(lib)) return lib_opts _distutils/compilers/C/__pycache__/msvc.cpython-310.pyc 0000644 00000035657 15030122015 0016774 0 ustar 00 o �h�S � @ sB d Z ddlmZ ddlZddlZddlZddlmZ ddlZddl m Z e� e �� ddl Z W d � n1 s8w Y ddlmZ ddlmZ ddlmZmZ dd lmZmZ d d lmZ d d lmZ d d lmZm Z m Z dd� Z dd� Z ddddd�Z dd� Z!dd� Z"d#dd �Z#dd ddd �Z$d d � Z%G d!d"� d"ej&�Z&dS )$z�distutils._msvccompiler Contains MSVCCompiler, an implementation of the abstract CCompiler class for Microsoft Visual Studio 2015. This module requires VS 2015 or later. � )� annotationsN)�Iterable)�count� )�log)�DistutilsExecError�DistutilsPlatformError)�get_host_platform� get_platform� )�base)�gen_lib_options)� CompileError�LibError� LinkErrorc C s zt jt jdt jt jB d�} W n ty t�d� Y dS w d}d }| �_ t� D ]F}z t � | |�\}}}W n ty@ Y n:w |ro|t j krot j � |�roztt|��}W n ttfya Y q)w |dkro||kro||}}q)W d � ||fS W d � ||fS 1 s�w Y ||fS )Nz'Software\Microsoft\VisualStudio\SxS\VC7)�accessz Visual C++ is not registered�NNr � )�winreg� OpenKeyEx�HKEY_LOCAL_MACHINE�KEY_READ�KEY_WOW64_32KEY�OSErrorr �debugr � EnumValue�REG_SZ�os�path�isdir�int�float� ValueError� TypeError)�key� best_version�best_dir�i�v�vc_dir�vt�version� r, �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/msvc.py� _find_vc2015+ sH � � �� �� � � � � r. c C s� t j�d�p t j�d�} | sdS t� dkrdnd}d|� �df}|D ]R}t�tjtt ��@ t� t j � | d d d �d d d|ddddg �j ddd��� }t j � |ddd�}t j �|�red|fW d � S W d � n1 sow Y q"dS )aJ Returns "15, path" based on the result of invoking vswhere.exe If no install is found, returns "None, None" The version is returned to avoid unnecessarily changing the function result. It may be ignored when the path is not None. If vswhere.exe is not available, by definition, VS 2017 is not installed. zProgramFiles(x86)� ProgramFilesr � win-arm64�arm64zx86.x64z*Microsoft.VisualStudio.Component.VC.Tools.z)Microsoft.VisualStudio.Workload.WDExpresszMicrosoft Visual Studio� Installerz vswhere.exez-latestz -prereleasez -requiresz -property�installationPathz -products�*�mbcs�strict)�encoding�errors�VC� Auxiliary�Build� N)r �environ�getr � contextlib�suppress� subprocess�CalledProcessErrorr �UnicodeDecodeError� check_outputr �join�decode�stripr )�root�variant�suitable_components� componentr r, r, r- � _find_vc2017H sH ���� �� � ��rL �x86�x64�armr1 )rM � x86_amd64�x86_arm� x86_arm64c C s\ t � \}}|s t� \}}|st�d� dS tj�|d�}tj�|�s*t�d|� dS |d fS )Nz$No suitable Visual C++ version foundr z vcvarsall.batz%s cannot be found)rL r. r r r r rE �isfile)� plat_spec�_r& r% � vcvarsallr, r, r- �_find_vcvarsall� s rW c C s� t �d�rdd� t j�� D �S t| �\}}|std��ztjd|� d| � d�tjd�j d d d �}W n tj yL } zt � |j � td |j� ���d }~ww d d� dd� |�� D �D �}|S )N�DISTUTILS_USE_SDKc S s i | ] \}}|� � |�qS r, ��lower)�.0r$ �valuer, r, r- � <dictcomp>� s z _get_vc_env.<locals>.<dictcomp>z�Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/z cmd /u /c "z" z && set)�stderrzutf-16le�replace)r8 zError executing c S s$ i | ]\}}}|r|r|� � |�qS r, rY )r[ r$ rU r\ r, r, r- r] � s ���c s s � | ]}|� d �V qdS )�=N)� partition)r[ �liner, r, r- � <genexpr>� s � z _get_vc_env.<locals>.<genexpr>)r �getenvr= �itemsrW r rA rD �STDOUTrF rB r �error�output�cmd� splitlines)rT rV rU �out�exc�envr, r, r- � _get_vc_env� s. �� � ���rn c C sN |s t �d��t j�}|D ]}t j�t j�|�| �}t j�|�r$| S q | S )at Return path to an MSVC executable program. Tries to find the program in several places: first, one of the MSVC program search paths from the registry; next, the directories in the PATH environment variable. If any of those work, return an absolute path that is known to exist. If none of them work, just return the original program name, 'exe'. r )r rd �split�pathsepr rE �abspathrS )�exe�paths�p�fnr, r, r- � _find_exe� s �rv �amd64)�win32z win-amd64z win-arm32r0 c C s6 | dkrd} t | }t | }||kr|S |� d|� �S )aw Given a host platform and platform, determine the spec for vcvarsall. Uses the native MSVC host if the host platform would need expensive emulation for x86. >>> _get_vcvars_spec('win-arm64', 'win32') 'arm64_x86' >>> _get_vcvars_spec('win-arm64', 'win-amd64') 'arm64_amd64' Otherwise, always cross-compile from x86 to work with the lighter-weight MSVC installs that do not include native 64-bit tools. >>> _get_vcvars_spec('win32', 'win32') 'x86' >>> _get_vcvars_spec('win-arm32', 'win-arm32') 'x86_arm' >>> _get_vcvars_spec('win-amd64', 'win-arm64') 'x86_arm64' r0 rx rU )� _vcvars_names)� host_platform�platform�vc_hp�vc_platr, r, r- �_get_vcvars_spec� s r~ c s2 e Zd ZdZdZi ZdgZg d�ZdgZdgZ ee e e Z dZ dZ d Z d Zd ZZd ZdEdF� fdd� Zedd� �Zedd� �ZdGdHdd�ZedI� fd d � �Z dJd d �Z dKdLd(d)�Z dMdNd7d8�Z � fd9d:�Z e j � fd;d<��Z d=d>� Z!d?d@� Z"dAdB� Z#dOdCdD�Z$� Z%S )P�CompilerztConcrete class that implements an interface to Microsoft Visual C++, as defined by the CCompiler abstract class.�msvcz.c)z.ccz.cppz.cxx�.rcz.mcz.resz.objz.libz.dllz%s%sz.exeF�return�Nonec s t � �|||� d | _d| _d S )NF)�super�__init__� plat_name� initialized)�self�verbose�dry_run�force�� __class__r, r- r� s zCompiler.__init__c C s, | � |�dd��| _| � |�dd��| _dS )z3 Set class-level include/lib dirs. �include� �libN)� _parse_pathr> � include_dirs� library_dirs)�cls�vc_envr, r, r- � _configure s zCompiler._configurec C s dd� | � tj�D �S )Nc S s g | ] }|r|� tj��qS r, )�rstripr �sep)r[ �dirr, r, r- � <listcomp> s z(Compiler._parse_path.<locals>.<listcomp>)ro r rp )�valr, r, r- r� s zCompiler._parse_pathNr� � str | Nonec C s� | j rJ d��|d u rt� }|tvrtdtt�� ���tt� |�}t|�}|s+td��| �|� |� dd�| _ | j � t j �}td|�| _td|�| _td|�| _td |�| _td |�| _td |�| _d | _g d �| _g d �| _g d�}g d�}g |�d�| _g |�d�| _g |�d�d�d�| _g |�d�d�d�| _g |�| _ g |�| _ t j j d f| jt j j df| jt j j df| jt j j!d f| jt j j!df| jt j j!df| jt j j"d f| j t j j"df| j t j j"df| j i | _#d| _ d S )Nzdon't init multiple timesz--plat-name must be one of z7Unable to find a compatible Visual Studio installation.r r� zcl.exezlink.exezlib.exezrc.exezmc.exezmt.exe)�/nologoz/O2�/W3z/GLz/DNDEBUGz/MD)r� z/Odz/MDdz/Zir� z/D_DEBUG)r� �/INCREMENTAL:NO�/LTCG)r� r� r� z /DEBUG:FULLz/MANIFEST:EMBED,ID=1z/DLLz/MANIFEST:EMBED,ID=2z/MANIFESTUAC:NOFT)$r� r ry r �tupler~ r rn r� r> �_pathsro r rp rv �cc�linkerr� �rc�mc�mt�preprocess_options�compile_options�compile_options_debug� ldflags_exe�ldflags_exe_debug�ldflags_shared�ldflags_shared_debug�ldflags_static�ldflags_static_debugr r � EXECUTABLE� SHARED_OBJECT�SHARED_LIBRARY�_ldflags)r� r� rT r� rs �ldflags� ldflags_debugr, r, r- � initialize sx � � �������� � zCompiler.initialize�dict[str, str]c s& i t � j�� fdd�� j� j D ��S )Nc s i | ]}|� j �qS r, )� res_extension)r[ �ext�r� r, r- r] n s ��z+Compiler.out_extensions.<locals>.<dictcomp>)r� �out_extensions�_rc_extensions�_mc_extensionsr� r� r� r- r� j s � ��zCompiler.out_extensionsc C sN | j s| �� | �||||||�} | \}} }} } |pg } | �d� |r*| �| j� n| �| j� d}| D ]�}z| | \}}W n tyG Y q4w |rPtj � |�}|| j v r[d|� �}n�|| j v rhd|� �}d}n�|| j v r�|}d| }z| �| jg| ||g � W n ty� } zt|��d }~ww q4|| jv r�tj �|�}tj �|�}z.| �| jd|d||g� tj �tj �|��\}}tj �||d �}| �| jd| |g� W n ty� } zt|��d }~ww q4td |� d |� ���| jg| | }|r�|�d � |�|d | f� |�|� z| �|� W q4 t�y$ } zt|��d }~ww | S )Nz/cFz/Tcz/TpTz/foz-hz-rr� zDon't know how to compile z to z/EHscz/Fo)r� r� �_setup_compile�append�extendr� r� �KeyErrorr r rq � _c_extensions�_cpp_extensionsr� �spawnr� r r r� �dirnamer� �splitext�basenamerE r� )r� �sources� output_dir�macrosr� r � extra_preargs�extra_postargs�depends� compile_info�objects�pp_opts�build� compile_opts� add_cpp_opts�obj�srcr� � input_opt� output_opt�msg�h_dir�rc_dirr rU �rc_file�argsr, r, r- �compilet sz � � �� �� ��zCompiler.compiler� �list[str] | tuple[str, ...]�output_libname�strr� r �bool� target_langc C s� | j s| �� | �||�\}}| j||d�}| �||�rN|d| g }|r& zt�d| jd�|�� | � | jg| � W d S t yM } zt |��d }~ww t�d|� d S )N)r� �/OUT:�Executing "%s" %s� �skipping %s (up-to-date)) r� r� �_fix_object_args�library_filename� _need_linkr r r� rE r� r r ) r� r� r� r� r r� �output_filename�lib_argsr� r, r, r- �create_static_lib� s ��zCompiler.create_static_lib� target_descr� � libraries�"list[str] | tuple[str, ...] | Noner� �runtime_library_dirs�export_symbols�Iterable[str] | Noner� �list[str] | Noner� � build_temp� str | os.PathLike[str] | Nonec C s� | j s| �� | �||�\}}| �|||�}|\}}}|r&| �dt|� � t| |||�}|d ur8tj� ||�}| � ||�r�| j || f }dd� |pKg D �}|| | | d| g }tj� |d �} |d ur�tj� tj�|��\}}tj� | | �|��}|�d| � | r�| |d d�< | r�|�| � tj� tj�|��}| �|� zt�d| jd� |�� | �| jg| � W d S ty� } zt|��d }~ww t�d |� d S ) Nz5I don't know what to do with 'runtime_library_dirs': c S s g | ]}d | �qS )z/EXPORT:r, )r[ �symr, r, r- r� s z!Compiler.link.<locals>.<listcomp>r� r z/IMPLIB:r� r� r� )r� r� r� � _fix_lib_args�warnr� r r r rE r� r� r� r� r� r� r� r� rq �mkpathr r r� r� r r )r� r� r� r� r� r� r� r� r� r r� r� r� r� � fixed_args�lib_optsr� � export_opts�ld_args�dll_name�dll_ext� implib_filer� r, r, r- �link� sP �� � � ��z Compiler.linkc sR t tj| jd�}| �||��}t� j||d�W d � S 1 s!w Y |jS )N)�PATH)rm )�dictr r= r� �_fallback_spawnr� r� r\ )r� ri rm �fallbackr� r, r- r� 0 s �zCompiler.spawnc # s� � t ddi �� }z|V W dS ty' } z dt|�vr � W Y d}~nd}~ww t�d� tj�d|�� t� � |�|_ W d � dS 1 sGw Y dS )z� Discovered in pypa/distutils#15, some tools monkeypatch the compiler, so the 'env' kwarg causes a TypeError. Detect this condition and restore the legacy, unsafe behavior. �Bagr, z!unexpected keyword argument 'env'Nz>Fallback spawn triggered. Please update distutils monkeypatch.z os.environ) �typer# r� �warningsr� �mock�patchr r� r� r\ )r� ri rm �bagrl r� r, r- r 6 s �� ��� "�zCompiler._fallback_spawnc C s d| S )Nz /LIBPATH:r, �r� r� r, r, r- �library_dir_optionM s zCompiler.library_dir_optionc C s t d��)Nz:don't know how to set runtime library search path for MSVC)r r r, r, r- �runtime_library_dir_optionP s �z#Compiler.runtime_library_dir_optionc C s | � |�S �N)r� )r� r� r, r, r- �library_optionU s zCompiler.library_optionc C s\ |r |d |g}n|g}|D ] }|D ]}t j�|| �|��}t j�|�r*| S qqd S )N�_d)r r rE r� rS )r� �dirsr� r � try_namesr� �name�libfiler, r, r- �find_library_fileX s ��zCompiler.find_library_file)FFF)r� r� r )r� r� r� r� )r� r� )NNNFNNN)NFN) r� r� r� r� r� r� r r� r� r� r� r� ) NNNNNFNNNN) r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r� r� )F)&�__name__� __module__� __qualname__�__doc__� compiler_type� executablesr� r� r� r� �src_extensionsr� � obj_extension�static_lib_extension�shared_lib_extension�static_lib_format�shared_lib_format� exe_extensionr� � classmethodr� � staticmethodr� r� �propertyr� r� r� r r� r? �contextmanagerr r r r r � __classcell__r, r, r� r- r � sj Q �b � � Er r )'r � __future__r r? r rA � unittest.mockr r �collections.abcr r@ � ImportErrorr � itertoolsr �_logr r8 r r �utilr r r� r r r r r r. rL �PLAT_SPEC_TO_RUNTIMErW rn rv ry r~ r r, r, r, r- �<module> sF � 3� � _distutils/compilers/C/__pycache__/cygwin.cpython-310.pyc 0000644 00000017610 15030122015 0017311 0 ustar 00 o �hD. � @ s� d Z ddlZddlZddlZddlZddlZddlZddlmZ ddl m Z m Z ddl m Z ddlmZ ddlmZmZ d d lmZ d d l mZmZ d d � ZdZG dd� dej�ZG dd� de�ZdZdZ dZ dd� Z dd� Z dZ dS )a distutils.cygwinccompiler Provides the CygwinCCompiler class, a subclass of UnixCCompiler that handles the Cygwin port of the GNU C compiler to Windows. It also contains the Mingw32CCompiler class which handles the mingw32 port of GCC (same as cygwin in no-cygwin mode). � N)� check_output� )�DistutilsExecError�DistutilsPlatformError)� write_file)�get_config_vars)� LooseVersion�suppress_known_deprecation� )�unix)� CompileError�Errorc C s g S )z6No longer needed, but kept for backward compatibility.� r r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/cygwin.py� get_msvcr s r zxUnable to set runtime library search path on Windows, usually indicated by `runtime_library_dirs` parameter to Extensionc s� e Zd ZdZdZdZdZdZdZdZ dZ dZ d Z d� fd d � Z ed d� �Zdd� Z d� fdd� Zdd� Z� fdd�Ze� fdd��Z� ZS ) �Compilerz9Handles the Cygwin port of the GNU C compiler to Windows.�cygwinz.oz.az.dll.az.dllzlib%s%szcyg%s%sz.exeFc s t � �|||� t� \}}| �d|� d|� d�� |tur&| �d|� d�� tdd�\| _| _t j � d| jp7d�| _t j � d| jpBd �| _| j| _ | j| _ d }| j| j� d �| j� d �| j� d �| j� d �| j� d �| j � d|� �| j� d �| j � d|� �d� t� | _d S )NzPython's GCC status: z (details: �)zCPython's pyconfig.h doesn't seem to support your compiler. Reason: z>. Compiling may fail because of undefined preprocessor macros.�CC�CXX�gcczg++�-sharedz -mcygwin -O -Wallz -mcygwin -mdll -O -Wallz -mcygwinz -mcygwin )�compiler� compiler_so� compiler_cxx�compiler_so_cxx� linker_exe� linker_so�linker_exe_cxx� linker_so_cxx)�super�__init__�check_config_h� debug_print� CONFIG_H_OK�warnr �cc�cxx�os�environ�get� linker_dll�linker_dll_cxx�set_executablesr � dll_libraries)�self�verbose�dry_run�force�status�details� shared_option�� __class__r r r! 7 s4 �� � zCompiler.__init__c C sB t jdtdd� t� � td�W d � S 1 sw Y d S )Nz�gcc_version attribute of CygwinCCompiler is deprecated. Instead of returning actual gcc version a fixed value 11.2.0 is returned.� )� stacklevelz11.2.0)�warningsr% �DeprecationWarningr r �r/ r r r � gcc_version[ s �$�zCompiler.gcc_versionc C s� |dv r"z | � dd|d|g� W dS ty! } zt|��d}~ww z+| �|�dkr<| � | j| |d|g | � W dS | � | j| |d|g | � W dS ty] } zt|��d}~ww )z:Compiles the source by spawning GCC and windres if needed.)�.rc�.res�windresz-iz-oNzc++)�spawnr r �detect_languager r )r/ �obj�src�ext�cc_args�extra_postargs�pp_opts�msgr r r �_compilej s2 ����� � ���zCompiler._compileNc s t � | pg �} t � |p g �}t � |pg �}|r | �t� |�| j� |durn|| jks0| jdkrntj� |d �}tj� tj� |��\}}tj� ||d �}dtj� |�� �dg}|�|� | � t||fd|� �� |�|� | su| �d� t� �|||||||d| | | | | � dS ) zLink the objects.Nr r z.defzLIBRARY �EXPORTSzwriting z-s)�copyr% �_runtime_library_dirs_msg�extendr. � EXECUTABLEr+ r( �path�dirname�splitext�basename�join�executer �appendr �link)r/ � target_desc�objects�output_filename� output_dir� libraries� library_dirs�runtime_library_dirs�export_symbols�debug� extra_preargsrG � build_temp� target_lang�temp_dir�dll_name� dll_extension�def_file�contentsr6 r r rW � sD � �z Compiler.linkc C s | � t� g S �N)r% rM �r/ �dirr r r �runtime_library_dir_option� s z#Compiler.runtime_library_dir_optionc s t j�|�}t� �|||�S ri )r( rP �normcaser �_make_out_path)r/ r[ � strip_dir�src_name� norm_src_namer6 r r rn � s zCompiler._make_out_pathc s i t � j�� fdd�dD ��S )z3 Add support for rc and res files. c s i | ]}||� j �qS r )� obj_extension)�.0rE r< r r � <dictcomp>� s z+Compiler.out_extensions.<locals>.<dictcomp>)r? r> )r �out_extensionsr< r6 r< r ru � s ��zCompiler.out_extensions�FFF) NNNNNFNNNN)�__name__� __module__� __qualname__�__doc__� compiler_typerr �static_lib_extension�shared_lib_extension�dylib_lib_extension�static_lib_format�shared_lib_format�dylib_lib_format� exe_extensionr! �propertyr= rJ rW rl rn ru � __classcell__r r r6 r r * s< $ �X r c s. e Zd ZdZdZd� fdd� Zdd� Z� ZS ) �MinGW32Compilerz:Handles the Mingw32 port of the GNU C compiler to Windows.�mingw32Fc s� t � �|||� d}t| j�rtd��| j| j� d�| j� d�| j� d�| j� d�| j� | j� d|� �| j� | j� d|� �d� d S )Nr z1Cygwin gcc cannot be used with --compiler=mingw32z -O -Wallz -shared -O -Wall� )r r r r r r r r ) r r! � is_cygwinccr& r r- r' r+ r, )r/ r0 r1 r2 r5 r6 r r r! � s �zMinGW32Compiler.__init__c C s t t��ri )r rM rj r r r rl s z*MinGW32Compiler.runtime_library_dir_optionrv )rw rx ry rz r{ r! rl r� r r r6 r r� � s r� �okznot ok� uncertainc C s� ddl m} dtjv rtdfS dtjv rtdfS | �� }z t�|�jdd�}W n t yD } zt d |� d |j � �fW Y d }~S d }~ww d }||v rPt}d }nt }d}||�d|� d|��fS )aw Check if the current Python installation appears amenable to building extensions with GCC. Returns a tuple (status, details), where 'status' is one of the following constants: - CONFIG_H_OK: all is well, go ahead and compile - CONFIG_H_NOTOK: doesn't look good - CONFIG_H_UNCERTAIN: not sure -- unable to read pyconfig.h 'details' is a human-readable string explaining the situation. Note there are two ways to conclude "OK": either 'sys.version' contains the string "GCC" (implying that this Python was built with GCC), or the installed "pyconfig.h" contains the string "__GNUC__". r )� sysconfig�GCCzsys.version mentions 'GCC'�Clangz sys.version mentions 'Clang'zutf-8)�encodingzcouldn't read 'z': N�__GNUC__�mentionszdoes not mentionr� ) � distutilsr� �sys�versionr$ �get_config_h_filename�pathlib�Path� read_text�OSError�CONFIG_H_UNCERTAIN�strerror�CONFIG_H_NOTOK)r� �fn�config_h�exc� substring�code�mention_inflectedr r r r" s& "��r" c C s" t t�| �dg �}|�� �d�S )zCTry to determine if the compiler that would be used is from cygwin.z -dumpmachines cygwin)r �shlex�split�strip�endswith)r& � out_stringr r r r� J s r� )!rz rL r( r� r� r� r: � subprocessr �errorsr r � file_utilr r� r r� r r � r r r r rM r r� r$ r� r� r" r� � get_versionsr r r r �<module> s6 � K 1 _distutils/compilers/C/__pycache__/errors.cpython-310.pyc 0000644 00000002377 15030122015 0017331 0 ustar 00 o �h= � @ sd G d d� de �ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�Zd S ) c @ � e Zd ZdZdS )�Errorz#Some compile/link operation failed.N��__name__� __module__� __qualname__�__doc__� r r �[/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/errors.pyr � r c @ r )�PreprocessErrorz.Failure to preprocess one or more C/C++ files.Nr r r r r r r r c @ r )� CompileErrorz2Failure to compile one or more C/C++ source files.Nr r r r r r r r c @ r )�LibErrorzKFailure to create a static library from one or more C/C++ object files.Nr r r r r r r r c @ r )� LinkErrorz]Failure to link one or more C/C++ object files into an executable or shared library file.Nr r r r r r r r c @ r )�UnknownFileTypez(Attempt to process an unknown file type.Nr r r r r r r r N)� Exceptionr r r r r r r r r r �<module> s _distutils/compilers/C/__pycache__/zos.cpython-310.pyc 0000644 00000010214 15030122015 0016615 0 ustar 00 o �h� � @ s� d Z ddlZddlmZ ddlmZ ddlmZ ddlmZ g d �g d �g d �d �Zg d �g d �g d �d �Z g d�g g d �Z g ddgddgd �Z G dd� dej �Z dS )a� distutils.zosccompiler Contains the selection of the c & c++ compilers on z/OS. There are several different c compilers on z/OS, all of them are optional, so the correct one needs to be chosen based on the users input. This is compatible with the following compilers: IBM C/C++ For Open Enterprise Languages on z/OS 2.0 IBM Open XL C/C++ 1.1 for z/OS IBM XL C/C++ V2.4.1 for z/OS 2.4 and 2.5 IBM z/OS XL C/C++ � N� )� sysconfig)�DistutilsExecError� )�unix)� CompileError)z-m64z-fvisibility=defaultz-fzos-le-char-mode=asciiz-fno-short-enums) �-q64� -qexportall�-qascii�-qstrict� -qnocsect� -Wa,asa,goff� -Wa,xplink� -qgonumber� -qenum=int�-Wc,DLL) r r r r r r r r r r z-qlanglvl=extc99)� ibm-openxl� ibm-xlclang�ibm-xlc) r r r r r r r r r r z-qlanglvl=extended0x)z-fasmz-fno-integrated-asz -Wa,--ASAz -Wa,--GOFFz-Wl,dllr c sn e Zd Zg d�Zg d�ZdgZdd� Zd� fdd� Zd d � Zd d � Z d� fdd� Z � Z S )�Compiler)z.c�.C�.cc�.cxx�.cppz.m�.s)r r r r r c sl � fdd�dD �}t |�dkrdS i }dD ]}d||< qdD ]}d||< q d D ]}d ||< q'|�|d d�S ) Nc s* g | ]}t j�|d � � rt j�� ��qS �N)�os�environ�get�path�basename)�.0�envvar��binary� �X/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/zos.py� <listcomp>o s � �z3Compiler._get_zos_compiler_name.<locals>.<listcomp>)�CC�CXX�LDSHAREDr r )z ibm-clangz ibm-clang64z ibm-clang++z ibm-clang++64�clangzclang++zclang-14)�xlclangz xlclang++�njscznjsc++r )�xlc�xlCzxlc++r )�lenr )�self�zos_compiler_names� zos_compilers�compilerr% r# r& �_get_zos_compiler_namen s � z Compiler._get_zos_compiler_nameFc s( t � �|||� | �� | _t�| � d S r )�super�__init__r5 � zos_compilerr �customize_compiler)r1 �verbose�dry_run�force�� __class__r% r& r7 � s zCompiler.__init__c C s� g }|| j v r| j}|�t| j � n$|| jv r,| j}|�t| j � |�t| j � n | j}|�t| j � |�|� z| � || |d|g | � W d S t y] } zt | ��d } ~ ww )Nz-o) �_cpp_extensions� compiler_cxx�extend� _cxx_argsr8 �_asm_extensions� compiler_so�_cc_args� _asm_args�spawnr r ) r1 �obj�src�ext�cc_args�extra_postargs�pp_opts� local_argsr4 �msgr% r% r& �_compile� s" "��zCompiler._compilec C s d| S )Nz-Lr% )r1 �dirr% r% r& �runtime_library_dir_option� s z#Compiler.runtime_library_dir_optionNc s t �d�}t jrtj�t �d�d|� d��}ntj�t �d�t �d�d|� d��}tj�|�r:| r7| �|� n|g} |rf|D ]'}|d d � D ] }tj�||� d��}tj�|�rd|�|� | �|� nqFq>| � t | j � t � � ||||||||| | | | | � d S )N� LDVERSION� abs_builddir� libpythonz.x�installed_base� platlibdir)r �get_config_var� python_buildr r �join�exists�append�removerA �_ld_argsr8 r6 �link)r1 � target_desc�objects�output_filename� output_dir� libraries� library_dirs�runtime_library_dirs�export_symbols�debug� extra_preargsrL � build_temp� target_lang� ldversion�side_deck_pathrQ �library�library_side_deckr= r% r& r_ � sR � � ���z Compiler.link)FFF) NNNNNFNNNN) �__name__� __module__� __qualname__�src_extensionsr? rC r5 r7 rP rR r_ � __classcell__r% r% r= r& r i s& �r ) �__doc__r � r �errorsr r r rE rB rF r^ r r% r% r% r& �<module> s. �# �#�� _distutils/compilers/C/__pycache__/base.cpython-310.pyc 0000644 00000117310 15030122015 0016721 0 ustar 00 o �h\� � @ s� U d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl mZmZmZmZmZmZ ddlmZ ddlmZ dd lmZ dd lmZ dd l m Z m Z dd l m Z dd l!m!Z! ddl"m#Z#m$Z$m%Z% ddl m&Z&m'Z'm(Z( er�ddl)m*Z*m+Z+m,Z, e+d�Z-ee.e/ e.e/ee/df f f Z0de1d< eddd�Z2eddd�Z3G dd� d�Z4d Z5dCdDd"d#�Z6d$d%d&d'd(d)d*�Z7dEd,d-�Z8 . . .dFdGd5d6�Z9dHd<d=�Z:dIdAdB�Z;dS )Jz�distutils.ccompiler Contains Compiler, an abstract base class that defines the interface for the Distutils compiler abstraction model.� )� annotationsN)�Callable�Iterable�MutableSequence�Sequence)� TYPE_CHECKING�ClassVar�Literal�TypeVar�Union�overload)�always_iterable� )�log)� newer_group)�mkpath)�DistutilsModuleError�DistutilsPlatformError)� move_file)�spawn)�execute�is_mingw� split_quoted� )� CompileError� LinkError�UnknownFileType)� TypeAlias� TypeVarTuple�Unpack�_Tsr �_Macro� _StrPathT�str | os.PathLike[str])�bound� _BytesPathT�bytes | os.PathLike[bytes]c @ sP e Zd ZU dZdZded< ded< dZded< dZd ed < dZd ed < dZ d ed < dZ d ed < dZ d ed< dZ d ed< dddddd�Z ded< g d�Zded< g Zded< g Zded< d�d�d#d$�Zd�d'd(�Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zed�d1d2��Zd�d�d6d7�Zd�d8d9�Zd�d;d<�Zd�d>d?�Z d�dAdB�Z d�dDdE�Z d�dFdG�Z d�dHdI�Z d�dJdK�Z!d�dLdM�Z"d�dOdP�Z#d�dRdS�Z$d�dYdZ�Z%d[d\� Z&d�d_d`�Z'd�dadb�Z(d�dedf�Z)d�djdk�Z*dldm� Z+d�dpdq�Z, d�d�dzd{�Z- d�d�dd��Z.d�d�� Z/ d�d�d�d��Z0d�Z1d�Z2d�Z3 d�d�d�d��Z4 d��d d�d��Z5 d��dd�d��Z6 �d�dd�d��Z7�dd�d��Z8�dd�d��Z9�dd�d��Z: �d�dd�d��Z; �d�d d�d��Z< ��d �d d�d��Z=e>d�d�� �Z?d�d�� Z@eAd�d�� �ZBe�d d�d���ZCeD ��d �d d�d���ZEeD ��d�dd�d���ZE ��d �dd�d��ZEeD ��d �d d�d���ZFeD ��d�dd�d���ZF ��d �dd�d��ZF � ��d�dd�dÄZG�d�dd�dɄZH�dd�d˄ZI�dd�d̈́ZJ Đd�dd�dӄZK�dd�dׄZLeD�dd�d݄�ZMeD�dd�d݄�ZM�dd�d݄ZM�d d�d�ZNdS ( �Compilera� Abstract base class to define the interface that must be implemented by real compiler classes. Also has some utility methods used by several compiler classes. The basic idea behind a compiler abstraction class is that each instance can be used for all the compile/link steps in building a single project. Thus, attributes common to all of those compile and link steps -- include directories, macros to define, libraries to link against, etc. -- are attributes of the compiler instance. To allow for variability in how individual files are treated, most of those attributes may be varied on a per-compilation or per-link basis. Nz ClassVar[str]� compiler_typezClassVar[dict]� executableszClassVar[list[str] | None]�src_extensionszClassVar[str | None]� obj_extension�static_lib_extension�shared_lib_extension�static_lib_format�shared_lib_format� exe_extension�c�c++�objc)�.cz.ccz.cppz.cxxz.mzClassVar[dict[str, str]]� language_map)r2 r3 r1 zClassVar[list[str]]�language_order� list[str]� include_dirs� library_dirsF�verbose�bool�dry_run�force�return�Nonec C sb || _ || _|| _d | _g | _g | _g | _g | _g | _g | _ | j � � D ] }| � || j | � q#d S �N) r< r= r: � output_dir�macrosr8 � librariesr9 �runtime_library_dirs�objectsr) �keys�set_executable)�selfr: r< r= �key� rJ �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/base.py�__init__� s �zCompiler.__init__�kwargs�strc K s@ |D ]}|| j vrtd|� d| jj� ���| �||| � qdS )a� Define the executables (and options for them) that will be run to perform the various stages of compilation. The exact set of executables that may be specified here depends on the compiler class (via the 'executables' class attribute), but most will have: compiler the C/C++ compiler linker_so linker used to create shared objects and libraries linker_exe linker used to create binary executables archiver static library creator On platforms with a command-line (Unix, DOS/Windows), each of these is a string that will be split into executable name and (optional) list of arguments. (Splitting the string is done similarly to how Unix shells operate: words are delimited by spaces, but quotes and backslashes can override this. See 'distutils.util.split_quoted()'.) zunknown executable 'z ' for class N)r) � ValueError� __class__�__name__rG )rH rM rI rJ rJ rK �set_executables� s ��zCompiler.set_executablesc C s. t |t�rt| |t|�� d S t| ||� d S r@ )� isinstancerN �setattrr )rH rI �valuerJ rJ rK rG � s zCompiler.set_executablec C s0 d}| j D ]}|d |kr| S |d7 }qd S )Nr r )rB )rH �name�i�defnrJ rJ rK � _find_macro� s zCompiler._find_macroc C s |D ]}| j |� qdS )z4Ensure that every element of 'definitions' is valid.N)�_check_macro_definition)rH � definitionsrX rJ rJ rK �_check_macro_definitions� s �z!Compiler._check_macro_definitionsc C s( t |t�r | j|� std|� d���dS )z� Raise a TypeError if defn is not valid. A valid definition is either a (name, value) 2-tuple or a (name,) tuple. zinvalid macro definition 'z?': must be tuple (string,), (string, string), or (string, None)N)rS �tuple�_is_valid_macro� TypeError)rH rX rJ rJ rK rZ � s ��z Compiler._check_macro_definitionc C s t | t�o t |ttd�f�S )z� A valid macro is a ``name : str`` and a ``value : str | None``. >>> Compiler._is_valid_macro('foo', None) True N)rS rN �type)rV rU rJ rJ rK r^ � s zCompiler._is_valid_macrorV rU � str | Nonec C s. | � |�}|dur | j|= | j�||f� dS )a_ Define a preprocessor macro for all compilations driven by this compiler object. The optional parameter 'value' should be a string; if it is not supplied, then the macro will be defined without an explicit value and the exact outcome depends on the compiler used (XXX true? does ANSI say anything about this?) N�rY rB �append)rH rV rU rW rJ rJ rK � define_macro� s zCompiler.define_macroc C s0 | � |�}|dur | j|= |f}| j�|� dS )a� Undefine a preprocessor macro for all compilations driven by this compiler object. If the same macro is defined by 'define_macro()' and undefined by 'undefine_macro()' the last call takes precedence (including multiple redefinitions or undefinitions). If the macro is redefined/undefined on a per-compilation basis (ie. in the call to 'compile()'), then that takes precedence. Nrb )rH rV rW �undefnrJ rJ rK �undefine_macro s zCompiler.undefine_macro�dirc C � | j �|� dS )z�Add 'dir' to the list of directories that will be searched for header files. The compiler is instructed to search directories in the order in which they are supplied by successive calls to 'add_include_dir()'. N)r8 rc �rH rg rJ rJ rK �add_include_dir � zCompiler.add_include_dir�dirsc C � |dd� | _ dS )ay Set the list of directories that will be searched to 'dirs' (a list of strings). Overrides any preceding calls to 'add_include_dir()'; subsequence calls to 'add_include_dir()' add to the list passed to 'set_include_dirs()'. This does not affect any list of standard include directories that the compiler may search by default. N�r8 �rH rl rJ rJ rK �set_include_dirs s zCompiler.set_include_dirs�libnamec C rh )a� Add 'libname' to the list of libraries that will be included in all links driven by this compiler object. Note that 'libname' should *not* be the name of a file containing a library, but the name of the library itself: the actual filename will be inferred by the linker, the compiler, or the compiler class (depending on the platform). The linker will be instructed to link against libraries in the order they were supplied to 'add_library()' and/or 'set_libraries()'. It is perfectly valid to duplicate library names; the linker will be instructed to link against libraries as many times as they are mentioned. N)rC rc )rH rq rJ rJ rK � add_library* s zCompiler.add_library�libnamesc C rm )z�Set the list of libraries to be included in all links driven by this compiler object to 'libnames' (a list of strings). This does not affect any standard system libraries that the linker may include by default. N)rC )rH rs rJ rJ rK � set_libraries: � zCompiler.set_librariesc C rh )a' Add 'dir' to the list of directories that will be searched for libraries specified to 'add_library()' and 'set_libraries()'. The linker will be instructed to search for libraries in the order they are supplied to 'add_library_dir()' and/or 'set_library_dirs()'. N)r9 rc ri rJ rJ rK �add_library_dirB rk zCompiler.add_library_dirc C rm )z�Set the list of library search directories to 'dirs' (a list of strings). This does not affect any standard library search path that the linker may search by default. N)r9 ro rJ rJ rK �set_library_dirsJ s zCompiler.set_library_dirsc C rh )zlAdd 'dir' to the list of directories that will be searched for shared libraries at runtime. N)rD rc ri rJ rJ rK �add_runtime_library_dirQ s z Compiler.add_runtime_library_dirc C rm )z�Set the list of directories to search for shared libraries at runtime to 'dirs' (a list of strings). This does not affect any standard search path that the runtime linker may search by default. N)rD ro rJ rJ rK �set_runtime_library_dirsW ru z!Compiler.set_runtime_library_dirs�objectc C rh )z�Add 'object' to the list of object files (or analogues, such as explicitly named library files or the output of "resource compilers") to be included in every link driven by this compiler object. N)rE rc )rH rz rJ rJ rK �add_link_object_ rk zCompiler.add_link_objectrE c C rm )z�Set the list of object files (or analogues) to be included in every link to 'objects'. This does not affect any standard object files that the linker may include by default (such as system libraries). N)rE )rH rE rJ rJ rK �set_link_objectsg ru zCompiler.set_link_objects�outdirrB �list[_Macro] | None�incdirs�"list[str] | tuple[str, ...] | Nonec C s� | � |||�\}}}|du rg }| j|d|d�}t|�t|�ks"J �t||�}i } tt|��D ]!} || } || } tj�| �d } | �tj� | �� | | f| | < q/||||| fS )z;Process arguments and decide which source files to compile.NF)� strip_dirrA r ) �_fix_compile_args�object_filenames�len�gen_preprocess_options�range�os�path�splitextr �dirname)rH r} rB r �sources�depends�extrarE �pp_opts�buildrW �src�obj�extrJ rJ rK �_setup_compilet s zCompiler._setup_compilec C s0 |dg }|rdg|d d�< |r||d d�< |S )Nz-cz-gr rJ )rH r� �debug�before�cc_argsrJ rJ rK � _get_cc_args� s zCompiler._get_cc_argsrA �#tuple[str, list[_Macro], list[str]]c C s� |du r| j }n t|t�std��|du rt| j�}nt|t�r(|| jp%g }ntd��|du r6t| j�}nt|ttf�rGt|�| jpDg }ntd��|| jj7 }|||fS )a' Typecheck and fix-up some of the arguments to the 'compile()' method, and return fixed-up values. Specifically: if 'output_dir' is None, replaces it with 'self.output_dir'; ensures that 'macros' is a list, and augments it with 'self.macros'; ensures that 'include_dirs' is a list, and augments it with 'self.include_dirs'. Guarantees that the returned values are of the correct type, i.e. for 'output_dir' either string or None, and for 'macros' and 'include_dirs' either list or None. N�%'output_dir' must be a string or Nonez/'macros' (if supplied) must be a list of tuplesz6'include_dirs' (if supplied) must be a list of strings) rA rS rN r_ �listrB r8 r] rP )rH rA rB r8 rJ rJ rK r� � s zCompiler._fix_compile_argsc C s* | j ||d�}t|�t|�ksJ �|i fS )a, Decide which source files must be recompiled. Determine the list of object files corresponding to 'sources', and figure out which ones really need to be recompiled. Return a list of all object files and a dictionary telling which source files can be skipped. �rA )r� r� )rH r� rA r� rE rJ rJ rK � _prep_compile� s zCompiler._prep_compile�list[str] | tuple[str, ...]�tuple[list[str], str]c C sN t |ttf�s td��t|�}|du r| j}||fS t |t�s#td��||fS )z�Typecheck and fix up some arguments supplied to various methods. Specifically: ensure that 'objects' is a list; if output_dir is None, replace with self.output_dir. Return fixed versions of 'objects' and 'output_dir'. z,'objects' must be a list or tuple of stringsNr� )rS r� r] r_ rA rN )rH rE rA rJ rJ rK �_fix_object_args� s �zCompiler._fix_object_argsrC rD �&tuple[list[str], list[str], list[str]]c C s� |du r t | j�}nt|t tf�rt |�| jpg }ntd��|du r)t | j�}nt|t tf�r:t |�| jp7g }ntd��|| jj7 }|du rNt | j�}nt|t tf�r_t |�| jp\g }ntd��|||fS )a; Typecheck and fix up some of the arguments supplied to the 'link_*' methods. Specifically: ensure that all arguments are lists, and augment them with their permanent versions (eg. 'self.libraries' augments 'libraries'). Return a tuple with fixed versions of all arguments. Nz3'libraries' (if supplied) must be a list of stringsz6'library_dirs' (if supplied) must be a list of stringsz>'runtime_library_dirs' (if supplied) must be a list of strings)r� rC rS r] r_ r9 rP rD )rH rC r9 rD rJ rJ rK � _fix_lib_args� s* �� zCompiler._fix_lib_argsc C s0 | j rdS | jrt||dd�}|S t||�}|S )zjReturn true if we need to relink the files listed in 'objects' to recreate 'output_file'. T�newer)�missing)r= r< r )rH rE � output_filer� rJ rJ rK � _need_link s �zCompiler._need_linkr� �str | list[str]c C sz t |t�s|g}d}t| j�}|D ])}tj�|�\}}| j�|�}z| j� |�}||k r0|}|}W q t y: Y qw |S )z|Detect the language of a given file, or list of files. Uses language_map, and language_order to do the job. N) rS r� r� r6 r� r� r� r5 �get�indexrO ) rH r� �langr� �source�baser� �extlang�extindexrJ rJ rK �detect_language s" � �zCompiler.detect_languager� r# r� � str | os.PathLike[str] | None� extra_preargs�list[str] | None�extra_postargs�Iterable[str] | Nonec C � dS )a� Preprocess a single C/C++ source file, named in 'source'. Output will be written to file named 'output_file', or stdout if 'output_file' not supplied. 'macros' is a list of macro definitions as for 'compile()', which will augment the macros set with 'define_macro()' and 'undefine_macro()'. 'include_dirs' is a list of directory names that will be added to the default list. Raises PreprocessError on failure. NrJ )rH r� r� rB r8 r� r� rJ rJ rK � preprocess4 s zCompiler.preprocess� Sequence[str | os.PathLike[str]]r� r� c C sr | � ||||||�\}} }} } | �| ||�} | D ] } z| | \}}W n ty+ Y qw | �| ||| || � q| S )aK Compile one or more source files. 'sources' must be a list of filenames, most likely C/C++ files, but in reality anything that can be handled by a particular compiler and compiler class (eg. MSVCCompiler can handle resource files in 'sources'). Return a list of object filenames, one per source filename in 'sources'. Depending on the implementation, not all source files will necessarily be compiled, but all corresponding object filenames will be returned. If 'output_dir' is given, object files will be put under it, while retaining their original path component. That is, "foo/bar.c" normally compiles to "foo/bar.o" (for a Unix implementation); if 'output_dir' is "build", then it would compile to "build/foo/bar.o". 'macros', if given, must be a list of macro definitions. A macro definition is either a (name, value) 2-tuple or a (name,) 1-tuple. The former defines a macro; if the value is None, the macro is defined without an explicit value. The 1-tuple case undefines a macro. Later definitions/redefinitions/ undefinitions take precedence. 'include_dirs', if given, must be a list of strings, the directories to add to the default include file search path for this compilation only. 'debug' is a boolean; if true, the compiler will be instructed to output debug symbols in (or alongside) the object file(s). 'extra_preargs' and 'extra_postargs' are implementation- dependent. On platforms that have the notion of a command-line (e.g. Unix, DOS/Windows), they are most likely lists of strings: extra command-line arguments to prepend/append to the compiler command line. On other platforms, consult the implementation class documentation. In any event, they are intended as an escape hatch for those occasions when the abstract compiler framework doesn't cut the mustard. 'depends', if given, is a list of filenames that all targets depend on. If a source file is older than any file in depends, then the source file will be recompiled. This supports dependency tracking, but only at a coarse granularity. Raises CompileError on failure. )r� r� �KeyError�_compile)rH r� rA rB r8 r� r� r� r� rE r� r� r� r� r� r� rJ rJ rK �compileH s = � �zCompiler.compilec C r� )z Compile 'src' to product 'obj'.NrJ )rH r� r� r� r� r� r� rJ rJ rK r� � � zCompiler._compile�output_libname� target_langc C r� )a& Link a bunch of stuff together to create a static library file. The "bunch of stuff" consists of the list of object files supplied as 'objects', the extra object files supplied to 'add_link_object()' and/or 'set_link_objects()', the libraries supplied to 'add_library()' and/or 'set_libraries()', and the libraries supplied as 'libraries' (if any). 'output_libname' should be a library name, not a filename; the filename will be inferred from the library name. 'output_dir' is the directory where the library file will be put. 'debug' is a boolean; if true, debugging information will be included in the library (note that on most platforms, it is the compile step where this matters: the 'debug' flag is included here just for consistency). 'target_lang' is the target language for which the given objects are being compiled. This allows specific linkage time treatment of certain languages. Raises LibError on failure. NrJ )rH rE r� rA r� r� rJ rJ rK �create_static_lib� s zCompiler.create_static_lib� shared_object�shared_library� executable� target_desc�output_filename�export_symbols� build_tempc C � t �)au Link a bunch of stuff together to create an executable or shared library file. The "bunch of stuff" consists of the list of object files supplied as 'objects'. 'output_filename' should be a filename. If 'output_dir' is supplied, 'output_filename' is relative to it (i.e. 'output_filename' can provide directory components if needed). 'libraries' is a list of libraries to link against. These are library names, not filenames, since they're translated into filenames in a platform-specific way (eg. "foo" becomes "libfoo.a" on Unix and "foo.lib" on DOS/Windows). However, they can include a directory component, which means the linker will look in that specific directory rather than searching all the normal locations. 'library_dirs', if supplied, should be a list of directories to search for libraries that were specified as bare library names (ie. no directory component). These are on top of the system default and those supplied to 'add_library_dir()' and/or 'set_library_dirs()'. 'runtime_library_dirs' is a list of directories that will be embedded into the shared library and used to search for other shared libraries that *it* depends on at run-time. (This may only be relevant on Unix.) 'export_symbols' is a list of symbols that the shared library will export. (This appears to be relevant only on Windows.) 'debug' is as for 'compile()' and 'create_static_lib()', with the slight distinction that it actually matters on most platforms (as opposed to 'create_static_lib()', which includes a 'debug' flag mostly for form's sake). 'extra_preargs' and 'extra_postargs' are as for 'compile()' (except of course that they supply command-line arguments for the particular linker being used). 'target_lang' is the target language for which the given objects are being compiled. This allows specific linkage time treatment of certain languages. Raises LinkError on failure. ��NotImplementedError)rH r� rE r� rA rC r9 rD r� r� r� r� r� r� rJ rJ rK �link� s ;z Compiler.linkc C s2 | � tj|| j|dd�||||||| | | | � d S )N�shared)�lib_type)r� r' �SHARED_LIBRARY�library_filename) rH rE r� rA rC r9 rD r� r� r� r� r� r� rJ rJ rK �link_shared_lib� s �zCompiler.link_shared_libc C s( | � tj||||||||| | | | � d S r@ )r� r' � SHARED_OBJECT) rH rE r� rA rC r9 rD r� r� r� r� r� r� rJ rJ rK �link_shared_object s �zCompiler.link_shared_object�output_prognamec C s. | � tj|| �|�||||d ||| d | � d S r@ )r� r' � EXECUTABLE�executable_filename) rH rE r� rA rC r9 rD r� r� r� r� rJ rJ rK �link_executable< s �zCompiler.link_executablec C r� )zkReturn the compiler option to add 'dir' to the list of directories searched for libraries. r� ri rJ rJ rK �library_dir_option^ r� zCompiler.library_dir_optionc C r� )zsReturn the compiler option to add 'dir' to the list of directories searched for runtime libraries. r� ri rJ rJ rK �runtime_library_dir_optiond r� z#Compiler.runtime_library_dir_option�libc C r� )zReturn the compiler option to add 'lib' to the list of libraries linked into the shared library or executable. r� )rH r� rJ rJ rK �library_optionj r� zCompiler.library_option�funcname�includesc C s� ddl }|du r g }nt�dt� |du rg }nt�dt� |du r$g }|du r*g }|jd|dd�\}}tj|dd d ��*} |D ] } | �d | � d �� q?|sV| �d |� d�� | �d|� d�� W d � n1 siw Y z"z | j|g|d�} W n t y� Y W t� |� dS w W t� |� nt� |� w z=z | j | d||d� W n t t fy� Y W | D ]} t� | � q�dS w t� | jd| jp�dd�� W | D ]} t� | � q�dS | D ]} t� | � q�w )aR Return a boolean indicating whether funcname is provided as a symbol on the current platform. The optional arguments can be used to augment the compilation environment. The libraries argument is a list of flags to be passed to the linker to make additional symbol definitions available for linking. The includes and include_dirs arguments are deprecated. Usually, supplying include files with function declarations will cause function detection to fail even in cases where the symbol is available for linking. r Nzincludes is deprecatedzinclude_dirs is deprecatedr4 T)�text�wzutf-8)�encodingz #include "z" z*#ifdef __cplusplus extern "C" #endif char z(void); z'int main (int argc, char **argv) { z(); return 0; } rn Fza.out)rC r9 � r� )�tempfile�warnings�warn�DeprecationWarning�mkstempr� �fdopen�writer� r �remover� r r_ r� rA ) rH r� r� r8 rC r9 r� �fd�fname�f�inclrE �fnrJ rJ rK � has_functionp sl ���� � �� � ��� � �zCompiler.has_function� Iterable[str]c C r� )aH Search the specified list of directories for a static or shared library file 'lib' and return the full path to that file. If 'debug' true, look for a debugging version (if that makes sense on the current platform). Return None if 'lib' wasn't found in any of the specified directories. r� )rH rl r� r� rJ rJ rK �find_library_file� s zCompiler.find_library_filer� �source_filenames� Iterable[str | os.PathLike[str]]r� c s& � d u rd� t � ��fdd�|D ��S )Nr� c 3 s � | ] }�� � �|�V qd S r@ )�_make_out_path)�.0�src_name�rA rH r� rJ rK � <genexpr>� s � � �z,Compiler.object_filenames.<locals>.<genexpr>)r� )rH r� r� rA rJ r� rK r� � s �zCompiler.object_filenamesc C s t �| j| j�S r@ )�dict�fromkeysr* r+ )rH rJ rJ rK �out_extensions s zCompiler.out_extensionsc C s | � |||| j�S r@ )�_make_out_path_extsr� )rH rA r� r� rJ rJ rK r� s �zCompiler._make_out_pathc C sn t �|�}| �|�}z||j }W n ty$ td|j� d|� d���w |r-t �|j�}tj� ||� |��S )a >>> exts = {'.c': '.o'} >>> Compiler._make_out_path_exts('.', False, '/foo/bar.c', exts).replace('\\', '/') './foo/bar.o' >>> Compiler._make_out_path_exts('.', True, '/foo/bar.c', exts).replace('\\', '/') './bar.o' zunknown file type 'z ' (from 'z')) �pathlib�PurePath�_make_relative�suffix� LookupErrorr rV r� r� �join� with_suffix)�clsrA r� r� � extensionsr� r� �new_extrJ rJ rK r� s � z Compiler._make_out_path_extsr� � pathlib.Pathc C s | � | j�S r@ )� relative_to�anchor)r� rJ rJ rK r� ! s zCompiler._make_relative�basename�Literal[False]c C � d S r@ rJ �rH r r� rA rJ rJ rK �shared_object_filename% � z Compiler.shared_object_filename� Literal[True]c C r r@ rJ r rJ rJ rK r , r c C s0 |d usJ �|rt j�|�}t j�||| j �S r@ )r� r� r r� r- r rJ rJ rK r 3 s c C r r@ rJ r rJ rJ rK r� > r z Compiler.executable_filenamec C r r@ rJ r rJ rJ rK r� E r c C s4 |d usJ �|rt j�|�}t j�||| jpd �S )Nr� )r� r� r r� r0 r rJ rJ rK r� L s �staticr� c C sz |d usJ �d}|t |�vrtd|� ���t| |d �}t| |d �}tj�|�\}} || |f } |r5d}tj�||| �S )Nz)"static", "shared", "dylib", "xcode_stub"z'lib_type' must be � _lib_format�_lib_extensionr� )�evalrO �getattrr� r� �splitr� ) rH rq r� r� rA �expected�fmtr� rg r� �filenamerJ rJ rK r� W s zCompiler.library_filenamer �msg�level�intc C s t �|� d S r@ )r r� )rH r r rJ rJ rK �announcen s zCompiler.announcec C s ddl m} |rt|� d S d S )Nr )�DEBUG)�distutils.debugr �print)rH r r rJ rJ rK � debug_printq s �zCompiler.debug_printc C s t j�d|� d�� d S )Nz warning: � )�sys�stderrr� )rH r rJ rJ rK r� w s z Compiler.warn�func� Callable[[Unpack[_Ts]], object]�args�tuple[Unpack[_Ts]]c C s t |||| j� d S r@ )r r< )rH r! r# r r rJ rJ rK r z s zCompiler.execute�cmd�/MutableSequence[bytes | str | os.PathLike[str]]c K s t |fd| ji|�� d S )Nr< )r r< )rH r% rM rJ rJ rK r � s zCompiler.spawnr� �dstr" �_StrPathT | strc C r r@ rJ �rH r� r' rJ rJ rK r � � zCompiler.move_filer& r% �_BytesPathT | bytesc C r r@ rJ r) rJ rJ rK r � r* �3str | os.PathLike[str] | bytes | os.PathLike[bytes]c C s t ||| jd�S �N)r< )r r< r) rJ rJ rK r � s � c C s t ||| jd� d S r- )r r< )rH rV �moderJ rJ rK r � s zCompiler.mkpath)FFF)r: r; r< r; r= r; r> r? )rM rN r> r? r@ )rV rN rU ra r> r? )rV rN r> r? )rg rN r> r? )rl r7 r> r? )rq rN r> r? )rs r7 r> r? )rz rN r> r? )rE r7 r> r? )r} ra rB r~ r r� )rA ra rB r~ r8 r� r> r� )rE r� rA ra r> r� )rC r� r9 r� rD r� r> r� )r� r� r> ra )NNNNN) r� r# r� r� rB r~ r8 r� r� r� r� r� )NNNFNNN)r� r� rA ra rB r~ r8 r� r� r; r� r� r� r� r� r� r> r7 )NFN) rE r� r� rN rA ra r� r; r� ra r> r? ) NNNNNFNNNN)r� rN rE r� r� rN rA ra rC r� r9 r� rD r� r� r� r� r; r� r� r� r� r� r� r� ra )rE r� r� rN rA ra rC r� r9 r� rD r� r� r� r� r; r� r� r� r� r� r� r� ra )rE r� r� rN rA ra rC r� r9 r� rD r� r� r� r� r; r� r� r� r� r� r� r� ra )NNNNFNNN)rE r� r� rN rA ra rC r� r9 r� rD r� r� r; r� r� r� r� r� ra )rg rN r> rN )r� rN r> rN )NNNN) r� rN r� r� r8 r� rC r� r9 r� r> r; )F)rl r� r� rN r� r; r> ra )Fr� )r� r� r� r; rA r� r> r7 )r� r )r rN r� r rA r# r> rN )r� )r r# r� r rA r# r> rN )r r# r� r; rA r# r> rN )r Fr� )rq rN r� rN r� r; rA r# )r )r rz r r r> r? )r rz r> r? )Nr ) r! r" r# r$ r rz r r r> r? )r% r& r> r? )r� r# r' r" r> r( )r� r& r' r% r> r+ )r� r, r' r, r> r, )r. )OrQ � __module__� __qualname__�__doc__r( �__annotations__r* r+ r, r- r. r/ r0 r5 r6 r8 r9 rL rR rG rY r\ rZ � staticmethodr^ rd rf rj rp rr rt rv rw rx ry r{ r| r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� �propertyr� r� � classmethodr� r� r r r� r� r r r� r r r r rJ rJ rJ rK r' 3 sX � � &! ' * � �L �! �C�#�#� " �[�0� �� � �� �� � r' ))zcygwin.*�unix)�zosr8 )�posixr7 )�nt�msvc�osnamera �platformr> rN c C s` | du rt j} |du rtj}t� rdS tD ]\}}t�||�dus)t�|| �dur-| S qdS )a\ Determine the default compiler to use for the given platform. osname should be one of the standard Python OS names (i.e. the ones returned by os.name) and platform the common value returned by sys.platform for the platform in question. The default values are os.name and sys.platform in case the parameters are not given. N�mingw32r7 )r� rV r r= r �_default_compilers�re�match)r< r= �pattern�compilerrJ rJ rK �get_default_compiler� s �rD )� unixccompiler� UnixCCompilerz standard UNIX-style compiler)� _msvccompiler� MSVCCompilerzMicrosoft Visual C++)�cygwinccompiler�CygwinCCompilerz'Cygwin port of GNU C Compiler for Win32)rI �Mingw32CCompilerz(Mingw32 port of GNU C Compiler for Win32)� bcppcompiler� BCPPCompilerzBorland C++ Compiler)� zosccompiler� zOSCCompilerzIBM XL C/C++ Compilers)r7 r; �cygwinr> �bcppr8 r? c C s8 ddl m} tdd� t�� D ��}| |�}|�d� dS )zyPrint list of available compilers (used by the "--help-compiler" options to "build", "build_ext", "build_clib"). r )� FancyGetoptc s s& � | ]}d | dt | d fV qdS )z compiler=N� )�compiler_class)r� rC rJ rJ rK r� � s � � �z!show_compilers.<locals>.<genexpr>z List of available compilers:N)�distutils.fancy_getoptrR �sortedrT rF � print_help)rR � compilers�pretty_printerrJ rJ rK �show_compilers� s �rZ F�platrC r: r; r< r= c C s� | du rt j} z|du rt| �}t| \}}}W n ty5 d| � d�}|dur1|d|� d� }t|��w zd| }t|� tj| } t | �| } W n t yZ t d|� d��� tyk t d|� d |� d���w | d||�S ) a[ Generate an instance of some CCompiler subclass for the supplied platform/compiler combination. 'plat' defaults to 'os.name' (eg. 'posix', 'nt'), and 'compiler' defaults to the default compiler for that platform. Currently only 'posix' and 'nt' are supported, and the default compilers are "traditional Unix interface" (UnixCCompiler class) and Visual C++ (MSVCCompiler class). Note that it's perfectly possible to ask for a Unix compiler object under Windows, and a Microsoft compiler object under Unix -- if you supply a value for 'compiler', 'plat' is ignored. Nz2don't know how to compile C/C++ code on platform '�'z with 'z ' compilerz distutils.z1can't compile C/C++ code: unable to load module 'z0can't compile C/C++ code: unable to find class 'z ' in module ') r� rV rD rT r� r � __import__r �modules�vars� ImportErrorr ) r[ rC r: r< r= � module_name� class_name�long_descriptionr �module�klassrJ rJ rK � new_compiler� s: � � ��� rf rB �Iterable[_Macro]r8 r� r7 c C s� g }| D ]L}t |t�rdt|� krdks n td|� d���t|�dkr1|�d|d � �� qt|�dkrP|d du rH|�d|d � �� q|�d j|� � q|�d d � |D �� |S ) a Generate C pre-processor options (-D, -U, -I) as used by at least two types of compilers: the typical Unix compiler and Visual C++. 'macros' is the usual thing, a list of 1- or 2-tuples, where (name,) means undefine (-U) macro 'name', and (name,value) means define (-D) macro 'name' to 'value'. 'include_dirs' is just a list of directory names to be added to the header file search path (-I). Returns a list of command-line options suitable for either Unix compilers or Visual C++. r rS zbad macro definition 'z8': each element of 'macros' list must be a 1- or 2-tuplez-Ur Nz-Dz-D{}={}c s s � | ]}d |� �V qdS )z-INrJ �r� rg rJ rJ rK r� K s � z)gen_preprocess_options.<locals>.<genexpr>)rS r] r� r_ rc �format�extend)rB r8 r� �macrorJ rJ rK r� ! s $ � �r� r9 rD rC c s� � fdd�|D �}|D ] }|� t� �|��� q |D ]-}tj�|�\}}|r?� �|g|�} | r5|�| � q� �d|� d�� q|�� � |�� q|S )ac Generate linker options for searching library directories and linking with specific libraries. 'libraries' and 'library_dirs' are, respectively, lists of library names (not filenames!) and search directories. Returns a list of command-line options suitable for use with some compiler (depending on the two format strings passed in). c s g | ]}� � |��qS rJ )r� rh �rC rJ rK � <listcomp>[ s z#gen_lib_options.<locals>.<listcomp>z"no library file corresponding to 'z' found (skipping)) rj r r� r� r� r r� rc r� r� ) rC r9 rD rC �lib_optsrg r� �lib_dir�lib_name�lib_filerJ rl rK �gen_lib_optionsO s �rr )NN)r< ra r= ra r> rN )r> r? )NNFFF) r[ ra rC ra r: r; r< r; r= r; r> r' )rB rg r8 r� r> r7 ) rC r' r9 r� rD r� rC r� r> r7 )<r2 � __future__r r� r� r@ r r� �collections.abcr r r r �typingr r r r r r �more_itertoolsr �_logr � _modifiedr �dir_utilr �errorsr r � file_utilr r �utilr r r r r r �typing_extensionsr r r r r] rN r! r3 r" r% r' r? rD rT rZ rf r� rr rJ rJ rJ rK �<module> sf ( t � � 4. _distutils/compilers/C/__pycache__/unix.cpython-310.pyc 0000644 00000025502 15030122015 0016773 0 ustar 00 o �hv@ � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZ dd lmZ dd lmZ dd lmZ d d l mZ d dlmZmZmZ d dlmZmZm Z dd� Z dd� Z dd� Z G dd� dej �Z dS )a9 distutils.unixccompiler Contains the UnixCCompiler class, a subclass of CCompiler that handles the "typical" Unix-style command-line C compiler: * macros defined with -Dname[=value] * macros undefined with -Uname * include search directories specified with -Idir * libraries specified with -lllib * library search directories specified with -Ldir * compile handled by 'cc' (or similar) executable with -c option: compiles .c to .o * link static library handled by 'ar' command (possibly with 'ranlib') * link shared library handled by 'cc -shared' � )� annotationsN)�Iterable� )� sysconfig)�log)�compiler_fixup)�newer)�consolidate_linker_args)�DistutilsExecError� )�base)�_Macro�gen_lib_options�gen_preprocess_options)� CompileError�LibError� LinkErrorc C sT d}t j�| d �dkr d}d| | v r |d7 }d| | v s| d|� | |d� fS )z� For macOS, split command into 'env' portion (if any) and the rest of the linker command. >>> _split_env(['a', 'b', 'c']) ([], ['a', 'b', 'c']) >>> _split_env(['/usr/bin/env', 'A=3', 'gcc']) (['/usr/bin/env', 'A=3'], ['gcc']) r �envr �=N��os�path�basename��cmd�pivot� r �Y/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/_distutils/compilers/C/unix.py� _split_env7 s �r c C s, t j�| d �dk}| d|� | |d� fS )a AIX platforms prefix the compiler with the ld_so_aix script, so split that from the linker command. >>> _split_aix(['a', 'b', 'c']) ([], ['a', 'b', 'c']) >>> _split_aix(['/bin/foo/ld_so_aix', 'gcc']) (['/bin/foo/ld_so_aix'], ['gcc']) r � ld_so_aixNr r r r r � _split_aixI s r c C s, t |�}| d|� |kr|nd}| |d� S )a The linker command usually begins with the compiler command (possibly multiple elements), followed by zero or more params for shared library building. If the LDSHARED env variable overrides the linker command, however, the commands may not match. Return the best guess of the linker parameters by stripping the linker command. If the compiler command does not match the linker command, assume the linker command is just the first element. >>> _linker_params('gcc foo bar'.split(), ['gcc']) ['foo', 'bar'] >>> _linker_params('gcc foo bar'.split(), ['other']) ['foo', 'bar'] >>> _linker_params('ccache gcc foo bar'.split(), 'ccache gcc'.split()) ['foo', 'bar'] >>> _linker_params(['gcc'], ['gcc']) [] Nr )�len)� linker_cmd� compiler_cmd�c_lenr r r r �_linker_paramsW s r% c s: e Zd ZdZddgdgdgdgddgddgdgddgddgdd� Zejdd � d kr/d ged < g d �Zd ZdZ dZ dZ dZ d Z ZZeZejdkrRdZdZ dZ dZ� fdd�Z dFdGd&d'�Zd(d)� Z dHd+d,�Z * dIdJd4d5�Zd6d7� Zd8d9� ZdKd>d?�Zd@dA� ZedBdC� �Z dLdDdE�Z � Z S )M�Compiler�unixN�cc�c++z-shared�arz-cr) � preprocessor�compiler� compiler_so� compiler_cxx�compiler_so_cxx� linker_so� linker_so_cxx� linker_exe�linker_exe_cxx�archiver�ranlib� �darwinr5 )z.cz.Cz.ccz.cxxz.cppz.mz.oz.az.soz.dylibz.tbdzlib%s%s�cygwinz.exez.dll.az.dllzcyg%s%sc sJ t � �|||�\}}}t�d�}|r |�d�r ||v r |�|� |||fS )z'Remove standard library path from rpath�LIBDIRz/usr/lib)�super� _fix_lib_argsr �get_config_var� startswith�remove)�self� libraries� library_dirs�runtime_library_dirs�libdir�� __class__r r r; � s � �� zCompiler._fix_lib_args�source�str | os.PathLike[str]� output_file� str | os.PathLike[str] | None�macros�list[_Macro] | None� include_dirs�"list[str] | tuple[str, ...] | None� extra_preargs�list[str] | None�extra_postargs�Iterable[str] | Nonec C s� | � d ||�}|\}}}t||�} | j| } |r | �d|g� |r'|| d d�< |r.| �|� | �|� | jp>|d u p>t||�} | sCd S |rN| �tj � |�� z| � | � W d S t yf } zt | ��d } ~ ww )N�-or )�_fix_compile_argsr r+ �extend�append�forcer �mkpathr r �dirname�spawnr r ) r? rF rH rJ rL rN rP � fixed_args�ignore�pp_opts�pp_args� preprocess�msgr r r r^ � s, ��zCompiler.preprocessc C s� t | j|| �}t | j|| �}z)| �|�dkr)| �|| |d|g | � W d S | �|| |d|g | � W d S tyI } zt| ��d } ~ ww )Nr) rR )r r- r/ �detect_languagerY r r ) r? �obj�src�ext�cc_argsrP r\ r- r/ r_ r r r �_compile� s �"��zCompiler._compileFc C s� | � ||�\}}| j||d�}| �||�rN| �tj�|�� | �| j|g | | j � | j rLz | �| j |g � W d S t yK } zt |��d }~ww d S t �d|� d S )N)� output_dir�skipping %s (up-to-date))�_fix_object_args�library_filename� _need_linkrW r r rX rY r4 �objectsr5 r r r �debug)r? rk �output_libnamerf rl � target_lang�output_filenamer_ r r r �create_static_lib� s ���zCompiler.create_static_librk �list[str] | tuple[str, ...]rf � str | Noner@ rA rB c C s� | � ||�\}}| �|||�}|\}}}t| |||�}t|ttd �f�s(td��|d ur3tj� ||�}| � ||�r�|| j | d|g }| rMdg|d d�< | rU| |d d�< | r\|� | � | � tj�|�� zV|tjjk}|rq| jn | dkrx| jn| jd d � }| dkr�| jr�t|�\}}t|�\}}t| j�\}}t| j�\}}t||�}|| | | }t||�}| �|| � W d S ty� } zt |��d }~ww t � d|� d S )Nz%'output_dir' must be a string or NonerR z-gr r) rg ) rh r; r � isinstance�str�type� TypeErrorr r �joinrj rk rT rW rX r r& � EXECUTABLEr2 r1 r0 r. r r r% r rY r r r rl ) r? � target_descrk ro rf r@ rA rB �export_symbolsrl rN rP � build_temprn rZ �lib_opts�ld_args� building_exe�linkerr � linker_ne�aix� linker_na�_�compiler_cxx_ne� linker_exe_ne�paramsr_ r r r �link� sL �� ��z Compiler.linkc C � d| S )N�-Lr )r? �dirr r r �library_dir_option> � zCompiler.library_dir_optionc C s0 t �d�}tj�t�|�d �}d|v pd|v S )N�CCr �gcczg++)r r< r r r �shlex�split)r? �cc_varr, r r r �_is_gccA s zCompiler._is_gccr� rt �return�str | list[str]c C s� t jd d� dkr&ddlm}m} |� }|r"||�ddgkr"d| S d| S t jd d � d kr3d | S t jd d� d krH| �� rBd ndd| gS t�d�dkrWtdd| g�S d| S )Nr6 r7 r )�get_macosx_target_ver� split_version� � z -Wl,-rpath,r� � �freebsdz -Wl,-rpath=zhp-uxz-Wl,+sz+s�GNULD�yesz-Wl,--enable-new-dtagsz-Wl,-R) �sys�platform�distutils.utilr� r� r� r r< r )r? r� r� r� �macosx_target_verr r r �runtime_library_dir_optionF s$ ��z#Compiler.runtime_library_dir_optionc C r� )Nz-lr )r? �libr r r �library_optionn r� zCompiler.library_optionc C sh t �d�}t�d|�}tjdko!|o!| �d�p!| �d�o!| �d� }|r2tj� |� d�| dd� �S | S ) a� macOS users can specify an alternate SDK using'-isysroot'. Calculate the SDK root if it is specified. Note that, as of Xcode 7, Apple SDKs may contain textual stub libraries with .tbd extensions rather than the normal .dylib shared libraries installed in /. The Apple compiler tool chain handles this transparently but it can cause problems for programs that are being built with an SDK and searching for specific libraries. Callers of find_library_file need to keep in mind that the base filename of the returned SDK library file might have a different extension from that of the library file installed on the running system, for example: /Applications/Xcode.app/Contents/Developer/Platforms/ MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/ usr/lib/libedit.tbd vs /usr/lib/libedit.dylib �CFLAGSz-isysroot\s*(\S+)r7 z/System/z/usr/z /usr/local/r N) r r< �re�searchr� r� r= r r rw �group)r� �cflags�match� apply_rootr r r � _library_rootq s � �$ zCompiler._library_rootc sT � �fdd�d� � D �}t�j|�}t�tjjt�||��}t tjj |�}t |d�S )z� Second-guess the linker with not much hard data to go on: GCC seems to prefer the shared library, so assume that *all* Unix C compilers do, ignoring even GCC's "-static" option. c 3 s � | ] }�j � |d �V qdS ))�lib_typeN)ri )�.0ru �r� r? r r � <genexpr>� s � � �z-Compiler.find_library_file.<locals>.<genexpr>z dylib xcode_stub shared staticN) r� �mapr� � itertools�starmapr r rw �product�filter�exists�next)r? �dirsr� rl � lib_names�roots�searched�foundr r� r �find_library_file� s � zCompiler.find_library_file)NNNNN) rF rG rH rI rJ rK rL rM rN rO rP rQ )NFN) NNNNNFNNNN) rk rq rf rr r@ rM rA rM rB rM )r� rt r� r� )F) �__name__� __module__� __qualname__� compiler_type� executablesr� r� �src_extensions� obj_extension�static_lib_extension�shared_lib_extension�dylib_lib_extension�xcode_stub_lib_extension�static_lib_format�shared_lib_format�dylib_lib_format�xcode_stub_lib_format� exe_extensionr; r^ re rp r� r� r� r� r� � staticmethodr� r� � __classcell__r r rD r r& s sr � �% � �E ( "r& )!�__doc__� __future__r r� r r� r� r� �collections.abcr � r �_logr � _macos_compatr � _modifiedr �compatr �errorsr r r r r r r r r r r% r& r r r r �<module> s* _distutils/compilers/C/cygwin.py 0000644 00000027104 15030122015 0012751 0 ustar 00 """distutils.cygwinccompiler Provides the CygwinCCompiler class, a subclass of UnixCCompiler that handles the Cygwin port of the GNU C compiler to Windows. It also contains the Mingw32CCompiler class which handles the mingw32 port of GCC (same as cygwin in no-cygwin mode). """ import copy import os import pathlib import shlex import sys import warnings from subprocess import check_output from ...errors import ( DistutilsExecError, DistutilsPlatformError, ) from ...file_util import write_file from ...sysconfig import get_config_vars from ...version import LooseVersion, suppress_known_deprecation from . import unix from .errors import ( CompileError, Error, ) def get_msvcr(): """No longer needed, but kept for backward compatibility.""" return [] _runtime_library_dirs_msg = ( "Unable to set runtime library search path on Windows, " "usually indicated by `runtime_library_dirs` parameter to Extension" ) class Compiler(unix.Compiler): """Handles the Cygwin port of the GNU C compiler to Windows.""" compiler_type = 'cygwin' obj_extension = ".o" static_lib_extension = ".a" shared_lib_extension = ".dll.a" dylib_lib_extension = ".dll" static_lib_format = "lib%s%s" shared_lib_format = "lib%s%s" dylib_lib_format = "cyg%s%s" exe_extension = ".exe" def __init__(self, verbose=False, dry_run=False, force=False): super().__init__(verbose, dry_run, force) status, details = check_config_h() self.debug_print(f"Python's GCC status: {status} (details: {details})") if status is not CONFIG_H_OK: self.warn( "Python's pyconfig.h doesn't seem to support your compiler. " f"Reason: {details}. " "Compiling may fail because of undefined preprocessor macros." ) self.cc, self.cxx = get_config_vars('CC', 'CXX') # Override 'CC' and 'CXX' environment variables for # building using MINGW compiler for MSVC python. self.cc = os.environ.get('CC', self.cc or 'gcc') self.cxx = os.environ.get('CXX', self.cxx or 'g++') self.linker_dll = self.cc self.linker_dll_cxx = self.cxx shared_option = "-shared" self.set_executables( compiler=f'{self.cc} -mcygwin -O -Wall', compiler_so=f'{self.cc} -mcygwin -mdll -O -Wall', compiler_cxx=f'{self.cxx} -mcygwin -O -Wall', compiler_so_cxx=f'{self.cxx} -mcygwin -mdll -O -Wall', linker_exe=f'{self.cc} -mcygwin', linker_so=f'{self.linker_dll} -mcygwin {shared_option}', linker_exe_cxx=f'{self.cxx} -mcygwin', linker_so_cxx=f'{self.linker_dll_cxx} -mcygwin {shared_option}', ) self.dll_libraries = get_msvcr() @property def gcc_version(self): # Older numpy depended on this existing to check for ancient # gcc versions. This doesn't make much sense with clang etc so # just hardcode to something recent. # https://github.com/numpy/numpy/pull/20333 warnings.warn( "gcc_version attribute of CygwinCCompiler is deprecated. " "Instead of returning actual gcc version a fixed value 11.2.0 is returned.", DeprecationWarning, stacklevel=2, ) with suppress_known_deprecation(): return LooseVersion("11.2.0") def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): """Compiles the source by spawning GCC and windres if needed.""" if ext in ('.rc', '.res'): # gcc needs '.res' and '.rc' compiled to object files !!! try: self.spawn(["windres", "-i", src, "-o", obj]) except DistutilsExecError as msg: raise CompileError(msg) else: # for other files use the C-compiler try: if self.detect_language(src) == 'c++': self.spawn( self.compiler_so_cxx + cc_args + [src, '-o', obj] + extra_postargs ) else: self.spawn( self.compiler_so + cc_args + [src, '-o', obj] + extra_postargs ) except DistutilsExecError as msg: raise CompileError(msg) def link( self, target_desc, objects, output_filename, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=False, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None, ): """Link the objects.""" # use separate copies, so we can modify the lists extra_preargs = copy.copy(extra_preargs or []) libraries = copy.copy(libraries or []) objects = copy.copy(objects or []) if runtime_library_dirs: self.warn(_runtime_library_dirs_msg) # Additional libraries libraries.extend(self.dll_libraries) # handle export symbols by creating a def-file # with executables this only works with gcc/ld as linker if (export_symbols is not None) and ( target_desc != self.EXECUTABLE or self.linker_dll == "gcc" ): # (The linker doesn't do anything if output is up-to-date. # So it would probably better to check if we really need this, # but for this we had to insert some unchanged parts of # UnixCCompiler, and this is not what we want.) # we want to put some files in the same directory as the # object files are, build_temp doesn't help much # where are the object files temp_dir = os.path.dirname(objects[0]) # name of dll to give the helper files the same base name (dll_name, dll_extension) = os.path.splitext( os.path.basename(output_filename) ) # generate the filenames for these files def_file = os.path.join(temp_dir, dll_name + ".def") # Generate .def file contents = [f"LIBRARY {os.path.basename(output_filename)}", "EXPORTS"] contents.extend(export_symbols) self.execute(write_file, (def_file, contents), f"writing {def_file}") # next add options for def-file # for gcc/ld the def-file is specified as any object files objects.append(def_file) # end: if ((export_symbols is not None) and # (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")): # who wants symbols and a many times larger output file # should explicitly switch the debug mode on # otherwise we let ld strip the output file # (On my machine: 10KiB < stripped_file < ??100KiB # unstripped_file = stripped_file + XXX KiB # ( XXX=254 for a typical python extension)) if not debug: extra_preargs.append("-s") super().link( target_desc, objects, output_filename, output_dir, libraries, library_dirs, runtime_library_dirs, None, # export_symbols, we do this in our def-file debug, extra_preargs, extra_postargs, build_temp, target_lang, ) def runtime_library_dir_option(self, dir): # cygwin doesn't support rpath. While in theory we could error # out like MSVC does, code might expect it to work like on Unix, so # just warn and hope for the best. self.warn(_runtime_library_dirs_msg) return [] # -- Miscellaneous methods ----------------------------------------- def _make_out_path(self, output_dir, strip_dir, src_name): # use normcase to make sure '.rc' is really '.rc' and not '.RC' norm_src_name = os.path.normcase(src_name) return super()._make_out_path(output_dir, strip_dir, norm_src_name) @property def out_extensions(self): """ Add support for rc and res files. """ return { **super().out_extensions, **{ext: ext + self.obj_extension for ext in ('.res', '.rc')}, } # the same as cygwin plus some additional parameters class MinGW32Compiler(Compiler): """Handles the Mingw32 port of the GNU C compiler to Windows.""" compiler_type = 'mingw32' def __init__(self, verbose=False, dry_run=False, force=False): super().__init__(verbose, dry_run, force) shared_option = "-shared" if is_cygwincc(self.cc): raise Error('Cygwin gcc cannot be used with --compiler=mingw32') self.set_executables( compiler=f'{self.cc} -O -Wall', compiler_so=f'{self.cc} -shared -O -Wall', compiler_so_cxx=f'{self.cxx} -shared -O -Wall', compiler_cxx=f'{self.cxx} -O -Wall', linker_exe=f'{self.cc}', linker_so=f'{self.linker_dll} {shared_option}', linker_exe_cxx=f'{self.cxx}', linker_so_cxx=f'{self.linker_dll_cxx} {shared_option}', ) def runtime_library_dir_option(self, dir): raise DistutilsPlatformError(_runtime_library_dirs_msg) # Because these compilers aren't configured in Python's pyconfig.h file by # default, we should at least warn the user if he is using an unmodified # version. CONFIG_H_OK = "ok" CONFIG_H_NOTOK = "not ok" CONFIG_H_UNCERTAIN = "uncertain" def check_config_h(): """Check if the current Python installation appears amenable to building extensions with GCC. Returns a tuple (status, details), where 'status' is one of the following constants: - CONFIG_H_OK: all is well, go ahead and compile - CONFIG_H_NOTOK: doesn't look good - CONFIG_H_UNCERTAIN: not sure -- unable to read pyconfig.h 'details' is a human-readable string explaining the situation. Note there are two ways to conclude "OK": either 'sys.version' contains the string "GCC" (implying that this Python was built with GCC), or the installed "pyconfig.h" contains the string "__GNUC__". """ # XXX since this function also checks sys.version, it's not strictly a # "pyconfig.h" check -- should probably be renamed... from distutils import sysconfig # if sys.version contains GCC then python was compiled with GCC, and the # pyconfig.h file should be OK if "GCC" in sys.version: return CONFIG_H_OK, "sys.version mentions 'GCC'" # Clang would also work if "Clang" in sys.version: return CONFIG_H_OK, "sys.version mentions 'Clang'" # let's see if __GNUC__ is mentioned in python.h fn = sysconfig.get_config_h_filename() try: config_h = pathlib.Path(fn).read_text(encoding='utf-8') except OSError as exc: return (CONFIG_H_UNCERTAIN, f"couldn't read '{fn}': {exc.strerror}") else: substring = '__GNUC__' if substring in config_h: code = CONFIG_H_OK mention_inflected = 'mentions' else: code = CONFIG_H_NOTOK mention_inflected = 'does not mention' return code, f"{fn!r} {mention_inflected} {substring!r}" def is_cygwincc(cc): """Try to determine if the compiler that would be used is from cygwin.""" out_string = check_output(shlex.split(cc) + ['-dumpmachine']) return out_string.strip().endswith(b'cygwin') get_versions = None """ A stand-in for the previous get_versions() function to prevent failures when monkeypatched. See pypa/setuptools#2969. """ _distutils/compilers/C/msvc.py 0000644 00000051634 15030122015 0012426 0 ustar 00 """distutils._msvccompiler Contains MSVCCompiler, an implementation of the abstract CCompiler class for Microsoft Visual Studio 2015. This module requires VS 2015 or later. """ # Written by Perry Stoll # hacked by Robin Becker and Thomas Heller to do a better job of # finding DevStudio (through the registry) # ported to VS 2005 and VS 2008 by Christian Heimes # ported to VS 2015 by Steve Dower from __future__ import annotations import contextlib import os import subprocess import unittest.mock as mock import warnings from collections.abc import Iterable with contextlib.suppress(ImportError): import winreg from itertools import count from ..._log import log from ...errors import ( DistutilsExecError, DistutilsPlatformError, ) from ...util import get_host_platform, get_platform from . import base from .base import gen_lib_options from .errors import ( CompileError, LibError, LinkError, ) def _find_vc2015(): try: key = winreg.OpenKeyEx( winreg.HKEY_LOCAL_MACHINE, r"Software\Microsoft\VisualStudio\SxS\VC7", access=winreg.KEY_READ | winreg.KEY_WOW64_32KEY, ) except OSError: log.debug("Visual C++ is not registered") return None, None best_version = 0 best_dir = None with key: for i in count(): try: v, vc_dir, vt = winreg.EnumValue(key, i) except OSError: break if v and vt == winreg.REG_SZ and os.path.isdir(vc_dir): try: version = int(float(v)) except (ValueError, TypeError): continue if version >= 14 and version > best_version: best_version, best_dir = version, vc_dir return best_version, best_dir def _find_vc2017(): """Returns "15, path" based on the result of invoking vswhere.exe If no install is found, returns "None, None" The version is returned to avoid unnecessarily changing the function result. It may be ignored when the path is not None. If vswhere.exe is not available, by definition, VS 2017 is not installed. """ root = os.environ.get("ProgramFiles(x86)") or os.environ.get("ProgramFiles") if not root: return None, None variant = 'arm64' if get_platform() == 'win-arm64' else 'x86.x64' suitable_components = ( f"Microsoft.VisualStudio.Component.VC.Tools.{variant}", "Microsoft.VisualStudio.Workload.WDExpress", ) for component in suitable_components: # Workaround for `-requiresAny` (only available on VS 2017 > 15.6) with contextlib.suppress( subprocess.CalledProcessError, OSError, UnicodeDecodeError ): path = ( subprocess.check_output([ os.path.join( root, "Microsoft Visual Studio", "Installer", "vswhere.exe" ), "-latest", "-prerelease", "-requires", component, "-property", "installationPath", "-products", "*", ]) .decode(encoding="mbcs", errors="strict") .strip() ) path = os.path.join(path, "VC", "Auxiliary", "Build") if os.path.isdir(path): return 15, path return None, None # no suitable component found PLAT_SPEC_TO_RUNTIME = { 'x86': 'x86', 'x86_amd64': 'x64', 'x86_arm': 'arm', 'x86_arm64': 'arm64', } def _find_vcvarsall(plat_spec): # bpo-38597: Removed vcruntime return value _, best_dir = _find_vc2017() if not best_dir: best_version, best_dir = _find_vc2015() if not best_dir: log.debug("No suitable Visual C++ version found") return None, None vcvarsall = os.path.join(best_dir, "vcvarsall.bat") if not os.path.isfile(vcvarsall): log.debug("%s cannot be found", vcvarsall) return None, None return vcvarsall, None def _get_vc_env(plat_spec): if os.getenv("DISTUTILS_USE_SDK"): return {key.lower(): value for key, value in os.environ.items()} vcvarsall, _ = _find_vcvarsall(plat_spec) if not vcvarsall: raise DistutilsPlatformError( 'Microsoft Visual C++ 14.0 or greater is required. ' 'Get it with "Microsoft C++ Build Tools": ' 'https://visualstudio.microsoft.com/visual-cpp-build-tools/' ) try: out = subprocess.check_output( f'cmd /u /c "{vcvarsall}" {plat_spec} && set', stderr=subprocess.STDOUT, ).decode('utf-16le', errors='replace') except subprocess.CalledProcessError as exc: log.error(exc.output) raise DistutilsPlatformError(f"Error executing {exc.cmd}") env = { key.lower(): value for key, _, value in (line.partition('=') for line in out.splitlines()) if key and value } return env def _find_exe(exe, paths=None): """Return path to an MSVC executable program. Tries to find the program in several places: first, one of the MSVC program search paths from the registry; next, the directories in the PATH environment variable. If any of those work, return an absolute path that is known to exist. If none of them work, just return the original program name, 'exe'. """ if not paths: paths = os.getenv('path').split(os.pathsep) for p in paths: fn = os.path.join(os.path.abspath(p), exe) if os.path.isfile(fn): return fn return exe _vcvars_names = { 'win32': 'x86', 'win-amd64': 'amd64', 'win-arm32': 'arm', 'win-arm64': 'arm64', } def _get_vcvars_spec(host_platform, platform): """ Given a host platform and platform, determine the spec for vcvarsall. Uses the native MSVC host if the host platform would need expensive emulation for x86. >>> _get_vcvars_spec('win-arm64', 'win32') 'arm64_x86' >>> _get_vcvars_spec('win-arm64', 'win-amd64') 'arm64_amd64' Otherwise, always cross-compile from x86 to work with the lighter-weight MSVC installs that do not include native 64-bit tools. >>> _get_vcvars_spec('win32', 'win32') 'x86' >>> _get_vcvars_spec('win-arm32', 'win-arm32') 'x86_arm' >>> _get_vcvars_spec('win-amd64', 'win-arm64') 'x86_arm64' """ if host_platform != 'win-arm64': host_platform = 'win32' vc_hp = _vcvars_names[host_platform] vc_plat = _vcvars_names[platform] return vc_hp if vc_hp == vc_plat else f'{vc_hp}_{vc_plat}' class Compiler(base.Compiler): """Concrete class that implements an interface to Microsoft Visual C++, as defined by the CCompiler abstract class.""" compiler_type = 'msvc' # Just set this so CCompiler's constructor doesn't barf. We currently # don't use the 'set_executables()' bureaucracy provided by CCompiler, # as it really isn't necessary for this sort of single-compiler class. # Would be nice to have a consistent interface with UnixCCompiler, # though, so it's worth thinking about. executables = {} # Private class data (need to distinguish C from C++ source for compiler) _c_extensions = ['.c'] _cpp_extensions = ['.cc', '.cpp', '.cxx'] _rc_extensions = ['.rc'] _mc_extensions = ['.mc'] # Needed for the filename generation methods provided by the # base class, CCompiler. src_extensions = _c_extensions + _cpp_extensions + _rc_extensions + _mc_extensions res_extension = '.res' obj_extension = '.obj' static_lib_extension = '.lib' shared_lib_extension = '.dll' static_lib_format = shared_lib_format = '%s%s' exe_extension = '.exe' def __init__(self, verbose=False, dry_run=False, force=False) -> None: super().__init__(verbose, dry_run, force) # target platform (.plat_name is consistent with 'bdist') self.plat_name = None self.initialized = False @classmethod def _configure(cls, vc_env): """ Set class-level include/lib dirs. """ cls.include_dirs = cls._parse_path(vc_env.get('include', '')) cls.library_dirs = cls._parse_path(vc_env.get('lib', '')) @staticmethod def _parse_path(val): return [dir.rstrip(os.sep) for dir in val.split(os.pathsep) if dir] def initialize(self, plat_name: str | None = None) -> None: # multi-init means we would need to check platform same each time... assert not self.initialized, "don't init multiple times" if plat_name is None: plat_name = get_platform() # sanity check for platforms to prevent obscure errors later. if plat_name not in _vcvars_names: raise DistutilsPlatformError( f"--plat-name must be one of {tuple(_vcvars_names)}" ) plat_spec = _get_vcvars_spec(get_host_platform(), plat_name) vc_env = _get_vc_env(plat_spec) if not vc_env: raise DistutilsPlatformError( "Unable to find a compatible Visual Studio installation." ) self._configure(vc_env) self._paths = vc_env.get('path', '') paths = self._paths.split(os.pathsep) self.cc = _find_exe("cl.exe", paths) self.linker = _find_exe("link.exe", paths) self.lib = _find_exe("lib.exe", paths) self.rc = _find_exe("rc.exe", paths) # resource compiler self.mc = _find_exe("mc.exe", paths) # message compiler self.mt = _find_exe("mt.exe", paths) # message compiler self.preprocess_options = None # bpo-38597: Always compile with dynamic linking # Future releases of Python 3.x will include all past # versions of vcruntime*.dll for compatibility. self.compile_options = ['/nologo', '/O2', '/W3', '/GL', '/DNDEBUG', '/MD'] self.compile_options_debug = [ '/nologo', '/Od', '/MDd', '/Zi', '/W3', '/D_DEBUG', ] ldflags = ['/nologo', '/INCREMENTAL:NO', '/LTCG'] ldflags_debug = ['/nologo', '/INCREMENTAL:NO', '/LTCG', '/DEBUG:FULL'] self.ldflags_exe = [*ldflags, '/MANIFEST:EMBED,ID=1'] self.ldflags_exe_debug = [*ldflags_debug, '/MANIFEST:EMBED,ID=1'] self.ldflags_shared = [ *ldflags, '/DLL', '/MANIFEST:EMBED,ID=2', '/MANIFESTUAC:NO', ] self.ldflags_shared_debug = [ *ldflags_debug, '/DLL', '/MANIFEST:EMBED,ID=2', '/MANIFESTUAC:NO', ] self.ldflags_static = [*ldflags] self.ldflags_static_debug = [*ldflags_debug] self._ldflags = { (base.Compiler.EXECUTABLE, None): self.ldflags_exe, (base.Compiler.EXECUTABLE, False): self.ldflags_exe, (base.Compiler.EXECUTABLE, True): self.ldflags_exe_debug, (base.Compiler.SHARED_OBJECT, None): self.ldflags_shared, (base.Compiler.SHARED_OBJECT, False): self.ldflags_shared, (base.Compiler.SHARED_OBJECT, True): self.ldflags_shared_debug, (base.Compiler.SHARED_LIBRARY, None): self.ldflags_static, (base.Compiler.SHARED_LIBRARY, False): self.ldflags_static, (base.Compiler.SHARED_LIBRARY, True): self.ldflags_static_debug, } self.initialized = True # -- Worker methods ------------------------------------------------ @property def out_extensions(self) -> dict[str, str]: return { **super().out_extensions, **{ ext: self.res_extension for ext in self._rc_extensions + self._mc_extensions }, } def compile( # noqa: C901 self, sources, output_dir=None, macros=None, include_dirs=None, debug=False, extra_preargs=None, extra_postargs=None, depends=None, ): if not self.initialized: self.initialize() compile_info = self._setup_compile( output_dir, macros, include_dirs, sources, depends, extra_postargs ) macros, objects, extra_postargs, pp_opts, build = compile_info compile_opts = extra_preargs or [] compile_opts.append('/c') if debug: compile_opts.extend(self.compile_options_debug) else: compile_opts.extend(self.compile_options) add_cpp_opts = False for obj in objects: try: src, ext = build[obj] except KeyError: continue if debug: # pass the full pathname to MSVC in debug mode, # this allows the debugger to find the source file # without asking the user to browse for it src = os.path.abspath(src) if ext in self._c_extensions: input_opt = f"/Tc{src}" elif ext in self._cpp_extensions: input_opt = f"/Tp{src}" add_cpp_opts = True elif ext in self._rc_extensions: # compile .RC to .RES file input_opt = src output_opt = "/fo" + obj try: self.spawn([self.rc] + pp_opts + [output_opt, input_opt]) except DistutilsExecError as msg: raise CompileError(msg) continue elif ext in self._mc_extensions: # Compile .MC to .RC file to .RES file. # * '-h dir' specifies the directory for the # generated include file # * '-r dir' specifies the target directory of the # generated RC file and the binary message resource # it includes # # For now (since there are no options to change this), # we use the source-directory for the include file and # the build directory for the RC file and message # resources. This works at least for win32all. h_dir = os.path.dirname(src) rc_dir = os.path.dirname(obj) try: # first compile .MC to .RC and .H file self.spawn([self.mc, '-h', h_dir, '-r', rc_dir, src]) base, _ = os.path.splitext(os.path.basename(src)) rc_file = os.path.join(rc_dir, base + '.rc') # then compile .RC to .RES file self.spawn([self.rc, "/fo" + obj, rc_file]) except DistutilsExecError as msg: raise CompileError(msg) continue else: # how to handle this file? raise CompileError(f"Don't know how to compile {src} to {obj}") args = [self.cc] + compile_opts + pp_opts if add_cpp_opts: args.append('/EHsc') args.extend((input_opt, "/Fo" + obj)) args.extend(extra_postargs) try: self.spawn(args) except DistutilsExecError as msg: raise CompileError(msg) return objects def create_static_lib( self, objects: list[str] | tuple[str, ...], output_libname: str, output_dir: str | None = None, debug: bool = False, target_lang: str | None = None, ) -> None: if not self.initialized: self.initialize() objects, output_dir = self._fix_object_args(objects, output_dir) output_filename = self.library_filename(output_libname, output_dir=output_dir) if self._need_link(objects, output_filename): lib_args = objects + ['/OUT:' + output_filename] if debug: pass # XXX what goes here? try: log.debug('Executing "%s" %s', self.lib, ' '.join(lib_args)) self.spawn([self.lib] + lib_args) except DistutilsExecError as msg: raise LibError(msg) else: log.debug("skipping %s (up-to-date)", output_filename) def link( self, target_desc: str, objects: list[str] | tuple[str, ...], output_filename: str, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, export_symbols: Iterable[str] | None = None, debug: bool = False, extra_preargs: list[str] | None = None, extra_postargs: Iterable[str] | None = None, build_temp: str | os.PathLike[str] | None = None, target_lang: str | None = None, ) -> None: if not self.initialized: self.initialize() objects, output_dir = self._fix_object_args(objects, output_dir) fixed_args = self._fix_lib_args(libraries, library_dirs, runtime_library_dirs) libraries, library_dirs, runtime_library_dirs = fixed_args if runtime_library_dirs: self.warn( "I don't know what to do with 'runtime_library_dirs': " + str(runtime_library_dirs) ) lib_opts = gen_lib_options(self, library_dirs, runtime_library_dirs, libraries) if output_dir is not None: output_filename = os.path.join(output_dir, output_filename) if self._need_link(objects, output_filename): ldflags = self._ldflags[target_desc, debug] export_opts = ["/EXPORT:" + sym for sym in (export_symbols or [])] ld_args = ( ldflags + lib_opts + export_opts + objects + ['/OUT:' + output_filename] ) # The MSVC linker generates .lib and .exp files, which cannot be # suppressed by any linker switches. The .lib files may even be # needed! Make sure they are generated in the temporary build # directory. Since they have different names for debug and release # builds, they can go into the same directory. build_temp = os.path.dirname(objects[0]) if export_symbols is not None: (dll_name, dll_ext) = os.path.splitext( os.path.basename(output_filename) ) implib_file = os.path.join(build_temp, self.library_filename(dll_name)) ld_args.append('/IMPLIB:' + implib_file) if extra_preargs: ld_args[:0] = extra_preargs if extra_postargs: ld_args.extend(extra_postargs) output_dir = os.path.dirname(os.path.abspath(output_filename)) self.mkpath(output_dir) try: log.debug('Executing "%s" %s', self.linker, ' '.join(ld_args)) self.spawn([self.linker] + ld_args) except DistutilsExecError as msg: raise LinkError(msg) else: log.debug("skipping %s (up-to-date)", output_filename) def spawn(self, cmd): env = dict(os.environ, PATH=self._paths) with self._fallback_spawn(cmd, env) as fallback: return super().spawn(cmd, env=env) return fallback.value @contextlib.contextmanager def _fallback_spawn(self, cmd, env): """ Discovered in pypa/distutils#15, some tools monkeypatch the compiler, so the 'env' kwarg causes a TypeError. Detect this condition and restore the legacy, unsafe behavior. """ bag = type('Bag', (), {})() try: yield bag except TypeError as exc: if "unexpected keyword argument 'env'" not in str(exc): raise else: return warnings.warn("Fallback spawn triggered. Please update distutils monkeypatch.") with mock.patch.dict('os.environ', env): bag.value = super().spawn(cmd) # -- Miscellaneous methods ----------------------------------------- # These are all used by the 'gen_lib_options() function, in # ccompiler.py. def library_dir_option(self, dir): return "/LIBPATH:" + dir def runtime_library_dir_option(self, dir): raise DistutilsPlatformError( "don't know how to set runtime library search path for MSVC" ) def library_option(self, lib): return self.library_filename(lib) def find_library_file(self, dirs, lib, debug=False): # Prefer a debugging library if found (and requested), but deal # with it if we don't have one. if debug: try_names = [lib + "_d", lib] else: try_names = [lib] for dir in dirs: for name in try_names: libfile = os.path.join(dir, self.library_filename(name)) if os.path.isfile(libfile): return libfile else: # Oops, didn't find it in *any* of 'dirs' return None _distutils/compilers/C/unix.py 0000644 00000040166 15030122015 0012437 0 ustar 00 """distutils.unixccompiler Contains the UnixCCompiler class, a subclass of CCompiler that handles the "typical" Unix-style command-line C compiler: * macros defined with -Dname[=value] * macros undefined with -Uname * include search directories specified with -Idir * libraries specified with -lllib * library search directories specified with -Ldir * compile handled by 'cc' (or similar) executable with -c option: compiles .c to .o * link static library handled by 'ar' command (possibly with 'ranlib') * link shared library handled by 'cc -shared' """ from __future__ import annotations import itertools import os import re import shlex import sys from collections.abc import Iterable from ... import sysconfig from ..._log import log from ..._macos_compat import compiler_fixup from ..._modified import newer from ...compat import consolidate_linker_args from ...errors import DistutilsExecError from . import base from .base import _Macro, gen_lib_options, gen_preprocess_options from .errors import ( CompileError, LibError, LinkError, ) # XXX Things not currently handled: # * optimization/debug/warning flags; we just use whatever's in Python's # Makefile and live with it. Is this adequate? If not, we might # have to have a bunch of subclasses GNUCCompiler, SGICCompiler, # SunCCompiler, and I suspect down that road lies madness. # * even if we don't know a warning flag from an optimization flag, # we need some way for outsiders to feed preprocessor/compiler/linker # flags in to us -- eg. a sysadmin might want to mandate certain flags # via a site config file, or a user might want to set something for # compiling this module distribution only via the setup.py command # line, whatever. As long as these options come from something on the # current system, they can be as system-dependent as they like, and we # should just happily stuff them into the preprocessor/compiler/linker # options and carry on. def _split_env(cmd): """ For macOS, split command into 'env' portion (if any) and the rest of the linker command. >>> _split_env(['a', 'b', 'c']) ([], ['a', 'b', 'c']) >>> _split_env(['/usr/bin/env', 'A=3', 'gcc']) (['/usr/bin/env', 'A=3'], ['gcc']) """ pivot = 0 if os.path.basename(cmd[0]) == "env": pivot = 1 while '=' in cmd[pivot]: pivot += 1 return cmd[:pivot], cmd[pivot:] def _split_aix(cmd): """ AIX platforms prefix the compiler with the ld_so_aix script, so split that from the linker command. >>> _split_aix(['a', 'b', 'c']) ([], ['a', 'b', 'c']) >>> _split_aix(['/bin/foo/ld_so_aix', 'gcc']) (['/bin/foo/ld_so_aix'], ['gcc']) """ pivot = os.path.basename(cmd[0]) == 'ld_so_aix' return cmd[:pivot], cmd[pivot:] def _linker_params(linker_cmd, compiler_cmd): """ The linker command usually begins with the compiler command (possibly multiple elements), followed by zero or more params for shared library building. If the LDSHARED env variable overrides the linker command, however, the commands may not match. Return the best guess of the linker parameters by stripping the linker command. If the compiler command does not match the linker command, assume the linker command is just the first element. >>> _linker_params('gcc foo bar'.split(), ['gcc']) ['foo', 'bar'] >>> _linker_params('gcc foo bar'.split(), ['other']) ['foo', 'bar'] >>> _linker_params('ccache gcc foo bar'.split(), 'ccache gcc'.split()) ['foo', 'bar'] >>> _linker_params(['gcc'], ['gcc']) [] """ c_len = len(compiler_cmd) pivot = c_len if linker_cmd[:c_len] == compiler_cmd else 1 return linker_cmd[pivot:] class Compiler(base.Compiler): compiler_type = 'unix' # These are used by CCompiler in two places: the constructor sets # instance attributes 'preprocessor', 'compiler', etc. from them, and # 'set_executable()' allows any of these to be set. The defaults here # are pretty generic; they will probably have to be set by an outsider # (eg. using information discovered by the sysconfig about building # Python extensions). executables = { 'preprocessor': None, 'compiler': ["cc"], 'compiler_so': ["cc"], 'compiler_cxx': ["c++"], 'compiler_so_cxx': ["c++"], 'linker_so': ["cc", "-shared"], 'linker_so_cxx': ["c++", "-shared"], 'linker_exe': ["cc"], 'linker_exe_cxx': ["c++", "-shared"], 'archiver': ["ar", "-cr"], 'ranlib': None, } if sys.platform[:6] == "darwin": executables['ranlib'] = ["ranlib"] # Needed for the filename generation methods provided by the base # class, CCompiler. NB. whoever instantiates/uses a particular # UnixCCompiler instance should set 'shared_lib_ext' -- we set a # reasonable common default here, but it's not necessarily used on all # Unices! src_extensions = [".c", ".C", ".cc", ".cxx", ".cpp", ".m"] obj_extension = ".o" static_lib_extension = ".a" shared_lib_extension = ".so" dylib_lib_extension = ".dylib" xcode_stub_lib_extension = ".tbd" static_lib_format = shared_lib_format = dylib_lib_format = "lib%s%s" xcode_stub_lib_format = dylib_lib_format if sys.platform == "cygwin": exe_extension = ".exe" shared_lib_extension = ".dll.a" dylib_lib_extension = ".dll" dylib_lib_format = "cyg%s%s" def _fix_lib_args(self, libraries, library_dirs, runtime_library_dirs): """Remove standard library path from rpath""" libraries, library_dirs, runtime_library_dirs = super()._fix_lib_args( libraries, library_dirs, runtime_library_dirs ) libdir = sysconfig.get_config_var('LIBDIR') if ( runtime_library_dirs and libdir.startswith("/usr/lib") and (libdir in runtime_library_dirs) ): runtime_library_dirs.remove(libdir) return libraries, library_dirs, runtime_library_dirs def preprocess( self, source: str | os.PathLike[str], output_file: str | os.PathLike[str] | None = None, macros: list[_Macro] | None = None, include_dirs: list[str] | tuple[str, ...] | None = None, extra_preargs: list[str] | None = None, extra_postargs: Iterable[str] | None = None, ): fixed_args = self._fix_compile_args(None, macros, include_dirs) ignore, macros, include_dirs = fixed_args pp_opts = gen_preprocess_options(macros, include_dirs) pp_args = self.preprocessor + pp_opts if output_file: pp_args.extend(['-o', output_file]) if extra_preargs: pp_args[:0] = extra_preargs if extra_postargs: pp_args.extend(extra_postargs) pp_args.append(source) # reasons to preprocess: # - force is indicated # - output is directed to stdout # - source file is newer than the target preprocess = self.force or output_file is None or newer(source, output_file) if not preprocess: return if output_file: self.mkpath(os.path.dirname(output_file)) try: self.spawn(pp_args) except DistutilsExecError as msg: raise CompileError(msg) def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): compiler_so = compiler_fixup(self.compiler_so, cc_args + extra_postargs) compiler_so_cxx = compiler_fixup(self.compiler_so_cxx, cc_args + extra_postargs) try: if self.detect_language(src) == 'c++': self.spawn( compiler_so_cxx + cc_args + [src, '-o', obj] + extra_postargs ) else: self.spawn(compiler_so + cc_args + [src, '-o', obj] + extra_postargs) except DistutilsExecError as msg: raise CompileError(msg) def create_static_lib( self, objects, output_libname, output_dir=None, debug=False, target_lang=None ): objects, output_dir = self._fix_object_args(objects, output_dir) output_filename = self.library_filename(output_libname, output_dir=output_dir) if self._need_link(objects, output_filename): self.mkpath(os.path.dirname(output_filename)) self.spawn(self.archiver + [output_filename] + objects + self.objects) # Not many Unices required ranlib anymore -- SunOS 4.x is, I # think the only major Unix that does. Maybe we need some # platform intelligence here to skip ranlib if it's not # needed -- or maybe Python's configure script took care of # it for us, hence the check for leading colon. if self.ranlib: try: self.spawn(self.ranlib + [output_filename]) except DistutilsExecError as msg: raise LibError(msg) else: log.debug("skipping %s (up-to-date)", output_filename) def link( self, target_desc, objects: list[str] | tuple[str, ...], output_filename, output_dir: str | None = None, libraries: list[str] | tuple[str, ...] | None = None, library_dirs: list[str] | tuple[str, ...] | None = None, runtime_library_dirs: list[str] | tuple[str, ...] | None = None, export_symbols=None, debug=False, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None, ): objects, output_dir = self._fix_object_args(objects, output_dir) fixed_args = self._fix_lib_args(libraries, library_dirs, runtime_library_dirs) libraries, library_dirs, runtime_library_dirs = fixed_args lib_opts = gen_lib_options(self, library_dirs, runtime_library_dirs, libraries) if not isinstance(output_dir, (str, type(None))): raise TypeError("'output_dir' must be a string or None") if output_dir is not None: output_filename = os.path.join(output_dir, output_filename) if self._need_link(objects, output_filename): ld_args = objects + self.objects + lib_opts + ['-o', output_filename] if debug: ld_args[:0] = ['-g'] if extra_preargs: ld_args[:0] = extra_preargs if extra_postargs: ld_args.extend(extra_postargs) self.mkpath(os.path.dirname(output_filename)) try: # Select a linker based on context: linker_exe when # building an executable or linker_so (with shared options) # when building a shared library. building_exe = target_desc == base.Compiler.EXECUTABLE linker = ( self.linker_exe if building_exe else ( self.linker_so_cxx if target_lang == "c++" else self.linker_so ) )[:] if target_lang == "c++" and self.compiler_cxx: env, linker_ne = _split_env(linker) aix, linker_na = _split_aix(linker_ne) _, compiler_cxx_ne = _split_env(self.compiler_cxx) _, linker_exe_ne = _split_env(self.linker_exe) params = _linker_params(linker_na, linker_exe_ne) linker = env + aix + compiler_cxx_ne + params linker = compiler_fixup(linker, ld_args) self.spawn(linker + ld_args) except DistutilsExecError as msg: raise LinkError(msg) else: log.debug("skipping %s (up-to-date)", output_filename) # -- Miscellaneous methods ----------------------------------------- # These are all used by the 'gen_lib_options() function, in # ccompiler.py. def library_dir_option(self, dir): return "-L" + dir def _is_gcc(self): cc_var = sysconfig.get_config_var("CC") compiler = os.path.basename(shlex.split(cc_var)[0]) return "gcc" in compiler or "g++" in compiler def runtime_library_dir_option(self, dir: str) -> str | list[str]: # type: ignore[override] # Fixed in pypa/distutils#339 # XXX Hackish, at the very least. See Python bug #445902: # https://bugs.python.org/issue445902 # Linkers on different platforms need different options to # specify that directories need to be added to the list of # directories searched for dependencies when a dynamic library # is sought. GCC on GNU systems (Linux, FreeBSD, ...) has to # be told to pass the -R option through to the linker, whereas # other compilers and gcc on other systems just know this. # Other compilers may need something slightly different. At # this time, there's no way to determine this information from # the configuration data stored in the Python installation, so # we use this hack. if sys.platform[:6] == "darwin": from distutils.util import get_macosx_target_ver, split_version macosx_target_ver = get_macosx_target_ver() if macosx_target_ver and split_version(macosx_target_ver) >= [10, 5]: return "-Wl,-rpath," + dir else: # no support for -rpath on earlier macOS versions return "-L" + dir elif sys.platform[:7] == "freebsd": return "-Wl,-rpath=" + dir elif sys.platform[:5] == "hp-ux": return [ "-Wl,+s" if self._is_gcc() else "+s", "-L" + dir, ] # For all compilers, `-Wl` is the presumed way to pass a # compiler option to the linker if sysconfig.get_config_var("GNULD") == "yes": return consolidate_linker_args([ # Force RUNPATH instead of RPATH "-Wl,--enable-new-dtags", "-Wl,-rpath," + dir, ]) else: return "-Wl,-R" + dir def library_option(self, lib): return "-l" + lib @staticmethod def _library_root(dir): """ macOS users can specify an alternate SDK using'-isysroot'. Calculate the SDK root if it is specified. Note that, as of Xcode 7, Apple SDKs may contain textual stub libraries with .tbd extensions rather than the normal .dylib shared libraries installed in /. The Apple compiler tool chain handles this transparently but it can cause problems for programs that are being built with an SDK and searching for specific libraries. Callers of find_library_file need to keep in mind that the base filename of the returned SDK library file might have a different extension from that of the library file installed on the running system, for example: /Applications/Xcode.app/Contents/Developer/Platforms/ MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/ usr/lib/libedit.tbd vs /usr/lib/libedit.dylib """ cflags = sysconfig.get_config_var('CFLAGS') match = re.search(r'-isysroot\s*(\S+)', cflags) apply_root = ( sys.platform == 'darwin' and match and ( dir.startswith('/System/') or (dir.startswith('/usr/') and not dir.startswith('/usr/local/')) ) ) return os.path.join(match.group(1), dir[1:]) if apply_root else dir def find_library_file(self, dirs, lib, debug=False): """ Second-guess the linker with not much hard data to go on: GCC seems to prefer the shared library, so assume that *all* Unix C compilers do, ignoring even GCC's "-static" option. """ lib_names = ( self.library_filename(lib, lib_type=type) for type in 'dylib xcode_stub shared static'.split() ) roots = map(self._library_root, dirs) searched = itertools.starmap(os.path.join, itertools.product(roots, lib_names)) found = filter(os.path.exists, searched) # Return None if it could not be found in any dir. return next(found, None) _distutils/compilers/C/zos.py 0000644 00000014672 15030122015 0012272 0 ustar 00 """distutils.zosccompiler Contains the selection of the c & c++ compilers on z/OS. There are several different c compilers on z/OS, all of them are optional, so the correct one needs to be chosen based on the users input. This is compatible with the following compilers: IBM C/C++ For Open Enterprise Languages on z/OS 2.0 IBM Open XL C/C++ 1.1 for z/OS IBM XL C/C++ V2.4.1 for z/OS 2.4 and 2.5 IBM z/OS XL C/C++ """ import os from ... import sysconfig from ...errors import DistutilsExecError from . import unix from .errors import CompileError _cc_args = { 'ibm-openxl': [ '-m64', '-fvisibility=default', '-fzos-le-char-mode=ascii', '-fno-short-enums', ], 'ibm-xlclang': [ '-q64', '-qexportall', '-qascii', '-qstrict', '-qnocsect', '-Wa,asa,goff', '-Wa,xplink', '-qgonumber', '-qenum=int', '-Wc,DLL', ], 'ibm-xlc': [ '-q64', '-qexportall', '-qascii', '-qstrict', '-qnocsect', '-Wa,asa,goff', '-Wa,xplink', '-qgonumber', '-qenum=int', '-Wc,DLL', '-qlanglvl=extc99', ], } _cxx_args = { 'ibm-openxl': [ '-m64', '-fvisibility=default', '-fzos-le-char-mode=ascii', '-fno-short-enums', ], 'ibm-xlclang': [ '-q64', '-qexportall', '-qascii', '-qstrict', '-qnocsect', '-Wa,asa,goff', '-Wa,xplink', '-qgonumber', '-qenum=int', '-Wc,DLL', ], 'ibm-xlc': [ '-q64', '-qexportall', '-qascii', '-qstrict', '-qnocsect', '-Wa,asa,goff', '-Wa,xplink', '-qgonumber', '-qenum=int', '-Wc,DLL', '-qlanglvl=extended0x', ], } _asm_args = { 'ibm-openxl': ['-fasm', '-fno-integrated-as', '-Wa,--ASA', '-Wa,--GOFF'], 'ibm-xlclang': [], 'ibm-xlc': [], } _ld_args = { 'ibm-openxl': [], 'ibm-xlclang': ['-Wl,dll', '-q64'], 'ibm-xlc': ['-Wl,dll', '-q64'], } # Python on z/OS is built with no compiler specific options in it's CFLAGS. # But each compiler requires it's own specific options to build successfully, # though some of the options are common between them class Compiler(unix.Compiler): src_extensions = ['.c', '.C', '.cc', '.cxx', '.cpp', '.m', '.s'] _cpp_extensions = ['.cc', '.cpp', '.cxx', '.C'] _asm_extensions = ['.s'] def _get_zos_compiler_name(self): zos_compiler_names = [ os.path.basename(binary) for envvar in ('CC', 'CXX', 'LDSHARED') if (binary := os.environ.get(envvar, None)) ] if len(zos_compiler_names) == 0: return 'ibm-openxl' zos_compilers = {} for compiler in ( 'ibm-clang', 'ibm-clang64', 'ibm-clang++', 'ibm-clang++64', 'clang', 'clang++', 'clang-14', ): zos_compilers[compiler] = 'ibm-openxl' for compiler in ('xlclang', 'xlclang++', 'njsc', 'njsc++'): zos_compilers[compiler] = 'ibm-xlclang' for compiler in ('xlc', 'xlC', 'xlc++'): zos_compilers[compiler] = 'ibm-xlc' return zos_compilers.get(zos_compiler_names[0], 'ibm-openxl') def __init__(self, verbose=False, dry_run=False, force=False): super().__init__(verbose, dry_run, force) self.zos_compiler = self._get_zos_compiler_name() sysconfig.customize_compiler(self) def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): local_args = [] if ext in self._cpp_extensions: compiler = self.compiler_cxx local_args.extend(_cxx_args[self.zos_compiler]) elif ext in self._asm_extensions: compiler = self.compiler_so local_args.extend(_cc_args[self.zos_compiler]) local_args.extend(_asm_args[self.zos_compiler]) else: compiler = self.compiler_so local_args.extend(_cc_args[self.zos_compiler]) local_args.extend(cc_args) try: self.spawn(compiler + local_args + [src, '-o', obj] + extra_postargs) except DistutilsExecError as msg: raise CompileError(msg) def runtime_library_dir_option(self, dir): return '-L' + dir def link( self, target_desc, objects, output_filename, output_dir=None, libraries=None, library_dirs=None, runtime_library_dirs=None, export_symbols=None, debug=False, extra_preargs=None, extra_postargs=None, build_temp=None, target_lang=None, ): # For a built module to use functions from cpython, it needs to use Pythons # side deck file. The side deck is located beside the libpython3.xx.so ldversion = sysconfig.get_config_var('LDVERSION') if sysconfig.python_build: side_deck_path = os.path.join( sysconfig.get_config_var('abs_builddir'), f'libpython{ldversion}.x', ) else: side_deck_path = os.path.join( sysconfig.get_config_var('installed_base'), sysconfig.get_config_var('platlibdir'), f'libpython{ldversion}.x', ) if os.path.exists(side_deck_path): if extra_postargs: extra_postargs.append(side_deck_path) else: extra_postargs = [side_deck_path] # Check and replace libraries included side deck files if runtime_library_dirs: for dir in runtime_library_dirs: for library in libraries[:]: library_side_deck = os.path.join(dir, f'{library}.x') if os.path.exists(library_side_deck): libraries.remove(library) extra_postargs.append(library_side_deck) break # Any required ld args for the given compiler extra_postargs.extend(_ld_args[self.zos_compiler]) super().link( target_desc, objects, output_filename, output_dir, libraries, library_dirs, runtime_library_dirs, export_symbols, debug, extra_preargs, extra_postargs, build_temp, target_lang, ) _distutils/compilers/C/errors.py 0000644 00000001075 15030122015 0012764 0 ustar 00 class Error(Exception): """Some compile/link operation failed.""" class PreprocessError(Error): """Failure to preprocess one or more C/C++ files.""" class CompileError(Error): """Failure to compile one or more C/C++ source files.""" class LibError(Error): """Failure to create a static library from one or more C/C++ object files.""" class LinkError(Error): """Failure to link one or more C/C++ object files into an executable or shared library file.""" class UnknownFileType(Error): """Attempt to process an unknown file type.""" _distutils/cmd.py 0000644 00000053252 15030122015 0010040 0 ustar 00 """distutils.cmd Provides the Command class, the base class for the command classes in the distutils.command package. """ from __future__ import annotations import logging import os import re import sys from abc import abstractmethod from collections.abc import Callable, MutableSequence from typing import TYPE_CHECKING, Any, ClassVar, TypeVar, overload from . import _modified, archive_util, dir_util, file_util, util from ._log import log from .errors import DistutilsOptionError if TYPE_CHECKING: # type-only import because of mutual dependence between these classes from distutils.dist import Distribution from typing_extensions import TypeVarTuple, Unpack _Ts = TypeVarTuple("_Ts") _StrPathT = TypeVar("_StrPathT", bound="str | os.PathLike[str]") _BytesPathT = TypeVar("_BytesPathT", bound="bytes | os.PathLike[bytes]") _CommandT = TypeVar("_CommandT", bound="Command") class Command: """Abstract base class for defining command classes, the "worker bees" of the Distutils. A useful analogy for command classes is to think of them as subroutines with local variables called "options". The options are "declared" in 'initialize_options()' and "defined" (given their final values, aka "finalized") in 'finalize_options()', both of which must be defined by every command class. The distinction between the two is necessary because option values might come from the outside world (command line, config file, ...), and any options dependent on other options must be computed *after* these outside influences have been processed -- hence 'finalize_options()'. The "body" of the subroutine, where it does all its work based on the values of its options, is the 'run()' method, which must also be implemented by every command class. """ # 'sub_commands' formalizes the notion of a "family" of commands, # eg. "install" as the parent with sub-commands "install_lib", # "install_headers", etc. The parent of a family of commands # defines 'sub_commands' as a class attribute; it's a list of # (command_name : string, predicate : unbound_method | string | None) # tuples, where 'predicate' is a method of the parent command that # determines whether the corresponding command is applicable in the # current situation. (Eg. we "install_headers" is only applicable if # we have any C header files to install.) If 'predicate' is None, # that command is always applicable. # # 'sub_commands' is usually defined at the *end* of a class, because # predicates can be unbound methods, so they must already have been # defined. The canonical example is the "install" command. sub_commands: ClassVar[ # Any to work around variance issues list[tuple[str, Callable[[Any], bool] | None]] ] = [] user_options: ClassVar[ # Specifying both because list is invariant. Avoids mypy override assignment issues list[tuple[str, str, str]] | list[tuple[str, str | None, str]] ] = [] # -- Creation/initialization methods ------------------------------- def __init__(self, dist: Distribution) -> None: """Create and initialize a new Command object. Most importantly, invokes the 'initialize_options()' method, which is the real initializer and depends on the actual command being instantiated. """ # late import because of mutual dependence between these classes from distutils.dist import Distribution if not isinstance(dist, Distribution): raise TypeError("dist must be a Distribution instance") if self.__class__ is Command: raise RuntimeError("Command is an abstract class") self.distribution = dist self.initialize_options() # Per-command versions of the global flags, so that the user can # customize Distutils' behaviour command-by-command and let some # commands fall back on the Distribution's behaviour. None means # "not defined, check self.distribution's copy", while 0 or 1 mean # false and true (duh). Note that this means figuring out the real # value of each flag is a touch complicated -- hence "self._dry_run" # will be handled by __getattr__, below. # XXX This needs to be fixed. self._dry_run = None # verbose is largely ignored, but needs to be set for # backwards compatibility (I think)? self.verbose = dist.verbose # Some commands define a 'self.force' option to ignore file # timestamps, but methods defined *here* assume that # 'self.force' exists for all commands. So define it here # just to be safe. self.force = None # The 'help' flag is just used for command-line parsing, so # none of that complicated bureaucracy is needed. self.help = False # 'finalized' records whether or not 'finalize_options()' has been # called. 'finalize_options()' itself should not pay attention to # this flag: it is the business of 'ensure_finalized()', which # always calls 'finalize_options()', to respect/update it. self.finalized = False # XXX A more explicit way to customize dry_run would be better. def __getattr__(self, attr): if attr == 'dry_run': myval = getattr(self, "_" + attr) if myval is None: return getattr(self.distribution, attr) else: return myval else: raise AttributeError(attr) def ensure_finalized(self) -> None: if not self.finalized: self.finalize_options() self.finalized = True # Subclasses must define: # initialize_options() # provide default values for all options; may be customized by # setup script, by options from config file(s), or by command-line # options # finalize_options() # decide on the final values for all options; this is called # after all possible intervention from the outside world # (command-line, option file, etc.) has been processed # run() # run the command: do whatever it is we're here to do, # controlled by the command's various option values @abstractmethod def initialize_options(self) -> None: """Set default values for all the options that this command supports. Note that these defaults may be overridden by other commands, by the setup script, by config files, or by the command-line. Thus, this is not the place to code dependencies between options; generally, 'initialize_options()' implementations are just a bunch of "self.foo = None" assignments. This method must be implemented by all command classes. """ raise RuntimeError( f"abstract method -- subclass {self.__class__} must override" ) @abstractmethod def finalize_options(self) -> None: """Set final values for all the options that this command supports. This is always called as late as possible, ie. after any option assignments from the command-line or from other commands have been done. Thus, this is the place to code option dependencies: if 'foo' depends on 'bar', then it is safe to set 'foo' from 'bar' as long as 'foo' still has the same value it was assigned in 'initialize_options()'. This method must be implemented by all command classes. """ raise RuntimeError( f"abstract method -- subclass {self.__class__} must override" ) def dump_options(self, header=None, indent=""): from distutils.fancy_getopt import longopt_xlate if header is None: header = f"command options for '{self.get_command_name()}':" self.announce(indent + header, level=logging.INFO) indent = indent + " " for option, _, _ in self.user_options: option = option.translate(longopt_xlate) if option[-1] == "=": option = option[:-1] value = getattr(self, option) self.announce(indent + f"{option} = {value}", level=logging.INFO) @abstractmethod def run(self) -> None: """A command's raison d'etre: carry out the action it exists to perform, controlled by the options initialized in 'initialize_options()', customized by other commands, the setup script, the command-line, and config files, and finalized in 'finalize_options()'. All terminal output and filesystem interaction should be done by 'run()'. This method must be implemented by all command classes. """ raise RuntimeError( f"abstract method -- subclass {self.__class__} must override" ) def announce(self, msg: object, level: int = logging.DEBUG) -> None: log.log(level, 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. """ from distutils.debug import DEBUG if DEBUG: print(msg) sys.stdout.flush() # -- Option validation methods ------------------------------------- # (these are very handy in writing the 'finalize_options()' method) # # NB. the general philosophy here is to ensure that a particular option # value meets certain type and value constraints. If not, we try to # force it into conformance (eg. if we expect a list but have a string, # split the string on comma and/or whitespace). If we can't force the # option into conformance, raise DistutilsOptionError. Thus, command # classes need do nothing more than (eg.) # self.ensure_string_list('foo') # and they can be guaranteed that thereafter, self.foo will be # a list of strings. def _ensure_stringlike(self, option, what, default=None): val = getattr(self, option) if val is None: setattr(self, option, default) return default elif not isinstance(val, str): raise DistutilsOptionError(f"'{option}' must be a {what} (got `{val}`)") return val def ensure_string(self, option: str, default: str | None = None) -> None: """Ensure that 'option' is a string; if not defined, set it to 'default'. """ self._ensure_stringlike(option, "string", default) def ensure_string_list(self, option: str) -> None: r"""Ensure that 'option' is a list of strings. If 'option' is currently a string, we split it either on /,\s*/ or /\s+/, so "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become ["foo", "bar", "baz"]. """ val = getattr(self, option) if val is None: return elif isinstance(val, str): setattr(self, option, re.split(r',\s*|\s+', val)) else: if isinstance(val, list): ok = all(isinstance(v, str) for v in val) else: ok = False if not ok: raise DistutilsOptionError( f"'{option}' must be a list of strings (got {val!r})" ) def _ensure_tested_string(self, option, tester, what, error_fmt, default=None): val = self._ensure_stringlike(option, what, default) if val is not None and not tester(val): raise DistutilsOptionError( ("error in '%s' option: " + error_fmt) % (option, val) ) def ensure_filename(self, option: str) -> None: """Ensure that 'option' is the name of an existing file.""" self._ensure_tested_string( option, os.path.isfile, "filename", "'%s' does not exist or is not a file" ) def ensure_dirname(self, option: str) -> None: self._ensure_tested_string( option, os.path.isdir, "directory name", "'%s' does not exist or is not a directory", ) # -- Convenience methods for commands ------------------------------ def get_command_name(self) -> str: if hasattr(self, 'command_name'): return self.command_name else: return self.__class__.__name__ def set_undefined_options( self, src_cmd: str, *option_pairs: tuple[str, str] ) -> None: """Set the values of any "undefined" options from corresponding option values in some other command object. "Undefined" here means "is None", which is the convention used to indicate that an option has not been changed between 'initialize_options()' and 'finalize_options()'. Usually called from 'finalize_options()' for options that depend on some other command rather than another option of the same command. 'src_cmd' is the other command from which option values will be taken (a command object will be created for it if necessary); the remaining arguments are '(src_option,dst_option)' tuples which mean "take the value of 'src_option' in the 'src_cmd' command object, and copy it to 'dst_option' in the current command object". """ # Option_pairs: list of (src_option, dst_option) tuples src_cmd_obj = self.distribution.get_command_obj(src_cmd) src_cmd_obj.ensure_finalized() for src_option, dst_option in option_pairs: if getattr(self, dst_option) is None: setattr(self, dst_option, getattr(src_cmd_obj, src_option)) # NOTE: Because distutils is private to Setuptools and not all commands are exposed here, # not every possible command is enumerated in the signature. def get_finalized_command(self, command: str, create: bool = True) -> Command: """Wrapper around Distribution's 'get_command_obj()' method: find (create if necessary and 'create' is true) the command object for 'command', call its 'ensure_finalized()' method, and return the finalized command object. """ cmd_obj = self.distribution.get_command_obj(command, create) cmd_obj.ensure_finalized() return cmd_obj # XXX rename to 'get_reinitialized_command()'? (should do the # same in dist.py, if so) @overload def reinitialize_command( self, command: str, reinit_subcommands: bool = False ) -> Command: ... @overload def reinitialize_command( self, command: _CommandT, reinit_subcommands: bool = False ) -> _CommandT: ... def reinitialize_command( self, command: str | Command, reinit_subcommands=False ) -> Command: return self.distribution.reinitialize_command(command, reinit_subcommands) def run_command(self, command: str) -> None: """Run some other command: uses the 'run_command()' method of Distribution, which creates and finalizes the command object if necessary and then invokes its 'run()' method. """ self.distribution.run_command(command) def get_sub_commands(self) -> list[str]: """Determine the sub-commands that are relevant in the current distribution (ie., that need to be run). This is based on the 'sub_commands' class attribute: each tuple in that list may include a method that we call to determine if the subcommand needs to be run for the current distribution. Return a list of command names. """ commands = [] for cmd_name, method in self.sub_commands: if method is None or method(self): commands.append(cmd_name) return commands # -- External world manipulation ----------------------------------- def warn(self, msg: object) -> None: log.warning("warning: %s: %s\n", self.get_command_name(), msg) def execute( self, func: Callable[[Unpack[_Ts]], object], args: tuple[Unpack[_Ts]], msg: object = None, level: int = 1, ) -> None: util.execute(func, args, msg, dry_run=self.dry_run) def mkpath(self, name: str, mode: int = 0o777) -> None: dir_util.mkpath(name, mode, dry_run=self.dry_run) @overload def copy_file( self, infile: str | os.PathLike[str], outfile: _StrPathT, preserve_mode: bool = True, preserve_times: bool = True, link: str | None = None, level: int = 1, ) -> tuple[_StrPathT | str, bool]: ... @overload def copy_file( self, infile: bytes | os.PathLike[bytes], outfile: _BytesPathT, preserve_mode: bool = True, preserve_times: bool = True, link: str | None = None, level: int = 1, ) -> tuple[_BytesPathT | bytes, bool]: ... def copy_file( self, infile: str | os.PathLike[str] | bytes | os.PathLike[bytes], outfile: str | os.PathLike[str] | bytes | os.PathLike[bytes], preserve_mode: bool = True, preserve_times: bool = True, link: str | None = None, level: int = 1, ) -> tuple[str | os.PathLike[str] | bytes | os.PathLike[bytes], bool]: """Copy a file respecting verbose, dry-run and force flags. (The former two default to whatever is in the Distribution object, and the latter defaults to false for commands that don't define it.)""" return file_util.copy_file( infile, outfile, preserve_mode, preserve_times, not self.force, link, dry_run=self.dry_run, ) def copy_tree( self, infile: str | os.PathLike[str], outfile: str, preserve_mode: bool = True, preserve_times: bool = True, preserve_symlinks: bool = False, level: int = 1, ) -> list[str]: """Copy an entire directory tree respecting verbose, dry-run, and force flags. """ return dir_util.copy_tree( infile, outfile, preserve_mode, preserve_times, preserve_symlinks, not self.force, dry_run=self.dry_run, ) @overload def move_file( self, src: str | os.PathLike[str], dst: _StrPathT, level: int = 1 ) -> _StrPathT | str: ... @overload def move_file( self, src: bytes | os.PathLike[bytes], dst: _BytesPathT, level: int = 1 ) -> _BytesPathT | bytes: ... def move_file( self, src: str | os.PathLike[str] | bytes | os.PathLike[bytes], dst: str | os.PathLike[str] | bytes | os.PathLike[bytes], level: int = 1, ) -> str | os.PathLike[str] | bytes | os.PathLike[bytes]: """Move a file respecting dry-run flag.""" return file_util.move_file(src, dst, dry_run=self.dry_run) def spawn( self, cmd: MutableSequence[str], search_path: bool = True, level: int = 1 ) -> None: """Spawn an external command respecting dry-run flag.""" from distutils.spawn import spawn spawn(cmd, search_path, dry_run=self.dry_run) @overload def make_archive( self, base_name: str, format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, base_dir: str | None = None, owner: str | None = None, group: str | None = None, ) -> str: ... @overload def make_archive( self, base_name: str | os.PathLike[str], format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes], base_dir: str | None = None, owner: str | None = None, group: str | None = None, ) -> str: ... def make_archive( self, base_name: str | os.PathLike[str], format: str, root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, base_dir: str | None = None, owner: str | None = None, group: str | None = None, ) -> str: return archive_util.make_archive( base_name, format, root_dir, base_dir, dry_run=self.dry_run, owner=owner, group=group, ) def make_file( self, infiles: str | list[str] | tuple[str, ...], outfile: str | os.PathLike[str] | bytes | os.PathLike[bytes], func: Callable[[Unpack[_Ts]], object], args: tuple[Unpack[_Ts]], exec_msg: object = None, skip_msg: object = None, level: int = 1, ) -> None: """Special case of 'execute()' for operations that process one or more input files and generate one output file. Works just like 'execute()', except the operation is skipped and a different message printed if 'outfile' already exists and is newer than all files listed in 'infiles'. If the command defined 'self.force', and it is true, then the command is unconditionally run -- does no timestamp checks. """ if skip_msg is None: skip_msg = f"skipping {outfile} (inputs unchanged)" # Allow 'infiles' to be a single string if isinstance(infiles, str): infiles = (infiles,) elif not isinstance(infiles, (list, tuple)): raise TypeError("'infiles' must be a string, or a list or tuple of strings") if exec_msg is None: exec_msg = "generating {} from {}".format(outfile, ', '.join(infiles)) # If 'outfile' must be regenerated (either because it doesn't # exist, is out-of-date, or the 'force' flag is true) then # perform the action that presumably regenerates it if self.force or _modified.newer_group(infiles, outfile): self.execute(func, args, exec_msg, level) # Otherwise, print the "skip" message else: log.debug(skip_msg) _distutils/extension.py 0000644 00000025623 15030122015 0011312 0 ustar 00 """distutils.extension Provides the Extension class, used to describe C/C++ extension modules in setup scripts.""" from __future__ import annotations import os import warnings from collections.abc import Iterable # This class is really only used by the "build_ext" command, so it might # make sense to put it in distutils.command.build_ext. However, that # module is already big enough, and I want to make this class a bit more # complex to simplify some common cases ("foo" module in "foo.c") and do # better error-checking ("foo.c" actually exists). # # Also, putting this in build_ext.py means every setup script would have to # import that large-ish module (indirectly, through distutils.core) in # order to do anything. class Extension: """Just a collection of attributes that describes an extension module and everything needed to build it (hopefully in a portable way, but there are hooks that let you be as unportable as you need). Instance attributes: name : string the full name of the extension, including any packages -- ie. *not* a filename or pathname, but Python dotted name sources : Iterable[string | os.PathLike] iterable of source filenames (except strings, which could be misinterpreted as a single filename), relative to the distribution root (where the setup script lives), in Unix form (slash-separated) for portability. Can be any non-string iterable (list, tuple, set, etc.) containing strings or PathLike objects. Source files may be C, C++, SWIG (.i), platform-specific resource files, or whatever else is recognized by the "build_ext" command as source for a Python extension. include_dirs : [string] list of directories to search for C/C++ header files (in Unix form for portability) define_macros : [(name : string, value : string|None)] list of macros to define; each macro is defined using a 2-tuple, where 'value' is either the string to define it to or None to define it without a particular value (equivalent of "#define FOO" in source or -DFOO on Unix C compiler command line) undef_macros : [string] list of macros to undefine explicitly library_dirs : [string] list of directories to search for C/C++ libraries at link time libraries : [string] list of library names (not filenames or paths) to link against runtime_library_dirs : [string] list of directories to search for C/C++ libraries at run time (for shared extensions, this is when the extension is loaded) extra_objects : [string] list of extra files to link with (eg. object files not implied by 'sources', static library that must be explicitly specified, binary resource files, etc.) extra_compile_args : [string] any extra platform- and compiler-specific information to use when compiling the source files in 'sources'. For platforms and compilers where "command line" makes sense, this is typically a list of command-line arguments, but for other platforms it could be anything. extra_link_args : [string] any extra platform- and compiler-specific information to use when linking object files together to create the extension (or to create a new static Python interpreter). Similar interpretation as for 'extra_compile_args'. export_symbols : [string] list of symbols to be exported from a shared extension. Not used on all platforms, and not generally necessary for Python extensions, which typically export exactly one symbol: "init" + extension_name. swig_opts : [string] any extra options to pass to SWIG if a source file has the .i extension. depends : [string] list of files that the extension depends on language : string extension language (i.e. "c", "c++", "objc"). Will be detected from the source extensions if not provided. optional : boolean specifies that a build failure in the extension should not abort the build process, but simply not install the failing extension. """ # When adding arguments to this constructor, be sure to update # setup_keywords in core.py. def __init__( self, name: str, sources: Iterable[str | os.PathLike[str]], include_dirs: list[str] | None = None, define_macros: list[tuple[str, str | None]] | None = None, undef_macros: list[str] | None = None, library_dirs: list[str] | None = None, libraries: list[str] | None = None, runtime_library_dirs: list[str] | None = None, extra_objects: list[str] | None = None, extra_compile_args: list[str] | None = None, extra_link_args: list[str] | None = None, export_symbols: list[str] | None = None, swig_opts: list[str] | None = None, depends: list[str] | None = None, language: str | None = None, optional: bool | None = None, **kw, # To catch unknown keywords ): if not isinstance(name, str): raise TypeError("'name' must be a string") # handle the string case first; since strings are iterable, disallow them if isinstance(sources, str): raise TypeError( "'sources' must be an iterable of strings or PathLike objects, not a string" ) # now we check if it's iterable and contains valid types try: self.sources = list(map(os.fspath, sources)) except TypeError: raise TypeError( "'sources' must be an iterable of strings or PathLike objects" ) self.name = name self.include_dirs = include_dirs or [] self.define_macros = define_macros or [] self.undef_macros = undef_macros or [] self.library_dirs = library_dirs or [] self.libraries = libraries or [] self.runtime_library_dirs = runtime_library_dirs or [] self.extra_objects = extra_objects or [] self.extra_compile_args = extra_compile_args or [] self.extra_link_args = extra_link_args or [] self.export_symbols = export_symbols or [] self.swig_opts = swig_opts or [] self.depends = depends or [] self.language = language self.optional = optional # If there are unknown keyword options, warn about them if len(kw) > 0: options = [repr(option) for option in kw] options = ', '.join(sorted(options)) msg = f"Unknown Extension options: {options}" warnings.warn(msg) def __repr__(self): return f'<{self.__class__.__module__}.{self.__class__.__qualname__}({self.name!r}) at {id(self):#x}>' def read_setup_file(filename): # noqa: C901 """Reads a Setup file and returns Extension instances.""" from distutils.sysconfig import _variable_rx, expand_makefile_vars, parse_makefile from distutils.text_file import TextFile from distutils.util import split_quoted # First pass over the file to gather "VAR = VALUE" assignments. vars = parse_makefile(filename) # Second pass to gobble up the real content: lines of the form # <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...] file = TextFile( filename, strip_comments=True, skip_blanks=True, join_lines=True, lstrip_ws=True, rstrip_ws=True, ) try: extensions = [] while True: line = file.readline() if line is None: # eof break if _variable_rx.match(line): # VAR=VALUE, handled in first pass continue if line[0] == line[-1] == "*": file.warn(f"'{line}' lines not handled yet") continue line = expand_makefile_vars(line, vars) words = split_quoted(line) # NB. this parses a slightly different syntax than the old # makesetup script: here, there must be exactly one extension per # line, and it must be the first word of the line. I have no idea # why the old syntax supported multiple extensions per line, as # they all wind up being the same. module = words[0] ext = Extension(module, []) append_next_word = None for word in words[1:]: if append_next_word is not None: append_next_word.append(word) append_next_word = None continue suffix = os.path.splitext(word)[1] switch = word[0:2] value = word[2:] if suffix in (".c", ".cc", ".cpp", ".cxx", ".c++", ".m", ".mm"): # hmm, should we do something about C vs. C++ sources? # or leave it up to the CCompiler implementation to # worry about? ext.sources.append(word) elif switch == "-I": ext.include_dirs.append(value) elif switch == "-D": equals = value.find("=") if equals == -1: # bare "-DFOO" -- no value ext.define_macros.append((value, None)) else: # "-DFOO=blah" ext.define_macros.append((value[0:equals], value[equals + 2 :])) elif switch == "-U": ext.undef_macros.append(value) elif switch == "-C": # only here 'cause makesetup has it! ext.extra_compile_args.append(word) elif switch == "-l": ext.libraries.append(value) elif switch == "-L": ext.library_dirs.append(value) elif switch == "-R": ext.runtime_library_dirs.append(value) elif word == "-rpath": append_next_word = ext.runtime_library_dirs elif word == "-Xlinker": append_next_word = ext.extra_link_args elif word == "-Xcompiler": append_next_word = ext.extra_compile_args elif switch == "-u": ext.extra_link_args.append(word) if not value: append_next_word = ext.extra_link_args elif suffix in (".a", ".so", ".sl", ".o", ".dylib"): # NB. a really faithful emulation of makesetup would # append a .o file to extra_objects only if it # had a slash in it; otherwise, it would s/.o/.c/ # and append it to sources. Hmmmm. ext.extra_objects.append(word) else: file.warn(f"unrecognized argument '{word}'") extensions.append(ext) finally: file.close() return extensions _distutils/text_file.py 0000644 00000027505 15030122015 0011262 0 ustar 00 """text_file provides the TextFile class, which gives an interface to text files that (optionally) takes care of stripping comments, ignoring blank lines, and joining lines with backslashes.""" import sys class TextFile: """Provides a file-like object that takes care of all the things you commonly want to do when processing a text file that has some line-by-line syntax: strip comments (as long as "#" is your comment character), skip blank lines, join adjacent lines by escaping the newline (ie. backslash at end of line), strip leading and/or trailing whitespace. All of these are optional and independently controllable. Provides a 'warn()' method so you can generate warning messages that report physical line number, even if the logical line in question spans multiple physical lines. Also provides 'unreadline()' for implementing line-at-a-time lookahead. Constructor is called as: TextFile (filename=None, file=None, **options) It bombs (RuntimeError) if both 'filename' and 'file' are None; 'filename' should be a string, and 'file' a file object (or something that provides 'readline()' and 'close()' methods). It is recommended that you supply at least 'filename', so that TextFile can include it in warning messages. If 'file' is not supplied, TextFile creates its own using 'io.open()'. The options are all boolean, and affect the value returned by 'readline()': strip_comments [default: true] strip from "#" to end-of-line, as well as any whitespace leading up to the "#" -- unless it is escaped by a backslash lstrip_ws [default: false] strip leading whitespace from each line before returning it rstrip_ws [default: true] strip trailing whitespace (including line terminator!) from each line before returning it skip_blanks [default: true} skip lines that are empty *after* stripping comments and whitespace. (If both lstrip_ws and rstrip_ws are false, then some lines may consist of solely whitespace: these will *not* be skipped, even if 'skip_blanks' is true.) join_lines [default: false] if a backslash is the last non-newline character on a line after stripping comments and whitespace, join the following line to it to form one "logical line"; if N consecutive lines end with a backslash, then N+1 physical lines will be joined to form one logical line. collapse_join [default: false] strip leading whitespace from lines that are joined to their predecessor; only matters if (join_lines and not lstrip_ws) errors [default: 'strict'] error handler used to decode the file content Note that since 'rstrip_ws' can strip the trailing newline, the semantics of 'readline()' must differ from those of the builtin file object's 'readline()' method! In particular, 'readline()' returns None for end-of-file: an empty string might just be a blank line (or an all-whitespace line), if 'rstrip_ws' is true but 'skip_blanks' is not.""" default_options = { 'strip_comments': 1, 'skip_blanks': 1, 'lstrip_ws': 0, 'rstrip_ws': 1, 'join_lines': 0, 'collapse_join': 0, 'errors': 'strict', } def __init__(self, filename=None, file=None, **options): """Construct a new TextFile object. At least one of 'filename' (a string) and 'file' (a file-like object) must be supplied. They keyword argument options are described above and affect the values returned by 'readline()'.""" if filename is None and file is None: raise RuntimeError( "you must supply either or both of 'filename' and 'file'" ) # set values for all options -- either from client option hash # or fallback to default_options for opt in self.default_options.keys(): if opt in options: setattr(self, opt, options[opt]) else: setattr(self, opt, self.default_options[opt]) # sanity check client option hash for opt in options.keys(): if opt not in self.default_options: raise KeyError(f"invalid TextFile option '{opt}'") if file is None: self.open(filename) else: self.filename = filename self.file = file self.current_line = 0 # assuming that file is at BOF! # 'linebuf' is a stack of lines that will be emptied before we # actually read from the file; it's only populated by an # 'unreadline()' operation self.linebuf = [] def open(self, filename): """Open a new file named 'filename'. This overrides both the 'filename' and 'file' arguments to the constructor.""" self.filename = filename self.file = open(self.filename, errors=self.errors, encoding='utf-8') self.current_line = 0 def close(self): """Close the current file and forget everything we know about it (filename, current line number).""" file = self.file self.file = None self.filename = None self.current_line = None file.close() def gen_error(self, msg, line=None): outmsg = [] if line is None: line = self.current_line outmsg.append(self.filename + ", ") if isinstance(line, (list, tuple)): outmsg.append("lines {}-{}: ".format(*line)) else: outmsg.append(f"line {int(line)}: ") outmsg.append(str(msg)) return "".join(outmsg) def error(self, msg, line=None): raise ValueError("error: " + self.gen_error(msg, line)) def warn(self, msg, line=None): """Print (to stderr) a warning message tied to the current logical line in the current file. If the current logical line in the file spans multiple physical lines, the warning refers to the whole range, eg. "lines 3-5". If 'line' supplied, it overrides the current line number; it may be a list or tuple to indicate a range of physical lines, or an integer for a single physical line.""" sys.stderr.write("warning: " + self.gen_error(msg, line) + "\n") def readline(self): # noqa: C901 """Read and return a single logical line from the current file (or from an internal buffer if lines have previously been "unread" with 'unreadline()'). If the 'join_lines' option is true, this may involve reading multiple physical lines concatenated into a single string. Updates the current line number, so calling 'warn()' after 'readline()' emits a warning about the physical line(s) just read. Returns None on end-of-file, since the empty string can occur if 'rstrip_ws' is true but 'strip_blanks' is not.""" # If any "unread" lines waiting in 'linebuf', return the top # one. (We don't actually buffer read-ahead data -- lines only # get put in 'linebuf' if the client explicitly does an # 'unreadline()'. if self.linebuf: line = self.linebuf[-1] del self.linebuf[-1] return line buildup_line = '' while True: # read the line, make it None if EOF line = self.file.readline() if line == '': line = None if self.strip_comments and line: # Look for the first "#" in the line. If none, never # mind. If we find one and it's the first character, or # is not preceded by "\", then it starts a comment -- # strip the comment, strip whitespace before it, and # carry on. Otherwise, it's just an escaped "#", so # unescape it (and any other escaped "#"'s that might be # lurking in there) and otherwise leave the line alone. pos = line.find("#") if pos == -1: # no "#" -- no comments pass # It's definitely a comment -- either "#" is the first # character, or it's elsewhere and unescaped. elif pos == 0 or line[pos - 1] != "\\": # Have to preserve the trailing newline, because it's # the job of a later step (rstrip_ws) to remove it -- # and if rstrip_ws is false, we'd better preserve it! # (NB. this means that if the final line is all comment # and has no trailing newline, we will think that it's # EOF; I think that's OK.) eol = (line[-1] == '\n') and '\n' or '' line = line[0:pos] + eol # If all that's left is whitespace, then skip line # *now*, before we try to join it to 'buildup_line' -- # that way constructs like # hello \\ # # comment that should be ignored # there # result in "hello there". if line.strip() == "": continue else: # it's an escaped "#" line = line.replace("\\#", "#") # did previous line end with a backslash? then accumulate if self.join_lines and buildup_line: # oops: end of file if line is None: self.warn("continuation line immediately precedes end-of-file") return buildup_line if self.collapse_join: line = line.lstrip() line = buildup_line + line # careful: pay attention to line number when incrementing it if isinstance(self.current_line, list): self.current_line[1] = self.current_line[1] + 1 else: self.current_line = [self.current_line, self.current_line + 1] # just an ordinary line, read it as usual else: if line is None: # eof return None # still have to be careful about incrementing the line number! if isinstance(self.current_line, list): self.current_line = self.current_line[1] + 1 else: self.current_line = self.current_line + 1 # strip whitespace however the client wants (leading and # trailing, or one or the other, or neither) if self.lstrip_ws and self.rstrip_ws: line = line.strip() elif self.lstrip_ws: line = line.lstrip() elif self.rstrip_ws: line = line.rstrip() # blank line (whether we rstrip'ed or not)? skip to next line # if appropriate if line in ('', '\n') and self.skip_blanks: continue if self.join_lines: if line[-1] == '\\': buildup_line = line[:-1] continue if line[-2:] == '\\\n': buildup_line = line[0:-2] + '\n' continue # well, I guess there's some actual content there: return it return line def readlines(self): """Read and return the list of all logical lines remaining in the current file.""" lines = [] while True: line = self.readline() if line is None: return lines lines.append(line) def unreadline(self, line): """Push 'line' (a string) onto an internal buffer that will be checked by future 'readline()' calls. Handy for implementing a parser with line-at-a-time lookahead.""" self.linebuf.append(line) _distutils/filelist.py 0000644 00000035751 15030122015 0011114 0 ustar 00 """distutils.filelist 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 from .util import convert_path class FileList: """A list of files built by on exploring the filesystem and filtered by applying various patterns to what we find there. Instance attributes: dir directory from which files will be taken -- only used if 'allfiles' not supplied to constructor files list of filenames currently being built/filtered/manipulated allfiles complete list of files under consideration (ie. without any filtering applied) """ def __init__(self, warn: object = None, debug_print: object = None) -> None: # ignore argument to FileList, but keep them for backwards # compatibility self.allfiles: Iterable[str] | None = None self.files: list[str] = [] def set_allfiles(self, allfiles: Iterable[str]) -> None: self.allfiles = allfiles def findall(self, dir: str | os.PathLike[str] = os.curdir) -> None: self.allfiles = findall(dir) 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. """ from distutils.debug import DEBUG if DEBUG: print(msg) # Collection methods def append(self, item: str) -> None: self.files.append(item) def extend(self, items: Iterable[str]) -> None: self.files.extend(items) def sort(self) -> None: # Not a strict lexical sort! sortable_files = sorted(map(os.path.split, self.files)) self.files = [] for sort_tuple in sortable_files: self.files.append(os.path.join(*sort_tuple)) # Other miscellaneous utility methods 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]: del self.files[i] # "File template" methods def _parse_template_line(self, line): words = line.split() action = words[0] patterns = dir = dir_pattern = None if action in ('include', 'exclude', 'global-include', 'global-exclude'): if len(words) < 2: raise DistutilsTemplateError( f"'{action}' expects <pattern1> <pattern2> ..." ) patterns = [convert_path(w) for w in words[1:]] elif action in ('recursive-include', 'recursive-exclude'): if len(words) < 3: raise DistutilsTemplateError( f"'{action}' expects <dir> <pattern1> <pattern2> ..." ) dir = convert_path(words[1]) patterns = [convert_path(w) for w in words[2:]] elif action in ('graft', 'prune'): if len(words) != 2: raise DistutilsTemplateError( f"'{action}' expects a single <dir_pattern>" ) dir_pattern = convert_path(words[1]) else: raise DistutilsTemplateError(f"unknown action '{action}'") return (action, patterns, dir, dir_pattern) 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 # three are defined depends on the action; it'll be either # patterns, (dir and patterns), or (dir_pattern). (action, patterns, dir, dir_pattern) = self._parse_template_line(line) # OK, now we know that the action is valid and we have the # right number of words on the line for that action -- so we # can proceed with minimal error-checking. if action == 'include': self.debug_print("include " + ' '.join(patterns)) for pattern in patterns: if not self.include_pattern(pattern, anchor=True): log.warning("warning: no files found matching '%s'", pattern) elif action == 'exclude': self.debug_print("exclude " + ' '.join(patterns)) for pattern in patterns: if not self.exclude_pattern(pattern, anchor=True): log.warning( "warning: no previously-included files found matching '%s'", pattern, ) elif action == 'global-include': self.debug_print("global-include " + ' '.join(patterns)) for pattern in patterns: if not self.include_pattern(pattern, anchor=False): log.warning( ( "warning: no files found matching '%s' " "anywhere in distribution" ), pattern, ) elif action == 'global-exclude': self.debug_print("global-exclude " + ' '.join(patterns)) for pattern in patterns: if not self.exclude_pattern(pattern, anchor=False): log.warning( ( "warning: no previously-included files matching " "'%s' found anywhere in distribution" ), pattern, ) elif action == 'recursive-include': self.debug_print("recursive-include {} {}".format(dir, ' '.join(patterns))) for pattern in patterns: if not self.include_pattern(pattern, prefix=dir): msg = "warning: no files found matching '%s' under directory '%s'" log.warning(msg, pattern, dir) elif action == 'recursive-exclude': self.debug_print("recursive-exclude {} {}".format(dir, ' '.join(patterns))) for pattern in patterns: if not self.exclude_pattern(pattern, prefix=dir): log.warning( ( "warning: no previously-included files matching " "'%s' found under directory '%s'" ), pattern, dir, ) elif action == 'graft': self.debug_print("graft " + dir_pattern) if not self.include_pattern(None, prefix=dir_pattern): log.warning("warning: no directories found matching '%s'", dir_pattern) elif action == 'prune': self.debug_print("prune " + dir_pattern) if not self.exclude_pattern(None, prefix=dir_pattern): log.warning( ("no previously-included directories found matching '%s'"), dir_pattern, ) else: raise DistutilsInternalError( f"this cannot happen: invalid action '{action}'" ) # Filtering/selection methods @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: '*' and '?' match non-special characters, where "special" is platform- dependent: slash on Unix; colon, slash, and backslash on DOS/Windows; and colon on Mac OS. If 'anchor' is true (the default), then the pattern match is more stringent: "*.py" will match "foo.py" but not "foo/bar.py". If 'anchor' is false, both of these will match. If 'prefix' is supplied, then only filenames starting with 'prefix' (itself a pattern) and ending with 'pattern', with anything in between them, will match. 'anchor' is ignored in this case. If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and 'pattern' is assumed to be either a string containing a regex or a regex object -- no translation is done, the regex is just compiled and used as-is. Selected strings will be added to self.files. Return True if files are found, False otherwise. """ # XXX docstring lying about what the special chars are? files_found = False pattern_re = translate_pattern(pattern, anchor, prefix, is_regex) self.debug_print(f"include_pattern: applying regex r'{pattern_re.pattern}'") # delayed loading of allfiles list if self.allfiles is None: self.findall() for name in self.allfiles: if pattern_re.search(name): self.debug_print(" adding " + name) self.files.append(name) files_found = True return files_found @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. The list 'self.files' is modified in place. Return True if files are found, False otherwise. """ files_found = False pattern_re = translate_pattern(pattern, anchor, prefix, is_regex) self.debug_print(f"exclude_pattern: applying regex r'{pattern_re.pattern}'") for i in range(len(self.files) - 1, -1, -1): if pattern_re.search(self.files[i]): self.debug_print(" removing " + self.files[i]) del self.files[i] files_found = True return files_found # Utility functions def _find_all_simple(path): """ Find all files under 'path' """ all_unique = _UniqueDirs.filter(os.walk(path, followlinks=True)) results = ( os.path.join(base, file) for base, dirs, files in all_unique for file in files ) return filter(os.path.isfile, results) class _UniqueDirs(set): """ Exclude previously-seen dirs from walk results, avoiding infinite recursion. Ref https://bugs.python.org/issue44497. """ def __call__(self, walk_item): """ Given an item from an os.walk result, determine if the item represents a unique dir for this instance and if not, prevent further traversal. """ base, dirs, files = walk_item stat = os.stat(base) candidate = stat.st_dev, stat.st_ino found = candidate in self if found: del dirs[:] self.add(candidate) return not found @classmethod def filter(cls, items): return filter(cls(), items) 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. """ files = _find_all_simple(dir) if dir == os.curdir: make_rel = functools.partial(os.path.relpath, start=dir) files = map(make_rel, files) return list(files) def glob_to_re(pattern): """Translate a shell-like glob pattern to a regular expression; return a string containing the regex. Differs from 'fnmatch.translate()' in that '*' does not match "special characters" (which are platform-specific). """ pattern_re = fnmatch.translate(pattern) # '?' and '*' in the glob pattern become '.' and '.*' in the RE, which # IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix, # and by extension they shouldn't match such "special characters" under # any OS. So change all non-escaped dots in the RE to match any # character except the special characters (currently: just os.sep). sep = os.sep if os.sep == '\\': # we're using a regex to manipulate a regex, so we need # to escape the backslash twice sep = r'\\\\' escaped = rf'\1[^{sep}]' pattern_re = re.sub(r'((?<!\\)(\\\\)*)\.', escaped, pattern_re) return pattern_re def translate_pattern(pattern, anchor=True, prefix=None, is_regex=False): """Translate a shell-like wildcard pattern to a compiled regular expression. Return the compiled regex. If 'is_regex' true, then 'pattern' is directly compiled to a regex (if it's a string) or just returned as-is (assumes it's a regex object). """ if is_regex: if isinstance(pattern, str): return re.compile(pattern) else: return pattern # ditch start and end characters start, _, end = glob_to_re('_').partition('_') if pattern: pattern_re = glob_to_re(pattern) assert pattern_re.startswith(start) and pattern_re.endswith(end) else: pattern_re = '' if prefix is not None: prefix_re = glob_to_re(prefix) assert prefix_re.startswith(start) and prefix_re.endswith(end) prefix_re = prefix_re[len(start) : len(prefix_re) - len(end)] sep = os.sep if os.sep == '\\': sep = r'\\' pattern_re = pattern_re[len(start) : len(pattern_re) - len(end)] pattern_re = rf'{start}\A{prefix_re}{sep}.*{pattern_re}{end}' else: # no prefix -- respect anchor flag if anchor: pattern_re = rf'{start}\A{pattern_re[len(start) :]}' return re.compile(pattern_re) _distutils/_macos_compat.py 0000644 00000000357 15030122015 0012077 0 ustar 00 import importlib import sys def bypass_compiler_fixup(cmd, args): return cmd if sys.platform == 'darwin': compiler_fixup = importlib.import_module('_osx_support').compiler_fixup else: compiler_fixup = bypass_compiler_fixup _distutils/_log.py 0000644 00000000052 15030122015 0010203 0 ustar 00 import logging log = logging.getLogger() _distutils/__init__.py 0000644 00000000547 15030122015 0011033 0 ustar 00 import importlib import sys __version__, _, _ = sys.version.partition(' ') try: # Allow Debian and pkgsrc (only) to customize system # behavior. Ref pypa/distutils#2 and pypa/distutils#16. # This hook is deprecated and no other environments # should use it. importlib.import_module('_distutils_system_mod') except ImportError: pass _distutils/errors.py 0000644 00000006024 15030122015 0010604 0 ustar 00 """ Exceptions used by the Distutils modules. Distutils modules may raise these or standard exceptions, including :exc:`SystemExit`. """ # compiler exceptions aliased for compatibility from .compilers.C.errors import CompileError as CompileError from .compilers.C.errors import Error as _Error from .compilers.C.errors import LibError as LibError from .compilers.C.errors import LinkError as LinkError from .compilers.C.errors import PreprocessError as PreprocessError from .compilers.C.errors import UnknownFileType as _UnknownFileType CCompilerError = _Error UnknownFileError = _UnknownFileType class DistutilsError(Exception): """The root of all Distutils evil.""" pass class DistutilsModuleError(DistutilsError): """Unable to load an expected module, or to find an expected class within some module (in particular, command modules and classes).""" pass class DistutilsClassError(DistutilsError): """Some command class (or possibly distribution class, if anyone feels a need to subclass Distribution) is found not to be holding up its end of the bargain, ie. implementing some part of the "command "interface.""" pass class DistutilsGetoptError(DistutilsError): """The option table provided to 'fancy_getopt()' is bogus.""" pass class DistutilsArgError(DistutilsError): """Raised by fancy_getopt in response to getopt.error -- ie. an error in the command line usage.""" pass class DistutilsFileError(DistutilsError): """Any problems in the filesystem: expected file not found, etc. Typically this is for problems that we detect before OSError could be raised.""" pass class DistutilsOptionError(DistutilsError): """Syntactic/semantic errors in command options, such as use of mutually conflicting options, or inconsistent options, badly-spelled values, etc. No distinction is made between option values originating in the setup script, the command line, config files, or what-have-you -- but if we *know* something originated in the setup script, we'll raise DistutilsSetupError instead.""" pass class DistutilsSetupError(DistutilsError): """For errors that can be definitely blamed on the setup script, such as invalid keyword arguments to 'setup()'.""" pass class DistutilsPlatformError(DistutilsError): """We don't know how to do something on the current platform (but we do know how to do it on some platform) -- eg. trying to compile C files on a platform not supported by a CCompiler subclass.""" pass class DistutilsExecError(DistutilsError): """Any problems executing an external program (such as the C compiler, when compiling C files).""" pass class DistutilsInternalError(DistutilsError): """Internal inconsistencies or impossibilities (obviously, this should never be seen if the code is working!).""" pass class DistutilsTemplateError(DistutilsError): """Syntax error in a file list template.""" class DistutilsByteCompileError(DistutilsError): """Byte compile error.""" dist.py 0000644 00000127541 15030122015 0006060 0 ustar 00 from __future__ import annotations import functools import io import itertools import numbers import os import re import sys from collections.abc import Iterable, Iterator, MutableMapping, Sequence from glob import glob from pathlib import Path from typing import TYPE_CHECKING, Any, Union from more_itertools import partition, unique_everseen from packaging.markers import InvalidMarker, Marker from packaging.specifiers import InvalidSpecifier, SpecifierSet from packaging.version import Version from . import ( _entry_points, _reqs, _static, command as _, # noqa: F401 # imported for side-effects ) from ._importlib import metadata from ._normalization import _canonicalize_license_expression from ._path import StrPath from ._reqs import _StrOrIter from .config import pyprojecttoml, setupcfg from .discovery import ConfigDiscovery from .errors import InvalidConfigError from .monkey import get_unpatched from .warnings import InformationOnly, SetuptoolsDeprecationWarning import distutils.cmd import distutils.command import distutils.core import distutils.dist import distutils.log from distutils.debug import DEBUG from distutils.errors import DistutilsOptionError, DistutilsSetupError from distutils.fancy_getopt import translate_longopt from distutils.util import strtobool if TYPE_CHECKING: from typing_extensions import TypeAlias from pkg_resources import Distribution as _pkg_resources_Distribution __all__ = ['Distribution'] _sequence = tuple, list """ :meta private: Supported iterable types that are known to be: - ordered (which `set` isn't) - not match a str (which `Sequence[str]` does) - not imply a nested type (like `dict`) for use with `isinstance`. """ _Sequence: TypeAlias = Union[tuple[str, ...], list[str]] # This is how stringifying _Sequence would look in Python 3.10 _sequence_type_repr = "tuple[str, ...] | list[str]" _OrderedStrSequence: TypeAlias = Union[str, dict[str, Any], Sequence[str]] """ :meta private: Avoid single-use iterable. Disallow sets. A poor approximation of an OrderedSequence (dict doesn't match a Sequence). """ def __getattr__(name: str) -> Any: # pragma: no cover if name == "sequence": SetuptoolsDeprecationWarning.emit( "`setuptools.dist.sequence` is an internal implementation detail.", "Please define your own `sequence = tuple, list` instead.", due_date=(2025, 8, 28), # Originally added on 2024-08-27 ) return _sequence raise AttributeError(f"module {__name__!r} has no attribute {name!r}") def check_importable(dist, attr, value): try: ep = metadata.EntryPoint(value=value, name=None, group=None) assert not ep.extras except (TypeError, ValueError, AttributeError, AssertionError) as e: raise DistutilsSetupError( f"{attr!r} must be importable 'module:attrs' string (got {value!r})" ) from e def assert_string_list(dist, attr: str, value: _Sequence) -> None: """Verify that value is a string list""" try: # verify that value is a list or tuple to exclude unordered # or single-use iterables assert isinstance(value, _sequence) # verify that elements of value are strings assert ''.join(value) != value except (TypeError, ValueError, AttributeError, AssertionError) as e: raise DistutilsSetupError( f"{attr!r} must be of type <{_sequence_type_repr}> (got {value!r})" ) from e def check_nsp(dist, attr, value): """Verify that namespace packages are valid""" ns_packages = value assert_string_list(dist, attr, ns_packages) for nsp in ns_packages: if not dist.has_contents_for(nsp): raise DistutilsSetupError( f"Distribution contains no modules or packages for namespace package {nsp!r}" ) parent, _sep, _child = nsp.rpartition('.') if parent and parent not in ns_packages: distutils.log.warn( "WARNING: %r is declared as a package namespace, but %r" " is not: please correct this in setup.py", nsp, parent, ) SetuptoolsDeprecationWarning.emit( "The namespace_packages parameter is deprecated.", "Please replace its usage with implicit namespaces (PEP 420).", see_docs="references/keywords.html#keyword-namespace-packages", # TODO: define due_date, it may break old packages that are no longer # maintained (e.g. sphinxcontrib extensions) when installed from source. # Warning officially introduced in May 2022, however the deprecation # was mentioned much earlier in the docs (May 2020, see #2149). ) def check_extras(dist, attr, value): """Verify that extras_require mapping is valid""" try: list(itertools.starmap(_check_extra, value.items())) except (TypeError, ValueError, AttributeError) as e: raise DistutilsSetupError( "'extras_require' must be a dictionary whose values are " "strings or lists of strings containing valid project/version " "requirement specifiers." ) from e def _check_extra(extra, reqs): _name, _sep, marker = extra.partition(':') try: _check_marker(marker) except InvalidMarker: msg = f"Invalid environment marker: {marker} ({extra!r})" raise DistutilsSetupError(msg) from None list(_reqs.parse(reqs)) def _check_marker(marker): if not marker: return m = Marker(marker) m.evaluate() def assert_bool(dist, attr, value): """Verify that value is True, False, 0, or 1""" if bool(value) != value: raise DistutilsSetupError(f"{attr!r} must be a boolean value (got {value!r})") def invalid_unless_false(dist, attr, value): if not value: DistDeprecationWarning.emit(f"{attr} is ignored.") # TODO: should there be a `due_date` here? return raise DistutilsSetupError(f"{attr} is invalid.") def check_requirements(dist, attr: str, value: _OrderedStrSequence) -> None: """Verify that install_requires is a valid requirements list""" try: list(_reqs.parse(value)) if isinstance(value, set): raise TypeError("Unordered types are not allowed") except (TypeError, ValueError) as error: msg = ( f"{attr!r} must be a string or iterable of strings " f"containing valid project/version requirement specifiers; {error}" ) raise DistutilsSetupError(msg) from error def check_specifier(dist, attr, value): """Verify that value is a valid version specifier""" try: SpecifierSet(value) except (InvalidSpecifier, AttributeError) as error: msg = f"{attr!r} must be a string containing valid version specifiers; {error}" raise DistutilsSetupError(msg) from error def check_entry_points(dist, attr, value): """Verify that entry_points map is parseable""" try: _entry_points.load(value) except Exception as e: raise DistutilsSetupError(e) from e def check_package_data(dist, attr, value): """Verify that value is a dictionary of package names to glob lists""" if not isinstance(value, dict): raise DistutilsSetupError( f"{attr!r} must be a dictionary mapping package names to lists of " "string wildcard patterns" ) for k, v in value.items(): if not isinstance(k, str): raise DistutilsSetupError( f"keys of {attr!r} dict must be strings (got {k!r})" ) assert_string_list(dist, f'values of {attr!r} dict', v) def check_packages(dist, attr, value): for pkgname in value: if not re.match(r'\w+(\.\w+)*', pkgname): distutils.log.warn( "WARNING: %r not a valid package name; please use only " ".-separated package names in setup.py", pkgname, ) if TYPE_CHECKING: # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962 from distutils.core import Distribution as _Distribution else: _Distribution = get_unpatched(distutils.core.Distribution) class Distribution(_Distribution): """Distribution with support for tests and package data This is an enhanced version of 'distutils.dist.Distribution' that effectively adds the following new optional keyword arguments to 'setup()': 'install_requires' -- a string or sequence of strings specifying project versions that the distribution requires when installed, in the format used by 'pkg_resources.require()'. They will be installed automatically when the package is installed. If you wish to use packages that are not available in PyPI, or want to give your users an alternate download location, you can add a 'find_links' option to the '[easy_install]' section of your project's 'setup.cfg' file, and then setuptools will scan the listed web pages for links that satisfy the requirements. 'extras_require' -- a dictionary mapping names of optional "extras" to the additional requirement(s) that using those extras incurs. For example, this:: extras_require = dict(reST = ["docutils>=0.3", "reSTedit"]) indicates that the distribution can optionally provide an extra capability called "reST", but it can only be used if docutils and reSTedit are installed. If the user installs your package using EasyInstall and requests one of your extras, the corresponding additional requirements will be installed if needed. 'package_data' -- a dictionary mapping package names to lists of filenames or globs to use to find data files contained in the named packages. If the dictionary has filenames or globs listed under '""' (the empty string), those names will be searched for in every package, in addition to any names for the specific package. Data files found using these names/globs will be installed along with the package, in the same location as the package. Note that globs are allowed to reference the contents of non-package subdirectories, as long as you use '/' as a path separator. (Globs are automatically converted to platform-specific paths at runtime.) In addition to these new keywords, this class also has several new methods for manipulating the distribution's contents. For example, the 'include()' and 'exclude()' methods can be thought of as in-place add and subtract commands that add or remove packages, modules, extensions, and so on from the distribution. """ _DISTUTILS_UNSUPPORTED_METADATA = { 'long_description_content_type': lambda: None, 'project_urls': dict, 'provides_extras': dict, # behaves like an ordered set 'license_expression': lambda: None, 'license_file': lambda: None, 'license_files': lambda: None, 'install_requires': list, 'extras_require': dict, } # Used by build_py, editable_wheel and install_lib commands for legacy namespaces namespace_packages: list[str] #: :meta private: DEPRECATED # Any: Dynamic assignment results in Incompatible types in assignment def __init__(self, attrs: MutableMapping[str, Any] | None = None) -> None: have_package_data = hasattr(self, "package_data") if not have_package_data: self.package_data: dict[str, list[str]] = {} attrs = attrs or {} self.dist_files: list[tuple[str, str, str]] = [] self.include_package_data: bool | None = None self.exclude_package_data: dict[str, list[str]] | None = None # Filter-out setuptools' specific options. self.src_root: str | None = attrs.pop("src_root", None) self.dependency_links: list[str] = attrs.pop('dependency_links', []) self.setup_requires: list[str] = attrs.pop('setup_requires', []) for ep in metadata.entry_points(group='distutils.setup_keywords'): vars(self).setdefault(ep.name, None) metadata_only = set(self._DISTUTILS_UNSUPPORTED_METADATA) metadata_only -= {"install_requires", "extras_require"} dist_attrs = {k: v for k, v in attrs.items() if k not in metadata_only} _Distribution.__init__(self, dist_attrs) # Private API (setuptools-use only, not restricted to Distribution) # Stores files that are referenced by the configuration and need to be in the # sdist (e.g. `version = file: VERSION.txt`) self._referenced_files = set[str]() self.set_defaults = ConfigDiscovery(self) self._set_metadata_defaults(attrs) self.metadata.version = self._normalize_version(self.metadata.version) self._finalize_requires() def _validate_metadata(self): required = {"name"} provided = { key for key in vars(self.metadata) if getattr(self.metadata, key, None) is not None } missing = required - provided if missing: msg = f"Required package metadata is missing: {missing}" raise DistutilsSetupError(msg) def _set_metadata_defaults(self, attrs): """ Fill-in missing metadata fields not supported by distutils. Some fields may have been set by other tools (e.g. pbr). Those fields (vars(self.metadata)) take precedence to supplied attrs. """ for option, default in self._DISTUTILS_UNSUPPORTED_METADATA.items(): vars(self.metadata).setdefault(option, attrs.get(option, default())) @staticmethod def _normalize_version(version): from . import sic if isinstance(version, numbers.Number): # Some people apparently take "version number" too literally :) version = str(version) elif isinstance(version, sic) or version is None: return version normalized = str(Version(version)) if version != normalized: InformationOnly.emit(f"Normalizing '{version}' to '{normalized}'") return normalized return version def _finalize_requires(self): """ Set `metadata.python_requires` and fix environment markers in `install_requires` and `extras_require`. """ if getattr(self, 'python_requires', None): self.metadata.python_requires = self.python_requires self._normalize_requires() self.metadata.install_requires = self.install_requires self.metadata.extras_require = self.extras_require if self.extras_require: for extra in self.extras_require.keys(): # Setuptools allows a weird "<name>:<env markers> syntax for extras extra = extra.split(':')[0] if extra: self.metadata.provides_extras.setdefault(extra) def _normalize_requires(self): """Make sure requirement-related attributes exist and are normalized""" install_requires = getattr(self, "install_requires", None) or [] extras_require = getattr(self, "extras_require", None) or {} # Preserve the "static"-ness of values parsed from config files list_ = _static.List if _static.is_static(install_requires) else list self.install_requires = list_(map(str, _reqs.parse(install_requires))) dict_ = _static.Dict if _static.is_static(extras_require) else dict self.extras_require = dict_( (k, list(map(str, _reqs.parse(v or [])))) for k, v in extras_require.items() ) def _finalize_license_expression(self) -> None: """ Normalize license and license_expression. >>> dist = Distribution({"license_expression": _static.Str("mit aNd gpl-3.0-OR-later")}) >>> _static.is_static(dist.metadata.license_expression) True >>> dist._finalize_license_expression() >>> _static.is_static(dist.metadata.license_expression) # preserve "static-ness" True >>> print(dist.metadata.license_expression) MIT AND GPL-3.0-or-later """ classifiers = self.metadata.get_classifiers() license_classifiers = [cl for cl in classifiers if cl.startswith("License :: ")] license_expr = self.metadata.license_expression if license_expr: str_ = _static.Str if _static.is_static(license_expr) else str normalized = str_(_canonicalize_license_expression(license_expr)) if license_expr != normalized: InformationOnly.emit(f"Normalizing '{license_expr}' to '{normalized}'") self.metadata.license_expression = normalized if license_classifiers: raise InvalidConfigError( "License classifiers have been superseded by license expressions " "(see https://peps.python.org/pep-0639/). Please remove:\n\n" + "\n".join(license_classifiers), ) elif license_classifiers: pypa_guides = "guides/writing-pyproject-toml/#license" SetuptoolsDeprecationWarning.emit( "License classifiers are deprecated.", "Please consider removing the following classifiers in favor of a " "SPDX license expression:\n\n" + "\n".join(license_classifiers), see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", # Warning introduced on 2025-02-17 # TODO: Should we add a due date? It may affect old/unmaintained # packages in the ecosystem and cause problems... ) def _finalize_license_files(self) -> None: """Compute names of all license files which should be included.""" license_files: list[str] | None = self.metadata.license_files patterns = license_files or [] license_file: str | None = self.metadata.license_file if license_file and license_file not in patterns: patterns.append(license_file) if license_files is None and license_file is None: # Default patterns match the ones wheel uses # See https://wheel.readthedocs.io/en/stable/user_guide.html # -> 'Including license files in the generated wheel file' patterns = ['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*'] files = self._expand_patterns(patterns, enforce_match=False) else: # Patterns explicitly given by the user files = self._expand_patterns(patterns, enforce_match=True) self.metadata.license_files = list(unique_everseen(files)) @classmethod def _expand_patterns( cls, patterns: list[str], enforce_match: bool = True ) -> Iterator[str]: """ >>> list(Distribution._expand_patterns(['LICENSE'])) ['LICENSE'] >>> list(Distribution._expand_patterns(['pyproject.toml', 'LIC*'])) ['pyproject.toml', 'LICENSE'] >>> list(Distribution._expand_patterns(['setuptools/**/pyprojecttoml.py'])) ['setuptools/config/pyprojecttoml.py'] """ return ( path.replace(os.sep, "/") for pattern in patterns for path in sorted(cls._find_pattern(pattern, enforce_match)) if not path.endswith('~') and os.path.isfile(path) ) @staticmethod def _find_pattern(pattern: str, enforce_match: bool = True) -> list[str]: r""" >>> Distribution._find_pattern("LICENSE") ['LICENSE'] >>> Distribution._find_pattern("/LICENSE.MIT") Traceback (most recent call last): ... setuptools.errors.InvalidConfigError: Pattern '/LICENSE.MIT' should be relative... >>> Distribution._find_pattern("../LICENSE.MIT") Traceback (most recent call last): ... setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern '../LICENSE.MIT' cannot contain '..'... >>> Distribution._find_pattern("LICEN{CSE*") Traceback (most recent call last): ... setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern 'LICEN{CSE*' contains invalid characters... """ pypa_guides = "specifications/glob-patterns/" if ".." in pattern: SetuptoolsDeprecationWarning.emit( f"Pattern {pattern!r} cannot contain '..'", """ Please ensure the files specified are contained by the root of the Python package (normally marked by `pyproject.toml`). """, see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", due_date=(2026, 3, 20), # Introduced in 2025-03-20 # Replace with InvalidConfigError after deprecation ) if pattern.startswith((os.sep, "/")) or ":\\" in pattern: raise InvalidConfigError( f"Pattern {pattern!r} should be relative and must not start with '/'" ) if re.match(r'^[\w\-\.\/\*\?\[\]]+$', pattern) is None: SetuptoolsDeprecationWarning.emit( "Please provide a valid glob pattern.", "Pattern {pattern!r} contains invalid characters.", pattern=pattern, see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", due_date=(2026, 3, 20), # Introduced in 2025-02-20 ) found = glob(pattern, recursive=True) if enforce_match and not found: SetuptoolsDeprecationWarning.emit( "Cannot find any files for the given pattern.", "Pattern {pattern!r} did not match any files.", pattern=pattern, due_date=(2026, 3, 20), # Introduced in 2025-02-20 # PEP 639 requires us to error, but as a transition period # we will only issue a warning to give people time to prepare. # After the transition, this should raise an InvalidConfigError. ) return found # FIXME: 'Distribution._parse_config_files' is too complex (14) def _parse_config_files(self, filenames=None): # noqa: C901 """ Adapted from distutils.dist.Distribution.parse_config_files, this method provides the same functionality in subtly-improved ways. """ from configparser import ConfigParser # Ignore install directory options if we have a venv ignore_options = ( [] if sys.prefix == sys.base_prefix else [ 'install-base', 'install-platbase', 'install-lib', 'install-platlib', 'install-purelib', 'install-headers', 'install-scripts', 'install-data', 'prefix', 'exec-prefix', 'home', 'user', 'root', ] ) ignore_options = frozenset(ignore_options) if filenames is None: filenames = self.find_config_files() if DEBUG: self.announce("Distribution.parse_config_files():") parser = ConfigParser() parser.optionxform = str for filename in filenames: with open(filename, encoding='utf-8') as reader: if DEBUG: self.announce(" reading {filename}".format(**locals())) parser.read_file(reader) for section in parser.sections(): options = parser.options(section) opt_dict = self.get_option_dict(section) for opt in options: if opt == '__name__' or opt in ignore_options: continue val = parser.get(section, opt) opt = self._enforce_underscore(opt, section) opt = self._enforce_option_lowercase(opt, section) opt_dict[opt] = (filename, val) # Make the ConfigParser forget everything (so we retain # the original filenames that options come from) parser.__init__() if 'global' not in self.command_options: return # If there was a "global" section in the config file, use it # to set Distribution options. for opt, (src, val) in self.command_options['global'].items(): alias = self.negative_opt.get(opt) if alias: val = not strtobool(val) elif opt in ('verbose', 'dry_run'): # ugh! val = strtobool(val) try: setattr(self, alias or opt, val) except ValueError as e: raise DistutilsOptionError(e) from e def _enforce_underscore(self, opt: str, section: str) -> str: if "-" not in opt or self._skip_setupcfg_normalization(section): return opt underscore_opt = opt.replace('-', '_') affected = f"(Affected: {self.metadata.name})." if self.metadata.name else "" SetuptoolsDeprecationWarning.emit( f"Invalid dash-separated key {opt!r} in {section!r} (setup.cfg), " f"please use the underscore name {underscore_opt!r} instead.", f""" Usage of dash-separated {opt!r} will not be supported in future versions. Please use the underscore name {underscore_opt!r} instead. {affected} """, see_docs="userguide/declarative_config.html", due_date=(2026, 3, 3), # Warning initially introduced in 3 Mar 2021 ) return underscore_opt def _enforce_option_lowercase(self, opt: str, section: str) -> str: if opt.islower() or self._skip_setupcfg_normalization(section): return opt lowercase_opt = opt.lower() affected = f"(Affected: {self.metadata.name})." if self.metadata.name else "" SetuptoolsDeprecationWarning.emit( f"Invalid uppercase key {opt!r} in {section!r} (setup.cfg), " f"please use lowercase {lowercase_opt!r} instead.", f""" Usage of uppercase key {opt!r} in {section!r} will not be supported in future versions. Please use lowercase {lowercase_opt!r} instead. {affected} """, see_docs="userguide/declarative_config.html", due_date=(2026, 3, 3), # Warning initially introduced in 6 Mar 2021 ) return lowercase_opt def _skip_setupcfg_normalization(self, section: str) -> bool: skip = ( 'options.extras_require', 'options.data_files', 'options.entry_points', 'options.package_data', 'options.exclude_package_data', ) return section in skip or not self._is_setuptools_section(section) def _is_setuptools_section(self, section: str) -> bool: return ( section == "metadata" or section.startswith("options") or section in _setuptools_commands() ) # FIXME: 'Distribution._set_command_options' is too complex (14) def _set_command_options(self, command_obj, option_dict=None): # noqa: C901 """ Set the options for 'command_obj' from 'option_dict'. Basically this means copying elements of a dictionary ('option_dict') to attributes of an instance ('command'). 'command_obj' must be a Command instance. If 'option_dict' is not supplied, uses the standard option dictionary for this command (from 'self.command_options'). (Adopted from distutils.dist.Distribution._set_command_options) """ command_name = command_obj.get_command_name() if option_dict is None: option_dict = self.get_option_dict(command_name) if DEBUG: self.announce(f" setting options for '{command_name}' command:") for option, (source, value) in option_dict.items(): if DEBUG: self.announce(f" {option} = {value} (from {source})") try: bool_opts = [translate_longopt(o) for o in command_obj.boolean_options] except AttributeError: bool_opts = [] try: neg_opt = command_obj.negative_opt except AttributeError: neg_opt = {} try: is_string = isinstance(value, str) if option in neg_opt and is_string: setattr(command_obj, neg_opt[option], not strtobool(value)) elif option in bool_opts and is_string: setattr(command_obj, option, strtobool(value)) elif hasattr(command_obj, option): setattr(command_obj, option, value) else: raise DistutilsOptionError( f"error in {source}: command '{command_name}' has no such option '{option}'" ) except ValueError as e: raise DistutilsOptionError(e) from e def _get_project_config_files(self, filenames: Iterable[StrPath] | None): """Add default file and split between INI and TOML""" tomlfiles = [] standard_project_metadata = Path(self.src_root or os.curdir, "pyproject.toml") if filenames is not None: parts = partition(lambda f: Path(f).suffix == ".toml", filenames) filenames = list(parts[0]) # 1st element => predicate is False tomlfiles = list(parts[1]) # 2nd element => predicate is True elif standard_project_metadata.exists(): tomlfiles = [standard_project_metadata] return filenames, tomlfiles def parse_config_files( self, filenames: Iterable[StrPath] | None = None, ignore_option_errors: bool = False, ) -> None: """Parses configuration files from various levels and loads configuration. """ inifiles, tomlfiles = self._get_project_config_files(filenames) self._parse_config_files(filenames=inifiles) setupcfg.parse_configuration( self, self.command_options, ignore_option_errors=ignore_option_errors ) for filename in tomlfiles: pyprojecttoml.apply_configuration(self, filename, ignore_option_errors) self._finalize_requires() self._finalize_license_expression() self._finalize_license_files() def fetch_build_eggs( self, requires: _StrOrIter ) -> list[_pkg_resources_Distribution]: """Resolve pre-setup requirements""" from .installer import _fetch_build_eggs return _fetch_build_eggs(self, requires) def finalize_options(self) -> None: """ Allow plugins to apply arbitrary operations to the distribution. Each hook may optionally define a 'order' to influence the order of execution. Smaller numbers go first and the default is 0. """ group = 'setuptools.finalize_distribution_options' def by_order(hook): return getattr(hook, 'order', 0) defined = metadata.entry_points(group=group) filtered = itertools.filterfalse(self._removed, defined) loaded = map(lambda e: e.load(), filtered) for ep in sorted(loaded, key=by_order): ep(self) @staticmethod def _removed(ep): """ When removing an entry point, if metadata is loaded from an older version of Setuptools, that removed entry point will attempt to be loaded and will fail. See #2765 for more details. """ removed = { # removed 2021-09-05 '2to3_doctests', } return ep.name in removed def _finalize_setup_keywords(self): for ep in metadata.entry_points(group='distutils.setup_keywords'): value = getattr(self, ep.name, None) if value is not None: ep.load()(self, ep.name, value) def get_egg_cache_dir(self): from . import windows_support egg_cache_dir = os.path.join(os.curdir, '.eggs') if not os.path.exists(egg_cache_dir): os.mkdir(egg_cache_dir) windows_support.hide_file(egg_cache_dir) readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt') with open(readme_txt_filename, 'w', encoding="utf-8") as f: f.write( 'This directory contains eggs that were downloaded ' 'by setuptools to build, test, and run plug-ins.\n\n' ) f.write( 'This directory caches those eggs to prevent ' 'repeated downloads.\n\n' ) f.write('However, it is safe to delete this directory.\n\n') return egg_cache_dir def fetch_build_egg(self, req): """Fetch an egg needed for building""" from .installer import fetch_build_egg return fetch_build_egg(self, req) def get_command_class(self, command: str) -> type[distutils.cmd.Command]: # type: ignore[override] # Not doing complex overrides yet """Pluggable version of get_command_class()""" if command in self.cmdclass: return self.cmdclass[command] # Special case bdist_wheel so it's never loaded from "wheel" if command == 'bdist_wheel': from .command.bdist_wheel import bdist_wheel return bdist_wheel eps = metadata.entry_points(group='distutils.commands', name=command) for ep in eps: self.cmdclass[command] = cmdclass = ep.load() return cmdclass else: return _Distribution.get_command_class(self, command) def print_commands(self): for ep in metadata.entry_points(group='distutils.commands'): if ep.name not in self.cmdclass: cmdclass = ep.load() self.cmdclass[ep.name] = cmdclass return _Distribution.print_commands(self) def get_command_list(self): for ep in metadata.entry_points(group='distutils.commands'): if ep.name not in self.cmdclass: cmdclass = ep.load() self.cmdclass[ep.name] = cmdclass return _Distribution.get_command_list(self) def include(self, **attrs) -> None: """Add items to distribution that are named in keyword arguments For example, 'dist.include(py_modules=["x"])' would add 'x' to the distribution's 'py_modules' attribute, if it was not already there. Currently, this method only supports inclusion for attributes that are lists or tuples. If you need to add support for adding to other attributes in this or a subclass, you can add an '_include_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'include()'. So, 'dist.include(foo={"bar":"baz"})' will try to call 'dist._include_foo({"bar":"baz"})', which can then handle whatever special inclusion logic is needed. """ for k, v in attrs.items(): include = getattr(self, '_include_' + k, None) if include: include(v) else: self._include_misc(k, v) def exclude_package(self, package: str) -> None: """Remove packages, modules, and extensions in named package""" pfx = package + '.' if self.packages: self.packages = [ p for p in self.packages if p != package and not p.startswith(pfx) ] if self.py_modules: self.py_modules = [ p for p in self.py_modules if p != package and not p.startswith(pfx) ] if self.ext_modules: self.ext_modules = [ p for p in self.ext_modules if p.name != package and not p.name.startswith(pfx) ] def has_contents_for(self, package: str) -> bool: """Return true if 'exclude_package(package)' would do something""" pfx = package + '.' for p in self.iter_distribution_names(): if p == package or p.startswith(pfx): return True return False def _exclude_misc(self, name: str, value: _Sequence) -> None: """Handle 'exclude()' for list/tuple attrs without a special handler""" if not isinstance(value, _sequence): raise DistutilsSetupError( f"{name}: setting must be of type <{_sequence_type_repr}> (got {value!r})" ) try: old = getattr(self, name) except AttributeError as e: raise DistutilsSetupError(f"{name}: No such distribution setting") from e if old is not None and not isinstance(old, _sequence): raise DistutilsSetupError( name + ": this setting cannot be changed via include/exclude" ) elif old: setattr(self, name, [item for item in old if item not in value]) def _include_misc(self, name: str, value: _Sequence) -> None: """Handle 'include()' for list/tuple attrs without a special handler""" if not isinstance(value, _sequence): raise DistutilsSetupError( f"{name}: setting must be of type <{_sequence_type_repr}> (got {value!r})" ) try: old = getattr(self, name) except AttributeError as e: raise DistutilsSetupError(f"{name}: No such distribution setting") from e if old is None: setattr(self, name, value) elif not isinstance(old, _sequence): raise DistutilsSetupError( name + ": this setting cannot be changed via include/exclude" ) else: new = [item for item in value if item not in old] setattr(self, name, list(old) + new) def exclude(self, **attrs) -> None: """Remove items from distribution that are named in keyword arguments For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from the distribution's 'py_modules' attribute. Excluding packages uses the 'exclude_package()' method, so all of the package's contained packages, modules, and extensions are also excluded. Currently, this method only supports exclusion from attributes that are lists or tuples. If you need to add support for excluding from other attributes in this or a subclass, you can add an '_exclude_X' method, where 'X' is the name of the attribute. The method will be called with the value passed to 'exclude()'. So, 'dist.exclude(foo={"bar":"baz"})' will try to call 'dist._exclude_foo({"bar":"baz"})', which can then handle whatever special exclusion logic is needed. """ for k, v in attrs.items(): exclude = getattr(self, '_exclude_' + k, None) if exclude: exclude(v) else: self._exclude_misc(k, v) def _exclude_packages(self, packages: _Sequence) -> None: if not isinstance(packages, _sequence): raise DistutilsSetupError( f"packages: setting must be of type <{_sequence_type_repr}> (got {packages!r})" ) list(map(self.exclude_package, packages)) def _parse_command_opts(self, parser, args): # Remove --with-X/--without-X options when processing command args self.global_options = self.__class__.global_options self.negative_opt = self.__class__.negative_opt # First, expand any aliases command = args[0] aliases = self.get_option_dict('aliases') while command in aliases: _src, alias = aliases[command] del aliases[command] # ensure each alias can expand only once! import shlex args[:1] = shlex.split(alias, True) command = args[0] nargs = _Distribution._parse_command_opts(self, parser, args) # Handle commands that want to consume all remaining arguments cmd_class = self.get_command_class(command) if getattr(cmd_class, 'command_consumes_arguments', None): self.get_option_dict(command)['args'] = ("command line", nargs) if nargs is not None: return [] return nargs def get_cmdline_options(self) -> dict[str, dict[str, str | None]]: """Return a '{cmd: {opt:val}}' map of all command-line options Option names are all long, but do not include the leading '--', and contain dashes rather than underscores. If the option doesn't take an argument (e.g. '--quiet'), the 'val' is 'None'. Note that options provided by config files are intentionally excluded. """ d: dict[str, dict[str, str | None]] = {} for cmd, opts in self.command_options.items(): val: str | None for opt, (src, val) in opts.items(): if src != "command line": continue opt = opt.replace('_', '-') if val == 0: cmdobj = self.get_command_obj(cmd) neg_opt = self.negative_opt.copy() neg_opt.update(getattr(cmdobj, 'negative_opt', {})) for neg, pos in neg_opt.items(): if pos == opt: opt = neg val = None break else: raise AssertionError("Shouldn't be able to get here") elif val == 1: val = None d.setdefault(cmd, {})[opt] = val return d def iter_distribution_names(self): """Yield all packages, modules, and extension names in distribution""" yield from self.packages or () yield from self.py_modules or () for ext in self.ext_modules or (): if isinstance(ext, tuple): name, _buildinfo = ext else: name = ext.name if name.endswith('module'): name = name[:-6] yield name def handle_display_options(self, option_order): """If there were any non-global "display-only" options (--help-commands or the metadata display options) on the command line, display the requested info and return true; else return false. """ import sys if self.help_commands: return _Distribution.handle_display_options(self, option_order) # Stdout may be StringIO (e.g. in tests) if not isinstance(sys.stdout, io.TextIOWrapper): return _Distribution.handle_display_options(self, option_order) # Don't wrap stdout if utf-8 is already the encoding. Provides # workaround for #334. if sys.stdout.encoding.lower() in ('utf-8', 'utf8'): return _Distribution.handle_display_options(self, option_order) # Print metadata in UTF-8 no matter the platform encoding = sys.stdout.encoding sys.stdout.reconfigure(encoding='utf-8') try: return _Distribution.handle_display_options(self, option_order) finally: sys.stdout.reconfigure(encoding=encoding) def run_command(self, command) -> None: self.set_defaults() # Postpone defaults until all explicit configuration is considered # (setup() args, config files, command line and plugins) super().run_command(command) @functools.cache def _setuptools_commands() -> set[str]: try: # Use older API for importlib.metadata compatibility entry_points = metadata.distribution('setuptools').entry_points eps: Iterable[str] = (ep.name for ep in entry_points) except metadata.PackageNotFoundError: # during bootstrapping, distribution doesn't exist eps = [] return {*distutils.command.__all__, *eps} class DistDeprecationWarning(SetuptoolsDeprecationWarning): """Class for warning about deprecations in dist in setuptools. Not ignored by default, unlike DeprecationWarning.""" script.tmpl 0000644 00000000212 15030122015 0006726 0 ustar 00 # EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r __requires__ = %(spec)r __import__('pkg_resources').run_script(%(spec)r, %(script_name)r) unicode_utils.py 0000644 00000006165 15030122015 0007761 0 ustar 00 import sys import unicodedata from configparser import RawConfigParser from .compat import py39 from .warnings import SetuptoolsDeprecationWarning # HFS Plus uses decomposed UTF-8 def decompose(path): if isinstance(path, str): return unicodedata.normalize('NFD', path) try: path = path.decode('utf-8') path = unicodedata.normalize('NFD', path) path = path.encode('utf-8') except UnicodeError: pass # Not UTF-8 return path def filesys_decode(path): """ Ensure that the given path is decoded, ``None`` when no expected encoding works """ if isinstance(path, str): return path fs_enc = sys.getfilesystemencoding() or 'utf-8' candidates = fs_enc, 'utf-8' for enc in candidates: try: return path.decode(enc) except UnicodeDecodeError: continue return None def try_encode(string, enc): "turn unicode encoding into a functional routine" try: return string.encode(enc) except UnicodeEncodeError: return None def _read_utf8_with_fallback(file: str, fallback_encoding=py39.LOCALE_ENCODING) -> str: """ First try to read the file with UTF-8, if there is an error fallback to a different encoding ("locale" by default). Returns the content of the file. Also useful when reading files that might have been produced by an older version of setuptools. """ try: with open(file, "r", encoding="utf-8") as f: return f.read() except UnicodeDecodeError: # pragma: no cover _Utf8EncodingNeeded.emit(file=file, fallback_encoding=fallback_encoding) with open(file, "r", encoding=fallback_encoding) as f: return f.read() def _cfg_read_utf8_with_fallback( cfg: RawConfigParser, file: str, fallback_encoding=py39.LOCALE_ENCODING ) -> None: """Same idea as :func:`_read_utf8_with_fallback`, but for the :meth:`RawConfigParser.read` method. This method may call ``cfg.clear()``. """ try: cfg.read(file, encoding="utf-8") except UnicodeDecodeError: # pragma: no cover _Utf8EncodingNeeded.emit(file=file, fallback_encoding=fallback_encoding) cfg.clear() cfg.read(file, encoding=fallback_encoding) class _Utf8EncodingNeeded(SetuptoolsDeprecationWarning): _SUMMARY = """ `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`. """ _DETAILS = """ Fallback behavior for UTF-8 is considered **deprecated** and future versions of `setuptools` may not implement it. Please encode {file!r} with "utf-8" to ensure future builds will succeed. If this file was produced by `setuptools` itself, cleaning up the cached files and re-building/re-installing the package with a newer version of `setuptools` (e.g. by updating `build-system.requires` in its `pyproject.toml`) might solve the problem. """ # TODO: Add a deadline? # Will we be able to remove this? # The question comes to mind mainly because of sdists that have been produced # by old versions of setuptools and published to PyPI... version.py 0000644 00000000241 15030122015 0006565 0 ustar 00 from ._importlib import metadata try: __version__ = metadata.version('setuptools') or '0.dev0+unknown' except Exception: __version__ = '0.dev0+unknown' namespaces.py 0000644 00000006143 15030122015 0007226 0 ustar 00 import itertools import os from .compat import py312 from distutils import log flatten = itertools.chain.from_iterable class Installer: nspkg_ext = '-nspkg.pth' def install_namespaces(self) -> None: nsp = self._get_all_ns_packages() if not nsp: return filename = self._get_nspkg_file() self.outputs.append(filename) log.info("Installing %s", filename) lines = map(self._gen_nspkg_line, nsp) if self.dry_run: # always generate the lines, even in dry run list(lines) return with open(filename, 'wt', encoding=py312.PTH_ENCODING) as f: # Python<3.13 requires encoding="locale" instead of "utf-8" # See: python/cpython#77102 f.writelines(lines) def uninstall_namespaces(self) -> None: filename = self._get_nspkg_file() if not os.path.exists(filename): return log.info("Removing %s", filename) os.remove(filename) def _get_nspkg_file(self): filename, _ = os.path.splitext(self._get_target()) return filename + self.nspkg_ext def _get_target(self): return self.target _nspkg_tmpl = ( "import sys, types, os", "p = os.path.join(%(root)s, *%(pth)r)", "importlib = __import__('importlib.util')", "__import__('importlib.machinery')", ( "m = " "sys.modules.setdefault(%(pkg)r, " "importlib.util.module_from_spec(" "importlib.machinery.PathFinder.find_spec(%(pkg)r, " "[os.path.dirname(p)])))" ), ("m = m or sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))"), "mp = (m or []) and m.__dict__.setdefault('__path__',[])", "(p not in mp) and mp.append(p)", ) "lines for the namespace installer" _nspkg_tmpl_multi = ('m and setattr(sys.modules[%(parent)r], %(child)r, m)',) "additional line(s) when a parent package is indicated" def _get_root(self): return "sys._getframe(1).f_locals['sitedir']" def _gen_nspkg_line(self, pkg): pth = tuple(pkg.split('.')) root = self._get_root() tmpl_lines = self._nspkg_tmpl parent, sep, child = pkg.rpartition('.') if parent: tmpl_lines += self._nspkg_tmpl_multi return ';'.join(tmpl_lines) % locals() + '\n' def _get_all_ns_packages(self): """Return sorted list of all package namespaces""" pkgs = self.distribution.namespace_packages or [] return sorted(set(flatten(map(self._pkg_names, pkgs)))) @staticmethod def _pkg_names(pkg): """ Given a namespace package, yield the components of that package. >>> names = Installer._pkg_names('a.b.c') >>> set(names) == set(['a', 'a.b', 'a.b.c']) True """ parts = pkg.split('.') while parts: yield '.'.join(parts) parts.pop() class DevelopInstaller(Installer): def _get_root(self): return repr(str(self.egg_path)) def _get_target(self): return self.egg_link windows_support.py 0000644 00000001326 15030122015 0010373 0 ustar 00 import platform def windows_only(func): if platform.system() != 'Windows': return lambda *args, **kwargs: None return func @windows_only def hide_file(path: str) -> None: """ Set the hidden attribute on a file or directory. From https://stackoverflow.com/questions/19622133/ `path` must be text. """ import ctypes import ctypes.wintypes SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD SetFileAttributes.restype = ctypes.wintypes.BOOL FILE_ATTRIBUTE_HIDDEN = 0x02 ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN) if not ret: raise ctypes.WinError() gui-32.exe 0000644 00000027000 15030122015 0006241 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ �z 2�da�da�da�c�a�dasee`�dase�a�dasea`�dase``�daseg`�da�ce`�da�ea�da�d``�da�d�a�da�df`�daRich�da PE L �'hd � $ � 0 @ p @� 6 � P � ` � �2 2 @ 0 .text � `.rdata � 0 @ @.data � @ ( @ �.rsrc � P * @ @.reloc � ` , @ B ��C@ �����������U��} u�@@ ��t j P� 0@ � ]���������������U��EPj �u �u����p�0� 1@ ��]�������������U��j�u �u� �� ]������������U���S�]VW�K��C��u�+�j�] P�x0@ �ȃ��M�3��"�q3ɉM���~S�U�<\uG�&<"u ��~Wj\V� �M��� �U�3��\F�3��A�F�M�;�| �~Wj\V�t �� ��E�_f�" ^[��]�������������U��� �@@ 3ʼnE��E�����E �����������h Pj �0@ j h� jj jh �������P� 0@ j h ������QP�0@ �������Q�A��u�+ʍ������������;�v�8.t� ������H;�w퍍����� If��A�I��u���1@ ���1@ �A��1@ W�A������j P� �������u2������Ph�1@ j��0@ ��P����� �G_�M�3��� ��]�Vh ������PW�� ������W��� ��������H@;�s���t �� t�� u�j� ������h�1@ P� 1@ �� ��t&��1@ �~�1@ �������1@ fօ����������������Q D �A��u�S+�jQ�x0@ �������������3ۉ���������Q�����1@ �� ��t�FFP�1@ ����u� � �F���������� ��P�1@ �������t��tm��������\uC�ƀ�"u0�Ã�����u 3��������3��9�����EȈ�������tSj\W�� �� �3ۊ��������o����G�g�����tSj\W� �� �3ۋ��������@� G������ �����<�t-�P�1@ ����t�FFP�1@ ����u�> ����������;�NJ��t ��@��/u�\���u�5h0@ ������P������P������P����PW�փ����� �� ������\�� ������P������P������P����P������P�֍��������Q�A��u�+ʊ� ������ �����Ӏ�\u�Q�3���\��������\t f � ������;�r � H�8\u�j W������P����P������P�l0@ �=x0@ jh �����h PV������1@ �������(�,�x0@ jh ��h �����WV�1@ �=x0@ ����u/�3h�1@ j��0@ ��P�r����� �F[^_�M�3��Q ��]Ë�������j� �����A�P��V����~�����{� �� 9���~*���� ������4��R����C����;�|勵���������P�3����� ����9���~/���� � ������4������C����;�|勵����} � t@���V��0@ ��Vh�1@ j��0@ ��P�l����� � [^_�M�3��I ��]ËQ�A��u�����+ʺ �y;�~0��� ��Y @ �A��u�+�GB�;�|ߋ���������x0@ jW��Vh�1@ P����� ���N��F��u�� +�;�~O @ ff � ����4������h�1@ P�d ����� � ��Q D �A��u�+�FG�;�|�W�Dž�� jh@ ����Dž����D f�����f�����f�����f�����f�����f�����f�����f������0@ �����P������Pj j j jj j ����j �0@ ��u,hP1@ j��0@ ��P������3�[^_�M�3�� ��]Ë����j�������@@ �0@ ����P������ 0@ ��u,hl1@ j��0@ ��P�v�����3�[^_�M�3��V ��]ËM�����3�[^_�? ��]����������U��EPj �u j��u�����p��Q��0@ ���� ��H�]�; @@ u��y Vj�v �V P� �D ��� j�0� �� ^��ts���l h"@ �n � P�> YY��uQ� �c ��t h� @ � Y�) �$ � �� P�G Y�� ��t� �� �T ��u�j�- ��� 3��� � P� Y�jh�5@ �/ j� Y���P 2ۈ]�e� �� �Eܡ<C@ 3�A;��/ ��uI� <C@ h<1@ h01@ � YY��t�E������� �� h,1@ h$1@ �[ YY�<C@ ��و]�u��� Y�i ��3�9>tV�9 Y��t�6WjW�� 1@ ���G ��9>tV� Y��t�6�$ Y�� ���� �0� WV�0�q����� ���. ��tk��u�� j j�{ YY�E��������5�M�� �E�QP�{ YYËe��� ��t2�}� u� �E������E�M�d� Y_^[��j� V�j �u��h ��� �t���U��j �D0@ �u�H0@ h ��@0@ P�<0@ ]�U���$ j�80@ ��tjY�)� A@ � A@ �A@ � A@ �5A@ �= A@ f�8A@ f� ,A@ f� A@ f�A@ f�% A@ f�-�@@ ��0A@ �E �$A@ �E�(A@ �E�4A@ ������p@@ �(A@ �,@@ � @@ ��$@@ �0@@ jXk� ǀ4@@ jXk� � @@ �L�jX�� � @@ �L�h2@ �����U��EV�H<��A�Q��Ak�(�;�t�M ;J r �BB ;�r ��(;�u�3�^]Ë��V� ��t d� �@C@ �P�;�t3�������u�2�^ð^�U��} u�DC@ �v �r ��u2�]��e ��u j �Z Y��]�U��=EC@ t�]�V�u��t��ub� ��t&��u"hHC@ � Y��uhTC@ �y Y��t+2��0��� HC@ � LC@ � PC@ � TC@ � XC@ � \C@ �EC@ �^]�j�/ �jh 6@ �K �e� �MZ f9 @ u]�< @ �� @ PE uL� f9� @ u>�E� @ +�PQ�|���YY��t'�x$ |!�E������� �E� 3Ɂ8 �����Ëe��E�����2��M�d� Y_^[��U��� ��t�} u 3��@C@ �]�U��=DC@ t�} u�u� �u� YY�]�U��=HC@ ��uu�T � hHC@ �B Y��Y���#E]�U��u������Y���H]�U����e� �E�e� P�(0@ �E�3E�E��,0@ 1E��00@ 1E��E�P�40@ �E�M�3E�3E�3��Ë @@ VW�N�@�� ��;�t��u&�����;�u�O�@����u G �� ȉ @@ ��_� @@ ^�3��3�@ø @ �h`C@ �$0@ ð�h h j �g �� ��u�j�? �� �hC@ ���H�$�H����H��H�3�9 @@ ��ø�C@ ø�C@ �U���$ Sj�80@ ��t�M�)j� �$� �����j P�F �� ��������������������������|�����x���f������f������f��t���f��p���f��l���f��h�����������E�������E������Dž��� �@�jP�������E�j P� �E�� �E� @�E� �E�� 0@ j �X��ۍE��E������ۉE���D0@ �E�P�H0@ ��u ��uj� Y[���e���j �L0@ ��t3�MZ f9u)�H<ȁ9PE u � f9Au�ytv ��� ���2��h�!@ �D0@ �U��VW�}�7�>csm�u%�~u �F= �t =!�t="�t= @�t_3�^]� �� �0�w�� �0�\ ̃%pC@ �SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[�SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[������h�"@ d�5 �D$�l$�l$+�SVW�@@ 1E�3�P�e�u��E��E������E��E�d� �U��V�u�6� �u��u�u Vh2@ h@@ � �� ^]�U��%tC@ ��$� @@ j �80@ ���� �e� 3�SVW3ɍ}�S���[���w�O3ɉW �E܋}�E�Genu�E�5ineI�E��E�5ntel�E�3�@S���[��]܉�E� E� ljs�K�S uC�E�%�?�=� t#=` t =p t=P t=` t=p u�=xC@ ���=xC@ ��=xC@ �M�jX�M�9E�|03�S���[��]܉�s�K�M��S �]�� t���=xC@ ��]�@@ ���tC@ �@@ �� �� ���tC@ �@@ �� ty�� tq3�ЉE�U�E�M�j^#�;�uW�@@ ���tC@ �@@ �� t;�� �tC@ �@@ � �#�;�u �E�� �M�#�;�u � @@ @�5tC@ _^[3���3�9@@ ���%T0@ �%X0@ �%`0@ �%\0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%1@ �%�0@ �%�0@ �%�0@ �%�0@ �%t0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ U��Q�=tC@ |f�}� �t �}� �uT�]��E���?��t?� u�� ��é t*� u�� ��é u�� ��é u�� ��ø� ��ËE�� 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � @ �@ @@ �@ failed to create process. failed to get exit code from process. %s %s -script.pyw Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s @@ p@@ � @@ 3@ 1@ 3@ 1@ �'hd l `3 ` �" �� 3 , H3 � � �" (# �# $ $ $ $ c$ k$ @ �" N% x � .text$mn 0 .idata$5 1 .00cfg $1 .CRT$XCA (1 .CRT$XCAA ,1 .CRT$XCZ 01 .CRT$XIA 41 .CRT$XIAA 81 .CRT$XIAC <1 .CRT$XIZ @1 .CRT$XPA D1 .CRT$XPZ H1 .CRT$XTA L1 .CRT$XTZ P1 � .rdata 3 .rdata$sxdata 3 \ .rdata$voltmd `3 l .rdata$zzzdbg �5 .rtc$IAA �5 .rtc$IZZ �5 .rtc$TAA �5 .rtc$TZZ �5 < .xdata$x 6 � .idata$2 �6 .idata$3 �6 .idata$4 8 � .idata$6 @ .data @ x .bss P ` .rsrc$01 `P � .rsrc$02 ���� ��� ����,@ @@ ���� ��� ����N @ a @ �6 �8 0 L7 ,9 T0 l7 �; t0 `7 �; h0 �7 �; �0 �7 < �0 8 4< 1 �7 V< �0 x7 v< �0 �7 �< �0 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � CreateFileA dGetFinalPathNameByHandleA �WaitForSingleObject QGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll H memset __current_exception __current_exception_context 5 _except_handler4_common VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace B _seh_filter_exe D _set_app_type . __setusermatherr _configure_narrow_argv 5 _initialize_narrow_environment * _get_initial_narrow_environment 8 _initterm 9 _initterm_e X exit % _exit T _set_fmode _cexit _c_exit ? _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 6 _initialize_onexit_table > _register_onexit_function _crt_atexit _controlfp_s j terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �UnhandledExceptionFilter �SetUnhandledExceptionFilter ,GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent mQueryPerformanceCounter -GetCurrentProcessId 1GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW ��DN�@����� � 0 � H `P } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 00'0[0�0J1u1�1�1�12 222:2�2�2�2�2�2�2+3>3g3&494s4M5S5w5�5�5�5�5�5�6�6�6>7I7�7�7(8P8Y8a8�8�8�8�8�8!949x9�9:3:H:M:R:s:x:�:�:�;�;�;�;�;�;�;�;�;�;�;�; <<<< <#<+<3<;<G<P<U<[<e<o<<�<�<�<=4=g=�=�=�=�=�=�=�=�=�=�=>>> >*>�>�>�>�>?'?0?=?S?�?�?�?�?�? � 0 00%0�011;1z1�1�1�1�1�122*2A2^2�2�2�2�2�2u3~3�3�3�3�3�3�3�3+444=4K4T4v4}4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�455555 5&5,52585>5D5J5T5 0 ( 1(1418122L2P2X2�2�2�5�566 msvc.py 0000644 00000121237 15030122015 0006061 0 ustar 00 """ Environment info about Microsoft Compilers. >>> getfixture('windows_only') >>> ei = EnvironmentInfo('amd64') """ from __future__ import annotations import contextlib import itertools import json import os import os.path import platform from typing import TYPE_CHECKING, TypedDict from more_itertools import unique_everseen import distutils.errors if TYPE_CHECKING: from typing_extensions import LiteralString, NotRequired # https://github.com/python/mypy/issues/8166 if not TYPE_CHECKING and platform.system() == 'Windows': import winreg from os import environ else: # Mock winreg and environ so the module can be imported on this platform. class winreg: HKEY_USERS = None HKEY_CURRENT_USER = None HKEY_LOCAL_MACHINE = None HKEY_CLASSES_ROOT = None environ: dict[str, str] = dict() class PlatformInfo: """ Current and Target Architectures information. Parameters ---------- arch: str Target architecture. """ current_cpu = environ.get('processor_architecture', '').lower() def __init__(self, arch) -> None: self.arch = arch.lower().replace('x64', 'amd64') @property def target_cpu(self): """ Return Target CPU architecture. Return ------ str Target CPU """ return self.arch[self.arch.find('_') + 1 :] def target_is_x86(self): """ Return True if target CPU is x86 32 bits.. Return ------ bool CPU is x86 32 bits """ return self.target_cpu == 'x86' def current_is_x86(self): """ Return True if current CPU is x86 32 bits.. Return ------ bool CPU is x86 32 bits """ return self.current_cpu == 'x86' def current_dir(self, hidex86=False, x64=False) -> str: """ Current platform specific subfolder. Parameters ---------- hidex86: bool return '' and not '\x86' if architecture is x86. x64: bool return '\x64' and not '\amd64' if architecture is amd64. Return ------ str subfolder: '\target', or '' (see hidex86 parameter) """ return ( '' if (self.current_cpu == 'x86' and hidex86) else r'\x64' if (self.current_cpu == 'amd64' and x64) else rf'\{self.current_cpu}' ) def target_dir(self, hidex86=False, x64=False) -> str: r""" Target platform specific subfolder. Parameters ---------- hidex86: bool return '' and not '\x86' if architecture is x86. x64: bool return '\x64' and not '\amd64' if architecture is amd64. Return ------ str subfolder: '\current', or '' (see hidex86 parameter) """ return ( '' if (self.target_cpu == 'x86' and hidex86) else r'\x64' if (self.target_cpu == 'amd64' and x64) else rf'\{self.target_cpu}' ) def cross_dir(self, forcex86=False): r""" Cross platform specific subfolder. Parameters ---------- forcex86: bool Use 'x86' as current architecture even if current architecture is not x86. Return ------ str subfolder: '' if target architecture is current architecture, '\current_target' if not. """ current = 'x86' if forcex86 else self.current_cpu return ( '' if self.target_cpu == current else self.target_dir().replace('\\', f'\\{current}_') ) class RegistryInfo: """ Microsoft Visual Studio related registry information. Parameters ---------- platform_info: PlatformInfo "PlatformInfo" instance. """ HKEYS = ( winreg.HKEY_USERS, winreg.HKEY_CURRENT_USER, winreg.HKEY_LOCAL_MACHINE, winreg.HKEY_CLASSES_ROOT, ) def __init__(self, platform_info) -> None: self.pi = platform_info @property def visualstudio(self) -> str: """ Microsoft Visual Studio root registry key. Return ------ str Registry key """ return 'VisualStudio' @property def sxs(self): """ Microsoft Visual Studio SxS registry key. Return ------ str Registry key """ return os.path.join(self.visualstudio, 'SxS') @property def vc(self): """ Microsoft Visual C++ VC7 registry key. Return ------ str Registry key """ return os.path.join(self.sxs, 'VC7') @property def vs(self): """ Microsoft Visual Studio VS7 registry key. Return ------ str Registry key """ return os.path.join(self.sxs, 'VS7') @property def vc_for_python(self) -> str: """ Microsoft Visual C++ for Python registry key. Return ------ str Registry key """ return r'DevDiv\VCForPython' @property def microsoft_sdk(self) -> str: """ Microsoft SDK registry key. Return ------ str Registry key """ return 'Microsoft SDKs' @property def windows_sdk(self): """ Microsoft Windows/Platform SDK registry key. Return ------ str Registry key """ return os.path.join(self.microsoft_sdk, 'Windows') @property def netfx_sdk(self): """ Microsoft .NET Framework SDK registry key. Return ------ str Registry key """ return os.path.join(self.microsoft_sdk, 'NETFXSDK') @property def windows_kits_roots(self) -> str: """ Microsoft Windows Kits Roots registry key. Return ------ str Registry key """ return r'Windows Kits\Installed Roots' def microsoft(self, key, x86=False): """ Return key in Microsoft software registry. Parameters ---------- key: str Registry key path where look. x86: str Force x86 software registry. Return ------ str Registry key """ node64 = '' if self.pi.current_is_x86() or x86 else 'Wow6432Node' return os.path.join('Software', node64, 'Microsoft', key) def lookup(self, key, name): """ Look for values in registry in Microsoft software registry. Parameters ---------- key: str Registry key path where look. name: str Value name to find. Return ------ str value """ key_read = winreg.KEY_READ openkey = winreg.OpenKey closekey = winreg.CloseKey ms = self.microsoft for hkey in self.HKEYS: bkey = None try: bkey = openkey(hkey, ms(key), 0, key_read) except OSError: if not self.pi.current_is_x86(): try: bkey = openkey(hkey, ms(key, True), 0, key_read) except OSError: continue else: continue try: return winreg.QueryValueEx(bkey, name)[0] except OSError: pass finally: if bkey: closekey(bkey) return None class SystemInfo: """ Microsoft Windows and Visual Studio related system information. Parameters ---------- registry_info: RegistryInfo "RegistryInfo" instance. vc_ver: float Required Microsoft Visual C++ version. """ # Variables and properties in this class use originals CamelCase variables # names from Microsoft source files for more easy comparison. WinDir = environ.get('WinDir', '') ProgramFiles = environ.get('ProgramFiles', '') ProgramFilesx86 = environ.get('ProgramFiles(x86)', ProgramFiles) def __init__(self, registry_info, vc_ver=None) -> None: self.ri = registry_info self.pi = self.ri.pi self.known_vs_paths = self.find_programdata_vs_vers() # Except for VS15+, VC version is aligned with VS version self.vs_ver = self.vc_ver = vc_ver or self._find_latest_available_vs_ver() def _find_latest_available_vs_ver(self): """ Find the latest VC version Return ------ float version """ reg_vc_vers = self.find_reg_vs_vers() if not (reg_vc_vers or self.known_vs_paths): raise distutils.errors.DistutilsPlatformError( 'No Microsoft Visual C++ version found' ) vc_vers = set(reg_vc_vers) vc_vers.update(self.known_vs_paths) return sorted(vc_vers)[-1] def find_reg_vs_vers(self): """ Find Microsoft Visual Studio versions available in registry. Return ------ list of float Versions """ ms = self.ri.microsoft vckeys = (self.ri.vc, self.ri.vc_for_python, self.ri.vs) vs_vers = [] for hkey, key in itertools.product(self.ri.HKEYS, vckeys): try: bkey = winreg.OpenKey(hkey, ms(key), 0, winreg.KEY_READ) except OSError: continue with bkey: subkeys, values, _ = winreg.QueryInfoKey(bkey) for i in range(values): with contextlib.suppress(ValueError): ver = float(winreg.EnumValue(bkey, i)[0]) if ver not in vs_vers: vs_vers.append(ver) for i in range(subkeys): with contextlib.suppress(ValueError): ver = float(winreg.EnumKey(bkey, i)) if ver not in vs_vers: vs_vers.append(ver) return sorted(vs_vers) def find_programdata_vs_vers(self) -> dict[float, str]: r""" Find Visual studio 2017+ versions from information in "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances". Return ------ dict float version as key, path as value. """ vs_versions: dict[float, str] = {} instances_dir = r'C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances' try: hashed_names = os.listdir(instances_dir) except OSError: # Directory not exists with all Visual Studio versions return vs_versions for name in hashed_names: try: # Get VS installation path from "state.json" file state_path = os.path.join(instances_dir, name, 'state.json') with open(state_path, 'rt', encoding='utf-8') as state_file: state = json.load(state_file) vs_path = state['installationPath'] # Raises OSError if this VS installation does not contain VC os.listdir(os.path.join(vs_path, r'VC\Tools\MSVC')) # Store version and path vs_versions[self._as_float_version(state['installationVersion'])] = ( vs_path ) except (OSError, KeyError): # Skip if "state.json" file is missing or bad format continue return vs_versions @staticmethod def _as_float_version(version): """ Return a string version as a simplified float version (major.minor) Parameters ---------- version: str Version. Return ------ float version """ return float('.'.join(version.split('.')[:2])) @property def VSInstallDir(self): """ Microsoft Visual Studio directory. Return ------ str path """ # Default path default = os.path.join( self.ProgramFilesx86, f'Microsoft Visual Studio {self.vs_ver:0.1f}' ) # Try to get path from registry, if fail use default path return self.ri.lookup(self.ri.vs, f'{self.vs_ver:0.1f}') or default @property def VCInstallDir(self): """ Microsoft Visual C++ directory. Return ------ str path """ path = self._guess_vc() or self._guess_vc_legacy() if not os.path.isdir(path): msg = 'Microsoft Visual C++ directory not found' raise distutils.errors.DistutilsPlatformError(msg) return path def _guess_vc(self): """ Locate Visual C++ for VS2017+. Return ------ str path """ if self.vs_ver <= 14.0: return '' try: # First search in known VS paths vs_dir = self.known_vs_paths[self.vs_ver] except KeyError: # Else, search with path from registry vs_dir = self.VSInstallDir guess_vc = os.path.join(vs_dir, r'VC\Tools\MSVC') # Subdir with VC exact version as name try: # Update the VC version with real one instead of VS version vc_ver = os.listdir(guess_vc)[-1] self.vc_ver = self._as_float_version(vc_ver) return os.path.join(guess_vc, vc_ver) except (OSError, IndexError): return '' def _guess_vc_legacy(self): """ Locate Visual C++ for versions prior to 2017. Return ------ str path """ default = os.path.join( self.ProgramFilesx86, rf'Microsoft Visual Studio {self.vs_ver:0.1f}\VC', ) # Try to get "VC++ for Python" path from registry as default path reg_path = os.path.join(self.ri.vc_for_python, f'{self.vs_ver:0.1f}') python_vc = self.ri.lookup(reg_path, 'installdir') default_vc = os.path.join(python_vc, 'VC') if python_vc else default # Try to get path from registry, if fail use default path return self.ri.lookup(self.ri.vc, f'{self.vs_ver:0.1f}') or default_vc @property def WindowsSdkVersion(self) -> tuple[LiteralString, ...]: """ Microsoft Windows SDK versions for specified MSVC++ version. Return ------ tuple of str versions """ if self.vs_ver <= 9.0: return '7.0', '6.1', '6.0a' elif self.vs_ver == 10.0: return '7.1', '7.0a' elif self.vs_ver == 11.0: return '8.0', '8.0a' elif self.vs_ver == 12.0: return '8.1', '8.1a' elif self.vs_ver >= 14.0: return '10.0', '8.1' return () @property def WindowsSdkLastVersion(self): """ Microsoft Windows SDK last version. Return ------ str version """ return self._use_last_dir_name(os.path.join(self.WindowsSdkDir, 'lib')) @property def WindowsSdkDir(self) -> str | None: # noqa: C901 # is too complex (12) # FIXME """ Microsoft Windows SDK directory. Return ------ str path """ sdkdir: str | None = '' for ver in self.WindowsSdkVersion: # Try to get it from registry loc = os.path.join(self.ri.windows_sdk, f'v{ver}') sdkdir = self.ri.lookup(loc, 'installationfolder') if sdkdir: break if not sdkdir or not os.path.isdir(sdkdir): # Try to get "VC++ for Python" version from registry path = os.path.join(self.ri.vc_for_python, f'{self.vc_ver:0.1f}') install_base = self.ri.lookup(path, 'installdir') if install_base: sdkdir = os.path.join(install_base, 'WinSDK') if not sdkdir or not os.path.isdir(sdkdir): # If fail, use default new path for ver in self.WindowsSdkVersion: intver = ver[: ver.rfind('.')] path = rf'Microsoft SDKs\Windows Kits\{intver}' d = os.path.join(self.ProgramFiles, path) if os.path.isdir(d): sdkdir = d if not sdkdir or not os.path.isdir(sdkdir): # If fail, use default old path for ver in self.WindowsSdkVersion: path = rf'Microsoft SDKs\Windows\v{ver}' d = os.path.join(self.ProgramFiles, path) if os.path.isdir(d): sdkdir = d if not sdkdir: # If fail, use Platform SDK sdkdir = os.path.join(self.VCInstallDir, 'PlatformSDK') return sdkdir @property def WindowsSDKExecutablePath(self): """ Microsoft Windows SDK executable directory. Return ------ str path """ # Find WinSDK NetFx Tools registry dir name if self.vs_ver <= 11.0: netfxver = 35 arch = '' else: netfxver = 40 hidex86 = True if self.vs_ver <= 12.0 else False arch = self.pi.current_dir(x64=True, hidex86=hidex86).replace('\\', '-') fx = f'WinSDK-NetFx{netfxver}Tools{arch}' # list all possibles registry paths regpaths = [] if self.vs_ver >= 14.0: for ver in self.NetFxSdkVersion: regpaths += [os.path.join(self.ri.netfx_sdk, ver, fx)] for ver in self.WindowsSdkVersion: regpaths += [os.path.join(self.ri.windows_sdk, f'v{ver}A', fx)] # Return installation folder from the more recent path for path in regpaths: execpath = self.ri.lookup(path, 'installationfolder') if execpath: return execpath return None @property def FSharpInstallDir(self): """ Microsoft Visual F# directory. Return ------ str path """ path = os.path.join(self.ri.visualstudio, rf'{self.vs_ver:0.1f}\Setup\F#') return self.ri.lookup(path, 'productdir') or '' @property def UniversalCRTSdkDir(self): """ Microsoft Universal CRT SDK directory. Return ------ str path """ # Set Kit Roots versions for specified MSVC++ version vers = ('10', '81') if self.vs_ver >= 14.0 else () # Find path of the more recent Kit for ver in vers: sdkdir = self.ri.lookup(self.ri.windows_kits_roots, f'kitsroot{ver}') if sdkdir: return sdkdir or '' return None @property def UniversalCRTSdkLastVersion(self): """ Microsoft Universal C Runtime SDK last version. Return ------ str version """ return self._use_last_dir_name(os.path.join(self.UniversalCRTSdkDir, 'lib')) @property def NetFxSdkVersion(self): """ Microsoft .NET Framework SDK versions. Return ------ tuple of str versions """ # Set FxSdk versions for specified VS version return ( ('4.7.2', '4.7.1', '4.7', '4.6.2', '4.6.1', '4.6', '4.5.2', '4.5.1', '4.5') if self.vs_ver >= 14.0 else () ) @property def NetFxSdkDir(self): """ Microsoft .NET Framework SDK directory. Return ------ str path """ sdkdir = '' for ver in self.NetFxSdkVersion: loc = os.path.join(self.ri.netfx_sdk, ver) sdkdir = self.ri.lookup(loc, 'kitsinstallationfolder') if sdkdir: break return sdkdir @property def FrameworkDir32(self): """ Microsoft .NET Framework 32bit directory. Return ------ str path """ # Default path guess_fw = os.path.join(self.WinDir, r'Microsoft.NET\Framework') # Try to get path from registry, if fail use default path return self.ri.lookup(self.ri.vc, 'frameworkdir32') or guess_fw @property def FrameworkDir64(self): """ Microsoft .NET Framework 64bit directory. Return ------ str path """ # Default path guess_fw = os.path.join(self.WinDir, r'Microsoft.NET\Framework64') # Try to get path from registry, if fail use default path return self.ri.lookup(self.ri.vc, 'frameworkdir64') or guess_fw @property def FrameworkVersion32(self) -> tuple[str, ...]: """ Microsoft .NET Framework 32bit versions. Return ------ tuple of str versions """ return self._find_dot_net_versions(32) @property def FrameworkVersion64(self) -> tuple[str, ...]: """ Microsoft .NET Framework 64bit versions. Return ------ tuple of str versions """ return self._find_dot_net_versions(64) def _find_dot_net_versions(self, bits) -> tuple[str, ...]: """ Find Microsoft .NET Framework versions. Parameters ---------- bits: int Platform number of bits: 32 or 64. Return ------ tuple of str versions """ # Find actual .NET version in registry reg_ver = self.ri.lookup(self.ri.vc, f'frameworkver{bits}') dot_net_dir = getattr(self, f'FrameworkDir{bits}') ver = reg_ver or self._use_last_dir_name(dot_net_dir, 'v') or '' # Set .NET versions for specified MSVC++ version if self.vs_ver >= 12.0: return ver, 'v4.0' elif self.vs_ver >= 10.0: return 'v4.0.30319' if ver.lower()[:2] != 'v4' else ver, 'v3.5' elif self.vs_ver == 9.0: return 'v3.5', 'v2.0.50727' elif self.vs_ver == 8.0: return 'v3.0', 'v2.0.50727' return () @staticmethod def _use_last_dir_name(path, prefix=''): """ Return name of the last dir in path or '' if no dir found. Parameters ---------- path: str Use dirs in this path prefix: str Use only dirs starting by this prefix Return ------ str name """ matching_dirs = ( dir_name for dir_name in reversed(os.listdir(path)) if os.path.isdir(os.path.join(path, dir_name)) and dir_name.startswith(prefix) ) return next(matching_dirs, None) or '' class _EnvironmentDict(TypedDict): include: str lib: str libpath: str path: str py_vcruntime_redist: NotRequired[str | None] class EnvironmentInfo: """ Return environment variables for specified Microsoft Visual C++ version and platform : Lib, Include, Path and libpath. This function is compatible with Microsoft Visual C++ 9.0 to 14.X. Script created by analysing Microsoft environment configuration files like "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ... Parameters ---------- arch: str Target architecture. vc_ver: float Required Microsoft Visual C++ version. If not set, autodetect the last version. vc_min_ver: float Minimum Microsoft Visual C++ version. """ # Variables and properties in this class use originals CamelCase variables # names from Microsoft source files for more easy comparison. def __init__(self, arch, vc_ver=None, vc_min_ver=0) -> None: self.pi = PlatformInfo(arch) self.ri = RegistryInfo(self.pi) self.si = SystemInfo(self.ri, vc_ver) if self.vc_ver < vc_min_ver: err = 'No suitable Microsoft Visual C++ version found' raise distutils.errors.DistutilsPlatformError(err) @property def vs_ver(self): """ Microsoft Visual Studio. Return ------ float version """ return self.si.vs_ver @property def vc_ver(self): """ Microsoft Visual C++ version. Return ------ float version """ return self.si.vc_ver @property def VSTools(self): """ Microsoft Visual Studio Tools. Return ------ list of str paths """ paths = [r'Common7\IDE', r'Common7\Tools'] if self.vs_ver >= 14.0: arch_subdir = self.pi.current_dir(hidex86=True, x64=True) paths += [r'Common7\IDE\CommonExtensions\Microsoft\TestWindow'] paths += [r'Team Tools\Performance Tools'] paths += [rf'Team Tools\Performance Tools{arch_subdir}'] return [os.path.join(self.si.VSInstallDir, path) for path in paths] @property def VCIncludes(self): """ Microsoft Visual C++ & Microsoft Foundation Class Includes. Return ------ list of str paths """ return [ os.path.join(self.si.VCInstallDir, 'Include'), os.path.join(self.si.VCInstallDir, r'ATLMFC\Include'), ] @property def VCLibraries(self): """ Microsoft Visual C++ & Microsoft Foundation Class Libraries. Return ------ list of str paths """ if self.vs_ver >= 15.0: arch_subdir = self.pi.target_dir(x64=True) else: arch_subdir = self.pi.target_dir(hidex86=True) paths = [f'Lib{arch_subdir}', rf'ATLMFC\Lib{arch_subdir}'] if self.vs_ver >= 14.0: paths += [rf'Lib\store{arch_subdir}'] return [os.path.join(self.si.VCInstallDir, path) for path in paths] @property def VCStoreRefs(self): """ Microsoft Visual C++ store references Libraries. Return ------ list of str paths """ if self.vs_ver < 14.0: return [] return [os.path.join(self.si.VCInstallDir, r'Lib\store\references')] @property def VCTools(self): """ Microsoft Visual C++ Tools. Return ------ list of str paths When host CPU is ARM, the tools should be found for ARM. >>> getfixture('windows_only') >>> mp = getfixture('monkeypatch') >>> mp.setattr(PlatformInfo, 'current_cpu', 'arm64') >>> ei = EnvironmentInfo(arch='irrelevant') >>> paths = ei.VCTools >>> any('HostARM64' in path for path in paths) True """ si = self.si tools = [os.path.join(si.VCInstallDir, 'VCPackages')] forcex86 = True if self.vs_ver <= 10.0 else False arch_subdir = self.pi.cross_dir(forcex86) if arch_subdir: tools += [os.path.join(si.VCInstallDir, f'Bin{arch_subdir}')] if self.vs_ver == 14.0: path = f'Bin{self.pi.current_dir(hidex86=True)}' tools += [os.path.join(si.VCInstallDir, path)] elif self.vs_ver >= 15.0: host_id = self.pi.current_cpu.replace('amd64', 'x64').upper() host_dir = os.path.join('bin', f'Host{host_id}%s') tools += [ os.path.join(si.VCInstallDir, host_dir % self.pi.target_dir(x64=True)) ] if self.pi.current_cpu != self.pi.target_cpu: tools += [ os.path.join( si.VCInstallDir, host_dir % self.pi.current_dir(x64=True) ) ] else: tools += [os.path.join(si.VCInstallDir, 'Bin')] return tools @property def OSLibraries(self): """ Microsoft Windows SDK Libraries. Return ------ list of str paths """ if self.vs_ver <= 10.0: arch_subdir = self.pi.target_dir(hidex86=True, x64=True) return [os.path.join(self.si.WindowsSdkDir, f'Lib{arch_subdir}')] else: arch_subdir = self.pi.target_dir(x64=True) lib = os.path.join(self.si.WindowsSdkDir, 'lib') libver = self._sdk_subdir return [os.path.join(lib, f'{libver}um{arch_subdir}')] @property def OSIncludes(self): """ Microsoft Windows SDK Include. Return ------ list of str paths """ include = os.path.join(self.si.WindowsSdkDir, 'include') if self.vs_ver <= 10.0: return [include, os.path.join(include, 'gl')] else: if self.vs_ver >= 14.0: sdkver = self._sdk_subdir else: sdkver = '' return [ os.path.join(include, f'{sdkver}shared'), os.path.join(include, f'{sdkver}um'), os.path.join(include, f'{sdkver}winrt'), ] @property def OSLibpath(self): """ Microsoft Windows SDK Libraries Paths. Return ------ list of str paths """ ref = os.path.join(self.si.WindowsSdkDir, 'References') libpath = [] if self.vs_ver <= 9.0: libpath += self.OSLibraries if self.vs_ver >= 11.0: libpath += [os.path.join(ref, r'CommonConfiguration\Neutral')] if self.vs_ver >= 14.0: libpath += [ ref, os.path.join(self.si.WindowsSdkDir, 'UnionMetadata'), os.path.join(ref, 'Windows.Foundation.UniversalApiContract', '1.0.0.0'), os.path.join(ref, 'Windows.Foundation.FoundationContract', '1.0.0.0'), os.path.join( ref, 'Windows.Networking.Connectivity.WwanContract', '1.0.0.0' ), os.path.join( self.si.WindowsSdkDir, 'ExtensionSDKs', 'Microsoft.VCLibs', f'{self.vs_ver:0.1f}', 'References', 'CommonConfiguration', 'neutral', ), ] return libpath @property def SdkTools(self): """ Microsoft Windows SDK Tools. Return ------ list of str paths """ return list(self._sdk_tools()) def _sdk_tools(self): """ Microsoft Windows SDK Tools paths generator. Return ------ generator of str paths """ if self.vs_ver < 15.0: bin_dir = 'Bin' if self.vs_ver <= 11.0 else r'Bin\x86' yield os.path.join(self.si.WindowsSdkDir, bin_dir) if not self.pi.current_is_x86(): arch_subdir = self.pi.current_dir(x64=True) path = f'Bin{arch_subdir}' yield os.path.join(self.si.WindowsSdkDir, path) if self.vs_ver in (10.0, 11.0): if self.pi.target_is_x86(): arch_subdir = '' else: arch_subdir = self.pi.current_dir(hidex86=True, x64=True) path = rf'Bin\NETFX 4.0 Tools{arch_subdir}' yield os.path.join(self.si.WindowsSdkDir, path) elif self.vs_ver >= 15.0: path = os.path.join(self.si.WindowsSdkDir, 'Bin') arch_subdir = self.pi.current_dir(x64=True) sdkver = self.si.WindowsSdkLastVersion yield os.path.join(path, f'{sdkver}{arch_subdir}') if self.si.WindowsSDKExecutablePath: yield self.si.WindowsSDKExecutablePath @property def _sdk_subdir(self): """ Microsoft Windows SDK version subdir. Return ------ str subdir """ ucrtver = self.si.WindowsSdkLastVersion return (f'{ucrtver}\\') if ucrtver else '' @property def SdkSetup(self): """ Microsoft Windows SDK Setup. Return ------ list of str paths """ if self.vs_ver > 9.0: return [] return [os.path.join(self.si.WindowsSdkDir, 'Setup')] @property def FxTools(self): """ Microsoft .NET Framework Tools. Return ------ list of str paths """ pi = self.pi si = self.si if self.vs_ver <= 10.0: include32 = True include64 = not pi.target_is_x86() and not pi.current_is_x86() else: include32 = pi.target_is_x86() or pi.current_is_x86() include64 = pi.current_cpu == 'amd64' or pi.target_cpu == 'amd64' tools = [] if include32: tools += [ os.path.join(si.FrameworkDir32, ver) for ver in si.FrameworkVersion32 ] if include64: tools += [ os.path.join(si.FrameworkDir64, ver) for ver in si.FrameworkVersion64 ] return tools @property def NetFxSDKLibraries(self): """ Microsoft .Net Framework SDK Libraries. Return ------ list of str paths """ if self.vs_ver < 14.0 or not self.si.NetFxSdkDir: return [] arch_subdir = self.pi.target_dir(x64=True) return [os.path.join(self.si.NetFxSdkDir, rf'lib\um{arch_subdir}')] @property def NetFxSDKIncludes(self): """ Microsoft .Net Framework SDK Includes. Return ------ list of str paths """ if self.vs_ver < 14.0 or not self.si.NetFxSdkDir: return [] return [os.path.join(self.si.NetFxSdkDir, r'include\um')] @property def VsTDb(self): """ Microsoft Visual Studio Team System Database. Return ------ list of str paths """ return [os.path.join(self.si.VSInstallDir, r'VSTSDB\Deploy')] @property def MSBuild(self): """ Microsoft Build Engine. Return ------ list of str paths """ if self.vs_ver < 12.0: return [] elif self.vs_ver < 15.0: base_path = self.si.ProgramFilesx86 arch_subdir = self.pi.current_dir(hidex86=True) else: base_path = self.si.VSInstallDir arch_subdir = '' path = rf'MSBuild\{self.vs_ver:0.1f}\bin{arch_subdir}' build = [os.path.join(base_path, path)] if self.vs_ver >= 15.0: # Add Roslyn C# & Visual Basic Compiler build += [os.path.join(base_path, path, 'Roslyn')] return build @property def HTMLHelpWorkshop(self): """ Microsoft HTML Help Workshop. Return ------ list of str paths """ if self.vs_ver < 11.0: return [] return [os.path.join(self.si.ProgramFilesx86, 'HTML Help Workshop')] @property def UCRTLibraries(self): """ Microsoft Universal C Runtime SDK Libraries. Return ------ list of str paths """ if self.vs_ver < 14.0: return [] arch_subdir = self.pi.target_dir(x64=True) lib = os.path.join(self.si.UniversalCRTSdkDir, 'lib') ucrtver = self._ucrt_subdir return [os.path.join(lib, f'{ucrtver}ucrt{arch_subdir}')] @property def UCRTIncludes(self): """ Microsoft Universal C Runtime SDK Include. Return ------ list of str paths """ if self.vs_ver < 14.0: return [] include = os.path.join(self.si.UniversalCRTSdkDir, 'include') return [os.path.join(include, f'{self._ucrt_subdir}ucrt')] @property def _ucrt_subdir(self): """ Microsoft Universal C Runtime SDK version subdir. Return ------ str subdir """ ucrtver = self.si.UniversalCRTSdkLastVersion return (f'{ucrtver}\\') if ucrtver else '' @property def FSharp(self): """ Microsoft Visual F#. Return ------ list of str paths """ if 11.0 > self.vs_ver > 12.0: return [] return [self.si.FSharpInstallDir] @property def VCRuntimeRedist(self) -> str | None: """ Microsoft Visual C++ runtime redistributable dll. Returns the first suitable path found or None. """ vcruntime = f'vcruntime{self.vc_ver}0.dll' arch_subdir = self.pi.target_dir(x64=True).strip('\\') # Installation prefixes candidates prefixes = [] tools_path = self.si.VCInstallDir redist_path = os.path.dirname(tools_path.replace(r'\Tools', r'\Redist')) if os.path.isdir(redist_path): # Redist version may not be exactly the same as tools redist_path = os.path.join(redist_path, os.listdir(redist_path)[-1]) prefixes += [redist_path, os.path.join(redist_path, 'onecore')] prefixes += [os.path.join(tools_path, 'redist')] # VS14 legacy path # CRT directory crt_dirs = ( f'Microsoft.VC{self.vc_ver * 10}.CRT', # Sometime store in directory with VS version instead of VC f'Microsoft.VC{int(self.vs_ver) * 10}.CRT', ) # vcruntime path candidate_paths = ( os.path.join(prefix, arch_subdir, crt_dir, vcruntime) for (prefix, crt_dir) in itertools.product(prefixes, crt_dirs) ) return next(filter(os.path.isfile, candidate_paths), None) # type: ignore[arg-type] #python/mypy#12682 def return_env(self, exists: bool = True) -> _EnvironmentDict: """ Return environment dict. Parameters ---------- exists: bool It True, only return existing paths. Return ------ dict environment """ env = _EnvironmentDict( include=self._build_paths( 'include', [ self.VCIncludes, self.OSIncludes, self.UCRTIncludes, self.NetFxSDKIncludes, ], exists, ), lib=self._build_paths( 'lib', [ self.VCLibraries, self.OSLibraries, self.FxTools, self.UCRTLibraries, self.NetFxSDKLibraries, ], exists, ), libpath=self._build_paths( 'libpath', [self.VCLibraries, self.FxTools, self.VCStoreRefs, self.OSLibpath], exists, ), path=self._build_paths( 'path', [ self.VCTools, self.VSTools, self.VsTDb, self.SdkTools, self.SdkSetup, self.FxTools, self.MSBuild, self.HTMLHelpWorkshop, self.FSharp, ], exists, ), ) if self.vs_ver >= 14 and self.VCRuntimeRedist: env['py_vcruntime_redist'] = self.VCRuntimeRedist return env def _build_paths(self, name, spec_path_lists, exists): """ Given an environment variable name and specified paths, return a pathsep-separated string of paths containing unique, extant, directories from those paths and from the environment variable. Raise an error if no paths are resolved. Parameters ---------- name: str Environment variable name spec_path_lists: list of str Paths exists: bool It True, only return existing paths. Return ------ str Pathsep-separated paths """ # flatten spec_path_lists spec_paths = itertools.chain.from_iterable(spec_path_lists) env_paths = environ.get(name, '').split(os.pathsep) paths = itertools.chain(spec_paths, env_paths) extant_paths = list(filter(os.path.isdir, paths)) if exists else paths if not extant_paths: msg = f"{name.upper()} environment variable is empty" raise distutils.errors.DistutilsPlatformError(msg) unique_paths = unique_everseen(extant_paths) return os.pathsep.join(unique_paths) compat/py310.py 0000644 00000000215 15030122015 0007240 0 ustar 00 import sys __all__ = ['tomllib'] if sys.version_info >= (3, 11): import tomllib else: # pragma: no cover import tomli as tomllib compat/__pycache__/__init__.cpython-310.pyc 0000644 00000000252 15030122015 0014463 0 ustar 00 o �h � @ s d S )N� r r r �M/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/compat/__init__.py�<module> s compat/__pycache__/py311.cpython-310.pyc 0000644 00000002252 15030122015 0013603 0 ustar 00 o �h � @ s� U d dl mZ d dlZd dlZd dlmZmZmZ er)d dlm Z m Z d dl m Z eedef e egef Zded< dddd�ZdS )� )� annotationsN)� TYPE_CHECKING�Any�Callable)�ExcInfo�StrOrBytesPath)� TypeAlias.r �_OnExcCallbackF�pathr � ignore_errors�bool�onexc�_OnExcCallback | None�return�Nonec s8 t jdkr tj| |� d�S d� fd d � }tj| ||d �S )N)� � �r �fn�Callable[..., Any]r �str�excinfor r r c s � r � | ||d � d S d S )N� � )r r r r r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/compat/py311.py�_handler s �z shutil_rmtree.<locals>._handler)�onerror)r r r r r r r r )�sys� version_info�shutil�rmtree)r r r r r r r � shutil_rmtree s r! )FN)r r r r r r r r )� __future__r r r �typingr r r � _typeshedr r �typing_extensionsr r � BaseException�objectr �__annotations__r! r r r r �<module> s "� compat/__pycache__/py39.cpython-310.pyc 0000644 00000000400 15030122015 0013523 0 ustar 00 o �h� � @ s" d dl Z e jdkr dZdS dZdS )� N)� � �locale)�sys� version_info�LOCALE_ENCODING� r r �I/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/compat/py39.py�<module> s compat/__pycache__/py312.cpython-310.pyc 0000644 00000000621 15030122015 0013602 0 ustar 00 o �hn � @ sD U d dl mZ d dlZejdkrdZded< dS ddlmZ eZdS ) � )� annotationsN)� � � zutf-8z str | None� PTH_ENCODING� )�LOCALE_ENCODING)� __future__r �sys� version_infor �__annotations__�py39r � r r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/compat/py312.py�<module> s compat/__pycache__/py310.cpython-310.pyc 0000644 00000000432 15030122015 0013600 0 ustar 00 o �h� � @ s0 d dl Z dgZe jdkrd dlZdS d dlZdS )� N�tomllib)� � )�sys�__all__� version_infor �tomli� r r �J/usr/local/CyberCP/lib/python3.10/site-packages/setuptools/compat/py310.py�<module> s compat/py312.py 0000644 00000000556 15030122015 0007252 0 ustar 00 from __future__ import annotations import sys if sys.version_info >= (3, 12, 4): # Python 3.13 should support `.pth` files encoded in UTF-8 # See discussion in https://github.com/python/cpython/issues/77102 PTH_ENCODING: str | None = "utf-8" else: from .py39 import LOCALE_ENCODING # PTH_ENCODING = "locale" PTH_ENCODING = LOCALE_ENCODING compat/py39.py 0000644 00000000755 15030122015 0007201 0 ustar 00 import sys # Explicitly use the ``"locale"`` encoding in versions that support it, # otherwise just rely on the implicit handling of ``encoding=None``. # Since all platforms that support ``EncodingWarning`` also support # ``encoding="locale"``, this can be used to suppress the warning. # However, please try to use UTF-8 when possible # (.pth files are the notorious exception: python/cpython#77102, pypa/setuptools#3937). LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None compat/py311.py 0000644 00000001426 15030122015 0007246 0 ustar 00 from __future__ import annotations import shutil import sys from typing import TYPE_CHECKING, Any, Callable if TYPE_CHECKING: from _typeshed import ExcInfo, StrOrBytesPath from typing_extensions import TypeAlias # Same as shutil._OnExcCallback from typeshed _OnExcCallback: TypeAlias = Callable[[Callable[..., Any], str, BaseException], object] def shutil_rmtree( path: StrOrBytesPath, ignore_errors: bool = False, onexc: _OnExcCallback | None = None, ) -> None: if sys.version_info >= (3, 12): return shutil.rmtree(path, ignore_errors, onexc=onexc) def _handler(fn: Callable[..., Any], path: str, excinfo: ExcInfo) -> None: if onexc: onexc(fn, path, excinfo[1]) return shutil.rmtree(path, ignore_errors, onerror=_handler) compat/__init__.py 0000644 00000000000 15030122015 0010113 0 ustar 00 cli.exe 0000644 00000027000 15030122015 0006002 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ �z 2�da�da�da�c�a�dasee`�dase�a�dasea`�dase``�daseg`�da�ce`�da�ea�da�d``�da�d�a�da�df`�daRich�da PE L �'hd � $ � 0 @ p @� 6 � P � ` � �2 2 @ 0 .text � `.rdata � 0 @ @.data � @ ( @ �.rsrc � P * @ @.reloc � ` , @ B ��C@ �����������U��} u�@@ ��t j P� 0@ � ]���������������U��EPj �u �u����p�0� 1@ ��]�������������U��j �u �u� �� ]������������U���S�]VW�K��C��u�+�j�] P�x0@ �ȃ��M�3��"�q3ɉM���~S�U�<\uG�&<"u ��~Wj\V� �M��� �U�3��\F�3��A�F�M�;�| �~Wj\V�t �� ��E�_f�" ^[��]�������������U��� �@@ 3ʼnE��E�����E �����������h Pj �0@ j h� jj jh �������P� 0@ j h ������QP�0@ �������Q�A��u�+ʍ������������;�v�8.t� ������H;�w퍍����� If��A�I��u���1@ ���1@ �Af��1@ f�A��1@ W�A ������j P� �������u2������Ph�1@ j��0@ ��P����� �G_�M�3��� ��]�Vh ������PW�� ������W�� ��������H@;�s���t �� t�� u�j� ������h�1@ P� 1@ �� ��t&��1@ �~�1@ �������1@ fօ����������������Q�A��u�S+�jQ�x0@ �������������3ۉ���������Q�����1@ �� ��t D �FFP�1@ ����u�F���������� ��P�1@ �������t��tm��������\uC�ƀ�"u0�Ã�����u 3��������3��9�����EȈ�������tSj\W�� �� �3ۊ��������o����G�g�����tSj\W� �� �3ۋ��������@� G������ �����<�t-�P�1@ ����t�FFP�1@ ����u�> ����������;�NJ��t��@��/u�\���u�5h0@ ������P������P������P����PW�փ����� �� ������\�� ������P������P������P����P������P�֍��������Q�A��u�+ʊ� ������ �����Ӏ�\u�Q�3���\��������\t f � ������;�r � H�8\u�j W������P����P������P�l0@ �=x0@ jh �����h PV������1@ �������(�,�x0@ jh ��h �����WV�1@ �=x0@ ����u/�3h�1@ j��0@ ��P�r����� �F[^_�M�3��Q ��]Ë�������j� �����A�P��V����~�����{� �� 9���~*���� ������4��R����C����;�|勵���������P�3����� ����9���~/���� � ������4������C����;�|勵����} � t@���V��0@ ��Vh�1@ j��0@ ��P�l����� � [^_�M�3��I ��]ËQ�A��u�����+ʺ �y;�~0��� ��Y @ �A��u�+�GB�;�|ߋ���������x0@ jW��Vh�1@ P����� ���N��F��u�� +�;�~O @ ff � ����4������h�1@ P�d ����� � ��Q D �A��u�+�FG�;�|�W�Dž�� jh@ ����Dž����D f�����f�����f�����f�����f�����f�����f�����f������0@ �����P������Pj j j jj j ����j �0@ ��u,hP1@ j��0@ ��P������3�[^_�M�3�� ��]Ë����j�������@@ �0@ ����P������ 0@ ��u,hl1@ j��0@ ��P�v�����3�[^_�M�3��V ��]ËM�����3�[^_�? ��]����������U��EPj �u j��u�����p��Q��0@ ���� ��H�]�; @@ u��y Vj�v �V P� �D ��� j�0� �� ^��ts���l h"@ �n � P�> YY��uQ� �c ��t h� @ � Y�) �$ � �� P�G Y�� ��t� �� �T ��u�j�- ��� 3��� � P� Y�jh�5@ �/ j� Y���P 2ۈ]�e� �� �Eܡ<C@ 3�A;��/ ��uI� <C@ h<1@ h01@ � YY��t�E������� �� h,1@ h$1@ �[ YY�<C@ ��و]�u��� Y�i ��3�9>tV�9 Y��t�6WjW�� 1@ ���G ��9>tV� Y��t�6�$ Y�� ���� �0� WV�0�q����� ���. ��tk��u�� j j�{ YY�E��������5�M�� �E�QP�{ YYËe��� ��t2�}� u� �E������E�M�d� Y_^[��j� V�j �u��h ��� �t���U��j �D0@ �u�H0@ h ��@0@ P�<0@ ]�U���$ j�80@ ��tjY�)� A@ � A@ �A@ � A@ �5A@ �= A@ f�8A@ f� ,A@ f� A@ f�A@ f�% A@ f�-�@@ ��0A@ �E �$A@ �E�(A@ �E�4A@ ������p@@ �(A@ �,@@ � @@ ��$@@ �0@@ jXk� ǀ4@@ jXk� � @@ �L�jX�� � @@ �L�h2@ �����U��EV�H<��A�Q��Ak�(�;�t�M ;J r �BB ;�r ��(;�u�3�^]Ë��V� ��t d� �@C@ �P�;�t3�������u�2�^ð^�U��} u�DC@ �v �r ��u2�]��e ��u j �Z Y��]�U��=EC@ t�]�V�u��t��ub� ��t&��u"hHC@ � Y��uhTC@ �y Y��t+2��0��� HC@ � LC@ � PC@ � TC@ � XC@ � \C@ �EC@ �^]�j�/ �jh 6@ �K �e� �MZ f9 @ u]�< @ �� @ PE uL� f9� @ u>�E� @ +�PQ�|���YY��t'�x$ |!�E������� �E� 3Ɂ8 �����Ëe��E�����2��M�d� Y_^[��U��� ��t�} u 3��@C@ �]�U��=DC@ t�} u�u� �u� YY�]�U��=HC@ ��uu�T � hHC@ �B Y��Y���#E]�U��u������Y���H]�U����e� �E�e� P�(0@ �E�3E�E��,0@ 1E��00@ 1E��E�P�40@ �E�M�3E�3E�3��Ë @@ VW�N�@�� ��;�t��u&�����;�u�O�@����u G �� ȉ @@ ��_� @@ ^�3��3�@ø @ �h`C@ �$0@ ð�h h j �g �� ��u�j�? �� �hC@ ���H�$�H����H��H�3�9 @@ ��ø�C@ ø�C@ �U���$ Sj�80@ ��t�M�)j� �$� �����j P�F �� ��������������������������|�����x���f������f������f��t���f��p���f��l���f��h�����������E�������E������Dž��� �@�jP�������E�j P� �E�� �E� @�E� �E�� 0@ j �X��ۍE��E������ۉE���D0@ �E�P�H0@ ��u ��uj� Y[���e���j �L0@ ��t3�MZ f9u)�H<ȁ9PE u � f9Au�ytv ��� ���2��h�!@ �D0@ �U��VW�}�7�>csm�u%�~u �F= �t =!�t="�t= @�t_3�^]� �� �0�w�� �0�\ ̃%pC@ �SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[�SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[������h�"@ d�5 �D$�l$�l$+�SVW�@@ 1E�3�P�e�u��E��E������E��E�d� �U��V�u�6� �u��u�u Vh2@ h@@ � �� ^]�U��%tC@ ��$� @@ j �80@ ���� �e� 3�SVW3ɍ}�S���[���w�O3ɉW �E܋}�E�Genu�E�5ineI�E��E�5ntel�E�3�@S���[��]܉�E� E� ljs�K�S uC�E�%�?�=� t#=` t =p t=P t=` t=p u�=xC@ ���=xC@ ��=xC@ �M�jX�M�9E�|03�S���[��]܉�s�K�M��S �]�� t���=xC@ ��]�@@ ���tC@ �@@ �� �� ���tC@ �@@ �� ty�� tq3�ЉE�U�E�M�j^#�;�uW�@@ ���tC@ �@@ �� t;�� �tC@ �@@ � �#�;�u �E�� �M�#�;�u � @@ @�5tC@ _^[3���3�9@@ ���%T0@ �%X0@ �%`0@ �%\0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%1@ �%�0@ �%�0@ �%�0@ �%�0@ �%t0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ U��Q�=tC@ |f�}� �t �}� �uT�]��E���?��t?� u�� ��é t*� u�� ��é u�� ��é u�� ��ø� ��ËE�� 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � @ �@ @@ �@ failed to create process. failed to get exit code from process. %s %s -script.py Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s @@ p@@ � @@ 3@ 1@ 3@ 1@ �'hd l `3 ` �" �� 3 , H3 � � �" (# �# $ $ $ $ c$ k$ @ �" N% x � .text$mn 0 .idata$5 1 .00cfg $1 .CRT$XCA (1 .CRT$XCAA ,1 .CRT$XCZ 01 .CRT$XIA 41 .CRT$XIAA 81 .CRT$XIAC <1 .CRT$XIZ @1 .CRT$XPA D1 .CRT$XPZ H1 .CRT$XTA L1 .CRT$XTZ P1 � .rdata 3 .rdata$sxdata 3 \ .rdata$voltmd `3 l .rdata$zzzdbg �5 .rtc$IAA �5 .rtc$IZZ �5 .rtc$TAA �5 .rtc$TZZ �5 < .xdata$x 6 � .idata$2 �6 .idata$3 �6 .idata$4 8 � .idata$6 @ .data @ x .bss P ` .rsrc$01 `P � .rsrc$02 ���� ��� ����,@ @@ ���� ��� ����N @ a @ �6 �8 0 L7 ,9 T0 l7 �; t0 `7 �; h0 �7 �; �0 �7 < �0 8 4< 1 �7 V< �0 x7 v< �0 �7 �< �0 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � CreateFileA dGetFinalPathNameByHandleA �WaitForSingleObject QGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll H memset __current_exception __current_exception_context 5 _except_handler4_common VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace B _seh_filter_exe D _set_app_type . __setusermatherr _configure_narrow_argv 5 _initialize_narrow_environment * _get_initial_narrow_environment 8 _initterm 9 _initterm_e X exit % _exit T _set_fmode _cexit _c_exit ? _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 6 _initialize_onexit_table > _register_onexit_function _crt_atexit _controlfp_s j terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �UnhandledExceptionFilter �SetUnhandledExceptionFilter ,GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent mQueryPerformanceCounter -GetCurrentProcessId 1GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW ��DN�@����� � 0 � H `P } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 00'0[0�0J1u1�1�1�12 22<2D2�2�2�2�2�2303H3j3)4<4s4M5S5w5�5�5�5�5�5�6�6�6>7I7�7�7(8P8Y8a8�8�8�8�8�8!949x9�9:3:H:M:R:s:x:�:�:�;�;�;�;�;�;�;�;�;�;�;�; <<<< <#<+<3<;<G<P<U<[<e<o<<�<�<�<=4=g=�=�=�=�=�=�=�=�=�=�=>>> >*>�>�>�>�>?'?0?=?S?�?�?�?�?�? � 0 00%0�011;1z1�1�1�1�1�122*2A2^2�2�2�2�2�2u3~3�3�3�3�3�3�3�3+444=4K4T4v4}4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�455555 5&5,52585>5D5J5T5 0 ( 1(1418122L2P2X2�2�2�5�566 gui-64.exe 0000644 00000034000 15030122015 0006244 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ ��b�c�1�c�1�c�1�61�c�1 �0�c�1 X1�c�1 �0�c�1 �0�c�1 �0�c�1��0�c�1�c�1�c�1� �0�c�1� Z1�c�1� �0�c�1Rich�c�1 PE d� �'hd � " $ " 0 @ � `� : � p � ` � � 0 5 �3 @ 0 P .text � `.rdata , 0 @ @.data H P 0 @ �.pdata � ` 2 @ @.rsrc � p 4 @ @.reloc 0 � 6 @ B H�)F ���������H��(��u� "@ ��t3� � H��(�������������H�T$L�D$L�L$ SVWH��0H��H�t$`H�����E3�H�t$ L��H��H���! H��0_^[������������A� �5 �����H�\$H�l$H�t$H�|$ ATAVAWH�� H��L��H����� D H���< u�� �, 3�L��A�?L��3�H�� �3! ��t�KH��"! ��u��3H��@��ta@�� ! ��t��tO@��\u����@��"u �׃�u 3�������3����E���tL�Dz\I��� L�3�@��t�A�6I��딅�tL�Dz\I���� L�3�A� I��Ic�AA�M�t�@��t,� �y ��t D �KH��c ��u�; �8���H�\$@I��H�l$HH�t$PH�|$XH�� A_A^A\�����H�\$H�l$H�t$H�|$ AVH�� H��H�����H�ǀ<9 u��?� Hc�H���� 3�Hc�L��� "H�X��~X�<\u���&<"u ��~���\D��H��� H�3��\H���3��H�ƈH��H��u���~���\D��H���� H�H�l$8I��H�t$@H�|$Hf�" H�\$0H�� A^�@UVWATH��$����H��H H� = H3�H�� D�D$dD��H�T$xA� �L$`H�U3� 3�H�MH�t$0E3��D$(� � ��D$ D�F�� E3�H�UH��A� �� H�MH�����H��@84u�H�MH�H�MH;�v�8.t@�0H�MH��H;�w�H�M@�0H��f�@8qH�Iu��~ 3ҋ~ ��AH�M�X �����u$�H�. H��L�EH�X �S����G� H��$� H�� L��$8 A� ��L��$0 � Hc�H�� Hً�� H�� H�ȐH��H;�s���t �� t�� u�A� @�0H�� H�� �� ��t)�� �� �� �� �� �� H�T$XH�� ���L��H�H�����tL��H����/uA� \���u�H�� H��L�� H�D$ L�� H�T$P�� @8t$P�� �� \�� H�� L�� H�D$ L�� H�T$PH�M�� H�� H�����@8tH�@u�D�� H�� A��\uD�A�H�A�HE�A��\t!ff � H�� H;�r @�0H�Ȁ8\u�L��H�t$ L�� H�T$PH�� �( � � �8 H�� �� � � H��A� H��L���2 M��u(I� A�O�� L��H�F H������A�G�W �|$X� L��$@ A�<Lc�L�l$hI�M�� I��H�D$XH�����H�H�s��~#I�^�� @ H� �x���H�H�[H��H��u�H�EH�����H�À< u��� Hc�H���N E3�Lc�H�D$pA��� "H�x��~lE3�f�B�D5<\u���(<"u!��~�ٲ\D��H���{ H�A���\H���A��B�D5I�ƈH��M;�|�L�l$h��~�ٲ\D��H���? H�E3�H�D$pf�" Hc|$`H�H��H��~%L�d$x� I� ����H�H��H��H;�|�|$d L�6t5H�T$XI��� � �] M��H�� H������ � H�����f�H��A�< u�L�d$X��I��~-A� f�K��H����� D H���< u���I���M;�|�Hcɺ �� M��H�� H��H��� H������H��A�< u�I��~F� fff � M��H�� Hc�H��J I� �H�����H���< u���H���I;�|�W�D�t$P3��E�h W�H�E�H� [����EE��PM�M�M�M�M�M�S H�E�E3�H�D$HE3�H�E�H��H�D$@3�L�t$8L�t$0D�t$(�D$ � ��u�H�� H��H�� � ����J�E������H�M���6 �� H�M�H�T$P�� ��u�H�� H��H�� �����D�t$PA��L��$@ L��$8 H��$� L��$0 H�� H3�� H��H A\_^]���H�T$L�D$L�L$ SVWH��0H��H�t$`H������L��H�t$(H�����H�D$ L��H��H�H���� ��H�H��0_^[���H��(M�A8H��I��� � H��(����@SE�H��A��L��A� L��tA�@McP��L�Hc�L#�Ic�J�H�C�HH�C�Dt �D���L�L3�I��[� �����������ff � H; Q5 uH��f����u�H��� ��@SH�� � �� �� ���� �� ��� � ��D ��ts�7 H� l �� � ��� ��uR� �� ��t H� ~ �m � � �j ��� � ��t�U �P � ��uH�� [ù � ���H��(�_ 3�H��(�H��(�7 � ��H��(�M ���H�\$H�t$WH��0� �/ ���6 @2�@�t$ �� �؋ �9 ���# ��uJ��9 H�� H� � � ��t �� �� H�o H� X � ��9 �@�@�t$ ��� �� H��H�8 t H���n ��tE3�A�P3�H��� � H��H�8 tH���B ��tH� �T � H���� H��� L��H�Ӌ����� ��tU@��u� 3ұ� ������ ��t;�|$ u�� ��H�\$@H�t$HH��0_ù � �� � ��� ���� �H��(�� H��(�r�����@SH�� H��3� H��� �� H�Ⱥ �H�� [H�%� H�L$H��8� � ��t� �)H� R3 � H�D$8H�94 H�D$8H��H��3 H�"4 H��2 H�D$@H��3 �m2 ��g2 �q2 � Hk� H� i2 H� � Hk� H� �1 H�L � Hk�H� �1 H�L H� h ���H��8���@SVWH��@H��S H��� 3�E3�H�T$`H��� H��t9H�d$8 H�L$hH�T$`L��H�L$0L��H�L$pH�L$(3�H�\$ �� �ǃ�|�H��@_^[����H��(� ��t!eH�%0 H�H�H;�t3��H� �6 u�2�H��(ð����@SH�� ��6 �ɻ DÈ�6 � � ��u2��� ��u 3�� ���H�� [����@SH�� �=|6 ��ug��wj� ��t(��u$H� f6 � ��uH� n6 � ��t.2��3fo) H���56 H�>6 �>6 H�G6 �6 �H�� [ù �^ ��H��L���MZ f9�uxHc L�H� �Hʁ9PE u_� f9AuTL+��QH��H��AH� �L� �H�$I;�t�J L;�r �B�L;�rH��(��3�H��u2���z$ }2�� ��2��2�H���@SH�� ���� 3҅�t ��uH�>5 H�� [�@SH�� �=35 ��t��u �6 ���/ �H�� [����@SH�� H�=5 �H��u�B �H��H� �4 �+ 3҅�HD�H��H�� [���H��(���H������H��(��H�\$UH��H��0H��. H�2��-�+ H;�utH�e H�M�F H�EH�E�@ ��H1E�< ��H�MH1E�4 �EH�M�H�� H3EH3E�H3�H������� H#�H�3��-�+ H;�HD�H�a. H�\$PH��H�J. H��0]�3��̸ ��̸ @ ���H� 94 H�%� �̰��� �H�14 �H��(��H�$���H�H��(��3�9 . ���H�!4 �H�4 Ã%�3 �H�\$UH��$@���H�� �ٹ �V ��t���)� ����3�H�M�A�� � H�M�1 H��� H��� H��E3��� H��t<H�d$8 H��� H��� L��H�L$0L��H��� H�L$(H�M�H�L$ 3�n H��� H�L$PH��� 3�H��� A�� H��H��� �t H��� H�D$`�D$P @�D$T �J ��H�D$PH�D$@H�E���H�D$H3� H�L$@�� ��u ��u�H���H��$� H�� ]���;������H��(3�� H��t9�MZ f9u/HcH<Hȁ9PE u � f9Au��� v ��� ���2�H��(����H� H�%r ��H�\$WH�� H�H���;csm�u �{u�S ���l�v�� @�t H�\$03�H�� _��^ H�H�_�X H��� ��H�\$WH�� H� H�= �H�H��t�� H��H;�r�H�\$0H�� _�H�\$WH�� H� � H�=� �H�H��t�� H��H;�r�H�\$0H�� _�H�\$H�t$WH��3�3��D��E3�D��A��ntelA��ineID�ˋ�3�A�CE ��A��Genu�$E щ\$���L$�T$ u[H� + �%�?�H��* � =� t(=` t!=p t������ w$H� H��sD��0 A��D��0 �D��0 � D�H�;�|&3���$D�ۉ\$�L$�T$ �� s E �D��0 �d* D� a* ���� D� L* � � E* ��sy�� ss3��H�� H �H�T$ H�D$ "�:�uW�* ���* �* A�� t8�� ��) ��) � �D#�D;�uH�D$ $�<�u � �) @� �) H�\$(3�H�t$0H��_�3�9�) ���������������%B �%4 �%> �%@ �%� �%� �%� �% �%z �% �%� �%� �%� �%� �%� �%� �% �%t �%~ �%� �%" �% �% �%@ �%B �%� �%F �%� �%� �%� �%� ������������ff � ����������������������ff � �%� @UH�� H��H�H�ы�����H�� ]��@UH��H�3Ɂ8 �����]�� 0= >= Z= p= �= �= �= �= �A �A B "B @B TB C �B �B �B �B �B �B hB �A �= �= > (> "C b> n> @ X> @ ? �@ @@ \@ �? �@ �? �? �? |> �? n? �> �> ? �? L? 2? x@ �? �@ �? �> �> �> �@ 0@ �@ �> �> �> �! @ �! @ P' @ p' @ p' @ 4' @ � @ � @ � @ failed to create process. failed to get exit code from process. %s %s -script.pyw Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s PP @ �P @ ����������������@ P @ P2 @ `2 @ �5 @ X2 @ h2 @ p2 @ x2 @ �2 @ �'hd � �5 �! ���5 , �5 � 4 � � � �" # �% �% >& � � � v' 6 @ .text$mn @' 6 .text$mn$00 v' 6 .text$x 0 P .idata$5 P2 8 .00cfg �2 .CRT$XCA �2 .CRT$XCAA �2 .CRT$XCZ �2 .CRT$XIA �2 .CRT$XIAA �2 .CRT$XIAC �2 .CRT$XIZ �2 .CRT$XPA �2 .CRT$XPZ �2 .CRT$XTA �2 .CRT$XTZ �2 � .rdata �5 \ .rdata$voltmd �5 � .rdata$zzzdbg `8 .rtc$IAA h8 .rtc$IZZ p8 .rtc$TAA x8 .rtc$TZZ �8 � .xdata : � .idata$2 �: .idata$3 �: P .idata$4 0= � .idata$6 P @ .data @P .bss ` � .pdata p ` .rsrc$01 `p � .rsrc$02 Rp`0 t d T 4 2� t d T 4 2��� B & � �p`P !' '�� �� 4� � � �8 ! �� � < �8 ! � < �8 ! � � �8 0 20 d 4 R p�& � � v' � ( v' � 2P b rp`0 " �& � e �' e P 4 RP 4� � P 4 2p d 4 p �: �= 0 �; F> �0 �; �@ 1 �; �@ �0 0< �@ P1 �< A �1 = >A 02 < `A 01 < �A 1 < �A @1 0= >= Z= p= �= �= �= �= �A �A B "B @B TB C �B �B �B �B �B �B hB �A �= �= > (> "C b> n> @ X> @ ? �@ @@ \@ �? �@ �? �? �? |> �? n? �> �> ? �? L? 2? x@ �? �@ �? �> �> �> �@ 0@ �@ �> �> �> � CreateFileA kGetFinalPathNameByHandleA WaitForSingleObject XGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll > memset __C_specific_handler __current_exception __current_exception_context VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace @ _seh_filter_exe B _set_app_type __setusermatherr _configure_narrow_argv 3 _initialize_narrow_environment ( _get_initial_narrow_environment 6 _initterm 7 _initterm_e U exit # _exit T _set_fmode _cexit _c_exit = _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 4 _initialize_onexit_table < _register_onexit_function _crt_atexit g terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �RtlCaptureContext �RtlLookupFunctionEntry RtlVirtualUnwind �UnhandledExceptionFilter �SetUnhandledExceptionFilter 2GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent pQueryPerformanceCounter 3GetCurrentProcessId 7GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW < memcpy �] �f��2��-�+ ���� 4 �8 @ � �8 � � �8 � �8 � � �8 � < �8 < � �8 � � 9 � � 9 � �8 = �8 @ � 09 � � 89 � � <9 � � �8 � � �8 � 0 D9 0 B �8 D x <9 x J �9 L � �9 � � �8 � E <9 H � <9 � l �9 l � <9 � � <9 � � <9 � ! �8 ! �! �9 �! " �8 0" {# �9 �# �# �8 �# C$ �9 D$ �$ �9 �$ �$ �9 �$ h& �9 P' R' �9 p' v' : v' �' |9 �' �' �9 � 0 � H `p } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 0 0 P�X�`�h�p�������������(�@�H�Ф�� �� warnings.py 0000644 00000007324 15030122015 0006741 0 ustar 00 """Provide basic warnings used by setuptools modules. Using custom classes (other than ``UserWarning``) allow users to set ``PYTHONWARNINGS`` filters to run tests and prepare for upcoming changes in setuptools. """ from __future__ import annotations import os import warnings from datetime import date from inspect import cleandoc from textwrap import indent from typing import TYPE_CHECKING if TYPE_CHECKING: from typing_extensions import TypeAlias _DueDate: TypeAlias = tuple[int, int, int] # time tuple _INDENT = 8 * " " _TEMPLATE = f"""{80 * '*'}\n{{details}}\n{80 * '*'}""" class SetuptoolsWarning(UserWarning): """Base class in ``setuptools`` warning hierarchy.""" @classmethod def emit( cls, summary: str | None = None, details: str | None = None, due_date: _DueDate | None = None, see_docs: str | None = None, see_url: str | None = None, stacklevel: int = 2, **kwargs, ) -> None: """Private: reserved for ``setuptools`` internal use only""" # Default values: summary_ = summary or getattr(cls, "_SUMMARY", None) or "" details_ = details or getattr(cls, "_DETAILS", None) or "" due_date = due_date or getattr(cls, "_DUE_DATE", None) docs_ref = see_docs or getattr(cls, "_SEE_DOCS", None) docs_url = docs_ref and f"https://setuptools.pypa.io/en/latest/{docs_ref}" see_url = see_url or getattr(cls, "_SEE_URL", None) due = date(*due_date) if due_date else None text = cls._format(summary_, details_, due, see_url or docs_url, kwargs) if due and due < date.today() and _should_enforce(): raise cls(text) warnings.warn(text, cls, stacklevel=stacklevel + 1) @classmethod def _format( cls, summary: str, details: str, due_date: date | None = None, see_url: str | None = None, format_args: dict | None = None, ) -> str: """Private: reserved for ``setuptools`` internal use only""" today = date.today() summary = cleandoc(summary).format_map(format_args or {}) possible_parts = [ cleandoc(details).format_map(format_args or {}), ( f"\nBy {due_date:%Y-%b-%d}, you need to update your project and remove " "deprecated calls\nor your builds will no longer be supported." if due_date and due_date > today else None ), ( "\nThis deprecation is overdue, please update your project and remove " "deprecated\ncalls to avoid build errors in the future." if due_date and due_date < today else None ), (f"\nSee {see_url} for details." if see_url else None), ] parts = [x for x in possible_parts if x] if parts: body = indent(_TEMPLATE.format(details="\n".join(parts)), _INDENT) return "\n".join([summary, "!!\n", body, "\n!!"]) return summary class InformationOnly(SetuptoolsWarning): """Currently there is no clear way of displaying messages to the users that use the setuptools backend directly via ``pip``. The only thing that might work is a warning, although it is not the most appropriate tool for the job... See pypa/packaging-problems#558. """ class SetuptoolsDeprecationWarning(SetuptoolsWarning): """ Base class for warning deprecations in ``setuptools`` This class is not derived from ``DeprecationWarning``, and as such is visible by default. """ def _should_enforce(): enforce = os.getenv("SETUPTOOLS_ENFORCE_DEPRECATION", "false").lower() return enforce in ("true", "on", "ok", "1") _shutil.py 0000644 00000002730 15030122015 0006554 0 ustar 00 """Convenience layer on top of stdlib's shutil and os""" import os import stat from typing import Callable, TypeVar from .compat import py311 from distutils import log try: from os import chmod # pyright: ignore[reportAssignmentType] # Losing type-safety w/ pyright, but that's ok except ImportError: # pragma: no cover # Jython compatibility def chmod(*args: object, **kwargs: object) -> None: # type: ignore[misc] # Mypy reuses the imported definition anyway pass _T = TypeVar("_T") def attempt_chmod_verbose(path, mode): log.debug("changing mode of %s to %o", path, mode) try: chmod(path, mode) except OSError as e: # pragma: no cover log.debug("chmod failed: %s", e) # Must match shutil._OnExcCallback def _auto_chmod( func: Callable[..., _T], arg: str, exc: BaseException ) -> _T: # pragma: no cover """shutils onexc callback to automatically call chmod for certain functions.""" # Only retry for scenarios known to have an issue if func in [os.unlink, os.remove] and os.name == 'nt': attempt_chmod_verbose(arg, stat.S_IWRITE) return func(arg) raise exc def rmtree(path, ignore_errors=False, onexc=_auto_chmod): """ Similar to ``shutil.rmtree`` but automatically executes ``chmod`` for well know Windows failure scenarios. """ return py311.shutil_rmtree(path, ignore_errors, onexc) def rmdir(path, **opts): if os.path.isdir(path): rmtree(path, **opts) build_meta.py 0000644 00000047000 15030122015 0007211 0 ustar 00 """A PEP 517 interface to setuptools Previously, when a user or a command line tool (let's call it a "frontend") needed to make a request of setuptools to take a certain action, for example, generating a list of installation requirements, the frontend would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line. PEP 517 defines a different method of interfacing with setuptools. Rather than calling "setup.py" directly, the frontend should: 1. Set the current directory to the directory with a setup.py file 2. Import this module into a safe python interpreter (one in which setuptools can potentially set global variables or crash hard). 3. Call one of the functions defined in PEP 517. What each function does is defined in PEP 517. However, here is a "casual" definition of the functions (this definition should not be relied on for bug reports or API stability): - `build_wheel`: build a wheel in the folder and return the basename - `get_requires_for_build_wheel`: get the `setup_requires` to build - `prepare_metadata_for_build_wheel`: get the `install_requires` - `build_sdist`: build an sdist in the folder and return the basename - `get_requires_for_build_sdist`: get the `setup_requires` to build Again, this is not a formal definition! Just a "taste" of the module. """ from __future__ import annotations import contextlib import io import os import shlex import shutil import sys import tempfile import tokenize import warnings from collections.abc import Iterable, Iterator, Mapping from pathlib import Path from typing import TYPE_CHECKING, Union import setuptools from . import errors from ._path import StrPath, same_path from ._reqs import parse_strings from .warnings import SetuptoolsDeprecationWarning import distutils from distutils.util import strtobool if TYPE_CHECKING: from typing_extensions import TypeAlias __all__ = [ 'get_requires_for_build_sdist', 'get_requires_for_build_wheel', 'prepare_metadata_for_build_wheel', 'build_wheel', 'build_sdist', 'get_requires_for_build_editable', 'prepare_metadata_for_build_editable', 'build_editable', '__legacy__', 'SetupRequirementsError', ] class SetupRequirementsError(BaseException): def __init__(self, specifiers) -> None: self.specifiers = specifiers class Distribution(setuptools.dist.Distribution): def fetch_build_eggs(self, specifiers): specifier_list = list(parse_strings(specifiers)) raise SetupRequirementsError(specifier_list) @classmethod @contextlib.contextmanager def patch(cls): """ Replace distutils.dist.Distribution with this class for the duration of this context. """ orig = distutils.core.Distribution distutils.core.Distribution = cls # type: ignore[misc] # monkeypatching try: yield finally: distutils.core.Distribution = orig # type: ignore[misc] # monkeypatching @contextlib.contextmanager def no_install_setup_requires(): """Temporarily disable installing setup_requires Under PEP 517, the backend reports build dependencies to the frontend, and the frontend is responsible for ensuring they're installed. So setuptools (acting as a backend) should not try to install them. """ orig = setuptools._install_setup_requires setuptools._install_setup_requires = lambda attrs: None try: yield finally: setuptools._install_setup_requires = orig def _get_immediate_subdirectories(a_dir): return [ name for name in os.listdir(a_dir) if os.path.isdir(os.path.join(a_dir, name)) ] def _file_with_extension(directory: StrPath, extension: str | tuple[str, ...]): matching = (f for f in os.listdir(directory) if f.endswith(extension)) try: (file,) = matching except ValueError: raise ValueError( 'No distribution was found. Ensure that `setup.py` ' 'is not empty and that it calls `setup()`.' ) from None return file def _open_setup_script(setup_script): if not os.path.exists(setup_script): # Supply a default setup.py return io.StringIO("from setuptools import setup; setup()") return tokenize.open(setup_script) @contextlib.contextmanager def suppress_known_deprecation(): with warnings.catch_warnings(): warnings.filterwarnings('ignore', 'setup.py install is deprecated') yield _ConfigSettings: TypeAlias = Union[Mapping[str, Union[str, list[str], None]], None] """ Currently the user can run:: pip install -e . --config-settings key=value python -m build -C--key=value -C key=value - pip will pass both key and value as strings and overwriting repeated keys (pypa/pip#11059). - build will accumulate values associated with repeated keys in a list. It will also accept keys with no associated value. This means that an option passed by build can be ``str | list[str] | None``. - PEP 517 specifies that ``config_settings`` is an optional dict. """ class _ConfigSettingsTranslator: """Translate ``config_settings`` into distutils-style command arguments. Only a limited number of options is currently supported. """ # See pypa/setuptools#1928 pypa/setuptools#2491 def _get_config(self, key: str, config_settings: _ConfigSettings) -> list[str]: """ Get the value of a specific key in ``config_settings`` as a list of strings. >>> fn = _ConfigSettingsTranslator()._get_config >>> fn("--global-option", None) [] >>> fn("--global-option", {}) [] >>> fn("--global-option", {'--global-option': 'foo'}) ['foo'] >>> fn("--global-option", {'--global-option': ['foo']}) ['foo'] >>> fn("--global-option", {'--global-option': 'foo'}) ['foo'] >>> fn("--global-option", {'--global-option': 'foo bar'}) ['foo', 'bar'] """ cfg = config_settings or {} opts = cfg.get(key) or [] return shlex.split(opts) if isinstance(opts, str) else opts def _global_args(self, config_settings: _ConfigSettings) -> Iterator[str]: """ Let the user specify ``verbose`` or ``quiet`` + escape hatch via ``--global-option``. Note: ``-v``, ``-vv``, ``-vvv`` have similar effects in setuptools, so we just have to cover the basic scenario ``-v``. >>> fn = _ConfigSettingsTranslator()._global_args >>> list(fn(None)) [] >>> list(fn({"verbose": "False"})) ['-q'] >>> list(fn({"verbose": "1"})) ['-v'] >>> list(fn({"--verbose": None})) ['-v'] >>> list(fn({"verbose": "true", "--global-option": "-q --no-user-cfg"})) ['-v', '-q', '--no-user-cfg'] >>> list(fn({"--quiet": None})) ['-q'] """ cfg = config_settings or {} falsey = {"false", "no", "0", "off"} if "verbose" in cfg or "--verbose" in cfg: level = str(cfg.get("verbose") or cfg.get("--verbose") or "1") yield ("-q" if level.lower() in falsey else "-v") if "quiet" in cfg or "--quiet" in cfg: level = str(cfg.get("quiet") or cfg.get("--quiet") or "1") yield ("-v" if level.lower() in falsey else "-q") yield from self._get_config("--global-option", config_settings) def __dist_info_args(self, config_settings: _ConfigSettings) -> Iterator[str]: """ The ``dist_info`` command accepts ``tag-date`` and ``tag-build``. .. warning:: We cannot use this yet as it requires the ``sdist`` and ``bdist_wheel`` commands run in ``build_sdist`` and ``build_wheel`` to reuse the egg-info directory created in ``prepare_metadata_for_build_wheel``. >>> fn = _ConfigSettingsTranslator()._ConfigSettingsTranslator__dist_info_args >>> list(fn(None)) [] >>> list(fn({"tag-date": "False"})) ['--no-date'] >>> list(fn({"tag-date": None})) ['--no-date'] >>> list(fn({"tag-date": "true", "tag-build": ".a"})) ['--tag-date', '--tag-build', '.a'] """ cfg = config_settings or {} if "tag-date" in cfg: val = strtobool(str(cfg["tag-date"] or "false")) yield ("--tag-date" if val else "--no-date") if "tag-build" in cfg: yield from ["--tag-build", str(cfg["tag-build"])] def _editable_args(self, config_settings: _ConfigSettings) -> Iterator[str]: """ The ``editable_wheel`` command accepts ``editable-mode=strict``. >>> fn = _ConfigSettingsTranslator()._editable_args >>> list(fn(None)) [] >>> list(fn({"editable-mode": "strict"})) ['--mode', 'strict'] """ cfg = config_settings or {} mode = cfg.get("editable-mode") or cfg.get("editable_mode") if not mode: return yield from ["--mode", str(mode)] def _arbitrary_args(self, config_settings: _ConfigSettings) -> Iterator[str]: """ Users may expect to pass arbitrary lists of arguments to a command via "--global-option" (example provided in PEP 517 of a "escape hatch"). >>> fn = _ConfigSettingsTranslator()._arbitrary_args >>> list(fn(None)) [] >>> list(fn({})) [] >>> list(fn({'--build-option': 'foo'})) ['foo'] >>> list(fn({'--build-option': ['foo']})) ['foo'] >>> list(fn({'--build-option': 'foo'})) ['foo'] >>> list(fn({'--build-option': 'foo bar'})) ['foo', 'bar'] >>> list(fn({'--global-option': 'foo'})) [] """ yield from self._get_config("--build-option", config_settings) class _BuildMetaBackend(_ConfigSettingsTranslator): def _get_build_requires( self, config_settings: _ConfigSettings, requirements: list[str] ): sys.argv = [ *sys.argv[:1], *self._global_args(config_settings), "egg_info", ] try: with Distribution.patch(): self.run_setup() except SetupRequirementsError as e: requirements += e.specifiers return requirements def run_setup(self, setup_script: str = 'setup.py'): # Note that we can reuse our build directory between calls # Correctness comes first, then optimization later __file__ = os.path.abspath(setup_script) __name__ = '__main__' with _open_setup_script(__file__) as f: code = f.read().replace(r'\r\n', r'\n') try: exec(code, locals()) except SystemExit as e: if e.code: raise # We ignore exit code indicating success SetuptoolsDeprecationWarning.emit( "Running `setup.py` directly as CLI tool is deprecated.", "Please avoid using `sys.exit(0)` or similar statements " "that don't fit in the paradigm of a configuration file.", see_url="https://blog.ganssle.io/articles/2021/10/" "setup-py-deprecated.html", ) def get_requires_for_build_wheel(self, config_settings: _ConfigSettings = None): return self._get_build_requires(config_settings, requirements=[]) def get_requires_for_build_sdist(self, config_settings: _ConfigSettings = None): return self._get_build_requires(config_settings, requirements=[]) def _bubble_up_info_directory( self, metadata_directory: StrPath, suffix: str ) -> str: """ PEP 517 requires that the .dist-info directory be placed in the metadata_directory. To comply, we MUST copy the directory to the root. Returns the basename of the info directory, e.g. `proj-0.0.0.dist-info`. """ info_dir = self._find_info_directory(metadata_directory, suffix) if not same_path(info_dir.parent, metadata_directory): shutil.move(str(info_dir), metadata_directory) # PEP 517 allow other files and dirs to exist in metadata_directory return info_dir.name def _find_info_directory(self, metadata_directory: StrPath, suffix: str) -> Path: for parent, dirs, _ in os.walk(metadata_directory): candidates = [f for f in dirs if f.endswith(suffix)] if len(candidates) != 0 or len(dirs) != 1: assert len(candidates) == 1, f"Multiple {suffix} directories found" return Path(parent, candidates[0]) msg = f"No {suffix} directory found in {metadata_directory}" raise errors.InternalError(msg) def prepare_metadata_for_build_wheel( self, metadata_directory: StrPath, config_settings: _ConfigSettings = None ): sys.argv = [ *sys.argv[:1], *self._global_args(config_settings), "dist_info", "--output-dir", str(metadata_directory), "--keep-egg-info", ] with no_install_setup_requires(): self.run_setup() self._bubble_up_info_directory(metadata_directory, ".egg-info") return self._bubble_up_info_directory(metadata_directory, ".dist-info") def _build_with_temp_dir( self, setup_command: Iterable[str], result_extension: str | tuple[str, ...], result_directory: StrPath, config_settings: _ConfigSettings, arbitrary_args: Iterable[str] = (), ): result_directory = os.path.abspath(result_directory) # Build in a temporary directory, then copy to the target. os.makedirs(result_directory, exist_ok=True) with tempfile.TemporaryDirectory( prefix=".tmp-", dir=result_directory ) as tmp_dist_dir: sys.argv = [ *sys.argv[:1], *self._global_args(config_settings), *setup_command, "--dist-dir", tmp_dist_dir, *arbitrary_args, ] with no_install_setup_requires(): self.run_setup() result_basename = _file_with_extension(tmp_dist_dir, result_extension) result_path = os.path.join(result_directory, result_basename) if os.path.exists(result_path): # os.rename will fail overwriting on non-Unix. os.remove(result_path) os.rename(os.path.join(tmp_dist_dir, result_basename), result_path) return result_basename def build_wheel( self, wheel_directory: StrPath, config_settings: _ConfigSettings = None, metadata_directory: StrPath | None = None, ): def _build(cmd: list[str]): with suppress_known_deprecation(): return self._build_with_temp_dir( cmd, '.whl', wheel_directory, config_settings, self._arbitrary_args(config_settings), ) if metadata_directory is None: return _build(['bdist_wheel']) try: return _build(['bdist_wheel', '--dist-info-dir', str(metadata_directory)]) except SystemExit as ex: # pragma: nocover # pypa/setuptools#4683 if "--dist-info-dir not recognized" not in str(ex): raise _IncompatibleBdistWheel.emit() return _build(['bdist_wheel']) def build_sdist( self, sdist_directory: StrPath, config_settings: _ConfigSettings = None ): return self._build_with_temp_dir( ['sdist', '--formats', 'gztar'], '.tar.gz', sdist_directory, config_settings ) def _get_dist_info_dir(self, metadata_directory: StrPath | None) -> str | None: if not metadata_directory: return None dist_info_candidates = list(Path(metadata_directory).glob("*.dist-info")) assert len(dist_info_candidates) <= 1 return str(dist_info_candidates[0]) if dist_info_candidates else None def build_editable( self, wheel_directory: StrPath, config_settings: _ConfigSettings = None, metadata_directory: StrPath | None = None, ): # XXX can or should we hide our editable_wheel command normally? info_dir = self._get_dist_info_dir(metadata_directory) opts = ["--dist-info-dir", info_dir] if info_dir else [] cmd = ["editable_wheel", *opts, *self._editable_args(config_settings)] with suppress_known_deprecation(): return self._build_with_temp_dir( cmd, ".whl", wheel_directory, config_settings ) def get_requires_for_build_editable(self, config_settings: _ConfigSettings = None): return self.get_requires_for_build_wheel(config_settings) def prepare_metadata_for_build_editable( self, metadata_directory: StrPath, config_settings: _ConfigSettings = None ): return self.prepare_metadata_for_build_wheel( metadata_directory, config_settings ) class _BuildMetaLegacyBackend(_BuildMetaBackend): """Compatibility backend for setuptools This is a version of setuptools.build_meta that endeavors to maintain backwards compatibility with pre-PEP 517 modes of invocation. It exists as a temporary bridge between the old packaging mechanism and the new packaging mechanism, and will eventually be removed. """ def run_setup(self, setup_script: str = 'setup.py'): # In order to maintain compatibility with scripts assuming that # the setup.py script is in a directory on the PYTHONPATH, inject # '' into sys.path. (pypa/setuptools#1642) sys_path = list(sys.path) # Save the original path script_dir = os.path.dirname(os.path.abspath(setup_script)) if script_dir not in sys.path: sys.path.insert(0, script_dir) # Some setup.py scripts (e.g. in pygame and numpy) use sys.argv[0] to # get the directory of the source code. They expect it to refer to the # setup.py script. sys_argv_0 = sys.argv[0] sys.argv[0] = setup_script try: super().run_setup(setup_script=setup_script) finally: # While PEP 517 frontends should be calling each hook in a fresh # subprocess according to the standard (and thus it should not be # strictly necessary to restore the old sys.path), we'll restore # the original path so that the path manipulation does not persist # within the hook after run_setup is called. sys.path[:] = sys_path sys.argv[0] = sys_argv_0 class _IncompatibleBdistWheel(SetuptoolsDeprecationWarning): _SUMMARY = "wheel.bdist_wheel is deprecated, please import it from setuptools" _DETAILS = """ Ensure that any custom bdist_wheel implementation is a subclass of setuptools.command.bdist_wheel.bdist_wheel. """ _DUE_DATE = (2025, 10, 15) # Initially introduced in 2024/10/15, but maybe too disruptive to be enforced? _SEE_URL = "https://github.com/pypa/wheel/pull/631" # The primary backend _BACKEND = _BuildMetaBackend() get_requires_for_build_wheel = _BACKEND.get_requires_for_build_wheel get_requires_for_build_sdist = _BACKEND.get_requires_for_build_sdist prepare_metadata_for_build_wheel = _BACKEND.prepare_metadata_for_build_wheel build_wheel = _BACKEND.build_wheel build_sdist = _BACKEND.build_sdist get_requires_for_build_editable = _BACKEND.get_requires_for_build_editable prepare_metadata_for_build_editable = _BACKEND.prepare_metadata_for_build_editable build_editable = _BACKEND.build_editable # The legacy backend __legacy__ = _BuildMetaLegacyBackend() _path.py 0000644 00000005175 15030122015 0006206 0 ustar 00 from __future__ import annotations import contextlib import os import sys from typing import TYPE_CHECKING, TypeVar, Union from more_itertools import unique_everseen if TYPE_CHECKING: from typing_extensions import TypeAlias StrPath: TypeAlias = Union[str, os.PathLike[str]] # Same as _typeshed.StrPath StrPathT = TypeVar("StrPathT", bound=Union[str, os.PathLike[str]]) def ensure_directory(path): """Ensure that the parent directory of `path` exists""" dirname = os.path.dirname(path) os.makedirs(dirname, exist_ok=True) def same_path(p1: StrPath, p2: StrPath) -> bool: """Differs from os.path.samefile because it does not require paths to exist. Purely string based (no comparison between i-nodes). >>> same_path("a/b", "./a/b") True >>> same_path("a/b", "a/./b") True >>> same_path("a/b", "././a/b") True >>> same_path("a/b", "./a/b/c/..") True >>> same_path("a/b", "../a/b/c") False >>> same_path("a", "a/b") False """ return normpath(p1) == normpath(p2) def normpath(filename: StrPath) -> str: """Normalize a file/dir name for comparison purposes.""" # See pkg_resources.normalize_path for notes about cygwin file = os.path.abspath(filename) if sys.platform == 'cygwin' else filename return os.path.normcase(os.path.realpath(os.path.normpath(file))) @contextlib.contextmanager def paths_on_pythonpath(paths): """ Add the indicated paths to the head of the PYTHONPATH environment variable so that subprocesses will also see the packages at these paths. Do this in a context that restores the value on exit. >>> getfixture('monkeypatch').setenv('PYTHONPATH', 'anything') >>> with paths_on_pythonpath(['foo', 'bar']): ... assert 'foo' in os.environ['PYTHONPATH'] ... assert 'anything' in os.environ['PYTHONPATH'] >>> os.environ['PYTHONPATH'] 'anything' >>> getfixture('monkeypatch').delenv('PYTHONPATH') >>> with paths_on_pythonpath(['foo', 'bar']): ... assert 'foo' in os.environ['PYTHONPATH'] >>> os.environ.get('PYTHONPATH') """ nothing = object() orig_pythonpath = os.environ.get('PYTHONPATH', nothing) current_pythonpath = os.environ.get('PYTHONPATH', '') try: prefix = os.pathsep.join(unique_everseen(paths)) to_join = filter(None, [prefix, current_pythonpath]) new_path = os.pathsep.join(to_join) if new_path: os.environ['PYTHONPATH'] = new_path yield finally: if orig_pythonpath is nothing: os.environ.pop('PYTHONPATH', None) else: os.environ['PYTHONPATH'] = orig_pythonpath package_index.py 0000644 00000116553 15030122015 0007700 0 ustar 00 """PyPI and direct package downloading.""" from __future__ import annotations import base64 import configparser import hashlib import html import http.client import io import itertools import os import re import shutil import socket import subprocess import sys import urllib.error import urllib.parse import urllib.request from fnmatch import translate from functools import wraps from typing import NamedTuple from more_itertools import unique_everseen import setuptools from pkg_resources import ( BINARY_DIST, CHECKOUT_DIST, DEVELOP_DIST, EGG_DIST, SOURCE_DIST, Distribution, Environment, Requirement, find_distributions, normalize_path, parse_version, safe_name, safe_version, to_filename, ) from setuptools.wheel import Wheel from .unicode_utils import _cfg_read_utf8_with_fallback, _read_utf8_with_fallback from distutils import log from distutils.errors import DistutilsError EGG_FRAGMENT = re.compile(r'^egg=([-A-Za-z0-9_.+!]+)$') HREF = re.compile(r"""href\s*=\s*['"]?([^'"> ]+)""", re.I) PYPI_MD5 = re.compile( r'<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)' r'href="[^?]+\?:action=show_md5&digest=([0-9a-f]{32})">md5</a>\)' ) URL_SCHEME = re.compile('([-+.a-z0-9]{2,}):', re.I).match EXTENSIONS = ".tar.gz .tar.bz2 .tar .zip .tgz".split() __all__ = [ 'PackageIndex', 'distros_for_url', 'parse_bdist_wininst', 'interpret_distro_name', ] _SOCKET_TIMEOUT = 15 user_agent = f"setuptools/{setuptools.__version__} Python-urllib/{sys.version_info.major}.{sys.version_info.minor}" def parse_requirement_arg(spec): try: return Requirement.parse(spec) except ValueError as e: raise DistutilsError( f"Not a URL, existing file, or requirement spec: {spec!r}" ) from e def parse_bdist_wininst(name): """Return (base,pyversion) or (None,None) for possible .exe name""" lower = name.lower() base, py_ver, plat = None, None, None if lower.endswith('.exe'): if lower.endswith('.win32.exe'): base = name[:-10] plat = 'win32' elif lower.startswith('.win32-py', -16): py_ver = name[-7:-4] base = name[:-16] plat = 'win32' elif lower.endswith('.win-amd64.exe'): base = name[:-14] plat = 'win-amd64' elif lower.startswith('.win-amd64-py', -20): py_ver = name[-7:-4] base = name[:-20] plat = 'win-amd64' return base, py_ver, plat def egg_info_for_url(url): parts = urllib.parse.urlparse(url) _scheme, server, path, _parameters, _query, fragment = parts base = urllib.parse.unquote(path.split('/')[-1]) if server == 'sourceforge.net' and base == 'download': # XXX Yuck base = urllib.parse.unquote(path.split('/')[-2]) if '#' in base: base, fragment = base.split('#', 1) return base, fragment def distros_for_url(url, metadata=None): """Yield egg or source distribution objects that might be found at a URL""" base, fragment = egg_info_for_url(url) yield from distros_for_location(url, base, metadata) if fragment: match = EGG_FRAGMENT.match(fragment) if match: yield from interpret_distro_name( url, match.group(1), metadata, precedence=CHECKOUT_DIST ) def distros_for_location(location, basename, metadata=None): """Yield egg or source distribution objects based on basename""" if basename.endswith('.egg.zip'): basename = basename[:-4] # strip the .zip if basename.endswith('.egg') and '-' in basename: # only one, unambiguous interpretation return [Distribution.from_location(location, basename, metadata)] if basename.endswith('.whl') and '-' in basename: wheel = Wheel(basename) if not wheel.is_compatible(): return [] return [ Distribution( location=location, project_name=wheel.project_name, version=wheel.version, # Increase priority over eggs. precedence=EGG_DIST + 1, ) ] if basename.endswith('.exe'): win_base, py_ver, platform = parse_bdist_wininst(basename) if win_base is not None: return interpret_distro_name( location, win_base, metadata, py_ver, BINARY_DIST, platform ) # Try source distro extensions (.zip, .tgz, etc.) # for ext in EXTENSIONS: if basename.endswith(ext): basename = basename[: -len(ext)] return interpret_distro_name(location, basename, metadata) return [] # no extension matched def distros_for_filename(filename, metadata=None): """Yield possible egg or source distribution objects based on a filename""" return distros_for_location( normalize_path(filename), os.path.basename(filename), metadata ) def interpret_distro_name( location, basename, metadata, py_version=None, precedence=SOURCE_DIST, platform=None ): """Generate the interpretation of a source distro name Note: if `location` is a filesystem filename, you should call ``pkg_resources.normalize_path()`` on it before passing it to this routine! """ parts = basename.split('-') if not py_version and any(re.match(r'py\d\.\d$', p) for p in parts[2:]): # it is a bdist_dumb, not an sdist -- bail out return # find the pivot (p) that splits the name from the version. # infer the version as the first item that has a digit. for p in range(len(parts)): if parts[p][:1].isdigit(): break else: p = len(parts) yield Distribution( location, metadata, '-'.join(parts[:p]), '-'.join(parts[p:]), py_version=py_version, precedence=precedence, platform=platform, ) def unique_values(func): """ Wrap a function returning an iterable such that the resulting iterable only ever yields unique items. """ @wraps(func) def wrapper(*args, **kwargs): return unique_everseen(func(*args, **kwargs)) return wrapper REL = re.compile(r"""<([^>]*\srel\s{0,10}=\s{0,10}['"]?([^'" >]+)[^>]*)>""", re.I) """ Regex for an HTML tag with 'rel="val"' attributes. """ @unique_values def find_external_links(url, page): """Find rel="homepage" and rel="download" links in `page`, yielding URLs""" for match in REL.finditer(page): tag, rel = match.groups() rels = set(map(str.strip, rel.lower().split(','))) if 'homepage' in rels or 'download' in rels: for match in HREF.finditer(tag): yield urllib.parse.urljoin(url, htmldecode(match.group(1))) for tag in ("<th>Home Page", "<th>Download URL"): pos = page.find(tag) if pos != -1: match = HREF.search(page, pos) if match: yield urllib.parse.urljoin(url, htmldecode(match.group(1))) class ContentChecker: """ A null content checker that defines the interface for checking content """ def feed(self, block): """ Feed a block of data to the hash. """ return def is_valid(self): """ Check the hash. Return False if validation fails. """ return True def report(self, reporter, template): """ Call reporter with information about the checker (hash name) substituted into the template. """ return class HashChecker(ContentChecker): pattern = re.compile( r'(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)=' r'(?P<expected>[a-f0-9]+)' ) def __init__(self, hash_name, expected) -> None: self.hash_name = hash_name self.hash = hashlib.new(hash_name) self.expected = expected @classmethod def from_url(cls, url): "Construct a (possibly null) ContentChecker from a URL" fragment = urllib.parse.urlparse(url)[-1] if not fragment: return ContentChecker() match = cls.pattern.search(fragment) if not match: return ContentChecker() return cls(**match.groupdict()) def feed(self, block): self.hash.update(block) def is_valid(self): return self.hash.hexdigest() == self.expected def report(self, reporter, template): msg = template % self.hash_name return reporter(msg) class PackageIndex(Environment): """A distribution index that scans web pages for download URLs""" def __init__( self, index_url: str = "https://pypi.org/simple/", hosts=('*',), ca_bundle=None, verify_ssl: bool = True, *args, **kw, ) -> None: super().__init__(*args, **kw) self.index_url = index_url + "/"[: not index_url.endswith('/')] self.scanned_urls: dict = {} self.fetched_urls: dict = {} self.package_pages: dict = {} self.allows = re.compile('|'.join(map(translate, hosts))).match self.to_scan: list = [] self.opener = urllib.request.urlopen def add(self, dist): # ignore invalid versions try: parse_version(dist.version) except Exception: return None return super().add(dist) # FIXME: 'PackageIndex.process_url' is too complex (14) def process_url(self, url, retrieve: bool = False) -> None: # noqa: C901 """Evaluate a URL as a possible download, and maybe retrieve it""" if url in self.scanned_urls and not retrieve: return self.scanned_urls[url] = True if not URL_SCHEME(url): self.process_filename(url) return else: dists = list(distros_for_url(url)) if dists: if not self.url_ok(url): return self.debug("Found link: %s", url) if dists or not retrieve or url in self.fetched_urls: list(map(self.add, dists)) return # don't need the actual page if not self.url_ok(url): self.fetched_urls[url] = True return self.info("Reading %s", url) self.fetched_urls[url] = True # prevent multiple fetch attempts tmpl = "Download error on %s: %%s -- Some packages may not be found!" f = self.open_url(url, tmpl % url) if f is None: return if isinstance(f, urllib.error.HTTPError) and f.code == 401: self.info(f"Authentication error: {f.msg}") self.fetched_urls[f.url] = True if 'html' not in f.headers.get('content-type', '').lower(): f.close() # not html, we can't process it return base = f.url # handle redirects page = f.read() if not isinstance(page, str): # In Python 3 and got bytes but want str. if isinstance(f, urllib.error.HTTPError): # Errors have no charset, assume latin1: charset = 'latin-1' else: charset = f.headers.get_param('charset') or 'latin-1' page = page.decode(charset, "ignore") f.close() for match in HREF.finditer(page): link = urllib.parse.urljoin(base, htmldecode(match.group(1))) self.process_url(link) if url.startswith(self.index_url) and getattr(f, 'code', None) != 404: page = self.process_index(url, page) def process_filename(self, fn, nested: bool = False) -> None: # process filenames or directories if not os.path.exists(fn): self.warn("Not found: %s", fn) return if os.path.isdir(fn) and not nested: path = os.path.realpath(fn) for item in os.listdir(path): self.process_filename(os.path.join(path, item), True) dists = distros_for_filename(fn) if dists: self.debug("Found: %s", fn) list(map(self.add, dists)) def url_ok(self, url, fatal: bool = False) -> bool: s = URL_SCHEME(url) is_file = s and s.group(1).lower() == 'file' if is_file or self.allows(urllib.parse.urlparse(url)[1]): return True msg = ( "\nNote: Bypassing %s (disallowed host; see " "https://setuptools.pypa.io/en/latest/deprecated/" "easy_install.html#restricting-downloads-with-allow-hosts for details).\n" ) if fatal: raise DistutilsError(msg % url) else: self.warn(msg, url) return False def scan_egg_links(self, search_path) -> None: dirs = filter(os.path.isdir, search_path) egg_links = ( (path, entry) for path in dirs for entry in os.listdir(path) if entry.endswith('.egg-link') ) list(itertools.starmap(self.scan_egg_link, egg_links)) def scan_egg_link(self, path, entry) -> None: content = _read_utf8_with_fallback(os.path.join(path, entry)) # filter non-empty lines lines = list(filter(None, map(str.strip, content.splitlines()))) if len(lines) != 2: # format is not recognized; punt return egg_path, _setup_path = lines for dist in find_distributions(os.path.join(path, egg_path)): dist.location = os.path.join(path, *lines) dist.precedence = SOURCE_DIST self.add(dist) def _scan(self, link): # Process a URL to see if it's for a package page NO_MATCH_SENTINEL = None, None if not link.startswith(self.index_url): return NO_MATCH_SENTINEL parts = list(map(urllib.parse.unquote, link[len(self.index_url) :].split('/'))) if len(parts) != 2 or '#' in parts[1]: return NO_MATCH_SENTINEL # it's a package page, sanitize and index it pkg = safe_name(parts[0]) ver = safe_version(parts[1]) self.package_pages.setdefault(pkg.lower(), {})[link] = True return to_filename(pkg), to_filename(ver) def process_index(self, url, page): """Process the contents of a PyPI page""" # process an index page into the package-page index for match in HREF.finditer(page): try: self._scan(urllib.parse.urljoin(url, htmldecode(match.group(1)))) except ValueError: pass pkg, ver = self._scan(url) # ensure this page is in the page index if not pkg: return "" # no sense double-scanning non-package pages # process individual package page for new_url in find_external_links(url, page): # Process the found URL base, frag = egg_info_for_url(new_url) if base.endswith('.py') and not frag: if ver: new_url += f'#egg={pkg}-{ver}' else: self.need_version_info(url) self.scan_url(new_url) return PYPI_MD5.sub( lambda m: '<a href="{}#md5={}">{}</a>'.format(*m.group(1, 3, 2)), page ) def need_version_info(self, url) -> None: self.scan_all( "Page at %s links to .py file(s) without version info; an index " "scan is required.", url, ) def scan_all(self, msg=None, *args) -> None: if self.index_url not in self.fetched_urls: if msg: self.warn(msg, *args) self.info("Scanning index of all packages (this may take a while)") self.scan_url(self.index_url) def find_packages(self, requirement) -> None: self.scan_url(self.index_url + requirement.unsafe_name + '/') if not self.package_pages.get(requirement.key): # Fall back to safe version of the name self.scan_url(self.index_url + requirement.project_name + '/') if not self.package_pages.get(requirement.key): # We couldn't find the target package, so search the index page too self.not_found_in_index(requirement) for url in list(self.package_pages.get(requirement.key, ())): # scan each page that might be related to the desired package self.scan_url(url) def obtain(self, requirement, installer=None): self.prescan() self.find_packages(requirement) for dist in self[requirement.key]: if dist in requirement: return dist self.debug("%s does not match %s", requirement, dist) return super().obtain(requirement, installer) def check_hash(self, checker, filename, tfp) -> None: """ checker is a ContentChecker """ checker.report(self.debug, f"Validating %s checksum for {filename}") if not checker.is_valid(): tfp.close() os.unlink(filename) raise DistutilsError( f"{checker.hash.name} validation failed for {os.path.basename(filename)}; " "possible download problem?" ) def add_find_links(self, urls) -> None: """Add `urls` to the list that will be prescanned for searches""" for url in urls: if ( self.to_scan is None # if we have already "gone online" or not URL_SCHEME(url) # or it's a local file/directory or url.startswith('file:') or list(distros_for_url(url)) # or a direct package link ): # then go ahead and process it now self.scan_url(url) else: # otherwise, defer retrieval till later self.to_scan.append(url) def prescan(self): """Scan urls scheduled for prescanning (e.g. --find-links)""" if self.to_scan: list(map(self.scan_url, self.to_scan)) self.to_scan = None # from now on, go ahead and process immediately def not_found_in_index(self, requirement) -> None: if self[requirement.key]: # we've seen at least one distro meth, msg = self.info, "Couldn't retrieve index page for %r" else: # no distros seen for this name, might be misspelled meth, msg = self.warn, "Couldn't find index page for %r (maybe misspelled?)" meth(msg, requirement.unsafe_name) self.scan_all() def download(self, spec, tmpdir): """Locate and/or download `spec` to `tmpdir`, returning a local path `spec` may be a ``Requirement`` object, or a string containing a URL, an existing local filename, or a project/version requirement spec (i.e. the string form of a ``Requirement`` object). If it is the URL of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is automatically created alongside the downloaded file. If `spec` is a ``Requirement`` object or a string containing a project/version requirement spec, this method returns the location of a matching distribution (possibly after downloading it to `tmpdir`). If `spec` is a locally existing file or directory name, it is simply returned unchanged. If `spec` is a URL, it is downloaded to a subpath of `tmpdir`, and the local filename is returned. Various errors may be raised if a problem occurs during downloading. """ if not isinstance(spec, Requirement): scheme = URL_SCHEME(spec) if scheme: # It's a url, download it to tmpdir found = self._download_url(spec, tmpdir) base, fragment = egg_info_for_url(spec) if base.endswith('.py'): found = self.gen_setup(found, fragment, tmpdir) return found elif os.path.exists(spec): # Existing file or directory, just return it return spec else: spec = parse_requirement_arg(spec) return getattr(self.fetch_distribution(spec, tmpdir), 'location', None) def fetch_distribution( # noqa: C901 # is too complex (14) # FIXME self, requirement, tmpdir, force_scan: bool = False, source: bool = False, develop_ok: bool = False, local_index=None, ) -> Distribution | None: """Obtain a distribution suitable for fulfilling `requirement` `requirement` must be a ``pkg_resources.Requirement`` instance. If necessary, or if the `force_scan` flag is set, the requirement is searched for in the (online) package index as well as the locally installed packages. If a distribution matching `requirement` is found, the returned distribution's ``location`` is the value you would have gotten from calling the ``download()`` method with the matching distribution's URL or filename. If no matching distribution is found, ``None`` is returned. If the `source` flag is set, only source distributions and source checkout links will be considered. Unless the `develop_ok` flag is set, development and system eggs (i.e., those using the ``.egg-info`` format) will be ignored. """ # process a Requirement self.info("Searching for %s", requirement) skipped = set() dist = None def find(req, env: Environment | None = None): if env is None: env = self # Find a matching distribution; may be called more than once for dist in env[req.key]: if dist.precedence == DEVELOP_DIST and not develop_ok: if dist not in skipped: self.warn( "Skipping development or system egg: %s", dist, ) skipped.add(dist) continue test = dist in req and (dist.precedence <= SOURCE_DIST or not source) if test: loc = self.download(dist.location, tmpdir) dist.download_location = loc if os.path.exists(dist.download_location): return dist return None if force_scan: self.prescan() self.find_packages(requirement) dist = find(requirement) if not dist and local_index is not None: dist = find(requirement, local_index) if dist is None: if self.to_scan is not None: self.prescan() dist = find(requirement) if dist is None and not force_scan: self.find_packages(requirement) dist = find(requirement) if dist is None: self.warn( "No local packages or working download links found for %s%s", (source and "a source distribution of " or ""), requirement, ) return None else: self.info("Best match: %s", dist) return dist.clone(location=dist.download_location) def fetch( self, requirement, tmpdir, force_scan: bool = False, source: bool = False ) -> str | None: """Obtain a file suitable for fulfilling `requirement` DEPRECATED; use the ``fetch_distribution()`` method now instead. For backward compatibility, this routine is identical but returns the ``location`` of the downloaded distribution instead of a distribution object. """ dist = self.fetch_distribution(requirement, tmpdir, force_scan, source) if dist is not None: return dist.location return None def gen_setup(self, filename, fragment, tmpdir): match = EGG_FRAGMENT.match(fragment) dists = ( match and [ d for d in interpret_distro_name(filename, match.group(1), None) if d.version ] or [] ) if len(dists) == 1: # unambiguous ``#egg`` fragment basename = os.path.basename(filename) # Make sure the file has been downloaded to the temp dir. if os.path.dirname(filename) != tmpdir: dst = os.path.join(tmpdir, basename) if not (os.path.exists(dst) and os.path.samefile(filename, dst)): shutil.copy2(filename, dst) filename = dst with open(os.path.join(tmpdir, 'setup.py'), 'w', encoding="utf-8") as file: file.write( "from setuptools import setup\n" f"setup(name={dists[0].project_name!r}, version={dists[0].version!r}, py_modules=[{os.path.splitext(basename)[0]!r}])\n" ) return filename elif match: raise DistutilsError( f"Can't unambiguously interpret project/version identifier {fragment!r}; " "any dashes in the name or version should be escaped using " f"underscores. {dists!r}" ) else: raise DistutilsError( "Can't process plain .py files without an '#egg=name-version'" " suffix to enable automatic setup script generation." ) dl_blocksize = 8192 def _download_to(self, url, filename): self.info("Downloading %s", url) # Download the file fp = None try: checker = HashChecker.from_url(url) fp = self.open_url(url) if isinstance(fp, urllib.error.HTTPError): raise DistutilsError(f"Can't download {url}: {fp.code} {fp.msg}") headers = fp.info() blocknum = 0 bs = self.dl_blocksize size = -1 if "content-length" in headers: # Some servers return multiple Content-Length headers :( sizes = headers.get_all('Content-Length') size = max(map(int, sizes)) self.reporthook(url, filename, blocknum, bs, size) with open(filename, 'wb') as tfp: while True: block = fp.read(bs) if block: checker.feed(block) tfp.write(block) blocknum += 1 self.reporthook(url, filename, blocknum, bs, size) else: break self.check_hash(checker, filename, tfp) return headers finally: if fp: fp.close() def reporthook(self, url, filename, blocknum, blksize, size) -> None: pass # no-op # FIXME: def open_url(self, url, warning=None): # noqa: C901 # is too complex (12) if url.startswith('file:'): return local_open(url) try: return open_with_auth(url, self.opener) except (ValueError, http.client.InvalidURL) as v: msg = ' '.join([str(arg) for arg in v.args]) if warning: self.warn(warning, msg) else: raise DistutilsError(f'{url} {msg}') from v except urllib.error.HTTPError as v: return v except urllib.error.URLError as v: if warning: self.warn(warning, v.reason) else: raise DistutilsError(f"Download error for {url}: {v.reason}") from v except http.client.BadStatusLine as v: if warning: self.warn(warning, v.line) else: raise DistutilsError( f'{url} returned a bad status line. The server might be ' f'down, {v.line}' ) from v except (http.client.HTTPException, OSError) as v: if warning: self.warn(warning, v) else: raise DistutilsError(f"Download error for {url}: {v}") from v @staticmethod def _sanitize(name): r""" Replace unsafe path directives with underscores. >>> san = PackageIndex._sanitize >>> san('/home/user/.ssh/authorized_keys') '_home_user_.ssh_authorized_keys' >>> san('..\\foo\\bing') '__foo_bing' >>> san('D:bar') 'D_bar' >>> san('C:\\bar') 'C__bar' >>> san('foo..bar') 'foo..bar' >>> san('D:../foo') 'D___foo' """ pattern = '|'.join(( # drive letters r':', # path separators r'[/\\]', # parent dirs r'(?:(?<=([/\\]|:))\.\.(?=[/\\]|$))|(?:^\.\.(?=[/\\]|$))', )) return re.sub(pattern, r'_', name) @classmethod def _resolve_download_filename(cls, url, tmpdir): """ >>> import pathlib >>> du = PackageIndex._resolve_download_filename >>> root = getfixture('tmp_path') >>> url = 'https://files.pythonhosted.org/packages/a9/5a/0db.../setuptools-78.1.0.tar.gz' >>> str(pathlib.Path(du(url, root)).relative_to(root)) 'setuptools-78.1.0.tar.gz' """ name, _fragment = egg_info_for_url(url) name = cls._sanitize( name or # default if URL has no path contents '__downloaded__' ) # strip any extra .zip before download name = re.sub(r'\.egg\.zip$', '.egg', name) return os.path.join(tmpdir, name) def _download_url(self, url, tmpdir): """ Determine the download filename. """ filename = self._resolve_download_filename(url, tmpdir) return self._download_vcs(url, filename) or self._download_other(url, filename) @staticmethod def _resolve_vcs(url): """ >>> rvcs = PackageIndex._resolve_vcs >>> rvcs('git+http://foo/bar') 'git' >>> rvcs('hg+https://foo/bar') 'hg' >>> rvcs('git:myhost') 'git' >>> rvcs('hg:myhost') >>> rvcs('http://foo/bar') """ scheme = urllib.parse.urlsplit(url).scheme pre, sep, _post = scheme.partition('+') # svn and git have their own protocol; hg does not allowed = set(['svn', 'git'] + ['hg'] * bool(sep)) return next(iter({pre} & allowed), None) def _download_vcs(self, url, spec_filename): vcs = self._resolve_vcs(url) if not vcs: return None if vcs == 'svn': raise DistutilsError( f"Invalid config, SVN download is not supported: {url}" ) filename, _, _ = spec_filename.partition('#') url, rev = self._vcs_split_rev_from_url(url) self.info(f"Doing {vcs} clone from {url} to {filename}") subprocess.check_call([vcs, 'clone', '--quiet', url, filename]) co_commands = dict( git=[vcs, '-C', filename, 'checkout', '--quiet', rev], hg=[vcs, '--cwd', filename, 'up', '-C', '-r', rev, '-q'], ) if rev is not None: self.info(f"Checking out {rev}") subprocess.check_call(co_commands[vcs]) return filename def _download_other(self, url, filename): scheme = urllib.parse.urlsplit(url).scheme if scheme == 'file': # pragma: no cover return urllib.request.url2pathname(urllib.parse.urlparse(url).path) # raise error if not allowed self.url_ok(url, True) return self._attempt_download(url, filename) def scan_url(self, url) -> None: self.process_url(url, True) def _attempt_download(self, url, filename): headers = self._download_to(url, filename) if 'html' in headers.get('content-type', '').lower(): return self._invalid_download_html(url, headers, filename) else: return filename def _invalid_download_html(self, url, headers, filename): os.unlink(filename) raise DistutilsError(f"Unexpected HTML page found at {url}") @staticmethod def _vcs_split_rev_from_url(url): """ Given a possible VCS URL, return a clean URL and resolved revision if any. >>> vsrfu = PackageIndex._vcs_split_rev_from_url >>> vsrfu('git+https://github.com/pypa/setuptools@v69.0.0#egg-info=setuptools') ('https://github.com/pypa/setuptools', 'v69.0.0') >>> vsrfu('git+https://github.com/pypa/setuptools#egg-info=setuptools') ('https://github.com/pypa/setuptools', None) >>> vsrfu('http://foo/bar') ('http://foo/bar', None) """ parts = urllib.parse.urlsplit(url) clean_scheme = parts.scheme.split('+', 1)[-1] # Some fragment identification fails no_fragment_path, _, _ = parts.path.partition('#') pre, sep, post = no_fragment_path.rpartition('@') clean_path, rev = (pre, post) if sep else (post, None) resolved = parts._replace( scheme=clean_scheme, path=clean_path, # discard the fragment fragment='', ).geturl() return resolved, rev def debug(self, msg, *args) -> None: log.debug(msg, *args) def info(self, msg, *args) -> None: log.info(msg, *args) def warn(self, msg, *args) -> None: log.warn(msg, *args) # This pattern matches a character entity reference (a decimal numeric # references, a hexadecimal numeric reference, or a named reference). entity_sub = re.compile(r'&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?').sub def decode_entity(match): what = match.group(0) return html.unescape(what) def htmldecode(text): """ Decode HTML entities in the given text. >>> htmldecode( ... 'https://../package_name-0.1.2.tar.gz' ... '?tokena=A&tokenb=B">package_name-0.1.2.tar.gz') 'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz' """ return entity_sub(decode_entity, text) def socket_timeout(timeout=15): def _socket_timeout(func): def _socket_timeout(*args, **kwargs): old_timeout = socket.getdefaulttimeout() socket.setdefaulttimeout(timeout) try: return func(*args, **kwargs) finally: socket.setdefaulttimeout(old_timeout) return _socket_timeout return _socket_timeout def _encode_auth(auth): """ Encode auth from a URL suitable for an HTTP header. >>> str(_encode_auth('username%3Apassword')) 'dXNlcm5hbWU6cGFzc3dvcmQ=' Long auth strings should not cause a newline to be inserted. >>> long_auth = 'username:' + 'password'*10 >>> chr(10) in str(_encode_auth(long_auth)) False """ auth_s = urllib.parse.unquote(auth) # convert to bytes auth_bytes = auth_s.encode() encoded_bytes = base64.b64encode(auth_bytes) # convert back to a string encoded = encoded_bytes.decode() # strip the trailing carriage return return encoded.replace('\n', '') class Credential(NamedTuple): """ A username/password pair. Displayed separated by `:`. >>> str(Credential('username', 'password')) 'username:password' """ username: str password: str def __str__(self) -> str: return f'{self.username}:{self.password}' class PyPIConfig(configparser.RawConfigParser): def __init__(self): """ Load from ~/.pypirc """ defaults = dict.fromkeys(['username', 'password', 'repository'], '') super().__init__(defaults) rc = os.path.join(os.path.expanduser('~'), '.pypirc') if os.path.exists(rc): _cfg_read_utf8_with_fallback(self, rc) @property def creds_by_repository(self): sections_with_repositories = [ section for section in self.sections() if self.get(section, 'repository').strip() ] return dict(map(self._get_repo_cred, sections_with_repositories)) def _get_repo_cred(self, section): repo = self.get(section, 'repository').strip() return repo, Credential( self.get(section, 'username').strip(), self.get(section, 'password').strip(), ) def find_credential(self, url): """ If the URL indicated appears to be a repository defined in this config, return the credential for that repository. """ for repository, cred in self.creds_by_repository.items(): if url.startswith(repository): return cred return None def open_with_auth(url, opener=urllib.request.urlopen): """Open a urllib2 request, handling HTTP authentication""" parsed = urllib.parse.urlparse(url) scheme, netloc, path, params, query, frag = parsed # Double scheme does not raise on macOS as revealed by a # failing test. We would expect "nonnumeric port". Refs #20. if netloc.endswith(':'): raise http.client.InvalidURL("nonnumeric port: ''") if scheme in ('http', 'https'): auth, address = _splituser(netloc) else: auth, address = (None, None) if not auth: cred = PyPIConfig().find_credential(url) if cred: auth = str(cred) info = cred.username, url log.info('Authenticating as %s for %s (from .pypirc)', *info) if auth: auth = "Basic " + _encode_auth(auth) parts = scheme, address, path, params, query, frag new_url = urllib.parse.urlunparse(parts) request = urllib.request.Request(new_url) request.add_header("Authorization", auth) else: request = urllib.request.Request(url) request.add_header('User-Agent', user_agent) fp = opener(request) if auth: # Put authentication info back into request URL if same host, # so that links found on the page will work s2, h2, path2, param2, query2, frag2 = urllib.parse.urlparse(fp.url) if s2 == scheme and h2 == address: parts = s2, netloc, path2, param2, query2, frag2 fp.url = urllib.parse.urlunparse(parts) return fp # copy of urllib.parse._splituser from Python 3.8 # See https://github.com/python/cpython/issues/80072. def _splituser(host): """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.""" user, delim, host = host.rpartition('@') return (user if delim else None), host # adding a timeout to avoid freezing package_index open_with_auth = socket_timeout(_SOCKET_TIMEOUT)(open_with_auth) def fix_sf_url(url): return url # backward compatibility def local_open(url): """Read a local path, with special support for directories""" _scheme, _server, path, _param, _query, _frag = urllib.parse.urlparse(url) filename = urllib.request.url2pathname(path) if os.path.isfile(filename): return urllib.request.urlopen(url) elif path.endswith('/') and os.path.isdir(filename): files = [] for f in os.listdir(filename): filepath = os.path.join(filename, f) if f == 'index.html': body = _read_utf8_with_fallback(filepath) break elif os.path.isdir(filepath): f += '/' files.append(f'<a href="{f}">{f}</a>') else: tmpl = "<html><head><title>{url}</title></head><body>{files}</body></html>" body = tmpl.format(url=url, files='\n'.join(files)) status, message = 200, "OK" else: status, message, body = 404, "Path not found", "Not found" headers = {'content-type': 'text/html'} body_stream = io.StringIO(body) return urllib.error.HTTPError(url, status, message, headers, body_stream) cli-32.exe 0000644 00000027000 15030122015 0006224 0 ustar 00 MZ� �� � @ � � �!�L�!This program cannot be run in DOS mode. $ �z 2�da�da�da�c�a�dasee`�dase�a�dasea`�dase``�daseg`�da�ce`�da�ea�da�d``�da�d�a�da�df`�daRich�da PE L �'hd � $ � 0 @ p @� 6 � P � ` � �2 2 @ 0 .text � `.rdata � 0 @ @.data � @ ( @ �.rsrc � P * @ @.reloc � ` , @ B ��C@ �����������U��} u�@@ ��t j P� 0@ � ]���������������U��EPj �u �u����p�0� 1@ ��]�������������U��j �u �u� �� ]������������U���S�]VW�K��C��u�+�j�] P�x0@ �ȃ��M�3��"�q3ɉM���~S�U�<\uG�&<"u ��~Wj\V� �M��� �U�3��\F�3��A�F�M�;�| �~Wj\V�t �� ��E�_f�" ^[��]�������������U��� �@@ 3ʼnE��E�����E �����������h Pj �0@ j h� jj jh �������P� 0@ j h ������QP�0@ �������Q�A��u�+ʍ������������;�v�8.t� ������H;�w퍍����� If��A�I��u���1@ ���1@ �Af��1@ f�A��1@ W�A ������j P� �������u2������Ph�1@ j��0@ ��P����� �G_�M�3��� ��]�Vh ������PW�� ������W�� ��������H@;�s���t �� t�� u�j� ������h�1@ P� 1@ �� ��t&��1@ �~�1@ �������1@ fօ����������������Q�A��u�S+�jQ�x0@ �������������3ۉ���������Q�����1@ �� ��t D �FFP�1@ ����u�F���������� ��P�1@ �������t��tm��������\uC�ƀ�"u0�Ã�����u 3��������3��9�����EȈ�������tSj\W�� �� �3ۊ��������o����G�g�����tSj\W� �� �3ۋ��������@� G������ �����<�t-�P�1@ ����t�FFP�1@ ����u�> ����������;�NJ��t��@��/u�\���u�5h0@ ������P������P������P����PW�փ����� �� ������\�� ������P������P������P����P������P�֍��������Q�A��u�+ʊ� ������ �����Ӏ�\u�Q�3���\��������\t f � ������;�r � H�8\u�j W������P����P������P�l0@ �=x0@ jh �����h PV������1@ �������(�,�x0@ jh ��h �����WV�1@ �=x0@ ����u/�3h�1@ j��0@ ��P�r����� �F[^_�M�3��Q ��]Ë�������j� �����A�P��V����~�����{� �� 9���~*���� ������4��R����C����;�|勵���������P�3����� ����9���~/���� � ������4������C����;�|勵����} � t@���V��0@ ��Vh�1@ j��0@ ��P�l����� � [^_�M�3��I ��]ËQ�A��u�����+ʺ �y;�~0��� ��Y @ �A��u�+�GB�;�|ߋ���������x0@ jW��Vh�1@ P����� ���N��F��u�� +�;�~O @ ff � ����4������h�1@ P�d ����� � ��Q D �A��u�+�FG�;�|�W�Dž�� jh@ ����Dž����D f�����f�����f�����f�����f�����f�����f�����f������0@ �����P������Pj j j jj j ����j �0@ ��u,hP1@ j��0@ ��P������3�[^_�M�3�� ��]Ë����j�������@@ �0@ ����P������ 0@ ��u,hl1@ j��0@ ��P�v�����3�[^_�M�3��V ��]ËM�����3�[^_�? ��]����������U��EPj �u j��u�����p��Q��0@ ���� ��H�]�; @@ u��y Vj�v �V P� �D ��� j�0� �� ^��ts���l h"@ �n � P�> YY��uQ� �c ��t h� @ � Y�) �$ � �� P�G Y�� ��t� �� �T ��u�j�- ��� 3��� � P� Y�jh�5@ �/ j� Y���P 2ۈ]�e� �� �Eܡ<C@ 3�A;��/ ��uI� <C@ h<1@ h01@ � YY��t�E������� �� h,1@ h$1@ �[ YY�<C@ ��و]�u��� Y�i ��3�9>tV�9 Y��t�6WjW�� 1@ ���G ��9>tV� Y��t�6�$ Y�� ���� �0� WV�0�q����� ���. ��tk��u�� j j�{ YY�E��������5�M�� �E�QP�{ YYËe��� ��t2�}� u� �E������E�M�d� Y_^[��j� V�j �u��h ��� �t���U��j �D0@ �u�H0@ h ��@0@ P�<0@ ]�U���$ j�80@ ��tjY�)� A@ � A@ �A@ � A@ �5A@ �= A@ f�8A@ f� ,A@ f� A@ f�A@ f�% A@ f�-�@@ ��0A@ �E �$A@ �E�(A@ �E�4A@ ������p@@ �(A@ �,@@ � @@ ��$@@ �0@@ jXk� ǀ4@@ jXk� � @@ �L�jX�� � @@ �L�h2@ �����U��EV�H<��A�Q��Ak�(�;�t�M ;J r �BB ;�r ��(;�u�3�^]Ë��V� ��t d� �@C@ �P�;�t3�������u�2�^ð^�U��} u�DC@ �v �r ��u2�]��e ��u j �Z Y��]�U��=EC@ t�]�V�u��t��ub� ��t&��u"hHC@ � Y��uhTC@ �y Y��t+2��0��� HC@ � LC@ � PC@ � TC@ � XC@ � \C@ �EC@ �^]�j�/ �jh 6@ �K �e� �MZ f9 @ u]�< @ �� @ PE uL� f9� @ u>�E� @ +�PQ�|���YY��t'�x$ |!�E������� �E� 3Ɂ8 �����Ëe��E�����2��M�d� Y_^[��U��� ��t�} u 3��@C@ �]�U��=DC@ t�} u�u� �u� YY�]�U��=HC@ ��uu�T � hHC@ �B Y��Y���#E]�U��u������Y���H]�U����e� �E�e� P�(0@ �E�3E�E��,0@ 1E��00@ 1E��E�P�40@ �E�M�3E�3E�3��Ë @@ VW�N�@�� ��;�t��u&�����;�u�O�@����u G �� ȉ @@ ��_� @@ ^�3��3�@ø @ �h`C@ �$0@ ð�h h j �g �� ��u�j�? �� �hC@ ���H�$�H����H��H�3�9 @@ ��ø�C@ ø�C@ �U���$ Sj�80@ ��t�M�)j� �$� �����j P�F �� ��������������������������|�����x���f������f������f��t���f��p���f��l���f��h�����������E�������E������Dž��� �@�jP�������E�j P� �E�� �E� @�E� �E�� 0@ j �X��ۍE��E������ۉE���D0@ �E�P�H0@ ��u ��uj� Y[���e���j �L0@ ��t3�MZ f9u)�H<ȁ9PE u � f9Au�ytv ��� ���2��h�!@ �D0@ �U��VW�}�7�>csm�u%�~u �F= �t =!�t="�t= @�t_3�^]� �� �0�w�� �0�\ ̃%pC@ �SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[�SV��5@ ��5@ ;�sW�>��t �� 1@ �׃�;�r�_^[������h�"@ d�5 �D$�l$�l$+�SVW�@@ 1E�3�P�e�u��E��E������E��E�d� �U��V�u�6� �u��u�u Vh2@ h@@ � �� ^]�U��%tC@ ��$� @@ j �80@ ���� �e� 3�SVW3ɍ}�S���[���w�O3ɉW �E܋}�E�Genu�E�5ineI�E��E�5ntel�E�3�@S���[��]܉�E� E� ljs�K�S uC�E�%�?�=� t#=` t =p t=P t=` t=p u�=xC@ ���=xC@ ��=xC@ �M�jX�M�9E�|03�S���[��]܉�s�K�M��S �]�� t���=xC@ ��]�@@ ���tC@ �@@ �� �� ���tC@ �@@ �� ty�� tq3�ЉE�U�E�M�j^#�;�uW�@@ ���tC@ �@@ �� t;�� �tC@ �@@ � �#�;�u �E�� �M�#�;�u � @@ @�5tC@ _^[3���3�9@@ ���%T0@ �%X0@ �%`0@ �%\0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%1@ �%�0@ �%�0@ �%�0@ �%�0@ �%t0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ �%�0@ U��Q�=tC@ |f�}� �t �}� �uT�]��E���?��t?� u�� ��é t*� u�� ��é u�� ��é u�� ��ø� ��ËE�� 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � @ �@ @@ �@ failed to create process. failed to get exit code from process. %s %s -script.py Cannot open %s #! #!python.exe Cannot find Python executable %s Could not exec %s @@ p@@ � @@ 3@ 1@ 3@ 1@ �'hd l `3 ` �" �� 3 , H3 � � �" (# �# $ $ $ $ c$ k$ @ �" N% x � .text$mn 0 .idata$5 1 .00cfg $1 .CRT$XCA (1 .CRT$XCAA ,1 .CRT$XCZ 01 .CRT$XIA 41 .CRT$XIAA 81 .CRT$XIAC <1 .CRT$XIZ @1 .CRT$XPA D1 .CRT$XPZ H1 .CRT$XTA L1 .CRT$XTZ P1 � .rdata 3 .rdata$sxdata 3 \ .rdata$voltmd `3 l .rdata$zzzdbg �5 .rtc$IAA �5 .rtc$IZZ �5 .rtc$TAA �5 .rtc$TZZ �5 < .xdata$x 6 � .idata$2 �6 .idata$3 �6 .idata$4 8 � .idata$6 @ .data @ x .bss P ` .rsrc$01 `P � .rsrc$02 ���� ��� ����,@ @@ ���� ��� ����N @ a @ �6 �8 0 L7 ,9 T0 l7 �; t0 `7 �; h0 �7 �; �0 �7 < �0 8 4< 1 �7 V< �0 x7 v< �0 �7 �< �0 8 "8 >8 T8 j8 |8 �8 �8 �= �= ~= h= R= 8= = = �< �< �< �= �8 �8 9 �8 T9 H9 ; >9 �: : �; �: v: T: &; B; ^; �: l; |; �: 2: : �: �9 �9 b9 p9 �: �: �9 ~9 �; �; �; ; �9 �: �9 �9 �9 � CreateFileA dGetFinalPathNameByHandleA �WaitForSingleObject QGetExitCodeProcess � CreateProcessA �GetModuleFileNameA SetConsoleCtrlHandler �GenerateConsoleCtrlEvent KERNEL32.dll H memset __current_exception __current_exception_context 5 _except_handler4_common VCRUNTIME140.dll calloc _makepath _splitpath __p___argc __p___argv __acrt_iob_func __stdio_common_vfprintf __stdio_common_vsprintf � strncmp � strncpy n isspace B _seh_filter_exe D _set_app_type . __setusermatherr _configure_narrow_argv 5 _initialize_narrow_environment * _get_initial_narrow_environment 8 _initterm 9 _initterm_e X exit % _exit T _set_fmode _cexit _c_exit ? _register_thread_local_exe_atexit_callback _configthreadlocale _set_new_mode __p__commode 6 _initialize_onexit_table > _register_onexit_function _crt_atexit _controlfp_s j terminate _execv I _open R _read _close api-ms-win-crt-heap-l1-1-0.dll api-ms-win-crt-filesystem-l1-1-0.dll api-ms-win-crt-runtime-l1-1-0.dll api-ms-win-crt-stdio-l1-1-0.dll api-ms-win-crt-string-l1-1-0.dll api-ms-win-crt-math-l1-1-0.dll api-ms-win-crt-locale-l1-1-0.dll api-ms-win-crt-process-l1-1-0.dll �UnhandledExceptionFilter �SetUnhandledExceptionFilter ,GetCurrentProcess �TerminateProcess �IsProcessorFeaturePresent mQueryPerformanceCounter -GetCurrentProcessId 1GetCurrentThreadId GetSystemTimeAsFileTime �InitializeSListHead �IsDebuggerPresent �GetModuleHandleW ��DN�@����� � 0 � H `P } <?xml version='1.0' encoding='UTF-8' standalone='yes'?> <assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3"> <security> <requestedPrivileges> <requestedExecutionLevel level='asInvoker' uiAccess='false' /> </requestedPrivileges> </security> </trustInfo> </assembly> 00'0[0�0J1u1�1�1�12 22<2D2�2�2�2�2�2303H3j3)4<4s4M5S5w5�5�5�5�5�5�6�6�6>7I7�7�7(8P8Y8a8�8�8�8�8�8!949x9�9:3:H:M:R:s:x:�:�:�;�;�;�;�;�;�;�;�;�;�;�; <<<< <#<+<3<;<G<P<U<[<e<o<<�<�<�<=4=g=�=�=�=�=�=�=�=�=�=�=>>> >*>�>�>�>�>?'?0?=?S?�?�?�?�?�? � 0 00%0�011;1z1�1�1�1�1�122*2A2^2�2�2�2�2�2u3~3�3�3�3�3�3�3�3+444=4K4T4v4}4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�455555 5&5,52585>5D5J5T5 0 ( 1(1418122L2P2X2�2�2�5�566 extension.py 0000644 00000015033 15030122015 0007121 0 ustar 00 from __future__ import annotations import functools import re from typing import TYPE_CHECKING from setuptools._path import StrPath from .monkey import get_unpatched import distutils.core import distutils.errors import distutils.extension def _have_cython(): """ Return True if Cython can be imported. """ cython_impl = 'Cython.Distutils.build_ext' try: # from (cython_impl) import build_ext __import__(cython_impl, fromlist=['build_ext']).build_ext except Exception: return False return True # for compatibility have_pyrex = _have_cython if TYPE_CHECKING: # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962 from distutils.core import Extension as _Extension else: _Extension = get_unpatched(distutils.core.Extension) class Extension(_Extension): """ Describes a single extension module. This means that all source files will be compiled into a single binary file ``<module path>.<suffix>`` (with ``<module path>`` derived from ``name`` and ``<suffix>`` defined by one of the values in ``importlib.machinery.EXTENSION_SUFFIXES``). In the case ``.pyx`` files are passed as ``sources and`` ``Cython`` is **not** installed in the build environment, ``setuptools`` may also try to look for the equivalent ``.cpp`` or ``.c`` files. :arg str name: the full name of the extension, including any packages -- ie. *not* a filename or pathname, but Python dotted name :arg list[str|os.PathLike[str]] sources: list of source filenames, relative to the distribution root (where the setup script lives), in Unix form (slash-separated) for portability. Source files may be C, C++, SWIG (.i), platform-specific resource files, or whatever else is recognized by the "build_ext" command as source for a Python extension. :keyword list[str] include_dirs: list of directories to search for C/C++ header files (in Unix form for portability) :keyword list[tuple[str, str|None]] define_macros: list of macros to define; each macro is defined using a 2-tuple: the first item corresponding to the name of the macro and the second item either a string with its value or None to define it without a particular value (equivalent of "#define FOO" in source or -DFOO on Unix C compiler command line) :keyword list[str] undef_macros: list of macros to undefine explicitly :keyword list[str] library_dirs: list of directories to search for C/C++ libraries at link time :keyword list[str] libraries: list of library names (not filenames or paths) to link against :keyword list[str] runtime_library_dirs: list of directories to search for C/C++ libraries at run time (for shared extensions, this is when the extension is loaded). Setting this will cause an exception during build on Windows platforms. :keyword list[str] extra_objects: list of extra files to link with (eg. object files not implied by 'sources', static library that must be explicitly specified, binary resource files, etc.) :keyword list[str] extra_compile_args: any extra platform- and compiler-specific information to use when compiling the source files in 'sources'. For platforms and compilers where "command line" makes sense, this is typically a list of command-line arguments, but for other platforms it could be anything. :keyword list[str] extra_link_args: any extra platform- and compiler-specific information to use when linking object files together to create the extension (or to create a new static Python interpreter). Similar interpretation as for 'extra_compile_args'. :keyword list[str] export_symbols: list of symbols to be exported from a shared extension. Not used on all platforms, and not generally necessary for Python extensions, which typically export exactly one symbol: "init" + extension_name. :keyword list[str] swig_opts: any extra options to pass to SWIG if a source file has the .i extension. :keyword list[str] depends: list of files that the extension depends on :keyword str language: extension language (i.e. "c", "c++", "objc"). Will be detected from the source extensions if not provided. :keyword bool optional: specifies that a build failure in the extension should not abort the build process, but simply not install the failing extension. :keyword bool py_limited_api: opt-in flag for the usage of :doc:`Python's limited API <python:c-api/stable>`. :raises setuptools.errors.PlatformError: if ``runtime_library_dirs`` is specified on Windows. (since v63) """ # These 4 are set and used in setuptools/command/build_ext.py # The lack of a default value and risk of `AttributeError` is purposeful # to avoid people forgetting to call finalize_options if they modify the extension list. # See example/rationale in https://github.com/pypa/setuptools/issues/4529. _full_name: str #: Private API, internal use only. _links_to_dynamic: bool #: Private API, internal use only. _needs_stub: bool #: Private API, internal use only. _file_name: str #: Private API, internal use only. def __init__( self, name: str, sources: list[StrPath], *args, py_limited_api: bool = False, **kw, ) -> None: # The *args is needed for compatibility as calls may use positional # arguments. py_limited_api may be set only via keyword. self.py_limited_api = py_limited_api super().__init__( name, sources, # type: ignore[arg-type] # Vendored version of setuptools supports PathLike *args, **kw, ) def _convert_pyx_sources_to_lang(self): """ Replace sources with .pyx extensions to sources with the target language extension. This mechanism allows language authors to supply pre-converted sources but to prefer the .pyx sources. """ if _have_cython(): # the build has Cython, so allow it to compile the .pyx files return lang = self.language or '' target_ext = '.cpp' if lang.lower() == 'c++' else '.c' sub = functools.partial(re.sub, '.pyx$', target_ext) self.sources = list(map(sub, self.sources)) class Library(Extension): """Just like a regular Extension, but built as a library instead""" modified.py 0000644 00000001070 15030122015 0006661 0 ustar 00 try: # Ensure a DistutilsError raised by these methods is the same as distutils.errors.DistutilsError from distutils._modified import ( newer, newer_group, newer_pairwise, newer_pairwise_group, ) except ImportError: # fallback for SETUPTOOLS_USE_DISTUTILS=stdlib, because _modified never existed in stdlib from ._distutils._modified import ( newer, newer_group, newer_pairwise, newer_pairwise_group, ) __all__ = ['newer', 'newer_pairwise', 'newer_group', 'newer_pairwise_group'] wheel.py 0000644 00000020660 15030122015 0006213 0 ustar 00 """Wheels support.""" import contextlib import email import functools import itertools import os import posixpath import re import zipfile from packaging.tags import sys_tags from packaging.utils import canonicalize_name from packaging.version import Version as parse_version import setuptools from setuptools.archive_util import _unpack_zipfile_obj from setuptools.command.egg_info import _egg_basename, write_requirements from .unicode_utils import _read_utf8_with_fallback from distutils.util import get_platform WHEEL_NAME = re.compile( r"""^(?P<project_name>.+?)-(?P<version>\d.*?) ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?) )\.whl$""", re.VERBOSE, ).match NAMESPACE_PACKAGE_INIT = "__import__('pkg_resources').declare_namespace(__name__)\n" @functools.cache def _get_supported_tags(): # We calculate the supported tags only once, otherwise calling # this method on thousands of wheels takes seconds instead of # milliseconds. return {(t.interpreter, t.abi, t.platform) for t in sys_tags()} def unpack(src_dir, dst_dir) -> None: """Move everything under `src_dir` to `dst_dir`, and delete the former.""" for dirpath, dirnames, filenames in os.walk(src_dir): subdir = os.path.relpath(dirpath, src_dir) for f in filenames: src = os.path.join(dirpath, f) dst = os.path.join(dst_dir, subdir, f) os.renames(src, dst) for n, d in reversed(list(enumerate(dirnames))): src = os.path.join(dirpath, d) dst = os.path.join(dst_dir, subdir, d) if not os.path.exists(dst): # Directory does not exist in destination, # rename it and prune it from os.walk list. os.renames(src, dst) del dirnames[n] # Cleanup. for dirpath, dirnames, filenames in os.walk(src_dir, topdown=True): assert not filenames os.rmdir(dirpath) @contextlib.contextmanager def disable_info_traces(): """ Temporarily disable info traces. """ from distutils import log saved = log.set_threshold(log.WARN) try: yield finally: log.set_threshold(saved) class Wheel: def __init__(self, filename) -> None: match = WHEEL_NAME(os.path.basename(filename)) if match is None: raise ValueError(f'invalid wheel name: {filename!r}') self.filename = filename for k, v in match.groupdict().items(): setattr(self, k, v) def tags(self): """List tags (py_version, abi, platform) supported by this wheel.""" return itertools.product( self.py_version.split('.'), self.abi.split('.'), self.platform.split('.'), ) def is_compatible(self): """Is the wheel compatible with the current platform?""" return next((True for t in self.tags() if t in _get_supported_tags()), False) def egg_name(self): return ( _egg_basename( self.project_name, self.version, platform=(None if self.platform == 'any' else get_platform()), ) + ".egg" ) def get_dist_info(self, zf): # find the correct name of the .dist-info dir in the wheel file for member in zf.namelist(): dirname = posixpath.dirname(member) if dirname.endswith('.dist-info') and canonicalize_name(dirname).startswith( canonicalize_name(self.project_name) ): return dirname raise ValueError("unsupported wheel format. .dist-info not found") def install_as_egg(self, destination_eggdir) -> None: """Install wheel as an egg directory.""" with zipfile.ZipFile(self.filename) as zf: self._install_as_egg(destination_eggdir, zf) def _install_as_egg(self, destination_eggdir, zf): dist_basename = f'{self.project_name}-{self.version}' dist_info = self.get_dist_info(zf) dist_data = f'{dist_basename}.data' egg_info = os.path.join(destination_eggdir, 'EGG-INFO') self._convert_metadata(zf, destination_eggdir, dist_info, egg_info) self._move_data_entries(destination_eggdir, dist_data) self._fix_namespace_packages(egg_info, destination_eggdir) @staticmethod def _convert_metadata(zf, destination_eggdir, dist_info, egg_info): import pkg_resources def get_metadata(name): with zf.open(posixpath.join(dist_info, name)) as fp: value = fp.read().decode('utf-8') return email.parser.Parser().parsestr(value) wheel_metadata = get_metadata('WHEEL') # Check wheel format version is supported. wheel_version = parse_version(wheel_metadata.get('Wheel-Version')) wheel_v1 = parse_version('1.0') <= wheel_version < parse_version('2.0dev0') if not wheel_v1: raise ValueError(f'unsupported wheel format version: {wheel_version}') # Extract to target directory. _unpack_zipfile_obj(zf, destination_eggdir) # Convert metadata. dist_info = os.path.join(destination_eggdir, dist_info) dist = pkg_resources.Distribution.from_location( destination_eggdir, dist_info, metadata=pkg_resources.PathMetadata(destination_eggdir, dist_info), ) # Note: Evaluate and strip markers now, # as it's difficult to convert back from the syntax: # foobar; "linux" in sys_platform and extra == 'test' def raw_req(req): req.marker = None return str(req) install_requires = list(map(raw_req, dist.requires())) extras_require = { extra: [ req for req in map(raw_req, dist.requires((extra,))) if req not in install_requires ] for extra in dist.extras } os.rename(dist_info, egg_info) os.rename( os.path.join(egg_info, 'METADATA'), os.path.join(egg_info, 'PKG-INFO'), ) setup_dist = setuptools.Distribution( attrs=dict( install_requires=install_requires, extras_require=extras_require, ), ) with disable_info_traces(): write_requirements( setup_dist.get_command_obj('egg_info'), None, os.path.join(egg_info, 'requires.txt'), ) @staticmethod def _move_data_entries(destination_eggdir, dist_data): """Move data entries to their correct location.""" dist_data = os.path.join(destination_eggdir, dist_data) dist_data_scripts = os.path.join(dist_data, 'scripts') if os.path.exists(dist_data_scripts): egg_info_scripts = os.path.join(destination_eggdir, 'EGG-INFO', 'scripts') os.mkdir(egg_info_scripts) for entry in os.listdir(dist_data_scripts): # Remove bytecode, as it's not properly handled # during easy_install scripts install phase. if entry.endswith('.pyc'): os.unlink(os.path.join(dist_data_scripts, entry)) else: os.rename( os.path.join(dist_data_scripts, entry), os.path.join(egg_info_scripts, entry), ) os.rmdir(dist_data_scripts) for subdir in filter( os.path.exists, ( os.path.join(dist_data, d) for d in ('data', 'headers', 'purelib', 'platlib') ), ): unpack(subdir, destination_eggdir) if os.path.exists(dist_data): os.rmdir(dist_data) @staticmethod def _fix_namespace_packages(egg_info, destination_eggdir): namespace_packages = os.path.join(egg_info, 'namespace_packages.txt') if os.path.exists(namespace_packages): namespace_packages = _read_utf8_with_fallback(namespace_packages).split() for mod in namespace_packages: mod_dir = os.path.join(destination_eggdir, *mod.split('.')) mod_init = os.path.join(mod_dir, '__init__.py') if not os.path.exists(mod_dir): os.mkdir(mod_dir) if not os.path.exists(mod_init): with open(mod_init, 'w', encoding="utf-8") as fp: fp.write(NAMESPACE_PACKAGE_INIT) discovery.py 0000644 00000051412 15030122015 0007115 0 ustar 00 """Automatic discovery of Python modules and packages (for inclusion in the distribution) and other config values. For the purposes of this module, the following nomenclature is used: - "src-layout": a directory representing a Python project that contains a "src" folder. Everything under the "src" folder is meant to be included in the distribution when packaging the project. Example:: . ├── tox.ini ├── pyproject.toml └── src/ └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "flat-layout": a Python project that does not use "src-layout" but instead have a directory under the project root for each package:: . ├── tox.ini ├── pyproject.toml └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "single-module": a project that contains a single Python script direct under the project root (no directory used):: . ├── tox.ini ├── pyproject.toml └── mymodule.py """ from __future__ import annotations import itertools import os from collections.abc import Iterable, Iterator, Mapping from fnmatch import fnmatchcase from glob import glob from pathlib import Path from typing import TYPE_CHECKING, ClassVar import _distutils_hack.override # noqa: F401 from ._path import StrPath from distutils import log from distutils.util import convert_path if TYPE_CHECKING: from setuptools import Distribution chain_iter = itertools.chain.from_iterable def _valid_name(path: StrPath) -> bool: # Ignore invalid names that cannot be imported directly return os.path.basename(path).isidentifier() class _Filter: """ Given a list of patterns, create a callable that will be true only if the input matches at least one of the patterns. """ def __init__(self, *patterns: str) -> None: self._patterns = dict.fromkeys(patterns) def __call__(self, item: str) -> bool: return any(fnmatchcase(item, pat) for pat in self._patterns) def __contains__(self, item: str) -> bool: return item in self._patterns class _Finder: """Base class that exposes functionality for module/package finders""" ALWAYS_EXCLUDE: ClassVar[tuple[str, ...]] = () DEFAULT_EXCLUDE: ClassVar[tuple[str, ...]] = () @classmethod def find( cls, where: StrPath = '.', exclude: Iterable[str] = (), include: Iterable[str] = ('*',), ) -> list[str]: """Return a list of all Python items (packages or modules, depending on the finder implementation) found within directory 'where'. 'where' is the root directory which will be searched. It should be supplied as a "cross-platform" (i.e. URL-style) path; it will be converted to the appropriate local path syntax. 'exclude' is a sequence of names to exclude; '*' can be used as a wildcard in the names. When finding packages, 'foo.*' will exclude all subpackages of 'foo' (but not 'foo' itself). 'include' is a sequence of names to include. If it's specified, only the named items will be included. If it's not specified, all found items will be included. 'include' can contain shell style wildcard patterns just like 'exclude'. """ exclude = exclude or cls.DEFAULT_EXCLUDE return list( cls._find_iter( convert_path(str(where)), _Filter(*cls.ALWAYS_EXCLUDE, *exclude), _Filter(*include), ) ) @classmethod def _find_iter( cls, where: StrPath, exclude: _Filter, include: _Filter ) -> Iterator[str]: raise NotImplementedError class PackageFinder(_Finder): """ Generate a list of all Python packages found within a directory """ ALWAYS_EXCLUDE = ("ez_setup", "*__pycache__") @classmethod def _find_iter( cls, where: StrPath, exclude: _Filter, include: _Filter ) -> Iterator[str]: """ All the packages found in 'where' that pass the 'include' filter, but not the 'exclude' filter. """ for root, dirs, files in os.walk(str(where), followlinks=True): # Copy dirs to iterate over it, then empty dirs. all_dirs = dirs[:] dirs[:] = [] for dir in all_dirs: full_path = os.path.join(root, dir) rel_path = os.path.relpath(full_path, where) package = rel_path.replace(os.path.sep, '.') # Skip directory trees that are not valid packages if '.' in dir or not cls._looks_like_package(full_path, package): continue # Should this package be included? if include(package) and not exclude(package): yield package # Early pruning if there is nothing else to be scanned if f"{package}*" in exclude or f"{package}.*" in exclude: continue # Keep searching subdirectories, as there may be more packages # down there, even if the parent was excluded. dirs.append(dir) @staticmethod def _looks_like_package(path: StrPath, _package_name: str) -> bool: """Does a directory look like a package?""" return os.path.isfile(os.path.join(path, '__init__.py')) class PEP420PackageFinder(PackageFinder): @staticmethod def _looks_like_package(_path: StrPath, _package_name: str) -> bool: return True class ModuleFinder(_Finder): """Find isolated Python modules. This function will **not** recurse subdirectories. """ @classmethod def _find_iter( cls, where: StrPath, exclude: _Filter, include: _Filter ) -> Iterator[str]: for file in glob(os.path.join(where, "*.py")): module, _ext = os.path.splitext(os.path.basename(file)) if not cls._looks_like_module(module): continue if include(module) and not exclude(module): yield module _looks_like_module = staticmethod(_valid_name) # We have to be extra careful in the case of flat layout to not include files # and directories not meant for distribution (e.g. tool-related) class FlatLayoutPackageFinder(PEP420PackageFinder): _EXCLUDE = ( "ci", "bin", "debian", "doc", "docs", "documentation", "manpages", "news", "newsfragments", "changelog", "test", "tests", "unit_test", "unit_tests", "example", "examples", "scripts", "tools", "util", "utils", "python", "build", "dist", "venv", "env", "requirements", # ---- Task runners / Build tools ---- "tasks", # invoke "fabfile", # fabric "site_scons", # SCons # ---- Other tools ---- "benchmark", "benchmarks", "exercise", "exercises", "htmlcov", # Coverage.py # ---- Hidden directories/Private packages ---- "[._]*", ) DEFAULT_EXCLUDE = tuple(chain_iter((p, f"{p}.*") for p in _EXCLUDE)) """Reserved package names""" @staticmethod def _looks_like_package(_path: StrPath, package_name: str) -> bool: names = package_name.split('.') # Consider PEP 561 root_pkg_is_valid = names[0].isidentifier() or names[0].endswith("-stubs") return root_pkg_is_valid and all(name.isidentifier() for name in names[1:]) class FlatLayoutModuleFinder(ModuleFinder): DEFAULT_EXCLUDE = ( "setup", "conftest", "test", "tests", "example", "examples", "build", # ---- Task runners ---- "toxfile", "noxfile", "pavement", "dodo", "tasks", "fabfile", # ---- Other tools ---- "[Ss][Cc]onstruct", # SCons "conanfile", # Connan: C/C++ build tool "manage", # Django "benchmark", "benchmarks", "exercise", "exercises", # ---- Hidden files/Private modules ---- "[._]*", ) """Reserved top-level module names""" def _find_packages_within(root_pkg: str, pkg_dir: StrPath) -> list[str]: nested = PEP420PackageFinder.find(pkg_dir) return [root_pkg] + [".".join((root_pkg, n)) for n in nested] class ConfigDiscovery: """Fill-in metadata and options that can be automatically derived (from other metadata/options, the file system or conventions) """ def __init__(self, distribution: Distribution) -> None: self.dist = distribution self._called = False self._disabled = False self._skip_ext_modules = False def _disable(self): """Internal API to disable automatic discovery""" self._disabled = True def _ignore_ext_modules(self): """Internal API to disregard ext_modules. Normally auto-discovery would not be triggered if ``ext_modules`` are set (this is done for backward compatibility with existing packages relying on ``setup.py`` or ``setup.cfg``). However, ``setuptools`` can call this function to ignore given ``ext_modules`` and proceed with the auto-discovery if ``packages`` and ``py_modules`` are not given (e.g. when using pyproject.toml metadata). """ self._skip_ext_modules = True @property def _root_dir(self) -> StrPath: # The best is to wait until `src_root` is set in dist, before using _root_dir. return self.dist.src_root or os.curdir @property def _package_dir(self) -> dict[str, str]: if self.dist.package_dir is None: return {} return self.dist.package_dir def __call__( self, force: bool = False, name: bool = True, ignore_ext_modules: bool = False ): """Automatically discover missing configuration fields and modifies the given ``distribution`` object in-place. Note that by default this will only have an effect the first time the ``ConfigDiscovery`` object is called. To repeatedly invoke automatic discovery (e.g. when the project directory changes), please use ``force=True`` (or create a new ``ConfigDiscovery`` instance). """ if force is False and (self._called or self._disabled): # Avoid overhead of multiple calls return self._analyse_package_layout(ignore_ext_modules) if name: self.analyse_name() # depends on ``packages`` and ``py_modules`` self._called = True def _explicitly_specified(self, ignore_ext_modules: bool) -> bool: """``True`` if the user has specified some form of package/module listing""" ignore_ext_modules = ignore_ext_modules or self._skip_ext_modules ext_modules = not (self.dist.ext_modules is None or ignore_ext_modules) return ( self.dist.packages is not None or self.dist.py_modules is not None or ext_modules or hasattr(self.dist, "configuration") and self.dist.configuration # ^ Some projects use numpy.distutils.misc_util.Configuration ) def _analyse_package_layout(self, ignore_ext_modules: bool) -> bool: if self._explicitly_specified(ignore_ext_modules): # For backward compatibility, just try to find modules/packages # when nothing is given return True log.debug( "No `packages` or `py_modules` configuration, performing " "automatic discovery." ) return ( self._analyse_explicit_layout() or self._analyse_src_layout() # flat-layout is the trickiest for discovery so it should be last or self._analyse_flat_layout() ) def _analyse_explicit_layout(self) -> bool: """The user can explicitly give a package layout via ``package_dir``""" package_dir = self._package_dir.copy() # don't modify directly package_dir.pop("", None) # This falls under the "src-layout" umbrella root_dir = self._root_dir if not package_dir: return False log.debug(f"`explicit-layout` detected -- analysing {package_dir}") pkgs = chain_iter( _find_packages_within(pkg, os.path.join(root_dir, parent_dir)) for pkg, parent_dir in package_dir.items() ) self.dist.packages = list(pkgs) log.debug(f"discovered packages -- {self.dist.packages}") return True def _analyse_src_layout(self) -> bool: """Try to find all packages or modules under the ``src`` directory (or anything pointed by ``package_dir[""]``). The "src-layout" is relatively safe for automatic discovery. We assume that everything within is meant to be included in the distribution. If ``package_dir[""]`` is not given, but the ``src`` directory exists, this function will set ``package_dir[""] = "src"``. """ package_dir = self._package_dir src_dir = os.path.join(self._root_dir, package_dir.get("", "src")) if not os.path.isdir(src_dir): return False log.debug(f"`src-layout` detected -- analysing {src_dir}") package_dir.setdefault("", os.path.basename(src_dir)) self.dist.package_dir = package_dir # persist eventual modifications self.dist.packages = PEP420PackageFinder.find(src_dir) self.dist.py_modules = ModuleFinder.find(src_dir) log.debug(f"discovered packages -- {self.dist.packages}") log.debug(f"discovered py_modules -- {self.dist.py_modules}") return True def _analyse_flat_layout(self) -> bool: """Try to find all packages and modules under the project root. Since the ``flat-layout`` is more dangerous in terms of accidentally including extra files/directories, this function is more conservative and will raise an error if multiple packages or modules are found. This assumes that multi-package dists are uncommon and refuse to support that use case in order to be able to prevent unintended errors. """ log.debug(f"`flat-layout` detected -- analysing {self._root_dir}") return self._analyse_flat_packages() or self._analyse_flat_modules() def _analyse_flat_packages(self) -> bool: self.dist.packages = FlatLayoutPackageFinder.find(self._root_dir) top_level = remove_nested_packages(remove_stubs(self.dist.packages)) log.debug(f"discovered packages -- {self.dist.packages}") self._ensure_no_accidental_inclusion(top_level, "packages") return bool(top_level) def _analyse_flat_modules(self) -> bool: self.dist.py_modules = FlatLayoutModuleFinder.find(self._root_dir) log.debug(f"discovered py_modules -- {self.dist.py_modules}") self._ensure_no_accidental_inclusion(self.dist.py_modules, "modules") return bool(self.dist.py_modules) def _ensure_no_accidental_inclusion(self, detected: list[str], kind: str): if len(detected) > 1: from inspect import cleandoc from setuptools.errors import PackageDiscoveryError msg = f"""Multiple top-level {kind} discovered in a flat-layout: {detected}. To avoid accidental inclusion of unwanted files or directories, setuptools will not proceed with this build. If you are trying to create a single distribution with multiple {kind} on purpose, you should not rely on automatic discovery. Instead, consider the following options: 1. set up custom discovery (`find` directive with `include` or `exclude`) 2. use a `src-layout` 3. explicitly set `py_modules` or `packages` with a list of names To find more information, look for "package discovery" on setuptools docs. """ raise PackageDiscoveryError(cleandoc(msg)) def analyse_name(self) -> None: """The packages/modules are the essential contribution of the author. Therefore the name of the distribution can be derived from them. """ if self.dist.metadata.name or self.dist.name: # get_name() is not reliable (can return "UNKNOWN") return log.debug("No `name` configuration, performing automatic discovery") name = ( self._find_name_single_package_or_module() or self._find_name_from_packages() ) if name: self.dist.metadata.name = name def _find_name_single_package_or_module(self) -> str | None: """Exactly one module or package""" for field in ('packages', 'py_modules'): items = getattr(self.dist, field, None) or [] if items and len(items) == 1: log.debug(f"Single module/package detected, name: {items[0]}") return items[0] return None def _find_name_from_packages(self) -> str | None: """Try to find the root package that is not a PEP 420 namespace""" if not self.dist.packages: return None packages = remove_stubs(sorted(self.dist.packages, key=len)) package_dir = self.dist.package_dir or {} parent_pkg = find_parent_package(packages, package_dir, self._root_dir) if parent_pkg: log.debug(f"Common parent package detected, name: {parent_pkg}") return parent_pkg log.warn("No parent package detected, impossible to derive `name`") return None def remove_nested_packages(packages: list[str]) -> list[str]: """Remove nested packages from a list of packages. >>> remove_nested_packages(["a", "a.b1", "a.b2", "a.b1.c1"]) ['a'] >>> remove_nested_packages(["a", "b", "c.d", "c.d.e.f", "g.h", "a.a1"]) ['a', 'b', 'c.d', 'g.h'] """ pkgs = sorted(packages, key=len) top_level = pkgs[:] size = len(pkgs) for i, name in enumerate(reversed(pkgs)): if any(name.startswith(f"{other}.") for other in top_level): top_level.pop(size - i - 1) return top_level def remove_stubs(packages: list[str]) -> list[str]: """Remove type stubs (:pep:`561`) from a list of packages. >>> remove_stubs(["a", "a.b", "a-stubs", "a-stubs.b.c", "b", "c-stubs"]) ['a', 'a.b', 'b'] """ return [pkg for pkg in packages if not pkg.split(".")[0].endswith("-stubs")] def find_parent_package( packages: list[str], package_dir: Mapping[str, str], root_dir: StrPath ) -> str | None: """Find the parent package that is not a namespace.""" packages = sorted(packages, key=len) common_ancestors = [] for i, name in enumerate(packages): if not all(n.startswith(f"{name}.") for n in packages[i + 1 :]): # Since packages are sorted by length, this condition is able # to find a list of all common ancestors. # When there is divergence (e.g. multiple root packages) # the list will be empty break common_ancestors.append(name) for name in common_ancestors: pkg_path = find_package_path(name, package_dir, root_dir) init = os.path.join(pkg_path, "__init__.py") if os.path.isfile(init): return name return None def find_package_path( name: str, package_dir: Mapping[str, str], root_dir: StrPath ) -> str: """Given a package name, return the path where it should be found on disk, considering the ``package_dir`` option. >>> path = find_package_path("my.pkg", {"": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/my/pkg' >>> path = find_package_path("my.pkg", {"my": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/pkg' >>> path = find_package_path("my.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested' >>> path = find_package_path("other.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './other/pkg' """ parts = name.split(".") for i in range(len(parts), 0, -1): # Look backwards, the most specific package_dir first partial_name = ".".join(parts[:i]) if partial_name in package_dir: parent = package_dir[partial_name] return os.path.join(root_dir, parent, *parts[i:]) parent = package_dir.get("") or "" return os.path.join(root_dir, *parent.split("/"), *parts) def construct_package_dir(packages: list[str], package_path: StrPath) -> dict[str, str]: parent_pkgs = remove_nested_packages(packages) prefix = Path(package_path).parts return {pkg: "/".join([*prefix, *pkg.split(".")]) for pkg in parent_pkgs} _itertools.py 0000644 00000001221 15030122015 0007262 0 ustar 00 from more_itertools import consume # noqa: F401 # copied from jaraco.itertools 6.1 def ensure_unique(iterable, key=lambda x: x): """ Wrap an iterable to raise a ValueError if non-unique values are encountered. >>> list(ensure_unique('abc')) ['a', 'b', 'c'] >>> consume(ensure_unique('abca')) Traceback (most recent call last): ... ValueError: Duplicate element 'a' encountered. """ seen = set() seen_add = seen.add for element in iterable: k = key(element) if k in seen: raise ValueError(f"Duplicate element {element!r} encountered.") seen_add(k) yield element monkey.py 0000644 00000007205 15030122015 0006411 0 ustar 00 """ Monkey patching of distutils. """ from __future__ import annotations import inspect import platform import sys import types from typing import TypeVar, cast, overload import distutils.filelist _T = TypeVar("_T") _UnpatchT = TypeVar("_UnpatchT", type, types.FunctionType) __all__: list[str] = [] """ Everything is private. Contact the project team if you think you need this functionality. """ def _get_mro(cls): """ Returns the bases classes for cls sorted by the MRO. Works around an issue on Jython where inspect.getmro will not return all base classes if multiple classes share the same name. Instead, this function will return a tuple containing the class itself, and the contents of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024. """ if platform.python_implementation() == "Jython": return (cls,) + cls.__bases__ return inspect.getmro(cls) @overload def get_unpatched(item: _UnpatchT) -> _UnpatchT: ... @overload def get_unpatched(item: object) -> None: ... def get_unpatched( item: type | types.FunctionType | object, ) -> type | types.FunctionType | None: if isinstance(item, type): return get_unpatched_class(item) if isinstance(item, types.FunctionType): return get_unpatched_function(item) return None def get_unpatched_class(cls: type[_T]) -> type[_T]: """Protect against re-patching the distutils if reloaded Also ensures that no other distutils extension monkeypatched the distutils first. """ external_bases = ( cast(type[_T], cls) for cls in _get_mro(cls) if not cls.__module__.startswith('setuptools') ) base = next(external_bases) if not base.__module__.startswith('distutils'): msg = f"distutils has already been patched by {cls!r}" raise AssertionError(msg) return base def patch_all(): import setuptools # we can't patch distutils.cmd, alas distutils.core.Command = setuptools.Command # type: ignore[misc,assignment] # monkeypatching _patch_distribution_metadata() # Install Distribution throughout the distutils for module in distutils.dist, distutils.core, distutils.cmd: module.Distribution = setuptools.dist.Distribution # Install the patched Extension distutils.core.Extension = setuptools.extension.Extension # type: ignore[misc,assignment] # monkeypatching distutils.extension.Extension = setuptools.extension.Extension # type: ignore[misc,assignment] # monkeypatching if 'distutils.command.build_ext' in sys.modules: sys.modules[ 'distutils.command.build_ext' ].Extension = setuptools.extension.Extension def _patch_distribution_metadata(): from . import _core_metadata """Patch write_pkg_file and read_pkg_file for higher metadata standards""" for attr in ( 'write_pkg_info', 'write_pkg_file', 'read_pkg_file', 'get_metadata_version', 'get_fullname', ): new_val = getattr(_core_metadata, attr) setattr(distutils.dist.DistributionMetadata, attr, new_val) def patch_func(replacement, target_mod, func_name): """ Patch func_name in target_mod with replacement Important - original must be resolved by name to avoid patching an already patched function. """ original = getattr(target_mod, func_name) # set the 'unpatched' attribute on the replacement to # point to the original. vars(replacement).setdefault('unpatched', original) # replace the function in the original module setattr(target_mod, func_name, replacement) def get_unpatched_function(candidate): return candidate.unpatched __init__.py 0000644 00000024246 15030122015 0006652 0 ustar 00 """Extensions to the 'distutils' for large or complex distributions""" # mypy: disable_error_code=override # Command.reinitialize_command has an extra **kw param that distutils doesn't have # Can't disable on the exact line because distutils doesn't exists on Python 3.12 # and mypy isn't aware of distutils_hack, causing distutils.core.Command to be Any, # and a [unused-ignore] to be raised on 3.12+ from __future__ import annotations import functools import os import re import sys from abc import abstractmethod from collections.abc import Mapping from typing import TYPE_CHECKING, TypeVar, overload sys.path.extend(((vendor_path := os.path.join(os.path.dirname(os.path.dirname(__file__)), 'setuptools', '_vendor')) not in sys.path) * [vendor_path]) # fmt: skip # workaround for #4476 sys.modules.pop('backports', None) import _distutils_hack.override # noqa: F401 from . import logging, monkey from .depends import Require from .discovery import PackageFinder, PEP420PackageFinder from .dist import Distribution from .extension import Extension from .version import __version__ as __version__ from .warnings import SetuptoolsDeprecationWarning import distutils.core from distutils.errors import DistutilsOptionError __all__ = [ 'setup', 'Distribution', 'Command', 'Extension', 'Require', 'SetuptoolsDeprecationWarning', 'find_packages', 'find_namespace_packages', ] _CommandT = TypeVar("_CommandT", bound="_Command") bootstrap_install_from = None find_packages = PackageFinder.find find_namespace_packages = PEP420PackageFinder.find def _install_setup_requires(attrs): # Note: do not use `setuptools.Distribution` directly, as # our PEP 517 backend patch `distutils.core.Distribution`. class MinimalDistribution(distutils.core.Distribution): """ A minimal version of a distribution for supporting the fetch_build_eggs interface. """ def __init__(self, attrs: Mapping[str, object]) -> None: _incl = 'dependency_links', 'setup_requires' filtered = {k: attrs[k] for k in set(_incl) & set(attrs)} super().__init__(filtered) # Prevent accidentally triggering discovery with incomplete set of attrs self.set_defaults._disable() def _get_project_config_files(self, filenames=None): """Ignore ``pyproject.toml``, they are not related to setup_requires""" try: cfg, _toml = super()._split_standard_project_metadata(filenames) except Exception: return filenames, () return cfg, () def finalize_options(self): """ Disable finalize_options to avoid building the working set. Ref #2158. """ dist = MinimalDistribution(attrs) # Honor setup.cfg's options. dist.parse_config_files(ignore_option_errors=True) if dist.setup_requires: _fetch_build_eggs(dist) def _fetch_build_eggs(dist: Distribution): try: dist.fetch_build_eggs(dist.setup_requires) except Exception as ex: msg = """ It is possible a package already installed in your system contains an version that is invalid according to PEP 440. You can try `pip install --use-pep517` as a workaround for this problem, or rely on a new virtual environment. If the problem refers to a package that is not installed yet, please contact that package's maintainers or distributors. """ if "InvalidVersion" in ex.__class__.__name__: if hasattr(ex, "add_note"): ex.add_note(msg) # PEP 678 else: dist.announce(f"\n{msg}\n") raise def setup(**attrs): logging.configure() # Make sure we have any requirements needed to interpret 'attrs'. _install_setup_requires(attrs) return distutils.core.setup(**attrs) setup.__doc__ = distutils.core.setup.__doc__ if TYPE_CHECKING: # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962 from distutils.core import Command as _Command else: _Command = monkey.get_unpatched(distutils.core.Command) class Command(_Command): """ Setuptools internal actions are organized using a *command design pattern*. This means that each action (or group of closely related actions) executed during the build should be implemented as a ``Command`` subclass. These commands are abstractions and do not necessarily correspond to a command that can (or should) be executed via a terminal, in a CLI fashion (although historically they would). When creating a new command from scratch, custom defined classes **SHOULD** inherit from ``setuptools.Command`` and implement a few mandatory methods. Between these mandatory methods, are listed: :meth:`initialize_options`, :meth:`finalize_options` and :meth:`run`. A useful analogy for command classes is to think of them as subroutines with local variables called "options". The options are "declared" in :meth:`initialize_options` and "defined" (given their final values, aka "finalized") in :meth:`finalize_options`, both of which must be defined by every command class. The "body" of the subroutine, (where it does all the work) is the :meth:`run` method. Between :meth:`initialize_options` and :meth:`finalize_options`, ``setuptools`` may set the values for options/attributes based on user's input (or circumstance), which means that the implementation should be careful to not overwrite values in :meth:`finalize_options` unless necessary. Please note that other commands (or other parts of setuptools) may also overwrite the values of the command's options/attributes multiple times during the build process. Therefore it is important to consistently implement :meth:`initialize_options` and :meth:`finalize_options`. For example, all derived attributes (or attributes that depend on the value of other attributes) **SHOULD** be recomputed in :meth:`finalize_options`. When overwriting existing commands, custom defined classes **MUST** abide by the same APIs implemented by the original class. They also **SHOULD** inherit from the original class. """ command_consumes_arguments = False distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution def __init__(self, dist: Distribution, **kw) -> None: """ Construct the command for dist, updating vars(self) with any keyword parameters. """ super().__init__(dist) vars(self).update(kw) def _ensure_stringlike(self, option, what, default=None): val = getattr(self, option) if val is None: setattr(self, option, default) return default elif not isinstance(val, str): raise DistutilsOptionError(f"'{option}' must be a {what} (got `{val}`)") return val def ensure_string_list(self, option: str) -> None: r"""Ensure that 'option' is a list of strings. If 'option' is currently a string, we split it either on /,\s*/ or /\s+/, so "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become ["foo", "bar", "baz"]. .. TODO: This method seems to be similar to the one in ``distutils.cmd`` Probably it is just here for backward compatibility with old Python versions? :meta private: """ val = getattr(self, option) if val is None: return elif isinstance(val, str): setattr(self, option, re.split(r',\s*|\s+', val)) else: if isinstance(val, list): ok = all(isinstance(v, str) for v in val) else: ok = False if not ok: raise DistutilsOptionError( f"'{option}' must be a list of strings (got {val!r})" ) @overload def reinitialize_command( self, command: str, reinit_subcommands: bool = False, **kw ) -> _Command: ... @overload def reinitialize_command( self, command: _CommandT, reinit_subcommands: bool = False, **kw ) -> _CommandT: ... def reinitialize_command( self, command: str | _Command, reinit_subcommands: bool = False, **kw ) -> _Command: cmd = _Command.reinitialize_command(self, command, reinit_subcommands) vars(cmd).update(kw) return cmd # pyright: ignore[reportReturnType] # pypa/distutils#307 @abstractmethod def initialize_options(self) -> None: """ Set or (reset) all options/attributes/caches used by the command to their default values. Note that these values may be overwritten during the build. """ raise NotImplementedError @abstractmethod def finalize_options(self) -> None: """ Set final values for all options/attributes used by the command. Most of the time, each option/attribute/cache should only be set if it does not have any value yet (e.g. ``if self.attr is None: self.attr = val``). """ raise NotImplementedError @abstractmethod def run(self) -> None: """ Execute the actions intended by the command. (Side effects **SHOULD** only take place when :meth:`run` is executed, for example, creating new files or writing to the terminal output). """ raise NotImplementedError def _find_all_simple(path): """ Find all files under 'path' """ results = ( os.path.join(base, file) for base, dirs, files in os.walk(path, followlinks=True) for file in files ) return filter(os.path.isfile, results) def findall(dir=os.curdir): """ Find all files under 'dir' and return the list of full filenames. Unless dir is '.', return full filenames with dir prepended. """ files = _find_all_simple(dir) if dir == os.curdir: make_rel = functools.partial(os.path.relpath, start=dir) files = map(make_rel, files) return list(files) class sic(str): """Treat this string as-is (https://en.wikipedia.org/wiki/Sic)""" # Apply monkey patches monkey.patch_all() _reqs.py 0000644 00000002636 15030122015 0006223 0 ustar 00 from __future__ import annotations from collections.abc import Iterable, Iterator from functools import lru_cache from typing import TYPE_CHECKING, Callable, TypeVar, Union, overload import jaraco.text as text from packaging.requirements import Requirement if TYPE_CHECKING: from typing_extensions import TypeAlias _T = TypeVar("_T") _StrOrIter: TypeAlias = Union[str, Iterable[str]] parse_req: Callable[[str], Requirement] = lru_cache()(Requirement) # Setuptools parses the same requirement many times # (e.g. first for validation than for normalisation), # so it might be worth to cache. def parse_strings(strs: _StrOrIter) -> Iterator[str]: """ Yield requirement strings for each specification in `strs`. `strs` must be a string, or a (possibly-nested) iterable thereof. """ return text.join_continuation(map(text.drop_comment, text.yield_lines(strs))) # These overloads are only needed because of a mypy false-positive, pyright gets it right # https://github.com/python/mypy/issues/3737 @overload def parse(strs: _StrOrIter) -> Iterator[Requirement]: ... @overload def parse(strs: _StrOrIter, parser: Callable[[str], _T]) -> Iterator[_T]: ... def parse(strs: _StrOrIter, parser: Callable[[str], _T] = parse_req) -> Iterator[_T]: # type: ignore[assignment] """ Replacement for ``pkg_resources.parse_requirements`` that uses ``packaging``. """ return map(parser, parse_strings(strs)) errors.py 0000644 00000005720 15030122015 0006423 0 ustar 00 """setuptools.errors Provides exceptions used by setuptools modules. """ from __future__ import annotations from distutils import errors as _distutils_errors # Re-export errors from distutils to facilitate the migration to PEP632 ByteCompileError = _distutils_errors.DistutilsByteCompileError CCompilerError = _distutils_errors.CCompilerError ClassError = _distutils_errors.DistutilsClassError CompileError = _distutils_errors.CompileError ExecError = _distutils_errors.DistutilsExecError FileError = _distutils_errors.DistutilsFileError InternalError = _distutils_errors.DistutilsInternalError LibError = _distutils_errors.LibError LinkError = _distutils_errors.LinkError ModuleError = _distutils_errors.DistutilsModuleError OptionError = _distutils_errors.DistutilsOptionError PlatformError = _distutils_errors.DistutilsPlatformError PreprocessError = _distutils_errors.PreprocessError SetupError = _distutils_errors.DistutilsSetupError TemplateError = _distutils_errors.DistutilsTemplateError UnknownFileError = _distutils_errors.UnknownFileError # The root error class in the hierarchy BaseError = _distutils_errors.DistutilsError class InvalidConfigError(OptionError): # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+ """Error used for invalid configurations.""" class RemovedConfigError(OptionError): # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+ """Error used for configurations that were deprecated and removed.""" class RemovedCommandError(BaseError, RuntimeError): # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+ """Error used for commands that have been removed in setuptools. Since ``setuptools`` is built on ``distutils``, simply removing a command from ``setuptools`` will make the behavior fall back to ``distutils``; this error is raised if a command exists in ``distutils`` but has been actively removed in ``setuptools``. """ class PackageDiscoveryError(BaseError, RuntimeError): # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+ """Impossible to perform automatic discovery of packages and/or modules. The current project layout or given discovery options can lead to problems when scanning the project directory. Setuptools might also refuse to complete auto-discovery if an error prone condition is detected (e.g. when a project is organised as a flat-layout but contains multiple directories that can be taken as top-level packages inside a single distribution [*]_). In these situations the users are encouraged to be explicit about which packages to include or to make the discovery parameters more specific. .. [*] Since multi-package distributions are uncommon it is very likely that the developers did not intend for all the directories to be packaged, and are just leaving auxiliary code in the repository top-level, such as maintenance-related scripts. """
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.23 |
proxy
|
phpinfo
|
Settings